cc-codeconductor 1.4.2 → 1.5.1

package/dist/library.js

@@ -149,7 +149,7 @@ function validateProductEvent(data) {
 function validateSkillsRegistry(data) {
   return SkillsRegistrySchema.parse(data);
 }
-var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, SkillFrontmatterSchema, CommandFrontmatterSchema, TargetCapabilitiesSchema, 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, DeliveryRouteSchema, TokenUsageSchema, DeliveryTelemetrySchema, DeliveryLedgerTaskSchema, DeliveryLedgerSchema, DeliveryLedgerRequestSchema, TaskOutcomeSchema, HarnessComponentIdSchema, HarnessComponentLayerSchema, HarnessToggleKindSchema, HarnessCatalogEntrySchema, HarnessCatalogSchema, HarnessOverlaySchema, HarnessExperimentSchema, HarnessSuiteTaskSchema, HarnessSuiteSchema, EvaluationIndexSchema, ExecutionProfileNameSchema, ExecutionProfileSchema, SkillsRegistrySchema;
+var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, SkillFrontmatterSchema, CommandFrontmatterSchema, TargetCapabilitiesSchema, 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, FixIntakeOutputSchema, ScorecardVerdictSchema, ScorecardCriterionIdSchema, ScorecardCriterionSchema, ScorecardRecordSchema, TaskOutcomeSourceSchema, TaskOutcomeStatusSchema, DeliveryRouteSchema, TokenUsageSchema, DeliveryTelemetrySchema, DeliveryLedgerTaskSchema, DeliveryLedgerSchema, HandoffEnvelopeSchema, RepoRelativePathSchema, DeliveryLedgerRequestSchema, TaskOutcomeSchema, HarnessComponentIdSchema, HarnessComponentLayerSchema, HarnessToggleKindSchema, HarnessCatalogEntrySchema, HarnessCatalogSchema, HarnessOverlaySchema, HarnessExperimentSchema, HarnessSuiteTaskSchema, HarnessSuiteSchema, EvaluationIndexSchema, ExecutionProfileNameSchema, ExecutionProfileSchema, SkillsRegistrySchema;
 var init_schemas = __esm(() => {
   init_runner_target();
   CouncilAgentSpecSchema = z.object({
@@ -226,6 +226,7 @@ var init_schemas = __esm(() => {
     "append",
     "merge-json",
     "merge-managed",
+    "create-only",
     "skip"
   ]);
   ManifestEntrySchema = z.object({
@@ -530,7 +531,8 @@ var init_schemas = __esm(() => {
     "goal.updated",
     "blocker.detected",
     "verification.completed",
-    "feedback.processed"
+    "feedback.processed",
+    "context.compiled"
   ]);
   ProductEventSchema = z.object({
     id: z.string(),
@@ -875,6 +877,11 @@ var init_schemas = __esm(() => {
     risks: z.array(z.string()).default([]),
     openQuestions: z.array(z.string()).optional()
   });
+  FixIntakeOutputSchema = z.object({
+    actualBehavior: z.string(),
+    expectedBehavior: z.string(),
+    reproductionSteps: z.array(z.string())
+  });
   ScorecardVerdictSchema = z.enum(["PASS", "REVISE", "REJECT"]);
   ScorecardCriterionIdSchema = z.enum([
     "acceptance",
@@ -946,16 +953,51 @@ var init_schemas = __esm(() => {
     nextStep: z.string().min(1),
     memoryTopicKey: z.string().min(1),
     workspace: z.record(z.string(), z.string()),
+    technicalPlanPath: z.string().min(1).optional(),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime()
   });
+  HandoffEnvelopeSchema = z.object({
+    version: z.literal(1),
+    task: z.object({
+      id: z.string().min(1),
+      objective: z.string().min(1),
+      acceptanceCriteria: z.array(z.string().min(1)),
+      status: CanonicalTaskCardStatusSchema
+    }),
+    decisions: z.object({
+      constraints: z.array(z.string()),
+      unresolved: z.array(z.string())
+    }),
+    scope: z.object({
+      relevantFiles: z.array(z.string()),
+      boundaries: z.array(z.string())
+    }),
+    verification: z.object({
+      evidence: z.array(z.string())
+    }),
+    change: z.object({
+      touchedFiles: z.array(z.string())
+    }),
+    next: z.object({
+      role: z.string().min(1),
+      objective: z.string().min(1)
+    }),
+    sources: z.object({
+      deliveryLedger: z.string().min(1),
+      memoryTopicKey: z.string().min(1),
+      technicalPlanPath: z.string().min(1).optional()
+    })
+  });
+  RepoRelativePathSchema = z.string().min(1).refine((path) => !/^([/\\]|[A-Za-z]:)/.test(path) && !path.split(/[/\\]/).includes(".."), 'Path must be relative to the repository and must not contain ".." segments');
   DeliveryLedgerRequestSchema = z.object({
     id: z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/),
     authorized: z.boolean(),
     route: DeliveryRouteSchema,
     taskCard: CanonicalTaskCardSchema,
     tasks: z.array(DeliveryLedgerTaskSchema).min(1),
-    nextStep: z.string().min(1)
+    nextStep: z.string().min(1),
+    technicalPlanPath: RepoRelativePathSchema.optional()
   });
   TaskOutcomeSchema = z.object({
     id: z.string(),
@@ -2970,9 +3012,11 @@ export {
   ExecutionContextSchema,
   ExecutionProfileNameSchema,
   ExecutionProfileSchema,
+  FixIntakeOutputSchema,
   GoalGraphSchema,
   GoalTaskSchema,
   GraphRelationSchema,
+  HandoffEnvelopeSchema,
   HarnessCatalogEntrySchema,
   HarnessCatalogSchema,
   HarnessComponentIdSchema,

package/dist/validation/schemas.d.ts

@@ -358,24 +358,24 @@ export declare const RunnerTargetSchema: z.ZodEnum<["opencode", "claude", "codex
 /**
  * Install manifest schemas
  */
-export declare const InstallStrategySchema: z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "skip"]>;
+export declare const InstallStrategySchema: z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "create-only", "skip"]>;
 export declare const ManifestEntrySchema: z.ZodObject<{
     src: z.ZodString;
     dest: z.ZodString;
-    strategy: z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "skip"]>;
-    globalStrategy: z.ZodOptional<z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "skip"]>>;
+    strategy: z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "create-only", "skip"]>;
+    globalStrategy: z.ZodOptional<z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "create-only", "skip"]>>;
     template: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     src: string;
     dest: string;
-    strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip";
-    globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip" | undefined;
+    strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip";
+    globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip" | undefined;
     template?: boolean | undefined;
 }, {
     src: string;
     dest: string;
-    strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip";
-    globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip" | undefined;
+    strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip";
+    globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip" | undefined;
     template?: boolean | undefined;
 }>;
 export declare const InstallManifestSchema: z.ZodObject<{
@@ -383,28 +383,28 @@ export declare const InstallManifestSchema: z.ZodObject<{
     entries: z.ZodArray<z.ZodObject<{
         src: z.ZodString;
         dest: z.ZodString;
-        strategy: z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "skip"]>;
-        globalStrategy: z.ZodOptional<z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "skip"]>>;
+        strategy: z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "create-only", "skip"]>;
+        globalStrategy: z.ZodOptional<z.ZodEnum<["overwrite", "append", "merge-json", "merge-managed", "create-only", "skip"]>>;
         template: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         src: string;
         dest: string;
-        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip";
-        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip" | undefined;
+        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip";
+        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip" | undefined;
         template?: boolean | undefined;
     }, {
         src: string;
         dest: string;
-        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip";
-        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip" | undefined;
+        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip";
+        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip" | undefined;
         template?: boolean | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     entries: {
         src: string;
         dest: string;
-        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip";
-        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip" | undefined;
+        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip";
+        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip" | undefined;
         template?: boolean | undefined;
     }[];
     target: "opencode" | "claude" | "codex" | "gemini" | "cursor" | "agy" | "pi";
@@ -412,8 +412,8 @@ export declare const InstallManifestSchema: z.ZodObject<{
     entries: {
         src: string;
         dest: string;
-        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip";
-        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "skip" | undefined;
+        strategy: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip";
+        globalStrategy?: "overwrite" | "append" | "merge-json" | "merge-managed" | "create-only" | "skip" | undefined;
         template?: boolean | undefined;
     }[];
     target: "opencode" | "claude" | "codex" | "gemini" | "cursor" | "agy" | "pi";
@@ -1686,20 +1686,20 @@ export declare const ProductMetaSchema: z.ZodObject<{
     lastIngestAt?: string | undefined;
     sourceHashes?: Record<string, string> | undefined;
 }>;
-export declare const ProductEventTypeSchema: z.ZodEnum<["task.started", "task.completed", "decision.recorded", "evidence.added", "ingest.completed", "goal.updated", "blocker.detected", "verification.completed", "feedback.processed"]>;
+export declare const ProductEventTypeSchema: z.ZodEnum<["task.started", "task.completed", "decision.recorded", "evidence.added", "ingest.completed", "goal.updated", "blocker.detected", "verification.completed", "feedback.processed", "context.compiled"]>;
 export declare const ProductEventSchema: z.ZodObject<{
     id: z.ZodString;
-    type: z.ZodEnum<["task.started", "task.completed", "decision.recorded", "evidence.added", "ingest.completed", "goal.updated", "blocker.detected", "verification.completed", "feedback.processed"]>;
+    type: z.ZodEnum<["task.started", "task.completed", "decision.recorded", "evidence.added", "ingest.completed", "goal.updated", "blocker.detected", "verification.completed", "feedback.processed", "context.compiled"]>;
     timestamp: z.ZodString;
     payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    type: "task.started" | "task.completed" | "decision.recorded" | "evidence.added" | "ingest.completed" | "goal.updated" | "blocker.detected" | "verification.completed" | "feedback.processed";
+    type: "task.started" | "task.completed" | "decision.recorded" | "evidence.added" | "ingest.completed" | "goal.updated" | "blocker.detected" | "verification.completed" | "feedback.processed" | "context.compiled";
     timestamp: string;
     payload: Record<string, unknown>;
 }, {
     id: string;
-    type: "task.started" | "task.completed" | "decision.recorded" | "evidence.added" | "ingest.completed" | "goal.updated" | "blocker.detected" | "verification.completed" | "feedback.processed";
+    type: "task.started" | "task.completed" | "decision.recorded" | "evidence.added" | "ingest.completed" | "goal.updated" | "blocker.detected" | "verification.completed" | "feedback.processed" | "context.compiled";
     timestamp: string;
     payload?: Record<string, unknown> | undefined;
 }>;
@@ -3648,6 +3648,19 @@ export declare const TechnicalPlanOutputSchema: z.ZodObject<{
     filesAffected?: string[] | undefined;
     openQuestions?: string[] | undefined;
 }>;
+export declare const FixIntakeOutputSchema: z.ZodObject<{
+    actualBehavior: z.ZodString;
+    expectedBehavior: z.ZodString;
+    reproductionSteps: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    actualBehavior: string;
+    expectedBehavior: string;
+    reproductionSteps: string[];
+}, {
+    actualBehavior: string;
+    expectedBehavior: string;
+    reproductionSteps: string[];
+}>;
 export declare const ScorecardVerdictSchema: z.ZodEnum<["PASS", "REVISE", "REJECT"]>;
 export declare const ScorecardCriterionIdSchema: z.ZodEnum<["acceptance", "minimal_diff", "tests", "regressions", "conventions", "documentation", "context_discipline", "cc_gain"]>;
 export declare const ScorecardCriterionSchema: z.ZodObject<{
@@ -3919,6 +3932,7 @@ export declare const DeliveryLedgerSchema: z.ZodObject<{
     nextStep: z.ZodString;
     memoryTopicKey: z.ZodString;
     workspace: z.ZodRecord<z.ZodString, z.ZodString>;
+    technicalPlanPath: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -3960,6 +3974,7 @@ export declare const DeliveryLedgerSchema: z.ZodObject<{
     nextStep: string;
     memoryTopicKey: string;
     workspace: Record<string, string>;
+    technicalPlanPath?: string | undefined;
 }, {
     id: string;
     version: 1;
@@ -3999,6 +4014,149 @@ export declare const DeliveryLedgerSchema: z.ZodObject<{
     nextStep: string;
     memoryTopicKey: string;
     workspace: Record<string, string>;
+    technicalPlanPath?: string | undefined;
+}>;
+/**
+ * A compact, derived view of a Delivery Ledger for a new agent or session.
+ * It intentionally contains references and current evidence, never a transcript.
+ */
+export declare const HandoffEnvelopeSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    task: z.ZodObject<{
+        id: z.ZodString;
+        objective: z.ZodString;
+        acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["draft", "ready", "in-progress", "review", "done", "blocked"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        status: "in-progress" | "done" | "blocked" | "draft" | "ready" | "review";
+        objective: string;
+        acceptanceCriteria: string[];
+    }, {
+        id: string;
+        status: "in-progress" | "done" | "blocked" | "draft" | "ready" | "review";
+        objective: string;
+        acceptanceCriteria: string[];
+    }>;
+    decisions: z.ZodObject<{
+        constraints: z.ZodArray<z.ZodString, "many">;
+        unresolved: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        constraints: string[];
+        unresolved: string[];
+    }, {
+        constraints: string[];
+        unresolved: string[];
+    }>;
+    scope: z.ZodObject<{
+        relevantFiles: z.ZodArray<z.ZodString, "many">;
+        boundaries: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        boundaries: string[];
+        relevantFiles: string[];
+    }, {
+        boundaries: string[];
+        relevantFiles: string[];
+    }>;
+    verification: z.ZodObject<{
+        evidence: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        evidence: string[];
+    }, {
+        evidence: string[];
+    }>;
+    change: z.ZodObject<{
+        touchedFiles: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        touchedFiles: string[];
+    }, {
+        touchedFiles: string[];
+    }>;
+    next: z.ZodObject<{
+        role: z.ZodString;
+        objective: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        objective: string;
+    }, {
+        role: string;
+        objective: string;
+    }>;
+    sources: z.ZodObject<{
+        deliveryLedger: z.ZodString;
+        memoryTopicKey: z.ZodString;
+        technicalPlanPath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        memoryTopicKey: string;
+        deliveryLedger: string;
+        technicalPlanPath?: string | undefined;
+    }, {
+        memoryTopicKey: string;
+        deliveryLedger: string;
+        technicalPlanPath?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    task: {
+        id: string;
+        status: "in-progress" | "done" | "blocked" | "draft" | "ready" | "review";
+        objective: string;
+        acceptanceCriteria: string[];
+    };
+    scope: {
+        boundaries: string[];
+        relevantFiles: string[];
+    };
+    decisions: {
+        constraints: string[];
+        unresolved: string[];
+    };
+    verification: {
+        evidence: string[];
+    };
+    change: {
+        touchedFiles: string[];
+    };
+    next: {
+        role: string;
+        objective: string;
+    };
+    sources: {
+        memoryTopicKey: string;
+        deliveryLedger: string;
+        technicalPlanPath?: string | undefined;
+    };
+}, {
+    version: 1;
+    task: {
+        id: string;
+        status: "in-progress" | "done" | "blocked" | "draft" | "ready" | "review";
+        objective: string;
+        acceptanceCriteria: string[];
+    };
+    scope: {
+        boundaries: string[];
+        relevantFiles: string[];
+    };
+    decisions: {
+        constraints: string[];
+        unresolved: string[];
+    };
+    verification: {
+        evidence: string[];
+    };
+    change: {
+        touchedFiles: string[];
+    };
+    next: {
+        role: string;
+        objective: string;
+    };
+    sources: {
+        memoryTopicKey: string;
+        deliveryLedger: string;
+        technicalPlanPath?: string | undefined;
+    };
 }>;
 export declare const DeliveryLedgerRequestSchema: z.ZodObject<{
     id: z.ZodString;
@@ -4091,6 +4249,7 @@ export declare const DeliveryLedgerRequestSchema: z.ZodObject<{
         title: string;
     }>, "many">;
     nextStep: z.ZodString;
+    technicalPlanPath: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     tasks: {
@@ -4126,6 +4285,7 @@ export declare const DeliveryLedgerRequestSchema: z.ZodObject<{
     route: "openspec" | "read-only" | "small" | "tracked";
     nextStep: string;
     authorized: boolean;
+    technicalPlanPath?: string | undefined;
 }, {
     id: string;
     tasks: {
@@ -4161,6 +4321,7 @@ export declare const DeliveryLedgerRequestSchema: z.ZodObject<{
     route: "openspec" | "read-only" | "small" | "tracked";
     nextStep: string;
     authorized: boolean;
+    technicalPlanPath?: string | undefined;
 }>;
 export declare const TaskOutcomeSchema: z.ZodObject<{
     id: z.ZodString;
@@ -4633,6 +4794,7 @@ export type HarnessSuiteTaskInput = z.infer<typeof HarnessSuiteTaskSchema>;
 export type HarnessSuiteInput = z.infer<typeof HarnessSuiteSchema>;
 export type WorkflowCommandInput = z.infer<typeof WorkflowCommandSchema>;
 export type DeliveryLedgerInput = z.infer<typeof DeliveryLedgerSchema>;
+export type HandoffEnvelopeInput = z.infer<typeof HandoffEnvelopeSchema>;
 export type DeliveryLedgerRequestInput = z.infer<typeof DeliveryLedgerRequestSchema>;
 export type CommandEnvelopeInput = z.infer<typeof CommandEnvelopeSchema>;
 export type WorkflowProfileInput = z.infer<typeof WorkflowProfileSchema>;

package/docs/generated/cli.md

@@ -24,6 +24,14 @@ Initialize low-level CodeConductor configuration.
 cc-codeconductor init [--locale en|es]
 ```
 
+## usage
+
+Show installation examples for presets, council, and LSP.
+
+```text
+cc-codeconductor usage
+```
+
 ## install
 
 Install harness components.
@@ -144,6 +152,14 @@ Run CCEP contract workflows.
 cc-codeconductor ccep <subcommand>
 ```
 
+## odd
+
+Create, resume, and hand off tracked delivery work.
+
+```text
+cc-codeconductor odd <create|read|reconcile|handoff>
+```
+
 ## openspec
 
 Run the OpenSpec delivery loop.

package/package.json

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

package/presets/agy/README.md

@@ -39,7 +39,7 @@ To configure permissions, models, and execution modes for the Antigravity CLI, u
 Recommended settings:
 ```json
 {
-  "model": "gemini-3.5-pro",
+  "model": "gemini-3.8-flash-medium",
   "toolPermission": "request-review",
   "enableTerminalSandbox": true,
   "allowNonWorkspaceAccess": false

package/presets/agy/hooks.json

@@ -17,7 +17,7 @@
     "enabled": true,
     "PreToolUse": [
       {
-        "matcher": "run_command|write_to_file|replace_file_content|multi_replace_file_content",
+        "matcher": "run_command|view_file|write_to_file|replace_file_content|multi_replace_file_content",
         "hooks": [
           {
             "type": "command",

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

@@ -2,8 +2,8 @@
 'use strict';
 
 const { spawnSync } = require('node:child_process');
-const { existsSync } = require('node:fs');
-const { join, resolve } = require('node:path');
+const { existsSync, readFileSync, realpathSync } = require('node:fs');
+const { delimiter, join, resolve } = require('node:path');
 
 const VALID_EVENTS = ['pre-tool', 'post-tool', 'session-start'];
 const SPAWN_TIMEOUT = 10000;
@@ -21,9 +21,10 @@ const isAgy = process.argv.some((a) => a === '--format=agy') || extra.includes('
 function findProjectRoot() {
   const candidates = [
     process.env.PROJECT_ROOT,
+    process.env.CLAUDE_PROJECT_DIR,
     process.env.WORKSPACE_DIR,
-    resolve(__dirname, '..', '..'),
     process.cwd(),
+    resolve(__dirname, '..', '..'),
   ].filter(Boolean);
 
   for (const dir of candidates) {
@@ -40,6 +41,8 @@ function findProjectRoot() {
 }
 
 const projectRoot = findProjectRoot();
+// Buffer once: each fallback attempt must receive the same host payload.
+const input = process.stdin.isTTY ? '' : readFileSync(0, 'utf8');
 
 /**
  * Run one candidate runner. Stdout/stderr are captured (not inherited) so a
@@ -54,7 +57,8 @@ function tryRun(bin, runArgs) {
   try {
     const result = spawnSync(bin, runArgs, {
       cwd: projectRoot,
-      stdio: ['inherit', 'pipe', 'pipe'],
+      stdio: ['pipe', 'pipe', 'pipe'],
+      input,
       windowsHide: true,
       env: process.env,
       encoding: 'utf8',
@@ -111,7 +115,18 @@ try {
     tryRun(process.execPath, [localDist, 'hook', event, ...extra]);
   }
 
-  tryRun('npx', ['--no-install', 'cc-codeconductor', 'hook', event, ...extra]);
+  // Locate global npm installs without invoking npx or Windows .cmd shims.
+  for (const binDir of (process.env.PATH || '').split(delimiter).filter(Boolean)) {
+    const candidates = [
+      join(binDir, 'node_modules', 'cc-codeconductor', 'dist', 'index.js'),
+      join(binDir, '..', 'lib', 'node_modules', 'cc-codeconductor', 'dist', 'index.js'),
+    ];
+    const executable = join(binDir, 'cc-codeconductor');
+    if (existsSync(executable)) candidates.push(realpathSync(executable));
+    for (const candidate of candidates) {
+      if (existsSync(candidate)) tryRun(process.execPath, [candidate, 'hook', event, ...extra]);
+    }
+  }
 } catch {
   // Ignore errors in runner attempts
 }

package/presets/agy/settings.json

@@ -1,5 +1,5 @@
 {
-  "model": "gemini-3.5-pro",
+  "model": "gemini-3.8-flash-medium",
   "toolPermission": "request-review",
   "enableTerminalSandbox": true,
   "allowNonWorkspaceAccess": false,