@sdd-method/author-cli 0.7.0 → 0.9.0

package/dist/verbs/scaffold.js

@@ -2,19 +2,21 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { isMethodDomainArchetype, METHOD_DOMAIN_ARCHETYPES, scaffoldDomain, } from "../lib/scaffold/domain.js";
 import { resolveArchetype } from "../lib/scaffold/registry.js";
+import { scaffoldBehaviourStore, storeScaffoldRefusal } from "../lib/scaffold/behaviour-store.js";
 import { resolvePathOption } from "./path-option.js";
 const DOMAIN_NAME = /^[a-z][a-z0-9-]*$/;
 export function registerScaffold(program) {
     const scaffold = program
         .command("scaffold")
-        .description("Scaffold method-shaped artefacts into an existing SDD repo (ADR 0173)");
+        .description("Scaffold method-shaped artefacts into an existing SDD repo (M-ADR 0173)");
+    registerScaffoldBehaviourStore(scaffold);
     scaffold
         .command("domain <name>")
         .description("Scaffold a platform domain (docs/domains/<name>/) into a platform-root SDD. " +
         "Writes the generic domain shape; --archetype overlays starter content.")
         .option("--archetype <id>", `seed from a domain archetype: method tier (${METHOD_DOMAIN_ARCHETYPES.join(" | ")}) ` +
         "or a registry archetype from a consumed bundle (e.g. core/identity, " +
-        "or bundle-qualified '<bundle>:<id>' — ADR 0176)")
+        "or bundle-qualified '<bundle>:<id>' — M-ADR 0176)")
         .option("--with-contracts", "include a contracts/ subfolder")
         .option("--target-repo <dir>", "platform-root SDD repo", resolvePathOption, process.cwd())
         .option("--dry-run", "report planned files without writing")
@@ -24,7 +26,7 @@ export function registerScaffold(program) {
         }
         const targetRepo = opts.targetRepo ?? process.cwd();
         await assertPlatformRoot(targetRepo);
-        // Archetype resolution chain (ADR 0176 §4.4): method tier is
+        // Archetype resolution chain (M-ADR 0176 §4.4): method tier is
         // built in; anything else resolves against cached bundle
         // registries — with a helpful listing on miss.
         let registryArchetype;
@@ -44,7 +46,7 @@ export function registerScaffold(program) {
                 `(archetype: ${label}${opts.withContracts ? ", +contracts" : ""})\n`);
             return;
         }
-        const { filesWritten } = await scaffoldDomain({
+        const { filesWritten, behaviourSkipped } = await scaffoldDomain({
             name,
             targetRepo,
             ...(opts.archetype && isMethodDomainArchetype(opts.archetype)
@@ -56,12 +58,42 @@ export function registerScaffold(program) {
         if (registryArchetype) {
             process.stdout.write(`[INFO] archetype ${registryArchetype.bundleName}:${registryArchetype.id} ` +
                 `(tier: ${registryArchetype.tier}) — seed files copied; the domain is adopter-owned from creation\n`);
+            process.stdout.write(behaviourSkipped
+                ? `[INFO] archetype behaviour not seeded: ${behaviourSkipped}\n`
+                : `[INFO] archetype behaviour seeded once as openspec/changes/seed-${name}-from-archetype, cited in docs/domains/${name}/archetype-citations.yaml: agree the change through the behaviour store\n`);
         }
         process.stdout.write(`[PASS] scaffolded domain '${name}' (${filesWritten.length} files):\n`);
         for (const f of filesWritten)
             process.stdout.write(`  ${f}\n`);
     });
 }
+function registerScaffoldBehaviourStore(scaffold) {
+    scaffold
+        .command("behaviour-store")
+        .description("Create this SDD's behaviour store at openspec/ (M-ADR 0221 §4.2): openspec/config.yaml from the method's " +
+        "template, selecting the sdd-change schema, the schema's copy at openspec/schemas/sdd-change/, and empty " +
+        "specs/, changes/archive/ and docs/agreements/. Create it when the SDD first drafts a proposed change, agrees a change or " +
+        "baselines behaviour; sync keeps the schema copy current afterwards.")
+        .option("--target-repo <dir>", "the SDD repo", resolvePathOption, process.cwd())
+        .option("--dry-run", "report the refusal or the planned store without writing")
+        .action(async (opts) => {
+        const targetRepo = opts.targetRepo ?? process.cwd();
+        const refusal = await storeScaffoldRefusal(targetRepo);
+        if (refusal !== null) {
+            process.stderr.write(`[FAIL] scaffold behaviour-store: ${refusal}\n`);
+            process.exit(1);
+        }
+        if (opts.dryRun === true) {
+            process.stdout.write("[DRY-RUN] would create openspec/ (config.yaml, schemas/sdd-change/, specs/, changes/archive/) and docs/agreements/\n");
+            return;
+        }
+        const { filesWritten, sddId } = await scaffoldBehaviourStore(targetRepo);
+        process.stdout.write(`[PASS] created the behaviour store (${filesWritten.length} files):\n`);
+        for (const f of filesWritten)
+            process.stdout.write(`  ${f}\n`);
+        process.stdout.write(`[INFO] fill in openspec/config.yaml's context${sddId === null ? " (the SDD id, no sdd_id in .sdd/sdd-manifest.yaml)" : ""}: the code repositories beside this SDD and where they are checked out\n`);
+    });
+}
 function fail(message) {
     process.stderr.write(`[FAIL] scaffold domain: ${message}\n`);
     process.exit(1);

package/dist/verify-program.js

@@ -109,11 +109,11 @@ export function registerVerifySurface(program) {
     registerList(program);
     const pack = program
         .command("pack")
-        .description("Validate adopter-shipped context-pack seeds (ADR 0151) — read-only");
+        .description("Validate adopter-shipped context-pack seeds (M-ADR 0151) — read-only");
     registerPackValidate(pack);
     const catalogue = program
         .command("catalogue")
-        .description("Validate and query per-SDD catalogues (ADR 0134) — read-only, never rebuilds");
+        .description("Validate and query per-SDD catalogues (M-ADR 0134) — read-only, never rebuilds");
     registerCatalogueValidate(catalogue);
     registerCatalogueImpact(catalogue);
     registerCatalogueBaselineCheck(catalogue);

package/dist/verify-version.json

@@ -1,4 +1,4 @@
 {
-  "version": "2.2.0",
-  "built_against_sdd_cli": "2.2.0"
+  "version": "2.4.0",
+  "built_against_sdd_cli": "2.4.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sdd-method/author-cli",
-  "version": "0.7.0",
-  "sddCliVersion": "2.2.0",
+  "version": "0.9.0",
+  "sddCliVersion": "2.4.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",

package/scripts/validate-app-dependencies.sh

@@ -149,7 +149,7 @@ fi
 APP_DEPS_FILE="$APP_ROOT/app-platform-dependencies.yaml"
 
 # TWO AUTHORING SOURCES, NOT ONE.
-#   The catalogue builder does multi-source ingestion under the ADR 0157 parity
+#   The catalogue builder does multi-source ingestion under the M-ADR 0157 parity
 #   principle: `app-platform-dependencies.yaml` AND every
 #   `reverse-evidence/**/feature-grounding-evidence.yaml`'s platform_dependencies
 #   block, merged by primary key with forward winning. They are equal-status

package/scripts/validate-integration-docs.sh

@@ -160,7 +160,7 @@ check_manifest() {
             ;;
     esac
 
-    # Interaction patterns (ADR 0171) — optional fields, validated only when present.
+    # Interaction patterns (M-ADR 0171) — optional fields, validated only when present.
     # Existing manifests predate the field; absence is not a failure. Directionality
     # mismatch (pattern present but the matching capability flag is false) is a warning.
     local ingestion invocation