cc-codeconductor 1.3.0 → 1.4.1

package/dist/library.js

@@ -1,11 +1,15 @@
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -1042,9 +1046,9 @@ function err(error) {
 // src/core/goal/goal-state.ts
 var exports_goal_state = {};
 __export(exports_goal_state, {
-  writeGoal: () => writeGoal,
+  loadGoal: () => loadGoal,
   markTaskBlocked: () => markTaskBlocked,
-  loadGoal: () => loadGoal
+  writeGoal: () => writeGoal
 });
 import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -1130,6 +1134,34 @@ var init_goal_state = __esm(() => {
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 init_schemas();
 
+// src/utils/cli-bin.ts
+import { basename } from "node:path";
+function resolveCliBin(env = process.env, argv = process.argv) {
+  if (env.CC_CLI_BIN) {
+    return env.CC_CLI_BIN;
+  }
+  if (env.npm_lifecycle_event === "npx" || env.npm_command === "exec" || env._?.endsWith("/npx") || env._ === "npx") {
+    return "npx cc-codeconductor";
+  }
+  if (env._?.endsWith("/bunx") || env._ === "bunx") {
+    return "bunx cc-codeconductor";
+  }
+  if (env.npm_lifecycle_event === "dev") {
+    return env.npm_lifecycle_script?.startsWith("bun") ? "bun run dev" : "npm run dev";
+  }
+  if (argv && argv.length > 1 && argv[1]) {
+    const script = argv[1];
+    const binName = basename(script);
+    if (binName === "main.ts") {
+      return "bun run dev";
+    }
+    if (binName === "cc-codeconductor" || binName === "codeconductor") {
+      return binName;
+    }
+  }
+  return "cc-codeconductor";
+}
+
 // src/core/product-graph/paths.ts
 import { join } from "node:path";
 var PRODUCT_DIR = ".codeconductor";
@@ -1157,7 +1189,7 @@ async function loadGraph(projectRoot) {
     return ok(ProductGraphSchema.parse(JSON.parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
-      return err(new Error("Product graph not found. Run `cc ingest` first."));
+      return err(new Error(`Product graph not found. Run \`${resolveCliBin()} ingest\` first.`));
     }
     return err(e instanceof Error ? e : new Error(String(e)));
   }
@@ -2669,165 +2701,165 @@ async function runLoopForProject(projectRoot, options) {
 // src/index.ts
 init_schemas();
 export {
-  validateWorkflowProfile,
-  validateTaskOutcome,
-  validateTargetCapabilities,
-  validateSkillsRegistry,
-  validateSkillFrontmatter,
-  validateScorecardRecord,
-  validateRunnerTarget,
-  validateReviewerOutput,
-  validateProjectProfile,
-  validateProductGraph,
-  validateProductEvent,
-  validatePlannerOutput,
-  validateOpenspecState,
-  validateOpenCodeAgentFile,
-  validateModelConfig,
-  validateMemoryPointer,
-  validateMemoryIndex,
-  validateKnowledgeEntity,
-  validateImplementerOutput,
-  validateHarnessSuite,
-  validateHarnessOverlay,
-  validateHarnessExperiment,
-  validateHarnessCatalog,
-  validateGoalGraph,
-  validateExecutionContext,
-  validateEvidenceIds,
-  validateEvidence,
-  validateDecision,
-  validateCouncilVerdictInput,
-  validateCouncilVerdict,
-  validateCouncilSpec,
-  validateConsensusConfig,
-  validateConfig,
-  validateCommandFrontmatter,
-  validateCommandEnvelope,
-  validateClaudeAgentFile,
-  validateCanonicalTaskCard,
-  validateBacklogDocument,
-  validateAgentOutput,
-  validateAgentContract,
-  tddCycleStateMachine,
-  startTask,
-  shouldRunAgentLoop,
-  runVerification,
-  runLoopForProject,
-  runLoop,
-  rollbackTaskStatus,
-  loopStateMachine,
-  loadTddSuiteEvidence,
-  hasTddRunnerEvidence,
-  goalTaskToCanonicalCard,
-  getReadyTasks,
-  getNextTask,
-  gateTaskCompletion,
-  formatGoalStatus,
-  formatFeedback,
-  createInitialTddState,
-  createInitialState,
-  completeTask,
-  captureTddSuiteEvidence,
-  buildTaskEnvelope,
-  advanceTddPhase,
-  WorkflowRiskRuleSchema,
-  WorkflowProfileSchema,
-  WorkflowPhaseSchema,
-  WorkflowCommandSchema,
-  VerificationReportSchema,
-  ToolProviderNamesSchema,
-  TechnicalPlanOutputSchema,
-  TaskOutcomeStatusSchema,
-  TaskOutcomeSourceSchema,
-  TaskOutcomeSchema,
-  TargetCapabilitiesSchema,
-  StrategicMemorySchema,
-  SpecAnalyzeReportSchema,
-  SpecAnalyzeFindingSchema,
-  SkillsRegistrySchema,
-  SkillFrontmatterSchema,
-  SentryWebhookSchema,
-  SentryStackFrameSchema,
-  ScorecardVerdictSchema,
-  ScorecardRecordSchema,
-  ScorecardCriterionSchema,
-  ScorecardCriterionIdSchema,
-  RunnerTargetSchema,
-  ReviewerOutputSchema,
-  ReviewFindingSchema,
-  ReviewAxisSchema,
-  ProjectProfileSchema,
-  ProductNodeTypeSchema,
-  ProductMetaSchema,
-  ProductGraphSchema,
-  ProductGraphNodeSchema,
-  ProductGraphEdgeSchema,
-  ProductEventTypeSchema,
-  ProductEventSchema,
-  PlannerOutputSchema,
-  PermissionProviderNamesSchema,
-  OperationalStateSchema,
-  OpenspecTaskCardStatusSchema,
-  OpenspecTaskCardSchema,
-  OpenspecTaskCardPhaseSchema,
-  OpenspecStateSchema,
-  OpenCodeAgentFileSchema,
-  ModelConfigSchema,
-  MemoryPointerSchema,
-  MemoryIndexSchema,
-  ManifestEntrySchema,
-  LoopEngine,
-  LoopConfigSchema,
-  KnowledgeEntitySchema,
-  InstallStrategySchema,
-  InstallManifestSchema,
-  ImplementerTestsSchema,
-  ImplementerOutputSchema,
-  ImpactReportSchema,
-  HarnessToggleKindSchema,
-  HarnessSuiteTaskSchema,
-  HarnessSuiteSchema,
-  HarnessOverlaySchema,
-  HarnessExperimentSchema,
-  HarnessComponentLayerSchema,
-  HarnessComponentIdSchema,
-  HarnessCatalogSchema,
-  HarnessCatalogEntrySchema,
-  GraphRelationSchema,
-  GoalTaskSchema,
-  GoalGraphSchema,
-  ExecutionProfileSchema,
-  ExecutionProfileNameSchema,
-  ExecutionContextSchema,
-  EvidenceSchema,
-  EvaluationIndexSchema,
-  DecisionSchema,
-  CouncilVerdictSchema,
-  CouncilVerdictInputSchema,
-  CouncilSpecSchema,
-  CouncilFindingSchema,
-  CouncilAgentSpecSchema,
-  ContractTargetSchema,
-  ContractFormatSchema,
-  ConsensusConfigSchema,
-  ConfidenceLevelSchema,
-  CompileCheckConfigSchema,
-  CommandFrontmatterSchema,
-  CommandEnvelopeSchema,
-  CodeConductorConfigSchema,
-  ClaudeAgentFileSchema,
-  CcepOutputFormatSchema,
-  CanonicalTaskCardStatusSchema,
-  CanonicalTaskCardSchema,
-  BusinessReviewOutputSchema,
-  BacklogTypeSchema,
-  BacklogStatusSchema,
-  BacklogPrioritySchema,
-  BacklogItemSchema,
-  BacklogGlobalSchema,
-  BacklogDocumentSchema,
-  AgentOutputSchema,
+  AgentArtifactSchema,
   AgentContractSchema,
-  AgentArtifactSchema
+  AgentOutputSchema,
+  BacklogDocumentSchema,
+  BacklogGlobalSchema,
+  BacklogItemSchema,
+  BacklogPrioritySchema,
+  BacklogStatusSchema,
+  BacklogTypeSchema,
+  BusinessReviewOutputSchema,
+  CanonicalTaskCardSchema,
+  CanonicalTaskCardStatusSchema,
+  CcepOutputFormatSchema,
+  ClaudeAgentFileSchema,
+  CodeConductorConfigSchema,
+  CommandEnvelopeSchema,
+  CommandFrontmatterSchema,
+  CompileCheckConfigSchema,
+  ConfidenceLevelSchema,
+  ConsensusConfigSchema,
+  ContractFormatSchema,
+  ContractTargetSchema,
+  CouncilAgentSpecSchema,
+  CouncilFindingSchema,
+  CouncilSpecSchema,
+  CouncilVerdictInputSchema,
+  CouncilVerdictSchema,
+  DecisionSchema,
+  EvaluationIndexSchema,
+  EvidenceSchema,
+  ExecutionContextSchema,
+  ExecutionProfileNameSchema,
+  ExecutionProfileSchema,
+  GoalGraphSchema,
+  GoalTaskSchema,
+  GraphRelationSchema,
+  HarnessCatalogEntrySchema,
+  HarnessCatalogSchema,
+  HarnessComponentIdSchema,
+  HarnessComponentLayerSchema,
+  HarnessExperimentSchema,
+  HarnessOverlaySchema,
+  HarnessSuiteSchema,
+  HarnessSuiteTaskSchema,
+  HarnessToggleKindSchema,
+  ImpactReportSchema,
+  ImplementerOutputSchema,
+  ImplementerTestsSchema,
+  InstallManifestSchema,
+  InstallStrategySchema,
+  KnowledgeEntitySchema,
+  LoopConfigSchema,
+  LoopEngine,
+  ManifestEntrySchema,
+  MemoryIndexSchema,
+  MemoryPointerSchema,
+  ModelConfigSchema,
+  OpenCodeAgentFileSchema,
+  OpenspecStateSchema,
+  OpenspecTaskCardPhaseSchema,
+  OpenspecTaskCardSchema,
+  OpenspecTaskCardStatusSchema,
+  OperationalStateSchema,
+  PermissionProviderNamesSchema,
+  PlannerOutputSchema,
+  ProductEventSchema,
+  ProductEventTypeSchema,
+  ProductGraphEdgeSchema,
+  ProductGraphNodeSchema,
+  ProductGraphSchema,
+  ProductMetaSchema,
+  ProductNodeTypeSchema,
+  ProjectProfileSchema,
+  ReviewAxisSchema,
+  ReviewFindingSchema,
+  ReviewerOutputSchema,
+  RunnerTargetSchema,
+  ScorecardCriterionIdSchema,
+  ScorecardCriterionSchema,
+  ScorecardRecordSchema,
+  ScorecardVerdictSchema,
+  SentryStackFrameSchema,
+  SentryWebhookSchema,
+  SkillFrontmatterSchema,
+  SkillsRegistrySchema,
+  SpecAnalyzeFindingSchema,
+  SpecAnalyzeReportSchema,
+  StrategicMemorySchema,
+  TargetCapabilitiesSchema,
+  TaskOutcomeSchema,
+  TaskOutcomeSourceSchema,
+  TaskOutcomeStatusSchema,
+  TechnicalPlanOutputSchema,
+  ToolProviderNamesSchema,
+  VerificationReportSchema,
+  WorkflowCommandSchema,
+  WorkflowPhaseSchema,
+  WorkflowProfileSchema,
+  WorkflowRiskRuleSchema,
+  advanceTddPhase,
+  buildTaskEnvelope,
+  captureTddSuiteEvidence,
+  completeTask,
+  createInitialState,
+  createInitialTddState,
+  formatFeedback,
+  formatGoalStatus,
+  gateTaskCompletion,
+  getNextTask,
+  getReadyTasks,
+  goalTaskToCanonicalCard,
+  hasTddRunnerEvidence,
+  loadTddSuiteEvidence,
+  loopStateMachine,
+  rollbackTaskStatus,
+  runLoop,
+  runLoopForProject,
+  runVerification,
+  shouldRunAgentLoop,
+  startTask,
+  tddCycleStateMachine,
+  validateAgentContract,
+  validateAgentOutput,
+  validateBacklogDocument,
+  validateCanonicalTaskCard,
+  validateClaudeAgentFile,
+  validateCommandEnvelope,
+  validateCommandFrontmatter,
+  validateConfig,
+  validateConsensusConfig,
+  validateCouncilSpec,
+  validateCouncilVerdict,
+  validateCouncilVerdictInput,
+  validateDecision,
+  validateEvidence,
+  validateEvidenceIds,
+  validateExecutionContext,
+  validateGoalGraph,
+  validateHarnessCatalog,
+  validateHarnessExperiment,
+  validateHarnessOverlay,
+  validateHarnessSuite,
+  validateImplementerOutput,
+  validateKnowledgeEntity,
+  validateMemoryIndex,
+  validateMemoryPointer,
+  validateModelConfig,
+  validateOpenCodeAgentFile,
+  validateOpenspecState,
+  validatePlannerOutput,
+  validateProductEvent,
+  validateProductGraph,
+  validateProjectProfile,
+  validateReviewerOutput,
+  validateRunnerTarget,
+  validateScorecardRecord,
+  validateSkillFrontmatter,
+  validateSkillsRegistry,
+  validateTargetCapabilities,
+  validateTaskOutcome,
+  validateWorkflowProfile
 };

package/dist/utils/cli-bin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolve the CLI command prefix based on execution context.
+ *
+ * - When invoked via npx (e.g. `npx cc-codeconductor ...`), returns `npx cc-codeconductor`.
+ * - When invoked via bunx, returns `bunx cc-codeconductor`.
+ * - When invoked during local development (`bun run dev` or executing `src/cli/main.ts`), returns `bun run dev`.
+ * - When invoked via an installed binary (`cc-codeconductor` or `codeconductor`), returns that binary name.
+ * - Respects the `CC_CLI_BIN` environment variable for testing or explicit overrides.
+ * - Defaults to `cc-codeconductor`.
+ */
+export declare function resolveCliBin(env?: NodeJS.ProcessEnv, argv?: readonly string[]): string;
+/**
+ * Formats a command usage string replacing any legacy or alternative command prefix
+ * (`cc `, `cc-codeconductor `, or `codeconductor `) with the resolved bin prefix.
+ */
+export declare function formatUsage(usage: string, bin?: string): string;

package/docs/generated/cli.md

@@ -0,0 +1,202 @@
+# CodeConductor CLI
+
+## setup
+
+Configure and install CodeConductor.
+
+```text
+cc-codeconductor setup [--target <target>] [--locale en|es] [--yes] [--dry-run]
+```
+
+## detect
+
+Inspect the project stack and recommended presets.
+
+```text
+cc-codeconductor detect
+```
+
+## init
+
+Initialize low-level CodeConductor configuration.
+
+```text
+cc-codeconductor init [--locale en|es]
+```
+
+## install
+
+Install harness components.
+
+```text
+cc-codeconductor install preset --target <target>
+```
+
+## version
+
+Show CLI and project harness versions.
+
+```text
+cc-codeconductor version [--json]
+```
+
+## status
+
+Show installed harness state.
+
+```text
+cc-codeconductor status [--json]
+```
+
+## doctor
+
+Diagnose the installation.
+
+```text
+cc-codeconductor doctor
+```
+
+## update
+
+Safely reconcile managed harness files.
+
+```text
+cc-codeconductor update [--dry-run] [--force]
+```
+
+## migrate
+
+Apply compatibility migrations.
+
+```text
+cc-codeconductor migrate [--dry-run]
+```
+
+## docs
+
+Read bundled command documentation.
+
+```text
+cc-codeconductor docs [command]
+```
+
+## completion
+
+Generate shell completion.
+
+```text
+cc-codeconductor completion <bash|zsh|fish|powershell>
+```
+
+## hook
+
+Run installed agent hooks.
+
+```text
+cc-codeconductor hook <pre-tool|post-tool|session-start>
+```
+
+## cc-help
+
+Show a target preset inventory.
+
+```text
+cc-codeconductor cc-help --target <target>
+```
+
+## ask
+
+Recommend a slash-command workflow.
+
+```text
+cc-codeconductor ask "problem"
+```
+
+## goal
+
+Plan a goal into dependent tasks.
+
+```text
+cc-codeconductor goal "objective"
+```
+
+## ingest
+
+Ingest repository knowledge into the product graph.
+
+```text
+cc-codeconductor ingest
+```
+
+## product
+
+Explore the product graph and memory.
+
+```text
+cc-codeconductor product <subcommand>
+```
+
+## ccep
+
+Run CCEP contract workflows.
+
+```text
+cc-codeconductor ccep <subcommand>
+```
+
+## openspec
+
+Run the OpenSpec delivery loop.
+
+```text
+cc-codeconductor openspec <subcommand>
+```
+
+## scorecard
+
+Record and aggregate outcomes.
+
+```text
+cc-codeconductor scorecard <subcommand>
+```
+
+## orchestrate
+
+Run goal execution orchestration.
+
+```text
+cc-codeconductor orchestrate <subcommand>
+```
+
+## impact
+
+Analyze change impact.
+
+```text
+cc-codeconductor impact [--files <paths>]
+```
+
+## verify
+
+Verify task completion with evidence.
+
+```text
+cc-codeconductor verify --task <id>
+```
+
+## seo
+
+Audit SEO and generate llms.txt.
+
+```text
+cc-codeconductor seo audit --url <url>
+```
+
+## debt-harvest
+
+Scan source files for deferred debt.
+
+```text
+cc-codeconductor debt-harvest
+```
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-codeconductor",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
   "keywords": [
     "ai",
@@ -18,6 +18,7 @@
     "dist/index.js",
     "dist/library.js",
     "dist/**/*.d.ts",
+    "docs/generated/",
     "policy.yml",
     "presets/",
     "src/presets/"
@@ -48,6 +49,7 @@
     "build:cli": "bun build src/cli/main.ts --target=node --outfile=dist/index.js",
     "build:lib": "bun build src/index.ts --target=node --outfile=dist/library.js --packages=external",
     "build:types": "tsc -p tsconfig.lib.json --emitDeclarationOnly",
+    "generate:cli-docs": "bun run scripts/generate-cli-docs.ts",
     "test": "bun test",
     "test:fast": "bun run scripts/test-fast.ts",
     "typecheck": "tsc --noEmit",