@gempack/squad-mcp 0.3.1 → 0.6.0

package/dist/tools/agents.js

@@ -6,7 +6,10 @@ export const listAgentsTool = {
     name: 'list_agents',
     description: 'List all configured agents with their roles, ownership, and naming conventions.',
     schema: listSchema,
-    handler: async () => ({ agents: await listAvailableAgents(), local_dir: getLocalDir() }),
+    handler: async () => {
+        const { rawDir, explicit } = getLocalDir();
+        return { agents: await listAvailableAgents(), local_dir: rawDir, local_dir_explicit: explicit };
+    },
 };
 const getSchema = z.object({
     name: z.enum(Object.keys(AGENTS)),

package/dist/tools/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/tools/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAkB,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEtH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,iFAAiF;IAC9F,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,mBAAmB,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,CAAC;CACzF,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgC,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAA8B;IAC/D,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,4GAA4G;IACzH,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI;QACJ,UAAU,EAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,qKAAqK;IACvK,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;CACrD,CAAC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/tools/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAkB,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEtH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,iFAAiF;IAC9F,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAClG,CAAC;CACF,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgC,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAA8B;IAC/D,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,4GAA4G;IACzH,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI;QACJ,UAAU,EAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,qKAAqK;IACvK,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;CACrD,CAAC"}

package/dist/tools/compose-advisory-bundle.d.ts

@@ -1,8 +1,8 @@
-import { z } from 'zod';
-import type { ToolDef } from './registry.js';
-import { type ComposeWorkflowOutput } from './compose-squad-workflow.js';
-import { type SliceOutput } from './slice-files.js';
-import { type ValidatePlanOutput } from './validate-plan-text.js';
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type ComposeWorkflowOutput } from "./compose-squad-workflow.js";
+import { type SliceOutput } from "./slice-files.js";
+import { type ValidatePlanOutput } from "./validate-plan-text.js";
 declare const schema: z.ZodObject<{
     workspace_root: z.ZodEffects<z.ZodString, string, string>;
     user_prompt: z.ZodEffects<z.ZodString, string, string>;

package/dist/tools/compose-advisory-bundle.js

@@ -1,12 +1,12 @@
-import { z } from 'zod';
-import { composeSquadWorkflow } from './compose-squad-workflow.js';
-import { sliceFilesForAgent } from './slice-files.js';
-import { validatePlanText } from './validate-plan-text.js';
-import { AGENT_NAMES_TUPLE } from '../config/ownership-matrix.js';
+import { z } from "zod";
+import { composeSquadWorkflow, } from "./compose-squad-workflow.js";
+import { sliceFilesForAgent } from "./slice-files.js";
+import { validatePlanText, } from "./validate-plan-text.js";
+import { AGENT_NAMES_TUPLE } from "../config/ownership-matrix.js";
 const safeString = (max) => z
     .string()
     .max(max)
-    .refine((s) => s.indexOf(' ') === -1, 'must not contain NUL byte');
+    .refine((s) => s.indexOf(" ") === -1, "must not contain NUL byte");
 const schema = z.object({
     workspace_root: safeString(4096),
     user_prompt: safeString(8192),
@@ -15,7 +15,14 @@ const schema = z.object({
     staged_only: z.boolean().optional().default(false),
     read_content: z.boolean().optional().default(true),
     force_work_type: z
-        .enum(['Feature', 'Bug Fix', 'Refactor', 'Performance', 'Security', 'Business Rule'])
+        .enum([
+        "Feature",
+        "Bug Fix",
+        "Refactor",
+        "Performance",
+        "Security",
+        "Business Rule",
+    ])
         .optional(),
     force_agents: z.array(z.enum(AGENT_NAMES_TUPLE)).optional().default([]),
     risk_signals: z
@@ -43,7 +50,12 @@ export async function composeAdvisoryBundle(input) {
     if (input.risk_signals !== undefined)
         workflowInput.risk_signals = input.risk_signals;
     const workflow = await composeSquadWorkflow(workflowInput);
-    const filePaths = workflow.changed_files.files.map((f) => f.path);
+    // Use the FILTERED list (skip_paths already applied by composeSquadWorkflow).
+    // Slicing has to operate on the same set of files the squad was selected over,
+    // otherwise an agent would receive paths the composer just hid.
+    const allChanged = workflow.changed_files.files.map((f) => f.path);
+    const skippedSet = new Set(workflow.skipped_paths);
+    const filePaths = allChanged.filter((p) => !skippedSet.has(p));
     const slices_by_agent = {};
     for (const agent of workflow.squad.agents) {
         const slice = await sliceFilesForAgent({
@@ -58,10 +70,10 @@ export async function composeAdvisoryBundle(input) {
     return { workflow, slices_by_agent, plan_validation };
 }
 export const composeAdvisoryBundleTool = {
-    name: 'compose_advisory_bundle',
-    description: 'End-to-end advisory dispatch bundle. Runs compose_squad_workflow, then slice_files_for_agent for each ' +
-        'selected agent, then validate_plan_text on the supplied plan. Returns the union output ready for the ' +
-        'host to dispatch parallel advisory reviews.',
+    name: "compose_advisory_bundle",
+    description: "End-to-end advisory dispatch bundle. Runs compose_squad_workflow, then slice_files_for_agent for each " +
+        "selected agent, then validate_plan_text on the supplied plan. Returns the union output ready for the " +
+        "host to dispatch parallel advisory reviews.",
     schema,
     handler: composeAdvisoryBundle,
 };

package/dist/tools/compose-advisory-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-advisory-bundle.js","sourceRoot":"","sources":["../../src/tools/compose-advisory-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAA8B,MAAM,6BAA6B,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAA2B,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CACjC,CAAC;KACE,MAAM,EAAE;KACR,GAAG,CAAC,GAAG,CAAC;KACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAEvE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC;IAChC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClD,eAAe,EAAE,CAAC;SACf,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;SACpF,QAAQ,EAAE;IACb,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC;QACN,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACpC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACrC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACzC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAClC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAC5C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAY;IACtD,MAAM,aAAa,GAA+C;QAChE,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;IACF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,aAAa,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC1E,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,aAAa,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC/F,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,aAAa,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAEtF,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAElE,MAAM,eAAe,GAAgC,EAAE,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;YACrC,KAAK;YACL,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;QACH,eAAe,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC;IAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAE/D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAA2B;IAC/D,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,wGAAwG;QACxG,uGAAuG;QACvG,6CAA6C;IAC/C,MAAM;IACN,OAAO,EAAE,qBAAqB;CAC/B,CAAC"}
+{"version":3,"file":"compose-advisory-bundle.js","sourceRoot":"","sources":["../../src/tools/compose-advisory-bundle.ts"],"names":[],"mappings":"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"}

package/dist/tools/compose-prd-parse.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodString;
+    /** PRD text. Free-form; the LLM is responsible for extracting structure. */
+    prd_text: z.ZodString;
+    /** Optional max number of tasks to extract (soft hint passed to the LLM). */
+    max_tasks: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * When true (default), include the existing tasks in the prompt so the LLM
+     * doesn't duplicate ids or re-decompose work already captured.
+     */
+    include_existing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+    prd_text: string;
+    max_tasks: number;
+    include_existing: boolean;
+}, {
+    workspace_root: string;
+    prd_text: string;
+    max_tasks?: number | undefined;
+    include_existing?: boolean | undefined;
+}>;
+type Input = z.infer<typeof schema>;
+export interface ComposePrdParseOutput {
+    /** Markdown prompt to feed to the host LLM. */
+    prompt: string;
+    /** JSON schema the LLM is instructed to emit. Caller validates against this. */
+    output_schema: Record<string, unknown>;
+    /** Existing tasks, injected into the prompt and returned for caller convenience. */
+    existing: {
+        id: number;
+        title: string;
+        status: string;
+    }[];
+    /** Highest existing id, so caller can pre-allocate or warn the LLM. */
+    next_id_floor: number;
+    /** Recommended next step (string, for the host LLM): call record_tasks. */
+    next_action: "call_record_tasks_with_user_confirmation";
+}
+/**
+ * Build the prompt + output schema for decomposing a PRD into squad-mcp tasks.
+ * Pure-MCP: this tool does NOT call any LLM. It returns the materials the host
+ * LLM (Claude Code, Cursor, etc.) needs to do the decomposition itself, and
+ * then call `record_tasks` with the result.
+ *
+ * Why pure-MCP: keeps squad-mcp deterministic and free of provider keys; the
+ * host already pays for inference and has the user's consent to do so.
+ */
+export declare function composePrdParseTool(input: Input): Promise<ComposePrdParseOutput>;
+export declare const composePrdParseToolDef: ToolDef<typeof schema>;
+export {};

package/dist/tools/compose-prd-parse.js

@@ -0,0 +1,167 @@
+import { z } from "zod";
+import { readTasks } from "../tasks/store.js";
+import { readSquadYaml } from "../config/squad-yaml.js";
+import { resolveSafePath, createSafePathContext } from "../util/path-safety.js";
+import { AGENT_NAMES_TUPLE } from "../config/ownership-matrix.js";
+const schema = z.object({
+    workspace_root: z.string().min(1).max(4096),
+    /** PRD text. Free-form; the LLM is responsible for extracting structure. */
+    prd_text: z.string().min(1).max(200_000),
+    /** Optional max number of tasks to extract (soft hint passed to the LLM). */
+    max_tasks: z.number().int().positive().max(200).optional().default(40),
+    /**
+     * When true (default), include the existing tasks in the prompt so the LLM
+     * doesn't duplicate ids or re-decompose work already captured.
+     */
+    include_existing: z.boolean().optional().default(true),
+});
+const TASK_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        title: { type: "string", maxLength: 512 },
+        description: { type: "string", maxLength: 4096 },
+        dependencies: {
+            type: "array",
+            items: { type: "integer", minimum: 1 },
+            description: "Task IDs this task depends on. May reference existing tasks or other tasks in the same parsed batch (forward refs allowed — IDs assigned by record_tasks in array order starting from next_id_floor + 1).",
+        },
+        priority: { type: "string", enum: ["low", "medium", "high"] },
+        details: { type: "string", maxLength: 16384 },
+        test_strategy: { type: "string", maxLength: 4096 },
+        scope: {
+            type: "string",
+            maxLength: 512,
+            description: "Glob limiting which files this task touches (e.g. 'src/auth/**'). Optional. Used by slice_files_for_task and the advisory squad to narrow review.",
+        },
+        agent_hints: {
+            type: "array",
+            items: { type: "string", enum: AGENT_NAMES_TUPLE },
+            description: "Subset of squad agents most relevant for this task. Empty/absent means repo-wide.",
+        },
+    },
+    required: ["title"],
+};
+const OUTPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        tasks: {
+            type: "array",
+            items: TASK_INPUT_SCHEMA,
+            maxItems: 200,
+        },
+    },
+    required: ["tasks"],
+};
+function renderExisting(existing) {
+    if (existing.length === 0) {
+        return "_(no existing tasks — this is a fresh decomposition)_";
+    }
+    const lines = existing.map((t) => `- ${t.id}. [${t.status}] ${t.title}`);
+    return lines.join("\n");
+}
+/**
+ * Build the prompt + output schema for decomposing a PRD into squad-mcp tasks.
+ * Pure-MCP: this tool does NOT call any LLM. It returns the materials the host
+ * LLM (Claude Code, Cursor, etc.) needs to do the decomposition itself, and
+ * then call `record_tasks` with the result.
+ *
+ * Why pure-MCP: keeps squad-mcp deterministic and free of provider keys; the
+ * host already pays for inference and has the user's consent to do so.
+ */
+export async function composePrdParseTool(input) {
+    const ctx = createSafePathContext();
+    const safeRoot = await resolveSafePath(input.workspace_root, ".", ctx);
+    const config = await readSquadYaml(safeRoot);
+    const existingFile = input.include_existing
+        ? await readTasks(safeRoot, { configuredPath: config.tasks.path })
+        : { tasks: [], version: 1 };
+    const nextIdFloor = existingFile.tasks.reduce((m, t) => Math.max(m, t.id), 0);
+    const existingSection = input.include_existing
+        ? `## Existing tasks (do not duplicate)
+
+The repo already has these tasks. Do NOT redecompose work they cover; reference
+their IDs in \`dependencies\` if your new tasks depend on them.
+
+${renderExisting(existingFile.tasks)}
+
+The next available task ID will be ${nextIdFloor + 1}.`
+        : `## Existing tasks
+_(skipped — caller passed \`include_existing: false\`)_`;
+    const agentList = AGENT_NAMES_TUPLE.filter((a) => a !== "tech-lead-planner" && a !== "tech-lead-consolidator").join(", ");
+    const prompt = `# Decompose the PRD below into atomic, ordered tasks.
+
+You are decomposing a Product Requirements Document into a list of tasks for the
+\`squad-mcp\` task store. The tasks will be reviewed by the user, then bulk-recorded
+via the \`record_tasks\` MCP tool, then executed one-at-a-time by the squad.
+
+## Output contract
+
+Emit ONE JSON object matching the schema below. No prose before or after — your
+entire response is parsed as JSON.
+
+\`\`\`json
+${JSON.stringify(OUTPUT_SCHEMA, null, 2)}
+\`\`\`
+
+## Decomposition rules
+
+1. **Atomic** — each task should be small enough that a developer can complete
+   it in a single sitting (one PR, one commit). If a task feels like "the whole
+   feature", break it down further.
+2. **Ordered via dependencies** — if task B can't start until task A is done,
+   set \`B.dependencies = [A's id]\`. IDs are assigned in array order starting
+   from ${nextIdFloor + 1}.
+3. **Cap at ${input.max_tasks} tasks** — if the PRD is huge, prefer fewer
+   higher-level tasks; the squad can \`expand_task\` later as needed.
+4. **Scope when sensible** — if a task touches a clearly-bounded directory
+   tree (e.g. just \`src/auth/\`), set \`scope\` to a glob (\`src/auth/**\`).
+   Skip \`scope\` for repo-wide tasks (config, docs, refactors).
+5. **Agent hints when obvious** — \`agent_hints\` narrows which squad agents
+   review the task. Available: ${agentList}. Pick 1-3 agents whose ownership
+   genuinely covers the task. Skip when the task spans multiple domains.
+6. **Test strategy** — for code tasks, write 1-3 sentences on how to verify.
+   Skip for non-code tasks (docs, config, deps).
+7. **Priority** — use \`high\` for blockers / security / critical path,
+   \`medium\` for normal work, \`low\` for nice-to-haves. Default \`medium\`.
+8. **No AI fluff** — \`title\` and \`description\` are read by humans.
+   Lead with the action verb. Example: "Add CSRF token to checkout flow",
+   not "Implementation of CSRF protection mechanism for the checkout module".
+
+## What NOT to do
+
+- Don't generate "setup", "init", or "scaffolding" tasks unless the PRD
+  explicitly requires them. Bias toward what the PRD actually asks for.
+- Don't invent tasks. If the PRD doesn't mention testing, don't add a
+  generic "write tests" task. The host can ask separately.
+- Don't reference task IDs that don't exist in either the existing list
+  or your own batch.
+- Don't emit a self-dependency (a task depending on itself).
+
+${existingSection}
+
+## PRD
+
+${input.prd_text}
+
+## Now emit the JSON
+
+Remember: ONE JSON object, schema above, no prose before or after.`;
+    return {
+        prompt,
+        output_schema: OUTPUT_SCHEMA,
+        existing: existingFile.tasks.map((t) => ({
+            id: t.id,
+            title: t.title,
+            status: t.status,
+        })),
+        next_id_floor: nextIdFloor,
+        next_action: "call_record_tasks_with_user_confirmation",
+    };
+}
+export const composePrdParseToolDef = {
+    name: "compose_prd_parse",
+    description: "Build a prompt + JSON schema for the host LLM to decompose a PRD into atomic tasks. Pure-MCP: does NOT call any LLM. Caller (skill/host) feeds the prompt to its LLM, receives JSON, then calls record_tasks with user confirmation. Includes existing tasks in the prompt to prevent duplication.",
+    schema,
+    handler: composePrdParseTool,
+};
+//# sourceMappingURL=compose-prd-parse.js.map

package/dist/tools/compose-prd-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-prd-parse.js","sourceRoot":"","sources":["../../src/tools/compose-prd-parse.ts"],"names":[],"mappings":"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"}

package/dist/tools/compose-squad-workflow.d.ts

@@ -1,10 +1,11 @@
-import { z } from 'zod';
-import type { ToolDef } from './registry.js';
-import { type DetectChangedFilesOutput } from './detect-changed-files.js';
-import { type ClassifyOutput } from './classify-work-type.js';
-import { type RiskOutput } from './score-risk.js';
-import { type SelectSquadOutput } from './select-squad.js';
-import { type WorkType } from '../config/ownership-matrix.js';
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type DetectChangedFilesOutput } from "./detect-changed-files.js";
+import { type ClassifyOutput } from "./classify-work-type.js";
+import { type RiskOutput } from "./score-risk.js";
+import { type SelectSquadOutput } from "./select-squad.js";
+import { type AgentName, type WorkType } from "../config/ownership-matrix.js";
+import { type ResolvedSquadConfig } from "../config/squad-yaml.js";
 declare const schema: z.ZodObject<{
     workspace_root: z.ZodEffects<z.ZodString, string, string>;
     user_prompt: z.ZodEffects<z.ZodString, string, string>;
@@ -12,7 +13,7 @@ declare const schema: z.ZodObject<{
     staged_only: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     read_content: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     force_work_type: z.ZodOptional<z.ZodEnum<["Feature", "Bug Fix", "Refactor", "Performance", "Security", "Business Rule"]>>;
-    force_agents: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<[import("../config/ownership-matrix.js").AgentName, ...import("../config/ownership-matrix.js").AgentName[]]>, "many">>>;
+    force_agents: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<[AgentName, ...AgentName[]]>, "many">>>;
     risk_signals: z.ZodOptional<z.ZodObject<{
         touches_auth: z.ZodOptional<z.ZodBoolean>;
         touches_money: z.ZodOptional<z.ZodBoolean>;
@@ -34,7 +35,7 @@ declare const schema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     read_content: boolean;
-    force_agents: import("../config/ownership-matrix.js").AgentName[];
+    force_agents: AgentName[];
     workspace_root: string;
     user_prompt: string;
     staged_only: boolean;
@@ -51,7 +52,7 @@ declare const schema: z.ZodObject<{
     workspace_root: string;
     user_prompt: string;
     read_content?: boolean | undefined;
-    force_agents?: import("../config/ownership-matrix.js").AgentName[] | undefined;
+    force_agents?: AgentName[] | undefined;
     base_ref?: string | undefined;
     staged_only?: boolean | undefined;
     force_work_type?: "Feature" | "Bug Fix" | "Refactor" | "Performance" | "Security" | "Business Rule" | undefined;
@@ -78,6 +79,23 @@ export interface ComposeWorkflowOutput {
         new_module: boolean;
         api_contract_change: boolean;
     };
+    /**
+     * Resolved `.squad.yaml` config (defaults filled in). `source` is null if no
+     * config file existed in workspace_root. Downstream callers (compose_advisory_bundle,
+     * apply_consolidation_rules) can lift weights/threshold/min_score from here.
+     */
+    config: ResolvedSquadConfig;
+    /**
+     * Files removed from advisory by `config.skip_paths`. Surfaced so callers can
+     * see *why* the slice list got narrower.
+     */
+    skipped_paths: string[];
+    /**
+     * Agents removed from the selected squad by `config.disable_agents`. Empty
+     * unless config disabled at least one of the agents the matrix would have
+     * picked.
+     */
+    disabled_agents: AgentName[];
 }
 export declare function composeSquadWorkflow(input: Input): Promise<ComposeWorkflowOutput>;
 export declare const composeSquadWorkflowTool: ToolDef<typeof schema>;

package/dist/tools/compose-squad-workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-squad-workflow.js","sourceRoot":"","sources":["../../src/tools/compose-squad-workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compose-squad-workflow.js","sourceRoot":"","sources":["../../src/tools/compose-squad-workflow.ts"],"names":[],"mappings":"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"}

package/dist/tools/consolidate.d.ts

@@ -1,5 +1,6 @@
-import { z } from 'zod';
-import type { ToolDef } from './registry.js';
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type RubricOutput } from "./score-rubric.js";
 declare const schema: z.ZodObject<{
     reports: z.ZodArray<z.ZodObject<{
         agent: z.ZodEnum<[import("../config/ownership-matrix.js").AgentName, ...import("../config/ownership-matrix.js").AgentName[]]>;
@@ -23,6 +24,14 @@ declare const schema: z.ZodObject<{
             justified?: boolean | undefined;
         }>, "many">;
         not_evaluated: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Optional dimension score 0-100 produced by the agent. When at least one
+         * report carries a score, the consolidator emits a rubric scorecard and the
+         * verdict can be downgraded if `min_score` is supplied. Backward compatible:
+         * pre-rubric clients omit this field and behave exactly as before.
+         */
+        score: z.ZodOptional<z.ZodNumber>;
+        score_rationale: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         agent: import("../config/ownership-matrix.js").AgentName;
         findings: {
@@ -33,6 +42,8 @@ declare const schema: z.ZodObject<{
             forwarded_to?: import("../config/ownership-matrix.js").AgentName | undefined;
         }[];
         not_evaluated: boolean;
+        score?: number | undefined;
+        score_rationale?: string | undefined;
     }, {
         agent: import("../config/ownership-matrix.js").AgentName;
         findings: {
@@ -42,9 +53,28 @@ declare const schema: z.ZodObject<{
             forwarded_to?: import("../config/ownership-matrix.js").AgentName | undefined;
             justified?: boolean | undefined;
         }[];
+        score?: number | undefined;
         not_evaluated?: boolean | undefined;
+        score_rationale?: string | undefined;
     }>, "many">;
+    /**
+     * Optional weight overrides for the rubric (sum must be 100). Forwarded to
+     * `score_rubric`. Ignored when no report carries a score.
+     */
+    weights: z.ZodOptional<z.ZodRecord<z.ZodEnum<[import("../config/ownership-matrix.js").AgentName, ...import("../config/ownership-matrix.js").AgentName[]]>, z.ZodNumber>>;
+    /**
+     * Per-dimension threshold for flagging individual scores. Defaults to 75.
+     */
+    threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * If supplied AND the weighted score is below this floor AND severity rules
+     * would otherwise return APPROVED, downgrade to CHANGES_REQUIRED. Lets a
+     * project enforce a "minimum quality bar" beyond just absence of Blockers.
+     * Independent of `threshold` (which flags individual dimensions).
+     */
+    min_score: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    threshold: number;
     reports: {
         agent: import("../config/ownership-matrix.js").AgentName;
         findings: {
@@ -55,7 +85,11 @@ declare const schema: z.ZodObject<{
             forwarded_to?: import("../config/ownership-matrix.js").AgentName | undefined;
         }[];
         not_evaluated: boolean;
+        score?: number | undefined;
+        score_rationale?: string | undefined;
     }[];
+    weights?: Partial<Record<import("../config/ownership-matrix.js").AgentName, number>> | undefined;
+    min_score?: number | undefined;
 }, {
     reports: {
         agent: import("../config/ownership-matrix.js").AgentName;
@@ -66,12 +100,17 @@ declare const schema: z.ZodObject<{
             forwarded_to?: import("../config/ownership-matrix.js").AgentName | undefined;
             justified?: boolean | undefined;
         }[];
+        score?: number | undefined;
         not_evaluated?: boolean | undefined;
+        score_rationale?: string | undefined;
     }[];
+    weights?: Partial<Record<import("../config/ownership-matrix.js").AgentName, number>> | undefined;
+    threshold?: number | undefined;
+    min_score?: number | undefined;
 }>;
 type Input = z.infer<typeof schema>;
-export type Verdict = 'APPROVED' | 'CHANGES_REQUIRED' | 'REJECTED';
-export type Severity = 'Blocker' | 'Major' | 'Minor' | 'Suggestion';
+export type Verdict = "APPROVED" | "CHANGES_REQUIRED" | "REJECTED";
+export type Severity = "Blocker" | "Major" | "Minor" | "Suggestion";
 export interface ConsolidationOutput {
     verdict: Verdict;
     blockers: {
@@ -91,6 +130,18 @@ export interface ConsolidationOutput {
     severity_counts: Record<Severity, number>;
     agents_involved: string[];
     summary: string;
+    /**
+     * Weighted-rubric scorecard if any report carried a score, else null.
+     * Independent of verdict — verdict logic preserves the legacy severity rules,
+     * extended only by the optional `min_score` floor.
+     */
+    rubric: RubricOutput | null;
+    /**
+     * True iff the verdict was downgraded from APPROVED to CHANGES_REQUIRED
+     * because the weighted score fell below `min_score`. Helps callers explain
+     * the downgrade in their output.
+     */
+    downgraded_by_score: boolean;
 }
 export declare function applyConsolidationRules(input: Input): ConsolidationOutput;
 export declare const applyConsolidationRulesTool: ToolDef<typeof schema>;