@ybotok/loam 0.1.0-beta.3 → 0.2.0-alpha.13

package/dist/core/openspec/scan/changes.js

@@ -0,0 +1,241 @@
+/**
+ * One `changes/<id>/` directory read end to end: its metadata, its spec files,
+ * and every artifact it holds.
+ *
+ * Active and archived changes come through the same reader with a different
+ * scope, because they are the same shape and only the consequences differ — an
+ * archive finding is a diagnostic, an active one blocks. Keeping that in the
+ * scope rather than in two readers is what stops the two drifting into two
+ * ideas of what a change looks like.
+ */
+import { existsSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { asRecord, isStringArray } from "../../kernel/records.js";
+import { compareIds } from "../../repo/entries.js";
+import { inspectSpecFile } from "./shape.js";
+import {} from "../model/model.js";
+import { schemaSpecPolicy } from "./config.js";
+import { isSymbolicLink, portable, sourceInventoryPath, walkTree, yamlRecord, } from "./walk.js";
+import { addCounts, issue } from "./shape.js";
+import {} from "./workspace.js";
+/**
+ * A calendar date, optionally with a time. OpenSpec's template writes the plain
+ * date, but a timestamp is still a date — and rejecting it blocked every change
+ * and every capability in the workspace over one field nobody reads, fixable
+ * only by editing the source migration promises not to touch.
+ */
+const CHANGE_CREATED_RE = /^\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+export async function inspectChangeMetadata(ingest, dir, scope, fallbackSchema) {
+    const { root, unsupported } = ingest;
+    const absolute = join(dir, ".openspec.yaml");
+    if (!existsSync(absolute)) {
+        return { path: null, schema: fallbackSchema, skipSpecs: false, created: null, fields: [] };
+    }
+    const path = portable(root, absolute);
+    if (await isSymbolicLink(absolute)) {
+        return { path, schema: fallbackSchema, skipSpecs: false, created: null, fields: [] };
+    }
+    try {
+        const metadata = await yamlRecord(absolute);
+        let valid = true;
+        const invalid = (message) => {
+            valid = false;
+            issue(unsupported, scope, {
+                code: "openspec.change-metadata-invalid",
+                path: path,
+                message: message,
+            });
+        };
+        const schema = typeof metadata.schema === "string" && metadata.schema.trim() !== ""
+            ? metadata.schema.trim()
+            : null;
+        if (schema === null) {
+            invalid("Present .openspec.yaml metadata requires a non-empty string schema; fallback applies only when the file is absent.");
+        }
+        if ("skip_specs" in metadata && typeof metadata.skip_specs !== "boolean") {
+            invalid("skip_specs must be a boolean when present.");
+        }
+        if ("created" in metadata
+            && (typeof metadata.created !== "string" || !CHANGE_CREATED_RE.test(metadata.created))) {
+            invalid("created must be a string date in YYYY-MM-DD or ISO-8601 date-time form when present.");
+        }
+        if ("goal" in metadata && (typeof metadata.goal !== "string" || metadata.goal.length === 0)) {
+            invalid("goal must be a non-empty string when present.");
+        }
+        if ("affected_areas" in metadata
+            && (!isStringArray(metadata.affected_areas)
+                || metadata.affected_areas.some((value) => value.length === 0))) {
+            invalid("affected_areas must be an array of non-empty strings when present.");
+        }
+        if ("initiative" in metadata) {
+            const initiative = asRecord(metadata.initiative);
+            const keys = initiative === null ? [] : Object.keys(initiative).sort(compareIds);
+            const kebabId = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+            if (initiative === null
+                || keys.length !== 2
+                || keys[0] !== "id"
+                || keys[1] !== "store"
+                || typeof initiative.id !== "string"
+                || !kebabId.test(initiative.id)
+                || typeof initiative.store !== "string"
+                || !kebabId.test(initiative.store)) {
+                invalid("initiative must be exactly { store, id }, with both values portable kebab-case identifiers.");
+            }
+        }
+        return {
+            path,
+            schema,
+            skipSpecs: valid && schema !== null && metadata.skip_specs === true,
+            created: typeof metadata.created === "string" && CHANGE_CREATED_RE.test(metadata.created)
+                ? metadata.created
+                : null,
+            fields: Object.keys(metadata).sort(compareIds),
+        };
+    }
+    catch (error) {
+        issue(unsupported, scope, {
+            code: "openspec.change-metadata-invalid",
+            path: path,
+            message: `Change metadata is invalid: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        return { path, schema: fallbackSchema, skipSpecs: false, created: null, fields: [] };
+    }
+}
+export async function inventoryChanges(ingest, tree) {
+    const { base, ids, scope, fallbackSchema, findings: unsupported } = tree;
+    const { root } = ingest;
+    const scoped = { ...ingest, unsupported };
+    const changes = [];
+    for (const id of ids) {
+        const dir = join(base, id);
+        const allArtifacts = (await walkTree(dir)).files;
+        const specRoot = join(dir, "specs");
+        const allSpecs = (await walkTree(specRoot)).files;
+        const specFiles = allSpecs.filter((path) => basename(path) === "spec.md");
+        const metadata = await inspectChangeMetadata(scoped, dir, scope, fallbackSchema);
+        const counts = { specFiles: 0, requirements: 0, scenarios: 0 };
+        const files = [];
+        const specs = [];
+        for (const specFile of specFiles) {
+            const inspected = await inspectSpecFile(scoped, specFile, "change", scope);
+            files.push(inspected.path);
+            specs.push({
+                capability: portable(specRoot, dirname(specFile)),
+                path: inspected.path,
+                requirementNames: [...new Set(inspected.requirements.filter((item) => item.kind !== "BASE").map((item) => item.name))].sort(compareIds),
+                ...inspected.counts,
+            });
+            addCounts(counts, inspected.counts);
+        }
+        const schemaPolicy = await schemaSpecPolicy(root, metadata.schema);
+        if (!schemaPolicy.resolved) {
+            issue(unsupported, scope, {
+                code: "openspec.change-schema-unresolved",
+                path: metadata.path ?? portable(root, dir),
+                message: `Change schema '${metadata.schema ?? "<missing>"}' cannot be resolved to a readable built-in or project schema.`,
+            });
+        }
+        if (metadata.skipSpecs && allSpecs.length > 0) {
+            issue(unsupported, scope, {
+                code: "openspec.skip-specs-with-specs",
+                path: portable(root, specRoot),
+                message: "skip_specs: true conflicts with authored content under specs/; remove the marker or review and remove the spec tree.",
+            });
+        }
+        const permitsNoSpecs = schemaPolicy.resolved && metadata.skipSpecs;
+        if (specFiles.length === 0 && schemaPolicy.resolved && !permitsNoSpecs) {
+            issue(unsupported, scope, {
+                code: "openspec.change-no-specs",
+                path: portable(root, dir),
+                message: "Change has no specs/<capability>/spec.md files and does not opt out with a valid, schema-resolved skip_specs: true marker.",
+            });
+        }
+        for (const file of allSpecs.filter((path) => path.endsWith(".md") && basename(path) !== "spec.md")) {
+            issue(unsupported, scope, {
+                code: "openspec.nonstandard-change-spec",
+                path: portable(root, file),
+                message: "Markdown under a change specs/ tree is not named spec.md.",
+            });
+        }
+        changes.push({
+            id,
+            files,
+            specs: specs.sort((a, b) => compareIds(a.capability, b.capability)),
+            artifacts: allArtifacts.map((path) => portable(root, path)),
+            metadata,
+            ...counts,
+        });
+    }
+    return changes;
+}
+export function artifactScope(path) {
+    if (path.startsWith("changes/archive/"))
+        return "archive";
+    if (/^changes\/[^/]+\//.test(path))
+        return "active";
+    if (path.startsWith("specs/"))
+        return "living";
+    return "workspace";
+}
+export function artifactFor(root, absolute) {
+    const rootPath = portable(root, absolute);
+    const path = sourceInventoryPath(root, absolute);
+    const scope = artifactScope(rootPath);
+    const pieces = rootPath.split("/");
+    const archived = scope === "archive";
+    const changeId = scope === "active" ? pieces[1] : scope === "archive" ? pieces[2] : undefined;
+    const deltaSpecIndex = pieces.indexOf("specs");
+    const capability = basename(absolute) === "spec.md" && deltaSpecIndex >= 0
+        ? pieces.slice(deltaSpecIndex + 1, -1).join("/")
+        : undefined;
+    let kind = "other";
+    let disposition = "manual-review";
+    // A Store checkout that keeps its planning shape at the checkout root holds
+    // its own metadata inside the planning root, not beside it.
+    if (path === "@workspace/.openspec-store/store.yaml" || rootPath === ".openspec-store/store.yaml") {
+        [kind, disposition] = ["store-metadata", "record-external-planning-root"];
+    }
+    else if (rootPath === "config.yaml")
+        [kind, disposition] = ["config", "translate-project-context"];
+    else if (rootPath === "project.md")
+        [kind, disposition] = ["project-context", "translate-project-context"];
+    else if (rootPath === "AGENTS.md")
+        [kind, disposition] = ["agent-instructions", "remove-after-cutover"];
+    else if (/^specs\/.+\/spec\.md$/.test(rootPath))
+        [kind, disposition] = ["living-spec", "map-requirements"];
+    else if (/^specs\/.+\/design\.md$/.test(rootPath))
+        [kind, disposition] = ["living-design", "review-as-service-adr"];
+    else if (/^changes\/(?:archive\/[^/]+|[^/]+)\/\.openspec\.yaml$/.test(rootPath)) {
+        [kind, disposition] = ["change-metadata", "translate-change-metadata"];
+    }
+    else if (basename(absolute) === "proposal.md" && (scope === "active" || scope === "archive")) {
+        [kind, disposition] = ["proposal", "convert-to-intent"];
+    }
+    else if (basename(absolute) === "tasks.md" && (scope === "active" || scope === "archive")) {
+        [kind, disposition] = ["tasks", "preserve-as-legacy-checklist"];
+    }
+    else if (basename(absolute) === "design.md" && (scope === "active" || scope === "archive")) {
+        [kind, disposition] = ["change-design", "review-as-feature-adr"];
+    }
+    else if (basename(absolute) === "spec.md" && (scope === "active" || scope === "archive")) {
+        [kind, disposition] = ["delta-spec", "map-delta"];
+    }
+    else if (/^schemas\/[^/]+\/schema\.yaml$/.test(rootPath)) {
+        [kind, disposition] = ["custom-schema", "review-custom-workflow"];
+    }
+    else if (/^schemas\/[^/]+\/templates\//.test(rootPath)) {
+        [kind, disposition] = ["schema-template", "review-custom-workflow"];
+    }
+    if (archived)
+        disposition = "retain-read-only";
+    return { path, scope, kind, disposition, ...(changeId ? { changeId } : {}), ...(capability ? { capability } : {}) };
+}
+export function sortIssues(issues) {
+    issues.sort((a, b) => compareIds(a.path, b.path) || compareIds(a.code, b.code));
+}
+export function titleFromChangeId(id) {
+    const words = id.split(/[-_]+/).filter(Boolean);
+    const text = words.join(" ");
+    return text === "" ? id : text[0].toUpperCase() + text.slice(1);
+}
+//# sourceMappingURL=changes.js.map

package/dist/core/openspec/scan/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../../../src/core/openspec/scan/changes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One `changes/<id>/` directory read end to end: its metadata, its spec files,\n * and every artifact it holds.\n *\n * Active and archived changes come through the same reader with a different\n * scope, because they are the same shape and only the consequences differ — an\n * archive finding is a diagnostic, an active one blocks. Keeping that in the\n * scope rather than in two readers is what stops the two drifting into two\n * ideas of what a change looks like.\n */\nimport { existsSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\nimport { asRecord, isStringArray } from \"../../kernel/records.js\";\nimport { compareIds } from \"../../repo/entries.js\";\nimport { inspectSpecFile } from \"./shape.js\";\nimport {\n  type OpenSpecArtifact,\n  type OpenSpecArtifactDisposition,\n  type OpenSpecArtifactKind,\n  type OpenSpecArtifactScope,\n  type OpenSpecChange,\n  type OpenSpecChangeMetadata,\n  type OpenSpecChangeSpec,\n  type OpenSpecCounts,\n  type OpenSpecUnsupportedShape,\n} from \"../model/model.js\";\nimport { schemaSpecPolicy } from \"./config.js\";\nimport {\n  isSymbolicLink,\n  portable,\n  sourceInventoryPath,\n  walkTree,\n  yamlRecord,\n} from \"./walk.js\";\nimport { addCounts, issue } from \"./shape.js\";\nimport { type Ingest } from \"./workspace.js\";\n\n/**\n * A calendar date, optionally with a time. OpenSpec's template writes the plain\n * date, but a timestamp is still a date — and rejecting it blocked every change\n * and every capability in the workspace over one field nobody reads, fixable\n * only by editing the source migration promises not to touch.\n */\nconst CHANGE_CREATED_RE = /^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$/;\n\nexport async function inspectChangeMetadata(\n  ingest: Ingest,\n  dir: string,\n  scope: \"active\" | \"archive\",\n  fallbackSchema: string | null,\n): Promise<OpenSpecChangeMetadata> {\n  const { root, unsupported } = ingest;\n  const absolute = join(dir, \".openspec.yaml\");\n  if (!existsSync(absolute)) {\n    return { path: null, schema: fallbackSchema, skipSpecs: false, created: null, fields: [] };\n  }\n  const path = portable(root, absolute);\n  if (await isSymbolicLink(absolute)) {\n    return { path, schema: fallbackSchema, skipSpecs: false, created: null, fields: [] };\n  }\n  try {\n    const metadata = await yamlRecord(absolute);\n    let valid = true;\n    const invalid = (message: string): void => {\n      valid = false;\n      issue(unsupported, scope, {\n        code: \"openspec.change-metadata-invalid\",\n        path: path,\n        message: message,\n      });\n    };\n    const schema = typeof metadata.schema === \"string\" && metadata.schema.trim() !== \"\"\n      ? metadata.schema.trim()\n      : null;\n    if (schema === null) {\n      invalid(\n        \"Present .openspec.yaml metadata requires a non-empty string schema; fallback applies only when the file is absent.\",\n      );\n    }\n    if (\"skip_specs\" in metadata && typeof metadata.skip_specs !== \"boolean\") {\n      invalid(\"skip_specs must be a boolean when present.\");\n    }\n    if (\"created\" in metadata\n      && (typeof metadata.created !== \"string\" || !CHANGE_CREATED_RE.test(metadata.created))) {\n      invalid(\"created must be a string date in YYYY-MM-DD or ISO-8601 date-time form when present.\");\n    }\n    if (\"goal\" in metadata && (typeof metadata.goal !== \"string\" || metadata.goal.length === 0)) {\n      invalid(\"goal must be a non-empty string when present.\");\n    }\n    if (\"affected_areas\" in metadata\n      && (!isStringArray(metadata.affected_areas)\n        || metadata.affected_areas.some((value) => value.length === 0))) {\n      invalid(\"affected_areas must be an array of non-empty strings when present.\");\n    }\n    if (\"initiative\" in metadata) {\n      const initiative = asRecord(metadata.initiative);\n      const keys = initiative === null ? [] : Object.keys(initiative).sort(compareIds);\n      const kebabId = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;\n      if (initiative === null\n        || keys.length !== 2\n        || keys[0] !== \"id\"\n        || keys[1] !== \"store\"\n        || typeof initiative.id !== \"string\"\n        || !kebabId.test(initiative.id)\n        || typeof initiative.store !== \"string\"\n        || !kebabId.test(initiative.store)) {\n        invalid(\"initiative must be exactly { store, id }, with both values portable kebab-case identifiers.\");\n      }\n    }\n    return {\n      path,\n      schema,\n      skipSpecs: valid && schema !== null && metadata.skip_specs === true,\n      created: typeof metadata.created === \"string\" && CHANGE_CREATED_RE.test(metadata.created)\n        ? metadata.created\n        : null,\n      fields: Object.keys(metadata).sort(compareIds),\n    };\n  } catch (error) {\n    issue(unsupported, scope, {\n      code: \"openspec.change-metadata-invalid\",\n      path: path,\n      message: `Change metadata is invalid: ${error instanceof Error ? error.message : String(error)}`,\n    });\n    return { path, schema: fallbackSchema, skipSpecs: false, created: null, fields: [] };\n  }\n}\n\n/** One tree of change directories — `changes/` or `changes/archive/`. */\nexport interface ChangeTree {\n  /** The directory the ids sit under. */\n  base: string;\n  ids: string[];\n  /** Active findings block a migration; archive findings are diagnostics. */\n  scope: \"active\" | \"archive\";\n  /** The workspace schema a change inherits unless it overrides it. */\n  fallbackSchema: string | null;\n  /**\n   * Where this tree's findings land, and the only reason the tree is a record\n   * rather than four arguments: an ACTIVE finding blocks a migration while an\n   * ARCHIVE one is a diagnostic over frozen history, so the two walks are the\n   * same code writing to different lists. Reading the list off the `Ingest`\n   * instead put an archive diagnostic among the blockers and made a corpus with\n   * a specless archived change unmigratable.\n   */\n  findings: OpenSpecUnsupportedShape[];\n}\n\nexport async function inventoryChanges(ingest: Ingest, tree: ChangeTree): Promise<OpenSpecChange[]> {\n  const { base, ids, scope, fallbackSchema, findings: unsupported } = tree;\n  const { root } = ingest;\n  const scoped: Ingest = { ...ingest, unsupported };\n  const changes: OpenSpecChange[] = [];\n  for (const id of ids) {\n    const dir = join(base, id);\n    const allArtifacts = (await walkTree(dir)).files;\n    const specRoot = join(dir, \"specs\");\n    const allSpecs = (await walkTree(specRoot)).files;\n    const specFiles = allSpecs.filter((path) => basename(path) === \"spec.md\");\n    const metadata = await inspectChangeMetadata(scoped, dir, scope, fallbackSchema);\n    const counts: OpenSpecCounts = { specFiles: 0, requirements: 0, scenarios: 0 };\n    const files: string[] = [];\n    const specs: OpenSpecChangeSpec[] = [];\n    for (const specFile of specFiles) {\n      const inspected = await inspectSpecFile(scoped, specFile, \"change\", scope);\n      files.push(inspected.path);\n      specs.push({\n        capability: portable(specRoot, dirname(specFile)),\n        path: inspected.path,\n        requirementNames: [...new Set(\n          inspected.requirements.filter((item) => item.kind !== \"BASE\").map((item) => item.name),\n        )].sort(compareIds),\n        ...inspected.counts,\n      });\n      addCounts(counts, inspected.counts);\n    }\n    const schemaPolicy = await schemaSpecPolicy(root, metadata.schema);\n    if (!schemaPolicy.resolved) {\n      issue(unsupported, scope, {\n        code: \"openspec.change-schema-unresolved\",\n        path: metadata.path ?? portable(root, dir),\n        message: `Change schema '${metadata.schema ?? \"<missing>\"}' cannot be resolved to a readable built-in or project schema.`,\n      });\n    }\n    if (metadata.skipSpecs && allSpecs.length > 0) {\n      issue(unsupported, scope, {\n        code: \"openspec.skip-specs-with-specs\",\n        path: portable(root, specRoot),\n        message: \"skip_specs: true conflicts with authored content under specs/; remove the marker or review and remove the spec tree.\",\n      });\n    }\n    const permitsNoSpecs = schemaPolicy.resolved && metadata.skipSpecs;\n    if (specFiles.length === 0 && schemaPolicy.resolved && !permitsNoSpecs) {\n      issue(unsupported, scope, {\n        code: \"openspec.change-no-specs\",\n        path: portable(root, dir),\n        message: \"Change has no specs/<capability>/spec.md files and does not opt out with a valid, schema-resolved skip_specs: true marker.\",\n      });\n    }\n    for (const file of allSpecs.filter((path) => path.endsWith(\".md\") && basename(path) !== \"spec.md\")) {\n      issue(unsupported, scope, {\n        code: \"openspec.nonstandard-change-spec\",\n        path: portable(root, file),\n        message: \"Markdown under a change specs/ tree is not named spec.md.\",\n      });\n    }\n    changes.push({\n      id,\n      files,\n      specs: specs.sort((a, b) => compareIds(a.capability, b.capability)),\n      artifacts: allArtifacts.map((path) => portable(root, path)),\n      metadata,\n      ...counts,\n    });\n  }\n  return changes;\n}\n\nexport function artifactScope(path: string): OpenSpecArtifactScope {\n  if (path.startsWith(\"changes/archive/\")) return \"archive\";\n  if (/^changes\\/[^/]+\\//.test(path)) return \"active\";\n  if (path.startsWith(\"specs/\")) return \"living\";\n  return \"workspace\";\n}\n\nexport function artifactFor(root: string, absolute: string): OpenSpecArtifact {\n  const rootPath = portable(root, absolute);\n  const path = sourceInventoryPath(root, absolute);\n  const scope = artifactScope(rootPath);\n  const pieces = rootPath.split(\"/\");\n  const archived = scope === \"archive\";\n  const changeId = scope === \"active\" ? pieces[1] : scope === \"archive\" ? pieces[2] : undefined;\n  const deltaSpecIndex = pieces.indexOf(\"specs\");\n  const capability = basename(absolute) === \"spec.md\" && deltaSpecIndex >= 0\n    ? pieces.slice(deltaSpecIndex + 1, -1).join(\"/\")\n    : undefined;\n  let kind: OpenSpecArtifactKind = \"other\";\n  let disposition: OpenSpecArtifactDisposition = \"manual-review\";\n\n  // A Store checkout that keeps its planning shape at the checkout root holds\n  // its own metadata inside the planning root, not beside it.\n  if (path === \"@workspace/.openspec-store/store.yaml\" || rootPath === \".openspec-store/store.yaml\") {\n    [kind, disposition] = [\"store-metadata\", \"record-external-planning-root\"];\n  } else if (rootPath === \"config.yaml\") [kind, disposition] = [\"config\", \"translate-project-context\"];\n  else if (rootPath === \"project.md\") [kind, disposition] = [\"project-context\", \"translate-project-context\"];\n  else if (rootPath === \"AGENTS.md\") [kind, disposition] = [\"agent-instructions\", \"remove-after-cutover\"];\n  else if (/^specs\\/.+\\/spec\\.md$/.test(rootPath)) [kind, disposition] = [\"living-spec\", \"map-requirements\"];\n  else if (/^specs\\/.+\\/design\\.md$/.test(rootPath)) [kind, disposition] = [\"living-design\", \"review-as-service-adr\"];\n  else if (/^changes\\/(?:archive\\/[^/]+|[^/]+)\\/\\.openspec\\.yaml$/.test(rootPath)) {\n    [kind, disposition] = [\"change-metadata\", \"translate-change-metadata\"];\n  } else if (basename(absolute) === \"proposal.md\" && (scope === \"active\" || scope === \"archive\")) {\n    [kind, disposition] = [\"proposal\", \"convert-to-intent\"];\n  } else if (basename(absolute) === \"tasks.md\" && (scope === \"active\" || scope === \"archive\")) {\n    [kind, disposition] = [\"tasks\", \"preserve-as-legacy-checklist\"];\n  } else if (basename(absolute) === \"design.md\" && (scope === \"active\" || scope === \"archive\")) {\n    [kind, disposition] = [\"change-design\", \"review-as-feature-adr\"];\n  } else if (basename(absolute) === \"spec.md\" && (scope === \"active\" || scope === \"archive\")) {\n    [kind, disposition] = [\"delta-spec\", \"map-delta\"];\n  } else if (/^schemas\\/[^/]+\\/schema\\.yaml$/.test(rootPath)) {\n    [kind, disposition] = [\"custom-schema\", \"review-custom-workflow\"];\n  } else if (/^schemas\\/[^/]+\\/templates\\//.test(rootPath)) {\n    [kind, disposition] = [\"schema-template\", \"review-custom-workflow\"];\n  }\n\n  if (archived) disposition = \"retain-read-only\";\n  return { path, scope, kind, disposition, ...(changeId ? { changeId } : {}), ...(capability ? { capability } : {}) };\n}\n\nexport function sortIssues(issues: OpenSpecUnsupportedShape[]): void {\n  issues.sort((a, b) => compareIds(a.path, b.path) || compareIds(a.code, b.code));\n}\n\nexport function titleFromChangeId(id: string): string {\n  const words = id.split(/[-_]+/).filter(Boolean);\n  const text = words.join(\" \");\n  return text === \"\" ? id : text[0]!.toUpperCase() + text.slice(1);\n}\n"]}

package/dist/core/openspec/scan/config.js

@@ -0,0 +1,191 @@
+/**
+ * `openspec/config.yaml` and the project schemas it can point at.
+ *
+ * The schema policy is here rather than with the change reader because it is a
+ * WORKSPACE fact: a change inherits its schema from the config unless it
+ * overrides it, so a per-change reader that resolved schemas itself would
+ * resolve the same registered file once per change and could disagree with
+ * itself about whether it validates.
+ */
+import { existsSync } from "node:fs";
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { join } from "node:path";
+import { isPathInside } from "../../kernel/path-safety.js";
+import { asRecord, isStringArray } from "../../kernel/records.js";
+import { compareIds } from "../../repo/entries.js";
+import {} from "../model/model.js";
+import { isSymbolicLink, yamlRecord } from "./walk.js";
+import { issue } from "./shape.js";
+export async function inspectConfig(root, unsupported) {
+    const path = join(root, "config.yaml");
+    if (!existsSync(path))
+        return null;
+    if (await isSymbolicLink(path))
+        return null;
+    try {
+        const config = await yamlRecord(path);
+        const rules = asRecord(config.rules);
+        return {
+            path: "config.yaml",
+            schema: typeof config.schema === "string" ? config.schema : null,
+            store: typeof config.store === "string" ? config.store : null,
+            hasContext: typeof config.context === "string" && config.context.trim() !== "",
+            ruleArtifacts: rules === null ? [] : Object.keys(rules).sort(compareIds),
+            references: Array.isArray(config.references)
+                ? config.references.filter((item) => typeof item === "string").sort(compareIds)
+                : [],
+        };
+    }
+    catch (error) {
+        issue(unsupported, "workspace", {
+            code: "openspec.config-invalid",
+            path: "config.yaml",
+            message: `OpenSpec config.yaml is invalid: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        return {
+            path: "config.yaml",
+            schema: null,
+            store: null,
+            hasContext: false,
+            ruleArtifacts: [],
+            references: [],
+        };
+    }
+}
+/**
+ * Resolve only a schema that OpenSpec could enumerate as one direct, portable
+ * member of this workspace's schemas/ directory. Constructing a path from the
+ * metadata value first would let `../` (or a platform-specific separator) read
+ * bytes outside the inventoried tree and then authorize `skip_specs` with them.
+ */
+export async function registeredProjectSchemaPath(root, schema) {
+    const windowsStem = schema.split(".")[0].toUpperCase();
+    const windowsReserved = /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/.test(windowsStem);
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(schema)
+        || schema === "."
+        || schema === ".."
+        || schema.endsWith(".")
+        || windowsReserved) {
+        return { registered: false, path: null };
+    }
+    const schemasRoot = join(root, "schemas");
+    try {
+        const schemasStat = await lstat(schemasRoot);
+        if (!schemasStat.isDirectory() || schemasStat.isSymbolicLink())
+            return { registered: false, path: null };
+        const entries = await readdir(schemasRoot, { withFileTypes: true });
+        const registered = entries.find((entry) => entry.name === schema);
+        if (registered === undefined)
+            return { registered: false, path: null };
+        if (!registered.isDirectory() || registered.isSymbolicLink())
+            return { registered: true, path: null };
+        const schemaDir = join(schemasRoot, registered.name);
+        const schemaFile = join(schemaDir, "schema.yaml");
+        const [schemaDirStat, schemaFileStat] = await Promise.all([lstat(schemaDir), lstat(schemaFile)]);
+        if (!schemaDirStat.isDirectory() || schemaDirStat.isSymbolicLink()
+            || !schemaFileStat.isFile() || schemaFileStat.isSymbolicLink()) {
+            return { registered: true, path: null };
+        }
+        const [canonicalRoot, canonicalSchemasRoot, canonicalSchemaDir, canonicalSchemaFile] = await Promise.all([
+            realpath(root),
+            realpath(schemasRoot),
+            realpath(schemaDir),
+            realpath(schemaFile),
+        ]);
+        if (!isPathInside(canonicalRoot, canonicalSchemasRoot)
+            || !isPathInside(canonicalSchemasRoot, canonicalSchemaDir)
+            || !isPathInside(canonicalSchemaDir, canonicalSchemaFile)) {
+            return { registered: true, path: null };
+        }
+        return { registered: true, path: schemaFile };
+    }
+    catch {
+        return { registered: false, path: null };
+    }
+}
+export function validArtifactSchema(document) {
+    if (typeof document.name !== "string" || document.name.length === 0
+        || typeof document.version !== "number"
+        || !Number.isInteger(document.version)
+        || document.version <= 0
+        || ("description" in document && typeof document.description !== "string")
+        || !Array.isArray(document.artifacts)
+        || document.artifacts.length === 0) {
+        return false;
+    }
+    const artifacts = [];
+    for (const value of document.artifacts) {
+        const artifact = asRecord(value);
+        if (artifact === null
+            || typeof artifact.id !== "string"
+            || artifact.id.length === 0
+            || typeof artifact.generates !== "string"
+            || artifact.generates.length === 0
+            || typeof artifact.description !== "string"
+            || typeof artifact.template !== "string"
+            || artifact.template.length === 0
+            || ("instruction" in artifact && typeof artifact.instruction !== "string")
+            || ("requires" in artifact && !isStringArray(artifact.requires))) {
+            return false;
+        }
+        artifacts.push({
+            id: artifact.id,
+            requires: isStringArray(artifact.requires) ? artifact.requires : [],
+        });
+    }
+    if ("apply" in document) {
+        const apply = asRecord(document.apply);
+        if (apply === null
+            || !isStringArray(apply.requires)
+            || apply.requires.length === 0
+            || ("tracks" in apply && apply.tracks !== null && typeof apply.tracks !== "string")
+            || ("instruction" in apply && typeof apply.instruction !== "string")) {
+            return false;
+        }
+    }
+    const ids = new Set();
+    for (const artifact of artifacts) {
+        if (ids.has(artifact.id))
+            return false;
+        ids.add(artifact.id);
+    }
+    if (artifacts.some((artifact) => artifact.requires.some((dependency) => !ids.has(dependency))))
+        return false;
+    const byId = new Map(artifacts.map((artifact) => [artifact.id, artifact]));
+    const complete = new Set();
+    const visiting = new Set();
+    const visit = (id) => {
+        if (complete.has(id))
+            return true;
+        if (visiting.has(id))
+            return false;
+        visiting.add(id);
+        for (const dependency of byId.get(id)?.requires ?? []) {
+            if (!visit(dependency))
+                return false;
+        }
+        visiting.delete(id);
+        complete.add(id);
+        return true;
+    };
+    return artifacts.every((artifact) => visit(artifact.id));
+}
+export async function schemaSpecPolicy(root, schema) {
+    if (schema === null)
+        return { resolved: false };
+    const projectSchema = await registeredProjectSchemaPath(root, schema);
+    // A project-local entry shadows the known built-in, but migration refuses
+    // unsafe/symlinked entries instead of following them outside the inventory.
+    if (!projectSchema.registered)
+        return { resolved: schema === "spec-driven" };
+    if (projectSchema.path === null)
+        return { resolved: false };
+    try {
+        const document = await yamlRecord(projectSchema.path);
+        return { resolved: validArtifactSchema(document) };
+    }
+    catch {
+        return { resolved: false };
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/core/openspec/scan/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/core/openspec/scan/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `openspec/config.yaml` and the project schemas it can point at.\n *\n * The schema policy is here rather than with the change reader because it is a\n * WORKSPACE fact: a change inherits its schema from the config unless it\n * overrides it, so a per-change reader that resolved schemas itself would\n * resolve the same registered file once per change and could disagree with\n * itself about whether it validates.\n */\nimport { existsSync } from \"node:fs\";\nimport { lstat, readdir, realpath } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { isPathInside } from \"../../kernel/path-safety.js\";\nimport { asRecord, isStringArray } from \"../../kernel/records.js\";\nimport { compareIds } from \"../../repo/entries.js\";\nimport { type OpenSpecConfigSummary, type OpenSpecUnsupportedShape } from \"../model/model.js\";\nimport { isSymbolicLink, yamlRecord } from \"./walk.js\";\nimport { issue } from \"./shape.js\";\n\nexport async function inspectConfig(\n  root: string,\n  unsupported: OpenSpecUnsupportedShape[],\n): Promise<OpenSpecConfigSummary | null> {\n  const path = join(root, \"config.yaml\");\n  if (!existsSync(path)) return null;\n  if (await isSymbolicLink(path)) return null;\n  try {\n    const config = await yamlRecord(path);\n    const rules = asRecord(config.rules);\n    return {\n      path: \"config.yaml\",\n      schema: typeof config.schema === \"string\" ? config.schema : null,\n      store: typeof config.store === \"string\" ? config.store : null,\n      hasContext: typeof config.context === \"string\" && config.context.trim() !== \"\",\n      ruleArtifacts: rules === null ? [] : Object.keys(rules).sort(compareIds),\n      references: Array.isArray(config.references)\n        ? config.references.filter((item): item is string => typeof item === \"string\").sort(compareIds)\n        : [],\n    };\n  } catch (error) {\n    issue(unsupported, \"workspace\", {\n      code: \"openspec.config-invalid\",\n      path: \"config.yaml\",\n      message: `OpenSpec config.yaml is invalid: ${error instanceof Error ? error.message : String(error)}`,\n    });\n    return {\n      path: \"config.yaml\",\n      schema: null,\n      store: null,\n      hasContext: false,\n      ruleArtifacts: [],\n      references: [],\n    };\n  }\n}\n\n/**\n * Resolve only a schema that OpenSpec could enumerate as one direct, portable\n * member of this workspace's schemas/ directory. Constructing a path from the\n * metadata value first would let `../` (or a platform-specific separator) read\n * bytes outside the inventoried tree and then authorize `skip_specs` with them.\n */\nexport async function registeredProjectSchemaPath(\n  root: string,\n  schema: string,\n): Promise<{ registered: boolean; path: string | null }> {\n  const windowsStem = schema.split(\".\")[0]!.toUpperCase();\n  const windowsReserved = /^(?:CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])$/.test(windowsStem);\n  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(schema)\n    || schema === \".\"\n    || schema === \"..\"\n    || schema.endsWith(\".\")\n    || windowsReserved) {\n    return { registered: false, path: null };\n  }\n\n  const schemasRoot = join(root, \"schemas\");\n  try {\n    const schemasStat = await lstat(schemasRoot);\n    if (!schemasStat.isDirectory() || schemasStat.isSymbolicLink()) return { registered: false, path: null };\n    const entries = await readdir(schemasRoot, { withFileTypes: true });\n    const registered = entries.find((entry) => entry.name === schema);\n    if (registered === undefined) return { registered: false, path: null };\n    if (!registered.isDirectory() || registered.isSymbolicLink()) return { registered: true, path: null };\n\n    const schemaDir = join(schemasRoot, registered.name);\n    const schemaFile = join(schemaDir, \"schema.yaml\");\n    const [schemaDirStat, schemaFileStat] = await Promise.all([lstat(schemaDir), lstat(schemaFile)]);\n    if (!schemaDirStat.isDirectory() || schemaDirStat.isSymbolicLink()\n      || !schemaFileStat.isFile() || schemaFileStat.isSymbolicLink()) {\n      return { registered: true, path: null };\n    }\n\n    const [canonicalRoot, canonicalSchemasRoot, canonicalSchemaDir, canonicalSchemaFile] = await Promise.all([\n      realpath(root),\n      realpath(schemasRoot),\n      realpath(schemaDir),\n      realpath(schemaFile),\n    ]);\n    if (!isPathInside(canonicalRoot, canonicalSchemasRoot)\n      || !isPathInside(canonicalSchemasRoot, canonicalSchemaDir)\n      || !isPathInside(canonicalSchemaDir, canonicalSchemaFile)) {\n      return { registered: true, path: null };\n    }\n    return { registered: true, path: schemaFile };\n  } catch {\n    return { registered: false, path: null };\n  }\n}\n\nexport function validArtifactSchema(document: Record<string, unknown>): boolean {\n  if (typeof document.name !== \"string\" || document.name.length === 0\n    || typeof document.version !== \"number\"\n    || !Number.isInteger(document.version)\n    || document.version <= 0\n    || (\"description\" in document && typeof document.description !== \"string\")\n    || !Array.isArray(document.artifacts)\n    || document.artifacts.length === 0) {\n    return false;\n  }\n\n  const artifacts: Array<{ id: string; requires: string[] }> = [];\n  for (const value of document.artifacts) {\n    const artifact = asRecord(value);\n    if (artifact === null\n      || typeof artifact.id !== \"string\"\n      || artifact.id.length === 0\n      || typeof artifact.generates !== \"string\"\n      || artifact.generates.length === 0\n      || typeof artifact.description !== \"string\"\n      || typeof artifact.template !== \"string\"\n      || artifact.template.length === 0\n      || (\"instruction\" in artifact && typeof artifact.instruction !== \"string\")\n      || (\"requires\" in artifact && !isStringArray(artifact.requires))) {\n      return false;\n    }\n    artifacts.push({\n      id: artifact.id,\n      requires: isStringArray(artifact.requires) ? artifact.requires : [],\n    });\n  }\n\n  if (\"apply\" in document) {\n    const apply = asRecord(document.apply);\n    if (apply === null\n      || !isStringArray(apply.requires)\n      || apply.requires.length === 0\n      || (\"tracks\" in apply && apply.tracks !== null && typeof apply.tracks !== \"string\")\n      || (\"instruction\" in apply && typeof apply.instruction !== \"string\")) {\n      return false;\n    }\n  }\n\n  const ids = new Set<string>();\n  for (const artifact of artifacts) {\n    if (ids.has(artifact.id)) return false;\n    ids.add(artifact.id);\n  }\n  if (artifacts.some((artifact) => artifact.requires.some((dependency) => !ids.has(dependency)))) return false;\n\n  const byId = new Map(artifacts.map((artifact) => [artifact.id, artifact]));\n  const complete = new Set<string>();\n  const visiting = new Set<string>();\n  const visit = (id: string): boolean => {\n    if (complete.has(id)) return true;\n    if (visiting.has(id)) return false;\n    visiting.add(id);\n    for (const dependency of byId.get(id)?.requires ?? []) {\n      if (!visit(dependency)) return false;\n    }\n    visiting.delete(id);\n    complete.add(id);\n    return true;\n  };\n  return artifacts.every((artifact) => visit(artifact.id));\n}\n\nexport async function schemaSpecPolicy(\n  root: string,\n  schema: string | null,\n): Promise<{ resolved: boolean }> {\n  if (schema === null) return { resolved: false };\n  const projectSchema = await registeredProjectSchemaPath(root, schema);\n  // A project-local entry shadows the known built-in, but migration refuses\n  // unsafe/symlinked entries instead of following them outside the inventory.\n  if (!projectSchema.registered) return { resolved: schema === \"spec-driven\" };\n  if (projectSchema.path === null) return { resolved: false };\n  try {\n    const document = await yamlRecord(projectSchema.path);\n    return { resolved: validArtifactSchema(document) };\n  } catch {\n    return { resolved: false };\n  }\n}\n"]}