cclaw-cli 0.51.23 → 0.51.25

package/dist/config.d.ts

@@ -49,7 +49,7 @@ export declare function readConfig(projectRoot: string, options?: ReadConfigOpti
  * the user set them explicitly. Keeps the default template small and honest:
  * only knobs a new user would meaningfully flip show up.
  */
-type AdvancedConfigKey = "tddTestGlobs" | "tdd" | "compound" | "defaultTrack" | "languageRulePacks" | "trackHeuristics" | "sliceReview" | "ironLaws" | "optInAudits" | "reviewLoop";
+type AdvancedConfigKey = "vcs" | "tddTestGlobs" | "tdd" | "compound" | "defaultTrack" | "languageRulePacks" | "trackHeuristics" | "sliceReview" | "ironLaws" | "optInAudits" | "reviewLoop";
 /**
  * Options controlling the serialisation shape of `config.yaml`.
  *

package/dist/config.js

@@ -16,6 +16,7 @@ const ALLOWED_CONFIG_KEYS = new Set([
     "version",
     "flowVersion",
     "harnesses",
+    "vcs",
     "strictness",
     "tddTestGlobs",
     "tdd",
@@ -51,6 +52,7 @@ const MINIMAL_CONFIG_KEYS = [
     "version",
     "flowVersion",
     "harnesses",
+    "vcs",
     "strictness",
     "gitHookGuards"
 ];
@@ -142,11 +144,13 @@ export function createDefaultConfig(harnesses = DEFAULT_HARNESSES, defaultTrack
         version: CCLAW_VERSION,
         flowVersion: FLOW_VERSION,
         harnesses,
+        vcs: "git-local-only",
         strictness: "advisory",
         tddTestGlobs: [...tddTestPathPatterns],
         tdd: {
             testPathPatterns: tddTestPathPatterns,
-            productionPathPatterns: tddProductionPathPatterns
+            productionPathPatterns: tddProductionPathPatterns,
+            verificationRef: "auto"
         },
         compound: {
             recurrenceThreshold: DEFAULT_COMPOUND_RECURRENCE_THRESHOLD
@@ -244,6 +248,16 @@ export async function readConfig(projectRoot, options = {}) {
     const harnesses = hasHarnessesField
         ? [...new Set(validatedHarnesses)]
         : DEFAULT_HARNESSES;
+    const vcsRaw = parsed.vcs;
+    if (Object.prototype.hasOwnProperty.call(parsed, "vcs") &&
+        vcsRaw !== "git-with-remote" &&
+        vcsRaw !== "git-local-only" &&
+        vcsRaw !== "none") {
+        throw configValidationError(fullPath, `"vcs" must be one of: git-with-remote, git-local-only, none`);
+    }
+    const vcs = vcsRaw === "git-with-remote" || vcsRaw === "git-local-only" || vcsRaw === "none"
+        ? vcsRaw
+        : "git-local-only";
     const strictnessRaw = parsed.strictness;
     if (Object.prototype.hasOwnProperty.call(parsed, "strictness") &&
         strictnessRaw !== "advisory" &&
@@ -258,16 +272,24 @@ export async function readConfig(projectRoot, options = {}) {
     const tddRaw = parsed.tdd;
     let explicitTddTestPathPatterns;
     let explicitTddProductionPathPatterns;
+    let explicitTddVerificationRef;
     if (hasTddField) {
         if (!isRecord(tddRaw)) {
             throw configValidationError(fullPath, `"tdd" must be an object`);
         }
-        const unknownTddKeys = Object.keys(tddRaw).filter((key) => key !== "testPathPatterns" && key !== "productionPathPatterns");
+        const unknownTddKeys = Object.keys(tddRaw).filter((key) => key !== "testPathPatterns" && key !== "productionPathPatterns" && key !== "verificationRef");
         if (unknownTddKeys.length > 0) {
             throw configValidationError(fullPath, `"tdd" has unknown key(s): ${unknownTddKeys.join(", ")}`);
         }
         explicitTddTestPathPatterns = validateStringArray(tddRaw.testPathPatterns, "tdd.testPathPatterns", fullPath);
         explicitTddProductionPathPatterns = validateStringArray(tddRaw.productionPathPatterns, "tdd.productionPathPatterns", fullPath);
+        if (tddRaw.verificationRef !== undefined &&
+            tddRaw.verificationRef !== "auto" &&
+            tddRaw.verificationRef !== "required" &&
+            tddRaw.verificationRef !== "disabled") {
+            throw configValidationError(fullPath, '"tdd.verificationRef" must be one of: auto, required, disabled');
+        }
+        explicitTddVerificationRef = tddRaw.verificationRef;
     }
     if (tddTestGlobsRaw !== undefined &&
         explicitTddTestPathPatterns !== undefined &&
@@ -508,11 +530,13 @@ export async function readConfig(projectRoot, options = {}) {
         version: parsed.version ?? CCLAW_VERSION,
         flowVersion: parsed.flowVersion ?? FLOW_VERSION,
         harnesses,
+        vcs,
         strictness,
         tddTestGlobs,
         tdd: {
             testPathPatterns: resolvedTddTestPathPatterns,
-            productionPathPatterns: resolvedTddProductionPathPatterns
+            productionPathPatterns: resolvedTddProductionPathPatterns,
+            verificationRef: explicitTddVerificationRef ?? "auto"
         },
         compound: {
             recurrenceThreshold: compoundRecurrenceThreshold
@@ -538,6 +562,7 @@ function buildSerializableConfig(config, options = {}) {
         "version",
         "flowVersion",
         "harnesses",
+        "vcs",
         "strictness",
         "tddTestGlobs",
         "tdd",

package/dist/content/core-agents.d.ts

@@ -6,6 +6,16 @@
  * need isolated subagent context lives in `.cclaw/skills/research/*.md`
  * playbooks and is executed in-thread by the primary agent.
  */
+export interface AgentReturnSchema {
+    /** Field carrying the terminal verdict/status token. */
+    statusField: string;
+    /** Exact allowed terminal values for this agent's first structured return. */
+    allowedStatuses: string[];
+    /** Fields the controller should expect in every completed response. */
+    requiredFields: string[];
+    /** Fields that must cite artifact anchors, commands, or code locations when applicable. */
+    evidenceFields: string[];
+}
 export interface AgentDefinition {
     /** Kebab-case identifier, e.g. `"reviewer"`. */
     name: string;
@@ -19,11 +29,13 @@ export interface AgentDefinition {
     activation: "proactive" | "on-demand" | "mandatory";
     /** cclaw flow stages this agent is designed to support. */
     relatedStages: string[];
+    /** Strict terminal return contract rendered into materialized agent files. */
+    returnSchema: AgentReturnSchema;
     /** Markdown body rendered below the YAML frontmatter. */
     body: string;
 }
 /**
- * Canonical specialist roster (core-5) materialized under `.cclaw/agents/`.
+ * Canonical specialist roster materialized under `.cclaw/agents/`.
  *
  * Declared with `satisfies` so the array retains literal `name` types for
  * downstream type-level consumers (e.g. `AgentName`), while still being
@@ -32,12 +44,58 @@ export interface AgentDefinition {
  * to `string` and break the compile-time drift guard.
  */
 export declare const CCLAW_AGENTS: readonly [{
+    readonly name: "researcher";
+    readonly description: "PROACTIVE when context readiness, repo search, reference patterns, or external docs could change a stage decision. MUST summarize search-before-read evidence before large reads.";
+    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
+    readonly model: "fast";
+    readonly activation: "proactive";
+    readonly relatedStages: ["brainstorm", "scope", "design", "plan"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
     readonly name: "planner";
     readonly description: "MANDATORY for scope/design/plan and PROACTIVE for high-ambiguity work. MUST BE USED when sequencing, dependency mapping, or risk trade-offs are required before coding.";
     readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
     readonly model: "deep";
     readonly activation: "mandatory";
     readonly relatedStages: ["brainstorm", "scope", "design", "spec", "plan"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "product-manager";
+    readonly description: "PROACTIVE during brainstorm/scope when product value, persona/JTBD, success metric, or why-now framing is unclear. Use for product discovery, not implementation.";
+    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
+    readonly model: "balanced";
+    readonly activation: "proactive";
+    readonly relatedStages: ["brainstorm", "scope"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "critic";
+    readonly description: "PROACTIVE during brainstorm/scope/design when premises, alternatives, cost, rollback, or hidden assumptions need adversarial pressure.";
+    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
+    readonly model: "balanced";
+    readonly activation: "proactive";
+    readonly relatedStages: ["brainstorm", "scope", "design"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "architect";
+    readonly description: "MANDATORY during design. MUST BE USED to validate architecture boundaries, alternatives, failure modes, rollout, and spec handoff before implementation.";
+    readonly tools: ["Read", "Grep", "Glob", "WebSearch"];
+    readonly model: "deep";
+    readonly activation: "mandatory";
+    readonly relatedStages: ["design"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "spec-validator";
+    readonly description: "MANDATORY during standard/deep spec. MUST BE USED to validate measurable acceptance criteria, assumptions, edge cases, and testability mapping.";
+    readonly tools: ["Read", "Grep", "Glob"];
+    readonly model: "balanced";
+    readonly activation: "mandatory";
+    readonly relatedStages: ["spec"];
+    readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
     readonly name: "reviewer";
@@ -46,6 +104,34 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly model: "balanced";
     readonly activation: "mandatory";
     readonly relatedStages: ["spec", "review", "ship"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "performance-reviewer";
+    readonly description: "PROACTIVE during review for hot paths, IO, data volume, caching, rendering, or algorithmic cost changes. Produces no-impact rationale when clean.";
+    readonly tools: ["Read", "Grep", "Glob"];
+    readonly model: "balanced";
+    readonly activation: "proactive";
+    readonly relatedStages: ["review"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "compatibility-reviewer";
+    readonly description: "PROACTIVE during design/review when public APIs, config, persisted data, CLI behavior, generated clients, or dependency versions may change.";
+    readonly tools: ["Read", "Grep", "Glob"];
+    readonly model: "balanced";
+    readonly activation: "proactive";
+    readonly relatedStages: ["design", "review"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "observability-reviewer";
+    readonly description: "PROACTIVE during design/review when diagnosis, telemetry, rollout visibility, or supportability could affect safe operation.";
+    readonly tools: ["Read", "Grep", "Glob"];
+    readonly model: "balanced";
+    readonly activation: "proactive";
+    readonly relatedStages: ["design", "review"];
+    readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
     readonly name: "security-reviewer";
@@ -54,6 +140,7 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly model: "balanced";
     readonly activation: "mandatory";
     readonly relatedStages: ["design", "review", "ship"];
+    readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
     readonly name: "test-author";
@@ -62,6 +149,16 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly model: "balanced";
     readonly activation: "mandatory";
     readonly relatedStages: ["tdd"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "release-reviewer";
+    readonly description: "MANDATORY during ship. MUST BE USED for release readiness, rollback, finalization mode, evidence freshness, and victory detector checks.";
+    readonly tools: ["Read", "Grep", "Glob", "Bash"];
+    readonly model: "balanced";
+    readonly activation: "mandatory";
+    readonly relatedStages: ["ship"];
+    readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }, {
     readonly name: "doc-updater";
@@ -70,6 +167,34 @@ export declare const CCLAW_AGENTS: readonly [{
     readonly model: "fast";
     readonly activation: "mandatory";
     readonly relatedStages: ["tdd", "ship"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "slice-implementer";
+    readonly description: "ON-DEMAND or PROACTIVE during TDD GREEN/REFACTOR for one bounded vertical slice after RED evidence exists and file ownership is non-overlapping.";
+    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
+    readonly model: "balanced";
+    readonly activation: "on-demand";
+    readonly relatedStages: ["tdd"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "implementer";
+    readonly description: "ON-DEMAND worker for one scoped implementation slice. Use only with self-contained task text, explicit file boundaries, and verification expectations.";
+    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
+    readonly model: "balanced";
+    readonly activation: "on-demand";
+    readonly relatedStages: ["tdd"];
+    readonly returnSchema: AgentReturnSchema;
+    readonly body: string;
+}, {
+    readonly name: "fixer";
+    readonly description: "ON-DEMAND fresh worker after review FAIL/PARTIAL evidence. Must fix only the cited criterion within explicit allowed files.";
+    readonly tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"];
+    readonly model: "balanced";
+    readonly activation: "on-demand";
+    readonly relatedStages: ["review", "tdd"];
+    readonly returnSchema: AgentReturnSchema;
     readonly body: string;
 }];
 /**
@@ -87,9 +212,10 @@ export declare function agentMarkdown(agent: AgentDefinition): string;
  */
 export declare function agentRoutingTable(): string;
 /**
- * Cost tier routing for the core-5 agent roster.
+ * Cost tier routing for the specialist agent roster.
  */
 export declare function agentCostTierTable(): string;
+export declare function agentRegistryMatrix(): string;
 /**
  * AGENTS.md-ready section describing cclaw’s specialist delegation model.
  */