@topogram/cli 0.3.78 → 0.3.79

package/src/cli/commands/import/plan.js

@@ -76,7 +76,7 @@ export function readImportAdoptionArtifacts(inputPath) {
     reconcileReport: path.join(reconcileRoot, "report.json")
   };
   if (!fs.existsSync(paths.adoptionPlanAgent)) {
-    throw new Error(`No import adoption plan found under '${reconcileRoot}'. Run 'topogram import <app-path> --out <target>' first.`);
+    throw new Error(`No extraction adoption plan found under '${reconcileRoot}'. Run 'topogram extract <app-path> --out <target>' first.`);
   }
   return {
     projectRoot,
@@ -182,10 +182,10 @@ export function summarizeImportAdoption(adoptionPlan, adoptionStatus, projectRoo
     risks: [
       ...(blockedCount > 0 ? [`${blockedCount} adoption item(s) are blocked.`] : []),
       ...(((adoptionPlan.requires_human_review || []).length || surfaces.some((/** @type {AnyRecord} */ item) => item.human_review_required))
-        ? ["Imported proposal items require human review before adoption."]
+        ? ["Extracted proposal items require human review before adoption."]
         : [])
     ],
-    nextCommand: nextBundle ? nextBundle.nextCommand : `topogram import status ${importProjectCommandPath(projectRoot)}`
+    nextCommand: nextBundle ? nextBundle.nextCommand : `topogram extract status ${importProjectCommandPath(projectRoot)}`
   };
 }
 
@@ -209,8 +209,8 @@ export function buildBrownfieldImportPlanPayload(inputPath) {
     },
     ...adoption,
     commands: {
-      check: `topogram import check ${importProjectCommandPath(artifacts.projectRoot)}`,
-      status: `topogram import status ${importProjectCommandPath(artifacts.projectRoot)}`,
+      check: `topogram extract check ${importProjectCommandPath(artifacts.projectRoot)}`,
+      status: `topogram extract status ${importProjectCommandPath(artifacts.projectRoot)}`,
       next: adoption.nextCommand
     }
   };
@@ -221,7 +221,7 @@ export function buildBrownfieldImportPlanPayload(inputPath) {
  * @returns {void}
  */
 export function printBrownfieldImportPlan(payload) {
-  console.log(`Import adoption plan for ${payload.projectRoot}`);
+  console.log(`Extraction adoption plan for ${payload.projectRoot}`);
   console.log(`Proposal items: ${payload.summary.proposalItemCount}`);
   console.log(`Bundles: ${payload.summary.bundleCount}`);
   for (const bundle of payload.bundles) {
@@ -279,9 +279,9 @@ export function buildBrownfieldImportAdoptListPayload(inputPath) {
  * @returns {void}
  */
 export function printBrownfieldImportAdoptList(payload) {
-  console.log(`Import adoption selectors for ${payload.projectRoot}`);
+  console.log(`Adoption selectors for ${payload.projectRoot}`);
   if (payload.selectors.length === 0) {
-    console.log("No adoption selectors are available. Run `topogram import plan` to inspect reconcile artifacts.");
+    console.log("No adoption selectors are available. Run `topogram extract plan` to inspect reconcile artifacts.");
     return;
   }
   for (const selector of payload.selectors) {

package/src/cli/commands/import/refresh.js

@@ -34,12 +34,12 @@ import { verifyImportAdoptionReceipts } from "./status-history.js";
 export function readTopogramImportRecord(projectRoot) {
   const importPath = path.join(normalizeProjectRoot(projectRoot), TOPOGRAM_IMPORT_FILE);
   if (!fs.existsSync(importPath)) {
-    throw new Error(`No brownfield import provenance found at '${importPath}'. Run 'topogram import <app-path> --out <target>' first.`);
+    throw new Error(`No brownfield extraction provenance found at '${importPath}'. Run 'topogram extract <app-path> --out <target>' first.`);
   }
   try {
     return { path: importPath, record: JSON.parse(fs.readFileSync(importPath, "utf8")) };
   } catch (error) {
-    throw new Error(`Invalid brownfield import provenance JSON at '${importPath}'.`);
+    throw new Error(`Invalid brownfield extraction provenance JSON at '${importPath}'.`);
   }
 }
 
@@ -48,8 +48,9 @@ export function readTopogramImportRecord(projectRoot) {
  * @returns {string|null}
  */
 export function importTrackValueFromRecord(importRecord) {
-  const tracks = Array.isArray(importRecord.import?.tracks)
-    ? importRecord.import.tracks.map((/** @type {any} */ track) => String(track).trim()).filter(Boolean)
+  const source = importRecord.extract || importRecord.import || {};
+  const tracks = Array.isArray(source.tracks)
+    ? source.tracks.map((/** @type {any} */ track) => String(track).trim()).filter(Boolean)
     : [];
   return tracks.length ? [...new Set(tracks)].join(",") : null;
 }
@@ -283,7 +284,7 @@ export function buildBrownfieldImportRefreshAnalysis(inputPath, options = {}) {
   const projectRoot = normalizeProjectRoot(inputPath);
   const topogramRoot = normalizeTopogramPath(projectRoot);
   if (!fs.existsSync(topogramRoot) || !fs.statSync(topogramRoot).isDirectory()) {
-    throw new Error(`No workspace folder found for imported workspace '${inputPath}'.`);
+    throw new Error(`No workspace folder found for extracted workspace '${inputPath}'.`);
   }
 
   const { record: importRecord } = readTopogramImportRecord(projectRoot);
@@ -291,21 +292,21 @@ export function buildBrownfieldImportRefreshAnalysis(inputPath, options = {}) {
     ? options.sourcePath
     : importRecord.source?.path;
   if (!sourcePath) {
-    throw new Error("No brownfield source path was provided or recorded. Use 'topogram import refresh <workspace> --from <app-path>'.");
+    throw new Error("No brownfield source path was provided or recorded. Use 'topogram extract refresh <workspace> --from <app-path>'.");
   }
   const sourceRoot = path.resolve(sourcePath);
   if (!fs.existsSync(sourceRoot) || !fs.statSync(sourceRoot).isDirectory()) {
     throw new Error(`Cannot refresh from missing app directory '${sourcePath}'.`);
   }
   if (sourceRoot === projectRoot) {
-    throw new Error("Refusing to refresh import from the imported Topogram workspace itself.");
+    throw new Error("Refusing to refresh extraction from the extracted Topogram workspace itself.");
   }
 
   const sourceComparison = compareImportRecordToSource(projectRoot, importRecord, sourceRoot);
   const trackValue = importTrackValueFromRecord(importRecord);
   const importResult = runWorkflow("import-app", sourceRoot, { from: trackValue });
   const candidateCounts = importCandidateCounts(importResult.summary);
-  const candidateCountDeltas = buildCountDeltas(importRecord.import?.candidateCounts || {}, candidateCounts);
+  const candidateCountDeltas = buildCountDeltas((importRecord.extract || importRecord.import)?.candidateCounts || {}, candidateCounts);
   const removedCandidateFiles = {
     rawCandidateFiles: countFilesRecursive(path.join(topogramRoot, "candidates", "app")),
     reconcileFiles: countFilesRecursive(path.join(topogramRoot, "candidates", "reconcile"))
@@ -324,7 +325,7 @@ export function buildBrownfieldImportRefreshAnalysis(inputPath, options = {}) {
     topogramRoot,
     sourcePath: sourceRoot,
     provenancePath: path.join(projectRoot, TOPOGRAM_IMPORT_FILE),
-    importedAt: importRecord.importedAt || null,
+    importedAt: importRecord.extractedAt || importRecord.importedAt || null,
     previousImportStatus: sourceComparison.status,
     sourceDiff: {
       status: sourceComparison.status,
@@ -354,13 +355,13 @@ export function buildBrownfieldImportRefreshAnalysis(inputPath, options = {}) {
 /**
  * @param {string} inputPath
  * @param {{ sourcePath?: string|null, dryRun?: boolean }} [options]
- * @returns {{ ok: boolean, dryRun: boolean, projectRoot: string, workspaceRoot: string, topogramRoot: string, sourcePath: string, provenancePath: string, previousImportStatus: string, currentImportStatus: string, tracks: string[], sourceFiles: number, sourceDiff: Record<string, any>, removedCandidateFiles: Record<string, number>, rawCandidateFiles: number, reconcileFiles: number, writtenFiles: string[], plannedFiles: string[], candidateCounts: Record<string, number>, candidateCountDeltas: Record<string, any>, adoptionPlanDeltas: Record<string, any>, receiptVerification: Record<string, any>, refreshMetadata: Record<string, any>|null, nextCommands: string[] }}
+ * @returns {{ ok: boolean, dryRun: boolean, projectRoot: string, workspaceRoot: string, topogramRoot: string, sourcePath: string, provenancePath: string, previousExtractStatus: string, currentExtractStatus: string, tracks: string[], sourceFiles: number, sourceDiff: Record<string, any>, removedCandidateFiles: Record<string, number>, rawCandidateFiles: number, reconcileFiles: number, writtenFiles: string[], plannedFiles: string[], candidateCounts: Record<string, number>, candidateCountDeltas: Record<string, any>, adoptionPlanDeltas: Record<string, any>, receiptVerification: Record<string, any>, refreshMetadata: Record<string, any>|null, nextCommands: string[] }}
  */
 export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
   const analysis = buildBrownfieldImportRefreshAnalysis(inputPath, options);
   const dryRun = Boolean(options.dryRun);
   let provenancePath = analysis.provenancePath;
-  let currentImportStatus = dryRun ? analysis.previousImportStatus : "unknown";
+  let currentExtractStatus = dryRun ? analysis.previousImportStatus : "unknown";
   /** @type {string[]} */
   let writtenFiles = [];
   /** @type {AnyRecord|null} */
@@ -391,7 +392,7 @@ export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
       files: collectImportSourceFileRecords(analysis.sourcePath, { excludeRoots: [analysis.projectRoot] })
     });
     provenancePath = provenance.path;
-    currentImportStatus = buildTopogramImportStatus(analysis.projectRoot).status;
+    currentExtractStatus = buildTopogramImportStatus(analysis.projectRoot).status;
     writtenFiles = [
       TOPOGRAM_IMPORT_FILE,
       ...rawCandidateFiles.map((filePath) => `${DEFAULT_TOPO_FOLDER_NAME}/${filePath}`),
@@ -402,15 +403,15 @@ export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
     analysis.reconcileFiles = reconcileFiles.length;
   }
   return {
-    ok: dryRun || currentImportStatus === "clean",
+    ok: dryRun || currentExtractStatus === "clean",
     dryRun,
     projectRoot: analysis.projectRoot,
     workspaceRoot: analysis.topogramRoot,
     topogramRoot: analysis.topogramRoot,
     sourcePath: analysis.sourcePath,
     provenancePath,
-    previousImportStatus: analysis.previousImportStatus,
-    currentImportStatus,
+    previousExtractStatus: analysis.previousImportStatus,
+    currentExtractStatus,
     tracks: analysis.tracks,
     sourceFiles: analysis.sourceFiles,
     sourceDiff: analysis.sourceDiff,
@@ -426,11 +427,11 @@ export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
     refreshMetadata,
     nextCommands: [
       dryRun
-        ? `topogram import refresh ${importProjectCommandPath(analysis.projectRoot)}`
-        : `topogram import check ${importProjectCommandPath(analysis.projectRoot)}`,
-      `topogram import plan ${importProjectCommandPath(analysis.projectRoot)}`,
-      `topogram import status ${importProjectCommandPath(analysis.projectRoot)}`,
-      `topogram import history ${importProjectCommandPath(analysis.projectRoot)} --verify`
+        ? `topogram extract refresh ${importProjectCommandPath(analysis.projectRoot)}`
+        : `topogram extract check ${importProjectCommandPath(analysis.projectRoot)}`,
+      `topogram extract plan ${importProjectCommandPath(analysis.projectRoot)}`,
+      `topogram extract status ${importProjectCommandPath(analysis.projectRoot)}`,
+      `topogram extract history ${importProjectCommandPath(analysis.projectRoot)} --verify`
     ]
   };
 }
@@ -440,12 +441,12 @@ export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
  * @returns {void}
  */
 export function printBrownfieldImportRefresh(payload) {
-  console.log(`${payload.dryRun ? "Previewed" : "Refreshed"} brownfield import candidates for ${payload.projectRoot}.`);
+  console.log(`${payload.dryRun ? "Previewed" : "Refreshed"} brownfield extraction candidates for ${payload.projectRoot}.`);
   console.log(`Source: ${payload.sourcePath}`);
   console.log(`Topogram: ${payload.topogramRoot}`);
-  console.log(`Import provenance: ${payload.provenancePath}`);
-  console.log(`Previous source status: ${payload.previousImportStatus}`);
-  console.log(`Current source status: ${payload.currentImportStatus}`);
+  console.log(`Extraction provenance: ${payload.provenancePath}`);
+  console.log(`Previous source status: ${payload.previousExtractStatus}`);
+  console.log(`Current source status: ${payload.currentExtractStatus}`);
   console.log(`Source diff: changed=${payload.sourceDiff.counts.changed}, added=${payload.sourceDiff.counts.added}, removed=${payload.sourceDiff.counts.removed}`);
   console.log(`Tracked source files: ${payload.sourceFiles}`);
   console.log(`Raw candidate files: ${payload.rawCandidateFiles}`);

package/src/cli/commands/import/status-history.js

@@ -33,7 +33,7 @@ export function buildBrownfieldImportStatusPayload(inputPath) {
     projectRoot: artifacts.projectRoot,
     workspaceRoot: artifacts.topogramRoot,
     topogramRoot: artifacts.topogramRoot,
-    import: importCheck.import,
+    extract: importCheck.extract,
     topogram: importCheck.topogram,
     adoption: {
       status: adoptionStatus,
@@ -52,7 +52,7 @@ export function buildBrownfieldImportStatusPayload(inputPath) {
  * @returns {void}
  */
 export function printBrownfieldImportStatus(payload) {
-  console.log(`Import status: ${payload.import.status}`);
+  console.log(`Extraction status: ${payload.extract.status}`);
   console.log(`Topogram check: ${payload.topogram.ok ? "passed" : "failed"}`);
   console.log(`Adoption: ${payload.adoption.summary.appliedItemCount} applied, ${payload.adoption.summary.pendingItemCount} pending, ${payload.adoption.summary.blockedItemCount} blocked`);
   const next = payload.adoption.nextCommand;
@@ -134,7 +134,7 @@ export function verifyImportAdoptionReceipts(projectRoot, receipts) {
     summary,
     files,
     auditOnly: true,
-    note: "History verification is audit-only. Imported/adopted Topogram files are project-owned, and edits do not make the workspace invalid."
+    note: "History verification is audit-only. Extracted/adopted Topogram files are project-owned, and edits do not make the workspace invalid."
   };
 }
 
@@ -175,7 +175,7 @@ export function buildBrownfieldImportHistoryPayload(inputPath, options = {}) {
  * @returns {void}
  */
 export function printBrownfieldImportHistory(payload) {
-  console.log(`Import adoption history for ${payload.projectRoot}`);
+  console.log(`Adoption history for ${payload.projectRoot}`);
   console.log(`Receipts: ${payload.summary.receiptCount}`);
   console.log(`Forced writes: ${payload.summary.forcedWriteCount}`);
   if (!payload.exists) {

package/src/cli/commands/import/workspace.js

@@ -79,23 +79,23 @@ function importedProjectConfig() {
  */
 function importedWorkspaceReadme(sourceRoot, targetRoot, importSummary) {
   return [
-    "# Imported Topogram Workspace",
+    "# Extracted Topogram Workspace",
     "",
-    "This workspace was created from a brownfield app import.",
+    "This workspace was created from a brownfield app extraction.",
     "",
-    `- Imported source: \`${sourceRoot}\``,
+    `- Extracted source: \`${sourceRoot}\``,
     `- Target workspace: \`${targetRoot}\``,
     `- Tracks: ${(importSummary.tracks || []).join(", ") || "none"}`,
     `- Provenance: \`${TOPOGRAM_IMPORT_FILE}\``,
     "",
-    "Imported Topogram artifacts are project-owned after creation. Edit them directly, promote candidates deliberately, and run `topogram check` before generation or maintained-app work.",
+    "Extracted Topogram artifacts are project-owned after creation. Edit them directly, promote candidates deliberately, and run `topogram check` before generation or maintained-app work.",
     "",
     "Useful commands:",
     "",
     "```sh",
-    "topogram import check",
+    "topogram extract check",
     "topogram check",
-    `topogram query import-plan ./${DEFAULT_TOPO_FOLDER_NAME}`,
+    `topogram query extract-plan ./${DEFAULT_TOPO_FOLDER_NAME}`,
     "```",
     ""
   ].join("\n");
@@ -156,10 +156,10 @@ export function buildBrownfieldImportWorkspacePayload(sourcePath, targetPath, op
   const sourceRoot = path.resolve(sourcePath);
   const targetRoot = path.resolve(targetPath);
   if (!fs.existsSync(sourceRoot) || !fs.statSync(sourceRoot).isDirectory()) {
-    throw new Error(`Cannot import missing app directory '${sourcePath}'.`);
+    throw new Error(`Cannot extract missing app directory '${sourcePath}'.`);
   }
   if (sourceRoot === targetRoot) {
-    throw new Error("Refusing to import into the same directory as the brownfield app.");
+    throw new Error("Refusing to extract into the same directory as the brownfield app.");
   }
   ensureEmptyImportTarget(targetRoot);
 
@@ -206,12 +206,12 @@ export function buildBrownfieldImportWorkspacePayload(sourcePath, targetPath, op
     writtenFiles,
     candidateCounts,
     nextCommands: [
-      "topogram import check",
-      "topogram import plan",
-      "topogram import adopt bundle:task --dry-run",
-      "topogram import status",
+      "topogram extract check",
+      "topogram extract plan",
+      "topogram adopt bundle:task --dry-run",
+      "topogram extract status",
       "topogram check",
-      `topogram query import-plan ./${DEFAULT_TOPO_FOLDER_NAME}`
+      `topogram query extract-plan ./${DEFAULT_TOPO_FOLDER_NAME}`
     ]
   };
 }
@@ -221,15 +221,15 @@ export function buildBrownfieldImportWorkspacePayload(sourcePath, targetPath, op
  * @returns {void}
  */
 export function printBrownfieldImportWorkspace(payload) {
-  console.log(`Imported brownfield app to ${payload.targetPath}.`);
+  console.log(`Extracted brownfield app to ${payload.targetPath}.`);
   console.log(`Source: ${payload.sourcePath}`);
   console.log(`Topogram: ${payload.topogramRoot}`);
   console.log(`Project config: ${payload.projectConfigPath}`);
-  console.log(`Import provenance: ${payload.provenancePath}`);
+  console.log(`Extraction provenance: ${payload.provenancePath}`);
   console.log(`Tracked source files: ${payload.sourceFiles}`);
   console.log(`Raw candidate files: ${payload.rawCandidateFiles}`);
   console.log(`Reconcile proposal files: ${payload.reconcileFiles}`);
-  console.log("Imported Topogram artifacts are project-owned after creation; source hashes record the app evidence trusted at import time.");
+  console.log("Extracted Topogram artifacts are project-owned after creation; source hashes record the app evidence trusted at extraction time.");
   console.log("");
   console.log("Next steps:");
   console.log(`  cd ${shellCommandArg(path.relative(process.cwd(), payload.targetPath) || ".")}`);

package/src/cli/commands/import-runner.js

@@ -11,6 +11,7 @@ import {
   buildBrownfieldImportRefreshPayload,
   buildBrownfieldImportStatusPayload,
   buildBrownfieldImportWorkspacePayload,
+  printAdoptHelp,
   printBrownfieldImportAdopt,
   printBrownfieldImportAdoptList,
   printBrownfieldImportCheck,
@@ -20,7 +21,7 @@ import {
   printBrownfieldImportRefresh,
   printBrownfieldImportStatus,
   printBrownfieldImportWorkspace,
-  printImportHelp
+  printExtractHelp
 } from "./import.js";
 
 /**
@@ -45,7 +46,7 @@ export function runImportCommand(context) {
   if (command === "workspace") {
     if (!outPath) {
       console.error("Missing required --out <target>.");
-      printImportHelp();
+      printExtractHelp();
       return 1;
     }
     const payload = buildBrownfieldImportWorkspacePayload(inputPath || "", outPath, { from: fromValue });
@@ -110,12 +111,12 @@ export function runImportCommand(context) {
   if (command === "adopt") {
     if (!commandArgs.importAdoptSelector || commandArgs.importAdoptSelector.startsWith("-")) {
       console.error("Missing required <selector>.");
-      printImportHelp();
+      printAdoptHelp();
       return 1;
     }
     if (write && dryRun) {
       console.error("Use either --dry-run or --write, not both.");
-      printImportHelp();
+      printAdoptHelp();
       return 1;
     }
     const payload = buildBrownfieldImportAdoptPayload(commandArgs.importAdoptSelector, inputPath || ".", {
@@ -153,5 +154,5 @@ export function runImportCommand(context) {
     return payload.ok ? 0 : 1;
   }
 
-  throw new Error(`Unknown import command '${command}'`);
+  throw new Error(`Unknown extract/adopt command '${command}'`);
 }

package/src/cli/commands/import.js

@@ -1,6 +1,9 @@
 // @ts-check
 
-export { printImportHelp } from "./import/help.js";
+export {
+  printAdoptHelp,
+  printExtractHelp
+} from "./import/help.js";
 export {
   buildBrownfieldImportWorkspacePayload,
   printBrownfieldImportWorkspace

package/src/cli/commands/init.js

@@ -0,0 +1,67 @@
+// @ts-check
+
+import path from "node:path";
+
+import { stableStringify } from "../../format.js";
+import { initTopogramProject } from "../../init-project.js";
+
+/**
+ * @param {string} projectRoot
+ * @param {string} cwd
+ * @returns {string}
+ */
+function displayProjectRoot(projectRoot, cwd) {
+  const relative = path.relative(cwd, projectRoot);
+  return !relative || relative.startsWith("..")
+    ? projectRoot
+    : relative.split(path.sep).join("/");
+}
+
+/**
+ * @param {ReturnType<typeof initTopogramProject>} result
+ * @param {string} cwd
+ * @returns {void}
+ */
+export function printInitProjectResult(result, cwd) {
+  console.log(`Initialized Topogram workspace at ${result.projectRoot}.`);
+  console.log("Workspace: topo/");
+  console.log("Project config: topogram.project.json");
+  console.log("Output ownership: maintained (.)");
+  console.log("Template: none");
+  console.log("Generated app output: none");
+  console.log(`SDLC: ${result.sdlc.enabled ? "adopted/enforced" : "not adopted"}`);
+  if (result.created.length > 0) {
+    console.log(`Created: ${result.created.join(", ")}`);
+  }
+  if (result.skipped.length > 0) {
+    console.log(`Skipped existing files: ${result.skipped.join(", ")}`);
+  }
+  console.log("");
+  console.log("Next steps:");
+  console.log(`  cd ${displayProjectRoot(result.projectRoot, cwd)}`);
+  console.log("  topogram agent brief --json");
+  console.log("  topogram check --json");
+  console.log("  topogram query list --json");
+  if (result.sdlc.enabled) {
+    console.log("  topogram sdlc policy explain --json");
+    console.log("  topogram sdlc prep commit . --json");
+  } else {
+    console.log("  topogram sdlc policy init .");
+  }
+  console.log("  topogram emit <target> ./topo --json");
+}
+
+/**
+ * @param {string} inputPath
+ * @param {{ json?: boolean, cwd?: string, withSdlc?: boolean }} [options]
+ * @returns {number}
+ */
+export function runInitProjectCommand(inputPath, options = {}) {
+  const result = initTopogramProject({ targetPath: inputPath || ".", withSdlc: Boolean(options.withSdlc) });
+  if (options.json) {
+    console.log(stableStringify(result));
+  } else {
+    printInitProjectResult(result, options.cwd || process.cwd());
+  }
+  return 0;
+}

package/src/cli/commands/query/{import-adopt.js → extract-adopt.js}

@@ -38,7 +38,7 @@ export function buildImportPlanForContext(context, queryFamily) {
   }
   const adoptionPlan = readJson(planPath);
   const ast = parsePath(context.inputPath);
-  const taskModeResult = buildTaskMode(ast, {}, "import-adopt");
+  const taskModeResult = buildTaskMode(ast, {}, "extract-adopt");
   if (!resultOk(taskModeResult)) {
     return taskModeResult;
   }
@@ -74,7 +74,7 @@ export function buildImportAdoptAgentContext(context, queryFamily) {
   const topogramRoot = normalizeTopogramPath(context.inputPath);
   const artifacts = requireReconcileArtifacts(topogramRoot, queryFamily);
   const ast = parsePath(context.inputPath);
-  const taskModeResult = buildTaskMode(ast, {}, "import-adopt");
+  const taskModeResult = buildTaskMode(ast, {}, "extract-adopt");
   if (!resultOk(taskModeResult)) {
     return taskModeResult;
   }

package/src/cli/commands/query/runner/change.js

@@ -14,7 +14,7 @@ import {
 } from "../../../../agent-ops/query-builders.js";
 import { parsePath } from "../../../../parser.js";
 import { buildChangePlanContext } from "../change-plan.js";
-import { buildImportPlanForContext } from "../import-adopt.js";
+import { buildImportPlanForContext } from "../extract-adopt.js";
 import {
   adoptionPlanPath,
   buildTaskMode,
@@ -57,7 +57,7 @@ export function runChangeQuery(context) {
         maintainedRisk: built.importPlan.maintained_risk || null
       });
       return printJson(buildRiskSummaryPayload({
-        source: "import-plan",
+        source: "extract-plan",
         risk,
         nextAction: built.importPlan.next_action || null,
         maintainedRisk: built.importPlan.maintained_risk || null

package/src/cli/commands/query/runner/{import-adopt.js → extract-adopt.js}

@@ -10,7 +10,7 @@ import {
   buildLaneStatusPayload,
   buildWorkPacketPayload
 } from "../../../../agent-ops/query-builders.js";
-import { buildImportAdoptAgentContext, buildImportPlanForContext } from "../import-adopt.js";
+import { buildImportAdoptAgentContext, buildImportPlanForContext } from "../extract-adopt.js";
 import { normalizeTopogramPath, printValidationFailure, readJson, resultOk } from "../workspace.js";
 import { printJson } from "./output.js";
 
@@ -25,15 +25,15 @@ import { printJson } from "./output.js";
 export function runImportAdoptQuery(context) {
   const queryName = context.commandArgs?.queryName;
 
-  if (queryName === "import-plan") {
-    const built = buildImportPlanForContext(context, "import-plan");
+  if (queryName === "extract-plan") {
+    const built = buildImportPlanForContext(context, "extract-plan");
     if (!resultOk(built)) return printValidationFailure(built);
     return printJson(built.importPlan);
   }
 
   if (queryName === "multi-agent-plan") {
-    if (context.modeId !== "import-adopt") {
-      throw new Error("query multi-agent-plan currently supports only --mode import-adopt.");
+    if (context.modeId !== "extract-adopt") {
+      throw new Error("query multi-agent-plan currently supports only --mode extract-adopt.");
     }
     const built = buildImportAdoptAgentContext(context, "multi-agent-plan");
     if (!resultOk(built)) return printValidationFailure(built);
@@ -41,8 +41,8 @@ export function runImportAdoptQuery(context) {
   }
 
   if (queryName === "work-packet") {
-    if (context.modeId !== "import-adopt") {
-      throw new Error("query work-packet currently supports only --mode import-adopt.");
+    if (context.modeId !== "extract-adopt") {
+      throw new Error("query work-packet currently supports only --mode extract-adopt.");
     }
     if (!context.laneId) {
       throw new Error("query work-packet requires --lane <id>.");
@@ -57,8 +57,8 @@ export function runImportAdoptQuery(context) {
   }
 
   if (queryName === "lane-status" || queryName === "handoff-status") {
-    if (context.modeId !== "import-adopt") {
-      throw new Error(`query ${queryName} currently supports only --mode import-adopt.`);
+    if (context.modeId !== "extract-adopt") {
+      throw new Error(`query ${queryName} currently supports only --mode extract-adopt.`);
     }
     const built = buildImportAdoptAgentContext(context, queryName);
     if (!resultOk(built)) return printValidationFailure(built);

package/src/cli/commands/query/runner/index.js

@@ -3,7 +3,7 @@
 import { runArtifactQuery } from "./artifacts.js";
 import { runBoundaryQuery } from "./boundaries.js";
 import { runChangeQuery } from "./change.js";
-import { runImportAdoptQuery } from "./import-adopt.js";
+import { runImportAdoptQuery } from "./extract-adopt.js";
 import { runWorkflowQuery } from "./workflow.js";
 
 /**

package/src/cli/commands/query/runner/workflow.js

@@ -46,7 +46,7 @@ export function runWorkflowQuery(context) {
   const selectors = selectorOptions(context);
 
   if (queryName === "next-action") {
-    const result = buildTaskMode(parsePath(context.inputPath), selectors, context.modeId || "import-adopt", context.fromTopogramPath);
+    const result = buildTaskMode(parsePath(context.inputPath), selectors, context.modeId || "extract-adopt", context.fromTopogramPath);
     if (!resultOk(result)) return printValidationFailure(result);
     return printJson({
       type: "next_action_query",
@@ -72,13 +72,13 @@ export function runWorkflowQuery(context) {
 
   if (queryName === "workflow-preset-activation") {
     if (!context.modeId) {
-      throw new Error("query workflow-preset-activation requires --mode <modeling|maintained-app-edit|import-adopt|diff-review|verification>.");
+      throw new Error("query workflow-preset-activation requires --mode <modeling|maintained-app-edit|extract-adopt|diff-review|verification>.");
     }
     const topogramRoot = normalizeTopogramPath(context.inputPath);
     const taskModeResult = buildTaskMode(parsePath(context.inputPath), selectors, context.modeId, context.fromTopogramPath);
     if (!resultOk(taskModeResult)) return printValidationFailure(taskModeResult);
     let importPlan = null;
-    if (context.modeId === "import-adopt" && fs.existsSync(adoptionPlanPath(topogramRoot))) {
+    if (context.modeId === "extract-adopt" && fs.existsSync(adoptionPlanPath(topogramRoot))) {
       const workflowPresets = buildWorkflowPresetState({
         workspace: topogramRoot,
         selectors: workflowPresetSelectors(taskModeResult.artifact, context.providerId, context.presetId, "workflow-preset-activation")
@@ -118,7 +118,7 @@ export function runWorkflowQuery(context) {
  */
 function runSingleAgentPlan(context, selectors) {
   if (!context.modeId) {
-    throw new Error("query single-agent-plan requires --mode <modeling|maintained-app-edit|import-adopt|diff-review|verification>.");
+    throw new Error("query single-agent-plan requires --mode <modeling|maintained-app-edit|extract-adopt|diff-review|verification>.");
   }
   const ast = parsePath(context.inputPath);
   const result = buildTaskMode(ast, selectors, context.modeId, context.fromTopogramPath);
@@ -134,7 +134,7 @@ function runSingleAgentPlan(context, selectors) {
   });
   const topogramRoot = normalizeTopogramPath(context.inputPath);
   let importPlan = null;
-  if (context.modeId === "import-adopt" && fs.existsSync(adoptionPlanPath(topogramRoot))) {
+  if (context.modeId === "extract-adopt" && fs.existsSync(adoptionPlanPath(topogramRoot))) {
     const workflowPresets = buildWorkflowPresetState({
       workspace: topogramRoot,
       selectors: workflowPresetSelectors(result.artifact, context.providerId, context.presetId, "single-agent-plan")
@@ -163,7 +163,7 @@ function runSingleAgentPlan(context, selectors) {
  */
 function runResolvedWorkflowContext(context, selectors) {
   if (!context.modeId) {
-    throw new Error("query resolved-workflow-context requires --mode <modeling|maintained-app-edit|import-adopt|diff-review|verification>.");
+    throw new Error("query resolved-workflow-context requires --mode <modeling|maintained-app-edit|extract-adopt|diff-review|verification>.");
   }
   const topogramRoot = normalizeTopogramPath(context.inputPath);
   const ast = parsePath(context.inputPath);
@@ -186,7 +186,7 @@ function runResolvedWorkflowContext(context, selectors) {
     maintainedBoundaryArtifact: maintainedBundleResult?.artifact?.maintained_boundary || null
   });
   let importPlan = null;
-  if (context.modeId === "import-adopt" && fs.existsSync(adoptionPlanPath(topogramRoot))) {
+  if (context.modeId === "extract-adopt" && fs.existsSync(adoptionPlanPath(topogramRoot))) {
     const workflowPresets = buildWorkflowPresetState({
       workspace: topogramRoot,
       selectors: workflowPresetSelectors(taskModeResult.artifact, context.providerId, context.presetId, "resolved-workflow-context")

package/src/cli/commands/query/workspace.js

@@ -29,7 +29,7 @@ export function normalizeTopogramPath(inputPath) {
  */
 export function workflowPresetSelectors(taskModeArtifact, providerId = null, presetId = null, queryFamily = null) {
   const categories = [];
-  if (taskModeArtifact?.mode === "import-adopt") categories.push("provider_adoption");
+  if (taskModeArtifact?.mode === "extract-adopt") categories.push("provider_adoption");
   if (taskModeArtifact?.mode === "maintained-app-edit") categories.push("maintained_app");
   if ((taskModeArtifact?.verification_targets?.maintained_app_checks || []).length > 0) categories.push("maintained_boundary");
   return {
@@ -65,7 +65,7 @@ export function generatorTargetsForWorkflowContext(options = {}) {
  * @returns {boolean}
  */
 export function importAdoptOnlyRequested(options = {}) {
-  return options.modeId === "import-adopt" && !(
+  return options.modeId === "extract-adopt" && !(
     options.capabilityId ||
     options.workflowId ||
     options.projectionId ||
@@ -267,7 +267,7 @@ export function resolveRecommendedQueryFamily(nextAction, mode) {
     case "customize_workflow_preset":
     case "refresh_workflow_preset_customization":
     case "import_declared_workflow_preset":
-      return "import-plan";
+      return "extract-plan";
     case "review_diff_impact":
     case "inspect_projection":
     case "inspect_diff":
@@ -284,7 +284,7 @@ export function resolveRecommendedQueryFamily(nextAction, mode) {
     default:
       break;
   }
-  if (mode === "import-adopt") return "import-plan";
+  if (mode === "extract-adopt") return "extract-plan";
   if (mode === "maintained-app-edit") return "maintained-boundary";
   if (mode === "verification") return "verification-targets";
   return "change-plan";