switchboard-cli 0.1.0-alpha.4 → 0.1.0-alpha.5

package/src/commands/compile.ts

@@ -1,117 +0,0 @@
-/**
- * switchboard compile
- *
- * Reads canonical local state (.switchboard/project/contract.yaml,
- * .switchboard/working/current.yaml), compiles a governed loop contract
- * using existing @switchboard/core logic, and writes the result to
- * .switchboard/working/loop.yaml.
- *
- * Also updates current.yaml stage to "activation-compiled" if it was
- * still in a shaping stage.
- *
- * Does not require the hosted web app, Supabase, or a running server.
- */
-
-import type { Command } from "commander";
-import {
-  chooseRecommendedSurface,
-  compileLoopContract,
-  workingStateSchema,
-  type RoutingResult,
-  type Surface,
-} from "@switchboard/core";
-import { requireRepoRoot } from "../lib/paths";
-import {
-  loadContract,
-  loadCurrentState,
-  loadSpec,
-  writeCurrentState,
-  writeLoop,
-} from "../store/filesystem-store";
-import * as out from "../lib/output";
-import { withCliErrors } from "../lib/errors";
-import { loopPath } from "../lib/paths";
-
-export function registerCompileCommand(program: Command): void {
-  program
-    .command("compile")
-    .description("Compile a governed loop contract from canonical state")
-    .option("--objective <text>", "Override the loop objective")
-    .option("--surface <surface>", "Force a target surface (claude-code, chatgpt, cursor, codex)")
-    .action(withCliErrors(async (opts: { objective?: string; surface?: string }) => {
-      const repoRoot = requireRepoRoot();
-
-      out.heading("switchboard compile");
-
-      // 1. Load canonical state
-      const contract = loadContract(repoRoot);
-      const current = loadCurrentState(repoRoot);
-      const spec = loadSpec(repoRoot);
-
-      out.success(`Loaded contract: ${contract.title} (${contract.project_id})`);
-      out.success(`Loaded state: stage=${current.stage}`);
-
-      // 2. Route to surface
-      const route: RoutingResult = chooseRecommendedSurface({
-        repo_present: contract.repo_status === "repo-present",
-        task: opts.objective ?? current.next_objective,
-      });
-
-      // Allow surface override
-      if (opts.surface) {
-        const validSurfaces = ["claude-code", "chatgpt", "cursor", "codex"];
-        if (!validSurfaces.includes(opts.surface)) {
-          out.fail(`Invalid surface: ${opts.surface}. Must be one of: ${validSurfaces.join(", ")}`);
-          process.exitCode = 1;
-          return;
-        }
-        (route as { primary_recommendation: Surface }).primary_recommendation = opts.surface as Surface;
-      }
-
-      out.section("Route", `${route.primary_recommendation} (fallback: ${route.fallback_surface})`);
-      out.section("Rationale", route.rationale);
-
-      // 3. Compile loop contract using existing core logic
-      const loopInput: Parameters<typeof compileLoopContract>[0] = {
-        contract,
-        current,
-        route,
-      };
-      if (opts.objective) loopInput.objective = opts.objective;
-      const loop = compileLoopContract(loopInput);
-
-      out.success(`Compiled loop contract`);
-      out.section("Objective", loop.objective);
-      out.section("Scope in", `${loop.scope_in.length} item(s)`);
-      out.section("Scope out", `${loop.scope_out.length} item(s)`);
-      out.section("Done when", `${loop.done_when.length} condition(s)`);
-      out.section("Execution shape", loop.execution_shape);
-
-      // 4. Write loop to filesystem
-      writeLoop(repoRoot, loop);
-      out.fileWritten("Loop contract", loopPath(repoRoot));
-
-      // 5. Update current state — sync next_objective to the compiled loop
-      //    objective so packet/run dispatch the same thing compile produced.
-      const shouldUpdateStage = current.stage.startsWith("activation-shaping") || current.stage === "activation-needs-narrowing";
-      const updated = workingStateSchema.parse({
-        ...current,
-        stage: shouldUpdateStage ? "activation-compiled" : current.stage,
-        current_objective: loop.objective,
-        next_recommended_surface: route.primary_recommendation,
-        // CRITICAL: next_objective must be the compiled loop objective,
-        // not the router's derived objective. Otherwise packet/run diverge.
-        next_objective: loop.objective,
-      });
-      writeCurrentState(repoRoot, updated);
-      if (shouldUpdateStage) {
-        out.success("Updated working state to activation-compiled");
-      } else {
-        out.success("Synced working state to compiled loop objective");
-      }
-
-      // Summary
-      out.heading("Next steps");
-      out.bullet(`Run \`switchboard packet ${route.primary_recommendation}\` to generate a dispatch packet`);
-    }));
-}

package/src/commands/evaluate.ts

@@ -1,103 +0,0 @@
-/**
- * switchboard evaluate
- *
- * Runs the independent evaluation lane against the latest portable
- * receipt. Writes evaluation output under .switchboard/evaluations/.
- *
- * Uses existing @switchboard/core evaluation logic: runEvaluation
- * from evaluation-lane.ts.
- *
- * Does not require the hosted web app or Supabase.
- */
-
-import type { Command } from "commander";
-import { runEvaluation } from "@switchboard/core";
-import { requireRepoRoot, sbDir } from "../lib/paths";
-import { readYaml } from "../lib/yaml-io";
-import {
-  loadContract,
-  loadLatestAuditedReceipt,
-  saveEvaluationResult,
-  saveEvaluationJson,
-} from "../store/filesystem-store";
-import { loadPortableProofManifest } from "../lib/proof";
-import * as out from "../lib/output";
-import { withCliErrors } from "../lib/errors";
-import { join } from "path";
-
-export function registerEvaluateCommand(program: Command): void {
-  program
-    .command("evaluate")
-    .description("Run independent evaluation on the latest receipt")
-    .action(withCliErrors(async () => {
-      const repoRoot = requireRepoRoot();
-
-      out.heading("switchboard evaluate");
-
-      // 1. Load the audited receipt (V1 format expected by evaluation lane)
-      const receipt = loadLatestAuditedReceipt(repoRoot);
-
-      if (!receipt) {
-        out.fail("No audited receipt found. Run `switchboard receipt` first.");
-        process.exitCode = 1;
-        return;
-      }
-
-      out.success(`Loaded receipt: ${receipt.receipt_id}`);
-      out.section("Gate", receipt.gate_label);
-      out.section("Trust posture", receipt.trust_posture);
-
-      // 2. Load contract for scope context
-      const contract = loadContract(repoRoot);
-
-      // 3. Load proof manifest if available (via ingest pointer)
-      const pointerPath = join(sbDir(repoRoot), "working", "latest-ingest.yaml");
-      const pointer = readYaml<{ dispatch_id?: string; has_proof_manifest?: boolean }>(pointerPath);
-
-      let proofManifest = null;
-      if (pointer?.dispatch_id && pointer?.has_proof_manifest) {
-        proofManifest = loadPortableProofManifest(repoRoot, pointer.dispatch_id);
-        if (proofManifest) {
-          out.success(`Loaded proof manifest: ${proofManifest.manifest_id} (${proofManifest.artifacts.length} artifact(s))`);
-        }
-      }
-
-      if (!proofManifest) {
-        out.info("No proof manifest — evaluation will be honest about provenance gaps.");
-      }
-
-      // 4. Run the evaluation lane with proof manifest when available
-      const result = runEvaluation({
-        receipt,
-        proofManifest,
-        trigger: "operator_requested",
-        contracted_scope_in: contract.task_clauses.scope_in,
-        contracted_done_when: [],
-      });
-
-      // 5. Persist
-      const yamlPath = saveEvaluationResult(repoRoot, result);
-      const jsonPath = saveEvaluationJson(repoRoot, result);
-      out.fileWritten("Evaluation (YAML)", yamlPath);
-      out.fileWritten("Evaluation (JSON)", jsonPath);
-
-      // Summary
-      out.heading("Evaluation complete");
-      out.section("Evaluation ID", result.evaluation_id);
-      out.section("Verdict", result.verdict);
-      out.section("Basis", result.verdict_basis);
-      out.section("Scope", result.evaluation_scope);
-
-      if (result.violation_count > 0) {
-        out.fail(`${result.violation_count} violation(s)`);
-      }
-      if (result.concern_count > 0) {
-        out.warn(`${result.concern_count} concern(s)`);
-      }
-      if (result.flag_count > 0) {
-        out.info(`${result.flag_count} flag(s)`);
-      }
-
-      out.section("Re-entry signal", `${result.reentry_signal} — ${result.reentry_basis}`);
-    }));
-}

package/src/commands/ingest.ts

@@ -1,250 +0,0 @@
-/**
- * switchboard ingest
- *
- * Reads a structured SB_RETURN.yaml, validates it against the active
- * handoff, runs the governed ingest + reconcile + gate path, and
- * updates .switchboard/ state.
- *
- * Uses existing @switchboard/core modules: parseStructuredReturn,
- * validateReturnForIngest, ingestReturnReport, normalizeReturn,
- * deriveCanonicalDelta, deriveGateState, deriveNextSlice.
- *
- * Does not require the hosted web app or Supabase.
- */
-
-import { existsSync, readdirSync } from "fs";
-import { join } from "path";
-import type { Command } from "commander";
-import {
-  parseStructuredReturn,
-  ingestReturnReport,
-  normalizeReturn,
-  deriveCanonicalDelta,
-  deriveGateState,
-  deriveNextSlice,
-  shouldRequireAudit,
-  computeAuditResult,
-  noAuditRequired,
-} from "@switchboard/core";
-import { requireRepoRoot, returnsDir, returnTemplatePath } from "../lib/paths";
-import { readMarkdown } from "../lib/yaml-io";
-import { captureReturnProof, buildAndWriteProofManifest } from "../lib/proof";
-import {
-  loadContract,
-  loadCurrentState,
-  loadHandoff,
-  loadLatestHandoff,
-  loadLatestDispatchMeta,
-  loadSpec,
-  writeCurrentState,
-  saveReturn,
-  saveCanonicalDelta,
-  saveNormalizedEnvelope,
-  saveGateState,
-} from "../store/filesystem-store";
-import * as out from "../lib/output";
-import { withCliErrors } from "../lib/errors";
-
-function findReturnFile(repoRoot: string, dispatchId?: string): string | null {
-  // Priority 1: Dispatch-specific return in .switchboard/returns/
-  if (dispatchId) {
-    const specific = join(returnsDir(repoRoot), `${dispatchId}-return.yaml`);
-    if (existsSync(specific)) return specific;
-  }
-
-  // Priority 2: Repo-root SB_RETURN.yaml (convenience location)
-  const rootReturn = join(repoRoot, "SB_RETURN.yaml");
-  if (existsSync(rootReturn)) return rootReturn;
-
-  // Priority 3: Most recent return file in .switchboard/returns/
-  const retDir = returnsDir(repoRoot);
-  if (!existsSync(retDir)) return null;
-
-  const files = readdirSync(retDir)
-    .filter(f => f.endsWith("-return.yaml"))
-    .sort()
-    .reverse();
-
-  return files.length > 0 ? join(retDir, files[0]!) : null;
-}
-
-export function registerIngestCommand(program: Command): void {
-  program
-    .command("ingest")
-    .description("Ingest a structured return and update canonical state")
-    .option("--file <path>", "Path to the return YAML file")
-    .action(withCliErrors(async (opts: { file?: string }) => {
-      const repoRoot = requireRepoRoot();
-
-      out.heading("switchboard ingest");
-
-      // 1. Load canonical state
-      const contract = loadContract(repoRoot);
-      const current = loadCurrentState(repoRoot);
-      const spec = loadSpec(repoRoot) ?? "";
-
-      out.success(`Loaded contract: ${contract.title}`);
-
-      // 2. Resolve active handoff
-      const activeHandoffId = current.active_handoff_id;
-      const dispatchMeta = loadLatestDispatchMeta(repoRoot);
-
-      let handoff = activeHandoffId ? loadHandoff(repoRoot, activeHandoffId) : null;
-      if (!handoff) {
-        handoff = loadLatestHandoff(repoRoot);
-      }
-
-      if (!handoff) {
-        out.fail("No handoff found. Run `switchboard run claude` first to create a dispatch.");
-        process.exitCode = 1;
-        return;
-      }
-
-      out.success(`Loaded handoff: ${handoff.handoff_id}`);
-
-      // 3. Find and read return file
-      const returnPath = opts.file ?? findReturnFile(repoRoot, handoff.handoff_id);
-      if (!returnPath) {
-        out.fail("No return file found.");
-        out.info("Place SB_RETURN.yaml in the repo root or .switchboard/returns/");
-        out.info("Or specify: switchboard ingest --file path/to/return.yaml");
-        process.exitCode = 1;
-        return;
-      }
-
-      const rawYaml = readMarkdown(returnPath);
-      if (!rawYaml) {
-        out.fail(`Return file is empty: ${returnPath}`);
-        process.exitCode = 1;
-        return;
-      }
-
-      out.success(`Read return from: ${returnPath}`);
-
-      // 4. Parse structured return
-      const report = parseStructuredReturn(rawYaml);
-      out.section("Status", report.status);
-      out.section("Objective met", report.objective_met);
-      out.section("Changed files", `${report.changed_files.length}`);
-
-      // 5. Run governed ingest (validates, reconciles, routes)
-      const ingestResult = ingestReturnReport({
-        current,
-        handoff,
-        report,
-        repo_present: contract.repo_status === "repo-present",
-        contract,
-        spec_markdown: spec,
-      });
-
-      out.success(`Ingested return: stage=${ingestResult.current.stage}`);
-
-      if (ingestResult.reconcile) {
-        out.section("Reconcile", ingestResult.reconcile.recommendation);
-        if (ingestResult.reconcile.drift_detected) {
-          out.warn(`Drift detected: ${ingestResult.reconcile.findings.length} finding(s)`);
-        }
-      }
-
-      // 6. Derive gate state
-      const gate = deriveGateState({
-        reconcile: ingestResult.reconcile,
-        latestReturn: report,
-        phase: ingestResult.current.stage,
-      });
-
-      out.section("Gate", `${gate.label} — ${gate.reason}`);
-
-      // 7. Normalize the return into governed envelope
-      const auditCheck = shouldRequireAudit({
-        report,
-        complexityMode: null,
-        taskType: "implementation-request",
-      });
-
-      const audit = auditCheck.required
-        ? computeAuditResult({ report, triggers: auditCheck.triggers, returnId: handoff.handoff_id })
-        : noAuditRequired(handoff.handoff_id);
-
-      if (audit.audit_required) {
-        out.section("Audit", `${audit.outcome} (${audit.findings.length} finding(s))`);
-      }
-
-      const envelope = normalizeReturn({
-        report,
-        reconcile: ingestResult.reconcile,
-        audit,
-        dispatch_id: handoff.handoff_id,
-      });
-
-      // 8. Derive canonical delta
-      const delta = deriveCanonicalDelta({
-        report,
-        contract,
-        gateState: gate,
-        reconcile: ingestResult.reconcile,
-        envelope,
-      });
-
-      out.section("Delta", `${delta.delta_id} — ${delta.summary}`);
-
-      // 9. Derive next slice
-      const nextSlice = deriveNextSlice({
-        report,
-        contract,
-        gateState: gate,
-        delta,
-      });
-
-      if (nextSlice) {
-        out.section("Next slice", nextSlice.title);
-      }
-
-      // 10. Capture return as proof artifact + build proof manifest
-      captureReturnProof(repoRoot, handoff.handoff_id, rawYaml);
-      const proofManifest = buildAndWriteProofManifest(repoRoot, handoff.handoff_id);
-      out.success(`Proof manifest: ${proofManifest.manifest_id} (${proofManifest.artifacts.length} artifact(s))`);
-
-      // 11. Persist everything — receipt will load these exact artifacts by ID
-      saveReturn(repoRoot, handoff.handoff_id, report);
-      saveNormalizedEnvelope(repoRoot, envelope);
-      saveCanonicalDelta(repoRoot, delta);
-      saveGateState(repoRoot, handoff.handoff_id, gate);
-      writeCurrentState(repoRoot, ingestResult.current);
-
-      // Persist reconcile and audit so receipt consumes exact ingested truth
-      const { writeYaml } = await import("../lib/yaml-io");
-      const { sbDir } = await import("../lib/paths");
-
-      if (ingestResult.reconcile) {
-        writeYaml(join(returnsDir(repoRoot), `reconcile-${handoff.handoff_id}.yaml`), ingestResult.reconcile);
-      }
-      writeYaml(join(returnsDir(repoRoot), `audit-${handoff.handoff_id}.yaml`), audit);
-      if (nextSlice) {
-        writeYaml(join(returnsDir(repoRoot), `next-slice-${handoff.handoff_id}.yaml`), nextSlice);
-      }
-
-      out.success("Updated canonical state");
-
-      // Summary
-      out.heading("Ingest complete");
-      out.section("Gate", gate.label);
-      out.section("Stage", ingestResult.current.stage);
-      out.bullet("Run `switchboard receipt` to build the trust artifact");
-
-      // Save a pointer so receipt loads the exact persisted artifacts
-      writeYaml(join(sbDir(repoRoot), "working", "latest-ingest.yaml"), {
-        dispatch_id: handoff.handoff_id,
-        envelope_id: envelope.envelope_id,
-        delta_id: delta.delta_id,
-        gate_label: gate.label,
-        audit_id: audit.audit_id,
-        next_slice_id: nextSlice?.slice_id ?? "",
-        has_reconcile: !!ingestResult.reconcile,
-        has_next_slice: !!nextSlice,
-        has_proof_manifest: true,
-        proof_manifest_id: proofManifest.manifest_id,
-        ingested_at: new Date().toISOString(),
-      });
-    }));
-}

package/src/commands/init.ts

@@ -1,133 +0,0 @@
-/**
- * switchboard init
- *
- * Scaffolds a minimal governed project root under .switchboard/.
- * Creates starter contract.yaml and current.yaml that validate against
- * core schemas, plus the canonical directory structure.
- *
- * Does not require Supabase, a running server, or the hosted app.
- */
-
-import { existsSync } from "fs";
-import { basename, resolve } from "path";
-import type { Command } from "commander";
-import { projectContractSchema, workingStateSchema } from "@switchboard/core";
-import {
-  scaffoldDirectories,
-  switchboardExists,
-  writeContract,
-  writeCurrentState,
-  writeSpec,
-} from "../store/filesystem-store";
-import { sbDir, contractPath, currentStatePath, specPath } from "../lib/paths";
-import * as out from "../lib/output";
-import { withCliErrors } from "../lib/errors";
-
-function slugify(text: string): string {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-|-$/g, "")
-    .slice(0, 60);
-}
-
-export function registerInitCommand(program: Command): void {
-  program
-    .command("init")
-    .description("Scaffold a .switchboard/ governed project root")
-    .option("--title <title>", "Project title")
-    .option("--force", "Overwrite existing .switchboard/ files")
-    .action(withCliErrors(async (opts: { title?: string; force?: boolean }) => {
-      const repoRoot = resolve(process.cwd());
-      const title = opts.title ?? basename(repoRoot);
-      const projectId = slugify(title);
-
-      // Guard: already initialized
-      if (switchboardExists(repoRoot) && !opts.force) {
-        out.warn(`${sbDir(repoRoot)} already exists. Use --force to overwrite.`);
-        process.exitCode = 1;
-        return;
-      }
-
-      out.heading("switchboard init");
-
-      // 1. Create directory tree
-      scaffoldDirectories(repoRoot);
-      out.success("Created .switchboard/ directory structure");
-
-      // 2. Write starter contract (validates against projectContractSchema)
-      const contract = projectContractSchema.parse({
-        project_id: projectId,
-        title,
-        one_liner: `${title} — [FILL IN] one-line description`,
-        problem: "[FILL IN] the problem this project solves.",
-        target_user: "[FILL IN] the target user for this project.",
-        desired_v1_outcome: "[FILL IN] what V1 should deliver.",
-        non_goals: [
-          "No platform sprawl beyond the first bounded slice.",
-        ],
-        repo_status: existsSync(resolve(repoRoot, ".git"))
-          ? "repo-present" as const
-          : "repo-not-present" as const,
-        task_clauses: {
-          scope_in: [],
-          scope_out: [],
-          systems_expected: [],
-          files_allowed: [],
-          must_not_widen: [],
-          build_constraints: [],
-        },
-      });
-      writeContract(repoRoot, contract);
-      out.fileWritten("Contract", contractPath(repoRoot));
-
-      // 3. Write starter working state (validates against workingStateSchema)
-      const current = workingStateSchema.parse({
-        stage: "activation-shaping",
-        current_objective: `Define and compile the first bounded slice for ${title}.`,
-        dominant_uncertainty: "The project contract needs to be filled in before compilation.",
-        open_questions: [
-          "What is the narrowest first slice worth building?",
-        ],
-        primary_artifact_ref: ".switchboard/artifacts/SB_SPEC.md",
-        active_handoff_id: "",
-        last_return_status: "not-started" as const,
-        latest_decisions: [],
-        latest_blockers: [],
-        next_recommended_surface: "claude-code" as const,
-        next_objective: `Compile the first governed loop for ${title}.`,
-      });
-      writeCurrentState(repoRoot, current);
-      out.fileWritten("Working state", currentStatePath(repoRoot));
-
-      // 4. Write placeholder spec
-      const placeholderSpec = [
-        `# ${title}`,
-        "",
-        "## Problem",
-        "",
-        "[FILL IN] Describe the problem this project solves.",
-        "",
-        "## Target User",
-        "",
-        "[FILL IN] Describe the target user.",
-        "",
-        "## Desired V1 Outcome",
-        "",
-        "[FILL IN] Describe what V1 should deliver.",
-        "",
-        "## Non-Goals",
-        "",
-        ...contract.non_goals.map(ng => `- ${ng}`),
-        "",
-      ].join("\n");
-      writeSpec(repoRoot, placeholderSpec);
-      out.fileWritten("Spec placeholder", specPath(repoRoot));
-
-      // Summary
-      out.heading("Next steps");
-      out.bullet("Edit .switchboard/project/contract.yaml with your project details");
-      out.bullet("Edit .switchboard/artifacts/SB_SPEC.md with your canonical brief");
-      out.bullet("Run `switchboard compile` to compile a governed loop");
-    }));
-}