@sdd-method/sdd-cli 4.0.1 → 5.1.0

package/scripts/build-persona-package.mjs

@@ -44,11 +44,6 @@ const ADMIN_CANARIES = [
   "verbs/metamodel.js",
   "verbs/catalogue.js",
   "lib/catalogue/migration-map.js",
-  // The archive operation and extraction (M-ADR 0230 §4.6, §6, Proposed) are sdd-cli's while the record is Proposed: no persona carries them.
-  "verbs/change.js",
-  "lib/structure/archive.js",
-  "lib/structure/apply.js",
-  "lib/structure/extract.js",
 ];
 const AUTHOR_ONLY_MODULES = [
   "verbs/conformance.js",
@@ -58,6 +53,12 @@ const AUTHOR_ONLY_MODULES = [
   "verbs/api-surface.js",
   "verbs/snapshot.js",
   "lib/snapshot/land.js",
+  // The structural model's authoring: its extraction and the archive operation (M-ADR 0230 §4.6, §6, at its acceptance).
+  "verbs/change.js",
+  "verbs/migrate-structure.js",
+  "lib/structure/archive.js",
+  "lib/structure/apply.js",
+  "lib/structure/extract.js",
 ];
 const MAINTAIN_WRITERS = [
   "verbs/sync.js",
@@ -69,6 +70,8 @@ const MAINTAIN_WRITERS = [
   "lib/catalogue/graph-run.js",
   "lib/snapshot/catalogue-diff.js",
   "lib/pack/builder.js",
+  // The generated views' writer (M-ADR 0230 §4.3); render.js itself is read by the structural-model validator.
+  "verbs/structure.js",
 ];
 const AUTHOR_CANARIES = [...ADMIN_CANARIES, ...AUTHOR_ONLY_MODULES];
 const PERSONAS = {
@@ -84,6 +87,7 @@ const PERSONAS = {
       "verbs/sync.js",
       "verbs/pack.js",
       "verbs/render.js",
+      "verbs/structure.js",
       "lib/sync/index.js",
       "lib/catalogue/build.js",
       "lib/catalogue/aggregate.js",
@@ -115,7 +119,7 @@ const PERSONAS = {
       `# @sdd-method/author-cli\n\n` +
       `\`sdd-author\` is for the people and agents who own one SDD's content. It re-authors that content and **cannot move the baseline or rebuild the model** (M-ADR 0220).\n\n` +
       `Verbs: everything in \`@sdd-method/verify-cli\`, plus \`scaffold domain\`, \`plan\`, \`contracts attest\`, \`conformance\`, \`api-surface\`, ` +
-      `the \`snapshot\` verbs, \`render screen\`, \`generate-briefing\`, \`context pull\` and \`catalogue check\`.\n\n` +
+      `the \`snapshot\` verbs, \`render screen\`, \`generate-briefing\`, \`context pull\`, \`catalogue check\`, and the structural model's \`migrate structure\` and \`change archive\`.\n\n` +
       `\`catalogue check\` reports whether the committed catalogues are what the committed specifications build to, and writes nothing. ` +
       `Rebuilding them (\`catalogue build\`), \`sync\` and \`pack build\` are in \`@sdd-method/maintain-cli\`; \`init\` and the administrator's verbs are in \`@sdd-method/sdd-cli\`. ` +
       `They are not present in this package, and invoking one fails with exit 1.\n`,
@@ -134,7 +138,7 @@ const PERSONAS = {
       `# @sdd-method/maintain-cli\n\n` +
       `\`sdd-maintain\` brings an SDD repository current and rebuilds its derived model, and **cannot author specification content** (M-ADR 0218).\n\n` +
       `Verbs: everything in \`@sdd-method/verify-cli\`, plus \`sync\`, \`generate-briefing\`, \`context pull\`, ` +
-      `\`catalogue build\`, \`catalogue aggregate\`, \`catalogue graph\`, \`catalogue diff\`, \`pack build\`, \`render screen\`.\n\n` +
+      `\`catalogue build\`, \`catalogue aggregate\`, \`catalogue graph\`, \`catalogue diff\`, \`pack build\`, \`render screen\`, \`structure show\`, \`structure render\`.\n\n` +
       `Each writes only derived or method-managed content, and two runs on the same commit write the same bytes. ` +
       `Authoring verbs — \`init\`, \`scaffold\`, \`plan\`, \`conformance\` and the rest — are not present in it, ` +
       `and are in \`@sdd-method/sdd-cli\`. Invoking one fails with exit 1.\n`,

package/scripts/maintain-acceptance.mjs

@@ -49,6 +49,7 @@ const FIXED = [
   /^catalogues\//, /^catalogues-aggregated\//, /^catalogues(-aggregated)?-graph\.jsonl$/, // item 7
   /^\.sdd\/bundle-cache\//,                                           // sync's cache of the last-applied bundle (managed by sync itself)
   /^MCP_SETUP\.md$/,                                                  // item 9 (code repo)
+  /^docs\/structure\//,                                               // the structural model's generated views (M-ADR 0230 §4.3)
 ];
 function lockManaged(repo) {
   const p = join(repo, "method-baseline.lock");
@@ -217,6 +218,12 @@ for (const repo of REPOS) {
     const spec = readdirSync(screens).find((f) => f.endsWith(".md"));
     if (spec) twice(`render screen @${name}`, clone, ["render", "screen", join("screens", spec), "--out", join(ws, "screen.svg")], managed);
   }
+  // structure render and show: an SDD with a structural model (M-ADR 0230 §4.3). show reads one domain the model holds.
+  if (existsSync(join(clone, "openspec", "structure"))) {
+    twice(`structure render @${name}`, clone, ["structure", "render", "--sdd-path", "."], managed);
+    const domain = readdirSync(join(clone, "openspec", "structure")).find((f) => f.endsWith(".yaml") && f !== "platform.yaml");
+    if (domain) twice(`structure show @${name}`, clone, ["structure", "show", `domains/${domain.slice(0, -5)}`, "--sdd-path", "."], managed, { allowNonZero: true });
+  }
   // context pull: a scratch code repo, named for a repository this SDD catalogues, in its own directory: an
   // SDD often catalogues a repository with its own name, and beside the clone that path IS the clone.
   const repoCsv = join(clone, "catalogues", "repositories.csv");
@@ -233,7 +240,7 @@ for (const repo of REPOS) {
   }
 }
 
-const SURFACE = ["sync", "generate-briefing", "catalogue build", "catalogue graph", "catalogue aggregate", "context pull", "catalogue diff", "pack build", "render screen"];
+const SURFACE = ["sync", "generate-briefing", "catalogue build", "catalogue graph", "catalogue aggregate", "context pull", "catalogue diff", "pack build", "render screen", "structure render", "structure show"];
 const missing = SURFACE.filter((v) => !exercised.has(v));
 process.stdout.write(`COVERAGE exercised: ${[...exercised].join(", ")}\n`);
 if (missing.length) process.stdout.write(`COVERAGE NOT exercised here (needs inputs this run lacks): ${missing.join(", ")}\n`);

package/scripts/maintain-version.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.13.1",
-  "built_against_sdd_cli": "4.0.1"
+  "version": "0.15.0",
+  "built_against_sdd_cli": "5.1.0"
 }

package/scripts/verify-version.json

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