002bcf2a8a
* feat(sdk): add typed query foundation and gsd-sdk query (Phase 1) Add sdk/src/query registry and handlers with tests, GSDQueryError, CLI query wiring, and supporting type/tool-scoping hooks. Update CHANGELOG. Vitest 4 constructor mock fixes in milestone-runner tests. Made-with: Cursor * fix(2137): skip worktree isolation when .gitmodules detected When a project contains git submodules, worktree isolation cannot correctly handle submodule commits — three separate gaps exist in worktree setup, executor commit protocol, and merge-back. Rather than patch each gap individually, detect .gitmodules at phase start and fall back to sequential execution, which handles submodules transparently (Option B). Affected workflows: execute-phase.md, quick.md --------- Co-authored-by: David Sienkowski <dave@sienkowski.com>
62 lines
2.5 KiB
TypeScript
62 lines
2.5 KiB
TypeScript
/**
|
|
* Tool scoping — maps phase types to allowed tool sets.
|
|
*
|
|
* Per R015, different phases get different tool access:
|
|
* - Research: read-only + web search (no Write/Edit on source)
|
|
* - Execute: full read/write
|
|
* - Verify: read-only (no Write/Edit)
|
|
* - Discuss: read-only
|
|
* - Plan: read/write + web (for creating plan files)
|
|
*/
|
|
|
|
import { PhaseType } from './types.js';
|
|
import { parseAgentTools } from './prompt-builder.js';
|
|
|
|
// ─── Phase default tool sets ─────────────────────────────────────────────────
|
|
|
|
const PHASE_DEFAULT_TOOLS: Record<PhaseType, string[]> = {
|
|
[PhaseType.Research]: ['Read', 'Grep', 'Glob', 'Bash', 'WebSearch'],
|
|
[PhaseType.Execute]: ['Read', 'Write', 'Edit', 'Bash', 'Grep', 'Glob'],
|
|
[PhaseType.Verify]: ['Read', 'Bash', 'Grep', 'Glob'],
|
|
[PhaseType.Discuss]: ['Read', 'Bash', 'Grep', 'Glob'],
|
|
[PhaseType.Plan]: ['Read', 'Write', 'Bash', 'Glob', 'Grep', 'WebFetch'],
|
|
[PhaseType.Repair]: ['Read', 'Write', 'Edit', 'Bash', 'Grep', 'Glob'],
|
|
};
|
|
|
|
// ─── Phase → agent definition filename ──────────────────────────────────────
|
|
|
|
/**
|
|
* Maps each phase type to its corresponding agent definition filename.
|
|
* Discuss has no dedicated agent — it runs in the main conversation.
|
|
*/
|
|
export const PHASE_AGENT_MAP: Record<PhaseType, string | null> = {
|
|
[PhaseType.Execute]: 'gsd-executor.md',
|
|
[PhaseType.Research]: 'gsd-phase-researcher.md',
|
|
[PhaseType.Plan]: 'gsd-planner.md',
|
|
[PhaseType.Verify]: 'gsd-verifier.md',
|
|
[PhaseType.Discuss]: null,
|
|
[PhaseType.Repair]: null,
|
|
};
|
|
|
|
// ─── Public API ──────────────────────────────────────────────────────────────
|
|
|
|
/**
|
|
* Get the allowed tools for a phase type.
|
|
*
|
|
* If an agent definition string is provided, tools are parsed from its
|
|
* frontmatter (reusing parseAgentTools from prompt-builder). Otherwise,
|
|
* returns the hardcoded phase defaults per R015.
|
|
*
|
|
* @param phaseType - The phase being executed
|
|
* @param agentDef - Optional raw agent .md file content to parse tools from
|
|
* @returns Array of allowed tool names
|
|
*/
|
|
export function getToolsForPhase(phaseType: PhaseType, agentDef?: string): string[] {
|
|
if (agentDef) {
|
|
return parseAgentTools(agentDef);
|
|
}
|
|
return [...PHASE_DEFAULT_TOOLS[phaseType]];
|
|
}
|
|
|
|
export { PHASE_DEFAULT_TOOLS };
|