cc-codeconductor 1.1.0 → 1.2.0

package/dist/library.js

@@ -117,7 +117,7 @@ function validateCanonicalTaskCard(data) {
 function validateProductEvent(data) {
   return ProductEventSchema.parse(data);
 }
-var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, ContractTargetSchema, ContractFormatSchema, AgentContractSchema, CouncilFindingSchema, CouncilVerdictInputSchema, ConsensusConfigSchema, CouncilVerdictSchema, ClaudeAgentFileSchema, OpenCodeAgentFileSchema, SentryStackFrameSchema, SentryWebhookSchema, MemoryPointerSchema, MemoryIndexSchema, GoalTaskSchema, GoalGraphSchema, ConfidenceLevelSchema, ProductNodeTypeSchema, GraphRelationSchema, KnowledgeEntitySchema, DecisionSchema, EvidenceSchema, CanonicalTaskCardStatusSchema, CanonicalTaskCardSchema, ProductGraphNodeSchema, ProductGraphEdgeSchema, ProductGraphSchema, ProductMetaSchema, ProductEventTypeSchema, ProductEventSchema, OperationalStateSchema, StrategicMemorySchema, ImpactReportSchema, BusinessReviewOutputSchema, VerificationReportSchema, BacklogStatusSchema, BacklogTypeSchema, BacklogPrioritySchema, BacklogGlobalSchema, BacklogItemSchema, BacklogDocumentSchema, OpenspecTaskCardPhaseSchema, OpenspecTaskCardStatusSchema, OpenspecTaskCardSchema, OpenspecStateSchema, WorkflowCommandSchema, CcepOutputFormatSchema, CommandEnvelopeSchema, WorkflowPhaseSchema, WorkflowRiskRuleSchema, WorkflowProfileSchema, ExecutionContextSchema, PlannerOutputSchema, AgentArtifactSchema, AgentOutputSchema, ImplementerTestsSchema, ImplementerOutputSchema, ReviewAxisSchema, ReviewFindingSchema, ReviewerOutputSchema, TechnicalPlanOutputSchema, ScorecardVerdictSchema, ScorecardCriterionIdSchema, ScorecardCriterionSchema, ScorecardRecordSchema, TaskOutcomeSourceSchema, TaskOutcomeStatusSchema, TaskOutcomeSchema, HarnessComponentIdSchema, HarnessComponentLayerSchema, HarnessToggleKindSchema, HarnessCatalogEntrySchema, HarnessCatalogSchema, HarnessOverlaySchema, HarnessExperimentSchema, HarnessSuiteTaskSchema, HarnessSuiteSchema, EvaluationIndexSchema, ExecutionProfileNameSchema, ExecutionProfileSchema;
+var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, ContractTargetSchema, ContractFormatSchema, AgentContractSchema, CouncilFindingSchema, CouncilVerdictInputSchema, ConsensusConfigSchema, CouncilVerdictSchema, ClaudeAgentFileSchema, OpenCodeAgentFileSchema, SentryStackFrameSchema, SentryWebhookSchema, MemoryPointerSchema, MemoryIndexSchema, GoalTaskSchema, GoalGraphSchema, ConfidenceLevelSchema, ProductNodeTypeSchema, GraphRelationSchema, KnowledgeEntitySchema, DecisionSchema, EvidenceSchema, CanonicalTaskCardStatusSchema, CanonicalTaskCardSchema, ProductGraphNodeSchema, ProductGraphEdgeSchema, ProductGraphSchema, ProductMetaSchema, ProductEventTypeSchema, ProductEventSchema, OperationalStateSchema, StrategicMemorySchema, ImpactReportSchema, BusinessReviewOutputSchema, VerificationReportSchema, BacklogStatusSchema, BacklogTypeSchema, BacklogPrioritySchema, BacklogGlobalSchema, BacklogItemSchema, BacklogDocumentSchema, OpenspecTaskCardPhaseSchema, OpenspecTaskCardStatusSchema, OpenspecTaskCardSchema, OpenspecStateSchema, SpecAnalyzeFindingSchema, SpecAnalyzeReportSchema, WorkflowCommandSchema, CcepOutputFormatSchema, CommandEnvelopeSchema, WorkflowPhaseSchema, WorkflowRiskRuleSchema, WorkflowProfileSchema, ExecutionContextSchema, PlannerOutputSchema, AgentArtifactSchema, AgentOutputSchema, ImplementerTestsSchema, ImplementerOutputSchema, ReviewAxisSchema, ReviewFindingSchema, ReviewerOutputSchema, TechnicalPlanOutputSchema, ScorecardVerdictSchema, ScorecardCriterionIdSchema, ScorecardCriterionSchema, ScorecardRecordSchema, TaskOutcomeSourceSchema, TaskOutcomeStatusSchema, TaskOutcomeSchema, HarnessComponentIdSchema, HarnessComponentLayerSchema, HarnessToggleKindSchema, HarnessCatalogEntrySchema, HarnessCatalogSchema, HarnessOverlaySchema, HarnessExperimentSchema, HarnessSuiteTaskSchema, HarnessSuiteSchema, EvaluationIndexSchema, ExecutionProfileNameSchema, ExecutionProfileSchema;
 var init_schemas = __esm(() => {
   CouncilAgentSpecSchema = z.object({
     id: z.string(),
@@ -608,6 +608,24 @@ var init_schemas = __esm(() => {
     changePaths: z.record(z.string(), z.string()).optional().default({}),
     itemSnapshots: z.record(z.string(), z.string()).optional().default({})
   });
+  SpecAnalyzeFindingSchema = z.object({
+    severity: z.enum(["CRITICAL", "HIGH", "MEDIUM", "LOW"]),
+    code: z.string(),
+    message: z.string()
+  });
+  SpecAnalyzeReportSchema = z.object({
+    changePath: z.string(),
+    frIds: z.array(z.string()),
+    scIds: z.array(z.string()),
+    mappedFr: z.array(z.string()),
+    mappedSc: z.array(z.string()),
+    mappedToTests: z.array(z.string()),
+    frCoveragePct: z.number(),
+    scCoveragePct: z.number(),
+    testCoveragePct: z.number(),
+    findings: z.array(SpecAnalyzeFindingSchema),
+    stop: z.boolean()
+  });
   WorkflowCommandSchema = z.enum([
     "feature",
     "fix",
@@ -615,6 +633,7 @@ var init_schemas = __esm(() => {
     "review",
     "test-plan",
     "tdd-cycle",
+    "spec-mutation",
     "api-contract",
     "db-migration",
     "pagespeed",
@@ -1852,6 +1871,12 @@ async function loadTddSuiteEvidence(projectRoot, taskId, evidenceId) {
   }
   return ok({ capturedBy, suiteFailed, suitePassed });
 }
+async function hasTddRunnerEvidence(projectRoot, taskId) {
+  const collected = await collectTaskEvidence(projectRoot, taskId);
+  if (!collected.success)
+    return false;
+  return collected.data.records.some((ev) => ev.type === "tdd" && ev.source === TDD_EVIDENCE_SOURCE && ev.data?.capturedBy === TDD_CAPTURED_BY);
+}
 
 // src/core/orchestrator/runtime-orchestrator.ts
 async function rollbackTaskStatus(projectRoot, graph, task, previousStatus, previousState, cause) {
@@ -2636,6 +2661,7 @@ export {
   rollbackTaskStatus,
   loopStateMachine,
   loadTddSuiteEvidence,
+  hasTddRunnerEvidence,
   goalTaskToCanonicalCard,
   getReadyTasks,
   getNextTask,
@@ -2659,6 +2685,8 @@ export {
   TaskOutcomeSourceSchema,
   TaskOutcomeSchema,
   StrategicMemorySchema,
+  SpecAnalyzeReportSchema,
+  SpecAnalyzeFindingSchema,
   SentryWebhookSchema,
   SentryStackFrameSchema,
   ScorecardVerdictSchema,

package/dist/validation/schemas.d.ts

@@ -2145,11 +2145,81 @@ export declare const OpenspecStateSchema: z.ZodObject<{
     changePaths?: Record<string, string> | undefined;
     itemSnapshots?: Record<string, string> | undefined;
 }>;
-export declare const WorkflowCommandSchema: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
+export declare const SpecAnalyzeFindingSchema: z.ZodObject<{
+    severity: z.ZodEnum<["CRITICAL", "HIGH", "MEDIUM", "LOW"]>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+}, {
+    code: string;
+    message: string;
+    severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+}>;
+export declare const SpecAnalyzeReportSchema: z.ZodObject<{
+    changePath: z.ZodString;
+    frIds: z.ZodArray<z.ZodString, "many">;
+    scIds: z.ZodArray<z.ZodString, "many">;
+    mappedFr: z.ZodArray<z.ZodString, "many">;
+    mappedSc: z.ZodArray<z.ZodString, "many">;
+    mappedToTests: z.ZodArray<z.ZodString, "many">;
+    frCoveragePct: z.ZodNumber;
+    scCoveragePct: z.ZodNumber;
+    testCoveragePct: z.ZodNumber;
+    findings: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<["CRITICAL", "HIGH", "MEDIUM", "LOW"]>;
+        code: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    }, {
+        code: string;
+        message: string;
+        severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    }>, "many">;
+    stop: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    findings: {
+        code: string;
+        message: string;
+        severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    }[];
+    changePath: string;
+    frIds: string[];
+    scIds: string[];
+    mappedFr: string[];
+    mappedSc: string[];
+    mappedToTests: string[];
+    frCoveragePct: number;
+    scCoveragePct: number;
+    testCoveragePct: number;
+    stop: boolean;
+}, {
+    findings: {
+        code: string;
+        message: string;
+        severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    }[];
+    changePath: string;
+    frIds: string[];
+    scIds: string[];
+    mappedFr: string[];
+    mappedSc: string[];
+    mappedToTests: string[];
+    frCoveragePct: number;
+    scCoveragePct: number;
+    testCoveragePct: number;
+    stop: boolean;
+}>;
+export declare const WorkflowCommandSchema: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "spec-mutation", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
 export declare const CcepOutputFormatSchema: z.ZodEnum<["taskcard", "plan", "verdict"]>;
 export declare const CommandEnvelopeSchema: z.ZodObject<{
     protocolVersion: z.ZodLiteral<"ccep-1">;
-    command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
+    command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "spec-mutation", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
     userRequest: z.ZodString;
     projectId: z.ZodString;
     repoContext: z.ZodObject<{
@@ -2192,7 +2262,7 @@ export declare const CommandEnvelopeSchema: z.ZodObject<{
         maxVariance: "low";
     }>;
 }, "strip", z.ZodTypeAny, {
-    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
     constraints: {
         outputFormat: "taskcard" | "plan" | "verdict";
         needConfirmation: boolean;
@@ -2212,7 +2282,7 @@ export declare const CommandEnvelopeSchema: z.ZodObject<{
         maxVariance: "low";
     };
 }, {
-    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
     constraints: {
         outputFormat: "taskcard" | "plan" | "verdict";
         needConfirmation: boolean;
@@ -2289,7 +2359,7 @@ export declare const WorkflowRiskRuleSchema: z.ZodObject<{
 export declare const WorkflowProfileSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     version: z.ZodNumber;
-    command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
+    command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "spec-mutation", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
     taskCard: z.ZodOptional<z.ZodObject<{
         type: z.ZodString;
         requiredFields: z.ZodArray<z.ZodString, "many">;
@@ -2390,7 +2460,7 @@ export declare const WorkflowProfileSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     version: number;
-    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
     phases: {
         id: string;
         type?: string | undefined;
@@ -2425,7 +2495,7 @@ export declare const WorkflowProfileSchema: z.ZodEffects<z.ZodObject<{
 }, {
     id: string;
     version: number;
-    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
     phases: {
         id: string;
         type?: string | undefined;
@@ -2460,7 +2530,7 @@ export declare const WorkflowProfileSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     id: string;
     version: number;
-    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
     phases: {
         id: string;
         type?: string | undefined;
@@ -2495,7 +2565,7 @@ export declare const WorkflowProfileSchema: z.ZodEffects<z.ZodObject<{
 }, {
     id: string;
     version: number;
-    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+    command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
     phases: {
         id: string;
         type?: string | undefined;
@@ -2531,7 +2601,7 @@ export declare const WorkflowProfileSchema: z.ZodEffects<z.ZodObject<{
 export declare const ExecutionContextSchema: z.ZodObject<{
     envelope: z.ZodObject<{
         protocolVersion: z.ZodLiteral<"ccep-1">;
-        command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
+        command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "spec-mutation", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
         userRequest: z.ZodString;
         projectId: z.ZodString;
         repoContext: z.ZodObject<{
@@ -2574,7 +2644,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
             maxVariance: "low";
         }>;
     }, "strip", z.ZodTypeAny, {
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         constraints: {
             outputFormat: "taskcard" | "plan" | "verdict";
             needConfirmation: boolean;
@@ -2594,7 +2664,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
             maxVariance: "low";
         };
     }, {
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         constraints: {
             outputFormat: "taskcard" | "plan" | "verdict";
             needConfirmation: boolean;
@@ -2617,7 +2687,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     profile: z.ZodEffects<z.ZodObject<{
         id: z.ZodString;
         version: z.ZodNumber;
-        command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
+        command: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "spec-mutation", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
         taskCard: z.ZodOptional<z.ZodObject<{
             type: z.ZodString;
             requiredFields: z.ZodArray<z.ZodString, "many">;
@@ -2718,7 +2788,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         version: number;
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         phases: {
             id: string;
             type?: string | undefined;
@@ -2753,7 +2823,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     }, {
         id: string;
         version: number;
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         phases: {
             id: string;
             type?: string | undefined;
@@ -2788,7 +2858,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     }>, {
         id: string;
         version: number;
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         phases: {
             id: string;
             type?: string | undefined;
@@ -2823,7 +2893,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     }, {
         id: string;
         version: number;
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         phases: {
             id: string;
             type?: string | undefined;
@@ -2857,19 +2927,19 @@ export declare const ExecutionContextSchema: z.ZodObject<{
         intakeSchema?: string | undefined;
     }>;
     intent: z.ZodObject<{
-        type: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
+        type: z.ZodEnum<["feature", "fix", "refactor", "review", "test-plan", "tdd-cycle", "spec-mutation", "api-contract", "db-migration", "pagespeed", "openspec", "backlog", "scorecard", "council", "iterative", "explore", "triage", "prototype", "handoff", "clarify", "security"]>;
         goal: z.ZodString;
         domain: z.ZodOptional<z.ZodString>;
         entity: z.ZodOptional<z.ZodString>;
         operation: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         goal: string;
         domain?: string | undefined;
         entity?: string | undefined;
         operation?: string | undefined;
     }, {
-        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         goal: string;
         domain?: string | undefined;
         entity?: string | undefined;
@@ -2932,7 +3002,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     profile: {
         id: string;
         version: number;
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         phases: {
             id: string;
             type?: string | undefined;
@@ -2967,7 +3037,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     };
     outputSchema: string;
     envelope: {
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         constraints: {
             outputFormat: "taskcard" | "plan" | "verdict";
             needConfirmation: boolean;
@@ -2988,7 +3058,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
         };
     };
     intent: {
-        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         goal: string;
         domain?: string | undefined;
         entity?: string | undefined;
@@ -3017,7 +3087,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     profile: {
         id: string;
         version: number;
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         phases: {
             id: string;
             type?: string | undefined;
@@ -3052,7 +3122,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
     };
     outputSchema: string;
     envelope: {
-        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        command: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         constraints: {
             outputFormat: "taskcard" | "plan" | "verdict";
             needConfirmation: boolean;
@@ -3073,7 +3143,7 @@ export declare const ExecutionContextSchema: z.ZodObject<{
         };
     };
     intent: {
-        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
+        type: "council" | "security" | "feature" | "fix" | "refactor" | "review" | "test-plan" | "tdd-cycle" | "spec-mutation" | "api-contract" | "db-migration" | "pagespeed" | "openspec" | "backlog" | "scorecard" | "iterative" | "explore" | "triage" | "prototype" | "handoff" | "clarify";
         goal: string;
         domain?: string | undefined;
         entity?: string | undefined;
@@ -3920,6 +3990,7 @@ export type OpenspecTaskCardPhaseInput = z.infer<typeof OpenspecTaskCardPhaseSch
 export type OpenspecTaskCardStatusInput = z.infer<typeof OpenspecTaskCardStatusSchema>;
 export type OpenspecTaskCardInput = z.infer<typeof OpenspecTaskCardSchema>;
 export type OpenspecStateInput = z.infer<typeof OpenspecStateSchema>;
+export type SpecAnalyzeReportInput = z.infer<typeof SpecAnalyzeReportSchema>;
 export type ScorecardVerdictInput = z.infer<typeof ScorecardVerdictSchema>;
 export type ScorecardCriterionInput = z.infer<typeof ScorecardCriterionSchema>;
 export type ScorecardRecordInput = z.infer<typeof ScorecardRecordSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-codeconductor",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
   "keywords": [
     "ai",

package/presets/agy/AGENTS.md

@@ -72,6 +72,7 @@ Antigravity CLI loads custom slash commands from `.agents/workflows/*.md`. The f
 | `/cc-review`     | Runs a structured, multi-perspective code review and audit         |
 | `/cc-test-plan`  | Generates a structured test plan for a given scope                 |
 | `/cc-tdd-cycle`  | Runs a Test-Driven Development (TDD) cycle                         |
+| `/cc-spec-mutation` | Spec-locked TDD with SHA-256 freeze and mutation-testing gate   |
 | `/cc-api-contract`| Handles API contract modification and validation                  |
 | `/cc-db-migration`| Coordinates database schema migrations safely                      |
 | `/cc-iterative`  | Advanced iterative workflow — wayfinding, grilling, TDD, council |
@@ -141,7 +142,7 @@ When multiple signals apply, take the highest risk level. Do not average.
 
 **Does not:** Write code. Execute tests. Push to any branch.
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Responsibilities:**
 1. Validate the Task Card before doing anything else.
@@ -189,7 +190,7 @@ High-risk checkpoint: [yes | no — if yes, describe what triggers a stop]
 - bash: `deny`
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Intake process:**
 1. Read the entire request before asking anything.
@@ -234,7 +235,7 @@ High-risk checkpoint: [yes | no — if yes, describe what triggers a stop]
 - bash: `allow` (git log, git diff, git status)
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Repo Map format:**
 ```markdown
@@ -269,7 +270,7 @@ High-risk checkpoint: [yes | no — if yes, describe what triggers a stop]
 - bash: `deny`
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Does not:** Write files. Execute commands. Make routing decisions.
 
@@ -293,7 +294,7 @@ When the orchestrator receives a GoalGraph, it delegates tasks in dependency ord
 - bash: `deny`
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Technical Plan format:**
 ```markdown
@@ -330,7 +331,7 @@ When the orchestrator receives a GoalGraph, it delegates tasks in dependency ord
 - bash: `allow` (build, test, and lint commands only)
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Pre-implementation checklist:**
 1. Create a Git Worktree: `git worktree add ../<branch>-session <branch>`
@@ -371,7 +372,7 @@ When the orchestrator receives a GoalGraph, it delegates tasks in dependency ord
 - bash: `allow` (test commands only)
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Coverage Summary format:**
 ```markdown
@@ -400,7 +401,7 @@ When the orchestrator receives a GoalGraph, it delegates tasks in dependency ord
 - bash: `allow` (git diff, git status, test commands)
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 **Review Axes & Gates:**
 - **Simplicity Gate**: Flag overcomplicated/speculative code. Ask: "Would a senior engineer say this is overbuilt?"
@@ -458,7 +459,7 @@ When the orchestrator receives a GoalGraph, it delegates tasks in dependency ord
 - bash: `deny`
 - network: `deny`
 
-**Model:** `{{MODEL_GEMINI}}`
+**Model:** `{{MODEL}}`
 
 ---
 

package/presets/agy/hooks.json

@@ -7,7 +7,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "if [ -f \"./.agents/scripts/post-tool.sh\" ]; then bash ./.agents/scripts/post-tool.sh; else bash \"$HOME/.gemini/config/scripts/post-tool.sh\"; fi"
+            "command": "node -e \"const fs=require('fs'),p=['scripts/invoke-hook.cjs','.agents/scripts/invoke-hook.cjs'].find(f=>fs.existsSync(f));if(p)require(require('path').resolve(p));else{if(process.argv.includes('--format=agy')){process.stdout.write(process.argv.includes('post-tool')?'{}\\n':'{\\\"decision\\\":\\\"allow\\\"}\\n');}process.exit(0);}\" post-tool --format=agy"
           }
         ]
       }
@@ -21,7 +21,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "if [ -f \"./.agents/scripts/pre-tool.sh\" ]; then bash ./.agents/scripts/pre-tool.sh; else bash \"$HOME/.gemini/config/scripts/pre-tool.sh\"; fi"
+            "command": "node -e \"const fs=require('fs'),p=['scripts/invoke-hook.cjs','.agents/scripts/invoke-hook.cjs'].find(f=>fs.existsSync(f));if(p)require(require('path').resolve(p));else{if(process.argv.includes('--format=agy')){process.stdout.write(process.argv.includes('post-tool')?'{}\\n':'{\\\"decision\\\":\\\"allow\\\"}\\n');}process.exit(0);}\" pre-tool --format=agy"
           }
         ]
       }

package/presets/agy/scripts/invoke-hook.cjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const { existsSync } = require('node:fs');
+const { join, resolve } = require('node:path');
+
+const VALID_EVENTS = ['pre-tool', 'post-tool', 'session-start'];
+const SPAWN_TIMEOUT = 10000;
+
+const rawArgs = process.argv.slice(1);
+const args = rawArgs.filter((arg) => {
+  if (VALID_EVENTS.includes(arg) || arg.startsWith('-')) return true;
+  return false;
+});
+
+const event = args.find((a) => VALID_EVENTS.includes(a)) || 'pre-tool';
+const extra = args.filter((a) => a !== event);
+const isAgy = process.argv.some((a) => a === '--format=agy') || extra.includes('--format=agy');
+
+function findProjectRoot() {
+  const candidates = [
+    process.env.PROJECT_ROOT,
+    process.env.WORKSPACE_DIR,
+    resolve(__dirname, '..', '..'),
+    process.cwd(),
+  ].filter(Boolean);
+
+  for (const dir of candidates) {
+    if (
+      existsSync(join(dir, 'package.json')) ||
+      existsSync(join(dir, '.git')) ||
+      existsSync(join(dir, '.agents')) ||
+      existsSync(join(dir, '.claude'))
+    ) {
+      return dir;
+    }
+  }
+  return resolve(__dirname, '..', '..');
+}
+
+const projectRoot = findProjectRoot();
+
+function canRun(bin) {
+  try {
+    const result = spawnSync(bin, ['--version'], {
+      encoding: 'utf8',
+      windowsHide: true,
+      stdio: 'ignore',
+      timeout: SPAWN_TIMEOUT,
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+function tryRun(bin, runArgs) {
+  try {
+    const result = spawnSync(bin, runArgs, {
+      cwd: projectRoot,
+      stdio: 'inherit',
+      windowsHide: true,
+      env: process.env,
+      timeout: SPAWN_TIMEOUT,
+    });
+    if (result.error) {
+      return false;
+    }
+    if (result.status === 0) {
+      process.exit(0);
+    }
+    if (!isAgy && result.status === 2) {
+      process.exit(2);
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+function fallback() {
+  if (isAgy) {
+    if (event === 'post-tool' || event === 'session-start') {
+      process.stdout.write('{}\n');
+    } else {
+      process.stdout.write('{"decision":"allow"}\n');
+    }
+  }
+  process.exit(0);
+}
+
+try {
+  const srcMain = join(projectRoot, 'src', 'cli', 'main.ts');
+  if (existsSync(srcMain) && canRun('bun')) {
+    tryRun('bun', ['run', srcMain, 'hook', event, ...extra]);
+  }
+
+  const packaged = join(projectRoot, 'node_modules', 'cc-codeconductor', 'dist', 'index.js');
+  if (existsSync(packaged)) {
+    tryRun(process.execPath, [packaged, 'hook', event, ...extra]);
+  }
+
+  const localDist = join(projectRoot, 'dist', 'index.js');
+  if (existsSync(localDist)) {
+    tryRun(process.execPath, [localDist, 'hook', event, ...extra]);
+  }
+
+  tryRun('npx', ['--no-install', 'cc-codeconductor', 'hook', event, ...extra]);
+} catch {
+  // Ignore errors in runner attempts
+}
+
+fallback();
+