npm - @prodshape/integration-openspec - Versions diffs - 0.1.0 - Mend

@prodshape/integration-openspec 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,115 @@
+/** The minimum supported OpenSpec CLI version. */
+declare const MIN_SUPPORTED_OPENSPEC = "1.0.0";
+/** The PDaC authority context block injected into openspec/config.yaml `context:`. */
+declare const PDAC_CONTEXT_BLOCK = "<!-- pdac:context begin -->\nThis repository uses Product Definition as Code (PDaC). The canonical product definition lives in docs/product/model (actors, journeys, use cases, business rules, domain terms, requirements) and is the single source of truth for product behaviour. OpenSpec artifacts are downstream consumers of it, never a second source of truth.\nConsumers bind to canonical text through the PDaC Citation Contract: a citation records the target artifact id, a sha256 content digest, and an optional verification scenario anchor. Verification reports one status per citation: current, stale, tampered or unresolved.\nTo cite: run `npx prodshape inspect <ID>` to read the current digest, then `npx prodshape cite --id <ID> --digest <digest>` to emit the citation record. Place inline citations on their own line directly under the text they ground.\nThe product definition changes only through a Product Change under docs/product/changes/. OpenSpec changes never edit docs/product/model directly.\n<!-- pdac:context end -->";
+/** The PDaC citation rules injected per artifact into openspec/config.yaml `rules:`. */
+declare const PDAC_RULES: Record<string, string[]>;
+/** The PDaC operation guidance injected into openspec/config.yaml `operations:`. */
+declare const PDAC_OPERATIONS: {
+    apply: {
+        guidance: string[];
+    };
+    archive: {
+        guidance: string[];
+    };
+};
+/** Metadata recorded under .product/integrations/openspec.json. */
+interface OpenSpecIntegrationMeta {
+    provider: 'openspec';
+    version: string;
+    openspecVersion: string;
+    installedAt: string;
+    configPath: string;
+}
+/** Detect the installed OpenSpec CLI version by running `openspec --version`. */
+declare function detectOpenSpecVersion(): Promise<{
+    version: string;
+} | {
+    error: string;
+}>;
+/** Check if an OpenSpec workspace exists at the given root (openspec/ directory present). */
+declare function isOpenSpecWorkspace(root: string): Promise<boolean>;
+/** Read and parse the existing openspec/config.yaml, or null if it does not exist. */
+declare function readOpenSpecConfig(root: string): Promise<Record<string, unknown> | null>;
+/**
+ * Merge PDaC guidance into the OpenSpec config, preserving existing content.
+ *
+ * - `schema` is preserved as-is.
+ * - `context`: if the existing context already contains the PDaC block, it is replaced in place
+ *   (idempotent); otherwise the PDaC block is appended after a separator. User-authored context
+ *   lines are never lost.
+ * - `rules`: for each PDaC artifact (proposal, specs, design, tasks), PDaC rules are appended to
+ *   existing rules, deduplicating identical entries.
+ * - `operations`: PDaC apply/archive guidance is appended to existing guidance, deduplicating.
+ * - Any other fields (githubCopilot, etc.) are preserved untouched.
+ *
+ * Returns the merged config and a list of human-readable change descriptions.
+ */
+declare function mergeConfig(existing: Record<string, unknown> | null): {
+    config: Record<string, unknown>;
+    changes: string[];
+};
+/** Serialize config back to YAML with a trailing newline. */
+declare function serializeConfig(config: Record<string, unknown>): string;
+/**
+ * Add the OpenSpec integration to a repository.
+ *
+ * - Detects the OpenSpec CLI version; rejects if not found or below MIN_SUPPORTED_OPENSPEC.
+ * - Requires an existing `openspec/` workspace (run `openspec init` first).
+ * - Merges PDaC guidance into `openspec/config.yaml`, preserving existing user configuration.
+ * - Records metadata under `.product/integrations/openspec.json`.
+ * - Idempotent: running twice produces the same result.
+ * - `--dry-run` reports what would change without writing.
+ * - `--force` re-merges even if the PDaC block is already present (useful after a PDaC upgrade).
+ */
+declare function addOpenSpecIntegration(root: string, options?: {
+    force?: boolean;
+    dryRun?: boolean;
+}): Promise<{
+    written: string[];
+    changes: string[];
+    meta: OpenSpecIntegrationMeta;
+}>;
+/**
+ * Update (re-merge) the OpenSpec integration. Re-runs the merge so that a PDaC upgrade that
+ * changed the context block or rules is reflected. Idempotent.
+ */
+declare function updateOpenSpecIntegration(root: string, options?: {
+    force?: boolean;
+    dryRun?: boolean;
+}): Promise<{
+    written: string[];
+    changes: string[];
+}>;
+/**
+ * Check the OpenSpec integration health. Verifies:
+ * - OpenSpec CLI is installed and the version is supported.
+ * - `openspec/config.yaml` exists and contains the PDaC context block.
+ * - `.product/integrations/openspec.json` metadata exists.
+ * - The config's PDaC block matches the current PDaC guidance (not removed or altered).
+ */
+declare function checkOpenSpecIntegration(root: string): Promise<{
+    ok: boolean;
+    checks: {
+        name: string;
+        ok: boolean;
+        detail: string;
+    }[];
+}>;
+/**
+ * Remove the PDaC-injected content from openspec/config.yaml, preserving user-authored content,
+ * and delete the metadata file.
+ *
+ * - Removes the PDaC context block (between sentinels) from `context:`.
+ * - Removes PDaC rules from each artifact (keeps user-authored rules).
+ * - Removes PDaC operation guidance (keeps user-authored guidance).
+ * - Deletes `.product/integrations/openspec.json`.
+ * - `--dry-run` reports what would be removed without writing.
+ */
+declare function removeOpenSpecIntegration(root: string, options?: {
+    dryRun?: boolean;
+}): Promise<{
+    removed: string[];
+}>;
+export { MIN_SUPPORTED_OPENSPEC, type OpenSpecIntegrationMeta, PDAC_CONTEXT_BLOCK, PDAC_OPERATIONS, PDAC_RULES, addOpenSpecIntegration, checkOpenSpecIntegration, detectOpenSpecVersion, isOpenSpecWorkspace, mergeConfig, readOpenSpecConfig, removeOpenSpecIntegration, serializeConfig, updateOpenSpecIntegration };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,444 @@
+// src/index.ts
+import { execFile } from "child_process";
+import { access, mkdir, readFile, rm, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import { parse, stringify } from "yaml";
+var MIN_SUPPORTED_OPENSPEC = "1.0.0";
+var PDAC_CONTEXT_BEGIN = "<!-- pdac:context begin -->";
+var PDAC_CONTEXT_END = "<!-- pdac:context end -->";
+var PDAC_CONTEXT_BLOCK = `${PDAC_CONTEXT_BEGIN}
+This repository uses Product Definition as Code (PDaC). The canonical product definition lives in docs/product/model (actors, journeys, use cases, business rules, domain terms, requirements) and is the single source of truth for product behaviour. OpenSpec artifacts are downstream consumers of it, never a second source of truth.
+Consumers bind to canonical text through the PDaC Citation Contract: a citation records the target artifact id, a sha256 content digest, and an optional verification scenario anchor. Verification reports one status per citation: current, stale, tampered or unresolved.
+To cite: run \`npx prodshape inspect <ID>\` to read the current digest, then \`npx prodshape cite --id <ID> --digest <digest>\` to emit the citation record. Place inline citations on their own line directly under the text they ground.
+The product definition changes only through a Product Change under docs/product/changes/. OpenSpec changes never edit docs/product/model directly.
+${PDAC_CONTEXT_END}`;
+var PDAC_RULES = {
+  proposal: [
+    "State which PDaC artifacts this change touches, each with an inline citation emitted by `npx prodshape cite --id <ID> --digest <digest>`. Never write a citation record by hand.",
+    "If the change alters product behaviour, name the Product Change (CHG id) it implements. If no Product Change exists yet, stop and ask for one instead of proceeding."
+  ],
+  specs: [
+    "Every requirement derived from canonical product text MUST carry a citation to every PDaC artifact it derives from, one citation per line, placed after the requirement text and before the first scenario. A requirement often derives from more than one artifact; citing only the closest one silently hides the other derivations. Never place citations between the requirement heading and the requirement text; OpenSpec reads the first paragraph as the requirement.",
+    'Cite a specific verification scenario with an anchor when the requirement maps to one (anchor="<scenario id>").',
+    "Never paraphrase canonical text as if it were new; either cite it inline or embed it in a marker-block citation (<!-- pdac:cite ... --> canonical text <!-- /pdac:cite -->).",
+    "Never invent artifact ids or digests. Read them with `npx prodshape inspect <ID>`."
+  ],
+  design: [
+    "When a design decision depends on canonical product text, cite the artifact it depends on."
+  ],
+  tasks: [
+    "A task that changes cited behaviour must include a follow-up task to refresh the affected citations."
+  ]
+};
+var PDAC_OPERATIONS = {
+  apply: {
+    guidance: [
+      "Before finishing, run `npx prodshape citations verify` and fix every stale, tampered or unresolved citation. Refresh a stale digest by re-running `npx prodshape inspect <ID>`; never delete a citation to silence a diagnostic."
+    ]
+  },
+  archive: {
+    guidance: [
+      "Run `npx prodshape citations verify` one final time. Archive only when every citation is current."
+    ]
+  }
+};
+var CONFIG_RELATIVE = "openspec/config.yaml";
+var META_RELATIVE = ".product/integrations/openspec.json";
+function configPath(root) {
+  return join(root, ...CONFIG_RELATIVE.split("/"));
+}
+function metaPath(root) {
+  return join(root, ...META_RELATIVE.split("/"));
+}
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function compareVersions(a, b) {
+  const parseParts = (v) => {
+    const core = v.split("-")[0]?.split("+")[0] ?? "";
+    const segments = core.split(".").map((s) => Number.parseInt(s, 10));
+    return [segments[0] ?? 0, segments[1] ?? 0, segments[2] ?? 0];
+  };
+  const [aMaj, aMin, aPatch] = parseParts(a);
+  const [bMaj, bMin, bPatch] = parseParts(b);
+  if (aMaj !== bMaj) return aMaj - bMaj;
+  if (aMin !== bMin) return aMin - bMin;
+  return aPatch - bPatch;
+}
+async function detectOpenSpecVersion() {
+  return new Promise((resolve) => {
+    execFile("openspec", ["--version"], { shell: true }, (error, stdout, stderr) => {
+      if (error) {
+        resolve({
+          error: `OpenSpec CLI not found on PATH (run: npm install -g openspec). ${error.message}`
+        });
+        return;
+      }
+      const output = `${stdout}${stderr}`.trim();
+      const match = output.match(/(\d+\.\d+\.\d+(?:-[^\s]+)?)/);
+      if (!match?.[1]) {
+        resolve({ error: `Could not parse OpenSpec version from output: ${output}` });
+        return;
+      }
+      resolve({ version: match[1] });
+    });
+  });
+}
+async function isOpenSpecWorkspace(root) {
+  return exists(join(root, "openspec"));
+}
+async function readOpenSpecConfig(root) {
+  const path = configPath(root);
+  if (!await exists(path)) return null;
+  const text = await readFile(path, "utf8");
+  const parsed = parse(text);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return {};
+  }
+  return parsed;
+}
+function extractPdacContext(context) {
+  if (!context) return null;
+  const begin = context.indexOf(PDAC_CONTEXT_BEGIN);
+  const end = context.indexOf(PDAC_CONTEXT_END);
+  if (begin === -1 || end === -1 || end < begin) return null;
+  return context.slice(begin, end + PDAC_CONTEXT_END.length);
+}
+function mergeConfig(existing) {
+  const config = { ...existing ?? {} };
+  const changes = [];
+  const existingContext = typeof config["context"] === "string" ? config["context"] : void 0;
+  const existingPdacBlock = extractPdacContext(existingContext);
+  if (existingPdacBlock !== null) {
+    if (existingPdacBlock !== PDAC_CONTEXT_BLOCK) {
+      const replaced = existingContext.replace(existingPdacBlock, PDAC_CONTEXT_BLOCK);
+      if (replaced !== existingContext) {
+        config["context"] = replaced;
+        changes.push("Updated PDaC context block in openspec/config.yaml (context:).");
+      }
+    }
+  } else if (existingContext) {
+    const separator = existingContext.endsWith("\n") ? "\n" : "\n\n";
+    config["context"] = `${existingContext}${separator}${PDAC_CONTEXT_BLOCK}`;
+    changes.push("Appended PDaC context block to existing openspec/config.yaml context:.");
+  } else {
+    config["context"] = PDAC_CONTEXT_BLOCK;
+    changes.push("Added PDaC context block to openspec/config.yaml (context:).");
+  }
+  const existingRules = config["rules"] && typeof config["rules"] === "object" && !Array.isArray(config["rules"]) ? { ...config["rules"] } : {};
+  let rulesChanged = false;
+  for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {
+    const existingList = Array.isArray(existingRules[artifact]) ? [...existingRules[artifact]] : [];
+    const merged = [...existingList];
+    for (const rule of pdacRules) {
+      if (!merged.includes(rule)) {
+        merged.push(rule);
+        rulesChanged = true;
+      }
+    }
+    existingRules[artifact] = merged;
+  }
+  if (rulesChanged) {
+    config["rules"] = existingRules;
+    changes.push("Merged PDaC citation rules into openspec/config.yaml (rules:).");
+  }
+  const existingOperations = config["operations"] && typeof config["operations"] === "object" && !Array.isArray(config["operations"]) ? { ...config["operations"] } : {};
+  let opsChanged = false;
+  for (const opKey of ["apply", "archive"]) {
+    const pdacGuidance = PDAC_OPERATIONS[opKey].guidance;
+    const existingOp = existingOperations[opKey] && typeof existingOperations[opKey] === "object" && !Array.isArray(existingOperations[opKey]) ? { ...existingOperations[opKey] } : {};
+    const existingGuidance = Array.isArray(existingOp["guidance"]) ? [...existingOp["guidance"]] : [];
+    const merged = [...existingGuidance];
+    for (const guidance of pdacGuidance) {
+      if (!merged.includes(guidance)) {
+        merged.push(guidance);
+        opsChanged = true;
+      }
+    }
+    existingOp["guidance"] = merged;
+    existingOperations[opKey] = existingOp;
+  }
+  if (opsChanged) {
+    config["operations"] = existingOperations;
+    changes.push("Merged PDaC operation guidance into openspec/config.yaml (operations:).");
+  }
+  return { config, changes };
+}
+function serializeConfig(config) {
+  return `${stringify(config)}
+`;
+}
+async function productshapeVersion() {
+  const packageJson = JSON.parse(
+    await readFile(new URL("../package.json", import.meta.url), "utf8")
+  );
+  return packageJson.version;
+}
+async function addOpenSpecIntegration(root, options = {}) {
+  const { force = false, dryRun = false } = options;
+  const detected = await detectOpenSpecVersion();
+  if ("error" in detected) {
+    throw new Error(detected.error);
+  }
+  if (compareVersions(detected.version, MIN_SUPPORTED_OPENSPEC) < 0) {
+    throw new Error(
+      `OpenSpec CLI version ${detected.version} is below the minimum supported ${MIN_SUPPORTED_OPENSPEC}. Please upgrade OpenSpec.`
+    );
+  }
+  if (!await isOpenSpecWorkspace(root)) {
+    throw new Error("No OpenSpec workspace found. Run `openspec init` first.");
+  }
+  const existing = await readOpenSpecConfig(root);
+  if (!force && existing) {
+    const existingContext = typeof existing["context"] === "string" ? existing["context"] : void 0;
+    if (existingContext && extractPdacContext(existingContext) === null) {
+    }
+  }
+  const { config, changes } = mergeConfig(existing);
+  if (changes.length === 0 && !force) {
+    const meta = {
+      provider: "openspec",
+      version: await productshapeVersion(),
+      openspecVersion: detected.version,
+      installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      configPath: CONFIG_RELATIVE
+    };
+    if (!dryRun) {
+      await writeMeta(root, meta);
+    }
+    return { written: [], changes: [], meta };
+  }
+  const written = [];
+  if (!dryRun) {
+    const serialized = serializeConfig(config);
+    await mkdir(dirname(configPath(root)), { recursive: true });
+    await writeFile(configPath(root), serialized, "utf8");
+    written.push(CONFIG_RELATIVE);
+    const meta = {
+      provider: "openspec",
+      version: await productshapeVersion(),
+      openspecVersion: detected.version,
+      installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      configPath: CONFIG_RELATIVE
+    };
+    await writeMeta(root, meta);
+    written.push(META_RELATIVE);
+  }
+  return {
+    written,
+    changes,
+    meta: {
+      provider: "openspec",
+      version: await productshapeVersion(),
+      openspecVersion: detected.version,
+      installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      configPath: CONFIG_RELATIVE
+    }
+  };
+}
+async function writeMeta(root, meta) {
+  const path = metaPath(root);
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, `${JSON.stringify(meta, null, 2)}
+`, "utf8");
+}
+async function readMeta(root) {
+  const path = metaPath(root);
+  if (!await exists(path)) return null;
+  return JSON.parse(await readFile(path, "utf8"));
+}
+async function updateOpenSpecIntegration(root, options = {}) {
+  const result = await addOpenSpecIntegration(root, { force: true, dryRun: options.dryRun });
+  return { written: result.written, changes: result.changes };
+}
+async function checkOpenSpecIntegration(root) {
+  const checks = [];
+  const detected = await detectOpenSpecVersion();
+  if ("error" in detected) {
+    checks.push({ name: "openspec CLI", ok: false, detail: detected.error });
+  } else if (compareVersions(detected.version, MIN_SUPPORTED_OPENSPEC) < 0) {
+    checks.push({
+      name: "openspec CLI",
+      ok: false,
+      detail: `OpenSpec ${detected.version} is below minimum supported ${MIN_SUPPORTED_OPENSPEC}.`
+    });
+  } else {
+    checks.push({
+      name: "openspec CLI",
+      ok: true,
+      detail: `OpenSpec ${detected.version} detected.`
+    });
+  }
+  const config = await readOpenSpecConfig(root);
+  if (config === null) {
+    checks.push({
+      name: "config.yaml",
+      ok: false,
+      detail: "openspec/config.yaml not found. Run: prodshape integration add openspec"
+    });
+  } else {
+    const context = typeof config["context"] === "string" ? config["context"] : void 0;
+    const pdacBlock = extractPdacContext(context);
+    if (pdacBlock === null) {
+      checks.push({
+        name: "config.yaml",
+        ok: false,
+        detail: "PDaC context block missing from openspec/config.yaml. Run: prodshape integration add openspec"
+      });
+    } else if (pdacBlock !== PDAC_CONTEXT_BLOCK) {
+      checks.push({
+        name: "config.yaml",
+        ok: false,
+        detail: "PDaC context block in openspec/config.yaml is outdated. Run: prodshape integration update"
+      });
+    } else {
+      checks.push({
+        name: "config.yaml",
+        ok: true,
+        detail: "PDaC context block present and current."
+      });
+    }
+  }
+  const meta = await readMeta(root);
+  if (meta === null) {
+    checks.push({
+      name: "metadata",
+      ok: false,
+      detail: ".product/integrations/openspec.json not found. Run: prodshape integration add openspec"
+    });
+  } else {
+    checks.push({
+      name: "metadata",
+      ok: true,
+      detail: `Integration recorded (OpenSpec ${meta.openspecVersion}, installed ${meta.installedAt}).`
+    });
+  }
+  if (config) {
+    const rules = config["rules"] && typeof config["rules"] === "object" && !Array.isArray(config["rules"]) ? config["rules"] : {};
+    const missingRules = [];
+    for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {
+      const list = Array.isArray(rules[artifact]) ? rules[artifact] : [];
+      for (const rule of pdacRules) {
+        if (!list.includes(rule)) missingRules.push(artifact);
+      }
+    }
+    if (missingRules.length > 0) {
+      checks.push({
+        name: "rules",
+        ok: false,
+        detail: `PDaC rules missing for: ${[...new Set(missingRules)].join(", ")}. Run: prodshape integration update`
+      });
+    } else {
+      checks.push({ name: "rules", ok: true, detail: "All PDaC citation rules present." });
+    }
+  }
+  const ok = checks.every((c) => c.ok);
+  return { ok, checks };
+}
+async function removeOpenSpecIntegration(root, options = {}) {
+  const { dryRun = false } = options;
+  const removed = [];
+  const config = await readOpenSpecConfig(root);
+  if (config !== null) {
+    let configChanged = false;
+    const context = typeof config["context"] === "string" ? config["context"] : void 0;
+    if (context) {
+      const pdacBlock = extractPdacContext(context);
+      if (pdacBlock !== null) {
+        const cleaned = context.replace(pdacBlock, "").replace(/\n{3,}/g, "\n\n").trimEnd();
+        if (cleaned === "") {
+          delete config["context"];
+        } else {
+          config["context"] = cleaned;
+        }
+        configChanged = true;
+      }
+    }
+    const rules = config["rules"] && typeof config["rules"] === "object" && !Array.isArray(config["rules"]) ? config["rules"] : null;
+    if (rules) {
+      let rulesChanged = false;
+      for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {
+        if (!Array.isArray(rules[artifact])) continue;
+        const list = rules[artifact];
+        const filtered = list.filter((r) => !pdacRules.includes(r));
+        if (filtered.length !== list.length) {
+          if (filtered.length === 0) {
+            delete rules[artifact];
+          } else {
+            rules[artifact] = filtered;
+          }
+          rulesChanged = true;
+        }
+      }
+      if (rulesChanged) {
+        if (Object.keys(rules).length === 0) {
+          delete config["rules"];
+        }
+        configChanged = true;
+      }
+    }
+    const operations = config["operations"] && typeof config["operations"] === "object" && !Array.isArray(config["operations"]) ? config["operations"] : null;
+    if (operations) {
+      let opsChanged = false;
+      for (const opKey of ["apply", "archive"]) {
+        const pdacGuidance = PDAC_OPERATIONS[opKey].guidance;
+        const op = operations[opKey] && typeof operations[opKey] === "object" && !Array.isArray(operations[opKey]) ? operations[opKey] : null;
+        if (!op || !Array.isArray(op["guidance"])) continue;
+        const list = op["guidance"];
+        const filtered = list.filter((g) => !pdacGuidance.includes(g));
+        if (filtered.length !== list.length) {
+          if (filtered.length === 0) {
+            delete op["guidance"];
+          } else {
+            op["guidance"] = filtered;
+          }
+          opsChanged = true;
+        }
+        if (Object.keys(op).length === 0) {
+          delete operations[opKey];
+        }
+      }
+      if (opsChanged) {
+        if (Object.keys(operations).length === 0) {
+          delete config["operations"];
+        }
+        configChanged = true;
+      }
+    }
+    if (configChanged && !dryRun) {
+      const serialized = serializeConfig(config);
+      await writeFile(configPath(root), serialized, "utf8");
+      removed.push(CONFIG_RELATIVE);
+    } else if (configChanged && dryRun) {
+      removed.push(CONFIG_RELATIVE);
+    }
+  }
+  if (await exists(metaPath(root))) {
+    if (!dryRun) {
+      await rm(metaPath(root), { force: true });
+    }
+    removed.push(META_RELATIVE);
+  }
+  return { removed };
+}
+export {
+  MIN_SUPPORTED_OPENSPEC,
+  PDAC_CONTEXT_BLOCK,
+  PDAC_OPERATIONS,
+  PDAC_RULES,
+  addOpenSpecIntegration,
+  checkOpenSpecIntegration,
+  detectOpenSpecVersion,
+  isOpenSpecWorkspace,
+  mergeConfig,
+  readOpenSpecConfig,
+  removeOpenSpecIntegration,
+  serializeConfig,
+  updateOpenSpecIntegration
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * OpenSpec integration for Product Definition as Code.\n *\n * This module configures an existing OpenSpec workspace with PDaC citation rules by merging\n * guidance into `openspec/config.yaml`, and records metadata under `.product/integrations/`.\n * It never creates an OpenSpec plugin, never patches OpenSpec-generated commands or skills, and\n * never forks OpenSpec's default schema. The integration is configuration + deterministic\n * verification: consumer documents cite canonical product artifacts by id + digest, and\n * `prodshape citations verify` checks them.\n *\n * The merge logic is the heart of this module: it preserves every field the user authored\n * (schema, context, rules, operations, githubCopilot, and anything else) and only appends PDaC\n * guidance, deduplicating identical entries so the operation is idempotent.\n */\nimport { execFile } from 'node:child_process';\nimport { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { parse, stringify } from 'yaml';\n\n/** The minimum supported OpenSpec CLI version. */\nexport const MIN_SUPPORTED_OPENSPEC = '1.0.0';\n\n/**\n * Sentinel markers that bracket the PDaC-injected context block. They let `mergeConfig` find\n * and replace exactly the PDaC portion without touching user-authored context lines.\n */\nconst PDAC_CONTEXT_BEGIN = '';\nconst PDAC_CONTEXT_END = '';\n\n/** The PDaC authority context block injected into openspec/config.yaml `context:`. */\nexport const PDAC_CONTEXT_BLOCK = `${PDAC_CONTEXT_BEGIN}\nThis repository uses Product Definition as Code (PDaC). The canonical product definition lives in docs/product/model (actors, journeys, use cases, business rules, domain terms, requirements) and is the single source of truth for product behaviour. OpenSpec artifacts are downstream consumers of it, never a second source of truth.\nConsumers bind to canonical text through the PDaC Citation Contract: a citation records the target artifact id, a sha256 content digest, and an optional verification scenario anchor. Verification reports one status per citation: current, stale, tampered or unresolved.\nTo cite: run \\`npx prodshape inspect <ID>\\` to read the current digest, then \\`npx prodshape cite --id <ID> --digest <digest>\\` to emit the citation record. Place inline citations on their own line directly under the text they ground.\nThe product definition changes only through a Product Change under docs/product/changes/. OpenSpec changes never edit docs/product/model directly.\n${PDAC_CONTEXT_END}`;\n\n/** The PDaC citation rules injected per artifact into openspec/config.yaml `rules:`. */\nexport const PDAC_RULES: Record<string, string[]> = {\n proposal: [\n 'State which PDaC artifacts this change touches, each with an inline citation emitted by `npx prodshape cite --id <ID> --digest <digest>`. Never write a citation record by hand.',\n 'If the change alters product behaviour, name the Product Change (CHG id) it implements. If no Product Change exists yet, stop and ask for one instead of proceeding.',\n ],\n specs: [\n 'Every requirement derived from canonical product text MUST carry a citation to every PDaC artifact it derives from, one citation per line, placed after the requirement text and before the first scenario. A requirement often derives from more than one artifact; citing only the closest one silently hides the other derivations. Never place citations between the requirement heading and the requirement text; OpenSpec reads the first paragraph as the requirement.',\n 'Cite a specific verification scenario with an anchor when the requirement maps to one (anchor=\"<scenario id>\").',\n 'Never paraphrase canonical text as if it were new; either cite it inline or embed it in a marker-block citation ( canonical text ).',\n 'Never invent artifact ids or digests. Read them with `npx prodshape inspect <ID>`.',\n ],\n design: [\n 'When a design decision depends on canonical product text, cite the artifact it depends on.',\n ],\n tasks: [\n 'A task that changes cited behaviour must include a follow-up task to refresh the affected citations.',\n ],\n};\n\n/** The PDaC operation guidance injected into openspec/config.yaml `operations:`. */\nexport const PDAC_OPERATIONS: {\n apply: { guidance: string[] };\n archive: { guidance: string[] };\n} = {\n apply: {\n guidance: [\n 'Before finishing, run `npx prodshape citations verify` and fix every stale, tampered or unresolved citation. Refresh a stale digest by re-running `npx prodshape inspect <ID>`; never delete a citation to silence a diagnostic.',\n ],\n },\n archive: {\n guidance: [\n 'Run `npx prodshape citations verify` one final time. Archive only when every citation is current.',\n ],\n },\n};\n\n/** Metadata recorded under .product/integrations/openspec.json. */\nexport interface OpenSpecIntegrationMeta {\n provider: 'openspec';\n version: string;\n openspecVersion: string;\n installedAt: string;\n configPath: string;\n}\n\n/** Repository-relative paths used by this integration. */\nconst CONFIG_RELATIVE = 'openspec/config.yaml';\nconst META_RELATIVE = '.product/integrations/openspec.json';\n\nfunction configPath(root: string): string {\n return join(root, ...CONFIG_RELATIVE.split('/'));\n}\n\nfunction metaPath(root: string): string {\n return join(root, ...META_RELATIVE.split('/'));\n}\n\nasync function exists(path: string): Promise<boolean> {\n try {\n await access(path);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * Compare two semver-like version strings (major.minor.patch, ignoring pre-release suffixes).\n * Returns negative if a < b, 0 if equal, positive if a > b.\n */\nfunction compareVersions(a: string, b: string): number {\n const parseParts = (v: string): [number, number, number] => {\n const core = v.split('-')[0]?.split('+')[0] ?? '';\n const segments = core.split('.').map((s) => Number.parseInt(s, 10));\n return [segments[0] ?? 0, segments[1] ?? 0, segments[2] ?? 0];\n };\n const [aMaj, aMin, aPatch] = parseParts(a);\n const [bMaj, bMin, bPatch] = parseParts(b);\n if (aMaj !== bMaj) return aMaj - bMaj;\n if (aMin !== bMin) return aMin - bMin;\n return aPatch - bPatch;\n}\n\n/** Detect the installed OpenSpec CLI version by running `openspec --version`. */\nexport async function detectOpenSpecVersion(): Promise<{ version: string } | { error: string }> {\n return new Promise((resolve) => {\n // `openspec` is typically a .cmd shim on Windows; `shell: true` lets execFile find it on PATH\n // across platforms without callers needing to know the extension.\n execFile('openspec', ['--version'], { shell: true }, (error, stdout, stderr) => {\n if (error) {\n resolve({\n error: `OpenSpec CLI not found on PATH (run: npm install -g openspec). ${error.message}`,\n });\n return;\n }\n const output = `${stdout}${stderr}`.trim();\n // `openspec --version` prints something like \"1.3.0\" or \"openspec/1.3.0 ...\".\n const match = output.match(/(\\d+\\.\\d+\\.\\d+(?:-[^\\s]+)?)/);\n if (!match?.[1]) {\n resolve({ error: `Could not parse OpenSpec version from output: ${output}` });\n return;\n }\n resolve({ version: match[1] });\n });\n });\n}\n\n/** Check if an OpenSpec workspace exists at the given root (openspec/ directory present). */\nexport async function isOpenSpecWorkspace(root: string): Promise<boolean> {\n return exists(join(root, 'openspec'));\n}\n\n/** Read and parse the existing openspec/config.yaml, or null if it does not exist. */\nexport async function readOpenSpecConfig(root: string): Promise<Record<string, unknown> | null> {\n const path = configPath(root);\n if (!(await exists(path))) return null;\n const text = await readFile(path, 'utf8');\n const parsed = parse(text);\n if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n // An empty or non-mapping file: treat as an empty config so we can merge into it.\n return {};\n }\n return parsed as Record<string, unknown>;\n}\n\n/**\n * Extract the PDaC context block (between sentinels) from a context string, or null if absent.\n */\nfunction extractPdacContext(context: string | undefined): string | null {\n if (!context) return null;\n const begin = context.indexOf(PDAC_CONTEXT_BEGIN);\n const end = context.indexOf(PDAC_CONTEXT_END);\n if (begin === -1 || end === -1 || end < begin) return null;\n return context.slice(begin, end + PDAC_CONTEXT_END.length);\n}\n\n/**\n * Merge PDaC guidance into the OpenSpec config, preserving existing content.\n *\n * - `schema` is preserved as-is.\n * - `context`: if the existing context already contains the PDaC block, it is replaced in place\n * (idempotent); otherwise the PDaC block is appended after a separator. User-authored context\n * lines are never lost.\n * - `rules`: for each PDaC artifact (proposal, specs, design, tasks), PDaC rules are appended to\n * existing rules, deduplicating identical entries.\n * - `operations`: PDaC apply/archive guidance is appended to existing guidance, deduplicating.\n * - Any other fields (githubCopilot, etc.) are preserved untouched.\n *\n * Returns the merged config and a list of human-readable change descriptions.\n */\nexport function mergeConfig(existing: Record<string, unknown> | null): {\n config: Record<string, unknown>;\n changes: string[];\n} {\n const config: Record<string, unknown> = { ...(existing ?? {}) };\n const changes: string[] = [];\n\n // --- context ---\n const existingContext =\n typeof config['context'] === 'string' ? (config['context'] as string) : undefined;\n const existingPdacBlock = extractPdacContext(existingContext);\n if (existingPdacBlock !== null) {\n // Replace the existing PDaC block in place (keeps it idempotent and up to date).\n if (existingPdacBlock !== PDAC_CONTEXT_BLOCK) {\n const replaced = existingContext!.replace(existingPdacBlock, PDAC_CONTEXT_BLOCK);\n if (replaced !== existingContext) {\n config['context'] = replaced;\n changes.push('Updated PDaC context block in openspec/config.yaml (context:).');\n }\n }\n // If identical, no change recorded — idempotent.\n } else if (existingContext) {\n // User has their own context: append the PDaC block after a blank-line separator.\n const separator = existingContext.endsWith('\\n') ? '\\n' : '\\n\\n';\n config['context'] = `${existingContext}${separator}${PDAC_CONTEXT_BLOCK}`;\n changes.push('Appended PDaC context block to existing openspec/config.yaml context:.');\n } else {\n config['context'] = PDAC_CONTEXT_BLOCK;\n changes.push('Added PDaC context block to openspec/config.yaml (context:).');\n }\n\n // --- rules ---\n const existingRules =\n config['rules'] && typeof config['rules'] === 'object' && !Array.isArray(config['rules'])\n ? { ...(config['rules'] as Record<string, unknown>) }\n : {};\n let rulesChanged = false;\n for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {\n const existingList = Array.isArray(existingRules[artifact])\n ? [...(existingRules[artifact] as string[])]\n : [];\n const merged = [...existingList];\n for (const rule of pdacRules) {\n if (!merged.includes(rule)) {\n merged.push(rule);\n rulesChanged = true;\n }\n }\n existingRules[artifact] = merged;\n }\n if (rulesChanged) {\n config['rules'] = existingRules;\n changes.push('Merged PDaC citation rules into openspec/config.yaml (rules:).');\n }\n\n // --- operations ---\n const existingOperations =\n config['operations'] &&\n typeof config['operations'] === 'object' &&\n !Array.isArray(config['operations'])\n ? { ...(config['operations'] as Record<string, unknown>) }\n : {};\n let opsChanged = false;\n for (const opKey of ['apply', 'archive'] as const) {\n const pdacGuidance = PDAC_OPERATIONS[opKey].guidance;\n const existingOp =\n existingOperations[opKey] &&\n typeof existingOperations[opKey] === 'object' &&\n !Array.isArray(existingOperations[opKey])\n ? { ...(existingOperations[opKey] as Record<string, unknown>) }\n : {};\n const existingGuidance = Array.isArray(existingOp['guidance'])\n ? [...(existingOp['guidance'] as string[])]\n : [];\n const merged = [...existingGuidance];\n for (const guidance of pdacGuidance) {\n if (!merged.includes(guidance)) {\n merged.push(guidance);\n opsChanged = true;\n }\n }\n existingOp['guidance'] = merged;\n existingOperations[opKey] = existingOp;\n }\n if (opsChanged) {\n config['operations'] = existingOperations;\n changes.push('Merged PDaC operation guidance into openspec/config.yaml (operations:).');\n }\n\n return { config, changes };\n}\n\n/** Serialize config back to YAML with a trailing newline. */\nexport function serializeConfig(config: Record<string, unknown>): string {\n return `${stringify(config)}\\n`;\n}\n\n/** Read the ProductShape version from the integration-openspec package.json. */\nasync function productshapeVersion(): Promise<string> {\n const packageJson = JSON.parse(\n await readFile(new URL('../package.json', import.meta.url), 'utf8'),\n ) as { version: string };\n return packageJson.version;\n}\n\n/**\n * Add the OpenSpec integration to a repository.\n *\n * - Detects the OpenSpec CLI version; rejects if not found or below MIN_SUPPORTED_OPENSPEC.\n * - Requires an existing `openspec/` workspace (run `openspec init` first).\n * - Merges PDaC guidance into `openspec/config.yaml`, preserving existing user configuration.\n * - Records metadata under `.product/integrations/openspec.json`.\n * - Idempotent: running twice produces the same result.\n * - `--dry-run` reports what would change without writing.\n * - `--force` re-merges even if the PDaC block is already present (useful after a PDaC upgrade).\n */\nexport async function addOpenSpecIntegration(\n root: string,\n options: { force?: boolean; dryRun?: boolean } = {},\n): Promise<{ written: string[]; changes: string[]; meta: OpenSpecIntegrationMeta }> {\n const { force = false, dryRun = false } = options;\n\n const detected = await detectOpenSpecVersion();\n if ('error' in detected) {\n throw new Error(detected.error);\n }\n if (compareVersions(detected.version, MIN_SUPPORTED_OPENSPEC) < 0) {\n throw new Error(\n `OpenSpec CLI version ${detected.version} is below the minimum supported ${MIN_SUPPORTED_OPENSPEC}. Please upgrade OpenSpec.`,\n );\n }\n\n if (!(await isOpenSpecWorkspace(root))) {\n throw new Error('No OpenSpec workspace found. Run `openspec init` first.');\n }\n\n const existing = await readOpenSpecConfig(root);\n\n // Detect a conflicting user context that is NOT the PDaC block and has no room for it.\n // In practice we always append, so a \"conflict\" only arises if the user explicitly removed the\n // PDaC block after a previous install and we are re-adding without --force.\n if (!force && existing) {\n const existingContext =\n typeof existing['context'] === 'string' ? (existing['context'] as string) : undefined;\n if (existingContext && extractPdacContext(existingContext) === null) {\n // The user has context but no PDaC block. We will append, which is safe — not a conflict.\n }\n }\n\n const { config, changes } = mergeConfig(existing);\n\n if (changes.length === 0 && !force) {\n // Already up to date. Still record/refresh metadata.\n const meta: OpenSpecIntegrationMeta = {\n provider: 'openspec',\n version: await productshapeVersion(),\n openspecVersion: detected.version,\n installedAt: new Date().toISOString(),\n configPath: CONFIG_RELATIVE,\n };\n if (!dryRun) {\n await writeMeta(root, meta);\n }\n return { written: [], changes: [], meta };\n }\n\n const written: string[] = [];\n if (!dryRun) {\n const serialized = serializeConfig(config);\n await mkdir(dirname(configPath(root)), { recursive: true });\n await writeFile(configPath(root), serialized, 'utf8');\n written.push(CONFIG_RELATIVE);\n\n const meta: OpenSpecIntegrationMeta = {\n provider: 'openspec',\n version: await productshapeVersion(),\n openspecVersion: detected.version,\n installedAt: new Date().toISOString(),\n configPath: CONFIG_RELATIVE,\n };\n await writeMeta(root, meta);\n written.push(META_RELATIVE);\n }\n\n return {\n written,\n changes,\n meta: {\n provider: 'openspec',\n version: await productshapeVersion(),\n openspecVersion: detected.version,\n installedAt: new Date().toISOString(),\n configPath: CONFIG_RELATIVE,\n },\n };\n}\n\n/** Write the integration metadata file. */\nasync function writeMeta(root: string, meta: OpenSpecIntegrationMeta): Promise<void> {\n const path = metaPath(root);\n await mkdir(dirname(path), { recursive: true });\n await writeFile(path, `${JSON.stringify(meta, null, 2)}\\n`, 'utf8');\n}\n\n/** Read the integration metadata file, or null if absent. */\nasync function readMeta(root: string): Promise<OpenSpecIntegrationMeta | null> {\n const path = metaPath(root);\n if (!(await exists(path))) return null;\n return JSON.parse(await readFile(path, 'utf8')) as OpenSpecIntegrationMeta;\n}\n\n/**\n * Update (re-merge) the OpenSpec integration. Re-runs the merge so that a PDaC upgrade that\n * changed the context block or rules is reflected. Idempotent.\n */\nexport async function updateOpenSpecIntegration(\n root: string,\n options: { force?: boolean; dryRun?: boolean } = {},\n): Promise<{ written: string[]; changes: string[] }> {\n // `add` already re-merges idempotently; `force` ensures the metadata is refreshed even when\n // the config content did not change.\n const result = await addOpenSpecIntegration(root, { force: true, dryRun: options.dryRun });\n return { written: result.written, changes: result.changes };\n}\n\n/**\n * Check the OpenSpec integration health. Verifies:\n * - OpenSpec CLI is installed and the version is supported.\n * - `openspec/config.yaml` exists and contains the PDaC context block.\n * - `.product/integrations/openspec.json` metadata exists.\n * - The config's PDaC block matches the current PDaC guidance (not removed or altered).\n */\nexport async function checkOpenSpecIntegration(root: string): Promise<{\n ok: boolean;\n checks: { name: string; ok: boolean; detail: string }[];\n}> {\n const checks: { name: string; ok: boolean; detail: string }[] = [];\n\n // 1. OpenSpec CLI installed and supported.\n const detected = await detectOpenSpecVersion();\n if ('error' in detected) {\n checks.push({ name: 'openspec CLI', ok: false, detail: detected.error });\n } else if (compareVersions(detected.version, MIN_SUPPORTED_OPENSPEC) < 0) {\n checks.push({\n name: 'openspec CLI',\n ok: false,\n detail: `OpenSpec ${detected.version} is below minimum supported ${MIN_SUPPORTED_OPENSPEC}.`,\n });\n } else {\n checks.push({\n name: 'openspec CLI',\n ok: true,\n detail: `OpenSpec ${detected.version} detected.`,\n });\n }\n\n // 2. openspec/config.yaml exists and contains PDaC context.\n const config = await readOpenSpecConfig(root);\n if (config === null) {\n checks.push({\n name: 'config.yaml',\n ok: false,\n detail: 'openspec/config.yaml not found. Run: prodshape integration add openspec',\n });\n } else {\n const context =\n typeof config['context'] === 'string' ? (config['context'] as string) : undefined;\n const pdacBlock = extractPdacContext(context);\n if (pdacBlock === null) {\n checks.push({\n name: 'config.yaml',\n ok: false,\n detail:\n 'PDaC context block missing from openspec/config.yaml. Run: prodshape integration add openspec',\n });\n } else if (pdacBlock !== PDAC_CONTEXT_BLOCK) {\n checks.push({\n name: 'config.yaml',\n ok: false,\n detail:\n 'PDaC context block in openspec/config.yaml is outdated. Run: prodshape integration update',\n });\n } else {\n checks.push({\n name: 'config.yaml',\n ok: true,\n detail: 'PDaC context block present and current.',\n });\n }\n }\n\n // 3. Metadata file exists.\n const meta = await readMeta(root);\n if (meta === null) {\n checks.push({\n name: 'metadata',\n ok: false,\n detail:\n '.product/integrations/openspec.json not found. Run: prodshape integration add openspec',\n });\n } else {\n checks.push({\n name: 'metadata',\n ok: true,\n detail: `Integration recorded (OpenSpec ${meta.openspecVersion}, installed ${meta.installedAt}).`,\n });\n }\n\n // 4. PDaC rules present.\n if (config) {\n const rules =\n config['rules'] && typeof config['rules'] === 'object' && !Array.isArray(config['rules'])\n ? (config['rules'] as Record<string, unknown>)\n : {};\n const missingRules: string[] = [];\n for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {\n const list = Array.isArray(rules[artifact]) ? (rules[artifact] as string[]) : [];\n for (const rule of pdacRules) {\n if (!list.includes(rule)) missingRules.push(artifact);\n }\n }\n if (missingRules.length > 0) {\n checks.push({\n name: 'rules',\n ok: false,\n detail: `PDaC rules missing for: ${[...new Set(missingRules)].join(', ')}. Run: prodshape integration update`,\n });\n } else {\n checks.push({ name: 'rules', ok: true, detail: 'All PDaC citation rules present.' });\n }\n }\n\n const ok = checks.every((c) => c.ok);\n return { ok, checks };\n}\n\n/**\n * Remove the PDaC-injected content from openspec/config.yaml, preserving user-authored content,\n * and delete the metadata file.\n *\n * - Removes the PDaC context block (between sentinels) from `context:`.\n * - Removes PDaC rules from each artifact (keeps user-authored rules).\n * - Removes PDaC operation guidance (keeps user-authored guidance).\n * - Deletes `.product/integrations/openspec.json`.\n * - `--dry-run` reports what would be removed without writing.\n */\nexport async function removeOpenSpecIntegration(\n root: string,\n options: { dryRun?: boolean } = {},\n): Promise<{ removed: string[] }> {\n const { dryRun = false } = options;\n const removed: string[] = [];\n\n const config = await readOpenSpecConfig(root);\n if (config !== null) {\n let configChanged = false;\n\n // Remove PDaC context block.\n const context =\n typeof config['context'] === 'string' ? (config['context'] as string) : undefined;\n if (context) {\n const pdacBlock = extractPdacContext(context);\n if (pdacBlock !== null) {\n const cleaned = context\n .replace(pdacBlock, '')\n .replace(/\\n{3,}/g, '\\n\\n')\n .trimEnd();\n if (cleaned === '') {\n delete config['context'];\n } else {\n config['context'] = cleaned;\n }\n configChanged = true;\n }\n }\n\n // Remove PDaC rules from each artifact.\n const rules =\n config['rules'] && typeof config['rules'] === 'object' && !Array.isArray(config['rules'])\n ? (config['rules'] as Record<string, unknown>)\n : null;\n if (rules) {\n let rulesChanged = false;\n for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {\n if (!Array.isArray(rules[artifact])) continue;\n const list = rules[artifact] as string[];\n const filtered = list.filter((r) => !pdacRules.includes(r));\n if (filtered.length !== list.length) {\n if (filtered.length === 0) {\n delete rules[artifact];\n } else {\n rules[artifact] = filtered;\n }\n rulesChanged = true;\n }\n }\n if (rulesChanged) {\n if (Object.keys(rules).length === 0) {\n delete config['rules'];\n }\n configChanged = true;\n }\n }\n\n // Remove PDaC operation guidance.\n const operations =\n config['operations'] &&\n typeof config['operations'] === 'object' &&\n !Array.isArray(config['operations'])\n ? (config['operations'] as Record<string, unknown>)\n : null;\n if (operations) {\n let opsChanged = false;\n for (const opKey of ['apply', 'archive'] as const) {\n const pdacGuidance = PDAC_OPERATIONS[opKey].guidance;\n const op =\n operations[opKey] &&\n typeof operations[opKey] === 'object' &&\n !Array.isArray(operations[opKey])\n ? (operations[opKey] as Record<string, unknown>)\n : null;\n if (!op || !Array.isArray(op['guidance'])) continue;\n const list = op['guidance'] as string[];\n const filtered = list.filter((g) => !pdacGuidance.includes(g));\n if (filtered.length !== list.length) {\n if (filtered.length === 0) {\n delete op['guidance'];\n } else {\n op['guidance'] = filtered;\n }\n opsChanged = true;\n }\n if (Object.keys(op).length === 0) {\n delete operations[opKey];\n }\n }\n if (opsChanged) {\n if (Object.keys(operations).length === 0) {\n delete config['operations'];\n }\n configChanged = true;\n }\n }\n\n if (configChanged && !dryRun) {\n const serialized = serializeConfig(config);\n await writeFile(configPath(root), serialized, 'utf8');\n removed.push(CONFIG_RELATIVE);\n } else if (configChanged && dryRun) {\n removed.push(CONFIG_RELATIVE);\n }\n }\n\n // Remove metadata file.\n if (await exists(metaPath(root))) {\n if (!dryRun) {\n await rm(metaPath(root), { force: true });\n }\n removed.push(META_RELATIVE);\n }\n\n return { removed };\n}\n"],"mappings":"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","names":[]}

package/package.json ADDED Viewed

@@ -0,0 +1,36 @@
+{
+  "name": "@prodshape/integration-openspec",
+  "version": "0.1.0",
+  "description": "OpenSpec integration for Product Definition as Code: configures OpenSpec workspaces with PDaC citation rules and verifies citations against the OpenSpec population.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/juangcarmona/productshape.git",
+    "directory": "packages/integration-openspec"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "yaml": "^2.5.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0"
+  }
+}

package/src/index.ts ADDED Viewed

@@ -0,0 +1,651 @@
+/**
+ * OpenSpec integration for Product Definition as Code.
+ *
+ * This module configures an existing OpenSpec workspace with PDaC citation rules by merging
+ * guidance into `openspec/config.yaml`, and records metadata under `.product/integrations/`.
+ * It never creates an OpenSpec plugin, never patches OpenSpec-generated commands or skills, and
+ * never forks OpenSpec's default schema. The integration is configuration + deterministic
+ * verification: consumer documents cite canonical product artifacts by id + digest, and
+ * `prodshape citations verify` checks them.
+ *
+ * The merge logic is the heart of this module: it preserves every field the user authored
+ * (schema, context, rules, operations, githubCopilot, and anything else) and only appends PDaC
+ * guidance, deduplicating identical entries so the operation is idempotent.
+ */
+import { execFile } from 'node:child_process';
+import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { parse, stringify } from 'yaml';
+/** The minimum supported OpenSpec CLI version. */
+export const MIN_SUPPORTED_OPENSPEC = '1.0.0';
+/**
+ * Sentinel markers that bracket the PDaC-injected context block. They let `mergeConfig` find
+ * and replace exactly the PDaC portion without touching user-authored context lines.
+ */
+const PDAC_CONTEXT_BEGIN = '<!-- pdac:context begin -->';
+const PDAC_CONTEXT_END = '<!-- pdac:context end -->';
+/** The PDaC authority context block injected into openspec/config.yaml `context:`. */
+export const PDAC_CONTEXT_BLOCK = `${PDAC_CONTEXT_BEGIN}
+This repository uses Product Definition as Code (PDaC). The canonical product definition lives in docs/product/model (actors, journeys, use cases, business rules, domain terms, requirements) and is the single source of truth for product behaviour. OpenSpec artifacts are downstream consumers of it, never a second source of truth.
+Consumers bind to canonical text through the PDaC Citation Contract: a citation records the target artifact id, a sha256 content digest, and an optional verification scenario anchor. Verification reports one status per citation: current, stale, tampered or unresolved.
+To cite: run \`npx prodshape inspect <ID>\` to read the current digest, then \`npx prodshape cite --id <ID> --digest <digest>\` to emit the citation record. Place inline citations on their own line directly under the text they ground.
+The product definition changes only through a Product Change under docs/product/changes/. OpenSpec changes never edit docs/product/model directly.
+${PDAC_CONTEXT_END}`;
+/** The PDaC citation rules injected per artifact into openspec/config.yaml `rules:`. */
+export const PDAC_RULES: Record<string, string[]> = {
+  proposal: [
+    'State which PDaC artifacts this change touches, each with an inline citation emitted by `npx prodshape cite --id <ID> --digest <digest>`. Never write a citation record by hand.',
+    'If the change alters product behaviour, name the Product Change (CHG id) it implements. If no Product Change exists yet, stop and ask for one instead of proceeding.',
+  ],
+  specs: [
+    'Every requirement derived from canonical product text MUST carry a citation to every PDaC artifact it derives from, one citation per line, placed after the requirement text and before the first scenario. A requirement often derives from more than one artifact; citing only the closest one silently hides the other derivations. Never place citations between the requirement heading and the requirement text; OpenSpec reads the first paragraph as the requirement.',
+    'Cite a specific verification scenario with an anchor when the requirement maps to one (anchor="<scenario id>").',
+    'Never paraphrase canonical text as if it were new; either cite it inline or embed it in a marker-block citation (<!-- pdac:cite ... --> canonical text <!-- /pdac:cite -->).',
+    'Never invent artifact ids or digests. Read them with `npx prodshape inspect <ID>`.',
+  ],
+  design: [
+    'When a design decision depends on canonical product text, cite the artifact it depends on.',
+  ],
+  tasks: [
+    'A task that changes cited behaviour must include a follow-up task to refresh the affected citations.',
+  ],
+};
+/** The PDaC operation guidance injected into openspec/config.yaml `operations:`. */
+export const PDAC_OPERATIONS: {
+  apply: { guidance: string[] };
+  archive: { guidance: string[] };
+} = {
+  apply: {
+    guidance: [
+      'Before finishing, run `npx prodshape citations verify` and fix every stale, tampered or unresolved citation. Refresh a stale digest by re-running `npx prodshape inspect <ID>`; never delete a citation to silence a diagnostic.',
+    ],
+  },
+  archive: {
+    guidance: [
+      'Run `npx prodshape citations verify` one final time. Archive only when every citation is current.',
+    ],
+  },
+};
+/** Metadata recorded under .product/integrations/openspec.json. */
+export interface OpenSpecIntegrationMeta {
+  provider: 'openspec';
+  version: string;
+  openspecVersion: string;
+  installedAt: string;
+  configPath: string;
+}
+/** Repository-relative paths used by this integration. */
+const CONFIG_RELATIVE = 'openspec/config.yaml';
+const META_RELATIVE = '.product/integrations/openspec.json';
+function configPath(root: string): string {
+  return join(root, ...CONFIG_RELATIVE.split('/'));
+}
+function metaPath(root: string): string {
+  return join(root, ...META_RELATIVE.split('/'));
+}
+async function exists(path: string): Promise<boolean> {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+/**
+ * Compare two semver-like version strings (major.minor.patch, ignoring pre-release suffixes).
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+function compareVersions(a: string, b: string): number {
+  const parseParts = (v: string): [number, number, number] => {
+    const core = v.split('-')[0]?.split('+')[0] ?? '';
+    const segments = core.split('.').map((s) => Number.parseInt(s, 10));
+    return [segments[0] ?? 0, segments[1] ?? 0, segments[2] ?? 0];
+  };
+  const [aMaj, aMin, aPatch] = parseParts(a);
+  const [bMaj, bMin, bPatch] = parseParts(b);
+  if (aMaj !== bMaj) return aMaj - bMaj;
+  if (aMin !== bMin) return aMin - bMin;
+  return aPatch - bPatch;
+}
+/** Detect the installed OpenSpec CLI version by running `openspec --version`. */
+export async function detectOpenSpecVersion(): Promise<{ version: string } | { error: string }> {
+  return new Promise((resolve) => {
+    // `openspec` is typically a .cmd shim on Windows; `shell: true` lets execFile find it on PATH
+    // across platforms without callers needing to know the extension.
+    execFile('openspec', ['--version'], { shell: true }, (error, stdout, stderr) => {
+      if (error) {
+        resolve({
+          error: `OpenSpec CLI not found on PATH (run: npm install -g openspec). ${error.message}`,
+        });
+        return;
+      }
+      const output = `${stdout}${stderr}`.trim();
+      // `openspec --version` prints something like "1.3.0" or "openspec/1.3.0 ...".
+      const match = output.match(/(\d+\.\d+\.\d+(?:-[^\s]+)?)/);
+      if (!match?.[1]) {
+        resolve({ error: `Could not parse OpenSpec version from output: ${output}` });
+        return;
+      }
+      resolve({ version: match[1] });
+    });
+  });
+}
+/** Check if an OpenSpec workspace exists at the given root (openspec/ directory present). */
+export async function isOpenSpecWorkspace(root: string): Promise<boolean> {
+  return exists(join(root, 'openspec'));
+}
+/** Read and parse the existing openspec/config.yaml, or null if it does not exist. */
+export async function readOpenSpecConfig(root: string): Promise<Record<string, unknown> | null> {
+  const path = configPath(root);
+  if (!(await exists(path))) return null;
+  const text = await readFile(path, 'utf8');
+  const parsed = parse(text);
+  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    // An empty or non-mapping file: treat as an empty config so we can merge into it.
+    return {};
+  }
+  return parsed as Record<string, unknown>;
+}
+/**
+ * Extract the PDaC context block (between sentinels) from a context string, or null if absent.
+ */
+function extractPdacContext(context: string | undefined): string | null {
+  if (!context) return null;
+  const begin = context.indexOf(PDAC_CONTEXT_BEGIN);
+  const end = context.indexOf(PDAC_CONTEXT_END);
+  if (begin === -1 || end === -1 || end < begin) return null;
+  return context.slice(begin, end + PDAC_CONTEXT_END.length);
+}
+/**
+ * Merge PDaC guidance into the OpenSpec config, preserving existing content.
+ *
+ * - `schema` is preserved as-is.
+ * - `context`: if the existing context already contains the PDaC block, it is replaced in place
+ *   (idempotent); otherwise the PDaC block is appended after a separator. User-authored context
+ *   lines are never lost.
+ * - `rules`: for each PDaC artifact (proposal, specs, design, tasks), PDaC rules are appended to
+ *   existing rules, deduplicating identical entries.
+ * - `operations`: PDaC apply/archive guidance is appended to existing guidance, deduplicating.
+ * - Any other fields (githubCopilot, etc.) are preserved untouched.
+ *
+ * Returns the merged config and a list of human-readable change descriptions.
+ */
+export function mergeConfig(existing: Record<string, unknown> | null): {
+  config: Record<string, unknown>;
+  changes: string[];
+} {
+  const config: Record<string, unknown> = { ...(existing ?? {}) };
+  const changes: string[] = [];
+  // --- context ---
+  const existingContext =
+    typeof config['context'] === 'string' ? (config['context'] as string) : undefined;
+  const existingPdacBlock = extractPdacContext(existingContext);
+  if (existingPdacBlock !== null) {
+    // Replace the existing PDaC block in place (keeps it idempotent and up to date).
+    if (existingPdacBlock !== PDAC_CONTEXT_BLOCK) {
+      const replaced = existingContext!.replace(existingPdacBlock, PDAC_CONTEXT_BLOCK);
+      if (replaced !== existingContext) {
+        config['context'] = replaced;
+        changes.push('Updated PDaC context block in openspec/config.yaml (context:).');
+      }
+    }
+    // If identical, no change recorded — idempotent.
+  } else if (existingContext) {
+    // User has their own context: append the PDaC block after a blank-line separator.
+    const separator = existingContext.endsWith('\n') ? '\n' : '\n\n';
+    config['context'] = `${existingContext}${separator}${PDAC_CONTEXT_BLOCK}`;
+    changes.push('Appended PDaC context block to existing openspec/config.yaml context:.');
+  } else {
+    config['context'] = PDAC_CONTEXT_BLOCK;
+    changes.push('Added PDaC context block to openspec/config.yaml (context:).');
+  }
+  // --- rules ---
+  const existingRules =
+    config['rules'] && typeof config['rules'] === 'object' && !Array.isArray(config['rules'])
+      ? { ...(config['rules'] as Record<string, unknown>) }
+      : {};
+  let rulesChanged = false;
+  for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {
+    const existingList = Array.isArray(existingRules[artifact])
+      ? [...(existingRules[artifact] as string[])]
+      : [];
+    const merged = [...existingList];
+    for (const rule of pdacRules) {
+      if (!merged.includes(rule)) {
+        merged.push(rule);
+        rulesChanged = true;
+      }
+    }
+    existingRules[artifact] = merged;
+  }
+  if (rulesChanged) {
+    config['rules'] = existingRules;
+    changes.push('Merged PDaC citation rules into openspec/config.yaml (rules:).');
+  }
+  // --- operations ---
+  const existingOperations =
+    config['operations'] &&
+    typeof config['operations'] === 'object' &&
+    !Array.isArray(config['operations'])
+      ? { ...(config['operations'] as Record<string, unknown>) }
+      : {};
+  let opsChanged = false;
+  for (const opKey of ['apply', 'archive'] as const) {
+    const pdacGuidance = PDAC_OPERATIONS[opKey].guidance;
+    const existingOp =
+      existingOperations[opKey] &&
+      typeof existingOperations[opKey] === 'object' &&
+      !Array.isArray(existingOperations[opKey])
+        ? { ...(existingOperations[opKey] as Record<string, unknown>) }
+        : {};
+    const existingGuidance = Array.isArray(existingOp['guidance'])
+      ? [...(existingOp['guidance'] as string[])]
+      : [];
+    const merged = [...existingGuidance];
+    for (const guidance of pdacGuidance) {
+      if (!merged.includes(guidance)) {
+        merged.push(guidance);
+        opsChanged = true;
+      }
+    }
+    existingOp['guidance'] = merged;
+    existingOperations[opKey] = existingOp;
+  }
+  if (opsChanged) {
+    config['operations'] = existingOperations;
+    changes.push('Merged PDaC operation guidance into openspec/config.yaml (operations:).');
+  }
+  return { config, changes };
+}
+/** Serialize config back to YAML with a trailing newline. */
+export function serializeConfig(config: Record<string, unknown>): string {
+  return `${stringify(config)}\n`;
+}
+/** Read the ProductShape version from the integration-openspec package.json. */
+async function productshapeVersion(): Promise<string> {
+  const packageJson = JSON.parse(
+    await readFile(new URL('../package.json', import.meta.url), 'utf8'),
+  ) as { version: string };
+  return packageJson.version;
+}
+/**
+ * Add the OpenSpec integration to a repository.
+ *
+ * - Detects the OpenSpec CLI version; rejects if not found or below MIN_SUPPORTED_OPENSPEC.
+ * - Requires an existing `openspec/` workspace (run `openspec init` first).
+ * - Merges PDaC guidance into `openspec/config.yaml`, preserving existing user configuration.
+ * - Records metadata under `.product/integrations/openspec.json`.
+ * - Idempotent: running twice produces the same result.
+ * - `--dry-run` reports what would change without writing.
+ * - `--force` re-merges even if the PDaC block is already present (useful after a PDaC upgrade).
+ */
+export async function addOpenSpecIntegration(
+  root: string,
+  options: { force?: boolean; dryRun?: boolean } = {},
+): Promise<{ written: string[]; changes: string[]; meta: OpenSpecIntegrationMeta }> {
+  const { force = false, dryRun = false } = options;
+  const detected = await detectOpenSpecVersion();
+  if ('error' in detected) {
+    throw new Error(detected.error);
+  }
+  if (compareVersions(detected.version, MIN_SUPPORTED_OPENSPEC) < 0) {
+    throw new Error(
+      `OpenSpec CLI version ${detected.version} is below the minimum supported ${MIN_SUPPORTED_OPENSPEC}. Please upgrade OpenSpec.`,
+    );
+  }
+  if (!(await isOpenSpecWorkspace(root))) {
+    throw new Error('No OpenSpec workspace found. Run `openspec init` first.');
+  }
+  const existing = await readOpenSpecConfig(root);
+  // Detect a conflicting user context that is NOT the PDaC block and has no room for it.
+  // In practice we always append, so a "conflict" only arises if the user explicitly removed the
+  // PDaC block after a previous install and we are re-adding without --force.
+  if (!force && existing) {
+    const existingContext =
+      typeof existing['context'] === 'string' ? (existing['context'] as string) : undefined;
+    if (existingContext && extractPdacContext(existingContext) === null) {
+      // The user has context but no PDaC block. We will append, which is safe — not a conflict.
+    }
+  }
+  const { config, changes } = mergeConfig(existing);
+  if (changes.length === 0 && !force) {
+    // Already up to date. Still record/refresh metadata.
+    const meta: OpenSpecIntegrationMeta = {
+      provider: 'openspec',
+      version: await productshapeVersion(),
+      openspecVersion: detected.version,
+      installedAt: new Date().toISOString(),
+      configPath: CONFIG_RELATIVE,
+    };
+    if (!dryRun) {
+      await writeMeta(root, meta);
+    }
+    return { written: [], changes: [], meta };
+  }
+  const written: string[] = [];
+  if (!dryRun) {
+    const serialized = serializeConfig(config);
+    await mkdir(dirname(configPath(root)), { recursive: true });
+    await writeFile(configPath(root), serialized, 'utf8');
+    written.push(CONFIG_RELATIVE);
+    const meta: OpenSpecIntegrationMeta = {
+      provider: 'openspec',
+      version: await productshapeVersion(),
+      openspecVersion: detected.version,
+      installedAt: new Date().toISOString(),
+      configPath: CONFIG_RELATIVE,
+    };
+    await writeMeta(root, meta);
+    written.push(META_RELATIVE);
+  }
+  return {
+    written,
+    changes,
+    meta: {
+      provider: 'openspec',
+      version: await productshapeVersion(),
+      openspecVersion: detected.version,
+      installedAt: new Date().toISOString(),
+      configPath: CONFIG_RELATIVE,
+    },
+  };
+}
+/** Write the integration metadata file. */
+async function writeMeta(root: string, meta: OpenSpecIntegrationMeta): Promise<void> {
+  const path = metaPath(root);
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, `${JSON.stringify(meta, null, 2)}\n`, 'utf8');
+}
+/** Read the integration metadata file, or null if absent. */
+async function readMeta(root: string): Promise<OpenSpecIntegrationMeta | null> {
+  const path = metaPath(root);
+  if (!(await exists(path))) return null;
+  return JSON.parse(await readFile(path, 'utf8')) as OpenSpecIntegrationMeta;
+}
+/**
+ * Update (re-merge) the OpenSpec integration. Re-runs the merge so that a PDaC upgrade that
+ * changed the context block or rules is reflected. Idempotent.
+ */
+export async function updateOpenSpecIntegration(
+  root: string,
+  options: { force?: boolean; dryRun?: boolean } = {},
+): Promise<{ written: string[]; changes: string[] }> {
+  // `add` already re-merges idempotently; `force` ensures the metadata is refreshed even when
+  // the config content did not change.
+  const result = await addOpenSpecIntegration(root, { force: true, dryRun: options.dryRun });
+  return { written: result.written, changes: result.changes };
+}
+/**
+ * Check the OpenSpec integration health. Verifies:
+ * - OpenSpec CLI is installed and the version is supported.
+ * - `openspec/config.yaml` exists and contains the PDaC context block.
+ * - `.product/integrations/openspec.json` metadata exists.
+ * - The config's PDaC block matches the current PDaC guidance (not removed or altered).
+ */
+export async function checkOpenSpecIntegration(root: string): Promise<{
+  ok: boolean;
+  checks: { name: string; ok: boolean; detail: string }[];
+}> {
+  const checks: { name: string; ok: boolean; detail: string }[] = [];
+  // 1. OpenSpec CLI installed and supported.
+  const detected = await detectOpenSpecVersion();
+  if ('error' in detected) {
+    checks.push({ name: 'openspec CLI', ok: false, detail: detected.error });
+  } else if (compareVersions(detected.version, MIN_SUPPORTED_OPENSPEC) < 0) {
+    checks.push({
+      name: 'openspec CLI',
+      ok: false,
+      detail: `OpenSpec ${detected.version} is below minimum supported ${MIN_SUPPORTED_OPENSPEC}.`,
+    });
+  } else {
+    checks.push({
+      name: 'openspec CLI',
+      ok: true,
+      detail: `OpenSpec ${detected.version} detected.`,
+    });
+  }
+  // 2. openspec/config.yaml exists and contains PDaC context.
+  const config = await readOpenSpecConfig(root);
+  if (config === null) {
+    checks.push({
+      name: 'config.yaml',
+      ok: false,
+      detail: 'openspec/config.yaml not found. Run: prodshape integration add openspec',
+    });
+  } else {
+    const context =
+      typeof config['context'] === 'string' ? (config['context'] as string) : undefined;
+    const pdacBlock = extractPdacContext(context);
+    if (pdacBlock === null) {
+      checks.push({
+        name: 'config.yaml',
+        ok: false,
+        detail:
+          'PDaC context block missing from openspec/config.yaml. Run: prodshape integration add openspec',
+      });
+    } else if (pdacBlock !== PDAC_CONTEXT_BLOCK) {
+      checks.push({
+        name: 'config.yaml',
+        ok: false,
+        detail:
+          'PDaC context block in openspec/config.yaml is outdated. Run: prodshape integration update',
+      });
+    } else {
+      checks.push({
+        name: 'config.yaml',
+        ok: true,
+        detail: 'PDaC context block present and current.',
+      });
+    }
+  }
+  // 3. Metadata file exists.
+  const meta = await readMeta(root);
+  if (meta === null) {
+    checks.push({
+      name: 'metadata',
+      ok: false,
+      detail:
+        '.product/integrations/openspec.json not found. Run: prodshape integration add openspec',
+    });
+  } else {
+    checks.push({
+      name: 'metadata',
+      ok: true,
+      detail: `Integration recorded (OpenSpec ${meta.openspecVersion}, installed ${meta.installedAt}).`,
+    });
+  }
+  // 4. PDaC rules present.
+  if (config) {
+    const rules =
+      config['rules'] && typeof config['rules'] === 'object' && !Array.isArray(config['rules'])
+        ? (config['rules'] as Record<string, unknown>)
+        : {};
+    const missingRules: string[] = [];
+    for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {
+      const list = Array.isArray(rules[artifact]) ? (rules[artifact] as string[]) : [];
+      for (const rule of pdacRules) {
+        if (!list.includes(rule)) missingRules.push(artifact);
+      }
+    }
+    if (missingRules.length > 0) {
+      checks.push({
+        name: 'rules',
+        ok: false,
+        detail: `PDaC rules missing for: ${[...new Set(missingRules)].join(', ')}. Run: prodshape integration update`,
+      });
+    } else {
+      checks.push({ name: 'rules', ok: true, detail: 'All PDaC citation rules present.' });
+    }
+  }
+  const ok = checks.every((c) => c.ok);
+  return { ok, checks };
+}
+/**
+ * Remove the PDaC-injected content from openspec/config.yaml, preserving user-authored content,
+ * and delete the metadata file.
+ *
+ * - Removes the PDaC context block (between sentinels) from `context:`.
+ * - Removes PDaC rules from each artifact (keeps user-authored rules).
+ * - Removes PDaC operation guidance (keeps user-authored guidance).
+ * - Deletes `.product/integrations/openspec.json`.
+ * - `--dry-run` reports what would be removed without writing.
+ */
+export async function removeOpenSpecIntegration(
+  root: string,
+  options: { dryRun?: boolean } = {},
+): Promise<{ removed: string[] }> {
+  const { dryRun = false } = options;
+  const removed: string[] = [];
+  const config = await readOpenSpecConfig(root);
+  if (config !== null) {
+    let configChanged = false;
+    // Remove PDaC context block.
+    const context =
+      typeof config['context'] === 'string' ? (config['context'] as string) : undefined;
+    if (context) {
+      const pdacBlock = extractPdacContext(context);
+      if (pdacBlock !== null) {
+        const cleaned = context
+          .replace(pdacBlock, '')
+          .replace(/\n{3,}/g, '\n\n')
+          .trimEnd();
+        if (cleaned === '') {
+          delete config['context'];
+        } else {
+          config['context'] = cleaned;
+        }
+        configChanged = true;
+      }
+    }
+    // Remove PDaC rules from each artifact.
+    const rules =
+      config['rules'] && typeof config['rules'] === 'object' && !Array.isArray(config['rules'])
+        ? (config['rules'] as Record<string, unknown>)
+        : null;
+    if (rules) {
+      let rulesChanged = false;
+      for (const [artifact, pdacRules] of Object.entries(PDAC_RULES)) {
+        if (!Array.isArray(rules[artifact])) continue;
+        const list = rules[artifact] as string[];
+        const filtered = list.filter((r) => !pdacRules.includes(r));
+        if (filtered.length !== list.length) {
+          if (filtered.length === 0) {
+            delete rules[artifact];
+          } else {
+            rules[artifact] = filtered;
+          }
+          rulesChanged = true;
+        }
+      }
+      if (rulesChanged) {
+        if (Object.keys(rules).length === 0) {
+          delete config['rules'];
+        }
+        configChanged = true;
+      }
+    }
+    // Remove PDaC operation guidance.
+    const operations =
+      config['operations'] &&
+      typeof config['operations'] === 'object' &&
+      !Array.isArray(config['operations'])
+        ? (config['operations'] as Record<string, unknown>)
+        : null;
+    if (operations) {
+      let opsChanged = false;
+      for (const opKey of ['apply', 'archive'] as const) {
+        const pdacGuidance = PDAC_OPERATIONS[opKey].guidance;
+        const op =
+          operations[opKey] &&
+          typeof operations[opKey] === 'object' &&
+          !Array.isArray(operations[opKey])
+            ? (operations[opKey] as Record<string, unknown>)
+            : null;
+        if (!op || !Array.isArray(op['guidance'])) continue;
+        const list = op['guidance'] as string[];
+        const filtered = list.filter((g) => !pdacGuidance.includes(g));
+        if (filtered.length !== list.length) {
+          if (filtered.length === 0) {
+            delete op['guidance'];
+          } else {
+            op['guidance'] = filtered;
+          }
+          opsChanged = true;
+        }
+        if (Object.keys(op).length === 0) {
+          delete operations[opKey];
+        }
+      }
+      if (opsChanged) {
+        if (Object.keys(operations).length === 0) {
+          delete config['operations'];
+        }
+        configChanged = true;
+      }
+    }
+    if (configChanged && !dryRun) {
+      const serialized = serializeConfig(config);
+      await writeFile(configPath(root), serialized, 'utf8');
+      removed.push(CONFIG_RELATIVE);
+    } else if (configChanged && dryRun) {
+      removed.push(CONFIG_RELATIVE);
+    }
+  }
+  // Remove metadata file.
+  if (await exists(metaPath(root))) {
+    if (!dryRun) {
+      await rm(metaPath(root), { force: true });
+    }
+    removed.push(META_RELATIVE);
+  }
+  return { removed };
+}