@gempack/squad-mcp 0.3.1 → 0.6.0

package/dist/tools/consolidate.js

@@ -1,6 +1,7 @@
-import { z } from 'zod';
-import { AGENT_NAMES_TUPLE } from '../config/ownership-matrix.js';
-const severity = z.enum(['Blocker', 'Major', 'Minor', 'Suggestion']);
+import { z } from "zod";
+import { AGENT_NAMES_TUPLE } from "../config/ownership-matrix.js";
+import { scoreRubric } from "./score-rubric.js";
+const severity = z.enum(["Blocker", "Major", "Minor", "Suggestion"]);
 const reportSchema = z.object({
     agent: z.enum(AGENT_NAMES_TUPLE),
     findings: z
@@ -13,9 +14,35 @@ const reportSchema = z.object({
     }))
         .max(500),
     not_evaluated: z.boolean().optional().default(false),
+    /**
+     * 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.number().min(0).max(100).optional(),
+    score_rationale: z.string().max(2048).optional(),
 });
 const schema = z.object({
     reports: z.array(reportSchema).max(50),
+    /**
+     * Optional weight overrides for the rubric (sum must be 100). Forwarded to
+     * `score_rubric`. Ignored when no report carries a score.
+     */
+    weights: z
+        .record(z.enum(AGENT_NAMES_TUPLE), z.number().min(0).max(100))
+        .optional(),
+    /**
+     * Per-dimension threshold for flagging individual scores. Defaults to 75.
+     */
+    threshold: z.number().min(0).max(100).optional().default(75),
+    /**
+     * 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.number().min(0).max(100).optional(),
 });
 export function applyConsolidationRules(input) {
     const blockers = [];
@@ -23,7 +50,12 @@ export function applyConsolidationRules(input) {
     const forwarded = [];
     const notEvaluated = [];
     const agentsInvolved = new Set();
-    const counts = { Blocker: 0, Major: 0, Minor: 0, Suggestion: 0 };
+    const counts = {
+        Blocker: 0,
+        Major: 0,
+        Minor: 0,
+        Suggestion: 0,
+    };
     for (const r of input.reports) {
         agentsInvolved.add(r.agent);
         if (r.not_evaluated) {
@@ -32,27 +64,62 @@ export function applyConsolidationRules(input) {
         }
         for (const f of r.findings) {
             counts[f.severity] += 1;
-            if (f.severity === 'Blocker')
+            if (f.severity === "Blocker")
                 blockers.push({ agent: r.agent, title: f.title });
-            if (f.severity === 'Major' && !f.justified)
+            if (f.severity === "Major" && !f.justified)
                 majorsUnjustified.push({ agent: r.agent, title: f.title });
             if (f.forwarded_to)
                 forwarded.push({ from: r.agent, to: f.forwarded_to, title: f.title });
         }
     }
+    // Compute rubric only if at least one report carried a score. Avoids
+    // disrupting legacy callers that never opted in.
+    const scoredReports = input.reports.filter((r) => typeof r.score === "number" && !r.not_evaluated);
+    let rubric = null;
+    if (scoredReports.length > 0) {
+        rubric = scoreRubric({
+            scores: scoredReports.map((r) => ({
+                agent: r.agent,
+                score: r.score,
+                rationale: r.score_rationale,
+            })),
+            weights: input.weights,
+            threshold: input.threshold,
+        });
+    }
+    // Severity rules (legacy, unchanged)
     let verdict;
     if (blockers.length)
-        verdict = 'REJECTED';
+        verdict = "REJECTED";
     else if (majorsUnjustified.length)
-        verdict = 'REJECTED';
+        verdict = "REJECTED";
     else if (counts.Major + counts.Minor > 0)
-        verdict = 'CHANGES_REQUIRED';
+        verdict = "CHANGES_REQUIRED";
     else
-        verdict = 'APPROVED';
+        verdict = "APPROVED";
+    // Optional score floor: APPROVED with weighted_score < min_score → CHANGES_REQUIRED.
+    // Never PROMOTES a verdict (a low score doesn't override a Blocker rejection),
+    // and never demotes below CHANGES_REQUIRED.
+    let downgradedByScore = false;
+    if (typeof input.min_score === "number" &&
+        rubric !== null &&
+        verdict === "APPROVED" &&
+        rubric.weighted_score < input.min_score) {
+        verdict = "CHANGES_REQUIRED";
+        downgradedByScore = true;
+    }
+    const scoreSummary = rubric
+        ? ` Weighted score: ${rubric.weighted_score.toFixed(1)}/100${rubric.passes_threshold ? "" : " (below threshold)"}.`
+        : "";
+    const downgradeSummary = downgradedByScore
+        ? ` Downgraded from APPROVED to CHANGES_REQUIRED because weighted score < min_score (${input.min_score}).`
+        : "";
     const summary = `Verdict: ${verdict}. ` +
         `${blockers.length} blocker(s), ${majorsUnjustified.length} unjustified major(s), ` +
         `${forwarded.length} forwarded item(s), ${notEvaluated.length} agent(s) not evaluated. ` +
-        `Severity counts: ${counts.Blocker} blocker / ${counts.Major} major / ${counts.Minor} minor / ${counts.Suggestion} suggestion.`;
+        `Severity counts: ${counts.Blocker} blocker / ${counts.Major} major / ${counts.Minor} minor / ${counts.Suggestion} suggestion.` +
+        scoreSummary +
+        downgradeSummary;
     return {
         verdict,
         blockers,
@@ -62,13 +129,18 @@ export function applyConsolidationRules(input) {
         severity_counts: counts,
         agents_involved: Array.from(agentsInvolved).sort(),
         summary,
+        rubric,
+        downgraded_by_score: downgradedByScore,
     };
 }
 export const applyConsolidationRulesTool = {
-    name: 'apply_consolidation_rules',
-    description: 'Aggregate advisory reports and emit a verdict per the rules in _Severity-and-Ownership.md. ' +
-        'Blocker -> REJECTED. Unjustified Major -> REJECTED. Otherwise CHANGES_REQUIRED or APPROVED. ' +
-        'Includes severity_counts and agents_involved for downstream summarization.',
+    name: "apply_consolidation_rules",
+    description: "Aggregate advisory reports and emit a verdict per the rules in _shared/_Severity-and-Ownership.md. " +
+        "Blocker -> REJECTED. Unjustified Major -> REJECTED. Otherwise CHANGES_REQUIRED or APPROVED. " +
+        "When reports carry per-dimension scores (0-100), also returns a weighted rubric scorecard " +
+        "(see score_rubric). Optional `min_score` downgrades APPROVED to CHANGES_REQUIRED if the " +
+        "weighted score is below the floor — useful for projects that want a quality bar beyond " +
+        "absence of blockers. Includes severity_counts and agents_involved for downstream summarization.",
     schema,
     handler: applyConsolidationRules,
 };

package/dist/tools/consolidate.js.map

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

package/dist/tools/expand-task.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type Task } from "../tasks/store.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodString;
+    task_id: z.ZodNumber;
+    subtasks: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        /** Reference sibling subtasks by id (assigned in input order, starting at max+1). */
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        details: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        details?: string | undefined;
+        description?: string | undefined;
+        dependencies?: number[] | undefined;
+    }, {
+        title: string;
+        details?: string | undefined;
+        description?: string | undefined;
+        dependencies?: number[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+    subtasks: {
+        title: string;
+        details?: string | undefined;
+        description?: string | undefined;
+        dependencies?: number[] | undefined;
+    }[];
+    task_id: number;
+}, {
+    workspace_root: string;
+    subtasks: {
+        title: string;
+        details?: string | undefined;
+        description?: string | undefined;
+        dependencies?: number[] | undefined;
+    }[];
+    task_id: number;
+}>;
+type Input = z.infer<typeof schema>;
+export interface ExpandTaskOutput {
+    expanded: true;
+    file: string;
+    task: Task;
+}
+export declare function expandTaskTool(input: Input): Promise<ExpandTaskOutput>;
+export declare const expandTaskToolDef: ToolDef<typeof schema>;
+export {};

package/dist/tools/expand-task.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { expandTask } from "../tasks/store.js";
+import { readSquadYaml } from "../config/squad-yaml.js";
+import { resolveSafePath, createSafePathContext } from "../util/path-safety.js";
+const subtaskInputSchema = z.object({
+    title: z.string().min(1).max(512),
+    description: z.string().max(4096).optional(),
+    /** Reference sibling subtasks by id (assigned in input order, starting at max+1). */
+    dependencies: z.array(z.number().int().positive()).max(50).optional(),
+    details: z.string().max(8192).optional(),
+});
+const schema = z.object({
+    workspace_root: z.string().min(1).max(4096),
+    task_id: z.number().int().positive(),
+    subtasks: z.array(subtaskInputSchema).min(1).max(50),
+});
+export async function expandTaskTool(input) {
+    const ctx = createSafePathContext();
+    const safeRoot = await resolveSafePath(input.workspace_root, ".", ctx);
+    const config = await readSquadYaml(safeRoot);
+    const result = await expandTask(safeRoot, input.task_id, input.subtasks.map((s) => ({
+        title: s.title,
+        ...(s.description !== undefined && { description: s.description }),
+        ...(s.dependencies !== undefined && { dependencies: s.dependencies }),
+        ...(s.details !== undefined && { details: s.details }),
+    })), { configuredPath: config.tasks.path });
+    return { expanded: true, file: result.filePath, task: result.task };
+}
+export const expandTaskToolDef = {
+    name: "expand_task",
+    description: "Append subtasks to an existing task. Mechanical only — the caller (skill or LLM) supplies the subtask inputs. Subtask ids allocated sequentially starting from `max(existing.subtasks.id) + 1`. Side-effecting, atomic write.",
+    schema,
+    handler: expandTaskTool,
+};
+//# sourceMappingURL=expand-task.js.map

package/dist/tools/expand-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-task.js","sourceRoot":"","sources":["../../src/tools/expand-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,qFAAqF;IACrF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACrD,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAY;IAC/C,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,QAAQ,EACR,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAClE,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;QACrE,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KACvD,CAAC,CAAC,EACH,EAAE,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CACtC,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,+NAA+N;IACjO,MAAM;IACN,OAAO,EAAE,cAAc;CACxB,CAAC"}

package/dist/tools/list-tasks.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type Task } from "../tasks/store.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodString;
+    status: z.ZodOptional<z.ZodArray<z.ZodEnum<["pending", "in-progress", "review", "done", "blocked", "cancelled"]>, "many">>;
+    agent: z.ZodOptional<z.ZodEnum<[import("../config/ownership-matrix.js").AgentName, ...import("../config/ownership-matrix.js").AgentName[]]>>;
+    changed_files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+    status?: ("pending" | "in-progress" | "review" | "done" | "blocked" | "cancelled")[] | undefined;
+    agent?: import("../config/ownership-matrix.js").AgentName | undefined;
+    limit?: number | undefined;
+    changed_files?: string[] | undefined;
+}, {
+    workspace_root: string;
+    status?: ("pending" | "in-progress" | "review" | "done" | "blocked" | "cancelled")[] | undefined;
+    agent?: import("../config/ownership-matrix.js").AgentName | undefined;
+    limit?: number | undefined;
+    changed_files?: string[] | undefined;
+}>;
+type Input = z.infer<typeof schema>;
+export interface ListTasksOutput {
+    tasks: Task[];
+    total_in_store: number;
+    source: string | null;
+}
+export declare function listTasksTool(input: Input): Promise<ListTasksOutput>;
+export declare const listTasksToolDef: ToolDef<typeof schema>;
+export {};

package/dist/tools/list-tasks.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { readTasks } from "../tasks/store.js";
+import { listTasks as listTasksFn } from "../tasks/select.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 taskStatusEnum = z.enum([
+    "pending",
+    "in-progress",
+    "review",
+    "done",
+    "blocked",
+    "cancelled",
+]);
+const schema = z.object({
+    workspace_root: z.string().min(1).max(4096),
+    status: z.array(taskStatusEnum).max(6).optional(),
+    agent: z.enum(AGENT_NAMES_TUPLE).optional(),
+    changed_files: z.array(z.string().min(1).max(4096)).max(5000).optional(),
+    limit: z.number().int().positive().max(2000).optional(),
+});
+export async function listTasksTool(input) {
+    const ctx = createSafePathContext();
+    const safeRoot = await resolveSafePath(input.workspace_root, ".", ctx);
+    const config = await readSquadYaml(safeRoot);
+    if (!config.tasks.enabled) {
+        return { tasks: [], total_in_store: 0, source: null };
+    }
+    const file = await readTasks(safeRoot, { configuredPath: config.tasks.path });
+    const filtered = listTasksFn(file.tasks, {
+        ...(input.status !== undefined && { status: input.status }),
+        ...(input.agent !== undefined && { agent: input.agent }),
+        ...(input.changed_files !== undefined && {
+            changed_files: input.changed_files,
+        }),
+        ...(input.limit !== undefined && { limit: input.limit }),
+    });
+    return {
+        tasks: filtered,
+        total_in_store: file.tasks.length,
+        source: file.tasks.length > 0 ? `${safeRoot}/${config.tasks.path}` : null,
+    };
+}
+export const listTasksToolDef = {
+    name: "list_tasks",
+    description: "List tasks from `.squad/tasks.json` with optional filters (status, agent, changed_files glob match against task.scope). Returns the filtered tasks plus the total count in the store.",
+    schema,
+    handler: listTasksTool,
+};
+//# sourceMappingURL=list-tasks.js.map

package/dist/tools/list-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tasks.js","sourceRoot":"","sources":["../../src/tools/list-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAa,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IAC5B,SAAS;IACT,aAAa;IACb,QAAQ;IACR,MAAM;IACN,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjD,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IAC3C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAY;IAC9C,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE;QACvC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACxD,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI;YACvC,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACzD,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QACjC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,uLAAuL;IACzL,MAAM;IACN,OAAO,EAAE,aAAa;CACvB,CAAC"}

package/dist/tools/next-task.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type Task } from "../tasks/store.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodString;
+    agent: z.ZodOptional<z.ZodEnum<[import("../config/ownership-matrix.js").AgentName, ...import("../config/ownership-matrix.js").AgentName[]]>>;
+    changed_files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Override default candidate statuses (default `["pending"]`). */
+    candidate_statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["pending", "in-progress", "review", "done", "blocked", "cancelled"]>, "many">>;
+    /** Override what "complete" means for dep checks (default `["done"]`). */
+    done_statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["pending", "in-progress", "review", "done", "blocked", "cancelled"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+    agent?: import("../config/ownership-matrix.js").AgentName | undefined;
+    changed_files?: string[] | undefined;
+    candidate_statuses?: ("pending" | "in-progress" | "review" | "done" | "blocked" | "cancelled")[] | undefined;
+    done_statuses?: ("pending" | "in-progress" | "review" | "done" | "blocked" | "cancelled")[] | undefined;
+}, {
+    workspace_root: string;
+    agent?: import("../config/ownership-matrix.js").AgentName | undefined;
+    changed_files?: string[] | undefined;
+    candidate_statuses?: ("pending" | "in-progress" | "review" | "done" | "blocked" | "cancelled")[] | undefined;
+    done_statuses?: ("pending" | "in-progress" | "review" | "done" | "blocked" | "cancelled")[] | undefined;
+}>;
+type Input = z.infer<typeof schema>;
+export interface NextTaskOutput {
+    task: Task | null;
+    reason: "no_candidates" | "all_blocked" | "ok";
+    blocked: Array<{
+        id: number;
+        title: string;
+        missing_deps: number[];
+    }>;
+}
+export declare function nextTaskTool(input: Input): Promise<NextTaskOutput>;
+export declare const nextTaskToolDef: ToolDef<typeof schema>;
+export {};

package/dist/tools/next-task.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { readTasks } from "../tasks/store.js";
+import { nextTask as nextTaskFn } from "../tasks/select.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 taskStatusEnum = z.enum([
+    "pending",
+    "in-progress",
+    "review",
+    "done",
+    "blocked",
+    "cancelled",
+]);
+const schema = z.object({
+    workspace_root: z.string().min(1).max(4096),
+    agent: z.enum(AGENT_NAMES_TUPLE).optional(),
+    changed_files: z.array(z.string().min(1).max(4096)).max(5000).optional(),
+    /** Override default candidate statuses (default `["pending"]`). */
+    candidate_statuses: z.array(taskStatusEnum).max(6).optional(),
+    /** Override what "complete" means for dep checks (default `["done"]`). */
+    done_statuses: z.array(taskStatusEnum).max(6).optional(),
+});
+export async function nextTaskTool(input) {
+    const ctx = createSafePathContext();
+    const safeRoot = await resolveSafePath(input.workspace_root, ".", ctx);
+    const config = await readSquadYaml(safeRoot);
+    if (!config.tasks.enabled) {
+        return { task: null, reason: "no_candidates", blocked: [] };
+    }
+    const file = await readTasks(safeRoot, { configuredPath: config.tasks.path });
+    const result = nextTaskFn(file.tasks, {
+        ...(input.agent !== undefined && { agent: input.agent }),
+        ...(input.changed_files !== undefined && {
+            changed_files: input.changed_files,
+        }),
+        ...(input.candidate_statuses !== undefined && {
+            candidate_statuses: input.candidate_statuses,
+        }),
+        ...(input.done_statuses !== undefined && {
+            done_statuses: input.done_statuses,
+        }),
+    });
+    return {
+        task: result.task,
+        reason: result.reason,
+        blocked: result.blocked.map((b) => ({
+            id: b.task.id,
+            title: b.task.title,
+            missing_deps: b.missing_deps,
+        })),
+    };
+}
+export const nextTaskToolDef = {
+    name: "next_task",
+    description: "Pick the next ready task: candidate status (default pending), all dependencies done, optional agent / changed_files filter. Tiebreaker priority then id. Returns null with reason when none ready, plus the blocked list so callers can show 'X is next when Y completes'.",
+    schema,
+    handler: nextTaskTool,
+};
+//# sourceMappingURL=next-task.js.map

package/dist/tools/next-task.js.map

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

package/dist/tools/read-learnings.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type LearningEntry } from "../learning/store.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodString;
+    /** Cap rendered/returned entries. Default 50. */
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** When set, restrict to learnings for this agent. */
+    agent: z.ZodOptional<z.ZodEnum<[import("../config/ownership-matrix.js").AgentName, ...import("../config/ownership-matrix.js").AgentName[]]>>;
+    /** When set, restrict to accepts or rejects. Default both. */
+    decision: z.ZodOptional<z.ZodEnum<["accept", "reject"]>>;
+    /**
+     * When set, filter scope-tagged entries to those whose scope glob matches
+     * at least one of these files. Entries without a scope always pass.
+     */
+    changed_files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * When true (default), also return the rendered markdown block ready to
+     * inject into an agent / consolidator prompt. When false, only the entries
+     * array. Skip the render when the caller will format their own.
+     */
+    include_rendered: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+    limit: number;
+    include_rendered: boolean;
+    agent?: import("../config/ownership-matrix.js").AgentName | undefined;
+    decision?: "accept" | "reject" | undefined;
+    changed_files?: string[] | undefined;
+}, {
+    workspace_root: string;
+    agent?: import("../config/ownership-matrix.js").AgentName | undefined;
+    decision?: "accept" | "reject" | undefined;
+    limit?: number | undefined;
+    changed_files?: string[] | undefined;
+    include_rendered?: boolean | undefined;
+}>;
+type Input = z.infer<typeof schema>;
+export interface ReadLearningsOutput {
+    entries: LearningEntry[];
+    total_in_store: number;
+    rendered: string;
+    source: string | null;
+}
+/**
+ * Read recent learnings from `.squad/learnings.jsonl` (path overridable via
+ * `.squad.yaml`.learnings.path). Returns the filtered entries plus a
+ * pre-rendered markdown block ready to inject into an agent / consolidator
+ * prompt. Pure-ish — reads filesystem, no writes.
+ */
+export declare function readLearningsTool(input: Input): Promise<ReadLearningsOutput>;
+export declare const readLearningsToolDef: ToolDef<typeof schema>;
+export {};

package/dist/tools/read-learnings.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { readLearnings, tailRecent, } from "../learning/store.js";
+import { formatLearningsForPrompt } from "../learning/format.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),
+    /** Cap rendered/returned entries. Default 50. */
+    limit: z.number().int().positive().max(200).optional().default(50),
+    /** When set, restrict to learnings for this agent. */
+    agent: z.enum(AGENT_NAMES_TUPLE).optional(),
+    /** When set, restrict to accepts or rejects. Default both. */
+    decision: z.enum(["accept", "reject"]).optional(),
+    /**
+     * When set, filter scope-tagged entries to those whose scope glob matches
+     * at least one of these files. Entries without a scope always pass.
+     */
+    changed_files: z.array(z.string().min(1).max(4096)).max(5000).optional(),
+    /**
+     * When true (default), also return the rendered markdown block ready to
+     * inject into an agent / consolidator prompt. When false, only the entries
+     * array. Skip the render when the caller will format their own.
+     */
+    include_rendered: z.boolean().optional().default(true),
+});
+/**
+ * Read recent learnings from `.squad/learnings.jsonl` (path overridable via
+ * `.squad.yaml`.learnings.path). Returns the filtered entries plus a
+ * pre-rendered markdown block ready to inject into an agent / consolidator
+ * prompt. Pure-ish — reads filesystem, no writes.
+ */
+export async function readLearningsTool(input) {
+    const ctx = createSafePathContext();
+    const safeRoot = await resolveSafePath(input.workspace_root, ".", ctx);
+    const config = await readSquadYaml(safeRoot);
+    // Honor the master switch — if learnings disabled, return empty without
+    // touching the filesystem (the user explicitly turned it off).
+    if (!config.learnings.enabled) {
+        return { entries: [], total_in_store: 0, rendered: "", source: null };
+    }
+    const configuredPath = config.learnings.path;
+    const allEntries = await readLearnings(safeRoot, { configuredPath });
+    const filtered = tailRecent(allEntries, input.limit, {
+        ...(input.agent !== undefined ? { agent: input.agent } : {}),
+        ...(input.decision !== undefined ? { decision: input.decision } : {}),
+    });
+    const rendered = input.include_rendered
+        ? formatLearningsForPrompt(filtered, {
+            ...(input.changed_files ? { changedFiles: input.changed_files } : {}),
+            limit: input.limit,
+        })
+        : "";
+    return {
+        entries: filtered,
+        total_in_store: allEntries.length,
+        rendered,
+        source: allEntries.length > 0
+            ? `${safeRoot}/${configuredPath ?? ".squad/learnings.jsonl"}`
+            : null,
+    };
+}
+export const readLearningsToolDef = {
+    name: "read_learnings",
+    description: "Read recent team decisions from `.squad/learnings.jsonl` (path overridable via .squad.yaml.learnings.path). " +
+        "Returns the filtered entries plus a pre-rendered markdown block ready to inject into agent / consolidator prompts. " +
+        "Filters: agent, decision (accept|reject), changed_files (matches scoped entries against these paths). " +
+        "Used by the /squad-review skill in Phase 5 (advisory) and Phase 10 (consolidation) to make the squad less repetitive over time.",
+    schema,
+    handler: readLearningsTool,
+};
+//# sourceMappingURL=read-learnings.js.map

package/dist/tools/read-learnings.js.map

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

package/dist/tools/read-squad-config.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { ToolDef } from "./registry.js";
+import { type ResolvedSquadConfig } from "../config/squad-yaml.js";
+declare const schema: z.ZodObject<{
+    workspace_root: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspace_root: string;
+}, {
+    workspace_root: string;
+}>;
+type Input = z.infer<typeof schema>;
+/**
+ * MCP tool wrapper around the YAML reader. Lets non-Claude-Code clients (or
+ * non-composer callers) inspect the resolved config explicitly. Pure tools
+ * (apply_consolidation_rules, score_rubric, select_squad) do NOT call this —
+ * the composers (compose_squad_workflow, compose_advisory_bundle) read
+ * .squad.yaml automatically when they receive workspace_root, then pass the
+ * concrete values down. This tool is for direct introspection and for clients
+ * that want to construct a tailored bundle themselves.
+ */
+export declare function readSquadConfig(input: Input): Promise<ResolvedSquadConfig>;
+export declare const readSquadConfigTool: ToolDef<typeof schema>;
+export {};