@topogram/cli 0.3.72 → 0.3.74

package/src/cli/commands/sdlc.js

@@ -6,6 +6,7 @@ import { stableStringify } from "../../format.js";
 import { parsePath } from "../../parser.js";
 import { resolveWorkspace } from "../../resolver.js";
 import { formatValidationErrors } from "../../validator.js";
+import { resolveTopoRoot } from "../../workspace-paths.js";
 
 /**
  * @typedef {Record<string, any>} AnyRecord
@@ -21,6 +22,23 @@ function flagValue(args, flag) {
   return index >= 0 ? args[index + 1] || null : null;
 }
 
+/**
+ * @param {string[]} args
+ * @param {string} flag
+ * @returns {string[]}
+ */
+function flagValues(args, flag) {
+  /** @type {string[]} */
+  const values = [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === flag && args[index + 1] && !args[index + 1].startsWith("-")) {
+      values.push(args[index + 1]);
+      index += 1;
+    }
+  }
+  return values;
+}
+
 /**
  * @param {string[]} args
  * @returns {boolean}
@@ -29,6 +47,65 @@ function includeHistory(args) {
   return args.includes("--history") || args.includes("--include-history");
 }
 
+/**
+ * @param {Record<string, any>} payload
+ * @returns {void}
+ */
+function printPolicyExplain(payload) {
+  console.log("Topogram SDLC policy");
+  console.log(`Status: ${payload.policy?.status || "not_adopted"}`);
+  console.log(`Mode: ${payload.policy?.mode || "none"}`);
+  console.log(`Policy: ${payload.policy?.path || "missing"}`);
+  console.log(payload.enforcement || "Project has not adopted enforced SDLC.");
+  if ((payload.policy?.protectedPaths || []).length > 0) {
+    console.log("Protected paths:");
+    for (const item of payload.policy.protectedPaths) {
+      console.log(`  - ${item}`);
+    }
+  }
+  if ((payload.nextCommands || []).length > 0) {
+    console.log("Next commands:");
+    for (const command of payload.nextCommands) {
+      console.log(`  - ${command}`);
+    }
+  }
+}
+
+/**
+ * @param {Record<string, any>} payload
+ * @returns {void}
+ */
+function printCommitPrep(payload) {
+  console.log("Topogram SDLC commit prep");
+  console.log(`Status: ${payload.ok ? "ready" : "needs attention"}`);
+  console.log(`Changed task files: ${(payload.taskFiles || []).length}`);
+  if ((payload.openTasks || []).length > 0) {
+    console.log("Open changed tasks:");
+    for (const task of payload.openTasks) {
+      console.log(`  - ${task.id} (${task.status}, ${task.disposition || "unclassified"})`);
+      console.log(`    file: ${task.file}`);
+    }
+  }
+  if ((payload.errors || []).length > 0) {
+    console.log("Errors:");
+    for (const error of payload.errors) {
+      console.log(`  - ${error}`);
+    }
+  }
+  if ((payload.warnings || []).length > 0) {
+    console.log("Warnings:");
+    for (const warning of payload.warnings) {
+      console.log(`  - ${warning}`);
+    }
+  }
+  if ((payload.nextCommands || []).length > 0) {
+    console.log("Next commands:");
+    for (const command of payload.nextCommands) {
+      console.log(`  - ${command}`);
+    }
+  }
+}
+
 /**
  * @param {string} sdlcRoot
  * @returns {AnyRecord|null}
@@ -56,15 +133,144 @@ function resolveSdlcWorkspace(sdlcRoot) {
  */
 export async function runSdlcCommand(context) {
   const { commandArgs, args } = context;
-  const sdlcRoot = path.resolve(context.inputPath || ".");
+  const sdlcRoot = resolveTopoRoot(context.inputPath || ".");
   const actor = flagValue(args, "--actor");
   const note = flagValue(args, "--note");
   const status = flagValue(args, "--status");
+  const id = flagValue(args, "--id");
   const before = flagValue(args, "--before");
   const appVersion = flagValue(args, "--app-version");
   const sinceTag = flagValue(args, "--since-tag");
+  const base = flagValue(args, "--base");
+  const head = flagValue(args, "--head");
+  const exemption = flagValue(args, "--exemption");
+  const verification = flagValue(args, "--verification");
   const dryRun = args.includes("--dry-run");
   const strict = args.includes("--strict");
+  const json = args.includes("--json");
+
+  if (String(commandArgs.sdlcCommand || "").startsWith("policy:")) {
+    const {
+      explainSdlcPolicy,
+      loadSdlcPolicy,
+      policyProjectRoot,
+      writeDefaultSdlcPolicy
+    } = await import("../../sdlc/policy.js");
+    const projectRoot = policyProjectRoot(context.inputPath || ".");
+    if (commandArgs.sdlcCommand === "policy:init") {
+      const result = writeDefaultSdlcPolicy(projectRoot);
+      console.log(stableStringify(result));
+      return result.ok ? 0 : 1;
+    }
+    if (commandArgs.sdlcCommand === "policy:check") {
+      const info = loadSdlcPolicy(projectRoot);
+      const result = {
+        type: "sdlc_policy_check",
+        ok: info.exists && info.diagnostics.every((diagnostic) => diagnostic.severity !== "error"),
+        exists: info.exists,
+        path: info.path,
+        status: info.status,
+        mode: info.mode,
+        diagnostics: info.diagnostics
+      };
+      if (json) {
+        console.log(stableStringify(result));
+      } else if (result.ok) {
+        console.log(`SDLC policy is valid: ${result.path}`);
+      } else {
+        console.error(stableStringify(result));
+      }
+      return result.ok ? 0 : 1;
+    }
+    if (commandArgs.sdlcCommand === "policy:explain") {
+      const result = explainSdlcPolicy(projectRoot);
+      if (json) {
+        console.log(stableStringify(result));
+      } else {
+        printPolicyExplain(result);
+      }
+      return result.ok ? 0 : 1;
+    }
+  }
+
+  if (commandArgs.sdlcCommand === "gate") {
+    const { runSdlcGate } = await import("../../sdlc/gate.js");
+    const result = await runSdlcGate(context.inputPath || ".", {
+      base,
+      head,
+      sdlcIds: flagValues(args, "--sdlc-id"),
+      exemption,
+      requireAdopted: args.includes("--require-adopted")
+    });
+    console.log(stableStringify(result));
+    return result.ok ? 0 : 1;
+  }
+
+  if (commandArgs.sdlcCommand === "prep:commit") {
+    const { runSdlcCommitPrep } = await import("../../sdlc/prep.js");
+    const result = runSdlcCommitPrep(context.inputPath || ".", {
+      base,
+      head
+    });
+    if (json) {
+      console.log(stableStringify(result));
+    } else {
+      printCommitPrep(result);
+    }
+    return result.ok ? 0 : 1;
+  }
+
+  if (commandArgs.sdlcCommand === "link") {
+    const { linkSdlcRecord } = await import("../../sdlc/link.js");
+    const result = linkSdlcRecord(sdlcRoot, commandArgs.sdlcFromId, commandArgs.sdlcToId, {
+      write: args.includes("--write")
+    });
+    console.log(stableStringify(result));
+    return result.ok ? 0 : 1;
+  }
+
+  if (commandArgs.sdlcCommand === "complete") {
+    const { completeTask } = await import("../../sdlc/complete.js");
+    const result = completeTask(sdlcRoot, commandArgs.sdlcId, verification || "", {
+      write: args.includes("--write") && !dryRun,
+      actor,
+      note
+    });
+    console.log(stableStringify(result));
+    return result.ok ? 0 : 1;
+  }
+
+  if (commandArgs.sdlcCommand === "plan:create") {
+    const { createPlan } = await import("../../sdlc/plan.js");
+    const result = createPlan(sdlcRoot, commandArgs.sdlcId, commandArgs.sdlcSlug, {
+      write: args.includes("--write") && !dryRun
+    });
+    console.log(stableStringify(result));
+    return result.ok ? 0 : 1;
+  }
+
+  if (commandArgs.sdlcCommand === "plan:explain") {
+    const { explainPlan } = await import("../../sdlc/plan.js");
+    const result = explainPlan(sdlcRoot, commandArgs.sdlcId);
+    console.log(stableStringify(result));
+    return result.ok ? 0 : 1;
+  }
+
+  if (String(commandArgs.sdlcCommand || "").startsWith("plan:step:")) {
+    const { transitionPlanStep } = await import("../../sdlc/plan.js");
+    if (commandArgs.sdlcCommand === "plan:step:skip" && !note) {
+      console.log(stableStringify({ ok: false, error: "sdlc plan step skip requires --note <reason>" }));
+      return 1;
+    }
+    const result = transitionPlanStep(sdlcRoot, commandArgs.sdlcId, commandArgs.sdlcStepId, commandArgs.sdlcTargetStatus, {
+      write: args.includes("--write") && !dryRun,
+      dryRun,
+      actor,
+      note
+    });
+    console.log(stableStringify(result));
+    return result.ok ? 0 : 1;
+  }
 
   if (commandArgs.sdlcCommand === "transition") {
     const { transitionStatement } = await import("../../sdlc/transition.js");
@@ -115,10 +321,12 @@ export async function runSdlcCommand(context) {
     if (!resolved) {
       return 1;
     }
-    const ids = archiveEligibleStatements(resolved, {
-      before,
-      statuses: status ? status.split(",") : null
-    });
+    const ids = id
+      ? [id]
+      : archiveEligibleStatements(resolved, {
+          before,
+          statuses: status ? status.split(",") : null
+        });
     const result = archiveBatch(sdlcRoot, ids, { dryRun, by: actor, reason: note });
     console.log(stableStringify({ candidates: ids, ...result }));
     return result.ok ? 0 : 1;

package/src/cli/dispatcher.js

@@ -109,6 +109,7 @@ export async function runCliDispatch(context) {
     domainId,
     seamId,
     taskId,
+    planId,
     pitchId,
     requirementId,
     acceptanceId,
@@ -296,6 +297,13 @@ export async function runCliDispatch(context) {
       journeyId,
       surfaceId,
       domainId,
+      pitchId,
+      requirementId,
+      acceptanceId,
+      taskId,
+      planId,
+      bugId,
+      documentId,
       seamId,
       modeId,
       providerId,

package/src/cli/help.js

@@ -11,11 +11,19 @@ export function printUsage(options = {}) {
   console.log("   or: topogram doctor --allow-local-npmrc");
   console.log("Usage: topogram setup package-auth|catalog-auth");
   console.log("Usage: topogram release status [--json] [--strict] [--markdown|--write-report <path>]");
-  console.log("   or: topogram release roll-consumers <version|--latest> [--json] [--no-push] [--watch]");
+  console.log("   or: topogram release roll-consumers <version|--latest> [--json] [--no-push] [--watch|--no-watch]");
   console.log("Usage: topogram check [path] [--json]");
   console.log("   or: topogram widget check [path] [--projection <id>] [--widget <id>] [--json]");
   console.log("   or: topogram widget behavior [path] [--projection <id>] [--widget <id>] [--json]");
   console.log("   or: topogram agent brief [path] [--json]");
+  console.log("   or: topogram sdlc policy init|check|explain [path] [--json]");
+  console.log("   or: topogram sdlc gate [path] --base <ref> --head <ref> [--sdlc-id <id>] [--exemption <text>] [--require-adopted] [--json]");
+  console.log("   or: topogram sdlc prep commit [path] [--base <ref> --head <ref>] [--json]");
+  console.log("   or: topogram sdlc link <from-id> <to-id> [path] [--write]");
+  console.log("   or: topogram sdlc complete <task-id> [path] --verification <verification-id> [--dry-run|--write]");
+  console.log("   or: topogram sdlc plan create <task-id> <slug> [path] [--write]");
+  console.log("   or: topogram sdlc plan explain <plan-id> [path] [--json]");
+  console.log("   or: topogram sdlc plan step complete <plan-id> <step-id> [path] --actor <actor> [--write]");
   console.log("   or: topogram generate [path] [--out <path>]");
   console.log("   or: topogram emit <target> [path] [--json|--write --out-dir <path>]");
   console.log("   or: topogram query list [--json]");
@@ -77,6 +85,10 @@ export function printUsage(options = {}) {
   console.log("  topogram widget behavior --projection proj_web_surface");
   console.log("  topogram agent brief");
   console.log("  topogram agent brief --json");
+  console.log("  topogram sdlc policy explain");
+  console.log("  topogram sdlc prep commit . --base origin/main --head HEAD");
+  console.log("  topogram sdlc gate . --require-adopted");
+  console.log("  topogram sdlc plan explain plan_example --json");
   console.log("  topogram query list");
   console.log("  topogram query show widget-behavior");
   console.log("  topogram query widget-behavior ./topo --projection proj_web_surface --json");
@@ -164,7 +176,7 @@ export function printUsage(options = {}) {
   console.log("   or: node ./src/cli.js query maintained-drift <path> --from-topogram <path>");
   console.log("   or: node ./src/cli.js query seam-check <path> [--seam <id>] [--from-topogram <path>]");
   console.log("   or: node ./src/cli.js query diff <path> --from-topogram <path>");
-  console.log("   or: node ./src/cli.js query slice <path> [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--domain <id>]");
+  console.log("   or: node ./src/cli.js query slice <path> [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--domain <id>] [--task <id>] [--plan <id>] [--bug <id>]");
   console.log("   or: node ./src/cli.js query domain-list <path>");
   console.log("   or: node ./src/cli.js query domain-coverage <path> --domain <id>");
   console.log("   or: node ./src/cli.js query review-boundary <path> [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>]");
@@ -178,7 +190,7 @@ export function printUsage(options = {}) {
   console.log("   or: node ./src/cli.js query proceed-decision <path> [--mode <id>] [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--surface <id>] [--from-topogram <path>]");
   console.log("   or: node ./src/cli.js query review-packet <path> [--mode <id>] [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--surface <id>] [--from-topogram <path>]");
   console.log("   or: node ./src/cli.js query next-action <path> [--mode <id>] [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--from-topogram <path>]");
-  console.log("   or: node ./src/cli.js query single-agent-plan <path> --mode <id> [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--surface <id>] [--from-topogram <path>]");
+  console.log("   or: node ./src/cli.js query single-agent-plan <path> --mode <id> [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--surface <id>] [--task <id>] [--plan <id>] [--bug <id>] [--from-topogram <path>]");
   console.log("   or: node ./src/cli.js query multi-agent-plan <path> --mode import-adopt");
   console.log("   or: node ./src/cli.js query resolved-workflow-context <path> --mode <id> [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--surface <id>] [--provider <id>] [--preset <id>] [--from-topogram <path>]");
   console.log("   or: node ./src/cli.js query workflow-preset-activation <path> --mode <id> [--provider <id>] [--preset <id>] [--from-topogram <path>]");

package/src/cli/options.js

@@ -81,6 +81,7 @@ export function parseCliOptions(args, commandArgs) {
       domainId: optionValue(args, "--domain"),
       seamId: optionValue(args, "--seam"),
       taskId: optionValue(args, "--task"),
+      planId: optionValue(args, "--plan"),
       pitchId: optionValue(args, "--pitch"),
       requirementId: optionValue(args, "--requirement"),
       acceptanceId: optionValue(args, "--acceptance"),

package/src/generator/context/shared/domain-sdlc.js

@@ -135,6 +135,14 @@ export function acceptanceCriterionById(graph, id) {
 export function taskById(graph, id) {
   return (graph?.byKind?.task || []).find(/** @param {any} s */ (s) => s.id === id) || null;
 }
+/**
+ * @param {import("./types.d.ts").ContextGraph} graph
+ * @param {string} id
+ * @returns {any}
+ */
+export function planById(graph, id) {
+  return (graph?.byKind?.plan || []).find(/** @param {any} s */ (s) => s.id === id) || null;
+}
 /**
  * @param {import("./types.d.ts").ContextGraph} graph
  * @param {string} id
@@ -207,10 +215,29 @@ export function summarizeTask(task) {
     status: task.status,
     priority: task.priority,
     work_type: task.workType,
+    disposition: task.disposition || null,
     claimed_by: (task.claimedBy || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean),
     domain: task.resolvedDomain ? task.resolvedDomain.id : null
   };
 }
+/**
+ * @param {any} plan
+ * @returns {any}
+ */
+export function summarizePlan(plan) {
+  if (!plan) return null;
+  const steps = plan.steps || [];
+  return {
+    id: plan.id,
+    name: plan.name,
+    status: plan.status,
+    priority: plan.priority,
+    task: plan.task?.id || null,
+    step_count: steps.length,
+    incomplete_steps: steps.filter(/** @param {any} step */ (step) => step.status !== "done" && step.status !== "skipped").map(/** @param {any} step */ (step) => step.id),
+    domain: plan.resolvedDomain ? plan.resolvedDomain.id : null
+  };
+}
 /**
  * @param {any} bug
  * @returns {any}

package/src/generator/context/shared/relationships.js

@@ -436,13 +436,14 @@ export function ensureContextSelection(options = {}) {
     options.requirementId ? ["requirement", options.requirementId] : null,
     options.acceptanceId ? ["acceptance_criterion", options.acceptanceId] : null,
     options.taskId ? ["task", options.taskId] : null,
+    options.planId ? ["plan", options.planId] : null,
     options.bugId ? ["bug", options.bugId] : null,
     options.documentId ? ["document", options.documentId] : null
   ].filter(Boolean));
 
   if (selectors.length !== 1) {
     throw new Error(
-      "Context selection requires exactly one of --capability, --workflow, --projection, --widget, --entity, --journey, --surface, --domain, --pitch, --requirement, --acceptance, --task, --bug, or --document"
+      "Context selection requires exactly one of --capability, --workflow, --projection, --widget, --entity, --journey, --surface, --domain, --pitch, --requirement, --acceptance, --task, --plan, --bug, or --document"
     );
   }
 

package/src/generator/context/shared/types.d.ts

@@ -143,6 +143,7 @@ export type ContextSelectionOptions = {
   requirementId?: string | null;
   acceptanceId?: string | null;
   taskId?: string | null;
+  planId?: string | null;
   bugId?: string | null;
   documentId?: string | null;
   [key: string]: any;

package/src/generator/context/shared.d.ts

@@ -9,6 +9,7 @@ export function getJourneyDoc(...args: any[]): any;
 export function getStatement(...args: any[]): any;
 export function getWorkflowDoc(...args: any[]): any;
 export function pitchById(...args: any[]): any;
+export function planById(...args: any[]): any;
 export function relatedCapabilitiesForEntity(...args: any[]): any;
 export function relatedCapabilitiesForProjection(...args: any[]): any;
 export function relatedEntitiesForDomain(...args: any[]): any;
@@ -34,6 +35,7 @@ export function summarizeDocsByIds(...args: any[]): any;
 export function summarizeDocument(...args: any[]): any;
 export function summarizeDomain(...args: any[]): any;
 export function summarizePitch(...args: any[]): any;
+export function summarizePlan(...args: any[]): any;
 export function summarizeProjection(...args: any[]): any;
 export function summarizeRequirement(...args: any[]): any;
 export function summarizeStatementsByIds(...args: any[]): any;

package/src/generator/context/shared.js

@@ -55,12 +55,14 @@ export {
   requirementById,
   acceptanceCriterionById,
   taskById,
+  planById,
   bugById,
   documentById,
   summarizePitch,
   summarizeRequirement,
   summarizeAcceptanceCriterion,
   summarizeTask,
+  summarizePlan,
   summarizeBug,
   summarizeDocument,
   getWorkflowDoc,

package/src/generator/context/slice/core.js

@@ -40,6 +40,7 @@ import {
   domainSlice,
   journeySlice,
   pitchSlice,
+  planSlice,
   requirementSlice,
   taskSlice
 } from "./sdlc.js";
@@ -375,6 +376,7 @@ export function generateContextSlice(graph, options = {}) {
     requirementId: options.requirementId,
     acceptanceId: options.acceptanceId,
     taskId: options.taskId,
+    planId: options.planId,
     bugId: options.bugId,
     documentId: options.documentId
   });
@@ -390,6 +392,7 @@ export function generateContextSlice(graph, options = {}) {
   if (selection.kind === "requirement") return requirementSlice(graph, selection.id);
   if (selection.kind === "acceptance_criterion") return acceptanceCriterionSlice(graph, selection.id);
   if (selection.kind === "task") return taskSlice(graph, selection.id);
+  if (selection.kind === "plan") return planSlice(graph, selection.id);
   if (selection.kind === "bug") return bugSlice(graph, selection.id);
   if (selection.kind === "document") return documentSlice(graph, selection.id);
 

package/src/generator/context/slice/sdlc.js

@@ -8,6 +8,7 @@ import {
   domainById,
   getJourneyDoc,
   pitchById,
+  planById,
   recommendedVerificationTargets,
   relatedEntitiesForDomain,
   relatedProjectionsForDomain,
@@ -21,6 +22,7 @@ import {
   summarizeDocument,
   summarizeDomain,
   summarizePitch,
+  summarizePlan,
   summarizeRequirement,
   summarizeStatementsByIds,
   summarizeTask,
@@ -297,10 +299,12 @@ export function taskSlice(graph, taskId) {
 
   const satisfies = (task.satisfies || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort();
   const acRefs = (task.acceptanceRefs || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort();
+  const verificationRefs = (task.verificationRefs || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort();
   const blockedBy = (task.blockedBy || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort();
   const blocks = (task.blocks || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort();
   const affects = (task.affects || []).map(/** @param {any} a */ (a) => (typeof a === "string" ? a : a?.id)).filter(Boolean).sort();
-  const verifications = verificationIdsForTarget(graph, [taskId, ...affects, ...acRefs]);
+  const plans = (task.plans || []).slice().sort();
+  const verifications = [...new Set([...verificationRefs, ...verificationIdsForTarget(graph, [taskId, ...affects, ...acRefs])])].sort();
 
   return {
     type: "context_slice",
@@ -310,15 +314,19 @@ export function taskSlice(graph, taskId) {
     depends_on: {
       satisfies,
       acceptance_refs: acRefs,
+      verification_refs: verificationRefs,
       blocked_by: blockedBy,
       blocks,
+      plans,
       affects,
       verifications
     },
     related: {
       satisfies: summarizeStatementsByIds(graph, satisfies),
       acceptance_refs: summarizeStatementsByIds(graph, acRefs),
+      verification_refs: summarizeStatementsByIds(graph, verificationRefs),
       blocked_by: summarizeStatementsByIds(graph, blockedBy),
+      plans: summarizeStatementsByIds(graph, plans),
       affects: summarizeStatementsByIds(graph, affects)
     },
     verification: summarizeStatementsByIds(graph, verifications),
@@ -331,6 +339,54 @@ export function taskSlice(graph, taskId) {
   };
 }
 
+/**
+ * @param {import("../shared/types.d.ts").ContextGraph} graph
+ * @param {string} planId
+ * @returns {any}
+ */
+export function planSlice(graph, planId) {
+  const plan = planById(graph, planId);
+  if (!plan) throw new Error(`No plan found with id '${planId}'`);
+
+  const taskId = plan.task?.id || null;
+  const task = taskId ? taskById(graph, taskId) : null;
+  const satisfies = task ? (task.satisfies || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort() : [];
+  const acRefs = task ? (task.acceptanceRefs || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort() : [];
+  const verificationRefs = task ? (task.verificationRefs || []).map(/** @param {any} r */ (r) => (typeof r === "string" ? r : r?.id)).filter(Boolean).sort() : [];
+  const affects = task ? (task.affects || []).map(/** @param {any} a */ (a) => (typeof a === "string" ? a : a?.id)).filter(Boolean).sort() : [];
+  const verifications = [...new Set([...verificationRefs, ...verificationIdsForTarget(graph, [planId, ...(taskId ? [taskId] : []), ...affects, ...acRefs])])].sort();
+
+  return {
+    type: "context_slice",
+    version: 1,
+    focus: { kind: "plan", id: planId },
+    summary: summarizePlan(plan),
+    depends_on: {
+      task: taskId,
+      satisfies,
+      acceptance_refs: acRefs,
+      verification_refs: verificationRefs,
+      affects,
+      verifications
+    },
+    related: {
+      task: task ? [summarizeTask(task)] : [],
+      satisfies: summarizeStatementsByIds(graph, satisfies),
+      acceptance_refs: summarizeStatementsByIds(graph, acRefs),
+      verification_refs: summarizeStatementsByIds(graph, verificationRefs),
+      affects: summarizeStatementsByIds(graph, affects)
+    },
+    steps: plan.steps || [],
+    verification: summarizeStatementsByIds(graph, verifications),
+    verification_targets: recommendedVerificationTargets(graph, [planId, ...(taskId ? [taskId] : []), ...affects, ...acRefs], {
+      rationale: "Plan slice points at verification for the owning task and affected surfaces."
+    }),
+    write_scope: buildDefaultWriteScope(),
+    review_boundary: reviewBoundaryForTask(),
+    ownership_boundary: defaultOwnershipBoundary()
+  };
+}
+
 /**
  * @param {import("../shared/types.d.ts").ContextGraph} graph
  * @param {string} bugId
@@ -414,4 +470,3 @@ export function documentSlice(graph, documentId) {
     ownership_boundary: defaultOwnershipBoundary()
   };
 }
-

package/src/generator/context/task-mode.js

@@ -234,6 +234,13 @@ function selectedSurface(options = {}) {
   if (options.entityId) return { kind: "entity", id: options.entityId };
   if (options.journeyId) return { kind: "journey", id: options.journeyId };
   if (options.surfaceId) return { kind: "surface", id: options.surfaceId };
+  if (options.pitchId) return { kind: "pitch", id: options.pitchId };
+  if (options.requirementId) return { kind: "requirement", id: options.requirementId };
+  if (options.acceptanceId) return { kind: "acceptance_criterion", id: options.acceptanceId };
+  if (options.taskId) return { kind: "task", id: options.taskId };
+  if (options.planId) return { kind: "plan", id: options.planId };
+  if (options.bugId) return { kind: "bug", id: options.bugId };
+  if (options.documentId) return { kind: "document", id: options.documentId };
   return null;
 }
 

package/src/generator/sdlc/board.js

@@ -7,6 +7,7 @@
 
 import {
   summarizeBug,
+  summarizePlan,
   summarizePitch,
   summarizeRequirement,
   summarizeTask
@@ -20,6 +21,7 @@ const SUMMARIZERS = {
   pitch: summarizePitch,
   requirement: summarizeRequirement,
   task: summarizeTask,
+  plan: summarizePlan,
   bug: summarizeBug
 };
 

package/src/generator/sdlc/traceability-matrix.js

@@ -19,7 +19,11 @@ export function generateSdlcTraceabilityMatrix(graph, options = {}) {
     const pitch = pitchId ? pitchesById.get(pitchId) : null;
 
     const taskIds = (ac.tasks || []).slice().sort();
-    const verificationIds = (ac.verifications || []).slice().sort();
+    const taskVerificationIds = taskIds.flatMap((id) => {
+      const task = tasksById.get(id);
+      return (task?.verificationRefs || []).map((ref) => typeof ref === "string" ? ref : ref?.id).filter(Boolean);
+    });
+    const verificationIds = [...new Set([...(ac.verifications || []), ...taskVerificationIds])].sort();
 
     const linkedBugIds = [];
     for (const bug of bugsById.values()) {

package/src/import/core/context.js

@@ -20,7 +20,7 @@ export function findNearestGitRoot(startDir) {
 }
 
 export function normalizeWorkspacePaths(inputPath) {
-  const context = resolveWorkspaceContext(inputPath);
+  const context = resolveWorkspaceContext(inputPath, { ignoreAncestorConfig: true });
   const absolute = path.resolve(inputPath);
   const topogramRoot = context.topoRoot;
   const workspaceRoot = context.projectRoot;

package/src/import/core/contracts.js

@@ -1,17 +1,17 @@
-export const IMPORT_TRACKS = new Set(["db", "api", "ui", "workflows", "verification"]);
+export const IMPORT_TRACKS = new Set(["db", "api", "ui", "cli", "workflows", "verification"]);
 
 /**
  * @typedef {{score:number, reasons:string[]}} DetectionResult
  * @typedef {{findings:any[], candidates:any}} ExtractResult
  * @typedef {{
  *   id:string,
- *   track:"db"|"api"|"ui"|"workflows"|"verification",
+ *   track:"db"|"api"|"ui"|"cli"|"workflows"|"verification",
  *   detect:(context:any)=>DetectionResult,
  *   extract:(context:any)=>ExtractResult
  * }} ImportExtractor
  * @typedef {{
  *   id:string,
- *   track:"db"|"api"|"ui"|"workflows"|"verification"|"docs",
+ *   track:"db"|"api"|"ui"|"cli"|"workflows"|"verification"|"docs",
  *   applies:(context:any, candidates:any)=>boolean|number,
  *   enrich:(context:any, candidates:any)=>any
  * }} ImportEnricher