@topogram/cli 0.3.78 → 0.3.79

package/src/cli/commands/release-status.js

@@ -290,7 +290,7 @@ export function renderReleaseStatusMarkdown(payload) {
     "The external Todo demo is the canonical end-to-end consumer proof for the current catalog-backed workflow:",
     "",
     "```bash",
-    "topogram new ./todo-demo --template todo",
+    "topogram copy todo ./todo-demo",
     "cd ./todo-demo",
     "npm install",
     "npm run check",
@@ -300,7 +300,7 @@ export function renderReleaseStatusMarkdown(payload) {
     "npm run app:runtime",
     "```",
     "",
-    "The demo CI also verifies `topogram new` from the default public catalog and from the repo-local catalog fixture. That prevents local fixtures from masking a broken published catalog alias."
+    "The demo CI also verifies `topogram copy` from the default public catalog and from the repo-local catalog fixture. That prevents local fixtures from masking a broken published catalog alias."
   );
   const reportDiagnostics = [...matrix.diagnostics];
   if (reportDiagnostics.length > 0) {

package/src/cli/commands/source.js

@@ -239,7 +239,7 @@ export function printTopogramSourceStatus(payload) {
     }
   }
   console.log("");
-  console.log(`${TOPOGRAM_SOURCE_FILE} records catalog-copy provenance only. Local edits are allowed.`);
+  console.log(`${TOPOGRAM_SOURCE_FILE} records copy provenance only. Local edits are allowed.`);
   console.log("Template attachment controls update tracking. Detaching makes the project fully owned by this workspace.");
   console.log("Template baseline drift does not block `topogram check` or `topogram generate`.");
   console.log("Implementation trust is separate and can block check/generate when review is required.");
@@ -250,7 +250,7 @@ export function printTopogramSourceStatus(payload) {
   } else if (payload.project?.templateBaseline?.state === "diverged") {
     console.log("Next: local template-derived changes are owned by this project. Run `topogram template update --check` only when reviewing upstream template changes.");
   } else if (!payload.exists) {
-    console.log("Next: use `topogram catalog copy <id> <target>` for pure topogram provenance, or continue with template/project provenance above.");
+    console.log("Next: use `topogram copy <id> <target>` for pure topogram provenance, or continue with template/project provenance above.");
   } else {
     console.log("Next: run `topogram check` or `topogram generate`.");
   }

package/src/cli/commands/template/check.js

@@ -124,7 +124,7 @@ function diagnosticForTemplateCreateFailure(message, templateSpec, step) {
       code: "template_symlink_unsupported",
       message,
       path: path.isAbsolute(templateSpec) ? templateSpec : null,
-      suggestedFix: "Replace template symlinks with real files or directories, then rerun `topogram new` or `topogram template check`.",
+      suggestedFix: "Replace template symlinks with real files or directories, then rerun `topogram copy` or `topogram template check`.",
       step
     });
   }
@@ -132,7 +132,7 @@ function diagnosticForTemplateCreateFailure(message, templateSpec, step) {
     code: "template_create_failed",
     message,
     path: path.isAbsolute(templateSpec) ? templateSpec : null,
-    suggestedFix: "Fix the template pack so topogram new can create a starter from it.",
+    suggestedFix: "Fix the template pack so topogram copy can create a starter from it.",
     step
   });
 }

package/src/cli/commands/template/list-show.js

@@ -81,7 +81,7 @@ function templateListItemFromCatalogEntry(entry, source) {
  */
 export function printTemplateList(payload) {
   console.log("Template starters:");
-  console.log("Catalog aliases resolve to versioned package installs. Local paths and full package specs can also be used with `topogram new`.");
+  console.log("Catalog aliases resolve to versioned package installs. Local paths and full package specs can also be used with `topogram copy`.");
   if (payload.catalog.source) {
     console.log(`Catalog: ${payload.catalog.source} (${payload.catalog.loaded ? "loaded" : "unavailable"})`);
   } else {
@@ -93,10 +93,10 @@ export function printTemplateList(payload) {
     const surfaces = Array.isArray(template.surfaces) && template.surfaces.length > 0
       ? template.surfaces.join(", ")
       : "not declared";
-    const command = template.recommendedCommand || `topogram new ./my-app --template ${shellCommandArg(template.id)}`;
+    const command = template.recommendedCommand || `topogram copy ${shellCommandArg(template.id)} ./my-app`;
     console.log(`- ${template.id}@${template.version}${defaultLabel}`);
     console.log(`  Source: ${template.source} | Surfaces: ${surfaces} | Stack: ${stack} | Executable implementation: ${template.includesExecutableImplementation ? "yes" : "no"}`);
-    console.log(`  New: ${command}`);
+    console.log(`  Copy: ${command}`);
   }
   for (const diagnostic of payload.diagnostics) {
     console.warn(`Warning: ${diagnostic.message}`);
@@ -137,7 +137,7 @@ function templateDecisionSummary(template, sourceKind, packageSpec, commands) {
     version: template.defaultVersion || template.version || null,
     executableImplementation: executable,
     policyImpact: executable
-      ? "Copies implementation/ code into the project; topogram new does not execute it, but topogram generate may load it after local trust is recorded."
+      ? "Copies implementation/ code into the project; topogram copy does not execute it, but topogram generate may load it after local trust is recorded."
       : "No executable implementation trust is required for this template.",
     recommendedCommand: commands.primary,
     followUp: commands.followUp,

package/src/cli/dispatcher.js

@@ -5,12 +5,13 @@ import { buildVersionPayload, printVersion } from "./commands/version.js";
 import { runAgentBriefCommand } from "./commands/agent.js";
 import { runCatalogCommand } from "./commands/catalog.js";
 import { runCheckCommand } from "./commands/check.js";
+import { runCopyCommand } from "./commands/copy.js";
 import { runEmitCommand } from "./commands/emit.js";
 import { runGenerateAppCommand } from "./commands/generate.js";
 import { runGeneratorCommand } from "./commands/generator.js";
 import { runGeneratorPolicyCommand } from "./commands/generator-policy.js";
 import { runImportCommand } from "./commands/import-runner.js";
-import { runNewProjectCommand } from "./commands/new.js";
+import { runInitProjectCommand } from "./commands/init.js";
 import { runPackageCommand } from "./commands/package.js";
 import { runParseCommand, runResolveCommand } from "./commands/inspect.js";
 import {
@@ -238,6 +239,16 @@ export async function runCliDispatch(context) {
     });
   }
 
+  if (commandArgs?.copyCommand) {
+    return runCopyCommand({
+      commandArgs,
+      catalogSource,
+      requestedVersion,
+      json: emitJson,
+      cwd: process.cwd()
+    });
+  }
+
   if (commandArgs?.packageCommand) {
     return runPackageCommand({ commandArgs, inputPath, json: emitJson });
   }
@@ -261,8 +272,12 @@ export async function runCliDispatch(context) {
     return runSourceCommand({ commandArgs, inputPath, args, json: emitJson });
   }
 
-  if (commandArgs?.newProject) {
-    return runNewProjectCommand(effectiveInputPath, { templateName, catalogSource, cwd: process.cwd() });
+  if (commandArgs?.initProject) {
+    return runInitProjectCommand(effectiveInputPath || ".", {
+      json: emitJson,
+      cwd: process.cwd(),
+      withSdlc: args.includes("--with-sdlc")
+    });
   }
 
   if (commandArgs?.templateCommand) {

package/src/cli/help-dispatch.js

@@ -16,7 +16,8 @@ import {
   printGeneratorHelp
 } from "./commands/generator.js";
 import {
-  printImportHelp
+  printAdoptHelp,
+  printExtractHelp
 } from "./commands/import.js";
 import {
   printPackageHelp
@@ -42,7 +43,8 @@ import {
 import {
   printEmitHelp,
   printGenerateHelp,
-  printNewHelp,
+  printInitHelp,
+  printCopyHelp,
   printUsage,
   printWidgetHelp
 } from "./help.js";
@@ -52,8 +54,12 @@ import {
  * @returns {boolean}
  */
 export function printCommandHelp(command) {
-  if (command === "new" || command === "create") {
-    printNewHelp();
+  if (command === "copy") {
+    printCopyHelp();
+    return true;
+  }
+  if (command === "init") {
+    printInitHelp();
     return true;
   }
   if (command === "generate") {
@@ -112,8 +118,12 @@ export function printCommandHelp(command) {
     printTrustHelp();
     return true;
   }
-  if (command === "import") {
-    printImportHelp();
+  if (command === "extract") {
+    printExtractHelp();
+    return true;
+  }
+  if (command === "adopt") {
+    printAdoptHelp();
     return true;
   }
   if (command === "check") {
@@ -170,8 +180,12 @@ export function handleUnparsedCommandHelp(args) {
     printTemplateHelp();
     return args[1] ? 1 : 0;
   }
-  if (args[0] === "import") {
-    printImportHelp();
+  if (args[0] === "extract") {
+    printExtractHelp();
+    return args[1] ? 1 : 0;
+  }
+  if (args[0] === "adopt") {
+    printAdoptHelp();
     return args[1] ? 1 : 0;
   }
   if (args[0] === "query") {

package/src/cli/help.js

@@ -35,17 +35,18 @@ export function printUsage(options = {}) {
   console.log("   or: topogram catalog show <id> [--json] [--catalog <path-or-source>]");
   console.log("   or: topogram catalog doctor [--json] [--catalog <path-or-source>]");
   console.log("   or: topogram catalog check <path-or-url> [--json]");
-  console.log("   or: topogram catalog copy <id> <target> [--version <version>] [--json] [--catalog <path-or-source>]");
   console.log("   or: topogram package update-cli <version|--latest> [--json]");
-  console.log("   or: topogram import <app-path> --out <target> [--from <track[,track]>] [--json]");
-  console.log("   or: topogram import refresh [path] [--from <app-path>] [--dry-run] [--json]");
-  console.log("   or: topogram import diff [path] [--json]");
-  console.log("   or: topogram import check [path] [--json]");
-  console.log("   or: topogram import plan [path] [--json]");
-  console.log("   or: topogram import adopt --list [path] [--json]");
-  console.log("   or: topogram import adopt <selector> [path] [--dry-run|--write] [--force --reason <text>] [--json]");
-  console.log("   or: topogram import status [path] [--json]");
-  console.log("   or: topogram import history [path] [--verify] [--json]");
+  console.log("   or: topogram copy <source> <target> [--version <version>] [--catalog <path-or-source>] [--json]");
+  console.log("   or: topogram copy --list [--json] [--catalog <path-or-source>]");
+  console.log("   or: topogram extract <app-path> --out <target> [--from <track[,track]>] [--json]");
+  console.log("   or: topogram extract refresh [path] [--from <app-path>] [--dry-run] [--json]");
+  console.log("   or: topogram extract diff [path] [--json]");
+  console.log("   or: topogram extract check [path] [--json]");
+  console.log("   or: topogram extract plan [path] [--json]");
+  console.log("   or: topogram adopt --list [path] [--json]");
+  console.log("   or: topogram adopt <selector> [path] [--dry-run|--write] [--force --reason <text>] [--json]");
+  console.log("   or: topogram extract status [path] [--json]");
+  console.log("   or: topogram extract history [path] [--verify] [--json]");
   console.log("   or: topogram source status [path] [--local|--remote] [--json]");
   console.log("   or: topogram template list [--json]");
   console.log("   or: topogram template explain [path] [--json]");
@@ -66,9 +67,7 @@ export function printUsage(options = {}) {
   console.log("   or: topogram generator policy check [path] [--json]");
   console.log("   or: topogram generator policy explain [path] [--json]");
   console.log("   or: topogram generator policy pin [package@version] [path] [--json]");
-  console.log("   or: topogram new <path> [--template hello-web|todo|./local-template|@scope/template]");
-  console.log("   or: topogram new <path> --template <package> --allow-local-npmrc");
-  console.log("   or: topogram new --list-templates [--json] [--catalog <path-or-source>]");
+  console.log("   or: topogram init [path] [--with-sdlc] [--json]");
   console.log("");
   console.log("Common commands:");
   console.log("  topogram version");
@@ -76,9 +75,10 @@ export function printUsage(options = {}) {
   console.log("  topogram setup package-auth");
   console.log("  topogram release status");
   console.log("  topogram release roll-consumers --latest");
-  console.log("  topogram new ./my-app");
-  console.log("  topogram new --list-templates");
-  console.log("  topogram new ./my-app --template todo");
+  console.log("  topogram init .");
+  console.log("  topogram copy --list");
+  console.log("  topogram copy hello-web ./my-app");
+  console.log("  topogram copy todo ./todo-app");
   console.log("  topogram check");
   console.log("  topogram check --json");
   console.log("  topogram widget check --projection proj_web_surface");
@@ -99,21 +99,22 @@ export function printUsage(options = {}) {
   console.log("  topogram generator check ./generator-package");
   console.log("  topogram generator policy check");
   console.log("  topogram generate");
-  console.log("  topogram import ./existing-app --out ./imported-topogram");
-  console.log("  topogram import diff ./imported-topogram");
-  console.log("  topogram import refresh ./imported-topogram --from ./existing-app --dry-run");
-  console.log("  topogram import check ./imported-topogram");
-  console.log("  topogram import plan ./imported-topogram");
-  console.log("  topogram import adopt --list ./imported-topogram");
-  console.log("  topogram import adopt bundle:task ./imported-topogram --dry-run");
-  console.log("  topogram import status ./imported-topogram");
-  console.log("  topogram import history ./imported-topogram --verify");
+  console.log("  topogram extract ./existing-app --out ./extracted-topogram");
+  console.log("  topogram extract diff ./extracted-topogram");
+  console.log("  topogram extract refresh ./extracted-topogram --from ./existing-app --dry-run");
+  console.log("  topogram extract check ./extracted-topogram");
+  console.log("  topogram extract plan ./extracted-topogram");
+  console.log("  topogram adopt --list ./extracted-topogram");
+  console.log("  topogram adopt bundle:task ./extracted-topogram --dry-run");
+  console.log("  topogram extract status ./extracted-topogram");
+  console.log("  topogram extract history ./extracted-topogram --verify");
   console.log("");
   console.log("Fresh install:");
   console.log("  npm install --save-dev @topogram/cli");
   console.log("  npx topogram doctor");
   console.log("  npx topogram template list");
-  console.log("  npx topogram new ./my-app --template hello-web");
+  console.log("  npx topogram init .");
+  console.log("  npx topogram copy hello-web ./my-app");
   console.log("  cd ./my-app && npm install && npm run check && npm run generate");
   console.log("  npm --prefix app run compile");
   console.log("");
@@ -123,7 +124,7 @@ export function printUsage(options = {}) {
   console.log("  topogram catalog show todo");
   console.log("  topogram catalog doctor");
   console.log("  topogram catalog check topograms.catalog.json");
-  console.log("  topogram catalog copy hello ./hello-topogram");
+  console.log("  topogram copy hello ./hello-topogram");
   console.log("  topogram source status --local");
   console.log("  topogram source status --remote");
   console.log("");
@@ -149,7 +150,7 @@ export function printUsage(options = {}) {
   console.log("  topogram template update --apply");
   console.log("");
   console.log("Defaults: check/generate use ./topo, and generate writes ./app.");
-  console.log("Default starter: hello-web from the catalog. Run `topogram template list` for catalog aliases.");
+  console.log("Default starter: hello-web from the catalog. Run `topogram copy --list` for catalog aliases.");
   console.log("Generated app commands are emitted into the output package.json.");
   console.log("Run `topogram help <command>` for command-specific help.");
   console.log("Run `topogram help all` for legacy and agent-facing commands.");
@@ -157,16 +158,12 @@ export function printUsage(options = {}) {
     return;
   }
   console.log("");
-  console.log("Legacy and internal commands:");
-  console.log("Usage: topogram create <path> [--template hello-web|todo|./local-template|@scope/template]");
+  console.log("Internal commands:");
   console.log("   or: topogram template show <id> [--json] [--catalog <path-or-source>]");
-  console.log("   or: topogram import app <path> [--from <track[,track]>] [--write]");
   console.log("   or: topogram validate <path>");
-  console.log("   or: node ./src/cli.js query work-packet <path> --mode import-adopt --lane <id>");
+  console.log("   or: node ./src/cli.js query work-packet <path> --mode extract-adopt --lane <id>");
   console.log("   or: node ./src/cli.js <path> [--json] [--validate] [--resolve] [--workflow <name>] [--mode <id>] [--from <track[,track]>] [--adopt <selector>] [--refresh-adopted] [--shape <id>] [--capability <id>] [--widget <id>] [--projection <id>] [--entity <id>] [--journey <id>] [--surface <id>] [--task <id>] [--profile <id>] [--from-snapshot <path>] [--from-topogram <path>] [--write] [--out-dir <path>]");
   console.log("   or: node ./src/cli.js emit <target> [path] [--json] [--write] [--out-dir <path>]");
-  console.log("   or: node ./src/cli.js import app <path> [--from <track[,track]>] [--write]");
-  console.log("   or: node ./src/cli.js import docs <path> [--write]");
   console.log("   or: node ./src/cli.js generate journeys <path> [--write]");
   console.log("   or: node ./src/cli.js report gaps <path> [--write]");
   console.log("   or: node ./src/cli.js query task-mode <path> [--mode <id>] [--capability <id>] [--workflow <id>] [--projection <id>] [--widget <id>] [--entity <id>] [--journey <id>] [--from-topogram <path>]");
@@ -184,56 +181,75 @@ export function printUsage(options = {}) {
   console.log("   or: node ./src/cli.js query verification-targets <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 widget-behavior <path> [--projection <id>] [--widget <id>] [--json]");
   console.log("   or: node ./src/cli.js query change-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 import-plan <path>");
+  console.log("   or: node ./src/cli.js query extract-plan <path>");
   console.log("   or: node ./src/cli.js query risk-summary <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 canonical-writes <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 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>] [--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 multi-agent-plan <path> --mode extract-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>]");
   console.log("   or: node ./src/cli.js query workflow-preset-diff <path> --provider <id> [--preset <id>]");
   console.log("   or: node ./src/cli.js query workflow-preset-customization <path> --provider <id> --preset <id>");
   console.log("   or: node ./src/cli.js workflow-preset customize <path> --provider <id> --preset <id> [--out <path>] [--write]");
-  console.log("   or: node ./src/cli.js query lane-status <path> --mode import-adopt");
-  console.log("   or: node ./src/cli.js query handoff-status <path> --mode import-adopt");
+  console.log("   or: node ./src/cli.js query lane-status <path> --mode extract-adopt");
+  console.log("   or: node ./src/cli.js query handoff-status <path> --mode extract-adopt");
   console.log("   or: node ./src/cli.js query auth-hints <path>");
   console.log("   or: node ./src/cli.js query auth-review-packet <path> --bundle <slug>");
   console.log("   or: node ./src/cli.js reconcile <path> [--write]");
   console.log("   or: node ./src/cli.js reconcile adopt <selector> <path> [--refresh-adopted] [--write]");
   console.log("   or: node ./src/cli.js adoption status <path> [--write]");
   console.log("Targets: json-schema, docs, docs-index, verification-plan, verification-checklist, shape-transform-graph, shape-transform-debug, api-contract-graph, api-contract-debug, ui-contract-graph, ui-contract-debug, ui-widget-contract, widget-conformance-report, widget-behavior-report, ui-surface-contract, ui-surface-debug, sveltekit-app, swiftui-app, db-contract-graph, db-contract-debug, db-schema-snapshot, db-migration-plan, db-lifecycle-plan, db-lifecycle-bundle, environment-plan, environment-bundle, deployment-plan, deployment-bundle, runtime-smoke-plan, runtime-smoke-bundle, runtime-check-plan, runtime-check-bundle, compile-check-plan, compile-check-bundle, app-bundle-plan, app-bundle, native-parity-plan, native-parity-bundle, sql-migration, sql-schema, prisma-schema, drizzle-schema, persistence-scaffold, server-contract, hono-server, openapi, context-digest, context-diff, context-slice, context-bundle, context-report, context-task-mode");
-  console.log("Workflows: import-app, scan-docs, reconcile, adoption-status, generate-docs, generate-journeys, refresh-docs, report-gaps");
-  console.log("Import tracks: db, api, ui, workflows, verification");
+  console.log("Workflows: scan-docs, reconcile, adoption-status, generate-docs, generate-journeys, refresh-docs, report-gaps");
+  console.log("Extract tracks: db, api, ui, cli, workflows, verification");
   console.log("Reconcile adopt selectors: from-plan, actors, roles, enums, shapes, entities, capabilities, widgets, docs, journeys, workflows, ui, bundle:<slug>, projection-review:<id>, ui-review:<id>, workflow-review:<id>, bundle-review:<slug>");
 }
 
 /**
  * @returns {void}
  */
-export function printNewHelp() {
-  console.log("Usage: topogram new <path> [--template <alias|package|path>] [--catalog <path-or-source>]");
-  console.log("   or: topogram new --list-templates [--json] [--catalog <path-or-source>]");
+export function printCopyHelp() {
+  console.log("Usage: topogram copy <source> <target> [--version <version>] [--catalog <path-or-source>] [--json]");
+  console.log("   or: topogram copy --list [--json] [--catalog <path-or-source>]");
   console.log("");
-  console.log("Creates a new editable Topogram workspace from a template package or local template path.");
+  console.log("Copies a catalog template, template package/path, or pure Topogram source into a new project directory.");
   console.log("");
   console.log("Fresh install flow:");
   console.log("  npm install --save-dev @topogram/cli");
-  console.log("  npx topogram template list");
-  console.log("  npx topogram new ./my-app --template hello-web");
+  console.log("  npx topogram copy --list");
+  console.log("  npx topogram copy hello-web ./my-app");
   console.log("  cd ./my-app && npm install && npm run check && npm run generate");
   console.log("  npm --prefix app run compile");
   console.log("");
   console.log("Examples:");
-  console.log("  topogram new ./my-app");
-  console.log("  topogram new --list-templates");
-  console.log("  topogram new ./my-app --template hello-web");
-  console.log("  topogram new ./my-app --template ./local-template");
-  console.log("  topogram new ./my-app --template @scope/topogram-template");
+  console.log("  topogram copy --list");
+  console.log("  topogram copy hello-web ./my-app");
+  console.log("  topogram copy todo ./todo-app");
+  console.log("  topogram copy ./local-template ./my-app");
+  console.log("  topogram copy @scope/topogram-template ./my-app");
+  console.log("");
+  console.log("Template entries create starter projects. Topogram entries copy editable topo/ source.");
+}
+
+/**
+ * @returns {void}
+ */
+export function printInitHelp() {
+  console.log("Usage: topogram init [path] [--with-sdlc] [--json]");
+  console.log("");
+  console.log("Initializes an empty Topogram workspace in an existing or new repository without copying a template.");
   console.log("");
-  console.log("Default template: hello-web from the configured catalog.");
+  console.log("Defaults: path is the current directory. Init creates topo/, topogram.project.json, and starter guidance files only when they are missing.");
+  console.log("The default output is maintained ownership for '.', so Topogram will not overwrite app source.");
+  console.log("--with-sdlc also writes topogram.sdlc-policy.json with adopted/enforced defaults.");
+  console.log("");
+  console.log("Examples:");
+  console.log("  topogram init");
+  console.log("  topogram init . --with-sdlc");
+  console.log("  topogram init . --json");
+  console.log("  topogram init ./existing-app");
 }
 
 /**

package/src/cli/migration-guidance.js

@@ -30,6 +30,15 @@ export function cliMigrationError(args) {
   if (args[0] === "component") {
     return "Command 'topogram component' was renamed to 'topogram widget'.";
   }
+  if (args[0] === "new" || args[0] === "create") {
+    return "Command 'topogram new' was replaced by 'topogram copy <source> <target>'. For example: topogram copy hello-web ./my-app.";
+  }
+  if (args[0] === "import") {
+    return "Command 'topogram import' was replaced by 'topogram extract' and top-level 'topogram adopt'.";
+  }
+  if (args[0] === "catalog" && args[1] === "copy") {
+    return "Command 'topogram catalog copy' was replaced by 'topogram copy <source> <target>'.";
+  }
   if (args[0] === "migrate") {
     return "Command 'topogram migrate workspace-folder' was removed. Use topo/ workspaces or configure topogram.project.json workspace to a non-legacy relative path.";
   }

package/src/generator/context/bundle.js

@@ -12,6 +12,7 @@ import {
   stableSortedStrings,
   summarizeById,
   summarizeDocsByIds,
+  summarizeJourneyLikeByIds,
   summarizeStatementsByIds,
   verificationIdsForTarget
 } from "./shared.js";
@@ -89,9 +90,12 @@ function uiBundle(graph) {
       .map((doc) => doc.id)
   );
   const journeys = stableSortedStrings(
-    (graph.docs || [])
-      .filter((doc) => doc.kind === "journey" && (doc.relatedProjections || []).some((id) => projections.includes(id)))
-      .map((doc) => doc.id)
+    [
+      ...(graph.byKind.journey || []),
+      ...(graph.docs || []).filter((doc) => doc.kind === "journey")
+    ]
+      .filter((journey) => (journey.relatedProjections || []).some((id) => projections.includes(id)))
+      .map((journey) => journey.id)
   );
   const rules = stableSortedStrings(capabilities.flatMap((capabilityId) => {
     return (graph.byKind.rule || [])
@@ -112,7 +116,7 @@ function uiBundle(graph) {
       projections: summarizeStatementsByIds(graph, projections),
       capabilities: summarizeStatementsByIds(graph, capabilities),
       workflows: summarizeDocsByIds(graph, workflows),
-      journeys: summarizeDocsByIds(graph, journeys),
+      journeys: summarizeJourneyLikeByIds(graph, journeys),
       rules: summarizeStatementsByIds(graph, rules)
     },
     dependencies: {
@@ -131,7 +135,7 @@ function uiBundle(graph) {
     review_boundaries: {
       projections: projections.map((id) => ({ id, review_boundary: summarizeById(graph, id)?.reviewBoundary || null })),
       workflows: workflows.map((id) => ({ id, review_boundary: reviewBoundaryForWorkflowDoc((graph.docs || []).find((doc) => doc.id === id)) })),
-      journeys: journeys.map((id) => ({ id, review_boundary: reviewBoundaryForJourneyDoc((graph.docs || []).find((doc) => doc.id === id)) }))
+      journeys: journeys.map((id) => ({ id, review_boundary: reviewBoundaryForJourneyDoc(summarizeById(graph, id) || null) }))
     }
   };
 }
@@ -186,7 +190,10 @@ function dbBundle(graph) {
 function maintainedAppBundle(graph) {
   const proofStories = maintainedProofMetadata(graph);
   const projections = stableSortedStrings((graph.byKind.projection || []).map((item) => item.id));
-  const journeys = stableSortedStrings((graph.docs || []).filter((doc) => doc.kind === "journey").map((doc) => doc.id));
+  const journeys = stableSortedStrings([
+    ...(graph.byKind.journey || []).map((item) => item.id),
+    ...(graph.docs || []).filter((doc) => doc.kind === "journey").map((doc) => doc.id)
+  ]);
   const verifications = stableSortedStrings((graph.byKind.verification || []).map((item) => item.id));
   const maintainedFiles = stableSortedStrings(proofStories.flatMap((item) => item.maintainedFiles || []));
   const emittedDependencies = stableSortedStrings(proofStories.flatMap((item) => item.emittedDependencies || []));
@@ -215,7 +222,7 @@ function maintainedAppBundle(graph) {
     },
     included_surfaces: {
       projections: summarizeStatementsByIds(graph, projections),
-      journeys: summarizeDocsByIds(graph, journeys),
+      journeys: summarizeJourneyLikeByIds(graph, journeys),
       maintained_files_in_scope: maintainedFiles,
       emitted_artifact_dependencies: emittedDependencies,
       human_owned_seams: humanOwnedSeams,

package/src/generator/context/diff.js

@@ -16,10 +16,17 @@ import {
 import { defaultOwnershipBoundary } from "../../policy/review-boundaries.js";
 
 function normalizeTargetMap(graph, kind) {
-  if (kind === "workflow" || kind === "journey") {
+  if (kind === "workflow") {
     const docs = (graph.docs || []).filter((doc) => doc.kind === kind);
     return new Map(docs.map((doc) => [doc.id, summarizeDoc(doc)]));
   }
+  if (kind === "journey") {
+    const journeys = [
+      ...(graph.byKind?.journey || []).map((statement) => summarizeStatement(statement)),
+      ...(graph.docs || []).filter((doc) => doc.kind === kind).map((doc) => summarizeDoc(doc))
+    ];
+    return new Map(journeys.map((journey) => [journey.id, journey]));
+  }
 
   return new Map(((graph.byKind[kind] || []).map((statement) => [statement.id, summarizeStatement(statement)])));
 }

package/src/generator/context/digest.js

@@ -138,6 +138,11 @@ function journeyDigest(graph, journey) {
       id: journey.id
     },
     summary: summarizeById(graph, journey.id),
+    steps: (journey.steps || []).map((step) => ({
+      id: step.id,
+      intent: step.intent || null,
+      after: [...(step.after || [])]
+    })),
     verifications: verificationIdsForTarget(graph, [journey.id, ...(journey.relatedCapabilities || [])]),
     review_boundary: reviewBoundaryForJourneyDoc(journey),
     ownership_boundary: defaultOwnershipBoundary()
@@ -174,7 +179,11 @@ export function generateContextDigest(graph) {
     files[`projections/${projection.id}.context-digest.json`] = projectionDigest(graph, projection);
   }
 
-  for (const journey of (graph.docs || []).filter((doc) => doc.kind === "journey").sort((a, b) => a.id.localeCompare(b.id))) {
+  const journeys = [
+    ...(graph.byKind.journey || []),
+    ...(graph.docs || []).filter((doc) => doc.kind === "journey")
+  ].sort((a, b) => a.id.localeCompare(b.id));
+  for (const journey of journeys) {
     files[`journeys/${journey.id}.context-digest.json`] = journeyDigest(graph, journey);
   }
 

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

@@ -287,9 +287,13 @@ export function getWorkflowDoc(graph, workflowId) {
  * @returns {any}
  */
 export function getJourneyDoc(graph, journeyId) {
+  const journey = (graph.byKind?.journey || []).find(/** @param {any} item */ (item) => item.id === journeyId);
+  if (journey) {
+    return journey;
+  }
   const doc = (graph.docs || []).find(/** @param {any} item */ (item) => item.kind === "journey" && item.id === journeyId);
   if (!doc) {
-    throw new Error(`No journey doc found with id '${journeyId}'`);
+    throw new Error(`No journey found with id '${journeyId}'`);
   }
   return doc;
 }

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

@@ -45,10 +45,13 @@ export function verificationsFor(graph, predicate) {
  * @returns {any}
  */
 export function relatedJourneysForCapability(graph, capabilityId) {
-  return relatedDocs(
-    graph,
-    /** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.kind === "journey" && (doc.relatedCapabilities || []).includes(capabilityId)
-  );
+  return [
+    ...(graph.byKind?.journey || []).filter(/** @param {any} journey */ (journey) => (journey.relatedCapabilities || []).includes(capabilityId)),
+    ...relatedDocs(
+      graph,
+      /** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.kind === "journey" && (doc.relatedCapabilities || []).includes(capabilityId)
+    )
+  ];
 }
 
 /**
@@ -395,6 +398,15 @@ export function summarizeDocsByIds(graph, ids) {
     .map(summarizeDoc);
 }
 
+/**
+ * @param {import("./types.d.ts").ContextGraph} graph
+ * @param {Iterable<string>} ids
+ * @returns {any}
+ */
+export function summarizeJourneyLikeByIds(graph, ids) {
+  return stableSortedStrings(ids).map(/** @param {string} id */ (id) => summarizeById(graph, id)).filter(Boolean);
+}
+
 /**
  * @param {import("./types.d.ts").ContextGraph} graph
  * @returns {any}
@@ -403,7 +415,10 @@ export function workspaceInventory(graph) {
   return {
     capabilities: stableSortedStrings((graph.byKind.capability || []).map(/** @param {any} item */ (item) => item.id)),
     workflows: stableSortedStrings((graph.docs || []).filter(/** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.kind === "workflow").map(/** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.id)),
-    journeys: stableSortedStrings((graph.docs || []).filter(/** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.kind === "journey").map(/** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.id)),
+    journeys: stableSortedStrings([
+      ...(graph.byKind.journey || []).map(/** @param {any} item */ (item) => item.id),
+      ...(graph.docs || []).filter(/** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.kind === "journey").map(/** @param {import("./types.d.ts").ContextDoc} doc */ (doc) => doc.id)
+    ]),
     entities: stableSortedStrings((graph.byKind.entity || []).map(/** @param {any} item */ (item) => item.id)),
     projections: stableSortedStrings((graph.byKind.projection || []).map(/** @param {any} item */ (item) => item.id)),
     widgets: stableSortedStrings((graph.byKind.widget || []).map(/** @param {any} item */ (item) => item.id)),