@moretea-labs/forge 1.5.0-rc.1 → 1.5.1

package/src/cli/controller/codex-continuation.ts

@@ -79,10 +79,10 @@ ${packet.allowedActions.map((action) => `- ${action}`).join('\n')}
 ${packet.stopConditions.map((condition) => `- ${condition}`).join('\n')}
 
 ## Instructions
-1. Prefer \`forge controller completion-backlog --json\` before starting new work.
-2. Run \`forge controller finish-ready-runs --apply --json\` only for low/medium auto-finishable runs.
+1. Read current Runtime state through \`rh_status\`, pending decisions through \`rh_inbox\`, and bounded Work through \`rh_work\` before starting new work.
+2. Use \`rh_work.verify/finalize/repair\` for current Work lifecycle changes; do not mutate legacy Issue/Task state.
 3. For high/destructive work, prepare a concise review summary instead of auto-approving it.
-4. If a command fails because of tool/platform limitations, write a small patch or a continuation note rather than retrying the same blocked path repeatedly.
+4. If a command fails because of tool/platform limitations, create a Runtime HandoffItem or bounded continuation note rather than retrying the same blocked path repeatedly.
 5. Finish with checks, a short status summary, and explicit remaining blockers.
 `;
 }
@@ -101,7 +101,7 @@ export function prepareCodexContinuation(repoRoot: string, options: CodexContinu
     controller: 'codex-cli',
     allowedActions: [
       'inspect compact backlog and stuck-state reports',
-      'finish low/medium successful runs using forge controller finish-ready-runs',
+      'finish validated bounded Work through rh_work.finalize when policy allows',
       'prepare patches for remaining blocker classes',
       'run declared checks and summarize failures',
     ],
@@ -123,9 +123,6 @@ export function prepareCodexContinuation(repoRoot: string, options: CodexContinu
       recommendations: stuckStates.recommendations,
     },
     nextCommands: [
-      'forge controller completion-backlog --json',
-      'forge controller stuck-states --json',
-      ...(backlog.finishableRunIds.length ? ['forge controller finish-ready-runs --apply --json'] : []),
       'npm run check:type',
       'npm run check:mcp-compatibility',
     ],

package/src/cli/controller/context-pack.ts

@@ -13,7 +13,7 @@ import {
   type CodeGraphReadProviderResponse,
 } from "../../runtime/context/codegraph-read-provider";
 
-const CONTEXT_PACK_SCHEMA_VERSION = 4;
+const CONTEXT_PACK_SCHEMA_VERSION = 6;
 const DEFAULT_MAX_FILES = 8;
 const DEFAULT_MAX_SNIPPETS = 20;
 const DEFAULT_SNIPPET_CONTEXT_BEFORE = 12;
@@ -38,6 +38,22 @@ const STOPWORDS = new Set([
 ]);
 
 export type StructuralContextMode = "off" | "auto" | "required";
+export type ControllerContextRetrievalMode = "implementation" | "plan" | "debug" | "review";
+export const CONTROLLER_CONTEXT_IMPACT_DOMAINS = [
+  "persistence", "scheduler", "notification", "timeline", "events", "cache", "api", "concurrency",
+] as const;
+export type ControllerContextImpactDomain = (typeof CONTROLLER_CONTEXT_IMPACT_DOMAINS)[number];
+
+const IMPACT_DOMAIN_TERMS: Record<ControllerContextImpactDomain, readonly string[]> = {
+  persistence: ["persist", "database", "repository"],
+  scheduler: ["scheduler", "schedule", "reminder"],
+  notification: ["notification", "notify", "push"],
+  timeline: ["timeline", "history", "activity"],
+  events: ["event", "publish", "subscribe"],
+  cache: ["cache", "invalidate", "memo"],
+  api: ["api", "dto", "controller"],
+  concurrency: ["transaction", "lock", "atomic"],
+};
 
 export interface ControllerContextPackOptions {
   description?: string;
@@ -51,6 +67,9 @@ export interface ControllerContextPackOptions {
   maxSnippets?: number;
   maxCharsPerSnippet?: number;
   structuralContext?: StructuralContextMode;
+  retrievalMode?: ControllerContextRetrievalMode;
+  /** GPT-selected cross-cutting evidence dimensions. Forge expands mechanically and never treats them as semantic completeness proof. */
+  impactDomains?: ControllerContextImpactDomain[];
 }
 
 export interface ControllerContextPackDependencies {
@@ -97,6 +116,15 @@ export interface ControllerContextPackProjection {
   };
   search: {
     terms: string[];
+    impactDomains: ControllerContextImpactDomain[];
+    impactCoverage: Array<{
+      domain: ControllerContextImpactDomain;
+      queries: string[];
+      matchedFiles: string[];
+      selectedFiles: string[];
+      omittedFileCount: number;
+      status: "selected" | "matched_not_selected" | "no_evidence";
+    }>;
     includeGlobs: string[];
     excludeGlobs: string[];
     scannedFiles: number;
@@ -132,7 +160,10 @@ export interface ControllerContextPackProjection {
   };
   contextContract: {
     strategy: string;
-    rawCodeRequiredForImplementation: true;
+    retrievalMode: ControllerContextRetrievalMode;
+    semanticSufficiencyAuthority: "chatgpt";
+    rawCodeRequiredForImplementation: boolean;
+    expansionSignals: string[];
     notes: string[];
   };
   next: string[];
@@ -364,6 +395,7 @@ export function buildControllerContextPack(
   options: ControllerContextPackOptions = {},
   dependencies: ControllerContextPackDependencies = {},
 ): ControllerContextPackProjection {
+  const retrievalMode = options.retrievalMode ?? "implementation";
   const maxFiles = clamp(options.maxFiles, DEFAULT_MAX_FILES, 1, 30);
   const maxSnippets = clamp(options.maxSnippets, DEFAULT_MAX_SNIPPETS, 1, 80);
   const maxCharsPerSnippet = clamp(options.maxCharsPerSnippet, DEFAULT_MAX_CHARS_PER_SNIPPET, 500, 50_000);
@@ -395,6 +427,23 @@ export function buildControllerContextPack(
   ].filter((entry): entry is string => typeof entry === "string" && entry.trim().length > 0);
   const goal = goalParts.join("\n").trim();
   const terms = cleanList([...(options.searchTerms ?? []), ...textTokens(goal)]).slice(0, 14);
+  const impactDomains = cleanList(options.impactDomains)
+    .filter((domain): domain is ControllerContextImpactDomain => CONTROLLER_CONTEXT_IMPACT_DOMAINS.includes(domain as ControllerContextImpactDomain))
+    .slice(0, 6);
+  const impactTermDomains = new Map<string, ControllerContextImpactDomain[]>();
+  for (const domain of impactDomains) {
+    for (const term of IMPACT_DOMAIN_TERMS[domain]) {
+      const existing = impactTermDomains.get(term) ?? [];
+      if (!existing.includes(domain)) existing.push(domain);
+      impactTermDomains.set(term, existing);
+    }
+  }
+  const searchQueries = cleanList([
+    ...(terms[0] ? [terms[0]] : []),
+    ...impactDomains.flatMap((domain) => IMPACT_DOMAIN_TERMS[domain]),
+    ...terms.slice(1),
+  ]).slice(0, 32);
+  const impactCandidatePaths = new Map<ControllerContextImpactDomain, Set<string>>(impactDomains.map((domain) => [domain, new Set<string>()]));
   const candidates = new Map<string, { reasons: Set<string>; lines: Set<number> }>();
   const deniedPaths: Array<{ path: string; reason: string }> = [];
   const omitted: Array<{ path: string; reason: string }> = [];
@@ -415,7 +464,7 @@ export function buildControllerContextPack(
   };
 
   if (structuralMode !== "off") {
-    const structuralQuery = goal || terms.join(" ");
+    const structuralQuery = [goal || terms.join(" "), ...impactDomains].filter(Boolean).join(" ");
     if (!structuralQuery) {
       structuralContext = {
         ...structuralContext,
@@ -504,9 +553,9 @@ export function buildControllerContextPack(
   // Lexical retrieval is one bounded pass across candidate files for all terms.
   // The old per-term loop reread the same source files up to 14 times even
   // though inventory itself was cached.
-  if (terms.length > 0 && candidates.size < maxFiles * 3) {
+  if (searchQueries.length > 0 && candidates.size < maxFiles * 3) {
     const search = searchRepositoryMany(repoRoot, policy, {
-      queries: terms,
+      queries: searchQueries,
       includeGlobs: searchIncludeGlobs,
       excludeGlobs,
       maxResultsPerQuery: Math.max(maxFiles * 4, 12),
@@ -521,7 +570,16 @@ export function buildControllerContextPack(
     searchTruncated = searchTruncated || search.truncated;
     for (const hit of search.results) {
       if (!coveredByGlob(hit.path, searchIncludeGlobs) || excludeGlobs.some((glob) => globMatches(glob, hit.path))) continue;
-      addReason(candidates, hit.path, `search:${hit.query}`, hit.line);
+      if (terms.includes(hit.query)) {
+        addReason(candidates, hit.path, `search:${hit.query}`, hit.line);
+      } else {
+        const domains = impactTermDomains.get(hit.query) ?? [];
+        if (domains.length === 0) addReason(candidates, hit.path, `search:${hit.query}`, hit.line);
+        for (const domain of domains) {
+          impactCandidatePaths.get(domain)?.add(hit.path);
+          addReason(candidates, hit.path, `impact:${domain}:${hit.query}`, hit.line);
+        }
+      }
       if (candidates.size >= maxFiles * 3) break;
     }
   }
@@ -541,6 +599,19 @@ export function buildControllerContextPack(
       return left.path.localeCompare(right.path);
     });
   const selected = rankedCandidates.slice(0, maxFiles);
+  const selectedPaths = new Set(selected.map((entry) => entry.path));
+  const impactCoverage = impactDomains.map((domain) => {
+    const matchedFiles = [...(impactCandidatePaths.get(domain) ?? new Set<string>())].sort();
+    const selectedFiles = matchedFiles.filter((path) => selectedPaths.has(path));
+    return {
+      domain,
+      queries: [...IMPACT_DOMAIN_TERMS[domain]],
+      matchedFiles: matchedFiles.slice(0, 20),
+      selectedFiles: selectedFiles.slice(0, 20),
+      omittedFileCount: Math.max(0, matchedFiles.length - selectedFiles.length),
+      status: selectedFiles.length > 0 ? "selected" as const : matchedFiles.length > 0 ? "matched_not_selected" as const : "no_evidence" as const,
+    };
+  });
   for (const entry of rankedCandidates.slice(maxFiles)) omitted.push({ path: entry.path, reason: "max_files" });
 
   let remainingSnippets = maxSnippets;
@@ -595,6 +666,26 @@ export function buildControllerContextPack(
     omitted.push({ path: "<none>", reason: "No description, search_terms, issue/task focus, or known_paths produced search terms." });
   }
 
+  const rawSnippetTruncated = files.some((file) => file.snippets.some((snippet) => snippet.truncated));
+  const expansionSignals = [
+    ...(files.length === 0 ? ["no_current_raw_source"] : []),
+    ...(rawSnippetTruncated ? ["raw_snippet_truncated"] : []),
+    ...(searchTruncated ? ["candidate_search_truncated"] : []),
+    ...(structuralContext.truncated ? ["structural_context_truncated"] : []),
+    ...(structuralContext.status === "stale" ? ["structural_context_stale"] : []),
+    ...(structuralMode === "required" && !structuralContext.requiredSatisfied ? ["required_structural_context_unavailable"] : []),
+    ...(policyDeniedFiles > 0 || deniedPaths.length > 0 ? ["policy_denied_candidates"] : []),
+    ...(skippedLargeFiles > 0 ? ["large_candidates_skipped"] : []),
+    ...impactCoverage.flatMap((coverage) => coverage.status === "no_evidence"
+      ? [`impact_domain_without_evidence:${coverage.domain}`]
+      : coverage.status === "matched_not_selected"
+        ? [`impact_domain_not_selected:${coverage.domain}`]
+        : []),
+  ];
+  const rawCodeRequiredForImplementation = retrievalMode !== "implementation"
+    || files.length === 0
+    || rawSnippetTruncated;
+
   return {
     schemaVersion: CONTEXT_PACK_SCHEMA_VERSION,
     generatedAt: new Date().toISOString(),
@@ -609,7 +700,9 @@ export function buildControllerContextPack(
     goal,
     git,
     search: {
-      terms,
+      terms: searchQueries,
+      impactDomains,
+      impactCoverage,
       includeGlobs: searchIncludeGlobs,
       excludeGlobs,
       scannedFiles,
@@ -628,13 +721,22 @@ export function buildControllerContextPack(
       checks: taskChecks,
     },
     contextContract: {
-      strategy: "Use this pack for scoped investigation only. Do not treat search ranking or summaries as proof of the correct implementation.",
-      rawCodeRequiredForImplementation: true,
+      strategy: retrievalMode === "implementation"
+        ? "Use the returned current raw snippets plus bounded impact evidence as the implementation decision input. ChatGPT owns semantic sufficiency; do not re-read source solely because it arrived through search."
+        : "Use this pack as investigation evidence and deliberately expand the evidence surface when the selected mode requires planning, debugging, or review.",
+      retrievalMode,
+      semanticSufficiencyAuthority: "chatgpt",
+      rawCodeRequiredForImplementation,
+      expansionSignals,
       notes: [
-        "The pack includes bounded raw snippets around explicit paths, text search hits, and any policy-approved structural candidates; expand exact files/ranges before editing important code.",
+        retrievalMode === "implementation"
+          ? "The pack already contains policy-approved current raw source snippets with file SHA identities. Request wider/exact ranges only when ChatGPT judges the impact surface ambiguous or an expansion signal makes the raw evidence mechanically incomplete."
+          : "Investigation modes may intentionally expand exact ranges, structural relationships, tests, and neighboring modules before any implementation decision.",
+        "Search/CodeGraph ranking is discovery evidence, not a business-semantics authority. Forge never decides that the returned files are the complete semantic impact surface.",
+        impactDomains.length > 0 ? `Impact domains were selected by ChatGPT and expanded mechanically in this same retrieval call: ${impactDomains.join(", ")}. Missing or omitted domain evidence is an ambiguity signal, not proof that the domain is irrelevant.` : "No explicit cross-cutting impact domains were requested; ChatGPT may add them when state, scheduling, notifications, events, caching, API, or concurrency could materially change the implementation.",
         "CodeGraph structural evidence is discovery evidence. Raw source access still passes through Forge repository policy and current-file reads.",
         structuralContext.status === "stale" ? "CodeGraph reports stale structural evidence. Treat graph relationships as hints and prefer the returned current raw source for changed files." : structuralContext.status === "unavailable" || structuralContext.status === "degraded" ? "Structural context was unavailable or degraded; bounded text search remains the fallback." : structuralContext.status === "ready" ? "CodeGraph structural context was queried read-only with index sync disabled." : "Structural context was not requested.",
-        "Run focused validation after patching; a context pack is not a substitute for tests, typecheck, diff review, or source review.",
+        "Run focused validation after a coherent edit batch; expensive full-suite checks belong at candidate/release boundaries unless debugging specifically needs them earlier.",
         taskChecks.length > 0 ? `Task checks advertised by the board: ${taskChecks.join(", ")}.` : "No task-specific checks were found in the compact ledger.",
       ],
     },
@@ -643,10 +745,12 @@ export function buildControllerContextPack(
         ? ["Structural context was required but is not current/ready. Refresh CodeGraph explicitly or continue only with the degraded-plan warning visible."]
         : []),
       files.length > 0
-        ? "Inspect the returned snippets and request exact wider ranges for files that will be edited."
+        ? retrievalMode === "implementation"
+          ? "ChatGPT should decide whether the impact coverage is sufficient; if yes, edit directly from the returned current raw snippets and SHA identities instead of issuing a mandatory second read."
+          : "Expand exact ranges or neighboring evidence when that investigation can materially change the plan, diagnosis, or review conclusion."
         : "Provide known_paths or narrower search_terms before attempting implementation.",
-      "After editing, review diff projection plus the raw diff for the edited files.",
-      "Use targeted validation before accepting or merging the change.",
+      "After editing, review the bounded diff/evidence for the coherent edit batch.",
+      "Use targeted validation before acceptance; defer expensive full-suite validation to a stable candidate or release boundary unless the task specifically requires it earlier.",
     ],
   };
 }

package/src/cli/controller/operational-plan.ts

@@ -71,7 +71,7 @@ export interface ControllerOperationalPlan {
     source: "task-recovery-loop";
     continuationState: string;
     nextActions: string[];
-    handoffArtifacts: string[];
+    recoveryArtifacts: string[];
   };
 }
 
@@ -173,7 +173,7 @@ export function buildControllerOperationalPlan(repoRoot: string, ledger: TaskLed
           label: "Fresh-session recovery",
           when: "A controller session restarts or loses conversation state.",
           steps: ["load task ledger", "read operational plan", "select continuation state", "expand only needed context", "resume or ask for the one missing decision"],
-          requiredEvidence: ["taskLedger", "operationalPlan", "handoffArtifacts"],
+          requiredEvidence: ["taskLedger", "operationalPlan", "recoveryArtifacts"],
         },
       ],
     },
@@ -195,7 +195,7 @@ export function buildControllerOperationalPlan(repoRoot: string, ledger: TaskLed
     },
     mcpToolSchemaConvergence: {
       source: "mcp-tool-schema-convergence",
-      readModels: ["controller_context", "controller_context_pack", "work_status_digest", "prepare_handoff_artifacts"],
+      readModels: ["controller_context", "controller_context_pack", "work_status_digest", "prepare_transfer_artifacts"],
       commandModels: ["work_submit", "run_check", "dispatch_task", "verify_task", "accept_task", "repository_safe_patch_apply"],
       compatibilityRules: [
         "compact reads are default",
@@ -220,7 +220,7 @@ export function buildControllerOperationalPlan(repoRoot: string, ledger: TaskLed
       source: "task-recovery-loop",
       continuationState: ledger.status.kind,
       nextActions: ledger.suggestedNextActions.slice(0, 6),
-      handoffArtifacts: [".ai/harness/controller/task-ledger.json", ".ai/harness/handoff/controller-current.md"],
+      recoveryArtifacts: [".ai/harness/controller/task-ledger.json", ".ai/harness/projections/controller-task-ledger.md"],
     },
   };
 }

package/src/cli/controller/task-ledger.ts

@@ -7,7 +7,7 @@ import { resolveRepoPreferredControllerHome } from "../repositories/controller-h
 import { buildRequirementBoard } from "../../runtime/control-plane/facade/requirement-board";
 
 const LEDGER_JSON_PATH = ".ai/harness/controller/task-ledger.json";
-const LEDGER_HANDOFF_PATH = ".ai/harness/handoff/controller-current.md";
+const LEDGER_PROJECTION_PATH = ".ai/harness/projections/controller-task-ledger.md";
 const LEDGER_SCHEMA_VERSION = 2;
 
 export interface TaskLedgerTaskProjection {
@@ -539,7 +539,7 @@ function renderTaskRow(task: TaskLedgerTaskProjection): string {
   return `| ${tableEscape(task.issueId)} | ${tableEscape(task.taskId)} | ${tableEscape(task.title)} | ${tableEscape(task.effectiveStatus)} | ${tableEscape(task.verificationStatus)} | ${tableEscape(task.latestRunStatus ?? task.activeRunStatus ?? "")} |`;
 }
 
-export function renderControllerTaskLedgerHandoff(projection: TaskLedgerProjection, reason: string): string {
+export function renderControllerTaskLedgerProjection(projection: TaskLedgerProjection, reason: string): string {
   const current = projection.currentIssueId
     ? projection.issues.find((issue) => issue.id === projection.currentIssueId)
     : undefined;
@@ -547,7 +547,7 @@ export function renderControllerTaskLedgerHandoff(projection: TaskLedgerProjecti
     ? projection.attention.map(renderTaskRow)
     : ["| - | - | No attention tasks | - | - | - |"];
   return [
-    "# Controller Task Ledger Handoff",
+    "# Controller Task Ledger Projection",
     "",
     `> **Generated**: ${projection.generatedAt}`,
     `> **Reason**: ${reason}`,
@@ -608,25 +608,25 @@ function artifactPreview(repoRoot: string, path: string): TaskLedgerArtifactPrev
 
 export function writeControllerTaskLedgerArtifacts(repoRoot: string, input: { reason?: unknown } = {}): WrittenTaskLedgerArtifacts {
   if (legacyIssueCutoverState(repoRoot).retired) {
-    throw new Error("LEGACY_TASK_LEDGER_WRITES_RETIRED: task-ledger and handoff files are frozen after SQLite cutover.");
+    throw new Error("LEGACY_TASK_LEDGER_WRITES_RETIRED: task-ledger projection files are frozen after SQLite cutover.");
   }
   const reason = String(input.reason ?? "manual").trim() || "manual";
   const projection = buildControllerTaskLedgerProjection(repoRoot);
   const jsonPath = join(repoRoot, LEDGER_JSON_PATH);
-  const handoffPath = join(repoRoot, LEDGER_HANDOFF_PATH);
+  const projectionPath = join(repoRoot, LEDGER_PROJECTION_PATH);
   mkdirSync(dirname(jsonPath), { recursive: true });
-  mkdirSync(dirname(handoffPath), { recursive: true });
+  mkdirSync(dirname(projectionPath), { recursive: true });
   writeFileSync(jsonPath, `${JSON.stringify(projection, null, 2)}\n`, "utf-8");
-  writeFileSync(handoffPath, renderControllerTaskLedgerHandoff(projection, reason), "utf-8");
+  writeFileSync(projectionPath, renderControllerTaskLedgerProjection(projection, reason), "utf-8");
   return {
     projection,
     artifacts: [
       artifactPreview(repoRoot, LEDGER_JSON_PATH),
-      artifactPreview(repoRoot, LEDGER_HANDOFF_PATH),
+      artifactPreview(repoRoot, LEDGER_PROJECTION_PATH),
     ],
   };
 }
 
-export function controllerTaskLedgerArtifactPaths(): { json: string; handoff: string } {
-  return { json: LEDGER_JSON_PATH, handoff: LEDGER_HANDOFF_PATH };
+export function controllerTaskLedgerArtifactPaths(): { json: string; projection: string } {
+  return { json: LEDGER_JSON_PATH, projection: LEDGER_PROJECTION_PATH };
 }

package/src/cli/controller/work-mode.ts

@@ -6,8 +6,8 @@ import {
   type RoutePolicyInput,
 } from '../../runtime/control-plane/routing/route-policy';
 
-export type WorkMode = 'direct_edit' | 'bounded_work' | 'quick_agent' | 'issue_task' | 'campaign';
-export type ExecutionPathPreference = 'fast' | 'durable' | 'campaign';
+export type WorkMode = 'direct_edit' | 'bounded_work' | 'quick_agent' | 'issue_task';
+export type ExecutionPathPreference = 'fast' | 'durable';
 export type EffectiveTaskMode = ExplicitTaskMode | 'bounded';
 
 export interface WorkModeAssessmentInput {
@@ -38,7 +38,6 @@ export interface WorkModeAssessment {
   reasons: string[];
   nextTools: string[];
   issueRequired: boolean;
-  campaignRequired: boolean;
   taskMode: EffectiveTaskMode;
   explicitMode: ExplicitTaskMode | null;
   modeBehavior: {
@@ -57,7 +56,7 @@ export function parseExplicitTaskMode(value: unknown): ExplicitTaskMode | undefi
   if (typeof value !== 'string') return undefined;
   if (!value) return undefined;
   const normalized = value.replace(/^-/, '') as ExplicitTaskMode;
-  return ['direct', 'plan', 'debug', 'review', 'campaign', 'release', 'scale'].includes(normalized)
+  return ['direct', 'plan', 'debug', 'review', 'release', 'scale'].includes(normalized)
     ? normalized
     : undefined;
 }
@@ -80,10 +79,6 @@ function behaviorFor(mode: EffectiveTaskMode): WorkModeAssessment['modeBehavior'
       structuralContext: 'off', mutationPhase: 'read_only', issueRequired: false, planRequired: false, worktreeRequired: false,
       workflow: ['read diff and affected source', 'review correctness and regressions', 'review lifecycle, concurrency, and security', 'report test gaps without mutation'],
     };
-    case 'campaign': return {
-      structuralContext: 'off', mutationPhase: 'coordinate', issueRequired: false, planRequired: false, worktreeRequired: true,
-      workflow: ['decompose independent deliverables', 'create campaign', 'schedule isolated Tasks', 'reconcile and review campaign evidence'],
-    };
     case 'release': return {
       structuralContext: 'off', mutationPhase: 'release_gate', issueRequired: false, planRequired: false, worktreeRequired: false,
       workflow: ['verify checks and changelog', 'build immutable complete release', 'run integration and deployment gates', 'activate through Recovery', 'verify rollback evidence'],
@@ -100,7 +95,6 @@ function behaviorFor(mode: EffectiveTaskMode): WorkModeAssessment['modeBehavior'
 }
 
 function nextTools(decision: RouteDecision, investigation: boolean): string[] {
-  if (decision.workMode === 'campaign') return ['create_campaign', 'add_campaign_task', 'reconcile_campaign', 'get_campaign_review_packet'];
   if (decision.workMode === 'issue_task') return ['inspect_issue_readiness', 'create_issue or append_task', 'dispatch_task', 'verify_task', 'accept_task'];
   if (decision.workMode === 'quick_agent') return ['search_repository', 'rh_work(operation=delegate)', 'rh_work(operation=continue)', 'rh_work(operation=verify)'];
   if (decision.workMode === 'bounded_work') return [
@@ -129,7 +123,7 @@ export function assessWorkMode(input: WorkModeAssessmentInput): WorkModeAssessme
   const explicitMode = parseExplicitTaskMode(input.explicitMode);
   const investigationMode = explicitMode === 'plan' || explicitMode === 'debug' || explicitMode === 'review';
   const readonlyMode = investigationMode;
-  const parallelMode = explicitMode === 'campaign' || explicitMode === 'scale';
+  const parallelMode = explicitMode === 'scale';
   const routeDecision = decideRoute(input.routePolicyInput ?? {
     intent: {
       objective: input.description,
@@ -160,7 +154,7 @@ export function assessWorkMode(input: WorkModeAssessmentInput): WorkModeAssessme
     },
   });
   const taskMode: EffectiveTaskMode = explicitMode
-    ?? (routeDecision.workMode === 'campaign' ? 'campaign' : routeDecision.workMode === 'direct_edit' ? 'direct' : 'bounded');
+    ?? (routeDecision.workMode === 'direct_edit' ? 'direct' : 'bounded');
   const modeBehavior = behaviorFor(taskMode);
   return {
     recommendedMode: routeDecision.workMode,
@@ -174,10 +168,9 @@ export function assessWorkMode(input: WorkModeAssessmentInput): WorkModeAssessme
         : explicitMode === 'release'
           ? ['run_check', 'request_release_gate', 'capability_recovery_plan', 'capability_recovery_apply', 'controller_ready']
           : explicitMode === 'scale'
-            ? ['create_campaign', 'process_start', 'process_wait', 'benchmark evidence']
+            ? ['rh_work(operation=plan_create)', 'rh_work(operation=start)', 'process_get', 'process_wait', 'benchmark evidence']
             : nextTools(routeDecision, input.requiresInvestigation === true || investigationMode || (input.knownPaths?.length ?? 0) === 0),
     issueRequired: routeDecision.workMode === 'issue_task',
-    campaignRequired: routeDecision.workMode === 'campaign',
     taskMode,
     explicitMode: explicitMode ?? null,
     modeBehavior,

package/src/cli/index.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 /**
- * Forge CLI entry with forge compatibility aliases.
+ * Forge CLI entry. Public commands expose product workflows; compatibility and host-dispatch commands stay hidden.
  *
  * Wires commander.js to the global runtime bootstrap, repo-local update,
  * hook adapter, status, doctor, migrate, security, and tool command bodies.
@@ -13,7 +13,7 @@ import { runInit, runInteractiveInit, type InitBrainMode } from './commands/init
 import { runHook } from './commands/hook';
 import { CLI_VERSION, formatStatus, runStatus } from './commands/status';
 import { formatDoctor, runDoctor } from './commands/doctor';
-import { buildInitHookCommand, buildSetupCommand, formatInitHook, runInitHook } from './commands/init-hook';
+import { buildSetupCommand, formatInitHook, runInitHook } from './commands/init-hook';
 import { formatMigratePlan, runMigrate } from './commands/migrate';
 import { buildToolsCommand } from './commands/tools';
 import { buildPluginCommand } from './commands/plugin';
@@ -23,7 +23,6 @@ import { buildDocsCommand } from './commands/docs';
 import { buildMcpCommand } from './commands/mcp';
 import { buildChatgptCommand } from './commands/chatgpt';
 import { buildRunCommand } from './commands/run';
-import { buildControllerCommand } from './commands/controller';
 import { buildRepositoryCommand } from './commands/repository';
 import { buildRuntimeCommand } from './commands/runtime';
 import { buildRecoveryCommand } from './commands/recovery';
@@ -41,8 +40,6 @@ import { bootstrapManagedRuntimeEnv } from '../runtime/shared/managed-env';
 bootstrapManagedRuntimeEnv();
 
 export const SUBCOMMANDS = [
-  'init',
-  'init-hook',
   'install',
   'uninstall',
   'hook',
@@ -76,7 +73,7 @@ interface GlobalRuntimeCommandOptions {
   cli?: boolean;
   syncSkill?: boolean;
   hooks?: string | false;
-  externalSkills?: boolean;
+  withExternalSkills?: boolean;
   codegraph?: boolean;
   brainRoot?: string;
   json?: boolean;
@@ -94,7 +91,7 @@ function runGlobalRuntimeBootstrap(commandName: 'init' | 'install', rawOpts: Glo
     installCli: rawOpts.cli !== false,
     syncSkill: rawOpts.syncSkill !== false,
     hostAdapters: rawOpts.hooks !== false,
-    externalSkills: rawOpts.externalSkills !== false,
+    externalSkills: rawOpts.withExternalSkills === true,
     codegraph: rawOpts.codegraph !== false,
     brainRoot: rawOpts.brainRoot,
   });
@@ -114,21 +111,6 @@ export function buildProgram(): Command {
     .addHelpText('after', '\nGlobal shortcuts:\n  -V, --version  output the version number')
     .exitOverride();
 
-  program
-    .command('init')
-    .description('Install the Forge CLI, global hook adapters, and required runtime dependencies')
-    .option('--target <target>', `Host target for adapters and runtime skills: ${VALID_TARGETS.join('|')}`, 'both')
-    .option('--no-cli', 'Skip installing the Forge CLI globally')
-    .option('--no-sync-skill', 'Skip refreshing legacy forge skill aliases under host skill roots')
-    .option('--no-hooks', 'Skip global hook adapter installation')
-    .option('--no-external-skills', 'Skip Waza, Mermaid, and cross-review (codex-review/claude-review) skill bootstrap')
-    .option('--no-codegraph', 'Skip CodeGraph CLI/MCP configuration')
-    .option('--brain-root <path>', 'Brain vault root to persist for Forge brain commands')
-    .option('--refresh', 'Compatibility no-op; init already refreshes the idempotent user-level runtime')
-    .option('--json', 'Output JSON instead of human-readable text')
-    .action((rawOpts: GlobalRuntimeCommandOptions & { refresh?: boolean }) => {
-      runGlobalRuntimeBootstrap('init', rawOpts);
-    });
 
   program
     .command('update')
@@ -140,7 +122,7 @@ export function buildProgram(): Command {
     .option('--check-updates', 'Include network-backed version update advisories in setup check output')
     .option('--no-runtime-refresh', 'Skip runtime refresh and run the read-only setup check only')
     .option('--no-cli', 'Skip installing the Forge CLI globally')
-    .option('--no-sync-skill', 'Skip refreshing legacy forge skill aliases under host skill roots')
+    .option('--no-sync-skill', 'Skip refreshing Forge host skill aliases')
     .option('--no-hooks', 'Skip global hook adapter installation')
     .option('--with-external-skills', 'Also bootstrap third-party Waza, Mermaid, and cross-review skills')
     .option('--no-external-skills', 'Compatibility no-op; update no longer bootstraps third-party skills by default')
@@ -164,7 +146,6 @@ export function buildProgram(): Command {
       syncSkill?: boolean;
       hooks?: string | false;
       withExternalSkills?: boolean;
-      externalSkills?: boolean;
       codegraph?: boolean;
       configureCodegraph?: boolean;
       brainRoot?: string;
@@ -220,7 +201,7 @@ export function buildProgram(): Command {
 
   program
     .command('adopt')
-    .description('Install or refresh the repo-local harness workflow in an existing repo')
+    .description('Install or refresh the repo-local Forge workflow in an existing repo')
     .argument('[action]', 'Optional action: rollback')
     .option('--repo <path>', 'Target repository path (defaults to cwd)')
     .option('--archive <path>', 'Runtime reclaim archive to restore when action is rollback')
@@ -250,7 +231,7 @@ export function buildProgram(): Command {
       target: string;
       syncSkill?: boolean;
       hostAdapters?: boolean;
-      externalSkills?: boolean;
+      withExternalSkills?: boolean;
       verify?: boolean;
       codegraph?: boolean;
       reclaimRuntime?: boolean;
@@ -409,9 +390,9 @@ export function buildProgram(): Command {
     .option('--target <target>', `Target host: ${VALID_TARGETS.join('|')}`, 'both')
     .option('--location <location>', `Adapter-only install location: ${VALID_LOCATIONS.join('|')}`)
     .option('--no-cli', 'Skip installing the Forge CLI globally')
-    .option('--no-sync-skill', 'Skip refreshing legacy forge skill aliases under host skill roots')
+    .option('--no-sync-skill', 'Skip refreshing Forge host skill aliases')
     .option('--no-hooks', 'Skip global hook adapter installation during full runtime install')
-    .option('--no-external-skills', 'Skip Waza, Mermaid, and cross-review (codex-review/claude-review) skill bootstrap')
+    .option('--with-external-skills', 'Also install optional third-party Waza/Mermaid skills and Forge cross-review helpers')
     .option('--no-codegraph', 'Skip CodeGraph CLI/MCP configuration')
     .option('--brain-root <path>', 'Brain vault root to persist for Forge brain commands')
     .option('--json', 'Output JSON instead of human-readable text')
@@ -466,7 +447,7 @@ export function buildProgram(): Command {
     });
 
   program
-    .command('hook')
+    .command('hook', { hidden: true })
     .description('Dispatch a hook event to opt-in repo .ai/hooks/<script>')
     .argument('<event>', 'Hook event name')
     .requiredOption('--route <route>', 'Route id (default, edit, bash, always)')
@@ -498,11 +479,10 @@ export function buildProgram(): Command {
       process.exit(report.summary.fail > 0 ? 1 : 0);
     });
 
-  program.addCommand(buildInitHookCommand());
   program.addCommand(buildSetupCommand());
 
   program
-    .command('migrate')
+    .command('migrate', { hidden: true })
     .description('Migrate legacy project-level hook adapters to the global CLI (dry-run by default)')
     .option('--apply', 'Commit changes (default is dry-run)')
     .option('--json', 'Output JSON plan')
@@ -529,13 +509,12 @@ export function buildProgram(): Command {
 
   program.addCommand(buildToolsCommand());
   program.addCommand(buildPluginCommand());
-  program.addCommand(buildBrainCommand());
-  program.addCommand(buildCapabilityContextCommand());
+  program.addCommand(buildBrainCommand(), { hidden: true });
+  program.addCommand(buildCapabilityContextCommand(), { hidden: true });
   program.addCommand(buildDocsCommand());
   program.addCommand(buildMcpCommand());
   program.addCommand(buildChatgptCommand());
-  program.addCommand(buildRunCommand());
-  program.addCommand(buildControllerCommand());
+  program.addCommand(buildRunCommand(), { hidden: true });
   program.addCommand(buildRepositoryCommand());
   program.addCommand(buildRuntimeCommand());
   program.addCommand(buildRecoveryCommand());

package/src/cli/local-bridge/connector-freshness.ts

@@ -28,7 +28,7 @@ export const EXPECTED_FACADE_TOOLS = [...PREFERRED_FACADE_TOOL_NAMES] as const;
 /**
  * Interactive development tools in the bounded default schema. The historical
  * core and advanced labels expose the same bounded default surface; git / issue /
- * campaign atomics live in the `full` compatibility profile.
+ * legacy atomics live in the `full` compatibility profile.
  */
 export const OPTIONAL_INTERACTIVE_DEVELOPMENT_TOOLS = [
   'repository_safe_patch_apply',

package/src/cli/local-bridge/console-assets.ts

@@ -0,0 +1,17 @@
+import { existsSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+
+export type ConsoleAssetName = "app.js" | "app.css";
+
+export function resolveConsoleAssetPath(
+  asset: ConsoleAssetName,
+  executablePath = process.execPath,
+): string | URL {
+  const releaseAssetPath = join(dirname(executablePath), "ui-dist", asset);
+  if (existsSync(releaseAssetPath)) return releaseAssetPath;
+  return new URL(`./ui-dist/${asset}`, import.meta.url);
+}
+
+export function readConsoleAsset(asset: ConsoleAssetName): string {
+  return readFileSync(resolveConsoleAssetPath(asset), "utf8");
+}