cc-codeconductor 1.3.0 → 1.4.0

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";
@@ -2669,165 +2673,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/docs/generated/cli.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-codeconductor",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "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",

package/presets/agy/skills/android-ui-design/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: android-ui-design
+description: >-
+  Design, implement, review, and audit Android Jetpack Compose UI/UX for phone
+  interfaces. Use when a request concerns concrete Compose layout, components,
+  interaction, accessibility, or visual behavior. Do not activate for framework
+  or dependency presence alone; non-UI Android work is excluded.
+---
+
+# Android UI design
+
+Apply this specialized guidance to Android phone interfaces built with Jetpack
+Compose. Keep the active `cc-feature`, `cc-fix`, `cc-review`, or `cc-openspec`
+workflow and its gates; this skill contributes UI/UX criteria, not a separate
+workflow. Use the general `android` skill for architecture, dependency injection,
+Media3, performance, testing, and other non-UI Android engineering.
+
+## Intake and boundaries
+
+Identify the user goal, phone surface, affected interaction, supported Android
+versions, and observable outcomes. Inspect the existing Compose components,
+design tokens, navigation conventions, installed versions, tests, previews, and
+available emulator or device tooling before proposing changes.
+
+Preserve the established product visual system, including its components, color,
+type, shape, spacing, and motion tokens. Material 3 is advisory guidance, not a
+mandate to replace a deliberate product language. Suggest Material 3 changes with
+their accessibility or usability benefit and wait for scope approval when they
+would alter the visual direction.
+
+The initial scope is phones. Do not invent tablet, foldable, desktop, or wearable
+layouts. Still account for phone portrait and landscape orientation, window size
+changes, display cutouts, system bars, and the soft keyboard or IME.
+
+## Design mode
+
+Turn the request into a small interaction contract before implementation:
+
+- Define hierarchy, content, spacing, phone layout, scroll and overflow behavior,
+  navigation, focus entry and return, gestures, and predictive back behavior.
+- Specify applicable default, pressed, focused, disabled, pending or loading,
+  empty, success, error or failure, and offline states. State what changes and
+  what the user can do next; never imply success before it is known.
+- Name the state owner. Prefer state hoisting, a single source of truth, and
+  unidirectional data flow (UDF); keep transient visual state local only when no
+  external owner needs to observe or control it.
+- Design edge-to-edge intentionally with WindowInsets and system bars. Define IME
+  resize, pan, focus, dismissal, and restoration behavior for editable surfaces.
+- Require at least 48dp touch targets, meaningful semantics, TalkBack labels and
+  actions, logical traversal or focus order, sufficient contrast, and usable font
+  scaling without clipped or hidden actions.
+- Add motion only when it has a purpose such as continuity, spatial orientation,
+  feedback, or state change. Define start/end state, interruption, cancellation
+  or reversal, repeated or rapid input, and reduced-motion or reduced-animation
+  behavior that preserves essential information.
+
+Use existing components and platform/Compose primitives before adding code or a
+dependency. When alternatives are requested, compare only scoped options and make
+the product-system and Material 3 tradeoffs explicit.
+
+## Implementation mode
+
+Implement the accepted contract without expanding the visual language. Keep
+composables focused, pass immutable UI state and event callbacks, and preserve
+unidirectional data flow. Hoist state to the lowest common owner that needs to
+read or write it. Do not duplicate navigation, loading, or failure truth across
+the composition.
+
+Prefer semantic Material/Compose controls over raw pointer input. When a custom
+gesture is necessary, preserve accessible actions, minimum touch targets, visual
+feedback, cancellation, and interoperability with scrolling. Consume insets once
+at the correct boundary and verify that edge-to-edge content and IME transitions
+do not obscure controls.
+
+Write tests for observable behavior and state outcomes rather than modifier or
+implementation details. Cover the relevant state transition, duplicate or rapid
+input, disabled behavior, semantics, navigation/back behavior, and state
+restoration. Use previews as design aids, not as proof of runtime interaction.
+
+## Review mode
+
+Review the agreed surface against the interaction contract and existing Review
+Report rules. Each finding needs a location, reproduction or evidence, user
+impact, and proposed resolution. Treat contract and accessibility failures as
+defects; classify unsupported aesthetic preferences as suggestions. Do not create
+a new review axis or elevate a Material 3 preference over the product system.
+
+Check state completeness, TalkBack semantics and traversal, 48dp touch targets,
+contrast and font scaling, focus/IME behavior, edge-to-edge insets, gestures,
+predictive back, orientation changes, state ownership/UDF, motion interruption,
+reduced animation, and rapid repeated interaction as applicable.
+
+## Audit mode
+
+A requested audit is read-only. Inspect only the agreed Compose phone surface and
+report prioritized, evidence-backed findings; an audit is not permission to edit,
+implement, modify, or automatically fix the UI. Keep out-of-scope improvements as
+suggestions and create backlog work only when requested through the existing
+workflow.
+
+Distinguish code inspection, semantics tests, screenshots, and live emulator or
+device interaction because they prove different things. If required visual,
+emulator, or device evidence is unavailable, mark that validation pending with
+the surface, steps, expected result, and limitation. Do not claim visual
+validation or a completed acceptance criterion without executing the check.
+
+## Evidence and delivery
+
+Report the observable outcomes checked, commands or tools used, results, and
+limitations. A screenshot cannot prove TalkBack traversal, gesture interruption,
+IME recovery, predictive back, or repeated-input behavior. Prefer a real phone or
+phone emulator for those checks; otherwise leave precise pending verification.
+
+Primary Android references: [Compose semantics](https://developer.android.com/develop/ui/compose/accessibility/semantics),
+[accessibility defaults](https://developer.android.com/develop/ui/compose/accessibility/api-defaults),
+[state and hoisting](https://developer.android.com/develop/ui/compose/state),
+[window insets](https://developer.android.com/develop/ui/compose/system/insets),
+[predictive back](https://developer.android.com/develop/ui/compose/system/predictive-back),
+and [Compose accessibility testing](https://developer.android.com/develop/ui/compose/accessibility/testing).