@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/commands/validate.js

@@ -4,13 +4,28 @@ import path from "path";
 import { fileURLToPath } from "url";
 import { Model } from "../core/model.js";
 import { Validator } from "../validators/validator.js";
+import { ValidationFormatter } from "../validators/validation-formatter.js";
+import { getErrorMessage } from "../utils/errors.js";
+import { RELATIONSHIPS_BY_SOURCE, RELATIONSHIPS_BY_DESTINATION } from "../generated/relationship-index.js";
+import { getActiveSpan } from "../telemetry/index.js";
+async function findJsonFiles(dir, baseDir = dir) {
+  const entries = await fs.readdir(dir, { withFileTypes: !0 }), files = [];
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory() && entry.name !== "layers") {
+      const subFiles = await findJsonFiles(fullPath, baseDir);
+      files.push(...subFiles);
+    } else entry.name.endsWith(".json") && entry.isFile() && files.push(path.relative(baseDir, fullPath));
+  }
+  return files;
+}
 async function validateSchemaSynchronization() {
   console.log(""), console.log(ansis.bold("Validating schema synchronization...")), console.log("");
-  const __filename = fileURLToPath(import.meta.url), __dirname = path.dirname(__filename), projectRoot = path.resolve(__dirname, "../../.."), specSchemaDir = path.join(projectRoot, "spec", "schemas"), bundledSchemaDir = path.join(__dirname, "../schemas/bundled"), specSchemaFiles = await fs.readdir(specSchemaDir), bundledSchemaFiles = await fs.readdir(bundledSchemaDir), schemaFiles = specSchemaFiles.filter((f) => f.endsWith(".json"));
-  if (schemaFiles.length === 0)
+  const __filename = fileURLToPath(import.meta.url), __dirname = path.dirname(__filename), projectRoot = path.resolve(__dirname, "../../.."), specSchemaDir = path.join(projectRoot, "spec", "dist"), bundledSchemaDir = path.join(__dirname, "../schemas/bundled"), specSchemaFiles = await findJsonFiles(specSchemaDir), bundledSchemaFiles = await findJsonFiles(bundledSchemaDir);
+  if (specSchemaFiles.length === 0)
     throw new Error("No schema files found in spec/schemas/");
   let mismatches = [];
-  for (const schemaFile of schemaFiles) {
+  for (const schemaFile of specSchemaFiles) {
     const specPath = path.join(specSchemaDir, schemaFile), bundledPath = path.join(bundledSchemaDir, schemaFile);
     try {
       const specContent = await fs.readFile(specPath, "utf-8");
@@ -24,45 +39,149 @@ async function validateSchemaSynchronization() {
           throw error;
       }
     } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
+      const message = getErrorMessage(error);
       mismatches.push(`  ${ansis.red("\u2717")} ${schemaFile} - Error reading spec schema: ${message}`);
     }
   }
   for (const bundledFile of bundledSchemaFiles)
-    bundledFile.endsWith(".json") && !schemaFiles.includes(bundledFile) && mismatches.push(`  ${ansis.red("\u2717")} ${bundledFile} - Extra file in cli/src/schemas/bundled/ (not in spec/)`);
+    specSchemaFiles.includes(bundledFile) || mismatches.push(`  ${ansis.red("\u2717")} ${bundledFile} - Extra file in cli/src/schemas/bundled/ (not in spec/)`);
   if (mismatches.length > 0) {
     console.log(""), console.log(ansis.bold(ansis.red(`\u2717 Schema synchronization failed with ${mismatches.length} issue(s):`))), console.log("");
     for (const mismatch of mismatches)
       console.log(mismatch);
-    throw console.log(""), console.log(ansis.dim("To fix: Ensure spec/schemas/*.json matches cli/src/schemas/bundled/*.json")), console.log(""), new Error(`Schema synchronization failed with ${mismatches.length} issue(s)`);
+    throw console.log(""), console.log(ansis.dim("To fix: Run 'npm run build:spec' at repo root, then 'npm run build' in cli/ to sync spec/dist/ \u2192 cli/src/schemas/bundled/")), console.log(""), new Error(`Schema synchronization failed with ${mismatches.length} issue(s)`);
   } else
     console.log(""), console.log(ansis.green("\u2713 All schemas synchronized")), console.log("");
 }
+async function validateOrphansOnly(model, outputPath) {
+  const stats = ValidationFormatter.calculateStats(model);
+  if (stats.orphanedElements.length === 0) {
+    outputPath ? (await fs.writeFile(outputPath, JSON.stringify({ total: 0, byLayer: {} }, null, 2), "utf-8"), console.log(`
+Orphan report exported to ${outputPath}`)) : console.log(ansis.green(`
+\u2713 No orphaned elements found. All elements are connected.`));
+    return;
+  }
+  const typesInModel = /* @__PURE__ */ new Set();
+  for (const [, layer] of model.layers)
+    for (const element of layer.listElements()) {
+      const parts2 = (element.path || element.id).split(".");
+      parts2.length >= 2 && typesInModel.add(`${parts2[0]}.${parts2[1]}`);
+    }
+  const byLayer = /* @__PURE__ */ new Map();
+  for (const elementId of stats.orphanedElements.sort()) {
+    const parts2 = elementId.split("."), layer = parts2[0] ?? "unknown", specNodeType = parts2.length >= 2 ? `${parts2[0]}.${parts2[1]}` : elementId, outgoingRels = RELATIONSHIPS_BY_SOURCE.get(specNodeType) ?? [], allDestTypes = [...new Set(outgoingRels.map((r) => r.destinationSpecNodeId))], reachableDestTypes = allDestTypes.filter((t) => typesInModel.has(t)), reachablePredicates = [...new Set(outgoingRels.filter((r) => reachableDestTypes.includes(r.destinationSpecNodeId)).map((r) => r.predicate))], incomingRels = RELATIONSHIPS_BY_DESTINATION.get(specNodeType) ?? [], reachableIncomingSourceTypes = [...new Set(incomingRels.map((r) => r.sourceSpecNodeId))].filter((t) => typesInModel.has(t)), hasOutgoingTargets = reachableDestTypes.length > 0, hasIncomingSources = reachableIncomingSourceTypes.length > 0, hasAnySchemas = outgoingRels.length > 0 || incomingRels.length > 0;
+    let status;
+    hasAnySchemas ? !hasOutgoingTargets && !hasIncomingSources ? status = "dead-end" : status = "connectable" : status = "no-schema", byLayer.has(layer) || byLayer.set(layer, []), byLayer.get(layer).push({
+      id: elementId,
+      type: specNodeType,
+      status,
+      reachablePredicates,
+      reachableTargetTypes: reachableDestTypes,
+      needsTypes: allDestTypes
+    });
+  }
+  if (outputPath) {
+    const jsonOut = {
+      total: stats.orphanedElements.length,
+      byLayer: Object.fromEntries([...byLayer.entries()].map(([layer, items]) => [layer, items]))
+    };
+    await fs.writeFile(outputPath, JSON.stringify(jsonOut, null, 2), "utf-8"), console.log(`
+Orphan report exported to ${outputPath}`);
+    return;
+  }
+  console.log(ansis.bold(`
+Orphaned Elements (${stats.orphanedElements.length})`)), console.log(ansis.dim(`Elements with no intra-layer relationships and no cross-layer references
+`));
+  let deadEndCount = 0, connectableCount = 0;
+  for (const [layerName, items] of byLayer) {
+    console.log(ansis.bold(ansis.cyan(`  ${layerName} (${items.length})`)));
+    for (const item of items)
+      if (item.status === "no-schema")
+        console.log(`    ${ansis.dim("\u25CB")} ${item.id}`), console.log(`      ${ansis.dim("No outgoing relationship schemas defined for type " + item.type)}`);
+      else if (item.status === "dead-end") {
+        deadEndCount++;
+        const needsPreview = item.needsTypes.slice(0, 4).join(", ") + (item.needsTypes.length > 4 ? ` +${item.needsTypes.length - 4} more` : "");
+        console.log(`    ${ansis.red("\u2717")} ${item.id} ${ansis.dim("(dead-end)")}`), console.log(`      ${ansis.dim("Needs: " + needsPreview)}`);
+      } else {
+        connectableCount++;
+        const predsPreview = item.reachablePredicates.slice(0, 3).join(", "), targetsPreview = item.reachableTargetTypes.slice(0, 3).join(", ");
+        console.log(`    ${ansis.yellow("\u25CB")} ${item.id}`), console.log(`      ${ansis.dim(`\u2192 try: ${predsPreview} \u2192 ${targetsPreview}`)}`);
+      }
+    console.log();
+  }
+  const noSchemaCount = stats.orphanedElements.length - connectableCount - deadEndCount, parts = [];
+  connectableCount > 0 && parts.push(`${connectableCount} connectable`), deadEndCount > 0 && parts.push(`${deadEndCount} dead-end (valid target types missing from model)`), noSchemaCount > 0 && parts.push(`${noSchemaCount} no-schema`), console.log(ansis.dim(`Summary: ${parts.length > 0 ? parts.join(", ") : "0 actionable"}`)), connectableCount > 0 && console.log(ansis.dim("Run /dr-relate --orphans to wire connectable elements"));
+}
 async function validateCommand(options) {
+  const activeSpan = getActiveSpan();
+  activeSpan && (activeSpan.setAttribute("validate.layers", options.layers?.join(",") || "all"), activeSpan.setAttribute("validate.strict", options.strict || !1), activeSpan.setAttribute("validate.verbose", options.verbose || !1), activeSpan.setAttribute("validate.orphans", options.orphans || !1), activeSpan.setAttribute("validate.schemas", options.schemas || options.schema || !1), activeSpan.setAttribute("validate.output", options.output || "console"));
   try {
     if (options.schemas || options.schema) {
-      await validateSchemaSynchronization();
+      await validateSchemaSynchronization(), activeSpan && (activeSpan.setAttribute("validate.mode", "schema-sync"), activeSpan.setAttribute("validate.result", "success"));
       return;
     }
-    const model = await Model.load(options.model), validator = new Validator();
-    console.log(""), console.log(ansis.bold("Validating model...")), console.log("");
-    const result = await validator.validateModel(model);
-    if (result.errors.length > 0) {
-      console.log(ansis.bold(ansis.red(`\u2717 ${result.errors.length} error(s):`))), console.log("");
-      for (const error of result.errors)
-        console.log(ansis.red(`  [${error.layer}] ${error.message}`)), error.elementId && console.log(ansis.dim(`    Element: ${error.elementId}`)), error.fixSuggestion && console.log(ansis.dim(`    \u2192 Suggestion: ${error.fixSuggestion}`));
-      console.log("");
+    const model = await Model.load(options.model, options.layers ? { layers: options.layers } : {});
+    if (options.orphans) {
+      activeSpan && activeSpan.setAttribute("validate.mode", "orphans-only");
+      const activeChangesetId2 = model.getActiveChangesetId(), modelForOrphans = activeChangesetId2 ? await model.getVirtualProjectionEngine().projectModel(model, activeChangesetId2) : model;
+      await validateOrphansOnly(modelForOrphans, options.output), activeSpan && activeSpan.setAttribute("validate.result", "success");
+      return;
     }
-    if (result.warnings.length > 0) {
-      console.log(ansis.bold(ansis.yellow(`\u26A0 ${result.warnings.length} warning(s):`))), console.log("");
-      for (const warning of result.warnings)
-        console.log(ansis.yellow(`  [${warning.layer}] ${warning.message}`)), warning.elementId && console.log(ansis.dim(`    Element: ${warning.elementId}`)), warning.fixSuggestion && console.log(ansis.dim(`    \u2192 Suggestion: ${warning.fixSuggestion}`));
-      console.log("");
+    const validator = new Validator(), activeChangesetId = model.getActiveChangesetId(), modelToValidate = activeChangesetId ? await model.getVirtualProjectionEngine().projectModel(model, activeChangesetId) : model, result = await validator.validateModel(modelToValidate), stats = ValidationFormatter.calculateStats(modelToValidate);
+    for (const orphanId of stats.orphanedElements)
+      result.addWarning({
+        message: `Element '${orphanId}' is orphaned (no cross-layer references or intra-layer relationships)`,
+        layer: orphanId.split(".")[0] ?? "",
+        elementId: orphanId,
+        category: "orphan",
+        fixSuggestion: "Add cross-layer references or relationships to connect this element to the rest of the model"
+      });
+    for (const [layerName, layer] of modelToValidate.layers)
+      for (const element of layer.listElements()) {
+        const elementId = element.path || element.id;
+        element.source_reference || result.addWarning({
+          message: `Element '${elementId}' has no source reference`,
+          layer: layerName,
+          elementId,
+          fixSuggestion: "Add a source_reference with provenance to link this element to its implementation"
+        });
+      }
+    if (options.strict)
+      for (const [layerName, layer] of modelToValidate.layers)
+        for (const element of layer.listElements()) {
+          const elementId = element.path || element.id;
+          (!element.description || element.description.trim() === "") && result.addWarning({
+            message: `Element '${elementId}' has no description`,
+            layer: layerName,
+            elementId,
+            fixSuggestion: "Add a description to document what this element represents"
+          });
+        }
+    if (activeSpan && (activeSpan.setAttribute("validate.valid", result.isValid()), activeSpan.setAttribute("validate.error_count", result.errors.length), activeSpan.setAttribute("validate.warning_count", result.warnings.length), activeSpan.setAttribute("validate.orphan_count", stats.orphanedElements.length)), options.output) {
+      let content;
+      if (options.output.endsWith(".md") || options.output.endsWith(".markdown") ? content = ValidationFormatter.toMarkdown(result, modelToValidate) : options.output.endsWith(".json") ? content = JSON.stringify(ValidationFormatter.toJSON(result, modelToValidate), null, 2) : content = JSON.stringify(ValidationFormatter.toJSON(result, modelToValidate), null, 2), await fs.writeFile(options.output, content, "utf-8"), console.log(`
+Validation report exported to ${options.output}`), !result.isValid())
+        throw new Error("Validation failed");
+      activeSpan && activeSpan.setAttribute("validate.result", "success");
+      return;
     }
-    result.isValid() ? result.warnings.length === 0 ? (console.log(ansis.green("\u2713 Validation passed")), console.log(""), process.exit(0)) : (console.log(ansis.yellow(`\u2713 Validation passed with ${result.warnings.length} warning(s)`)), console.log(""), options.strict ? (console.log(ansis.red("Strict mode enabled: treating warnings as errors")), process.exit(1)) : process.exit(0)) : (console.log(ansis.red(`\u2717 Validation failed with ${result.errors.length} error(s)`)), console.log(""), process.exit(1));
+    const formatted = ValidationFormatter.format(result, modelToValidate, {
+      verbose: options.verbose,
+      quiet: options.quiet
+    });
+    if (console.log(formatted), result.isValid()) {
+      if (options.strict && result.warnings.length > 0)
+        throw console.log(ansis.red("Strict mode enabled: treating warnings as errors")), new Error("Validation failed (strict mode)");
+      activeSpan && activeSpan.setAttribute("validate.result", "success");
+      return;
+    } else
+      throw new Error("Validation failed");
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(ansis.red(`Error: ${message}`)), process.env.DEBUG && console.error(error.stack), process.exit(1);
+    activeSpan?.setAttribute("validate.result", "error");
+    const message = getErrorMessage(error);
+    throw console.error(ansis.red(`Error: ${message}`)), error instanceof Error && error.stack && (console.error(ansis.dim(`
+Full error details:`)), console.error(ansis.dim(error.stack))), process.env.DEBUG && (console.error(ansis.dim(`
+Debug mode enabled. Additional context:`)), error instanceof Error && (console.error(ansis.dim(`Error name: ${error.name}`)), console.error(ansis.dim(`Error cause: ${error.cause || "none"}`)))), error;
   }
 }
 export {

package/dist/commands/validate.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/validate.ts"],
-  "sourcesContent": ["/**\n * Validate the architecture model\n */\n\nimport ansis from 'ansis';\nimport { promises as fs } from 'fs';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { Model } from '../core/model.js';\nimport { Validator } from '../validators/validator.js';\n\nexport interface ValidateOptions {\n  layers?: string[];\n  strict?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n  model?: string;\n  // Python CLI compatibility options\n  all?: boolean;\n  markdown?: boolean;\n  schemas?: boolean;\n  schema?: boolean;  // Alias for schemas\n  relationships?: boolean;\n  structure?: boolean;\n  naming?: boolean;\n  references?: boolean;\n}\n\n/**\n * Validate schema synchronization between spec/ and cli/src/schemas/bundled/\n * @throws {Error} if schema synchronization validation fails\n */\nasync function validateSchemaSynchronization(): Promise<void> {\n  console.log('');\n  console.log(ansis.bold('Validating schema synchronization...'));\n  console.log('');\n\n  const __filename = fileURLToPath(import.meta.url);\n  const __dirname = path.dirname(__filename);\n\n  // Resolve paths relative to project root\n  const projectRoot = path.resolve(__dirname, '../../..');\n  const specSchemaDir = path.join(projectRoot, 'spec', 'schemas');\n  const bundledSchemaDir = path.join(__dirname, '../schemas/bundled');\n\n  const specSchemaFiles = await fs.readdir(specSchemaDir);\n  const bundledSchemaFiles = await fs.readdir(bundledSchemaDir);\n\n  const schemaFiles = specSchemaFiles.filter(f => f.endsWith('.json'));\n\n  if (schemaFiles.length === 0) {\n    throw new Error('No schema files found in spec/schemas/');\n  }\n\n  let mismatches: string[] = [];\n\n  for (const schemaFile of schemaFiles) {\n    const specPath = path.join(specSchemaDir, schemaFile);\n    const bundledPath = path.join(bundledSchemaDir, schemaFile);\n\n    try {\n      const specContent = await fs.readFile(specPath, 'utf-8');\n\n      try {\n        const bundledContent = await fs.readFile(bundledPath, 'utf-8');\n\n        // Normalize JSON to account for formatting differences\n        const specParsed = JSON.parse(specContent);\n        const bundledParsed = JSON.parse(bundledContent);\n        const specNormalized = JSON.stringify(specParsed, null, 2);\n        const bundledNormalized = JSON.stringify(bundledParsed, null, 2);\n\n        if (specNormalized !== bundledNormalized) {\n          mismatches.push(\n            `  ${ansis.red('\u2717')} ${schemaFile} - Content differs between spec/ and cli/src/schemas/bundled/`\n          );\n        } else {\n          console.log(`  ${ansis.green('\u2713')} ${schemaFile}`);\n        }\n      } catch (error) {\n        if ((error as any).code === 'ENOENT') {\n          mismatches.push(\n            `  ${ansis.red('\u2717')} ${schemaFile} - Missing in cli/src/schemas/bundled/`\n          );\n        } else {\n          throw error;\n        }\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      mismatches.push(`  ${ansis.red('\u2717')} ${schemaFile} - Error reading spec schema: ${message}`);\n    }\n  }\n\n  // Check for extra files in bundled that aren't in spec\n  for (const bundledFile of bundledSchemaFiles) {\n    if (bundledFile.endsWith('.json') && !schemaFiles.includes(bundledFile)) {\n      mismatches.push(\n        `  ${ansis.red('\u2717')} ${bundledFile} - Extra file in cli/src/schemas/bundled/ (not in spec/)`\n      );\n    }\n  }\n\n  if (mismatches.length > 0) {\n    console.log('');\n    console.log(ansis.bold(ansis.red(`\u2717 Schema synchronization failed with ${mismatches.length} issue(s):`)));\n    console.log('');\n    for (const mismatch of mismatches) {\n      console.log(mismatch);\n    }\n    console.log('');\n    console.log(ansis.dim('To fix: Ensure spec/schemas/*.json matches cli/src/schemas/bundled/*.json'));\n    console.log('');\n    throw new Error(`Schema synchronization failed with ${mismatches.length} issue(s)`);\n  } else {\n    console.log('');\n    console.log(ansis.green('\u2713 All schemas synchronized'));\n    console.log('');\n  }\n}\n\nexport async function validateCommand(options: ValidateOptions): Promise<void> {\n  try {\n    // Handle schema validation flag\n    if (options.schemas || options.schema) {\n      await validateSchemaSynchronization();\n      return;\n    }\n\n    // Load model\n    const model = await Model.load(options.model);\n\n    // Validate\n    const validator = new Validator();\n\n    console.log('');\n    console.log(ansis.bold('Validating model...'));\n    console.log('');\n\n    const result = await validator.validateModel(model);\n\n    // Display errors\n    if (result.errors.length > 0) {\n      console.log(ansis.bold(ansis.red(`\u2717 ${result.errors.length} error(s):`)));\n      console.log('');\n      for (const error of result.errors) {\n        console.log(ansis.red(`  [${error.layer}] ${error.message}`));\n        if (error.elementId) {\n          console.log(ansis.dim(`    Element: ${error.elementId}`));\n        }\n        if (error.fixSuggestion) {\n          console.log(ansis.dim(`    \u2192 Suggestion: ${error.fixSuggestion}`));\n        }\n      }\n      console.log('');\n    }\n\n    // Display warnings\n    if (result.warnings.length > 0) {\n      console.log(ansis.bold(ansis.yellow(`\u26A0 ${result.warnings.length} warning(s):`)));\n      console.log('');\n      for (const warning of result.warnings) {\n        console.log(ansis.yellow(`  [${warning.layer}] ${warning.message}`));\n        if (warning.elementId) {\n          console.log(ansis.dim(`    Element: ${warning.elementId}`));\n        }\n        if (warning.fixSuggestion) {\n          console.log(ansis.dim(`    \u2192 Suggestion: ${warning.fixSuggestion}`));\n        }\n      }\n      console.log('');\n    }\n\n    // Display summary\n    if (result.isValid()) {\n      if (result.warnings.length === 0) {\n        console.log(ansis.green('\u2713 Validation passed'));\n        console.log('');\n        process.exit(0);\n      } else {\n        console.log(\n          ansis.yellow(\n            `\u2713 Validation passed with ${result.warnings.length} warning(s)`\n          )\n        );\n        console.log('');\n        if (options.strict) {\n          console.log(ansis.red('Strict mode enabled: treating warnings as errors'));\n          process.exit(1);\n        } else {\n          process.exit(0);\n        }\n      }\n    } else {\n      console.log(\n        ansis.red(`\u2717 Validation failed with ${result.errors.length} error(s)`)\n      );\n      console.log('');\n      process.exit(1);\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    if (process.env.DEBUG) {\n      console.error((error as Error).stack);\n    }\n    process.exit(1);\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
+  "sourcesContent": ["/**\n * Validate the architecture model\n */\n\nimport ansis from \"ansis\";\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { Model } from \"../core/model.js\";\nimport { Validator } from \"../validators/validator.js\";\nimport { ValidationFormatter } from \"../validators/validation-formatter.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { RELATIONSHIPS_BY_SOURCE, RELATIONSHIPS_BY_DESTINATION } from \"../generated/relationship-index.js\";\nimport { getActiveSpan } from \"../telemetry/index.js\";\n\n\nexport interface ValidateOptions {\n  layers?: string[];\n  strict?: boolean;\n  verbose?: boolean;\n  quiet?: boolean;\n  output?: string;\n  debug?: boolean;\n  model?: string;\n  orphans?: boolean;\n  // Python CLI compatibility options\n  all?: boolean;\n  markdown?: boolean;\n  schemas?: boolean;\n  schema?: boolean; // Alias for schemas\n  relationships?: boolean;\n  structure?: boolean;\n  naming?: boolean;\n  references?: boolean;\n}\n\n/**\n * Validate schema synchronization between spec/ and cli/src/schemas/bundled/\n * @throws {Error} if schema synchronization validation fails\n */\n/**\n * Recursively find all JSON schema files in a directory\n * Excludes 'layers' subdirectory since layer instances are not schemas\n */\nasync function findJsonFiles(dir: string, baseDir: string = dir): Promise<string[]> {\n  const entries = await fs.readdir(dir, { withFileTypes: true });\n  const files: string[] = [];\n\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    // Skip 'layers' directory - layer instances are synced but are not schemas\n    if (entry.isDirectory() && entry.name !== \"layers\") {\n      const subFiles = await findJsonFiles(fullPath, baseDir);\n      files.push(...subFiles);\n    } else if (entry.name.endsWith(\".json\") && entry.isFile()) {\n      // Store relative path from base directory\n      files.push(path.relative(baseDir, fullPath));\n    }\n  }\n\n  return files;\n}\n\nasync function validateSchemaSynchronization(): Promise<void> {\n  console.log(\"\");\n  console.log(ansis.bold(\"Validating schema synchronization...\"));\n  console.log(\"\");\n\n  const __filename = fileURLToPath(import.meta.url);\n  const __dirname = path.dirname(__filename);\n\n  // Resolve paths relative to project root\n  const projectRoot = path.resolve(__dirname, \"../../..\");\n  // Compare spec/dist/ (14 compiled flat files) vs dist/schemas/bundled/ (same 14 files)\n  // spec/schemas/ contains individual source files; spec/dist/ is the compiled distribution\n  const specSchemaDir = path.join(projectRoot, \"spec\", \"dist\");\n  const bundledSchemaDir = path.join(__dirname, \"../schemas/bundled\");\n\n  // Find all JSON files recursively\n  const specSchemaFiles = await findJsonFiles(specSchemaDir);\n  const bundledSchemaFiles = await findJsonFiles(bundledSchemaDir);\n\n  if (specSchemaFiles.length === 0) {\n    throw new Error(\"No schema files found in spec/schemas/\");\n  }\n\n  let mismatches: string[] = [];\n\n  for (const schemaFile of specSchemaFiles) {\n    const specPath = path.join(specSchemaDir, schemaFile);\n    const bundledPath = path.join(bundledSchemaDir, schemaFile);\n\n    try {\n      const specContent = await fs.readFile(specPath, \"utf-8\");\n\n      try {\n        const bundledContent = await fs.readFile(bundledPath, \"utf-8\");\n\n        // Normalize JSON to account for formatting differences\n        const specParsed = JSON.parse(specContent);\n        const bundledParsed = JSON.parse(bundledContent);\n        const specNormalized = JSON.stringify(specParsed, null, 2);\n        const bundledNormalized = JSON.stringify(bundledParsed, null, 2);\n\n        if (specNormalized !== bundledNormalized) {\n          mismatches.push(\n            `  ${ansis.red(\"\u2717\")} ${schemaFile} - Content differs between spec/ and cli/src/schemas/bundled/`\n          );\n        } else {\n          console.log(`  ${ansis.green(\"\u2713\")} ${schemaFile}`);\n        }\n      } catch (error) {\n        if ((error as any).code === \"ENOENT\") {\n          mismatches.push(\n            `  ${ansis.red(\"\u2717\")} ${schemaFile} - Missing in cli/src/schemas/bundled/`\n          );\n        } else {\n          throw error;\n        }\n      }\n    } catch (error) {\n      const message = getErrorMessage(error);\n      mismatches.push(`  ${ansis.red(\"\u2717\")} ${schemaFile} - Error reading spec schema: ${message}`);\n    }\n  }\n\n  // Check for extra files in bundled that aren't in spec\n  for (const bundledFile of bundledSchemaFiles) {\n    if (!specSchemaFiles.includes(bundledFile)) {\n      mismatches.push(\n        `  ${ansis.red(\"\u2717\")} ${bundledFile} - Extra file in cli/src/schemas/bundled/ (not in spec/)`\n      );\n    }\n  }\n\n  if (mismatches.length > 0) {\n    console.log(\"\");\n    console.log(\n      ansis.bold(ansis.red(`\u2717 Schema synchronization failed with ${mismatches.length} issue(s):`))\n    );\n    console.log(\"\");\n    for (const mismatch of mismatches) {\n      console.log(mismatch);\n    }\n    console.log(\"\");\n    console.log(\n      ansis.dim(\"To fix: Run 'npm run build:spec' at repo root, then 'npm run build' in cli/ to sync spec/dist/ \u2192 cli/src/schemas/bundled/\")\n    );\n    console.log(\"\");\n    throw new Error(`Schema synchronization failed with ${mismatches.length} issue(s)`);\n  } else {\n    console.log(\"\");\n    console.log(ansis.green(\"\u2713 All schemas synchronized\"));\n    console.log(\"\");\n  }\n}\n\n/**\n * Display structured orphan report grouped by layer, with dead-end detection.\n * For each orphan, checks whether valid relationship targets exist in the model.\n */\nasync function validateOrphansOnly(model: Model, outputPath?: string): Promise<void> {\n  const stats = ValidationFormatter.calculateStats(model);\n\n  if (stats.orphanedElements.length === 0) {\n    const msg = \"No orphaned elements found. All elements are connected.\";\n    if (outputPath) {\n      await fs.writeFile(outputPath, JSON.stringify({ total: 0, byLayer: {} }, null, 2), \"utf-8\");\n      console.log(`\\nOrphan report exported to ${outputPath}`);\n    } else {\n      console.log(ansis.green(`\\n\u2713 ${msg}`));\n    }\n    return;\n  }\n\n  // Build set of element types currently present in the model\n  const typesInModel = new Set<string>();\n  for (const [, layer] of model.layers) {\n    for (const element of layer.listElements()) {\n      const id = element.path || element.id;\n      const parts = id.split(\".\");\n      if (parts.length >= 2) typesInModel.add(`${parts[0]}.${parts[1]}`);\n    }\n  }\n\n  // Group orphans by layer, annotated with dead-end status\n  const byLayer = new Map<string, Array<{\n    id: string;\n    type: string;\n    status: \"dead-end\" | \"connectable\" | \"no-schema\";\n    reachablePredicates: string[];\n    reachableTargetTypes: string[];\n    needsTypes: string[];\n  }>>();\n\n  for (const elementId of stats.orphanedElements.sort()) {\n    const parts = elementId.split(\".\");\n    const layer = parts[0] ?? \"unknown\";\n    const specNodeType = parts.length >= 2 ? `${parts[0]}.${parts[1]}` : elementId;\n\n    // Outgoing: this element can point to others\n    const outgoingRels = RELATIONSHIPS_BY_SOURCE.get(specNodeType) ?? [];\n    const allDestTypes = [...new Set(outgoingRels.map(r => r.destinationSpecNodeId))];\n    const reachableDestTypes = allDestTypes.filter(t => typesInModel.has(t));\n    const reachablePredicates = [...new Set(\n      outgoingRels.filter(r => reachableDestTypes.includes(r.destinationSpecNodeId)).map(r => r.predicate)\n    )];\n\n    // Incoming: other element types in the model can point to this element\n    const incomingRels = RELATIONSHIPS_BY_DESTINATION.get(specNodeType) ?? [];\n    const reachableIncomingSourceTypes = [...new Set(incomingRels.map(r => r.sourceSpecNodeId))]\n      .filter(t => typesInModel.has(t));\n\n    const hasOutgoingTargets = reachableDestTypes.length > 0;\n    const hasIncomingSources = reachableIncomingSourceTypes.length > 0;\n    const hasAnySchemas = outgoingRels.length > 0 || incomingRels.length > 0;\n\n    let status: \"dead-end\" | \"connectable\" | \"no-schema\";\n    if (!hasAnySchemas) {\n      status = \"no-schema\";\n    } else if (!hasOutgoingTargets && !hasIncomingSources) {\n      status = \"dead-end\";\n    } else {\n      status = \"connectable\";\n    }\n\n    if (!byLayer.has(layer)) byLayer.set(layer, []);\n    byLayer.get(layer)!.push({\n      id: elementId,\n      type: specNodeType,\n      status,\n      reachablePredicates,\n      reachableTargetTypes: reachableDestTypes,\n      needsTypes: allDestTypes,\n    });\n  }\n\n  if (outputPath) {\n    const jsonOut: Record<string, unknown> = {\n      total: stats.orphanedElements.length,\n      byLayer: Object.fromEntries(\n        [...byLayer.entries()].map(([layer, items]) => [layer, items])\n      ),\n    };\n    await fs.writeFile(outputPath, JSON.stringify(jsonOut, null, 2), \"utf-8\");\n    console.log(`\\nOrphan report exported to ${outputPath}`);\n    return;\n  }\n\n  console.log(ansis.bold(`\\nOrphaned Elements (${stats.orphanedElements.length})`));\n  console.log(ansis.dim(\"Elements with no intra-layer relationships and no cross-layer references\\n\"));\n\n  let deadEndCount = 0;\n  let connectableCount = 0;\n\n  for (const [layerName, items] of byLayer) {\n    console.log(ansis.bold(ansis.cyan(`  ${layerName} (${items.length})`)));\n    for (const item of items) {\n      if (item.status === \"no-schema\") {\n        console.log(`    ${ansis.dim(\"\u25CB\")} ${item.id}`);\n        console.log(`      ${ansis.dim(\"No outgoing relationship schemas defined for type \" + item.type)}`);\n      } else if (item.status === \"dead-end\") {\n        deadEndCount++;\n        const needsPreview = item.needsTypes.slice(0, 4).join(\", \") +\n          (item.needsTypes.length > 4 ? ` +${item.needsTypes.length - 4} more` : \"\");\n        console.log(`    ${ansis.red(\"\u2717\")} ${item.id} ${ansis.dim(\"(dead-end)\")}`);\n        console.log(`      ${ansis.dim(\"Needs: \" + needsPreview)}`);\n      } else {\n        connectableCount++;\n        const predsPreview = item.reachablePredicates.slice(0, 3).join(\", \");\n        const targetsPreview = item.reachableTargetTypes.slice(0, 3).join(\", \");\n        console.log(`    ${ansis.yellow(\"\u25CB\")} ${item.id}`);\n        console.log(`      ${ansis.dim(`\u2192 try: ${predsPreview} \u2192 ${targetsPreview}`)}`);\n      }\n    }\n    console.log();\n  }\n\n  // Summary line\n  const noSchemaCount = stats.orphanedElements.length - connectableCount - deadEndCount;\n  const parts: string[] = [];\n  if (connectableCount > 0) parts.push(`${connectableCount} connectable`);\n  if (deadEndCount > 0) parts.push(`${deadEndCount} dead-end (valid target types missing from model)`);\n  if (noSchemaCount > 0) parts.push(`${noSchemaCount} no-schema`);\n  console.log(ansis.dim(`Summary: ${parts.length > 0 ? parts.join(\", \") : \"0 actionable\"}`));\n  if (connectableCount > 0) {\n    console.log(ansis.dim(\"Run /dr-relate --orphans to wire connectable elements\"));\n  }\n}\n\nexport async function validateCommand(options: ValidateOptions): Promise<void> {\n  // Annotate the root cli.execute span with validate-specific attributes\n  const activeSpan = getActiveSpan();\n  if (activeSpan) {\n    activeSpan.setAttribute(\"validate.layers\", options.layers?.join(\",\") || \"all\");\n    activeSpan.setAttribute(\"validate.strict\", options.strict || false);\n    activeSpan.setAttribute(\"validate.verbose\", options.verbose || false);\n    activeSpan.setAttribute(\"validate.orphans\", options.orphans || false);\n    activeSpan.setAttribute(\"validate.schemas\", options.schemas || options.schema || false);\n    activeSpan.setAttribute(\"validate.output\", options.output || \"console\");\n  }\n\n  try {\n    // Handle schema validation flag\n    if (options.schemas || options.schema) {\n      await validateSchemaSynchronization();\n\n      if (activeSpan) {\n        activeSpan.setAttribute(\"validate.mode\", \"schema-sync\");\n        activeSpan.setAttribute(\"validate.result\", \"success\");\n      }\n      return;\n    }\n\n    // Load model (forward --layers filter so only requested layers are read from disk)\n    const model = await Model.load(options.model, options.layers ? { layers: options.layers } : {});\n\n    // --orphans mode: focused orphan report, skip full validation\n    if (options.orphans) {\n      if (activeSpan) {\n        activeSpan.setAttribute(\"validate.mode\", \"orphans-only\");\n      }\n\n      const activeChangesetId = model.getActiveChangesetId();\n      const modelForOrphans = activeChangesetId\n        ? (await model.getVirtualProjectionEngine().projectModel(model, activeChangesetId)) as unknown as typeof model\n        : model;\n      await validateOrphansOnly(modelForOrphans, options.output);\n\n      if (activeSpan) {\n        activeSpan.setAttribute(\"validate.result\", \"success\");\n      }\n      return;\n    }\n\n    // Validate\n    const validator = new Validator();\n\n    // If an active changeset exists, project staged elements into the model so validators see them\n    const activeChangesetId = model.getActiveChangesetId();\n    const modelToValidate = activeChangesetId\n      ? (await model.getVirtualProjectionEngine().projectModel(model, activeChangesetId)) as unknown as typeof model\n      : model;\n\n    const result = await validator.validateModel(modelToValidate);\n\n    // Detect orphaned elements and add them as warnings so they appear in\n    // the warning count and are surfaced consistently across all output formats.\n    const stats = ValidationFormatter.calculateStats(modelToValidate);\n    for (const orphanId of stats.orphanedElements) {\n      result.addWarning({\n        message: `Element '${orphanId}' is orphaned (no cross-layer references or intra-layer relationships)`,\n        layer: orphanId.split(\".\")[0] ?? \"\",\n        elementId: orphanId,\n        category: \"orphan\",\n        fixSuggestion: \"Add cross-layer references or relationships to connect this element to the rest of the model\",\n      });\n    }\n\n    // Check source traceability in normal mode: elements without source_reference lack the\n    // provenance link that dr-sync uses for drift detection. Surface this in every validate\n    // run so users discover gaps without having to remember --strict.\n    for (const [layerName, layer] of modelToValidate.layers) {\n      for (const element of layer.listElements()) {\n        const elementId = element.path || element.id;\n        if (!element.source_reference) {\n          result.addWarning({\n            message: `Element '${elementId}' has no source reference`,\n            layer: layerName,\n            elementId,\n            fixSuggestion:\n              \"Add a source_reference with provenance to link this element to its implementation\",\n          });\n        }\n      }\n    }\n\n    // Strict-mode additional checks: flag elements missing a description.\n    if (options.strict) {\n      for (const [layerName, layer] of modelToValidate.layers) {\n        for (const element of layer.listElements()) {\n          const elementId = element.path || element.id;\n\n          if (!element.description || element.description.trim() === \"\") {\n            result.addWarning({\n              message: `Element '${elementId}' has no description`,\n              layer: layerName,\n              elementId,\n              fixSuggestion: \"Add a description to document what this element represents\",\n            });\n          }\n        }\n      }\n    }\n\n    // Record validation results in span\n    if (activeSpan) {\n      activeSpan.setAttribute(\"validate.valid\", result.isValid());\n      activeSpan.setAttribute(\"validate.error_count\", result.errors.length);\n      activeSpan.setAttribute(\"validate.warning_count\", result.warnings.length);\n      activeSpan.setAttribute(\"validate.orphan_count\", stats.orphanedElements.length);\n    }\n\n    // Format and display output\n    if (options.output) {\n      // Export to file\n      let content: string;\n\n      if (options.output.endsWith(\".md\") || options.output.endsWith(\".markdown\")) {\n        content = ValidationFormatter.toMarkdown(result, modelToValidate);\n      } else if (options.output.endsWith(\".json\")) {\n        content = JSON.stringify(ValidationFormatter.toJSON(result, modelToValidate), null, 2);\n      } else {\n        // Default to JSON\n        content = JSON.stringify(ValidationFormatter.toJSON(result, modelToValidate), null, 2);\n      }\n\n      await fs.writeFile(options.output, content, \"utf-8\");\n      console.log(`\\nValidation report exported to ${options.output}`);\n\n      if (!result.isValid()) {\n        throw new Error(\"Validation failed\");\n      }\n\n      if (activeSpan) {\n        activeSpan.setAttribute(\"validate.result\", \"success\");\n      }\n      return;\n    }\n\n    // Display formatted output\n    const formatted = ValidationFormatter.format(result, modelToValidate, {\n      verbose: options.verbose,\n      quiet: options.quiet,\n    });\n\n    console.log(formatted);\n\n    // Exit with appropriate code\n    if (result.isValid()) {\n      if (options.strict && result.warnings.length > 0) {\n        console.log(ansis.red(\"Strict mode enabled: treating warnings as errors\"));\n        throw new Error(\"Validation failed (strict mode)\");\n      }\n\n      if (activeSpan) {\n        activeSpan.setAttribute(\"validate.result\", \"success\");\n      }\n      return;\n    } else {\n      throw new Error(\"Validation failed\");\n    }\n  } catch (error) {\n    activeSpan?.setAttribute(\"validate.result\", \"error\");\n\n    const message = getErrorMessage(error);\n    console.error(ansis.red(`Error: ${message}`));\n\n    // Always preserve full error details in stderr for debugging\n    if (error instanceof Error && error.stack) {\n      console.error(ansis.dim(\"\\nFull error details:\"));\n      console.error(ansis.dim(error.stack));\n    }\n\n    // Additional context for debugging\n    if (process.env.DEBUG) {\n      console.error(ansis.dim(\"\\nDebug mode enabled. Additional context:\"));\n      if (error instanceof Error) {\n        console.error(ansis.dim(`Error name: ${error.name}`));\n        console.error(ansis.dim(`Error cause: ${(error as any).cause || \"none\"}`));\n      }\n    }\n\n    // Re-throw to let root span handle exit\n    throw error;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["parts", "activeChangesetId"]
 }

package/dist/commands/version.js

@@ -1,18 +1,14 @@
 import ansis from "ansis";
-import { readJSON, fileExists } from "../utils/file-io.js";
 import { getCliBundledSpecVersion } from "../utils/spec-version.js";
-async function getPackageVersion() {
-  const packagePath = `${import.meta.url.replace("file://", "").split("/src/")[0]}/package.json`;
-  if (await fileExists(packagePath))
-    try {
-      return (await readJSON(packagePath)).version;
-    } catch {
-    }
-  return "0.1.0";
-}
+import { isTelemetryBuiltIn, isTelemetryConfigured } from "../telemetry/detect.js";
+import { getSpecReferencePath, getModelPath } from "../utils/project-paths.js";
+const gitHash = "d3cc2b3", cliVersion = "0.1.5";
 async function versionCommand() {
-  const cliVersion = await getPackageVersion(), specVersion = getCliBundledSpecVersion();
-  console.log(ansis.bold("Documentation Robotics CLI")), console.log(`CLI Version:  ${ansis.cyan(cliVersion)}`), console.log(`Spec Version: ${ansis.cyan(specVersion)}`);
+  const specVersion = getCliBundledSpecVersion(), telemetryBuiltIn = isTelemetryBuiltIn(), telemetryConfigured = await isTelemetryConfigured();
+  let telemetryStatus;
+  telemetryBuiltIn ? telemetryConfigured ? telemetryStatus = ansis.green("enabled, configured") : telemetryStatus = ansis.yellow("enabled, not configured") : telemetryStatus = ansis.dim("not available (build)"), console.log(ansis.bold("Documentation Robotics CLI")), console.log(`CLI Version:  ${ansis.cyan(cliVersion)}`), console.log(`Spec Version: ${ansis.cyan(specVersion)}`), console.log(`Git Hash:     ${ansis.cyan(gitHash)}`), console.log(`Telemetry:    ${telemetryStatus}`), console.log(`Spec source:  ${ansis.cyan("bundled with CLI")}`);
+  const drFolder = await getSpecReferencePath();
+  console.log(`DR folder:    ${ansis.cyan(drFolder || "Not found")}`), console.log(`Model path:   ${ansis.cyan(await getModelPath() || "Not found")}`);
 }
 export {
   versionCommand

package/dist/commands/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/version.ts"],
-  "sourcesContent": ["/**\n * Version Command - Display CLI and bundled spec versions\n */\n\nimport ansis from 'ansis';\nimport { readJSON, fileExists } from '../utils/file-io.js';\nimport { getCliBundledSpecVersion } from '../utils/spec-version.js';\n\n/**\n * Read CLI version from package.json\n */\nasync function getPackageVersion(): Promise<string> {\n  const packagePath = `${import.meta.url.replace('file://', '').split('/src/')[0]}/package.json`;\n\n  if (await fileExists(packagePath)) {\n    try {\n      const data = await readJSON<{ version: string }>(packagePath);\n      return data.version;\n    } catch {\n      // Fall through to default\n    }\n  }\n\n  return '0.1.0';\n}\n\nexport async function versionCommand(): Promise<void> {\n  const cliVersion = await getPackageVersion();\n  const specVersion = getCliBundledSpecVersion();\n\n  console.log(ansis.bold('Documentation Robotics CLI'));\n  console.log(`CLI Version:  ${ansis.cyan(cliVersion)}`);\n  console.log(`Spec Version: ${ansis.cyan(specVersion)}`);\n}\n"],
-  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,UAAU,kBAAkB;AACrC,SAAS,gCAAgC;AAKzC,eAAe,oBAAiB;AAC9B,QAAM,cAAc,GAAG,YAAY,IAAI,QAAQ,WAAW,EAAE,EAAE,MAAM,OAAO,EAAE,CAAC,CAAC;AAE/E,MAAI,MAAM,WAAW,WAAW;AAC9B,QAAI;AAEF,cADa,MAAM,SAA8B,WAAW,GAChD;IACd,QAAQ;IAER;AAGF,SAAO;AACT;AAEA,eAAsB,iBAAc;AAClC,QAAM,aAAa,MAAM,kBAAiB,GACpC,cAAc,yBAAwB;AAE5C,UAAQ,IAAI,MAAM,KAAK,4BAA4B,CAAC,GACpD,QAAQ,IAAI,iBAAiB,MAAM,KAAK,UAAU,CAAC,EAAE,GACrD,QAAQ,IAAI,iBAAiB,MAAM,KAAK,WAAW,CAAC,EAAE;AACxD;",
+  "sourcesContent": ["/**\n * Version Command - Display CLI and bundled spec versions\n */\n\nimport ansis from \"ansis\";\nimport { getCliBundledSpecVersion } from \"../utils/spec-version.js\";\nimport { isTelemetryBuiltIn, isTelemetryConfigured } from \"../telemetry/detect.js\";\nimport { getSpecReferencePath, getModelPath } from \"../utils/project-paths.js\";\n\n// Declare build-time constants (substituted by esbuild)\ndeclare const GIT_HASH: string;\ndeclare const CLI_VERSION: string;\n\nconst gitHash = typeof GIT_HASH !== \"undefined\" ? GIT_HASH : \"unknown\";\nconst cliVersion = typeof CLI_VERSION !== \"undefined\" ? CLI_VERSION : \"0.1.3\";\n\nexport async function versionCommand(): Promise<void> {\n  const specVersion = getCliBundledSpecVersion();\n  const telemetryBuiltIn = isTelemetryBuiltIn();\n  const telemetryConfigured = await isTelemetryConfigured();\n\n  // Determine telemetry status message\n  let telemetryStatus: string;\n  if (!telemetryBuiltIn) {\n    telemetryStatus = ansis.dim(\"not available (build)\");\n  } else if (telemetryConfigured) {\n    telemetryStatus = ansis.green(\"enabled, configured\");\n  } else {\n    telemetryStatus = ansis.yellow(\"enabled, not configured\");\n  }\n\n  console.log(ansis.bold(\"Documentation Robotics CLI\"));\n  console.log(`CLI Version:  ${ansis.cyan(cliVersion)}`);\n  console.log(`Spec Version: ${ansis.cyan(specVersion)}`);\n  console.log(`Git Hash:     ${ansis.cyan(gitHash)}`);\n  console.log(`Telemetry:    ${telemetryStatus}`);\n  console.log(`Spec source:  ${ansis.cyan(\"bundled with CLI\")}`);\n  const drFolder = await getSpecReferencePath();\n  console.log(`DR folder:    ${ansis.cyan(drFolder || \"Not found\")}`);\n  console.log(`Model path:   ${ansis.cyan((await getModelPath()) || \"Not found\")}`);\n}\n"],
+  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,gCAAgC;AACzC,SAAS,oBAAoB,6BAA6B;AAC1D,SAAS,sBAAsB,oBAAoB;AAMnD,MAAM,UAA4C,WAC5C,aAAkD;AAExD,eAAsB,iBAAc;AAClC,QAAM,cAAc,yBAAwB,GACtC,mBAAmB,mBAAkB,GACrC,sBAAsB,MAAM,sBAAqB;AAGvD,MAAI;AACJ,EAAK,mBAEM,sBACT,kBAAkB,MAAM,MAAM,qBAAqB,IAEnD,kBAAkB,MAAM,OAAO,yBAAyB,IAJxD,kBAAkB,MAAM,IAAI,uBAAuB,GAOrD,QAAQ,IAAI,MAAM,KAAK,4BAA4B,CAAC,GACpD,QAAQ,IAAI,iBAAiB,MAAM,KAAK,UAAU,CAAC,EAAE,GACrD,QAAQ,IAAI,iBAAiB,MAAM,KAAK,WAAW,CAAC,EAAE,GACtD,QAAQ,IAAI,iBAAiB,MAAM,KAAK,OAAO,CAAC,EAAE,GAClD,QAAQ,IAAI,iBAAiB,eAAe,EAAE,GAC9C,QAAQ,IAAI,iBAAiB,MAAM,KAAK,kBAAkB,CAAC,EAAE;AAC7D,QAAM,WAAW,MAAM,qBAAoB;AAC3C,UAAQ,IAAI,iBAAiB,MAAM,KAAK,YAAY,WAAW,CAAC,EAAE,GAClE,QAAQ,IAAI,iBAAiB,MAAM,KAAM,MAAM,aAAY,KAAO,WAAW,CAAC,EAAE;AAClF;",
   "names": []
 }

package/dist/commands/visualize.js

@@ -1,12 +1,30 @@
 import ansis from "ansis";
+import { spawn } from "child_process";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
 import { Model } from "../core/model.js";
-import { VisualizationServer } from "../server/server.js";
 import { logVerbose, logDebug } from "../utils/globals.js";
+import { CLIError } from "../utils/errors.js";
+import { getSpecReferencePath, getModelPath } from "../utils/project-paths.js";
+import { getErrorMessage } from "../utils/errors.js";
+const isTelemetryEnabled = !1;
+async function findAvailablePort(startPort) {
+  const { createServer } = await import("net");
+  for (let port = startPort; port <= 65535; port++)
+    if (await new Promise((resolve) => {
+      const server = createServer();
+      server.once("error", () => resolve(!1)), server.once("listening", () => {
+        server.close(), resolve(!0);
+      }), server.listen(port, "127.0.0.1");
+    }))
+      return port;
+  throw new Error("No available ports found");
+}
 async function visualizeCommand(options) {
   try {
-    logDebug("Loading model for visualization...");
-    const model = await Model.load(process.cwd(), { lazyLoad: !1 });
-    logVerbose(`Model loaded: ${model.manifest.name}`);
+    logDebug("Loading model for validation...");
+    const model = await Model.load(process.cwd(), { lazyLoad: !0 });
+    logVerbose(`Model validated: ${model.manifest.name}`);
     let port = 8080;
     if (options.port) {
       const portNum = parseInt(String(options.port), 10);
@@ -14,31 +32,143 @@ async function visualizeCommand(options) {
         throw new Error(`Invalid port number: ${options.port}. Port must be between 1 and 65535.`);
       port = portNum;
     }
-    const authEnabled = !options.noAuth, authToken = options.token, server = new VisualizationServer(model, { authEnabled, authToken });
-    if (logDebug(`Starting visualization server on port ${port}`), logDebug(`Authentication: ${authEnabled ? "enabled" : "disabled"}`), authEnabled && authToken ? logDebug("Using provided token for authentication") : authEnabled && logDebug("Token will be auto-generated"), await server.start(port), console.log(ansis.green("\u2713 Visualization server started")), authEnabled) {
-      const token = server.getAuthToken();
-      console.log(ansis.cyan(`   Access URL: http://localhost:${port}?token=${token}`)), console.log(ansis.dim(`   Auth token: ${token}`));
+    port = await findAvailablePort(port), port !== (options.port ? parseInt(String(options.port), 10) : 8080) && console.log(ansis.yellow(`   Port ${options.port ?? 8080} is in use, using port ${port} instead`));
+    const authEnabled = !options.noAuth, authToken = options.token, withDanger = options.withDanger || !1;
+    logDebug(`Starting visualization server on port ${port}`), logDebug(`Authentication: ${authEnabled ? "enabled" : "disabled"}`), authEnabled && authToken ? logDebug("Using provided token for authentication") : authEnabled && logDebug("Token will be auto-generated"), withDanger && logDebug("Danger mode enabled - chat permissions will be skipped");
+    const commandDir = dirname(fileURLToPath(import.meta.url)), serverEntryPath = `${dirname(commandDir)}/server-entry.js`;
+    logDebug(`Server entry path: ${serverEntryPath}`);
+    let serverStartupSpan = null;
+    if (isTelemetryEnabled) {
+      logDebug("[Telemetry] Creating visualize.server.startup span");
+      const { startSpan } = await import("../telemetry/index.js");
+      serverStartupSpan = startSpan("visualize.server.startup", {
+        "server.port": port,
+        "server.auth_enabled": authEnabled,
+        "server.with_danger": withDanger
+      }), logDebug(`[Telemetry] Span created: ${serverStartupSpan ? "success" : "failed"}`);
     } else
-      console.log(ansis.dim(`   Open http://localhost:${port} in your browser`)), console.log(ansis.yellow("   \u26A0 Authentication disabled"));
-    logVerbose(`   Model: ${model.manifest.name} (${model.getLayerNames().length} layers)`);
-    const shouldOpenBrowser = !options.noBrowser;
-    if (logDebug(`Browser auto-open: ${shouldOpenBrowser ? "enabled" : "disabled"} (noBrowser=${options.noBrowser})`), shouldOpenBrowser)
-      try {
-        const command = getOpenCommand(), url = authEnabled ? `http://localhost:${port}?token=${server.getAuthToken()}` : `http://localhost:${port}`;
-        logDebug(`Opening browser with command: ${command} ${url}`), Bun.spawn([command, url], {
-          stdout: "ignore",
-          stderr: "ignore"
-        });
-      } catch {
-        logVerbose("Could not auto-open browser (not critical)");
+      logDebug("[Telemetry] TELEMETRY_ENABLED is false - no spans will be created");
+    const env = {
+      ...process.env,
+      DR_VISUALIZE_PORT: String(port),
+      DR_PROJECT_PATH: process.cwd(),
+      DR_AUTH_ENABLED: String(authEnabled),
+      DR_WITH_DANGER: String(withDanger)
+    }, { isDebug: getDebugState, isVerbose } = await import("../utils/globals.js");
+    getDebugState() && (env.DEBUG = "1", env.DR_TELEMETRY_DEBUG = "1", logDebug("Passing DEBUG=1 and DR_TELEMETRY_DEBUG=1 to subprocess")), isVerbose() && (env.VERBOSE = "1", logDebug("Passing VERBOSE=1 to subprocess")), authToken && (env.DR_AUTH_TOKEN = authToken), options.viewerPath && (env.DR_VIEWER_PATH = options.viewerPath, logDebug(`Using custom viewer from: ${options.viewerPath}`));
+    const serverProcess = spawn("bun", ["run", serverEntryPath], {
+      cwd: process.cwd(),
+      stdio: ["pipe", "pipe", "pipe"],
+      env
+    });
+    let authTokenFromServer = "", serverOutput = "", serverStartupShown = !1;
+    serverProcess.stdout && serverProcess.stdout.on("data", async (data) => {
+      const chunk = data.toString();
+      serverOutput += chunk;
+      const lines = chunk.split(`
+`);
+      for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line) {
+          if (line.startsWith("TOKEN:") && (authTokenFromServer = line.substring(6), logDebug(`Received auth token from server: ${authTokenFromServer.substring(0, 8)}...`), serverStartupShown && authEnabled && authTokenFromServer && (console.log(ansis.cyan(`   Access URL: http://localhost:${port}?token=${authTokenFromServer}`)), console.log(ansis.dim(`   Auth token: ${authTokenFromServer}`)), !options.noBrowser)))
+            try {
+              const command = getOpenCommand(), url = `http://localhost:${port}?token=${authTokenFromServer}`;
+              logDebug(`Opening browser with command: ${command} ${url}`), spawn(command, [url], {
+                detached: !0,
+                stdio: "ignore"
+              });
+            } catch {
+              logVerbose("Could not auto-open browser (not critical)");
+            }
+          if (line.includes("running at http://localhost")) {
+            if (serverStartupShown = !0, isTelemetryEnabled && serverStartupSpan) {
+              logDebug("[Telemetry] Ending visualize.server.startup span (server started successfully)");
+              const { endSpan } = await import("../telemetry/index.js");
+              endSpan(serverStartupSpan), serverStartupSpan = null, logDebug("[Telemetry] Span ended");
+            }
+            if (console.log(ansis.green("\u2713 Visualization server started")), authEnabled) {
+              const token = authTokenFromServer || authToken || "(pending)";
+              authTokenFromServer ? (console.log(ansis.cyan(`   Access URL: http://localhost:${port}?token=${token}`)), console.log(ansis.dim(`   Auth token: ${token}`))) : (console.log(ansis.dim(`   Open http://localhost:${port} in your browser`)), logDebug("   (waiting for auth token...)"));
+            } else
+              console.log(ansis.dim(`   Open http://localhost:${port} in your browser`)), console.log(ansis.yellow("   \u26A0 Authentication disabled"));
+            withDanger && console.log(ansis.yellow("   \u26A0 Danger mode enabled - chat permissions will be skipped")), console.log(ansis.blueBright(`Model name: ${model.manifest.name}`));
+            const drFolder = await getSpecReferencePath();
+            console.log(`DR folder:    ${ansis.cyan(drFolder || "Not found")}`), console.log(`Model path:   ${ansis.cyan(await getModelPath() || "Not found")}`);
+            const shouldOpenBrowser = !options.noBrowser;
+            if (logDebug(`Browser auto-open: ${shouldOpenBrowser ? "enabled" : "disabled"} (noBrowser=${options.noBrowser})`), shouldOpenBrowser && !authEnabled)
+              try {
+                const command = getOpenCommand(), url = `http://localhost:${port}`;
+                logDebug(`Opening browser with command: ${command} ${url}`), spawn(command, [url], {
+                  detached: !0,
+                  stdio: "ignore"
+                });
+              } catch {
+                logVerbose("Could not auto-open browser (not critical)");
+              }
+            else shouldOpenBrowser && authEnabled && !authTokenFromServer ? logDebug("Browser auto-open deferred until token is received") : logDebug("Browser auto-open disabled");
+          }
+          line.startsWith("TOKEN:") || logDebug(`[server] ${line}`);
+        }
+      }
+    }), serverProcess.stderr && serverProcess.stderr.on("data", (data) => {
+      const output = data.toString().trim();
+      output && (serverOutput += output + `
+`, logDebug(`[server stderr] ${output}`));
+    });
+    let rejectKeepAlive = null;
+    serverProcess.on("close", (code) => {
+      if (code !== 0) {
+        const message = serverOutput ? `Server exited with code ${code}
+Server output:
+${serverOutput}` : `Server exited with code ${code}`;
+        isTelemetryEnabled && serverStartupSpan && (async () => {
+          const { endSpan } = await import("../telemetry/index.js");
+          "recordException" in serverStartupSpan && (serverStartupSpan.recordException(new Error(message)), serverStartupSpan.setStatus({ code: 2, message })), endSpan(serverStartupSpan), serverStartupSpan = null;
+        })(), console.error(message);
+        const error = new CLIError(message, code || 1);
+        rejectKeepAlive && rejectKeepAlive(error);
       }
-    else
-      logDebug("Browser auto-open disabled");
-    await new Promise(() => {
+    }), serverProcess.on("error", (error) => {
+      const message = `Failed to start visualization server: ${error.message}`;
+      isTelemetryEnabled && serverStartupSpan && (async () => {
+        const { endSpan } = await import("../telemetry/index.js");
+        "recordException" in serverStartupSpan && (serverStartupSpan.recordException(error), serverStartupSpan.setStatus({ code: 2, message })), endSpan(serverStartupSpan), serverStartupSpan = null;
+      })(), console.error(message);
+      const cliError = new CLIError(message, 1);
+      rejectKeepAlive && rejectKeepAlive(cliError);
+    });
+    let flushInterval = null;
+    if (isTelemetryEnabled) {
+      logDebug("[Telemetry] Setting up periodic flush (every 15 seconds)");
+      const { flushTelemetry } = await import("../telemetry/index.js");
+      flushInterval = setInterval(async () => {
+        logDebug("[Telemetry] Periodic flush: flushing pending spans...");
+        try {
+          await flushTelemetry(), logDebug("[Telemetry] Periodic flush complete");
+        } catch (error) {
+          logDebug(`[Telemetry] Periodic flush failed: ${error}`);
+        }
+      }, 15e3);
+    }
+    const handleShutdown = async (signal) => {
+      logDebug(`
+[${signal}] Shutting down visualization server gracefully...`), flushInterval && (logDebug("[Telemetry] Stopping periodic flush"), clearInterval(flushInterval), flushInterval = null), serverProcess && !serverProcess.killed && (logDebug("Sending termination signal to server process..."), serverProcess.kill(signal), await new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+          logDebug("Server shutdown timeout, forcing exit..."), serverProcess.killed || serverProcess.kill("SIGKILL"), resolve();
+        }, 3e3);
+        serverProcess.on("exit", () => {
+          clearTimeout(timeout), resolve();
+        });
+      })), logDebug("Visualization server stopped"), process.exit(0);
+    };
+    process.on("SIGINT", () => handleShutdown("SIGINT")), process.on("SIGTERM", () => handleShutdown("SIGTERM")), await new Promise((_, reject) => {
+      rejectKeepAlive = reject;
     });
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(ansis.red(`Error: ${message}`)), logDebug(`Stack: ${error instanceof Error ? error.stack : "N/A"}`), process.exit(1);
+    if (error instanceof CLIError)
+      throw error;
+    const message = getErrorMessage(error);
+    throw console.error(message), new CLIError(message, 1);
   }
 }
 function getOpenCommand() {