@documentation-robotics/cli 0.2.0 → 0.4.0

package/dist/core/element-type-migration.js

@@ -0,0 +1,145 @@
+import { readdir, readFile, writeFile } from "fs/promises";
+import { Element } from "./element.js";
+import { CANONICAL_LAYER_NAMES } from "./layers.js";
+import { StagedChangesetStorage } from "./staged-changeset-storage.js";
+import { FileLock } from "../utils/file-lock.js";
+import { getErrorMessage } from "../utils/errors.js";
+import { RELATIONSHIP_REWRITE_TABLE } from "./relationship-migration-table.js";
+function splitType(specNodeId) {
+  const dot = specNodeId.indexOf(".");
+  return { layer: specNodeId.slice(0, dot), type: specNodeId.slice(dot + 1) };
+}
+function mapId(id, ids, types) {
+  const known = ids.get(id);
+  if (known)
+    return known;
+  for (const [from, to] of Object.entries(types)) {
+    const rest = id.startsWith(`${from}.`) ? id.slice(from.length + 1) : void 0;
+    if (rest && !rest.includes(".") && !rest.includes(":"))
+      return `${to}.${rest}`;
+  }
+  return id;
+}
+function rewriteValue(value, ids, types) {
+  if (typeof value == "string") {
+    if (value.includes("::")) {
+      const parts = value.split("::"), mapped = parts.map((p) => mapId(p, ids, types));
+      return mapped.some((p, i) => p !== parts[i]) ? mapped.join("::") : value;
+    }
+    return mapId(value, ids, types);
+  }
+  if (Array.isArray(value))
+    return value.map((v) => rewriteValue(v, ids, types));
+  if (value && typeof value == "object") {
+    const obj = value, out = {};
+    for (const [k, v] of Object.entries(obj))
+      out[k] = rewriteValue(v, ids, types);
+    const layerId = typeof obj.layer_id == "string" ? obj.layer_id : void 0, specNodeId = typeof obj.spec_node_id == "string" ? obj.spec_node_id : layerId && typeof obj.type == "string" ? `${layerId}.${obj.type}` : void 0, renamed = specNodeId ? types[specNodeId] : void 0;
+    return renamed && ("spec_node_id" in obj && (out.spec_node_id = renamed), "type" in obj && (out.type = splitType(renamed).type)), out;
+  }
+  return value;
+}
+function renamedPath(path, from, to) {
+  return path.startsWith(`${from}.`) ? `${to}.${path.slice(from.length + 1)}` : path;
+}
+async function migrateElementTypes(model, renames = RELATIONSHIP_REWRITE_TABLE.typeRenames ?? {}, options = {}) {
+  const result = { filesModified: 0, changes: [], changesetsModified: 0, errors: [] };
+  if (Object.keys(renames).length === 0)
+    return result;
+  for (const layerName of CANONICAL_LAYER_NAMES)
+    model.layers.has(layerName) || await model.loadLayer(layerName);
+  const ids = /* @__PURE__ */ new Map();
+  for (const layer of model.layers.values())
+    for (const element of layer.listElements()) {
+      const oldSpec = element.spec_node_id || `${layer.name}.${element.type}`, newSpec = renames[oldSpec];
+      if (!newSpec)
+        continue;
+      const target = splitType(newSpec);
+      if (target.layer !== layer.name) {
+        result.errors.push(`${element.path}: renaming ${oldSpec} to ${newSpec} would move it to another layer, which the upgrade cannot do`);
+        continue;
+      }
+      const json = element.toJSON(), newPath = renamedPath(element.path, oldSpec, newSpec);
+      if (options.dryRun) {
+        result.changes.push({ from: element.path, to: newPath, fromType: oldSpec, toType: newSpec });
+        continue;
+      }
+      layer.deleteElement(element.id), layer.addElement(new Element({
+        ...json,
+        // A legacy element whose id is its semantic path keeps the two equal
+        id: json.id === element.path ? newPath : json.id,
+        path: newPath,
+        spec_node_id: newSpec,
+        type: target.type,
+        layer_id: layer.name
+      })), newPath !== element.path && ids.set(element.path, newPath), result.changes.push({ from: element.path, to: newPath, fromType: oldSpec, toType: newSpec });
+    }
+  if (result.changes.length === 0 || options.dryRun)
+    return result;
+  if (ids.size > 0)
+    for (const layer of model.layers.values())
+      for (const element of layer.listElements())
+        element.references?.some((r) => ids.has(r.target) || ids.has(r.source)) && (element.references = element.references.map((r) => ({
+          ...r,
+          source: ids.get(r.source) ?? r.source,
+          target: ids.get(r.target) ?? r.target
+        })), layer.updateElement(element));
+  if (ids.size > 0) {
+    const YAML = await import("yaml"), relationshipsPath = `${model.rootPath}/documentation-robotics/model/relationships.yaml`;
+    let content;
+    try {
+      content = await readFile(relationshipsPath, "utf-8");
+    } catch (error) {
+      if (error.code !== "ENOENT")
+        throw error;
+    }
+    const data = content ? YAML.parse(content) ?? [] : [];
+    if (Array.isArray(data)) {
+      let changed = !1;
+      const rewritten = data.map((rel) => {
+        const map = (v) => typeof v == "string" && mapId(v, ids, renames) !== v ? mapId(v, ids, renames) : void 0, source = map(rel.source), target = map(rel.target);
+        return !source && !target ? rel : (changed = !0, { ...rel, ...source && { source }, ...target && { target } });
+      });
+      if (changed) {
+        const header = `# Intra-layer relationships
+# Format: source_id -> predicate -> target_id
+# Last updated: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+`;
+        await writeFile(relationshipsPath, header + YAML.stringify(rewritten), "utf-8"), result.filesModified++;
+      }
+    }
+  }
+  const storage = new StagedChangesetStorage(model.rootPath);
+  let entries = [];
+  try {
+    entries = (await readdir(storage.getChangesetsDir(), { withFileTypes: !0 })).filter((entry) => entry.isDirectory() && !entry.name.endsWith(".lock")).map((entry) => entry.name).sort();
+  } catch (error) {
+    if (error.code !== "ENOENT")
+      throw error;
+  }
+  for (const id of entries)
+    try {
+      await new FileLock(storage.getChangesetPath(id)).withLock(async () => {
+        const changeset = await storage.load(id);
+        if (!changeset || changeset.status !== "staged")
+          return;
+        const before = JSON.stringify(changeset.changes);
+        changeset.changes = changeset.changes.map((change) => rewriteValue(change, ids, renames)), JSON.stringify(changeset.changes) !== before && (changeset.updateModified(), await storage.save(changeset), result.changesetsModified++);
+      });
+    } catch (error) {
+      result.errors.push(`Failed to rename element types in staged changeset '${id}': ${getErrorMessage(error)}; fix or delete the changeset and run the upgrade again`);
+    }
+  return result;
+}
+function summarizeElementTypeChanges(changes) {
+  const byType = /* @__PURE__ */ new Map();
+  for (const c of changes)
+    byType.set(`${c.fromType} -> ${c.toType}`, (byType.get(`${c.fromType} -> ${c.toType}`) ?? 0) + 1);
+  return [...byType].map(([k, n]) => `${k} (${n} element${n === 1 ? "" : "s"})`).join("; ");
+}
+export {
+  migrateElementTypes,
+  summarizeElementTypeChanges
+};
+//# sourceMappingURL=element-type-migration.js.map

package/dist/core/element-type-migration.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/element-type-migration.ts"],
+  "sourcesContent": ["/**\n * Element type renames for `dr upgrade`.\n *\n * When the spec renames an element type (\"product.capability\" -> \"product.softwarecapability\",\n * recorded as a rename-type action and generated into RELATIONSHIP_REWRITE_TABLE.typeRenames),\n * every model element of the old type takes the new type, and its semantic path follows\n * (\"product.capability.search\" -> \"product.softwarecapability.search\"). Anything that names the\n * old path is rewritten with it: other elements' references, relationships.yaml, and the\n * element and relationship changes of staged changesets.\n *\n * The rename runs before the relationship rewrite of the same migration, on the loaded model, so\n * the relationship rules (keyed by the new type names) resolve the renamed elements. Renamed\n * layers are left dirty for the upgrade's saveDirtyLayers(); relationships.yaml and changesets\n * are rewritten on disk.\n */\nimport { readdir, readFile, writeFile } from \"fs/promises\";\nimport type { Model } from \"./model.js\";\nimport { Element } from \"./element.js\";\nimport type { Change } from \"./changeset.js\";\nimport { CANONICAL_LAYER_NAMES } from \"./layers.js\";\nimport { StagedChangesetStorage } from \"./staged-changeset-storage.js\";\nimport { FileLock } from \"../utils/file-lock.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { RELATIONSHIP_REWRITE_TABLE } from \"./relationship-migration-table.js\";\n\nexport interface ElementTypeRenameChange {\n  /** Element path before and after (the UUID does not change) */\n  from: string;\n  to: string;\n  fromType: string;\n  toType: string;\n}\n\nexport interface ElementTypeMigrationResult {\n  filesModified: number;\n  changes: ElementTypeRenameChange[];\n  /** Changesets whose staged changes named a renamed element or type */\n  changesetsModified: number;\n  errors: string[];\n}\n\nfunction splitType(specNodeId: string): { layer: string; type: string } {\n  const dot = specNodeId.indexOf(\".\");\n  return { layer: specNodeId.slice(0, dot), type: specNodeId.slice(dot + 1) };\n}\n\n/**\n * The renamed form of an element id: a renamed element's path, or any \"{old type}.{name}\" path,\n * which covers elements that exist only in a staged changeset. Other ids are returned unchanged.\n */\nfunction mapId(id: string, ids: Map<string, string>, types: Record<string, string>): string {\n  const known = ids.get(id);\n  if (known) return known;\n  for (const [from, to] of Object.entries(types)) {\n    const rest = id.startsWith(`${from}.`) ? id.slice(from.length + 1) : undefined;\n    if (rest && !rest.includes(\".\") && !rest.includes(\":\")) return `${to}.${rest}`;\n  }\n  return id;\n}\n\n/** Replace every string in a JSON-like value that is a renamed element id (or a composite of them) */\nfunction rewriteValue(value: unknown, ids: Map<string, string>, types: Record<string, string>): unknown {\n  if (typeof value === \"string\") {\n    // Relationship change ids are \"source::predicate::target\"\n    if (value.includes(\"::\")) {\n      const parts = value.split(\"::\");\n      const mapped = parts.map((p) => mapId(p, ids, types));\n      return mapped.some((p, i) => p !== parts[i]) ? mapped.join(\"::\") : value;\n    }\n    return mapId(value, ids, types);\n  }\n  if (Array.isArray(value)) return value.map((v) => rewriteValue(v, ids, types));\n  if (value && typeof value === \"object\") {\n    const obj = value as Record<string, unknown>;\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(obj)) out[k] = rewriteValue(v, ids, types);\n    // An element payload of a renamed type: spec_node_id and type follow the rename\n    const layerId = typeof obj.layer_id === \"string\" ? obj.layer_id : undefined;\n    const specNodeId =\n      typeof obj.spec_node_id === \"string\"\n        ? obj.spec_node_id\n        : layerId && typeof obj.type === \"string\"\n          ? `${layerId}.${obj.type}`\n          : undefined;\n    const renamed = specNodeId ? types[specNodeId] : undefined;\n    if (renamed) {\n      if (\"spec_node_id\" in obj) out.spec_node_id = renamed;\n      if (\"type\" in obj) out.type = splitType(renamed).type;\n    }\n    return out;\n  }\n  return value;\n}\n\n/** The new semantic path for an element of a renamed type, or the path unchanged */\nfunction renamedPath(path: string, from: string, to: string): string {\n  return path.startsWith(`${from}.`) ? `${to}.${path.slice(from.length + 1)}` : path;\n}\n\n/**\n * Rename the elements of every renamed type in the loaded model, and rewrite what names them.\n *\n * @param renames - old spec node id -> new spec node id; defaults to the generated table's\n * @param options.dryRun - report the elements that would be renamed, and change nothing\n */\nexport async function migrateElementTypes(\n  model: Model,\n  renames: Record<string, string> = RELATIONSHIP_REWRITE_TABLE.typeRenames ?? {},\n  options: { dryRun?: boolean } = {}\n): Promise<ElementTypeMigrationResult> {\n  const result: ElementTypeMigrationResult = { filesModified: 0, changes: [], changesetsModified: 0, errors: [] };\n  if (Object.keys(renames).length === 0) return result;\n\n  for (const layerName of CANONICAL_LAYER_NAMES) {\n    if (!model.layers.has(layerName)) {\n      await model.loadLayer(layerName);\n    }\n  }\n\n  // 1. Elements of a renamed type: new type, new path. A move to another layer is not supported.\n  const ids = new Map<string, string>();\n  for (const layer of model.layers.values()) {\n    for (const element of layer.listElements()) {\n      const oldSpec = element.spec_node_id || `${layer.name}.${element.type}`;\n      const newSpec = renames[oldSpec];\n      if (!newSpec) continue;\n      const target = splitType(newSpec);\n      if (target.layer !== layer.name) {\n        result.errors.push(`${element.path}: renaming ${oldSpec} to ${newSpec} would move it to another layer, which the upgrade cannot do`);\n        continue;\n      }\n      const json = element.toJSON();\n      const newPath = renamedPath(element.path, oldSpec, newSpec);\n      if (options.dryRun) {\n        result.changes.push({ from: element.path, to: newPath, fromType: oldSpec, toType: newSpec });\n        continue;\n      }\n      layer.deleteElement(element.id);\n      layer.addElement(\n        new Element({\n          ...json,\n          // A legacy element whose id is its semantic path keeps the two equal\n          id: json.id === element.path ? newPath : json.id,\n          path: newPath,\n          spec_node_id: newSpec,\n          type: target.type,\n          layer_id: layer.name,\n        })\n      );\n      if (newPath !== element.path) ids.set(element.path, newPath);\n      result.changes.push({ from: element.path, to: newPath, fromType: oldSpec, toType: newSpec });\n    }\n  }\n  if (result.changes.length === 0 || options.dryRun) return result;\n\n  // 2. References from any element to a renamed path\n  if (ids.size > 0) {\n    for (const layer of model.layers.values()) {\n      for (const element of layer.listElements()) {\n        if (!element.references?.some((r) => ids.has(r.target) || ids.has(r.source))) continue;\n        element.references = element.references.map((r) => ({\n          ...r,\n          source: ids.get(r.source) ?? r.source,\n          target: ids.get(r.target) ?? r.target,\n        }));\n        layer.updateElement(element);\n      }\n    }\n  }\n\n  // 3. relationships.yaml names elements by path (or a legacy id)\n  if (ids.size > 0) {\n    const YAML = await import(\"yaml\");\n    const relationshipsPath = `${model.rootPath}/documentation-robotics/model/relationships.yaml`;\n    let content: string | undefined;\n    try {\n      content = await readFile(relationshipsPath, \"utf-8\");\n    } catch (error) {\n      if ((error as { code?: string }).code !== \"ENOENT\") throw error;\n    }\n    const data = content ? (YAML.parse(content) ?? []) : [];\n    if (Array.isArray(data)) {\n      let changed = false;\n      const rewritten = data.map((rel: Record<string, unknown>) => {\n        const map = (v: unknown) => (typeof v === \"string\" && mapId(v, ids, renames) !== v ? mapId(v, ids, renames) : undefined);\n        const source = map(rel.source);\n        const target = map(rel.target);\n        if (!source && !target) return rel;\n        changed = true;\n        return { ...rel, ...(source && { source }), ...(target && { target }) };\n      });\n      if (changed) {\n        const header = `# Intra-layer relationships\n# Format: source_id -> predicate -> target_id\n# Last updated: ${new Date().toISOString()}\n\n`;\n        await writeFile(relationshipsPath, header + YAML.stringify(rewritten), \"utf-8\");\n        result.filesModified++;\n      }\n    }\n  }\n\n  // 4. Staged changesets: element and relationship changes naming a renamed element or type\n  const storage = new StagedChangesetStorage(model.rootPath);\n  let entries: string[] = [];\n  try {\n    entries = (await readdir(storage.getChangesetsDir(), { withFileTypes: true }))\n      .filter((entry) => entry.isDirectory() && !entry.name.endsWith(\".lock\"))\n      .map((entry) => entry.name)\n      .sort();\n  } catch (error) {\n    if ((error as { code?: string }).code !== \"ENOENT\") throw error;\n  }\n  for (const id of entries) {\n    try {\n      await new FileLock(storage.getChangesetPath(id)).withLock(async () => {\n        const changeset = await storage.load(id);\n        if (!changeset || changeset.status !== \"staged\") return;\n        const before = JSON.stringify(changeset.changes);\n        changeset.changes = changeset.changes.map((change) => rewriteValue(change, ids, renames) as Change) as typeof changeset.changes;\n        if (JSON.stringify(changeset.changes) === before) return;\n        changeset.updateModified();\n        await storage.save(changeset);\n        result.changesetsModified++;\n      });\n    } catch (error) {\n      result.errors.push(\n        `Failed to rename element types in staged changeset '${id}': ${getErrorMessage(error)}; fix or delete the changeset and run the upgrade again`\n      );\n    }\n  }\n\n  // Renamed layers are dirty; the upgrade saves them\n  return result;\n}\n\n/** One line per renamed type: \"product.capability -> product.softwarecapability (3 elements)\" */\nexport function summarizeElementTypeChanges(changes: ElementTypeRenameChange[]): string {\n  const byType = new Map<string, number>();\n  for (const c of changes) byType.set(`${c.fromType} -> ${c.toType}`, (byType.get(`${c.fromType} -> ${c.toType}`) ?? 0) + 1);\n  return [...byType].map(([k, n]) => `${k} (${n} element${n === 1 ? \"\" : \"s\"})`).join(\"; \");\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/extraction-observability.js

@@ -0,0 +1,161 @@
+import { MappingLoader } from "../analyzers/mapping-loader.js";
+import { relationshipFor } from "../analyzers/edge-relationships.js";
+import { tier0RulesFrom } from "../analyzers/tier0-rules.js";
+import { getValidRelationships } from "../generated/relationship-index.js";
+const NEVER_OBSERVABLE_LAYERS = /* @__PURE__ */ new Set(["motivation", "business", "product"]), NO_TEST_CARDS = /\.[cm]?[jt]sx?$/, ROUTE_SYMBOL = /^(?:__route__[A-Z]+__\/|[A-Z]+ \/)/, BARREL_FILE = /(^|\/)(index\.[cm]?[jt]sx?|__init__\.py|mod\.rs)$/, CODE_FACTS = {
+  "api.operation": ["http_method", "http_path"]
+}, EDGE_LABELS = {
+  DEPLOYS: { oneEndOf: ["Resource", "Image"], why: "links infrastructure resources and images" },
+  INFRA_MAPS: { oneEndOf: ["Resource"], why: "links infrastructure resources" },
+  DEPENDS_ON: { oneEndOf: ["Package", "Image", "Resource"], why: "links packages, images and resources" },
+  SPAWNS: { oneEndOf: ["Process"], why: "links code to the processes it launches" }
+}, EDGE_ENDPOINTS = {
+  DEFINES_METHOD: {
+    to: (element) => {
+      const symbols = sourceLocations(element).map((l) => l.symbol).filter((s) => !!s);
+      return symbols.length === 0 || symbols.some((s) => s.includes("."));
+    },
+    why: "links a class to its methods only, and this function is not a method"
+  }
+};
+function catalogHasTriple(id) {
+  const parts = id.split(".");
+  return parts.length !== 5 ? !1 : getValidRelationships(`${parts[0]}.${parts[1]}`, parts[2], `${parts[3]}.${parts[4]}`).length > 0;
+}
+function sourceLocations(element) {
+  return (element.sourceReference?.locations ?? []).filter((l) => typeof l?.file == "string" && l.file.length > 0).map((l) => ({ file: l.file.replace(/\\/g, "/").replace(/^\.\//, ""), ...l.symbol ? { symbol: l.symbol } : {} }));
+}
+class ExtractionCoverage {
+  analyzer;
+  producers = /* @__PURE__ */ new Map();
+  /** Layers a Tier-0 rule narrows to with `layer.*`. */
+  wildcardLayers = /* @__PURE__ */ new Map();
+  /** Attributes the node mapping fills, by element type. */
+  filled = /* @__PURE__ */ new Map();
+  edgeMappings;
+  hasTriple;
+  tripleCache = /* @__PURE__ */ new Map();
+  constructor(input) {
+    this.analyzer = input.analyzer, this.hasTriple = input.hasTriple ?? catalogHasTriple;
+    const add = (type, producer) => {
+      const list = this.producers.get(type) ?? [];
+      list.push(producer), this.producers.set(type, list);
+    }, fill = (type, attributes) => {
+      const set = this.filled.get(type) ?? /* @__PURE__ */ new Set();
+      for (const a of attributes)
+        set.add(a);
+      this.filled.set(type, set);
+    }, labels = /* @__PURE__ */ new Set();
+    for (const m of input.nodeMappings) {
+      if (!m.dr_layer || !m.dr_element_type)
+        continue;
+      labels.add(m.cbm_label);
+      const producer = { via: `node mapping ${m.cbm_label}`, label: m.cbm_label }, mapped = m, attributes = [
+        ...(mapped.attribute_mappings ?? []).map((a) => a.dr_attribute).filter((a) => !!a),
+        ...Object.keys(m.dr_element_fields ?? {})
+      ];
+      for (const type of [m.dr_element_type, mapped.dr_element_type_promoted].filter((t) => !!t))
+        add(`${m.dr_layer}.${type}`, producer), fill(`${m.dr_layer}.${type}`, attributes);
+    }
+    for (const rule of input.rules) {
+      if (rule.action.kind === "reject")
+        continue;
+      for (const label of rule.labels)
+        labels.add(label);
+      const producer = { via: `Tier-0 rule ${rule.name}`, ...rule.when.file ? { file: rule.when.file } : {} };
+      if (rule.action.kind === "decide")
+        add(`${rule.action.layer}.${rule.action.type}`, producer);
+      else
+        for (const c of rule.action.candidates)
+          c.type ? add(`${c.layer}.${c.type}`, producer) : this.wildcardLayers.set(c.layer, [...this.wildcardLayers.get(c.layer) ?? [], producer]);
+    }
+    for (const [type, facts] of Object.entries(CODE_FACTS))
+      fill(type, facts);
+    this.edgeMappings = input.edgeMappings.filter((m) => m.usage === "verification_and_mapping" && (!EDGE_LABELS[m.cbm_edge] || EDGE_LABELS[m.cbm_edge].oneEndOf.some((l) => labels.has(l))));
+  }
+  /** Element types extraction can produce at all (`layer.type`), sorted. */
+  observableTypes() {
+    return [...this.producers.keys()].sort();
+  }
+  /**
+   * Whether extraction could produce this element. `codeFiles` are the files the build was
+   * extracted from; they stand in for the element's own source file when it names none.
+   */
+  element(element, codeFiles = []) {
+    const type = `${element.layer}.${element.type}`;
+    if (NEVER_OBSERVABLE_LAYERS.has(element.layer))
+      return { observable: !1, reason: `extraction does not read intent (${element.layer}) from code` };
+    const producers = [...this.producers.get(type) ?? [], ...this.wildcardLayers.get(element.layer) ?? []];
+    if (producers.length === 0)
+      return { observable: !1, reason: `the ${this.analyzer} mapping produces no ${type} elements` };
+    const locations = sourceLocations(element), files = locations.length > 0 ? locations.map((l) => l.file) : codeFiles;
+    if (element.layer === "testing" && files.length > 0 && files.every((f) => NO_TEST_CARDS.test(f)))
+      return {
+        observable: !1,
+        reason: "JavaScript and TypeScript test cases are anonymous callbacks and never become extraction cards"
+      };
+    const unlocated = isUnlocatedOperation(element, locations);
+    if (producers.filter((p) => !(p.file && locations.length > 0 && !locations.some((l) => p.file.test(l.file)) || p.label === "Route" && (unlocated || isReExport(element, locations)))).length === 0) {
+      const routeOnly = producers.every((p) => p.label === "Route");
+      return {
+        observable: !1,
+        ...routeOnly && unlocated ? { unlocated: !0 } : {},
+        reason: routeOnly ? unlocated ? `extraction produces ${type} only from HTTP routes, and this one has no method, path or source reference to find it by. To make it verifiable, give it http_method and http_path (for a route), or sourceFile and sourceSymbol (the handler that serves it)` : `extraction produces ${type} only from HTTP routes, and this one is a re-export from ${locations.map((l) => l.file).join(", ")} with no method and path` : `no ${this.analyzer} rule producing ${type} applies to ${locations.map((l) => l.file).join(", ")}`
+      };
+    }
+    return { observable: !0 };
+  }
+  /**
+   * Whether extraction writes this field of an element of this type: the name and type, the
+   * attributes the node mapping fills, and the code facts it reads (an operation's method and
+   * path). Never the description, which comes from a docstring at most, or other attributes.
+   */
+  field(element, field) {
+    return field === "name" || field === "type" ? !0 : field.startsWith("attributes.") ? this.filled.get(`${element.layer}.${element.type}`)?.has(field.slice(11)) ?? !1 : !1;
+  }
+  /**
+   * Whether some mapped code edge between these two elements becomes this relationship: by their
+   * types, as extraction decides it, and by what the edge links (see EDGE_LABELS, EDGE_ENDPOINTS).
+   */
+  relationship(source, predicate, target) {
+    const sourceType = `${source.layer}.${source.type}`, targetType = `${target.layer}.${target.type}`, key = `${sourceType}|${predicate}|${targetType}`;
+    let edges = this.tripleCache.get(key);
+    if (edges === void 0) {
+      edges = [];
+      for (const m of this.edgeMappings)
+        for (const inverted of [!1, !0]) {
+          const [from, to] = inverted ? [targetType, sourceType] : [sourceType, targetType], r = relationshipFor(m, from, to, this.hasTriple);
+          r && r.source === sourceType && r.destination === targetType && r.predicate === predicate && edges.push({ edge: m.cbm_edge, inverted });
+        }
+      this.tripleCache.set(key, edges);
+    }
+    return edges.length === 0 ? { observable: !1, reason: `the ${this.analyzer} edge mapping turns no code edge into ${sourceType} ${predicate} ${targetType}` } : edges.filter(({ edge, inverted }) => {
+      const check = EDGE_ENDPOINTS[edge]?.to;
+      return !check || check(inverted ? source : target);
+    }).length === 0 ? {
+      observable: !1,
+      reason: edges.map(({ edge }) => `${edge} ${EDGE_ENDPOINTS[edge]?.why ?? "does not apply"}`).join("; ")
+    } : { observable: !0 };
+  }
+}
+function isReExport(element, locations) {
+  const attrs = element.attributes ?? {};
+  return attrs.http_method || attrs.http_path || attrs.method || attrs.path || locations.length === 0 ? !1 : locations.every((l) => BARREL_FILE.test(l.file) && !(l.symbol && ROUTE_SYMBOL.test(l.symbol)));
+}
+function isUnlocatedOperation(element, locations) {
+  const attrs = element.attributes ?? {};
+  return attrs.http_method || attrs.http_path || attrs.method || attrs.path ? !1 : locations.length === 0;
+}
+async function loadExtractionCoverage(analyzer) {
+  try {
+    const mapper = await MappingLoader.load(analyzer), nodeMappings = mapper.getNodeLabels().map((label) => mapper.getNodeMapping(label)).filter((m) => !!m), edgeMappings = mapper.getEdgeTypes().map((type) => mapper.getEdgeMapping(type)).filter((m) => !!m);
+    return new ExtractionCoverage({ analyzer, nodeMappings, edgeMappings, rules: tier0RulesFrom(mapper.getHeuristics()) });
+  } catch {
+    return null;
+  }
+}
+export {
+  ExtractionCoverage,
+  loadExtractionCoverage
+};
+//# sourceMappingURL=extraction-observability.js.map

package/dist/core/extraction-observability.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/extraction-observability.ts"],
+  "sourcesContent": ["/**\n * Extraction observability \u2014 which planned elements, relationships and fields code extraction can\n * see.\n *\n * `changeset_verify` compares a plan with an as-built changeset. When the as-built side came from\n * `codebase_extract`, a planned element extraction can never produce (a requirement, a re-export,\n * a TypeScript test case) is not \"missing\": it is unverifiable, and stays out of the verdict.\n *\n * What extraction can produce is read from the analyzer's own mapping (spec/analyzers/<name>/):\n *\n * - the node mapping: each CBM label becomes one element type (and a promoted type), and fills some\n *   of its attributes;\n * - the Tier-0 rules: each decides or narrows to element types, some only for files matching a\n *   pattern;\n * - the edge mapping: each mapped CBM edge becomes a relationship between two element types,\n *   through the relationship catalog and the edge's from_types and to_types, the way\n *   `relationshipFor` decides it during extraction.\n *\n * Facts the mapping files don't state are kept here, each with its reason:\n *\n * - a Route is an HTTP route: an operation sourced to a barrel file (a package entry that\n *   re-exports) with no method and path is not one, and an operation with no method, no path and\n *   no source reference gives extraction nothing to find it by;\n * - some CBM edges link labels no node mapping or Tier-0 rule produces (DEPLOYS links\n *   infrastructure resources), so they make no relationship at all;\n * - DEFINES_METHOD links a class to its methods, not a module to its functions;\n * - the card builder makes no cards for JavaScript and TypeScript test cases (anonymous `it()`\n *   callbacks), so the testing layer is not observable in those files (docs/EXTRACTION_STRATEGY.md,\n *   \"Known gap\");\n * - extraction writes an operation's method and path (`http_method`, `http_path`) besides the\n *   node mapping's fields.\n *\n * Intent (motivation, business, product) is never read from code.\n */\n\nimport { MappingLoader } from \"../analyzers/mapping-loader.js\";\nimport { relationshipFor } from \"../analyzers/edge-relationships.js\";\nimport { tier0RulesFrom, type Tier0Rule } from \"../analyzers/tier0-rules.js\";\nimport type { AnalyzerEdgeMapping, AnalyzerNodeMapping } from \"../analyzers/types.js\";\nimport { getValidRelationships } from \"../generated/relationship-index.js\";\nimport type { SourceReference } from \"../types/source-reference.js\";\n\n/** Layers that state intent; no code says why the system exists. */\nconst NEVER_OBSERVABLE_LAYERS = new Set([\"motivation\", \"business\", \"product\"]);\n\n/** Files the card builder makes no test cards for: JS/TS test cases are anonymous callbacks. */\nconst NO_TEST_CARDS = /\\.[cm]?[jt]sx?$/;\n\n/** A Route's symbol: `GET /owners/{id}` or CBM's `__route__GET__/owners/{id}`. */\nconst ROUTE_SYMBOL = /^(?:__route__[A-Z]+__\\/|[A-Z]+ \\/)/;\n\n/** Barrel files: a package entry that re-exports what other files define. */\nconst BARREL_FILE = /(^|\\/)(index\\.[cm]?[jt]sx?|__init__\\.py|mod\\.rs)$/;\n\n/** Attributes extraction writes from the code beyond the node mapping (see deriveAttributes). */\nconst CODE_FACTS: Record<string, string[]> = {\n  \"api.operation\": [\"http_method\", \"http_path\"],\n};\n\n/**\n * CBM edges whose ends are particular labels. An edge one of whose ends must be a label no node\n * mapping or Tier-0 rule produces makes no relationship: its ends never become elements.\n */\nconst EDGE_LABELS: Record<string, { oneEndOf: string[]; why: string }> = {\n  DEPLOYS: { oneEndOf: [\"Resource\", \"Image\"], why: \"links infrastructure resources and images\" },\n  INFRA_MAPS: { oneEndOf: [\"Resource\"], why: \"links infrastructure resources\" },\n  DEPENDS_ON: { oneEndOf: [\"Package\", \"Image\", \"Resource\"], why: \"links packages, images and resources\" },\n  SPAWNS: { oneEndOf: [\"Process\"], why: \"links code to the processes it launches\" },\n};\n\n/**\n * CBM edges that link only some symbols of their element types, by which end (in CBM's direction)\n * must be what. DEFINES_METHOD runs from a class to its methods: a module-level function, whose\n * symbol names no owner (`computeNodeDegrees`, not `OwnerController.initCreationForm`), has none.\n */\nconst EDGE_ENDPOINTS: Record<string, { to?: (element: ObservedElement) => boolean; why: string }> = {\n  DEFINES_METHOD: {\n    to: (element) => {\n      const symbols = sourceLocations(element)\n        .map((l) => l.symbol)\n        .filter((s): s is string => !!s);\n      return symbols.length === 0 || symbols.some((s) => s.includes(\".\"));\n    },\n    why: \"links a class to its methods only, and this function is not a method\",\n  },\n};\n\n/** What an element looks like to the observability check. */\nexport interface ObservedElement {\n  layer: string;\n  type: string;\n  attributes?: Record<string, unknown>;\n  sourceReference?: SourceReference;\n}\n\nexport interface ObservabilityVerdict {\n  observable: boolean;\n  /** Why not, when it is not. */\n  reason?: string;\n  /**\n   * Not observable only for want of a method, path or source reference to find it by (an operation\n   * planned with no source fields): the build may still have it under another name.\n   */\n  unlocated?: true;\n}\n\n/** One way extraction produces an element type. */\ninterface Producer {\n  /** `node mapping <Label>` or `Tier-0 rule <name>`. */\n  via: string;\n  /** For a node mapping: the CBM label. */\n  label?: string;\n  /** For a Tier-0 rule with a file condition: the files it applies to. */\n  file?: RegExp;\n}\n\nexport interface ExtractionCoverageInput {\n  analyzer: string;\n  nodeMappings: AnalyzerNodeMapping[];\n  edgeMappings: AnalyzerEdgeMapping[];\n  rules: Tier0Rule[];\n  /** Catalog check by triple id (`layer.type.predicate.layer.type`); defaults to the generated index. */\n  hasTriple?: (id: string) => boolean;\n}\n\nfunction catalogHasTriple(id: string): boolean {\n  const parts = id.split(\".\");\n  if (parts.length !== 5) return false;\n  return getValidRelationships(`${parts[0]}.${parts[1]}`, parts[2], `${parts[3]}.${parts[4]}`).length > 0;\n}\n\nfunction sourceLocations(element: ObservedElement): Array<{ file: string; symbol?: string }> {\n  return (element.sourceReference?.locations ?? [])\n    .filter((l) => typeof l?.file === \"string\" && l.file.length > 0)\n    .map((l) => ({ file: l.file.replace(/\\\\/g, \"/\").replace(/^\\.\\//, \"\"), ...(l.symbol ? { symbol: l.symbol } : {}) }));\n}\n\n/** What an analyzer's extraction can produce, by element type, relationship triple and field. */\nexport class ExtractionCoverage {\n  readonly analyzer: string;\n  private readonly producers = new Map<string, Producer[]>();\n  /** Layers a Tier-0 rule narrows to with `layer.*`. */\n  private readonly wildcardLayers = new Map<string, Producer[]>();\n  /** Attributes the node mapping fills, by element type. */\n  private readonly filled = new Map<string, Set<string>>();\n  private readonly edgeMappings: AnalyzerEdgeMapping[];\n  private readonly hasTriple: (id: string) => boolean;\n  private readonly tripleCache = new Map<string, Array<{ edge: string; inverted: boolean }>>();\n\n  constructor(input: ExtractionCoverageInput) {\n    this.analyzer = input.analyzer;\n    this.hasTriple = input.hasTriple ?? catalogHasTriple;\n    const add = (type: string, producer: Producer) => {\n      const list = this.producers.get(type) ?? [];\n      list.push(producer);\n      this.producers.set(type, list);\n    };\n    const fill = (type: string, attributes: string[]) => {\n      const set = this.filled.get(type) ?? new Set<string>();\n      for (const a of attributes) set.add(a);\n      this.filled.set(type, set);\n    };\n    // Labels whose symbols can become elements, by the node mapping or a Tier-0 rule.\n    const labels = new Set<string>();\n    for (const m of input.nodeMappings) {\n      if (!m.dr_layer || !m.dr_element_type) continue;\n      labels.add(m.cbm_label);\n      const producer = { via: `node mapping ${m.cbm_label}`, label: m.cbm_label };\n      const mapped = m as AnalyzerNodeMapping & {\n        dr_element_type_promoted?: string;\n        attribute_mappings?: Array<{ dr_attribute?: string }>;\n      };\n      const attributes = [\n        ...(mapped.attribute_mappings ?? []).map((a) => a.dr_attribute).filter((a): a is string => !!a),\n        ...Object.keys(m.dr_element_fields ?? {}),\n      ];\n      for (const type of [m.dr_element_type, mapped.dr_element_type_promoted].filter((t): t is string => !!t)) {\n        add(`${m.dr_layer}.${type}`, producer);\n        fill(`${m.dr_layer}.${type}`, attributes);\n      }\n    }\n    for (const rule of input.rules) {\n      if (rule.action.kind === \"reject\") continue;\n      for (const label of rule.labels) labels.add(label);\n      const producer: Producer = { via: `Tier-0 rule ${rule.name}`, ...(rule.when.file ? { file: rule.when.file } : {}) };\n      if (rule.action.kind === \"decide\") add(`${rule.action.layer}.${rule.action.type}`, producer);\n      else {\n        for (const c of rule.action.candidates) {\n          if (c.type) add(`${c.layer}.${c.type}`, producer);\n          else this.wildcardLayers.set(c.layer, [...(this.wildcardLayers.get(c.layer) ?? []), producer]);\n        }\n      }\n    }\n    for (const [type, facts] of Object.entries(CODE_FACTS)) fill(type, facts);\n    this.edgeMappings = input.edgeMappings.filter(\n      (m) => m.usage === \"verification_and_mapping\" && (!EDGE_LABELS[m.cbm_edge] || EDGE_LABELS[m.cbm_edge].oneEndOf.some((l) => labels.has(l)))\n    );\n  }\n\n  /** Element types extraction can produce at all (`layer.type`), sorted. */\n  observableTypes(): string[] {\n    return [...this.producers.keys()].sort();\n  }\n\n  /**\n   * Whether extraction could produce this element. `codeFiles` are the files the build was\n   * extracted from; they stand in for the element's own source file when it names none.\n   */\n  element(element: ObservedElement, codeFiles: string[] = []): ObservabilityVerdict {\n    const type = `${element.layer}.${element.type}`;\n    if (NEVER_OBSERVABLE_LAYERS.has(element.layer)) {\n      return { observable: false, reason: `extraction does not read intent (${element.layer}) from code` };\n    }\n    const producers = [...(this.producers.get(type) ?? []), ...(this.wildcardLayers.get(element.layer) ?? [])];\n    if (producers.length === 0) {\n      return { observable: false, reason: `the ${this.analyzer} mapping produces no ${type} elements` };\n    }\n\n    const locations = sourceLocations(element);\n    const files = locations.length > 0 ? locations.map((l) => l.file) : codeFiles;\n    if (element.layer === \"testing\" && files.length > 0 && files.every((f) => NO_TEST_CARDS.test(f))) {\n      return {\n        observable: false,\n        reason: \"JavaScript and TypeScript test cases are anonymous callbacks and never become extraction cards\",\n      };\n    }\n\n    const unlocated = isUnlocatedOperation(element, locations);\n    const possible = producers.filter((p) => {\n      if (p.file && locations.length > 0 && !locations.some((l) => p.file!.test(l.file))) return false;\n      if (p.label === \"Route\" && (unlocated || isReExport(element, locations))) return false;\n      return true;\n    });\n    if (possible.length === 0) {\n      const routeOnly = producers.every((p) => p.label === \"Route\");\n      return {\n        observable: false,\n        ...(routeOnly && unlocated ? { unlocated: true as const } : {}),\n        reason: !routeOnly\n          ? `no ${this.analyzer} rule producing ${type} applies to ${locations.map((l) => l.file).join(\", \")}`\n          : unlocated\n            ? `extraction produces ${type} only from HTTP routes, and this one has no method, path or source reference to find ` +\n              \"it by. To make it verifiable, give it http_method and http_path (for a route), or sourceFile and sourceSymbol \" +\n              \"(the handler that serves it)\"\n            : `extraction produces ${type} only from HTTP routes, and this one is a re-export from ${locations.map((l) => l.file).join(\", \")} with no method and path`,\n      };\n    }\n    return { observable: true };\n  }\n\n  /**\n   * Whether extraction writes this field of an element of this type: the name and type, the\n   * attributes the node mapping fills, and the code facts it reads (an operation's method and\n   * path). Never the description, which comes from a docstring at most, or other attributes.\n   */\n  field(element: ObservedElement, field: string): boolean {\n    if (field === \"name\" || field === \"type\") return true;\n    if (!field.startsWith(\"attributes.\")) return false;\n    return this.filled.get(`${element.layer}.${element.type}`)?.has(field.slice(\"attributes.\".length)) ?? false;\n  }\n\n  /**\n   * Whether some mapped code edge between these two elements becomes this relationship: by their\n   * types, as extraction decides it, and by what the edge links (see EDGE_LABELS, EDGE_ENDPOINTS).\n   */\n  relationship(source: ObservedElement, predicate: string, target: ObservedElement): ObservabilityVerdict {\n    const sourceType = `${source.layer}.${source.type}`;\n    const targetType = `${target.layer}.${target.type}`;\n    const key = `${sourceType}|${predicate}|${targetType}`;\n    let edges = this.tripleCache.get(key);\n    if (edges === undefined) {\n      // Each producing edge, with the CBM edge's own ends: `inverted` when it runs target \u2192 source.\n      edges = [];\n      for (const m of this.edgeMappings) {\n        for (const inverted of [false, true]) {\n          const [from, to] = inverted ? [targetType, sourceType] : [sourceType, targetType];\n          const r = relationshipFor(m, from, to, this.hasTriple);\n          if (r && r.source === sourceType && r.destination === targetType && r.predicate === predicate) {\n            edges.push({ edge: m.cbm_edge, inverted });\n          }\n        }\n      }\n      this.tripleCache.set(key, edges);\n    }\n    if (edges.length === 0) {\n      return { observable: false, reason: `the ${this.analyzer} edge mapping turns no code edge into ${sourceType} ${predicate} ${targetType}` };\n    }\n    const possible = edges.filter(({ edge, inverted }) => {\n      const check = EDGE_ENDPOINTS[edge]?.to;\n      return !check || check(inverted ? source : target);\n    });\n    if (possible.length === 0) {\n      return {\n        observable: false,\n        reason: edges.map(({ edge }) => `${edge} ${EDGE_ENDPOINTS[edge]?.why ?? \"does not apply\"}`).join(\"; \"),\n      };\n    }\n    return { observable: true };\n  }\n}\n\n/**\n * A re-export, not a route: no method and path, sourced to a barrel file (a package entry), under a\n * name that isn't route-shaped. Without that evidence an operation may be a route (a handler symbol\n * such as `OwnerController.showVisits` names the code that serves it).\n */\nfunction isReExport(element: ObservedElement, locations: Array<{ file: string; symbol?: string }>): boolean {\n  const attrs = element.attributes ?? {};\n  if (attrs.http_method || attrs.http_path || attrs.method || attrs.path) return false;\n  if (locations.length === 0) return false;\n  return locations.every((l) => BARREL_FILE.test(l.file) && !(l.symbol && ROUTE_SYMBOL.test(l.symbol)));\n}\n\n/**\n * An operation planned with nothing extraction could find it by: no method or path, and no source\n * reference (so no handler or route symbol either). Extraction finds operations only as routes, by\n * method and path or by the handler's file and symbol, so it can't show such a one either way.\n */\nfunction isUnlocatedOperation(element: ObservedElement, locations: Array<{ file: string; symbol?: string }>): boolean {\n  const attrs = element.attributes ?? {};\n  if (attrs.http_method || attrs.http_path || attrs.method || attrs.path) return false;\n  return locations.length === 0;\n}\n\n/** The coverage of an analyzer's bundled mapping, or null when it can't be read. */\nexport async function loadExtractionCoverage(analyzer: string): Promise<ExtractionCoverage | null> {\n  try {\n    const mapper = await MappingLoader.load(analyzer);\n    const nodeMappings = mapper\n      .getNodeLabels()\n      .map((label) => mapper.getNodeMapping(label))\n      .filter((m): m is AnalyzerNodeMapping => !!m);\n    const edgeMappings = mapper\n      .getEdgeTypes()\n      .map((type) => mapper.getEdgeMapping(type))\n      .filter((m): m is AnalyzerEdgeMapping => !!m);\n    return new ExtractionCoverage({ analyzer, nodeMappings, edgeMappings, rules: tier0RulesFrom(mapper.getHeuristics()) });\n  } catch {\n    return null;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/farm-manifest.js

@@ -3,15 +3,21 @@ import { readFile, writeFile } from "../utils/file-io.js";
 function validateFarmProject(project, projectKey) {
   if (!project || typeof project != "object")
     throw new Error(`Invalid project entry "${projectKey}": expected object, got ${typeof project}`);
-  if (typeof project.name != "string" || project.name === "")
+  const p = project;
+  if (typeof p.name != "string" || p.name === "")
     throw new Error(`Project "${projectKey}" is missing required 'name' field. Each project must have name, source, and model fields.`);
-  if (typeof project.source != "string" || project.source === "")
+  if (typeof p.source != "string" || p.source === "")
     throw new Error(`Project "${projectKey}" is missing required 'source' field. Each project must have name, source, and model fields.`);
-  if (typeof project.model != "string" || project.model === "")
+  if (typeof p.model != "string" || p.model === "")
     throw new Error(`Project "${projectKey}" is missing required 'model' field. Each project must have name, source, and model fields.`);
-  if (project.name !== projectKey)
-    throw new Error(`Project name mismatch: key is "${projectKey}" but project.name is "${project.name}". They must match for consistent sync state tracking.`);
-  return project;
+  if (p.name !== projectKey)
+    throw new Error(`Project name mismatch: key is "${projectKey}" but project.name is "${p.name}". They must match for consistent sync state tracking.`);
+  const validatedProject = {
+    name: p.name,
+    source: p.source,
+    model: p.model
+  };
+  return typeof p.remote == "string" && (validatedProject.remote = p.remote), typeof p.branch == "string" && (validatedProject.branch = p.branch), validatedProject;
 }
 class FarmManifest {
   schema;

package/dist/core/farm-manifest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/core/farm-manifest.ts"],
-  "sourcesContent": ["/**\n * Farm Manifest - Manages farm.yaml configuration\n *\n * Represents a farm context containing multiple projects with detached model folders.\n * The farm manifest tracks project registrations and their model folder locations.\n */\n\nimport yaml from \"yaml\";\nimport { readFile, writeFile } from \"../utils/file-io.js\";\n\n/**\n * Represents a project registered in a farm\n */\nexport interface FarmProject {\n  name: string;\n  source: string; // Path to the codebase folder (relative to farm root)\n  model: string; // Path to the model folder (relative to farm root)\n  remote?: string; // Optional git remote URL\n  branch?: string; // Optional git branch\n}\n\n// Validate project object has required fields and key/name consistency\nfunction validateFarmProject(project: any, projectKey: string): FarmProject {\n  if (!project || typeof project !== \"object\") {\n    throw new Error(\n      `Invalid project entry \"${projectKey}\": expected object, got ${typeof project}`\n    );\n  }\n\n  if (typeof project.name !== \"string\" || project.name === \"\") {\n    throw new Error(\n      `Project \"${projectKey}\" is missing required 'name' field. ` +\n      `Each project must have name, source, and model fields.`\n    );\n  }\n\n  if (typeof project.source !== \"string\" || project.source === \"\") {\n    throw new Error(\n      `Project \"${projectKey}\" is missing required 'source' field. ` +\n      `Each project must have name, source, and model fields.`\n    );\n  }\n\n  if (typeof project.model !== \"string\" || project.model === \"\") {\n    throw new Error(\n      `Project \"${projectKey}\" is missing required 'model' field. ` +\n      `Each project must have name, source, and model fields.`\n    );\n  }\n\n  if (project.name !== projectKey) {\n    throw new Error(\n      `Project name mismatch: key is \"${projectKey}\" but project.name is \"${project.name}\". ` +\n      `They must match for consistent sync state tracking.`\n    );\n  }\n\n  return project as FarmProject;\n}\n\n/**\n * Farm manifest data structure\n */\nexport interface FarmManifestData {\n  schema: string; // Schema version (e.g., \"dr-farm-v1\")\n  name: string; // Human-readable farm name\n  created?: string; // ISO 8601 timestamp\n  modified?: string; // ISO 8601 timestamp\n  projects: Record<string, FarmProject>; // Projects indexed by name\n  platform_view?: boolean; // Optional: Enable platform view mode\n  sync?: {\n    track_commits?: boolean; // Optional: Track commits during sync\n  };\n}\n\n/**\n * FarmManifest class - Load, validate, and save farm.yaml\n */\nexport class FarmManifest {\n  schema: string;\n  name: string;\n  created: string;\n  modified: string;\n  projects: Map<string, FarmProject>;\n  platform_view?: boolean;\n  sync?: {\n    track_commits?: boolean;\n  };\n  filePath?: string;\n\n  constructor(data: FarmManifestData) {\n    this.schema = data.schema;\n    this.name = data.name;\n    this.created = data.created ?? new Date().toISOString();\n    this.modified = data.modified ?? new Date().toISOString();\n    this.projects = new Map(Object.entries(data.projects || {}));\n    this.platform_view = data.platform_view;\n    this.sync = data.sync;\n  }\n\n  /**\n   * Load farm manifest from file\n   * @param filePath - Path to farm.yaml\n   * @returns FarmManifest instance\n   * @throws Error if manifest is malformed or projects lack required fields\n   */\n  static async load(filePath: string): Promise<FarmManifest> {\n    const content = await readFile(filePath);\n    const data = yaml.parse(content) as FarmManifestData;\n\n    if (!data) {\n      throw new Error(\n        `Invalid farm manifest: file is empty or contains invalid YAML at ${filePath}`\n      );\n    }\n\n    if (!data.schema) {\n      throw new Error(\"Farm manifest must have a 'schema' field\");\n    }\n\n    if (!data.name) {\n      throw new Error(\"Farm manifest must have a 'name' field\");\n    }\n\n    if (!data.projects) {\n      data.projects = {};\n    } else {\n      // Validate each project has required fields before proceeding\n      for (const [key, project] of Object.entries(data.projects)) {\n        data.projects[key] = validateFarmProject(project, key);\n      }\n    }\n\n    const manifest = new FarmManifest(data);\n    manifest.filePath = filePath;\n    return manifest;\n  }\n\n  /**\n   * Create a new farm manifest\n   * @param name - Farm name\n   * @param options - Optional additional properties\n   * @returns FarmManifest instance\n   */\n  static create(\n    name: string,\n    options: {\n      platform_view?: boolean;\n      sync?: {\n        track_commits?: boolean;\n      };\n    } = {}\n  ): FarmManifest {\n    return new FarmManifest({\n      schema: \"dr-farm-v1\",\n      name,\n      created: new Date().toISOString(),\n      modified: new Date().toISOString(),\n      projects: {},\n      platform_view: options.platform_view,\n      sync: options.sync,\n    });\n  }\n\n  /**\n   * Save manifest to file\n   * @param filePath - Path where to save farm.yaml\n   */\n  async save(filePath?: string): Promise<void> {\n    const targetPath = filePath || this.filePath;\n    if (!targetPath) {\n      throw new Error(\"No file path specified for saving farm manifest\");\n    }\n\n    this.modified = new Date().toISOString();\n    const data = this.toJSON();\n    const yamlContent = yaml.stringify(data, { lineWidth: 0 });\n\n    await writeFile(targetPath, yamlContent);\n    this.filePath = targetPath;\n  }\n\n  // Add a project to the farm; ensures name parameter matches project.name\n  addProject(name: string, project: FarmProject): void {\n    if (project.name !== name) {\n      throw new Error(\n        `Project name mismatch: key is \"${name}\" but project.name is \"${project.name}\". ` +\n        `They must match for consistent sync state tracking. ` +\n        `Downstream code reads project.name for changeset names and sync state paths.`\n      );\n    }\n\n    this.projects.set(name, project);\n    this.modified = new Date().toISOString();\n  }\n\n  /**\n   * Remove a project from the farm\n   * @param name - Project name to remove\n   * @returns true if project was removed, false if not found\n   */\n  removeProject(name: string): boolean {\n    const existed = this.projects.has(name);\n    this.projects.delete(name);\n    if (existed) {\n      this.modified = new Date().toISOString();\n    }\n    return existed;\n  }\n\n  /**\n   * Get a project by name\n   * @param name - Project name\n   * @returns Project configuration or undefined\n   */\n  getProject(name: string): FarmProject | undefined {\n    return this.projects.get(name);\n  }\n\n  /**\n   * Get all projects\n   * @returns Array of all projects\n   */\n  getAllProjects(): FarmProject[] {\n    return Array.from(this.projects.values());\n  }\n\n  /**\n   * Check if platform-view is enabled on this farm\n   * @returns true if platform-view is enabled\n   */\n  isPlatformViewEnabled(): boolean {\n    return this.platform_view === true;\n  }\n\n  /**\n   * Serialize to JSON representation for saving\n   */\n  toJSON(): FarmManifestData {\n    return {\n      schema: this.schema,\n      name: this.name,\n      created: this.created,\n      modified: this.modified,\n      projects: Object.fromEntries(this.projects),\n      ...(this.platform_view !== undefined && { platform_view: this.platform_view }),\n      ...(this.sync && { sync: this.sync }),\n    };\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Farm Manifest - Manages farm.yaml configuration\n *\n * Represents a farm context containing multiple projects with detached model folders.\n * The farm manifest tracks project registrations and their model folder locations.\n */\n\nimport yaml from \"yaml\";\nimport { readFile, writeFile } from \"../utils/file-io.js\";\n\n/**\n * Represents a project registered in a farm\n */\nexport interface FarmProject {\n  name: string;\n  source: string; // Path to the codebase folder (relative to farm root)\n  model: string; // Path to the model folder (relative to farm root)\n  remote?: string; // Optional git remote URL\n  branch?: string; // Optional git branch\n}\n\n// Validate project object has required fields and key/name consistency\nfunction validateFarmProject(project: unknown, projectKey: string): FarmProject {\n  if (!project || typeof project !== \"object\") {\n    throw new Error(\n      `Invalid project entry \"${projectKey}\": expected object, got ${typeof project}`\n    );\n  }\n\n  const p = project as Record<string, unknown>;\n\n  if (typeof p.name !== \"string\" || p.name === \"\") {\n    throw new Error(\n      `Project \"${projectKey}\" is missing required 'name' field. ` +\n      `Each project must have name, source, and model fields.`\n    );\n  }\n\n  if (typeof p.source !== \"string\" || p.source === \"\") {\n    throw new Error(\n      `Project \"${projectKey}\" is missing required 'source' field. ` +\n      `Each project must have name, source, and model fields.`\n    );\n  }\n\n  if (typeof p.model !== \"string\" || p.model === \"\") {\n    throw new Error(\n      `Project \"${projectKey}\" is missing required 'model' field. ` +\n      `Each project must have name, source, and model fields.`\n    );\n  }\n\n  if (p.name !== projectKey) {\n    throw new Error(\n      `Project name mismatch: key is \"${projectKey}\" but project.name is \"${p.name}\". ` +\n      `They must match for consistent sync state tracking.`\n    );\n  }\n\n  const validatedProject: FarmProject = {\n    name: p.name,\n    source: p.source,\n    model: p.model,\n  };\n\n  if (typeof p.remote === \"string\") {\n    validatedProject.remote = p.remote;\n  }\n\n  if (typeof p.branch === \"string\") {\n    validatedProject.branch = p.branch;\n  }\n\n  return validatedProject;\n}\n\n/**\n * Farm manifest data structure\n */\nexport interface FarmManifestData {\n  schema: string; // Schema version (e.g., \"dr-farm-v1\")\n  name: string; // Human-readable farm name\n  created?: string; // ISO 8601 timestamp\n  modified?: string; // ISO 8601 timestamp\n  projects: Record<string, FarmProject>; // Projects indexed by name\n  platform_view?: boolean; // Optional: Enable platform view mode\n  sync?: {\n    track_commits?: boolean; // Optional: Track commits during sync\n  };\n}\n\n/**\n * FarmManifest class - Load, validate, and save farm.yaml\n */\nexport class FarmManifest {\n  schema: string;\n  name: string;\n  created: string;\n  modified: string;\n  projects: Map<string, FarmProject>;\n  platform_view?: boolean;\n  sync?: {\n    track_commits?: boolean;\n  };\n  filePath?: string;\n\n  constructor(data: FarmManifestData) {\n    this.schema = data.schema;\n    this.name = data.name;\n    this.created = data.created ?? new Date().toISOString();\n    this.modified = data.modified ?? new Date().toISOString();\n    this.projects = new Map(Object.entries(data.projects || {}));\n    this.platform_view = data.platform_view;\n    this.sync = data.sync;\n  }\n\n  /**\n   * Load farm manifest from file\n   * @param filePath - Path to farm.yaml\n   * @returns FarmManifest instance\n   * @throws Error if manifest is malformed or projects lack required fields\n   */\n  static async load(filePath: string): Promise<FarmManifest> {\n    const content = await readFile(filePath);\n    const data = yaml.parse(content) as FarmManifestData;\n\n    if (!data) {\n      throw new Error(\n        `Invalid farm manifest: file is empty or contains invalid YAML at ${filePath}`\n      );\n    }\n\n    if (!data.schema) {\n      throw new Error(\"Farm manifest must have a 'schema' field\");\n    }\n\n    if (!data.name) {\n      throw new Error(\"Farm manifest must have a 'name' field\");\n    }\n\n    if (!data.projects) {\n      data.projects = {};\n    } else {\n      // Validate each project has required fields before proceeding\n      for (const [key, project] of Object.entries(data.projects)) {\n        data.projects[key] = validateFarmProject(project, key);\n      }\n    }\n\n    const manifest = new FarmManifest(data);\n    manifest.filePath = filePath;\n    return manifest;\n  }\n\n  /**\n   * Create a new farm manifest\n   * @param name - Farm name\n   * @param options - Optional additional properties\n   * @returns FarmManifest instance\n   */\n  static create(\n    name: string,\n    options: {\n      platform_view?: boolean;\n      sync?: {\n        track_commits?: boolean;\n      };\n    } = {}\n  ): FarmManifest {\n    return new FarmManifest({\n      schema: \"dr-farm-v1\",\n      name,\n      created: new Date().toISOString(),\n      modified: new Date().toISOString(),\n      projects: {},\n      platform_view: options.platform_view,\n      sync: options.sync,\n    });\n  }\n\n  /**\n   * Save manifest to file\n   * @param filePath - Path where to save farm.yaml\n   */\n  async save(filePath?: string): Promise<void> {\n    const targetPath = filePath || this.filePath;\n    if (!targetPath) {\n      throw new Error(\"No file path specified for saving farm manifest\");\n    }\n\n    this.modified = new Date().toISOString();\n    const data = this.toJSON();\n    const yamlContent = yaml.stringify(data, { lineWidth: 0 });\n\n    await writeFile(targetPath, yamlContent);\n    this.filePath = targetPath;\n  }\n\n  // Add a project to the farm; ensures name parameter matches project.name\n  addProject(name: string, project: FarmProject): void {\n    if (project.name !== name) {\n      throw new Error(\n        `Project name mismatch: key is \"${name}\" but project.name is \"${project.name}\". ` +\n        `They must match for consistent sync state tracking. ` +\n        `Downstream code reads project.name for changeset names and sync state paths.`\n      );\n    }\n\n    this.projects.set(name, project);\n    this.modified = new Date().toISOString();\n  }\n\n  /**\n   * Remove a project from the farm\n   * @param name - Project name to remove\n   * @returns true if project was removed, false if not found\n   */\n  removeProject(name: string): boolean {\n    const existed = this.projects.has(name);\n    this.projects.delete(name);\n    if (existed) {\n      this.modified = new Date().toISOString();\n    }\n    return existed;\n  }\n\n  /**\n   * Get a project by name\n   * @param name - Project name\n   * @returns Project configuration or undefined\n   */\n  getProject(name: string): FarmProject | undefined {\n    return this.projects.get(name);\n  }\n\n  /**\n   * Get all projects\n   * @returns Array of all projects\n   */\n  getAllProjects(): FarmProject[] {\n    return Array.from(this.projects.values());\n  }\n\n  /**\n   * Check if platform-view is enabled on this farm\n   * @returns true if platform-view is enabled\n   */\n  isPlatformViewEnabled(): boolean {\n    return this.platform_view === true;\n  }\n\n  /**\n   * Serialize to JSON representation for saving\n   */\n  toJSON(): FarmManifestData {\n    return {\n      schema: this.schema,\n      name: this.name,\n      created: this.created,\n      modified: this.modified,\n      projects: Object.fromEntries(this.projects),\n      ...(this.platform_view !== undefined && { platform_view: this.platform_view }),\n      ...(this.sync && { sync: this.sync }),\n    };\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/core/farm-sync-engine.js

@@ -157,7 +157,7 @@ class FarmSyncEngine {
   async generateChangeset(project, diff, mappings, options = {}) {
     if (!this.model)
       throw new Error("Model is required for changeset generation");
-    const projectModelPath = path.join(this.farmRoot, project.model), stagingManager = new StagingAreaManager(projectModelPath, this.model), changesetName = `farm-sync-${project.name}-${Date.now()}`, changeset = await stagingManager.create(changesetName, `Auto-generated from farm sync of ${project.name}`);
+    const stagingManager = new StagingAreaManager(this.model.rootPath, this.model), changesetName = `farm-sync-${project.name}-${Date.now()}`, changeset = await stagingManager.create(changesetName, `Auto-generated from farm sync of ${project.name}`);
     if (!changeset.id)
       throw new Error("Failed to create changeset - no ID assigned");
     const warnings = [];