@sdd-method/author-cli 0.13.0 → 0.14.0

package/dist/verbs/migrate-structure.js

@@ -0,0 +1,36 @@
+import { extractStructure, writeExtraction } from "../lib/structure/extract.js";
+// `migrate structure [--dry-run]`: extract an SDD's first structural model from its sources, with its report
+// (M-ADR 0230 §6 step 1). Refuses an SDD that has a model; writes no source file.
+export async function runMigrateStructure(sddPath, options, write) {
+    const x = await extractStructure(sddPath);
+    if (x.refused !== null) {
+        write(`[FAIL] migrate structure: ${x.refused}\n`);
+        return 1;
+    }
+    const total = [...x.counts.values()].reduce((a, b) => a + b, 0);
+    write(`${options.dryRun ? "would extract" : "extracted"} ${total} element(s) in ${x.counts.size} catalogue(s), ${x.files.size} partition(s); ${x.loss.length + x.extraction.length} fact(s) the model could not carry\n`);
+    if (options.dryRun) {
+        write(x.report);
+        return 0;
+    }
+    for (const p of await writeExtraction(sddPath, x))
+        write(`wrote ${p}\n`);
+    write("[INFO] migrate structure: the model is now the record of structure, and the catalogue is built from it. Keep the original sources until it is reviewed against the code; removing openspec/structure/ withdraws it\n");
+    return 0;
+}
+// Authored content, so the author's and sdd-cli's (M-ADR 0230 §6, at its acceptance). Attaches to the
+// `migrate` command its program already registers.
+export function registerMigrateStructure(program) {
+    const migrate = program.commands.find((c) => c.name() === "migrate");
+    if (!migrate)
+        throw new Error("registerMigrateStructure: register `migrate` first");
+    migrate
+        .command("structure")
+        .description("Extract the SDD's first structural model from its sources into openspec/structure/, with an extraction report; source files are untouched (M-ADR 0230)")
+        .option("--sdd-path <path>", "the SDD (default: the current directory)", ".")
+        .option("--dry-run", "write nothing; print the report", false)
+        .action(async (opts) => {
+        process.exitCode = await runMigrateStructure(opts.sddPath, { dryRun: opts.dryRun }, (s) => process.stdout.write(s));
+    });
+}
+//# sourceMappingURL=migrate-structure.js.map

package/dist/verify-version.json

@@ -1,4 +1,4 @@
 {
-  "version": "5.0.0",
-  "built_against_sdd_cli": "5.0.0"
+  "version": "5.1.0",
+  "built_against_sdd_cli": "5.1.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sdd-method/author-cli",
-  "version": "0.13.0",
-  "sddCliVersion": "5.0.0",
+  "version": "0.14.0",
+  "sddCliVersion": "5.1.0",
   "description": "Re-author one SDD's content — scaffold, plan, contracts, conformance, api-surface, snapshots, briefings, catalogue check — plus every read-only verify verb. Ships only the code those verbs reach; it cannot sync the baseline or rebuild the catalogues. Maintenance is in @sdd-method/maintain-cli, administration in @sdd-method/sdd-cli.",
   "license": "UNLICENSED",
   "type": "module",