@documentation-robotics/cli 0.1.0

package/dist/utils/errors.js

@@ -0,0 +1,105 @@
+import ansis from "ansis";
+class CLIError extends Error {
+  exitCode;
+  suggestions;
+  constructor(message, exitCode = 1, suggestions) {
+    super(message), this.exitCode = exitCode, this.suggestions = suggestions, this.name = "CLIError";
+  }
+  format() {
+    const lines = [];
+    if (lines.push(ansis.red(`Error: ${this.message}`)), this.suggestions && this.suggestions.length > 0) {
+      lines.push(""), lines.push(ansis.dim("Suggestions:"));
+      for (const suggestion of this.suggestions)
+        lines.push(ansis.dim(`  \u2022 ${suggestion}`));
+    }
+    return lines.join(`
+`);
+  }
+}
+class ValidationError extends CLIError {
+  errors;
+  constructor(message, errors = [], suggestions) {
+    super(message, 1, suggestions), this.errors = errors, this.name = "ValidationError";
+  }
+  format() {
+    const lines = [];
+    if (lines.push(ansis.red(`Error: ${this.message}`)), this.errors.length > 0) {
+      lines.push(""), lines.push(ansis.dim("Details:"));
+      for (const error of this.errors) {
+        let detail = "";
+        error.layer && error.elementId ? detail = `  [${error.layer}:${error.elementId}] ${error.message}` : error.layer ? detail = `  [${error.layer}] ${error.message}` : detail = `  ${error.message}`, lines.push(ansis.dim(detail));
+      }
+    }
+    if (this.suggestions && this.suggestions.length > 0) {
+      lines.push(""), lines.push(ansis.dim("Suggestions:"));
+      for (const suggestion of this.suggestions)
+        lines.push(ansis.dim(`  \u2022 ${suggestion}`));
+    }
+    return lines.join(`
+`);
+  }
+}
+class FileNotFoundError extends CLIError {
+  constructor(path, context) {
+    const message = context ? `${context}: ${path}` : `File not found: ${path}`;
+    super(message, 2, [
+      `Check that the path is correct: ${path}`,
+      'Use "dr init" to create a new model',
+      'Use "dr list <layer>" to see available elements'
+    ]), this.name = "FileNotFoundError";
+  }
+}
+class ElementNotFoundError extends CLIError {
+  constructor(elementId) {
+    super(`Element not found: ${elementId}`, 2, [
+      `Use "dr search ${elementId}" to find similar elements`,
+      'Use "dr list <layer>" to list all elements in a layer',
+      "Check the element ID format: {layer}-{type}-{kebab-case-name}"
+    ]), this.name = "ElementNotFoundError";
+  }
+}
+class ModelNotFoundError extends CLIError {
+  constructor(rootPath = ".") {
+    super(`No model found at ${rootPath}`, 2, ['Run "dr init" to initialize a new model', "Check that you are in the correct directory"]), this.name = "ModelNotFoundError";
+  }
+}
+class InvalidJSONError extends CLIError {
+  constructor(input, context) {
+    const message = context ? `Invalid JSON in ${context}` : "Invalid JSON format";
+    super(message, 1, [
+      `Check your JSON syntax: ${input}`,
+      `Use single quotes to wrap JSON: --properties '{"key":"value"}'`,
+      "Escape special characters properly"
+    ]), this.name = "InvalidJSONError";
+  }
+}
+function handleError(error) {
+  error instanceof CLIError ? (console.error(error.format()), process.exit(error.exitCode)) : error instanceof Error ? (console.error(ansis.red(`Error: ${error.message}`)), process.env.DEBUG && console.error(ansis.dim(error.stack)), process.exit(1)) : (console.error(ansis.red("An unexpected error occurred")), process.env.DEBUG && console.error(ansis.dim(String(error))), process.exit(1));
+}
+function handleWarning(message, suggestions) {
+  const lines = [];
+  if (lines.push(ansis.yellow(`Warning: ${message}`)), suggestions && suggestions.length > 0) {
+    lines.push(""), lines.push(ansis.dim("Suggestions:"));
+    for (const suggestion of suggestions)
+      lines.push(ansis.dim(`  \u2022 ${suggestion}`));
+  }
+  console.warn(lines.join(`
+`));
+}
+function handleSuccess(message, details) {
+  if (console.log(ansis.green(`\u2713 ${message}`)), details)
+    for (const [key, value] of Object.entries(details))
+      console.log(ansis.dim(`  ${key}: ${value}`));
+}
+export {
+  CLIError,
+  ElementNotFoundError,
+  FileNotFoundError,
+  InvalidJSONError,
+  ModelNotFoundError,
+  ValidationError,
+  handleError,
+  handleSuccess,
+  handleWarning
+};
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/errors.ts"],
+  "sourcesContent": ["/**\n * Error handling utilities with formatted output\n * Matches Python CLI error message formatting\n *\n * NOTE: The add.ts command demonstrates usage of CLIError.\n * Future commands should adopt this pattern to ensure consistent error handling.\n */\n\nimport ansis from 'ansis';\n\nexport class CLIError extends Error {\n  constructor(\n    message: string,\n    public exitCode: number = 1,\n    public suggestions?: string[]\n  ) {\n    super(message);\n    this.name = 'CLIError';\n  }\n\n  format(): string {\n    const lines: string[] = [];\n\n    lines.push(ansis.red(`Error: ${this.message}`));\n\n    if (this.suggestions && this.suggestions.length > 0) {\n      lines.push('');\n      lines.push(ansis.dim('Suggestions:'));\n      for (const suggestion of this.suggestions) {\n        lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n\nexport class ValidationError extends CLIError {\n  constructor(\n    message: string,\n    public errors: Array<{ layer?: string; elementId?: string; message: string }> = [],\n    suggestions?: string[]\n  ) {\n    super(message, 1, suggestions);\n    this.name = 'ValidationError';\n  }\n\n  format(): string {\n    const lines: string[] = [];\n\n    lines.push(ansis.red(`Error: ${this.message}`));\n\n    if (this.errors.length > 0) {\n      lines.push('');\n      lines.push(ansis.dim('Details:'));\n      for (const error of this.errors) {\n        let detail = '';\n        if (error.layer && error.elementId) {\n          detail = `  [${error.layer}:${error.elementId}] ${error.message}`;\n        } else if (error.layer) {\n          detail = `  [${error.layer}] ${error.message}`;\n        } else {\n          detail = `  ${error.message}`;\n        }\n        lines.push(ansis.dim(detail));\n      }\n    }\n\n    if (this.suggestions && this.suggestions.length > 0) {\n      lines.push('');\n      lines.push(ansis.dim('Suggestions:'));\n      for (const suggestion of this.suggestions) {\n        lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n      }\n    }\n\n    return lines.join('\\n');\n  }\n}\n\nexport class FileNotFoundError extends CLIError {\n  constructor(path: string, context?: string) {\n    const message = context ? `${context}: ${path}` : `File not found: ${path}`;\n    super(message, 2, [\n      `Check that the path is correct: ${path}`,\n      'Use \"dr init\" to create a new model',\n      'Use \"dr list <layer>\" to see available elements',\n    ]);\n    this.name = 'FileNotFoundError';\n  }\n}\n\nexport class ElementNotFoundError extends CLIError {\n  constructor(elementId: string) {\n    super(\n      `Element not found: ${elementId}`,\n      2,\n      [\n        `Use \"dr search ${elementId}\" to find similar elements`,\n        'Use \"dr list <layer>\" to list all elements in a layer',\n        'Check the element ID format: {layer}-{type}-{kebab-case-name}',\n      ]\n    );\n    this.name = 'ElementNotFoundError';\n  }\n}\n\nexport class ModelNotFoundError extends CLIError {\n  constructor(rootPath: string = '.') {\n    super(\n      `No model found at ${rootPath}`,\n      2,\n      [`Run \"dr init\" to initialize a new model`, 'Check that you are in the correct directory']\n    );\n    this.name = 'ModelNotFoundError';\n  }\n}\n\nexport class InvalidJSONError extends CLIError {\n  constructor(input: string, context?: string) {\n    const message = context ? `Invalid JSON in ${context}` : 'Invalid JSON format';\n    super(message, 1, [\n      `Check your JSON syntax: ${input}`,\n      'Use single quotes to wrap JSON: --properties \\'{\"key\":\"value\"}\\'',\n      'Escape special characters properly',\n    ]);\n    this.name = 'InvalidJSONError';\n  }\n}\n\nexport function handleError(error: unknown): never {\n  if (error instanceof CLIError) {\n    console.error(error.format());\n    process.exit(error.exitCode);\n  } else if (error instanceof Error) {\n    console.error(ansis.red(`Error: ${error.message}`));\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(error.stack));\n    }\n    process.exit(1);\n  } else {\n    console.error(ansis.red('An unexpected error occurred'));\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(String(error)));\n    }\n    process.exit(1);\n  }\n}\n\nexport function handleWarning(message: string, suggestions?: string[]): void {\n  const lines: string[] = [];\n  lines.push(ansis.yellow(`Warning: ${message}`));\n  if (suggestions && suggestions.length > 0) {\n    lines.push('');\n    lines.push(ansis.dim('Suggestions:'));\n    for (const suggestion of suggestions) {\n      lines.push(ansis.dim(`  \u2022 ${suggestion}`));\n    }\n  }\n  console.warn(lines.join('\\n'));\n}\n\nexport function handleSuccess(message: string, details?: Record<string, string>): void {\n  console.log(ansis.green(`\u2713 ${message}`));\n  if (details) {\n    for (const [key, value] of Object.entries(details)) {\n      console.log(ansis.dim(`  ${key}: ${value}`));\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/file-io.js

@@ -0,0 +1,69 @@
+import { mkdir, rename, readFile as fsReadFile, writeFile as fsWriteFile, stat } from "node:fs/promises";
+import { existsSync as fsExistsSync } from "node:fs";
+import { startSpan, endSpan } from "../telemetry/index.js";
+const isTelemetryEnabled = !1;
+async function ensureDir(path) {
+  await mkdir(path, { recursive: !0 });
+}
+async function atomicWrite(path, content) {
+  const fileExists2 = fsExistsSync(path), span = startSpan("file.write", {
+    "file.path": path,
+    "file.size": content.length,
+    "file.created": !fileExists2
+  });
+  try {
+    const tempPath = `${path}.tmp`;
+    await fsWriteFile(tempPath, content, "utf-8"), await rename(tempPath, path);
+  } finally {
+    endSpan(span);
+  }
+}
+async function fileExists(path) {
+  try {
+    return await stat(path), !0;
+  } catch {
+    return !1;
+  }
+}
+async function readFile(path) {
+  const span = startSpan("file.read", {
+    "file.path": path,
+    "file.exists": fsExistsSync(path)
+  });
+  try {
+    const content = await fsReadFile(path, "utf-8");
+    return isTelemetryEnabled && span && span.setAttribute("file.size", content.length), content;
+  } finally {
+    endSpan(span);
+  }
+}
+async function writeFile(path, content) {
+  const fileExists2 = fsExistsSync(path), span = startSpan("file.write", {
+    "file.path": path,
+    "file.size": content.length,
+    "file.created": !fileExists2
+  });
+  try {
+    await fsWriteFile(path, content, "utf-8");
+  } finally {
+    endSpan(span);
+  }
+}
+async function readJSON(path) {
+  const content = await readFile(path);
+  return JSON.parse(content);
+}
+async function writeJSON(path, data, pretty = !0) {
+  const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+  await writeFile(path, content);
+}
+export {
+  atomicWrite,
+  ensureDir,
+  fileExists,
+  readFile,
+  readJSON,
+  writeFile,
+  writeJSON
+};
+//# sourceMappingURL=file-io.js.map

package/dist/utils/file-io.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/file-io.ts"],
+  "sourcesContent": ["import { mkdir, rename, readFile as fsReadFile, writeFile as fsWriteFile, stat } from \"node:fs/promises\";\nimport { existsSync as fsExistsSync } from \"node:fs\";\nimport { startSpan, endSpan } from \"../telemetry/index.js\";\n\n// Fallback for runtime environments where TELEMETRY_ENABLED is not defined by esbuild\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\n/**\n * Ensure a directory exists, creating it if necessary\n */\nexport async function ensureDir(path: string): Promise<void> {\n  await mkdir(path, { recursive: true });\n}\n\n/**\n * Write content to a file atomically using a temporary file\n */\nexport async function atomicWrite(path: string, content: string): Promise<void> {\n  const fileExists = fsExistsSync(path);\n\n  const span = startSpan('file.write', {\n    'file.path': path,\n    'file.size': content.length,\n    'file.created': !fileExists,\n  });\n\n  try {\n    const tempPath = `${path}.tmp`;\n    await fsWriteFile(tempPath, content, 'utf-8');\n    // Rename temp file to target path (atomic operation)\n    await rename(tempPath, path);\n  } finally {\n    endSpan(span);\n  }\n}\n\n/**\n * Check if a file exists\n */\nexport async function fileExists(path: string): Promise<boolean> {\n  try {\n    await stat(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read a file as text\n */\nexport async function readFile(path: string): Promise<string> {\n  const span = startSpan('file.read', {\n    'file.path': path,\n    'file.exists': fsExistsSync(path),\n  });\n\n  try {\n    const content = await fsReadFile(path, 'utf-8');\n\n    if (isTelemetryEnabled && span) {\n      span.setAttribute('file.size', content.length);\n    }\n\n    return content;\n  } finally {\n    endSpan(span);\n  }\n}\n\n/**\n * Write content to a file\n */\nexport async function writeFile(path: string, content: string): Promise<void> {\n  const fileExists = fsExistsSync(path);\n\n  const span = startSpan('file.write', {\n    'file.path': path,\n    'file.size': content.length,\n    'file.created': !fileExists,\n  });\n\n  try {\n    await fsWriteFile(path, content, 'utf-8');\n  } finally {\n    endSpan(span);\n  }\n}\n\n/**\n * Read a JSON file\n */\nexport async function readJSON<T>(path: string): Promise<T> {\n  const content = await readFile(path);\n  return JSON.parse(content) as T;\n}\n\n/**\n * Write a JSON object to a file\n */\nexport async function writeJSON<T>(path: string, data: T, pretty: boolean = true): Promise<void> {\n  const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);\n  await writeFile(path, content);\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,QAAQ,YAAY,YAAY,aAAa,aAAa,YAAY;AACtF,SAAS,cAAc,oBAAoB;AAC3C,SAAS,WAAW,eAAe;AAInC,MAAM,qBAAgE;AAKtE,eAAsB,UAAU,MAAY;AAC1C,QAAM,MAAM,MAAM,EAAE,WAAW,GAAI,CAAE;AACvC;AAKA,eAAsB,YAAY,MAAc,SAAe;AAC7D,QAAMA,cAAa,aAAa,IAAI,GAE9B,OAAO,UAAU,cAAc;IACnC,aAAa;IACb,aAAa,QAAQ;IACrB,gBAAgB,CAACA;GAClB;AAED,MAAI;AACF,UAAM,WAAW,GAAG,IAAI;AACxB,UAAM,YAAY,UAAU,SAAS,OAAO,GAE5C,MAAM,OAAO,UAAU,IAAI;EAC7B;AACE,YAAQ,IAAI;EACd;AACF;AAKA,eAAsB,WAAW,MAAY;AAC3C,MAAI;AACF,iBAAM,KAAK,IAAI,GACR;EACT,QAAQ;AACN,WAAO;EACT;AACF;AAKA,eAAsB,SAAS,MAAY;AACzC,QAAM,OAAO,UAAU,aAAa;IAClC,aAAa;IACb,eAAe,aAAa,IAAI;GACjC;AAED,MAAI;AACF,UAAM,UAAU,MAAM,WAAW,MAAM,OAAO;AAE9C,WAAI,sBAAsB,QACxB,KAAK,aAAa,aAAa,QAAQ,MAAM,GAGxC;EACT;AACE,YAAQ,IAAI;EACd;AACF;AAKA,eAAsB,UAAU,MAAc,SAAe;AAC3D,QAAMA,cAAa,aAAa,IAAI,GAE9B,OAAO,UAAU,cAAc;IACnC,aAAa;IACb,aAAa,QAAQ;IACrB,gBAAgB,CAACA;GAClB;AAED,MAAI;AACF,UAAM,YAAY,MAAM,SAAS,OAAO;EAC1C;AACE,YAAQ,IAAI;EACd;AACF;AAKA,eAAsB,SAAY,MAAY;AAC5C,QAAM,UAAU,MAAM,SAAS,IAAI;AACnC,SAAO,KAAK,MAAM,OAAO;AAC3B;AAKA,eAAsB,UAAa,MAAc,MAAS,SAAkB,IAAI;AAC9E,QAAM,UAAU,SAAS,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI;AAC5E,QAAM,UAAU,MAAM,OAAO;AAC/B;",
+  "names": ["fileExists"]
+}

package/dist/utils/globals.js

@@ -0,0 +1,28 @@
+let globalOptions = {};
+function setGlobalOptions(options) {
+  globalOptions = { ...globalOptions, ...options };
+}
+function getGlobalOptions() {
+  return { ...globalOptions };
+}
+function isVerbose() {
+  return globalOptions.verbose === !0;
+}
+function isDebug() {
+  return globalOptions.debug === !0;
+}
+function logVerbose(message) {
+  isVerbose() && console.log(message);
+}
+function logDebug(message) {
+  isDebug() && console.debug(`[DEBUG] ${message}`);
+}
+export {
+  getGlobalOptions,
+  isDebug,
+  isVerbose,
+  logDebug,
+  logVerbose,
+  setGlobalOptions
+};
+//# sourceMappingURL=globals.js.map

package/dist/utils/globals.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/globals.ts"],
+  "sourcesContent": ["/**\n * Global CLI option management\n */\n\nexport interface GlobalOptions {\n  verbose?: boolean;\n  debug?: boolean;\n}\n\n// Global state for CLI options\nlet globalOptions: GlobalOptions = {};\n\n/**\n * Set global CLI options\n */\nexport function setGlobalOptions(options: GlobalOptions): void {\n  globalOptions = { ...globalOptions, ...options };\n}\n\n/**\n * Get current global options\n */\nexport function getGlobalOptions(): GlobalOptions {\n  return { ...globalOptions };\n}\n\n/**\n * Check if verbose mode is enabled\n */\nexport function isVerbose(): boolean {\n  return globalOptions.verbose === true;\n}\n\n/**\n * Check if debug mode is enabled\n */\nexport function isDebug(): boolean {\n  return globalOptions.debug === true;\n}\n\n/**\n * Log verbose messages\n */\nexport function logVerbose(message: string): void {\n  if (isVerbose()) {\n    console.log(message);\n  }\n}\n\n/**\n * Log debug messages\n */\nexport function logDebug(message: string): void {\n  if (isDebug()) {\n    console.debug(`[DEBUG] ${message}`);\n  }\n}\n"],
+  "mappings": "AAUA,IAAI,gBAA+B,CAAA;AAK7B,SAAU,iBAAiB,SAAsB;AACrD,kBAAgB,EAAE,GAAG,eAAe,GAAG,QAAO;AAChD;AAKM,SAAU,mBAAgB;AAC9B,SAAO,EAAE,GAAG,cAAa;AAC3B;AAKM,SAAU,YAAS;AACvB,SAAO,cAAc,YAAY;AACnC;AAKM,SAAU,UAAO;AACrB,SAAO,cAAc,UAAU;AACjC;AAKM,SAAU,WAAW,SAAe;AACxC,EAAI,UAAS,KACX,QAAQ,IAAI,OAAO;AAEvB;AAKM,SAAU,SAAS,SAAe;AACtC,EAAI,QAAO,KACT,QAAQ,MAAM,WAAW,OAAO,EAAE;AAEtC;",
+  "names": []
+}

package/dist/utils/model-path.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+async function resolveModelRoot(opts) {
+  const cwd = opts?.cwd ? path.resolve(opts.cwd) : process.cwd(), input = opts?.modelPath ? path.resolve(cwd, opts.modelPath) : cwd, candidates = [];
+  if (input.endsWith("manifest.yaml") && candidates.push(input), candidates.push(path.join(input, "manifest.yaml")), candidates.push(path.join(input, "model", "manifest.yaml")), candidates.push(path.join(input, "documentation-robotics", "model", "manifest.yaml")), process.env.DR_MODEL_PATH) {
+    const envPath = path.resolve(process.env.DR_MODEL_PATH);
+    envPath.endsWith("manifest.yaml") ? candidates.unshift(envPath) : (candidates.unshift(path.join(envPath, "manifest.yaml")), candidates.unshift(path.join(envPath, "model", "manifest.yaml")));
+  }
+  for (const manifestPath of candidates)
+    try {
+      await fs.access(manifestPath);
+      const normalized = path.normalize(manifestPath);
+      let rootPath;
+      return normalized.endsWith(path.join("documentation-robotics", "model", "manifest.yaml")) ? rootPath = path.dirname(path.dirname(path.dirname(normalized))) : normalized.endsWith(path.join("model", "manifest.yaml")) ? rootPath = path.dirname(path.dirname(normalized)) : rootPath = path.dirname(normalized), { rootPath, manifestPath: normalized };
+    } catch {
+    }
+  throw new Error("Model not found. Provide --model <path> (directory containing documentation-robotics/model/manifest.yaml) or set DR_MODEL_PATH.");
+}
+export {
+  resolveModelRoot
+};
+//# sourceMappingURL=model-path.js.map

package/dist/utils/model-path.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/model-path.ts"],
+  "sourcesContent": ["import path from 'node:path'\nimport fs from 'node:fs/promises'\n\n/**\n * Resolve the model root directory and manifest path.\n * Supports both TS layout (root/model/manifest.yaml) and Python layout\n * (root/documentation-robotics/model/manifest.yaml).\n */\nexport async function resolveModelRoot(opts?: {\n  modelPath?: string\n  cwd?: string\n}): Promise<{ rootPath: string; manifestPath: string }> {\n  const cwd = opts?.cwd ? path.resolve(opts.cwd) : process.cwd()\n  const input = opts?.modelPath ? path.resolve(cwd, opts.modelPath) : cwd\n\n  const candidates: string[] = []\n\n  // If a manifest file is directly provided\n  if (input.endsWith('manifest.yaml')) {\n    candidates.push(input)\n  }\n\n  // If a model directory is provided\n  candidates.push(path.join(input, 'manifest.yaml'))\n\n  // TypeScript layout: <root>/model/manifest.yaml\n  candidates.push(path.join(input, 'model', 'manifest.yaml'))\n\n  // Python/TypeScript unified layout: <root>/documentation-robotics/model/manifest.yaml\n  candidates.push(path.join(input, 'documentation-robotics', 'model', 'manifest.yaml'))\n\n  // Optional override via env var (highest priority)\n  if (process.env.DR_MODEL_PATH) {\n    const envPath = path.resolve(process.env.DR_MODEL_PATH)\n    if (envPath.endsWith('manifest.yaml')) {\n      candidates.unshift(envPath)\n    } else {\n      candidates.unshift(path.join(envPath, 'manifest.yaml'))\n      candidates.unshift(path.join(envPath, 'model', 'manifest.yaml'))\n    }\n  }\n\n  for (const manifestPath of candidates) {\n    try {\n      await fs.access(manifestPath)\n      const normalized = path.normalize(manifestPath)\n      // rootPath is the parent of the model directory\n      let rootPath: string\n      if (normalized.endsWith(path.join('documentation-robotics', 'model', 'manifest.yaml'))) {\n        // <root>/documentation-robotics/model/manifest.yaml -> <root>\n        rootPath = path.dirname(path.dirname(path.dirname(normalized)))\n      } else if (normalized.endsWith(path.join('model', 'manifest.yaml'))) {\n        // <root>/model/manifest.yaml -> <root>\n        rootPath = path.dirname(path.dirname(normalized))\n      } else {\n        // <root>/manifest.yaml -> <root>\n        rootPath = path.dirname(normalized)\n      }\n      return { rootPath, manifestPath: normalized }\n    } catch {\n      // continue searching\n    }\n  }\n\n  throw new Error(\n    'Model not found. Provide --model <path> (directory containing documentation-robotics/model/manifest.yaml) or set DR_MODEL_PATH.'\n  )\n}\n"],
+  "mappings": "AAAA,OAAO,UAAU;AACjB,OAAO,QAAQ;AAOf,eAAsB,iBAAiB,MAGtC;AACC,QAAM,MAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,GAAG,IAAI,QAAQ,IAAG,GACtD,QAAQ,MAAM,YAAY,KAAK,QAAQ,KAAK,KAAK,SAAS,IAAI,KAE9D,aAAuB,CAAA;AAiB7B,MAdI,MAAM,SAAS,eAAe,KAChC,WAAW,KAAK,KAAK,GAIvB,WAAW,KAAK,KAAK,KAAK,OAAO,eAAe,CAAC,GAGjD,WAAW,KAAK,KAAK,KAAK,OAAO,SAAS,eAAe,CAAC,GAG1D,WAAW,KAAK,KAAK,KAAK,OAAO,0BAA0B,SAAS,eAAe,CAAC,GAGhF,QAAQ,IAAI,eAAe;AAC7B,UAAM,UAAU,KAAK,QAAQ,QAAQ,IAAI,aAAa;AAClD,YAAQ,SAAS,eAAe,IAClC,WAAW,QAAQ,OAAO,KAE1B,WAAW,QAAQ,KAAK,KAAK,SAAS,eAAe,CAAC,GACtD,WAAW,QAAQ,KAAK,KAAK,SAAS,SAAS,eAAe,CAAC;EAEnE;AAEA,aAAW,gBAAgB;AACzB,QAAI;AACF,YAAM,GAAG,OAAO,YAAY;AAC5B,YAAM,aAAa,KAAK,UAAU,YAAY;AAE9C,UAAI;AACJ,aAAI,WAAW,SAAS,KAAK,KAAK,0BAA0B,SAAS,eAAe,CAAC,IAEnF,WAAW,KAAK,QAAQ,KAAK,QAAQ,KAAK,QAAQ,UAAU,CAAC,CAAC,IACrD,WAAW,SAAS,KAAK,KAAK,SAAS,eAAe,CAAC,IAEhE,WAAW,KAAK,QAAQ,KAAK,QAAQ,UAAU,CAAC,IAGhD,WAAW,KAAK,QAAQ,UAAU,GAE7B,EAAE,UAAU,cAAc,WAAU;IAC7C,QAAQ;IAER;AAGF,QAAM,IAAI,MACR,iIAAiI;AAErI;",
+  "names": []
+}

package/dist/utils/project-paths.js

@@ -0,0 +1,45 @@
+import { fileExists } from "./file-io.js";
+import { join, dirname } from "path";
+const MAX_SEARCH_DEPTH = 5, PROJECT_FOLDER_NAME = "documentation-robotics", SPEC_FOLDER_NAME = ".dr";
+async function findProjectRoot(startPath) {
+  let currentPath = startPath || process.cwd();
+  for (let depth = 0; depth < MAX_SEARCH_DEPTH; depth++) {
+    const projectPath = join(currentPath, PROJECT_FOLDER_NAME);
+    if (await fileExists(projectPath))
+      return currentPath;
+    const parentPath = dirname(currentPath);
+    if (parentPath === currentPath)
+      break;
+    currentPath = parentPath;
+  }
+  return null;
+}
+async function getDocumentationRobotsPath(startPath) {
+  const root = await findProjectRoot(startPath);
+  return root ? join(root, PROJECT_FOLDER_NAME) : null;
+}
+async function getModelPath(startPath) {
+  const drPath = await getDocumentationRobotsPath(startPath);
+  if (!drPath)
+    return null;
+  const modelPath = join(drPath, "model");
+  return await fileExists(modelPath) ? modelPath : null;
+}
+async function getSpecReferencePath(startPath) {
+  const root = await findProjectRoot(startPath);
+  if (!root)
+    return null;
+  const specPath = join(root, SPEC_FOLDER_NAME);
+  return await fileExists(specPath) ? specPath : null;
+}
+async function isInDRProject(startPath) {
+  return await findProjectRoot(startPath) !== null;
+}
+export {
+  findProjectRoot,
+  getDocumentationRobotsPath,
+  getModelPath,
+  getSpecReferencePath,
+  isInDRProject
+};
+//# sourceMappingURL=project-paths.js.map

package/dist/utils/project-paths.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/project-paths.ts"],
+  "sourcesContent": ["/**\n * Project Path Utilities\n *\n * Handles finding project root and related paths in the DR project structure:\n *\n * my-project/\n * \u251C\u2500\u2500 .dr/                           # Reference spec (ephemeral, git-ignored)\n * \u2502   \u251C\u2500\u2500 manifest.json              # Installed spec version\n * \u2502   \u2514\u2500\u2500 schemas/\n * \u2514\u2500\u2500 documentation-robotics/        # Project model (permanent, git-committed)\n *     \u251C\u2500\u2500 model/\n *     \u2502   \u251C\u2500\u2500 manifest.yaml       # Model spec version\n *     \u2502   \u2514\u2500\u2500 layers/\n *     \u251C\u2500\u2500 annotations/\n *     \u2514\u2500\u2500 changesets/\n */\n\nimport { fileExists } from './file-io.js';\nimport { join, dirname } from 'path';\n\nconst MAX_SEARCH_DEPTH = 5;\nconst PROJECT_FOLDER_NAME = 'documentation-robotics';\nconst SPEC_FOLDER_NAME = '.dr';\n\n/**\n * Find the project root by searching for the documentation-robotics/ folder\n *\n * Searches upward from the current working directory up to MAX_SEARCH_DEPTH levels.\n * Returns the directory containing the documentation_robotics/ folder.\n *\n * @param startPath - Optional starting path (defaults to process.cwd())\n * @returns Path to project root, or null if not found\n *\n * @example\n * // From /home/user/my-project/documentation-robotics/model/01_motivation\n * // Returns: /home/user/my-project\n * const root = await findProjectRoot();\n */\nexport async function findProjectRoot(startPath?: string): Promise<string | null> {\n  let currentPath = startPath || process.cwd();\n\n  for (let depth = 0; depth < MAX_SEARCH_DEPTH; depth++) {\n    const projectPath = join(currentPath, PROJECT_FOLDER_NAME);\n\n    if (await fileExists(projectPath)) {\n      return currentPath;\n    }\n\n    // Move up one directory\n    const parentPath = dirname(currentPath);\n\n    // Check if we've reached the root\n    if (parentPath === currentPath) {\n      break;\n    }\n\n    currentPath = parentPath;\n  }\n\n  return null;\n}\n\n/**\n * Get the path to the documentation-robotics/ folder\n *\n * @param startPath - Optional starting path (defaults to process.cwd())\n * @returns Path to documentation-robotics/ folder, or null if not found\n */\nexport async function getDocumentationRobotsPath(startPath?: string): Promise<string | null> {\n  const root = await findProjectRoot(startPath);\n  return root ? join(root, PROJECT_FOLDER_NAME) : null;\n}\n\n/**\n * Get the path to the model directory (documentation-robotics/model/)\n *\n * @param startPath - Optional starting path (defaults to process.cwd())\n * @returns Path to model directory, or null if not found\n */\nexport async function getModelPath(startPath?: string): Promise<string | null> {\n  const drPath = await getDocumentationRobotsPath(startPath);\n  if (!drPath) return null;\n\n  const modelPath = join(drPath, 'model');\n  return await fileExists(modelPath) ? modelPath : null;\n}\n\n/**\n * Get the path to the .dr/ folder (spec reference directory)\n *\n * @param startPath - Optional starting path (defaults to process.cwd())\n * @returns Path to .dr/ folder, or null if not found\n */\nexport async function getSpecReferencePath(startPath?: string): Promise<string | null> {\n  const root = await findProjectRoot(startPath);\n  if (!root) return null;\n\n  const specPath = join(root, SPEC_FOLDER_NAME);\n  return await fileExists(specPath) ? specPath : null;\n}\n\n/**\n * Check if currently in a DR project\n *\n * @param startPath - Optional starting path (defaults to process.cwd())\n * @returns True if documentation-robotics/ folder exists in hierarchy\n */\nexport async function isInDRProject(startPath?: string): Promise<boolean> {\n  return (await findProjectRoot(startPath)) !== null;\n}\n"],
+  "mappings": "AAiBA,SAAS,kBAAkB;AAC3B,SAAS,MAAM,eAAe;AAE9B,MAAM,mBAAmB,GACnB,sBAAsB,0BACtB,mBAAmB;AAgBzB,eAAsB,gBAAgB,WAAkB;AACtD,MAAI,cAAc,aAAa,QAAQ,IAAG;AAE1C,WAAS,QAAQ,GAAG,QAAQ,kBAAkB,SAAS;AACrD,UAAM,cAAc,KAAK,aAAa,mBAAmB;AAEzD,QAAI,MAAM,WAAW,WAAW;AAC9B,aAAO;AAIT,UAAM,aAAa,QAAQ,WAAW;AAGtC,QAAI,eAAe;AACjB;AAGF,kBAAc;EAChB;AAEA,SAAO;AACT;AAQA,eAAsB,2BAA2B,WAAkB;AACjE,QAAM,OAAO,MAAM,gBAAgB,SAAS;AAC5C,SAAO,OAAO,KAAK,MAAM,mBAAmB,IAAI;AAClD;AAQA,eAAsB,aAAa,WAAkB;AACnD,QAAM,SAAS,MAAM,2BAA2B,SAAS;AACzD,MAAI,CAAC;AAAQ,WAAO;AAEpB,QAAM,YAAY,KAAK,QAAQ,OAAO;AACtC,SAAO,MAAM,WAAW,SAAS,IAAI,YAAY;AACnD;AAQA,eAAsB,qBAAqB,WAAkB;AAC3D,QAAM,OAAO,MAAM,gBAAgB,SAAS;AAC5C,MAAI,CAAC;AAAM,WAAO;AAElB,QAAM,WAAW,KAAK,MAAM,gBAAgB;AAC5C,SAAO,MAAM,WAAW,QAAQ,IAAI,WAAW;AACjD;AAQA,eAAsB,cAAc,WAAkB;AACpD,SAAQ,MAAM,gBAAgB,SAAS,MAAO;AAChD;",
+  "names": []
+}

package/dist/utils/spec-installer.js

@@ -0,0 +1,85 @@
+import { ensureDir, writeFile } from "./file-io.js";
+import { join } from "path";
+import { getCliBundledSpecVersion } from "./spec-version.js";
+import fs from "fs/promises";
+async function installSpecReference(projectRoot, _force = !1) {
+  const drPath = join(projectRoot, ".dr"), specVersion = getCliBundledSpecVersion();
+  await ensureDir(drPath), await ensureDir(join(drPath, "schemas")), await ensureDir(join(drPath, "schemas", "common")), await ensureDir(join(drPath, "changesets"));
+  const manifestPath = join(drPath, "manifest.json"), manifest = {
+    specVersion,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+  const schemaSourceDir = new URL("../schemas/bundled", import.meta.url).pathname, layerSchemas = [
+    "01-motivation-layer.schema.json",
+    "02-business-layer.schema.json",
+    "03-security-layer.schema.json",
+    "04-application-layer.schema.json",
+    "05-technology-layer.schema.json",
+    "06-api-layer.schema.json",
+    "07-data-model-layer.schema.json",
+    "08-datastore-layer.schema.json",
+    "09-ux-layer.schema.json",
+    "10-navigation-layer.schema.json",
+    "11-apm-observability-layer.schema.json",
+    "12-testing-layer.schema.json"
+  ];
+  for (const schema of layerSchemas) {
+    const sourcePath = join(schemaSourceDir, schema), targetPath = join(drPath, "schemas", schema);
+    await fs.copyFile(sourcePath, targetPath);
+  }
+  const catalogFiles = [
+    "relationship-catalog.json",
+    "link-registry.json",
+    "link-registry.schema.json",
+    "relationship-type.schema.json"
+  ];
+  for (const file of catalogFiles) {
+    const sourcePath = join(schemaSourceDir, file), targetPath = join(drPath, "schemas", file);
+    await fs.copyFile(sourcePath, targetPath);
+  }
+  const commonSchemas = [
+    "layer-extensions.schema.json",
+    "predicates.schema.json",
+    "relationships.schema.json",
+    "source-references.schema.json"
+  ];
+  for (const schema of commonSchemas) {
+    const sourcePath = join(schemaSourceDir, "common", schema), targetPath = join(drPath, "schemas", "common", schema);
+    await fs.copyFile(sourcePath, targetPath);
+  }
+  const readmePath = join(drPath, "README.md"), readme = `# Documentation Robotics - Spec Reference
+
+This directory contains the specification reference for Documentation Robotics.
+
+**Spec Version:** ${specVersion}
+**Installed:** ${(/* @__PURE__ */ new Date()).toISOString()}
+
+## Structure
+
+- \`manifest.json\` - Spec version information
+- \`schemas/\` - JSON Schema definitions for all layers
+- \`changesets/\` - Model changesets (active and saved)
+
+## Important
+
+This directory is ephemeral and should be git-ignored. It will be recreated
+automatically by the CLI when needed.
+
+Do not manually edit files in this directory.
+`;
+  await writeFile(readmePath, readme);
+}
+async function needsSpecReferenceInstall(projectRoot) {
+  const manifestPath = join(projectRoot, ".dr", "manifest.json");
+  try {
+    return await (await import("fs/promises")).access(manifestPath), !1;
+  } catch {
+    return !0;
+  }
+}
+export {
+  installSpecReference,
+  needsSpecReferenceInstall
+};
+//# sourceMappingURL=spec-installer.js.map

package/dist/utils/spec-installer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/spec-installer.ts"],
+  "sourcesContent": ["/**\n * Spec Reference Installer\n *\n * Manages the .dr/ folder which contains the spec reference (schemas, etc.)\n * This is an ephemeral folder that should be git-ignored\n */\n\nimport { ensureDir, writeFile } from './file-io.js';\nimport { join } from 'path';\nimport { getCliBundledSpecVersion } from './spec-version.js';\nimport fs from 'fs/promises';\n\n/**\n * Install or update the .dr/ spec reference folder\n *\n * Creates:\n * - .dr/manifest.json with spec version\n * - .dr/schemas/ with all bundled schemas\n * - .dr/changesets/ directory\n * - .dr/README.md\n *\n * @param projectRoot - Path to project root\n * @param _force - If true, overwrite existing files (reserved for future use)\n */\nexport async function installSpecReference(\n  projectRoot: string,\n  _force: boolean = false\n): Promise<void> {\n  const drPath = join(projectRoot, '.dr');\n  const specVersion = getCliBundledSpecVersion();\n\n  // Create .dr directory structure\n  await ensureDir(drPath);\n  await ensureDir(join(drPath, 'schemas'));\n  await ensureDir(join(drPath, 'schemas', 'common'));\n  await ensureDir(join(drPath, 'changesets'));\n\n  // Write manifest.json\n  const manifestPath = join(drPath, 'manifest.json');\n  const manifest = {\n    specVersion: specVersion,\n    installedAt: new Date().toISOString(),\n  };\n  await writeFile(manifestPath, JSON.stringify(manifest, null, 2));\n\n  // Copy bundled schemas\n  const schemaSourceDir = new URL('../schemas/bundled', import.meta.url).pathname;\n\n  // Copy layer schemas\n  const layerSchemas = [\n    '01-motivation-layer.schema.json',\n    '02-business-layer.schema.json',\n    '03-security-layer.schema.json',\n    '04-application-layer.schema.json',\n    '05-technology-layer.schema.json',\n    '06-api-layer.schema.json',\n    '07-data-model-layer.schema.json',\n    '08-datastore-layer.schema.json',\n    '09-ux-layer.schema.json',\n    '10-navigation-layer.schema.json',\n    '11-apm-observability-layer.schema.json',\n    '12-testing-layer.schema.json',\n  ];\n\n  for (const schema of layerSchemas) {\n    const sourcePath = join(schemaSourceDir, schema);\n    const targetPath = join(drPath, 'schemas', schema);\n    await fs.copyFile(sourcePath, targetPath);\n  }\n\n  // Copy catalog and registry files\n  const catalogFiles = [\n    'relationship-catalog.json',\n    'link-registry.json',\n    'link-registry.schema.json',\n    'relationship-type.schema.json',\n  ];\n\n  for (const file of catalogFiles) {\n    const sourcePath = join(schemaSourceDir, file);\n    const targetPath = join(drPath, 'schemas', file);\n    await fs.copyFile(sourcePath, targetPath);\n  }\n\n  // Copy common schemas\n  const commonSchemas = [\n    'layer-extensions.schema.json',\n    'predicates.schema.json',\n    'relationships.schema.json',\n    'source-references.schema.json',\n  ];\n\n  for (const schema of commonSchemas) {\n    const sourcePath = join(schemaSourceDir, 'common', schema);\n    const targetPath = join(drPath, 'schemas', 'common', schema);\n    await fs.copyFile(sourcePath, targetPath);\n  }\n\n  // Create README.md\n  const readmePath = join(drPath, 'README.md');\n  const readme = `# Documentation Robotics - Spec Reference\n\nThis directory contains the specification reference for Documentation Robotics.\n\n**Spec Version:** ${specVersion}\n**Installed:** ${new Date().toISOString()}\n\n## Structure\n\n- \\`manifest.json\\` - Spec version information\n- \\`schemas/\\` - JSON Schema definitions for all layers\n- \\`changesets/\\` - Model changesets (active and saved)\n\n## Important\n\nThis directory is ephemeral and should be git-ignored. It will be recreated\nautomatically by the CLI when needed.\n\nDo not manually edit files in this directory.\n`;\n  await writeFile(readmePath, readme);\n}\n\n/**\n * Check if spec reference needs to be installed or updated\n *\n * @param projectRoot - Path to project root\n * @returns True if installation/update is needed\n */\nexport async function needsSpecReferenceInstall(projectRoot: string): Promise<boolean> {\n  const manifestPath = join(projectRoot, '.dr', 'manifest.json');\n\n  try {\n    const fs = await import('fs/promises');\n    await fs.access(manifestPath);\n    return false;\n  } catch {\n    return true;\n  }\n}\n"],
+  "mappings": "AAOA,SAAS,WAAW,iBAAiB;AACrC,SAAS,YAAY;AACrB,SAAS,gCAAgC;AACzC,OAAO,QAAQ;AAcf,eAAsB,qBACpB,aACA,SAAkB,IAAK;AAEvB,QAAM,SAAS,KAAK,aAAa,KAAK,GAChC,cAAc,yBAAwB;AAG5C,QAAM,UAAU,MAAM,GACtB,MAAM,UAAU,KAAK,QAAQ,SAAS,CAAC,GACvC,MAAM,UAAU,KAAK,QAAQ,WAAW,QAAQ,CAAC,GACjD,MAAM,UAAU,KAAK,QAAQ,YAAY,CAAC;AAG1C,QAAM,eAAe,KAAK,QAAQ,eAAe,GAC3C,WAAW;IACf;IACA,cAAa,oBAAI,KAAI,GAAG,YAAW;;AAErC,QAAM,UAAU,cAAc,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAG/D,QAAM,kBAAkB,IAAI,IAAI,sBAAsB,YAAY,GAAG,EAAE,UAGjE,eAAe;IACnB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;AAGF,aAAW,UAAU,cAAc;AACjC,UAAM,aAAa,KAAK,iBAAiB,MAAM,GACzC,aAAa,KAAK,QAAQ,WAAW,MAAM;AACjD,UAAM,GAAG,SAAS,YAAY,UAAU;EAC1C;AAGA,QAAM,eAAe;IACnB;IACA;IACA;IACA;;AAGF,aAAW,QAAQ,cAAc;AAC/B,UAAM,aAAa,KAAK,iBAAiB,IAAI,GACvC,aAAa,KAAK,QAAQ,WAAW,IAAI;AAC/C,UAAM,GAAG,SAAS,YAAY,UAAU;EAC1C;AAGA,QAAM,gBAAgB;IACpB;IACA;IACA;IACA;;AAGF,aAAW,UAAU,eAAe;AAClC,UAAM,aAAa,KAAK,iBAAiB,UAAU,MAAM,GACnD,aAAa,KAAK,QAAQ,WAAW,UAAU,MAAM;AAC3D,UAAM,GAAG,SAAS,YAAY,UAAU;EAC1C;AAGA,QAAM,aAAa,KAAK,QAAQ,WAAW,GACrC,SAAS;;;;oBAIG,WAAW;kBACd,oBAAI,KAAI,GAAG,YAAW,CAAE;;;;;;;;;;;;;;;AAevC,QAAM,UAAU,YAAY,MAAM;AACpC;AAQA,eAAsB,0BAA0B,aAAmB;AACjE,QAAM,eAAe,KAAK,aAAa,OAAO,eAAe;AAE7D,MAAI;AAEF,kBADW,MAAM,OAAO,aAAa,GAC5B,OAAO,YAAY,GACrB;EACT,QAAQ;AACN,WAAO;EACT;AACF;",
+  "names": []
+}

package/dist/utils/spec-version.js

@@ -0,0 +1,33 @@
+import { readJSON, fileExists } from "./file-io.js";
+import { join } from "path";
+const BUNDLED_SPEC_VERSION = "0.7.0";
+function getCliBundledSpecVersion() {
+  return BUNDLED_SPEC_VERSION;
+}
+async function getInstalledSpecVersion(drPath) {
+  const manifestPath = join(drPath, "manifest.json");
+  if (!await fileExists(manifestPath))
+    return null;
+  try {
+    return (await readJSON(manifestPath)).specVersion || null;
+  } catch {
+    return null;
+  }
+}
+async function getModelSpecVersion(modelPath) {
+  const manifestPath = join(modelPath, "manifest.yaml");
+  if (!await fileExists(manifestPath))
+    return null;
+  try {
+    const yaml = await import("yaml"), content = await (await import("fs/promises")).readFile(manifestPath, "utf-8"), manifest = yaml.parse(content);
+    return manifest.spec_version || manifest.specVersion || null;
+  } catch {
+    return null;
+  }
+}
+export {
+  getCliBundledSpecVersion,
+  getInstalledSpecVersion,
+  getModelSpecVersion
+};
+//# sourceMappingURL=spec-version.js.map

package/dist/utils/spec-version.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/spec-version.ts"],
+  "sourcesContent": ["/**\n * Spec Version Utilities\n *\n * Manages spec version information for the CLI\n */\n\nimport { readJSON, fileExists } from './file-io.js';\nimport { join } from 'path';\n\n/**\n * Bundled spec version\n * This should match the version in ../../../spec/VERSION\n * Updated during build process\n */\nconst BUNDLED_SPEC_VERSION = '0.7.0';\n\n/**\n * Get the CLI's bundled spec version\n *\n * This is the version of the DR specification that is bundled with this CLI.\n * It represents what version of the spec this CLI supports.\n *\n * @returns Bundled spec version string\n */\nexport function getCliBundledSpecVersion(): string {\n  return BUNDLED_SPEC_VERSION;\n}\n\n/**\n * Read spec version from .dr/manifest.json (installed spec reference)\n *\n * @param drPath - Path to .dr/ directory\n * @returns Spec version from .dr/manifest.json, or null if not found\n */\nexport async function getInstalledSpecVersion(drPath: string): Promise<string | null> {\n  const manifestPath = join(drPath, 'manifest.json');\n\n  if (!(await fileExists(manifestPath))) {\n    return null;\n  }\n\n  try {\n    const manifest = await readJSON<{ specVersion?: string }>(manifestPath);\n    return manifest.specVersion || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read spec version from documentation_robotics/model/manifest.yaml\n *\n * @param modelPath - Path to model directory\n * @returns Spec version from model manifest, or null if not found\n */\nexport async function getModelSpecVersion(modelPath: string): Promise<string | null> {\n  const manifestPath = join(modelPath, 'manifest.yaml');\n\n  if (!(await fileExists(manifestPath))) {\n    return null;\n  }\n\n  try {\n    // Use YAML parser\n    const yaml = await import('yaml');\n    const fs = await import('fs/promises');\n    const content = await fs.readFile(manifestPath, 'utf-8');\n    const manifest = yaml.parse(content) as { spec_version?: string; specVersion?: string };\n    // Check snake_case first (Python CLI format), then camelCase (legacy)\n    return manifest.spec_version || manifest.specVersion || null;\n  } catch {\n    return null;\n  }\n}\n"],
+  "mappings": "AAMA,SAAS,UAAU,kBAAkB;AACrC,SAAS,YAAY;AAOrB,MAAM,uBAAuB;AAUvB,SAAU,2BAAwB;AACtC,SAAO;AACT;AAQA,eAAsB,wBAAwB,QAAc;AAC1D,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,CAAE,MAAM,WAAW,YAAY;AACjC,WAAO;AAGT,MAAI;AAEF,YADiB,MAAM,SAAmC,YAAY,GACtD,eAAe;EACjC,QAAQ;AACN,WAAO;EACT;AACF;AAQA,eAAsB,oBAAoB,WAAiB;AACzD,QAAM,eAAe,KAAK,WAAW,eAAe;AAEpD,MAAI,CAAE,MAAM,WAAW,YAAY;AACjC,WAAO;AAGT,MAAI;AAEF,UAAM,OAAO,MAAM,OAAO,MAAM,GAE1B,UAAU,OADL,MAAM,OAAO,aAAa,GACZ,SAAS,cAAc,OAAO,GACjD,WAAW,KAAK,MAAM,OAAO;AAEnC,WAAO,SAAS,gBAAgB,SAAS,eAAe;EAC1D,QAAQ;AACN,WAAO;EACT;AACF;",
+  "names": []
+}

package/dist/validators/index.js

@@ -0,0 +1,15 @@
+import { ValidationResult } from "./types.js";
+import { SchemaValidator } from "./schema-validator.js";
+import { NamingValidator } from "./naming-validator.js";
+import { ReferenceValidator } from "./reference-validator.js";
+import { SemanticValidator } from "./semantic-validator.js";
+import { Validator } from "./validator.js";
+export {
+  NamingValidator,
+  ReferenceValidator,
+  SchemaValidator,
+  SemanticValidator,
+  ValidationResult,
+  Validator
+};
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/validators/index.ts"],
+  "sourcesContent": ["/**\n * Validators module - 4-stage validation pipeline\n */\n\nexport { ValidationResult, type ValidationIssue } from './types.js';\nexport { SchemaValidator } from './schema-validator.js';\nexport { NamingValidator } from './naming-validator.js';\nexport { ReferenceValidator } from './reference-validator.js';\nexport { SemanticValidator } from './semantic-validator.js';\nexport { Validator } from './validator.js';\n"],
+  "mappings": "AAIA,SAAS,wBAA8C;AACvD,SAAS,uBAAuB;AAChC,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,iBAAiB;",
+  "names": []
+}

package/dist/validators/naming-validator.js

@@ -0,0 +1,82 @@
+import { ValidationResult } from "./types.js";
+class NamingValidator {
+  // Element ID format: {layer}.{type}.{name} (dot-separated, matching Python CLI)
+  // Also accepts: {layer}-{type}-{kebab-case-name} (legacy kebab-case format)
+  DOT_SEPARATED_PATTERN = /^[a-z_][a-z0-9_]*(\.[a-z_][a-z0-9_-]*)+$/;
+  KEBAB_CASE_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*(-[a-z0-9]+)+$/;
+  // Known layer names (including hyphenated and underscored ones)
+  KNOWN_LAYERS = [
+    "motivation",
+    "business",
+    "security",
+    "application",
+    "technology",
+    "api",
+    "data_model",
+    "data-model",
+    "datastore",
+    "data-store",
+    "ux",
+    "navigation",
+    "apm",
+    "testing"
+  ];
+  /**
+   * Validate all elements in a layer
+   */
+  validateLayer(layer) {
+    const result = new ValidationResult();
+    for (const element of layer.listElements())
+      this.validateElementId(element.id, layer.name, result);
+    return result;
+  }
+  /**
+   * Validate an individual element ID
+   */
+  validateElementId(elementId, layerName, result) {
+    const isDotSeparated = this.DOT_SEPARATED_PATTERN.test(elementId), isKebabCase = this.KEBAB_CASE_PATTERN.test(elementId);
+    if (!isDotSeparated && !isKebabCase) {
+      result.addError({
+        layer: layerName,
+        elementId,
+        message: `Invalid element ID format: ${elementId}`,
+        fixSuggestion: "Use format: {layer}.{type}.{name} (e.g., motivation.goal.increase-revenue) or {layer}-{type}-{kebab-case-name}"
+      });
+      return;
+    }
+    const idLayer = this.extractLayerFromId(elementId, isDotSeparated), normalizedLayerName = layerName.replace(/-/g, "_");
+    if (idLayer.replace(/-/g, "_") !== normalizedLayerName) {
+      result.addError({
+        layer: layerName,
+        elementId,
+        message: `Element ID layer prefix '${idLayer}' does not match layer '${layerName}'`,
+        fixSuggestion: `Change prefix to '${layerName}' (e.g., ${layerName}.type.name)`
+      });
+      return;
+    }
+    const separator = isDotSeparated ? "." : "-";
+    if (elementId.slice(idLayer.length + 1).split(separator).length < 2) {
+      result.addError({
+        layer: layerName,
+        elementId,
+        message: "Element ID must have type and name components after layer",
+        fixSuggestion: "Use format: {layer}.{type}.{name}"
+      });
+      return;
+    }
+  }
+  /**
+   * Extract layer name from element ID, handling hyphenated/underscored layer names
+   */
+  extractLayerFromId(elementId, isDotSeparated) {
+    const sortedLayers = [...this.KNOWN_LAYERS].sort((a, b) => b.length - a.length), separator = isDotSeparated ? "." : "-";
+    for (const layer of sortedLayers)
+      if (elementId.startsWith(layer + separator))
+        return layer;
+    return elementId.split(separator)[0];
+  }
+}
+export {
+  NamingValidator
+};
+//# sourceMappingURL=naming-validator.js.map

package/dist/validators/naming-validator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/validators/naming-validator.ts"],
+  "sourcesContent": ["/**\n * Naming validation for element IDs\n */\n\nimport { ValidationResult } from './types.js';\nimport type { Layer } from '../core/layer.js';\n\n/**\n * Validator for element ID naming conventions\n */\nexport class NamingValidator {\n  // Element ID format: {layer}.{type}.{name} (dot-separated, matching Python CLI)\n  // Also accepts: {layer}-{type}-{kebab-case-name} (legacy kebab-case format)\n  private readonly DOT_SEPARATED_PATTERN = /^[a-z_][a-z0-9_]*(\\.[a-z_][a-z0-9_-]*)+$/;\n  private readonly KEBAB_CASE_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*(-[a-z0-9]+)+$/;\n\n  // Known layer names (including hyphenated and underscored ones)\n  private readonly KNOWN_LAYERS = [\n    'motivation',\n    'business',\n    'security',\n    'application',\n    'technology',\n    'api',\n    'data_model',\n    'data-model',\n    'datastore',\n    'data-store',\n    'ux',\n    'navigation',\n    'apm',\n    'testing',\n  ];\n\n  /**\n   * Validate all elements in a layer\n   */\n  validateLayer(layer: Layer): ValidationResult {\n    const result = new ValidationResult();\n\n    for (const element of layer.listElements()) {\n      this.validateElementId(element.id, layer.name, result);\n    }\n\n    return result;\n  }\n\n  /**\n   * Validate an individual element ID\n   */\n  private validateElementId(\n    elementId: string,\n    layerName: string,\n    result: ValidationResult\n  ): void {\n    // Check if ID matches dot-separated format (primary) or kebab-case format (legacy)\n    const isDotSeparated = this.DOT_SEPARATED_PATTERN.test(elementId);\n    const isKebabCase = this.KEBAB_CASE_PATTERN.test(elementId);\n\n    if (!isDotSeparated && !isKebabCase) {\n      result.addError({\n        layer: layerName,\n        elementId,\n        message: `Invalid element ID format: ${elementId}`,\n        fixSuggestion: 'Use format: {layer}.{type}.{name} (e.g., motivation.goal.increase-revenue) or {layer}-{type}-{kebab-case-name}',\n      });\n      return;\n    }\n\n    const idLayer = this.extractLayerFromId(elementId, isDotSeparated);\n\n    // Verify layer prefix matches the actual layer\n    const normalizedLayerName = layerName.replace(/-/g, '_');\n    const normalizedIdLayer = idLayer.replace(/-/g, '_');\n\n    if (normalizedIdLayer !== normalizedLayerName) {\n      result.addError({\n        layer: layerName,\n        elementId,\n        message: `Element ID layer prefix '${idLayer}' does not match layer '${layerName}'`,\n        fixSuggestion: `Change prefix to '${layerName}' (e.g., ${layerName}.type.name)`,\n      });\n      return;\n    }\n\n    // Extract remaining parts after layer\n    const separator = isDotSeparated ? '.' : '-';\n    const remainingParts = elementId.slice(idLayer.length + 1).split(separator);\n\n    // Verify type is present and non-empty\n    if (remainingParts.length < 2) {\n      result.addError({\n        layer: layerName,\n        elementId,\n        message: 'Element ID must have type and name components after layer',\n        fixSuggestion: 'Use format: {layer}.{type}.{name}',\n      });\n      return;\n    }\n  }\n\n  /**\n   * Extract layer name from element ID, handling hyphenated/underscored layer names\n   */\n  private extractLayerFromId(elementId: string, isDotSeparated: boolean): string {\n    // Try to match known layers in order of specificity (longest first)\n    const sortedLayers = [...this.KNOWN_LAYERS].sort((a, b) => b.length - a.length);\n\n    const separator = isDotSeparated ? '.' : '-';\n\n    for (const layer of sortedLayers) {\n      if (elementId.startsWith(layer + separator)) {\n        return layer;\n      }\n    }\n\n    // Fallback: take first component before separator\n    return elementId.split(separator)[0];\n  }\n}\n"],
+  "mappings": "AAIA,SAAS,wBAAwB;AAM3B,MAAO,gBAAe;;;EAGT,wBAAwB;EACxB,qBAAqB;;EAGrB,eAAe;IAC9B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;;;;EAMF,cAAc,OAAY;AACxB,UAAM,SAAS,IAAI,iBAAgB;AAEnC,eAAW,WAAW,MAAM,aAAY;AACtC,WAAK,kBAAkB,QAAQ,IAAI,MAAM,MAAM,MAAM;AAGvD,WAAO;EACT;;;;EAKQ,kBACN,WACA,WACA,QAAwB;AAGxB,UAAM,iBAAiB,KAAK,sBAAsB,KAAK,SAAS,GAC1D,cAAc,KAAK,mBAAmB,KAAK,SAAS;AAE1D,QAAI,CAAC,kBAAkB,CAAC,aAAa;AACnC,aAAO,SAAS;QACd,OAAO;QACP;QACA,SAAS,8BAA8B,SAAS;QAChD,eAAe;OAChB;AACD;IACF;AAEA,UAAM,UAAU,KAAK,mBAAmB,WAAW,cAAc,GAG3D,sBAAsB,UAAU,QAAQ,MAAM,GAAG;AAGvD,QAF0B,QAAQ,QAAQ,MAAM,GAAG,MAEzB,qBAAqB;AAC7C,aAAO,SAAS;QACd,OAAO;QACP;QACA,SAAS,4BAA4B,OAAO,2BAA2B,SAAS;QAChF,eAAe,qBAAqB,SAAS,YAAY,SAAS;OACnE;AACD;IACF;AAGA,UAAM,YAAY,iBAAiB,MAAM;AAIzC,QAHuB,UAAU,MAAM,QAAQ,SAAS,CAAC,EAAE,MAAM,SAAS,EAGvD,SAAS,GAAG;AAC7B,aAAO,SAAS;QACd,OAAO;QACP;QACA,SAAS;QACT,eAAe;OAChB;AACD;IACF;EACF;;;;EAKQ,mBAAmB,WAAmB,gBAAuB;AAEnE,UAAM,eAAe,CAAC,GAAG,KAAK,YAAY,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAExE,YAAY,iBAAiB,MAAM;AAEzC,eAAW,SAAS;AAClB,UAAI,UAAU,WAAW,QAAQ,SAAS;AACxC,eAAO;AAKX,WAAO,UAAU,MAAM,SAAS,EAAE,CAAC;EACrC;;",
+  "names": []
+}