@documentation-robotics/cli 0.1.12 → 0.2.0

package/dist/commands/farm.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/farm.ts"],
+  "sourcesContent": ["/**\n * Farm Commands - Manage model farms and project registration\n */\n\nimport ansis from \"ansis\";\nimport { Command } from \"commander\";\nimport path from \"path\";\nimport { rm } from \"fs/promises\";\nimport { FarmManifest } from \"../core/farm-manifest.js\";\nimport { findFarmRoot } from \"../utils/project-paths.js\";\nimport { fileExists } from \"../utils/file-io.js\";\nimport { execSync, execFileSync } from \"child_process\";\nimport * as prompts from \"@clack/prompts\";\nimport { getErrorMessage, handleSuccess, handleInfo } from \"../utils/errors.js\";\nimport { isJson } from \"../utils/globals.js\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { Model } from \"../core/model.js\";\nimport { ComposedReferenceValidator } from \"../validators/composed-reference-validator.js\";\nimport { ValidationFormatter } from \"../validators/validation-formatter.js\";\nimport { FarmSyncEngine } from \"../core/farm-sync-engine.js\";\n\ninterface FarmSyncResultEntry {\n  project: string;\n  status: \"success\" | \"error\" | \"partial\";\n  change_count?: number;\n  changeset_id?: string;\n  files_changed?: { added: string[]; modified: string[]; deleted: string[] };\n  ambiguities?: number;\n  commits_before?: string;\n  commits_after?: string;\n  auto_committed?: boolean;\n  committed_changes?: number;\n  commit_error?: string;\n  message?: string;\n}\n\n/**\n * Check if a directory is a git repository.\n * Returns true if git rev-parse succeeds, false if the directory is not a git repo\n * or if unexpected errors occur (which are logged in DEBUG mode only).\n * Does not re-throw errors; unexpected git errors are logged diagnostically but do not\n * prevent the operation from proceeding.\n */\nfunction isGitRepository(cwd: string): boolean {\n  try {\n    execSync(\"git rev-parse --git-dir\", { cwd, stdio: \"pipe\" });\n    return true;\n  } catch (error) {\n    const errorMsg = getErrorMessage(error);\n\n    // Only return false for the \"not a git repository\" case\n    // Pattern: \"fatal: not a git repository\" (case insensitive check for safety)\n    if (errorMsg.toLowerCase().includes(\"not a git repository\")) {\n      return false;\n    }\n\n    // For unexpected errors (missing git binary, permission denied, etc), log diagnostically\n    // but return false to preserve existing behavior of not blocking operations\n    if (process.env.DEBUG) {\n      console.warn(`Warning: Unexpected error checking git repository at ${cwd}: ${errorMsg}`);\n    }\n    return false;\n  }\n}\n\n/**\n * Initialize a new farm\n */\nexport async function farmInitCommand(options: {\n  name?: string;\n  description?: string;\n  format?: string;\n  platformView?: boolean;\n}): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.init\") : null;\n\n  try {\n    const farmPath = process.cwd();\n    const farmYamlPath = path.join(farmPath, \"farm.yaml\");\n\n    // Check if farm.yaml already exists\n    const useJson = options.format === \"json\" || isJson();\n    if (await fileExists(farmYamlPath)) {\n      const message = \"Farm already initialized in this directory\";\n      if (useJson) {\n        console.log(JSON.stringify({ status: \"error\", code: 1, message }));\n      } else {\n        console.error(ansis.red(`Error: ${message}`));\n      }\n      if (span) endSpan(span);\n      process.exit(1);\n    }\n\n    // Get farm name\n    let farmName = options.name;\n    if (!farmName) {\n      const isInteractive = process.stdin.isTTY;\n      if (isInteractive) {\n        const result = await prompts.text({\n          message: \"Farm name\",\n          placeholder: \"My Architecture Farm\",\n        });\n\n        if (typeof result === \"string\") {\n          farmName = result;\n        }\n      }\n    }\n\n    if (!farmName) {\n      farmName = \"Architecture Farm\";\n    }\n\n    // Create manifest with platform_view support if requested\n    const manifest = FarmManifest.create(farmName, {\n      platform_view: options.platformView || false,\n    });\n    await manifest.save(farmYamlPath);\n\n    // Initialize farm-level git repository\n    try {\n      execSync(\"git init\", { cwd: farmPath, stdio: useJson ? \"pipe\" : \"inherit\" });\n      execSync(\"git config user.email 'dr-farm@localhost'\", {\n        cwd: farmPath,\n        stdio: \"pipe\",\n      });\n      execSync(\"git config user.name 'DR Farm'\", {\n        cwd: farmPath,\n        stdio: \"pipe\",\n      });\n\n      // Add farm.yaml and commit\n      execSync(\"git add farm.yaml\", { cwd: farmPath, stdio: \"pipe\" });\n      execSync(\"git commit -m 'Initialize farm manifest'\", {\n        cwd: farmPath,\n        stdio: useJson ? \"pipe\" : \"inherit\",\n      });\n    } catch (gitError) {\n      throw new Error(\n        `Failed to initialize farm git repository: ${getErrorMessage(gitError)}`\n      );\n    }\n\n    if (useJson) {\n      console.log(JSON.stringify({ status: \"ok\", farmPath, farmName, platform_view: options.platformView || false }));\n    } else {\n      const platformViewNote = options.platformView ? \" (platform-view enabled)\" : \"\";\n      handleSuccess(\n        `Farm initialized: ${ansis.bold(farmName)}${platformViewNote}\\n  Location: ${farmPath}`\n      );\n    }\n\n    if (span) endSpan(span);\n  } catch (error) {\n    const useJsonError = options.format === \"json\" || isJson();\n    if (useJsonError) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 1,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(1);\n  }\n}\n\n/**\n * Add a project to the farm\n */\nexport async function farmAddCommand(\n  name: string,\n  options: {\n    remote?: string;\n    codebase?: string;\n    format?: string;\n  }\n): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.add\", { \"project.name\": name }) : null;\n  const useJson = options.format === \"json\" || isJson();\n\n  try {\n    // Find farm root\n    const farmRoot = await findFarmRoot();\n    if (!farmRoot) {\n      throw new Error(\"Not in a farm directory. Run 'dr farm init' first.\");\n    }\n\n    const farmYamlPath = path.join(farmRoot, \"farm.yaml\");\n    const manifest = await FarmManifest.load(farmYamlPath);\n\n    // Check if project already exists\n    if (manifest.getProject(name)) {\n      throw new Error(`Project '${name}' already exists in this farm`);\n    }\n\n    // Determine codebase path\n    let codebasePath = options.codebase || name;\n\n    // Clone if remote URL provided\n    if (options.remote) {\n      const codebaseFullPath = path.join(farmRoot, codebasePath);\n      if (await fileExists(codebaseFullPath)) {\n        throw new Error(`Codebase directory '${codebasePath}' already exists`);\n      }\n\n      if (!useJson) {\n        handleInfo(`Cloning ${options.remote} to ${codebasePath}...`);\n      }\n\n      try {\n        execFileSync(\"git\", [\"clone\", options.remote, codebaseFullPath], {\n          stdio: useJson ? \"pipe\" : \"inherit\",\n        });\n      } catch (error) {\n        throw new Error(`Failed to clone repository: ${getErrorMessage(error)}`);\n      }\n    }\n\n    // Create and scaffold model folder\n    const modelFolder = `${name}-model`;\n    const modelFullPath = path.join(farmRoot, modelFolder);\n\n    if (!(await fileExists(modelFullPath))) {\n      // Initialize model with manifest and layer structure\n      await Model.init(\n        modelFullPath,\n        {\n          name: name,\n          version: \"0.1.0\",\n          description: undefined,\n          author: undefined,\n          specVersion: (await import(\"../utils/spec-version.js\")).getCliBundledSpecVersion(),\n          created: new Date().toISOString(),\n        },\n        { lazyLoad: false }\n      );\n\n      if (!useJson) {\n        handleInfo(`Created and initialized model folder: ${modelFolder}`);\n      }\n    }\n\n    // Add project to manifest\n    manifest.addProject(name, {\n      name,\n      source: codebasePath,\n      model: modelFolder,\n      remote: options.remote,\n    });\n\n    await manifest.save(farmYamlPath);\n\n    // Commit farm.yaml changes to farm-level git repository if git is available\n    // Check for git repo first\n    const gitRepoExists = isGitRepository(farmRoot);\n\n    // If git repo exists, proceed with commit (handle commit errors independently)\n    if (gitRepoExists) {\n      try {\n        execSync(\"git add farm.yaml\", { cwd: farmRoot, stdio: \"pipe\" });\n        execFileSync(\"git\", [\"commit\", \"-m\", `Add project: ${name}`], {\n          cwd: farmRoot,\n          stdio: useJson ? \"pipe\" : \"inherit\",\n        });\n      } catch (commitError) {\n        const errorMsg = getErrorMessage(commitError);\n        // If nothing to commit, that's fine\n        if (!errorMsg.includes(\"nothing to commit\")) {\n          throw new Error(`Failed to commit farm changes: ${errorMsg}`);\n        }\n      }\n    }\n\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"ok\",\n          project: name,\n          source: codebasePath,\n          model: modelFolder,\n        })\n      );\n    } else {\n      handleSuccess(\n        `Project added to farm: ${ansis.bold(name)}\\n  Codebase: ${codebasePath}\\n  Model: ${modelFolder}`\n      );\n    }\n\n    if (span) endSpan(span);\n  } catch (error) {\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 1,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(1);\n  }\n}\n\n/**\n * Remove a project from the farm\n */\nexport async function farmRemoveCommand(\n  name: string,\n  options: {\n    deleteModel?: boolean;\n    format?: string;\n  }\n): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.remove\", { \"project.name\": name }) : null;\n  const useJson = options.format === \"json\" || isJson();\n\n  try {\n    // Find farm root\n    const farmRoot = await findFarmRoot();\n    if (!farmRoot) {\n      throw new Error(\"Not in a farm directory.\");\n    }\n\n    const farmYamlPath = path.join(farmRoot, \"farm.yaml\");\n    const manifest = await FarmManifest.load(farmYamlPath);\n\n    // Check if project exists\n    const project = manifest.getProject(name);\n    if (!project) {\n      throw new Error(`Project '${name}' not found in farm`);\n    }\n\n    // Remove model folder if requested\n    if (options.deleteModel) {\n      const modelFullPath = path.resolve(path.join(farmRoot, project.model));\n      const farmRootResolved = path.resolve(farmRoot);\n\n      // Validate that the resolved path is strictly within the farm root to prevent path traversal\n      if (!modelFullPath.startsWith(farmRootResolved + path.sep)) {\n        throw new Error(\n          `Invalid model path: would escape farm root. Path: ${project.model}`\n        );\n      }\n\n      if (await fileExists(modelFullPath)) {\n        try {\n          await rm(modelFullPath, { recursive: true, force: false });\n          if (!useJson) {\n            handleInfo(`Deleted model folder: ${project.model}`);\n          }\n        } catch (error) {\n          throw new Error(`Failed to delete model folder: ${getErrorMessage(error)}`);\n        }\n      }\n    }\n\n    // Remove project from manifest\n    manifest.removeProject(name);\n    await manifest.save(farmYamlPath);\n\n    // Commit farm.yaml changes to farm-level git repository if git is available\n    // Check for git repo first\n    const gitRepoExists = isGitRepository(farmRoot);\n\n    // If git repo exists, proceed with commit (handle commit errors independently)\n    if (gitRepoExists) {\n      try {\n        execSync(\"git add farm.yaml\", { cwd: farmRoot, stdio: \"pipe\" });\n        execFileSync(\"git\", [\"commit\", \"-m\", `Remove project: ${name}`], {\n          cwd: farmRoot,\n          stdio: useJson ? \"pipe\" : \"inherit\",\n        });\n      } catch (commitError) {\n        const errorMsg = getErrorMessage(commitError);\n        // If nothing to commit, that's fine\n        if (!errorMsg.includes(\"nothing to commit\")) {\n          throw new Error(`Failed to commit farm changes: ${errorMsg}`);\n        }\n      }\n    }\n\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"ok\",\n          project: name,\n          modelDeleted: options.deleteModel ?? false,\n        })\n      );\n    } else {\n      handleSuccess(`Project removed from farm: ${ansis.bold(name)}`);\n    }\n\n    if (span) endSpan(span);\n  } catch (error) {\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 1,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(1);\n  }\n}\n\n/**\n * Show farm status\n */\nexport async function farmStatusCommand(options: {\n  format?: string;\n}): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.status\") : null;\n\n  try {\n    // Find farm root\n    const farmRoot = await findFarmRoot();\n    if (!farmRoot) {\n      throw new Error(\"Not in a farm directory.\");\n    }\n\n    const farmYamlPath = path.join(farmRoot, \"farm.yaml\");\n    const manifest = await FarmManifest.load(farmYamlPath);\n\n    const projects = manifest.getAllProjects();\n    const engine = new FarmSyncEngine(farmRoot);\n\n    // Compute pending changes using lightweight commit comparison\n    const projectsWithStatus = await Promise.all(\n      projects.map(async (p) => {\n        try {\n          const syncStatePath = path.join(farmRoot, p.model, \".farm-sync.yaml\");\n          const syncState = await (await import(\"../core/farm-sync-state.js\")).FarmSyncState.loadOrCreate(\n            syncStatePath,\n            p.name\n          );\n\n          // Use lightweight commit comparison instead of full diff\n          const currentCommit = await engine.getCurrentCommit(p.source);\n          const lastSyncCommit = syncState.lastSyncCommit;\n          const hasPendingChanges = !!(lastSyncCommit && lastSyncCommit !== currentCommit);\n\n          return {\n            name: p.name,\n            source: p.source,\n            model: p.model,\n            remote: p.remote,\n            last_sync_commit: lastSyncCommit,\n            current_commit: currentCommit,\n            has_pending_changes: hasPendingChanges,\n          };\n        } catch (error) {\n          // If sync state doesn't exist yet, that's expected - treat as no sync yet\n          // For unexpected errors (YAML parse, git permission, etc), always log them\n          const errorMsg = getErrorMessage(error);\n          if (\n            !errorMsg.includes(\"not found\") &&\n            !errorMsg.includes(\"does not exist\") &&\n            !errorMsg.includes(\"ENOENT\")\n          ) {\n            // Unexpected error - always log it to surface issues to users\n            console.error(`Warning: Error reading sync state for ${p.name}: ${errorMsg}`);\n          }\n          return {\n            name: p.name,\n            source: p.source,\n            model: p.model,\n            remote: p.remote,\n            last_sync_commit: undefined,\n            current_commit: undefined,\n            has_pending_changes: false,\n          };\n        }\n      })\n    );\n\n    const useJson = options.format === \"json\" || isJson();\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"ok\",\n          farm: {\n            name: manifest.name,\n            path: farmRoot,\n            created: manifest.created,\n            modified: manifest.modified,\n            platform_view: manifest.platform_view,\n          },\n          projects: projectsWithStatus,\n          project_count: projects.length,\n        })\n      );\n    } else {\n      console.log(ansis.bold(`Farm: ${manifest.name}`));\n      console.log(`Location: ${farmRoot}`);\n      if (manifest.platform_view) {\n        console.log(`Platform-View: ${ansis.green(\"enabled\")}`);\n      }\n      console.log(`Projects: ${projects.length}\\n`);\n\n      if (projects.length === 0) {\n        console.log(ansis.dim(\"No projects registered yet.\"));\n      } else {\n        projectsWithStatus.forEach((project) => {\n          console.log(`  ${ansis.cyan(project.name)}`);\n          console.log(`    Codebase: ${project.source}`);\n          console.log(`    Model:    ${project.model}`);\n          if (project.remote) {\n            console.log(`    Remote:   ${project.remote}`);\n          }\n          if (project.has_pending_changes) {\n            console.log(`    Status:   ${ansis.yellow(\"\u26A0 Pending changes\")}`);\n          } else if (project.last_sync_commit) {\n            console.log(`    Status:   ${ansis.green(\"\u2713 Up to date\")}`);\n          } else {\n            console.log(`    Status:   ${ansis.dim(\"Not synced yet\")}`);\n          }\n        });\n      }\n    }\n\n    if (span) endSpan(span);\n  } catch (error) {\n    const useJsonError = options.format === \"json\" || isJson();\n    if (useJsonError) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 2,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(2);\n  }\n}\n\n/**\n * Validate a farm project or all projects using composed scope\n */\nexport async function farmValidateCommand(options: {\n  project?: string;\n  verbose?: boolean;\n  quiet?: boolean;\n  output?: string;\n  format?: string;\n}): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.validate\") : null;\n\n  try {\n    // Find farm root\n    const farmRoot = await findFarmRoot();\n    if (!farmRoot) {\n      throw new Error(\"Not in a farm directory. Run 'dr farm init' first.\");\n    }\n\n    const farmYamlPath = path.join(farmRoot, \"farm.yaml\");\n    const farmManifest = await FarmManifest.load(farmYamlPath);\n    const useJson = options.format === \"json\" || isJson();\n\n    // Determine which projects to validate\n    let projectsToValidate = farmManifest.getAllProjects();\n    let isPlatformViewValidation = false;\n\n    if (options.project) {\n      const project = farmManifest.getProject(options.project);\n      if (!project) {\n        throw new Error(`Project '${options.project}' not found in farm`);\n      }\n      projectsToValidate = [project];\n\n      // Check if this is a platform-view project validation\n      if (farmManifest.isPlatformViewEnabled() && options.project === \"platform-view\") {\n        isPlatformViewValidation = true;\n      } else if (options.project === \"platform-view\" && !farmManifest.isPlatformViewEnabled()) {\n        // Warn if platform-view project is being validated but platform-view is not enabled\n        if (!useJson && !options.quiet) {\n          handleInfo(\n            `Note: Validating platform-view project, but platform-view is not enabled on this farm`\n          );\n        }\n      }\n    }\n\n    if (projectsToValidate.length === 0) {\n      throw new Error(\"No projects found in farm\");\n    }\n\n    // Create composed validator from farm\n    // This automatically resolves model-path overrides for all projects in the farm\n    const composedValidator = await ComposedReferenceValidator.fromFarm(farmRoot);\n    if (useJson) {\n      console.log(JSON.stringify({ status: \"validating\", projects: projectsToValidate.length, platform_view: isPlatformViewValidation }));\n    } else if (!options.quiet) {\n      if (options.project) {\n        const platformViewNote = isPlatformViewValidation ? \" (platform-view aggregation)\" : \"\";\n        handleInfo(`Validating project '${options.project}'${platformViewNote} with farm-aware references...`);\n      } else {\n        handleInfo(`Validating ${projectsToValidate.length} farm project(s) with farm-aware references...`);\n      }\n    }\n\n    const allResults = [];\n    const reportData = [];\n\n    // Validate each project\n    for (const project of projectsToValidate) {\n      const modelPath = path.join(farmRoot, project.model);\n\n      // Check if model folder exists\n      if (!(await fileExists(modelPath))) {\n        const error = `Model folder not found for project '${project.name}' at ${modelPath}`;\n        if (useJson) {\n          console.log(\n            JSON.stringify({\n              status: \"error\",\n              code: 2,\n              project: project.name,\n              message: error,\n            })\n          );\n        } else {\n          console.error(ansis.red(`Error: ${error}`));\n        }\n        if (span) endSpan(span);\n        process.exit(2);\n      }\n\n      // Load the model using the safer startPath parameter\n      // For detached models, check if manifest.yaml exists directly in the model folder.\n      // If so, pass it directly to Model.load().\n      let drModelPath = modelPath;\n      const manifestPath = path.join(modelPath, \"manifest.yaml\");\n      if (await fileExists(manifestPath)) {\n        // Point directly to the manifest.yaml file\n        drModelPath = manifestPath;\n      }\n\n      const model = await Model.load(drModelPath);\n\n      let platformViewInfo: {\n        declared_models: string[];\n        missing_models: string[];\n      } | undefined;\n\n      // For platform-view projects, validate that all declared external models are resolvable\n      if (isPlatformViewValidation) {\n        const declaredModels = model.manifest.models || {};\n        const declaredModelNames = Object.keys(declaredModels);\n\n        platformViewInfo = {\n          declared_models: declaredModelNames,\n          missing_models: [],\n        };\n\n        if (declaredModelNames.length === 0) {\n          if (!useJson && !options.quiet) {\n            handleInfo(\n              `  Platform-view project has no declared external models`\n            );\n          }\n        } else {\n          if (!useJson && !options.quiet) {\n            handleInfo(\n              `  Platform-view is declaring external models: ${declaredModelNames.join(\", \")}`\n            );\n          }\n\n          // Verify all declared models are available in the farm\n          const missingModels: string[] = [];\n          for (const declaredModelName of declaredModelNames) {\n            const farmProject = farmManifest.getProject(declaredModelName);\n            if (!farmProject) {\n              missingModels.push(declaredModelName);\n            }\n          }\n\n          platformViewInfo.missing_models = missingModels;\n\n          if (missingModels.length > 0) {\n            if (!useJson) {\n              console.error(\n                ansis.yellow(\n                  `  \u26A0 Warning: The following declared external models are not registered in the farm: ${missingModels.join(\", \")}`\n                )\n              );\n            }\n          }\n        }\n      }\n\n      // Validate using composed reference validator\n      const result = await composedValidator.validateModel(model);\n\n      allResults.push({ project: project.name, result });\n\n      // Format and display validation output\n      const formatted = ValidationFormatter.format(result, model, {\n        verbose: options.verbose,\n        quiet: options.quiet,\n      });\n\n      // Collect report data for output file\n      const reportItem: any = {\n        project: project.name,\n        valid: result.isValid(),\n        errors: result.errors.map((e) => ({\n          message: e.message,\n          layer: e.layer,\n          elementId: e.elementId,\n          location: e.location,\n        })),\n        warnings: result.warnings.map((w) => ({\n          message: w.message,\n          layer: w.layer,\n          elementId: w.elementId,\n          location: w.location,\n        })),\n        formatted,\n      };\n\n      if (platformViewInfo) {\n        reportItem.platform_view_info = platformViewInfo;\n      }\n\n      reportData.push(reportItem);\n\n      if (!options.quiet) {\n        console.log(ansis.bold(`\\nProject: ${project.name}`));\n        console.log(formatted);\n      }\n\n      if (!result.isValid()) {\n        if (options.project) {\n          // Single project validation failed\n          throw new Error(`Validation failed for project '${project.name}'`);\n        }\n        // Multi-project validation: track but continue\n      }\n    }\n\n    // Check if all validations passed\n    const allValid = allResults.every((r) => r.result.isValid());\n\n    // Write output file if requested\n    if (options.output) {\n      const outputExt = path.extname(options.output).toLowerCase();\n\n      if (outputExt === \".json\") {\n        // Write JSON report\n        const jsonReport = {\n          timestamp: new Date().toISOString(),\n          farm_root: farmRoot,\n          all_valid: allValid,\n          projects: reportData.map((r) => {\n            const projectData: any = {\n              project: r.project,\n              valid: r.valid,\n              errors: r.errors,\n              warnings: r.warnings,\n            };\n            if (r.platform_view_info) {\n              projectData.platform_view_info = r.platform_view_info;\n            }\n            return projectData;\n          }),\n        };\n        await (await import(\"fs/promises\")).writeFile(\n          options.output,\n          JSON.stringify(jsonReport, null, 2),\n          \"utf-8\"\n        );\n      } else if (outputExt === \".md\") {\n        // Write Markdown report\n        let mdContent = `# Farm Validation Report\\n\\n`;\n        mdContent += `**Date**: ${new Date().toISOString()}\\n`;\n        mdContent += `**Farm Root**: ${farmRoot}\\n`;\n        mdContent += `**Overall Status**: ${allValid ? \"\u2705 Valid\" : \"\u274C Invalid\"}\\n\\n`;\n\n        mdContent += `## Projects\\n\\n`;\n        for (const r of reportData) {\n          mdContent += `### ${r.project}\\n\\n`;\n          mdContent += `**Status**: ${r.valid ? \"\u2705 Valid\" : \"\u274C Invalid\"}\\n\\n`;\n\n          if (r.errors.length > 0) {\n            mdContent += `#### Errors (${r.errors.length})\\n\\n`;\n            for (const err of r.errors) {\n              mdContent += `- ${err.message}\\n`;\n            }\n            mdContent += \"\\n\";\n          }\n\n          if (r.warnings.length > 0) {\n            mdContent += `#### Warnings (${r.warnings.length})\\n\\n`;\n            for (const warn of r.warnings) {\n              mdContent += `- ${warn.message}\\n`;\n            }\n            mdContent += \"\\n\";\n          }\n        }\n\n        await (await import(\"fs/promises\")).writeFile(options.output, mdContent, \"utf-8\");\n      } else {\n        throw new Error(`Unsupported output format: ${outputExt}. Use .json or .md`);\n      }\n\n      if (!options.quiet) {\n        handleInfo(`Report written to ${options.output}`);\n      }\n    }\n\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"ok\",\n          projects: allResults.map((r) => ({\n            name: r.project,\n            valid: r.result.isValid(),\n            errors: r.result.errors.length,\n            warnings: r.result.warnings.length,\n          })),\n          all_valid: allValid,\n          output: options.output ? path.resolve(options.output) : undefined,\n        })\n      );\n    }\n\n    if (!allValid) {\n      if (span) endSpan(span);\n      process.exit(1);\n    }\n\n    if (!options.quiet) {\n      handleSuccess(\n        options.project\n          ? `Project '${options.project}' validated successfully`\n          : `All farm projects validated successfully`\n      );\n    }\n\n    if (span) endSpan(span);\n  } catch (error) {\n    const useJson = options.format === \"json\" || isJson();\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 2,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(2);\n  }\n}\n\n/**\n * Pull latest changes from remote for farm projects\n */\nexport async function farmPullCommand(options: {\n  project?: string;\n  verbose?: boolean;\n  format?: string;\n}): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.pull\") : null;\n\n  try {\n    // Find farm root\n    const farmRoot = await findFarmRoot();\n    if (!farmRoot) {\n      throw new Error(\"Not in a farm directory. Run 'dr farm init' first.\");\n    }\n\n    const farmYamlPath = path.join(farmRoot, \"farm.yaml\");\n    const manifest = await FarmManifest.load(farmYamlPath);\n\n    // Determine which projects to pull\n    let projectsToPull = manifest.getAllProjects();\n    if (options.project) {\n      const project = manifest.getProject(options.project);\n      if (!project) {\n        throw new Error(`Project '${options.project}' not found in farm`);\n      }\n      projectsToPull = [project];\n    }\n\n    if (projectsToPull.length === 0) {\n      throw new Error(\"No projects found in farm\");\n    }\n\n    const useJson = options.format === \"json\" || isJson();\n    if (!useJson && !options.verbose) {\n      handleInfo(`Pulling ${projectsToPull.length} project(s)...`);\n    }\n\n    // Create sync engine (model not needed for pull-only operations)\n    const engine = new FarmSyncEngine(farmRoot);\n\n    const results = [];\n\n    // Pull each project\n    for (const project of projectsToPull) {\n      try {\n        const commit = await engine.pullCodebase(project.source);\n\n        results.push({\n          project: project.name,\n          status: \"success\",\n          commit,\n        });\n\n        if (options.verbose && !useJson) {\n          handleInfo(`  \u2713 ${project.name}: ${commit.substring(0, 8)}`);\n        }\n      } catch (error) {\n        results.push({\n          project: project.name,\n          status: \"error\",\n          message: getErrorMessage(error),\n        });\n\n        if (!useJson) {\n          console.error(ansis.red(`  \u2717 ${project.name}: ${getErrorMessage(error)}`));\n        }\n      }\n    }\n\n    const allSucceeded = results.every((r) => r.status === \"success\");\n\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: allSucceeded ? \"ok\" : \"partial\",\n          code: allSucceeded ? 0 : 1,\n          projects: results,\n          pulled: results.filter((r) => r.status === \"success\").length,\n          failed: results.filter((r) => r.status === \"error\").length,\n        })\n      );\n    } else if (allSucceeded) {\n      handleSuccess(`Pulled ${projectsToPull.length} project(s) successfully`);\n    } else {\n      console.error(ansis.red(`Pull failed for some projects`));\n    }\n\n    if (span) endSpan(span);\n    if (!allSucceeded) {\n      process.exit(1);\n    }\n  } catch (error) {\n    const useJson = options.format === \"json\" || isJson();\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 2,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(2);\n  }\n}\n\n/**\n * Sync farm projects with their models\n */\nexport async function farmSyncCommand(options: {\n  project?: string;\n  verbose?: boolean;\n  dryRun?: boolean;\n  force?: boolean;\n  output?: string;\n  format?: string;\n  autoCommit?: boolean;\n  concurrency?: string;\n}): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan(\"farm.sync\") : null;\n\n  try {\n    // Find farm root\n    const farmRoot = await findFarmRoot();\n    if (!farmRoot) {\n      throw new Error(\"Not in a farm directory. Run 'dr farm init' first.\");\n    }\n\n    const farmYamlPath = path.join(farmRoot, \"farm.yaml\");\n    const manifest = await FarmManifest.load(farmYamlPath);\n\n    // Determine which projects to sync\n    let projectsToSync = manifest.getAllProjects();\n    if (options.project) {\n      const project = manifest.getProject(options.project);\n      if (!project) {\n        throw new Error(`Project '${options.project}' not found in farm`);\n      }\n      projectsToSync = [project];\n    }\n\n    if (projectsToSync.length === 0) {\n      throw new Error(\"No projects found in farm\");\n    }\n\n    // Parse concurrency level\n    const concurrency = options.concurrency ? Math.max(1, parseInt(options.concurrency, 10)) : 1;\n    if (isNaN(concurrency)) {\n      throw new Error(\"Concurrency must be a positive number\");\n    }\n\n    // Reject incompatible option combination: --auto-commit with --concurrency > 1\n    if (options.autoCommit && concurrency > 1) {\n      throw new Error(\n        \"Cannot use --auto-commit with --concurrency > 1: concurrent git operations would cause race conditions. \" +\n        \"Use --concurrency 1 for auto-commit, or remove --auto-commit for parallel processing.\"\n      );\n    }\n\n    const useJson = options.format === \"json\" || isJson();\n    if (!useJson && !options.verbose) {\n      handleInfo(`Syncing ${projectsToSync.length} project(s) (concurrency: ${concurrency})...`);\n    }\n\n    const allResults: FarmSyncResultEntry[] = [];\n\n    // Process projects with concurrency control\n    const processSyncProject = async (project: typeof projectsToSync[0]) => {\n      try {\n        const modelPath = path.join(farmRoot, project.model);\n\n        if (!(await fileExists(modelPath))) {\n          throw new Error(`Model folder not found for project '${project.name}' at ${modelPath}`);\n        }\n\n        // Load model using detached model layout\n        let drModelPath = modelPath;\n        const manifestPath = path.join(modelPath, \"manifest.yaml\");\n        if (await fileExists(manifestPath)) {\n          drModelPath = manifestPath;\n        }\n\n        try {\n          const model = await Model.load(drModelPath);\n          const engine = new FarmSyncEngine(farmRoot, model);\n\n          const result = await engine.syncProject(project, {\n            verbose: options.verbose,\n            dryRun: options.dryRun,\n            force: options.force,\n          });\n\n          const resultEntry: FarmSyncResultEntry = {\n            project: project.name,\n            status: result.status === \"failed\" ? \"error\" : result.status,\n            change_count: result.changeCount,\n            changeset_id: result.changesetId,\n            files_changed: result.filesChanged,\n            ambiguities: result.ambiguities.length,\n            commits_before: result.commitsBefore,\n            commits_after: result.commitsAfter,\n          };\n\n          // Auto-commit if requested and changes were staged\n          if (options.autoCommit && result.changesetId && result.changeCount > 0 && !options.dryRun) {\n            try {\n              const projectModelPath = path.join(farmRoot, project.model);\n              const stagingManager = new (await import(\"../core/staging-area.js\")).StagingAreaManager(\n                projectModelPath,\n                model\n              );\n              const commitResult = await stagingManager.commit(model, result.changesetId);\n              resultEntry.auto_committed = true;\n              resultEntry.committed_changes = commitResult.committed;\n\n              // Commit changes to the farm-level git repository if git is available\n              // Scope git add to the project's model folder to avoid staging unrelated changes\n              // Check for git repo first\n              const gitRepoExists = isGitRepository(farmRoot);\n\n              // If git repo exists, proceed with commit (handle commit errors independently)\n              if (gitRepoExists) {\n                try {\n                  execFileSync(\"git\", [\"add\", project.model], { cwd: farmRoot, stdio: \"pipe\" });\n                  execFileSync(\n                    \"git\",\n                    [\"commit\", \"-m\", `Sync: ${result.changesetId} - ${commitResult.committed} change(s)`],\n                    { cwd: farmRoot, stdio: \"pipe\" }\n                  );\n                } catch (gitCommitError) {\n                  // If there's nothing to commit (no changes), that's fine\n                  if (!getErrorMessage(gitCommitError).includes(\"nothing to commit\")) {\n                    throw gitCommitError;\n                  }\n                }\n              }\n\n              if (options.verbose && !useJson) {\n                handleInfo(`  Auto-committed: ${commitResult.committed} change(s)`);\n              }\n            } catch (commitError) {\n              resultEntry.auto_committed = false;\n              resultEntry.commit_error = getErrorMessage(commitError);\n              resultEntry.status = \"error\";\n              if (!useJson) {\n                handleInfo(`  Auto-commit failed: ${getErrorMessage(commitError)}`);\n              }\n            }\n          }\n\n          allResults.push(resultEntry);\n\n          if (options.verbose && !useJson) {\n            handleInfo(`\\nProject: ${project.name}`);\n            const statusEmoji = result.status === \"success\" ? \"\u2713\" : result.status === \"partial\" ? \"\u26A0\" : \"\u2717\";\n            const statusText = result.status === \"success\" ? \"Success\" : result.status === \"partial\" ? \"Partial\" : \"Failed\";\n            handleInfo(`  Status: ${statusEmoji} ${statusText}`);\n            handleInfo(`  Commits: ${result.commitsBefore}...${result.commitsAfter}`);\n            handleInfo(\n              `  Files changed: +${result.filesChanged.added.length} ~${result.filesChanged.modified.length} -${result.filesChanged.deleted.length}`\n            );\n            handleInfo(`  Staged changes: ${result.changeCount}`);\n            if (result.changesetId) {\n              handleInfo(`  Changeset: ${result.changesetId}`);\n            }\n            if (result.ambiguities.length > 0) {\n              handleInfo(`  Ambiguities: ${result.ambiguities.length} (flagged for review)`);\n            }\n            for (const note of result.notes) {\n              console.log(`    ${note}`);\n            }\n          }\n        } catch (error) {\n          allResults.push({\n            project: project.name,\n            status: \"error\",\n            message: getErrorMessage(error),\n          });\n\n          if (!useJson) {\n            console.error(ansis.red(`\u2717 ${project.name}: ${getErrorMessage(error)}`));\n          }\n        }\n      } catch (error) {\n        allResults.push({\n          project: project.name,\n          status: \"error\",\n          message: getErrorMessage(error),\n        });\n\n        if (!useJson) {\n          console.error(ansis.red(`\u2717 ${project.name}: ${getErrorMessage(error)}`));\n        }\n      }\n    };\n\n    // Process with concurrency control\n    if (concurrency === 1) {\n      // Sequential processing\n      for (const project of projectsToSync) {\n        await processSyncProject(project);\n      }\n    } else {\n      // Parallel processing with limited concurrency\n      const queue = [...projectsToSync];\n      const active: Promise<void>[] = [];\n\n      while (queue.length > 0 || active.length > 0) {\n        while (active.length < concurrency && queue.length > 0) {\n          const project = queue.shift()!;\n          const promise = processSyncProject(project);\n          const wrapped = promise.then(() => {\n            const idx = active.indexOf(wrapped);\n            if (idx !== -1) {\n              active.splice(idx, 1);\n            }\n          });\n          active.push(wrapped);\n        }\n\n        if (active.length > 0) {\n          await Promise.race(active);\n        }\n      }\n    }\n\n    const allSucceeded = allResults.every((r) => r.status === \"success\" || r.status === \"partial\");\n\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: allSucceeded ? \"ok\" : \"error\",\n          code: allSucceeded ? 0 : 1,\n          projects: allResults,\n          synced: allResults.filter((r) => r.status === \"success\").length,\n          failed: allResults.filter((r) => r.status === \"error\").length,\n          auto_committed: options.autoCommit,\n        })\n      );\n    } else {\n      const synced = allResults.filter((r) => r.status === \"success\").length;\n      if (allSucceeded) {\n        handleSuccess(`Synced ${synced}/${projectsToSync.length} project(s)`);\n      }\n    }\n\n    // Write output file if requested\n    if (options.output) {\n      const { writeFile } = await import(\"../utils/file-io.js\");\n      const outputExt = path.extname(options.output).toLowerCase();\n\n      if (outputExt === \".json\") {\n        await writeFile(\n          options.output,\n          JSON.stringify(\n            {\n              timestamp: new Date().toISOString(),\n              farm_root: farmRoot,\n              projects: allResults,\n            },\n            null,\n            2\n          )\n        );\n      }\n    }\n\n    if (span) endSpan(span);\n    if (!allSucceeded) {\n      process.exit(1);\n    }\n  } catch (error) {\n    const useJson = options.format === \"json\" || isJson();\n    if (useJson) {\n      console.log(\n        JSON.stringify({\n          status: \"error\",\n          code: 2,\n          message: getErrorMessage(error),\n        })\n      );\n    } else {\n      console.error(ansis.red(`Error: ${getErrorMessage(error)}`));\n    }\n    if (span) endSpan(span);\n    process.exit(2);\n  }\n}\n\n/**\n * Register farm commands with the CLI\n */\nexport function farmCommands(program: Command): void {\n  const farmGroup = program.command(\"farm\").description(\"Manage model farms\");\n\n  farmGroup\n    .command(\"init\")\n    .description(\"Initialize a new farm\")\n    .option(\"--name <name>\", \"Farm name\")\n    .option(\"--platform-view\", \"Enable platform-view support for cross-model aggregation\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm init\n  $ dr farm init --name \"My Architecture Farm\"\n  $ dr farm init --platform-view\n  $ dr farm init --format json\n\nNotes:\n  When using --platform-view, create a project named exactly \"platform-view\" to serve as\n  the aggregation hub. When validating this project with 'dr farm validate --project platform-view',\n  the CLI will automatically resolve cross-model references from all farm projects.`\n    )\n    .action(async (options) => {\n      await farmInitCommand(options);\n    });\n\n  farmGroup\n    .command(\"add <name>\")\n    .description(\"Add a project to the farm\")\n    .option(\"--remote <url>\", \"Git remote URL to clone\")\n    .option(\"--codebase <path>\", \"Path to codebase folder (defaults to project name)\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm add my-service\n  $ dr farm add my-service --remote https://github.com/org/my-service.git\n  $ dr farm add my-service --codebase ./services/my-service\n  $ dr farm add my-service --format json`\n    )\n    .action(async (name, options) => {\n      await farmAddCommand(name, options);\n    });\n\n  farmGroup\n    .command(\"remove <name>\")\n    .description(\"Remove a project from the farm\")\n    .option(\"--delete-model\", \"Also delete the model folder\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm remove my-service\n  $ dr farm remove my-service --delete-model\n  $ dr farm remove my-service --format json`\n    )\n    .action(async (name, options) => {\n      await farmRemoveCommand(name, options);\n    });\n\n  farmGroup\n    .command(\"status\")\n    .description(\"Show farm status and registered projects\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm status\n  $ dr farm status --format json`\n    )\n    .action(async (options) => {\n      await farmStatusCommand(options);\n    });\n\n  farmGroup\n    .command(\"validate\")\n    .description(\"Validate farm projects using composed scope (cross-model references)\")\n    .option(\"--project <name>\", \"Validate only a specific project (default: all)\")\n    .option(\"--verbose\", \"Show verbose validation output\")\n    .option(\"--quiet\", \"Suppress success messages\")\n    .option(\"--output <path>\", \"Export validation report to file (JSON/Markdown)\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm validate\n  $ dr farm validate --project my-service\n  $ dr farm validate --verbose\n  $ dr farm validate --format json\n  $ dr farm validate --output report.json\n\nNotes:\n  For platform-view aggregation: Use 'dr farm validate --project platform-view' to validate\n  a platform-view project. The project name must be exactly 'platform-view' and the farm\n  must have platform-view enabled (set during 'dr farm init --platform-view').`\n    )\n    .action(async (options) => {\n      await farmValidateCommand(options);\n    });\n\n  farmGroup\n    .command(\"pull\")\n    .description(\"Pull latest changes from remote for farm projects\")\n    .option(\"--project <name>\", \"Pull only a specific project (default: all)\")\n    .option(\"--verbose\", \"Show verbose output\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm pull\n  $ dr farm pull --project my-service\n  $ dr farm pull --verbose\n  $ dr farm pull --format json`\n    )\n    .action(async (options) => {\n      await farmPullCommand(options);\n    });\n\n  farmGroup\n    .command(\"sync\")\n    .description(\"Sync farm projects with their models (generates staged changesets)\")\n    .option(\"--project <name>\", \"Sync only a specific project (default: all)\")\n    .option(\"--verbose\", \"Show verbose output\")\n    .option(\"--dry-run\", \"Preview without creating changesets\")\n    .option(\"--force\", \"Proceed despite ambiguous file-to-element mappings\")\n    .option(\"--output <path>\", \"Export sync report to file (JSON)\")\n    .option(\"--format <format>\", \"Output format: text, json\", \"text\")\n    .option(\"--auto-commit\", \"Automatically commit changes (bypasses staged review)\")\n    .option(\"--concurrency <n>\", \"Process multiple projects in parallel (default: 1)\", \"1\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr farm sync\n  $ dr farm sync --project my-service\n  $ dr farm sync --verbose --output sync-report.json\n  $ dr farm sync --dry-run\n  $ dr farm sync --format json --auto-commit\n  $ dr farm sync --concurrency 4\n\nAutomation (cron/CI):\n  $ dr farm sync --format json --auto-commit --output sync-report.json\n  $ dr farm sync --format json --concurrency 4 --output sync-report.json\n\nNote: --auto-commit and --concurrency > 1 cannot be used together (race condition risk).\nUse --concurrency 1 (default) with --auto-commit for automated syncs.`\n    )\n    .action(async (options) => {\n      await farmSyncCommand(options);\n    });\n\n  farmGroup.showSuggestionAfterError();\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/commands/init.js

@@ -7,6 +7,7 @@ import { installSpecReference } from "../utils/spec-installer.js";
 import { getCliBundledSpecVersion } from "../utils/spec-version.js";
 import { isTelemetryEnabled, startSpan, endSpan } from "../telemetry/index.js";
 import { getErrorMessage } from "../utils/errors.js";
+import { regenerateLayerReports } from "./reports.js";
 async function initCommand(options) {
   intro(ansis.bold(ansis.blue("\u2699\uFE0F  Initialize Documentation Robotics Model")));
   const span = isTelemetryEnabled ? startSpan("model.init", {
@@ -43,7 +44,16 @@ async function initCommand(options) {
     logVerbose(`Model saved with:
   - Version: 0.1.0
   - Spec Version: ${getCliBundledSpecVersion()}
-  - Location: ${rootPath}/documentation-robotics/model`), logDebug("Installing spec reference (.dr/ folder)..."), await installSpecReference(rootPath, !1), logVerbose("Spec reference installed"), isTelemetryEnabled && span && (span.setAttribute("model.path", rootPath), span.setStatus({ code: 0 })), outro(ansis.green(`\u2713 Model initialized: ${ansis.bold(model.manifest.name)}`));
+  - Location: ${rootPath}/documentation-robotics/model`), logDebug("Installing spec reference (.dr/ folder)..."), await installSpecReference(rootPath, !1), logVerbose("Spec reference installed"), logDebug("Generating reports and README...");
+    try {
+      await regenerateLayerReports(rootPath), logVerbose("Reports and README generated");
+    } catch (reportError) {
+      const reportMessage = getErrorMessage(reportError);
+      console.warn(ansis.yellow(`\u26A0 Warning: Failed to generate reports and README: ${reportMessage}
+  Model initialized successfully. To regenerate reports later, run:
+  dr reports regenerate`)), logDebug(`Report generation failed (non-fatal): ${reportMessage}`);
+    }
+    isTelemetryEnabled && span && (span.setAttribute("model.path", rootPath), span.setStatus({ code: 0 })), outro(ansis.green(`\u2713 Model initialized: ${ansis.bold(model.manifest.name)}`));
   } catch (error) {
     isTelemetryEnabled && span && (span.recordException(error), span.setStatus({
       code: 2,

package/dist/commands/init.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/init.ts"],
-  "sourcesContent": ["/**\n * Initialize a new Documentation Robotics model\n */\n\nimport { intro, text, outro } from \"@clack/prompts\";\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { fileExists } from \"../utils/file-io.js\";\nimport { logVerbose, logDebug } from \"../utils/globals.js\";\nimport { installSpecReference } from \"../utils/spec-installer.js\";\nimport { getCliBundledSpecVersion } from \"../utils/spec-version.js\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\nexport interface InitOptions {\n  name?: string;\n  author?: string;\n  description?: string;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function initCommand(options: InitOptions): Promise<void> {\n  intro(ansis.bold(ansis.blue(\"\u2699\uFE0F  Initialize Documentation Robotics Model\")));\n\n  const span = isTelemetryEnabled\n    ? startSpan(\"model.init\", {\n        \"init.hasName\": !!options.name,\n        \"init.hasDescription\": !!options.description,\n        \"init.hasAuthor\": !!options.author,\n      })\n    : null;\n\n  try {\n    const rootPath = process.cwd();\n    const modelPath = `${rootPath}/documentation-robotics/model`;\n    const manifestPath = `${modelPath}/manifest.yaml`;\n\n    // Check if model already exists\n    if (await fileExists(manifestPath)) {\n      console.error(ansis.red(\"Error: Model already initialized in this directory\"));\n      if (isTelemetryEnabled && span) {\n        (span as any).setStatus({ code: 2, message: \"Model already exists\" });\n      }\n      endSpan(span);\n      process.exit(1);\n    }\n\n    // Gather model metadata\n    // Check if stdin is a TTY to determine if we should prompt\n    const isInteractive = process.stdin.isTTY;\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"cli.interactive\", isInteractive);\n    }\n\n    // If name is provided, skip all prompts\n    const skipPrompts = !!options.name;\n\n    const name =\n      options.name ||\n      (isInteractive\n        ? await text({\n            message: \"Model name:\",\n            validate: (value) => (value.length === 0 ? \"Name is required\" : undefined),\n          })\n        : (() => {\n            console.error(ansis.red(\"Error: Model name is required (use --name option)\"));\n            if (isTelemetryEnabled && span) {\n              (span as any).setStatus({ code: 2, message: \"Model name required\" });\n            }\n            endSpan(span);\n            process.exit(1);\n          })());\n\n    const description =\n      options.description ||\n      (skipPrompts\n        ? \"\"\n        : isInteractive\n          ? await text({\n              message: \"Description (optional):\",\n              defaultValue: \"\",\n            })\n          : \"\");\n\n    const author =\n      options.author ||\n      (skipPrompts\n        ? \"\"\n        : isInteractive\n          ? await text({\n              message: \"Author (optional):\",\n              defaultValue: \"\",\n            })\n          : \"\");\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"model.name\", name as string);\n      (span as any).setAttribute(\"model.specVersion\", getCliBundledSpecVersion());\n    }\n\n    // Initialize model\n    logDebug(`Creating model directory at ${rootPath}/documentation-robotics/model`);\n    const model = await Model.init(\n      rootPath,\n      {\n        name: name as string,\n        version: \"0.1.0\",\n        description: (description as string) || undefined,\n        author: (author as string) || undefined,\n        specVersion: getCliBundledSpecVersion(),\n        created: new Date().toISOString(),\n      },\n      { lazyLoad: false }\n    );\n\n    logVerbose(`Model saved with:\n  - Version: 0.1.0\n  - Spec Version: ${getCliBundledSpecVersion()}\n  - Location: ${rootPath}/documentation-robotics/model`);\n\n    // Install spec reference (.dr/ folder)\n    logDebug(\"Installing spec reference (.dr/ folder)...\");\n    await installSpecReference(rootPath, false);\n    logVerbose(\"Spec reference installed\");\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"model.path\", rootPath);\n      (span as any).setStatus({ code: 0 });\n    }\n\n    outro(ansis.green(`\u2713 Model initialized: ${ansis.bold(model.manifest.name)}`));\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({\n        code: 2,\n        message: getErrorMessage(error),\n      });\n    }\n    const message = getErrorMessage(error);\n    console.error(ansis.red(`Error: ${message}`));\n    endSpan(span);\n    process.exit(1);\n  } finally {\n    endSpan(span);\n  }\n}\n"],
-  "mappings": "AAIA,SAAS,OAAO,MAAM,aAAa;AACnC,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,SAAS,YAAY,gBAAgB;AACrC,SAAS,4BAA4B;AACrC,SAAS,gCAAgC;AACzC,SAAS,oBAAoB,WAAW,eAAe;AACvD,SAAS,uBAAuB;AAUhC,eAAsB,YAAY,SAAoB;AACpD,QAAM,MAAM,KAAK,MAAM,KAAK,uDAA6C,CAAC,CAAC;AAE3E,QAAM,OAAO,qBACT,UAAU,cAAc;IACtB,gBAAgB,CAAC,CAAC,QAAQ;IAC1B,uBAAuB,CAAC,CAAC,QAAQ;IACjC,kBAAkB,CAAC,CAAC,QAAQ;GAC7B,IACD;AAEJ,MAAI;AACF,UAAM,WAAW,QAAQ,IAAG,GAEtB,eAAe,GADH,GAAG,QAAQ,+BACI;AAGjC,IAAI,MAAM,WAAW,YAAY,MAC/B,QAAQ,MAAM,MAAM,IAAI,oDAAoD,CAAC,GACzE,sBAAsB,QACvB,KAAa,UAAU,EAAE,MAAM,GAAG,SAAS,uBAAsB,CAAE,GAEtE,QAAQ,IAAI,GACZ,QAAQ,KAAK,CAAC;AAKhB,UAAM,gBAAgB,QAAQ,MAAM;AAEpC,IAAI,sBAAsB,QACvB,KAAa,aAAa,mBAAmB,aAAa;AAI7D,UAAM,cAAc,CAAC,CAAC,QAAQ,MAExB,OACJ,QAAQ,SACP,gBACG,MAAM,KAAK;MACT,SAAS;MACT,UAAU,CAAC,UAAW,MAAM,WAAW,IAAI,qBAAqB;KACjE,KACA,MAAK;AACJ,cAAQ,MAAM,MAAM,IAAI,mDAAmD,CAAC,GACxE,sBAAsB,QACvB,KAAa,UAAU,EAAE,MAAM,GAAG,SAAS,sBAAqB,CAAE,GAErE,QAAQ,IAAI,GACZ,QAAQ,KAAK,CAAC;IAChB,GAAE,IAEF,cACJ,QAAQ,gBACP,cACG,KACA,gBACE,MAAM,KAAK;MACT,SAAS;MACT,cAAc;KACf,IACD,KAEF,SACJ,QAAQ,WACP,cACG,KACA,gBACE,MAAM,KAAK;MACT,SAAS;MACT,cAAc;KACf,IACD;AAER,IAAI,sBAAsB,SACvB,KAAa,aAAa,cAAc,IAAc,GACtD,KAAa,aAAa,qBAAqB,yBAAwB,CAAE,IAI5E,SAAS,+BAA+B,QAAQ,+BAA+B;AAC/E,UAAM,QAAQ,MAAM,MAAM,KACxB,UACA;MACE;MACA,SAAS;MACT,aAAc,eAA0B;MACxC,QAAS,UAAqB;MAC9B,aAAa,yBAAwB;MACrC,UAAS,oBAAI,KAAI,GAAG,YAAW;OAEjC,EAAE,UAAU,GAAK,CAAE;AAGrB,eAAW;;oBAEK,yBAAwB,CAAE;gBAC9B,QAAQ,+BAA+B,GAGnD,SAAS,4CAA4C,GACrD,MAAM,qBAAqB,UAAU,EAAK,GAC1C,WAAW,0BAA0B,GAEjC,sBAAsB,SACvB,KAAa,aAAa,cAAc,QAAQ,GAChD,KAAa,UAAU,EAAE,MAAM,EAAC,CAAE,IAGrC,MAAM,MAAM,MAAM,6BAAwB,MAAM,KAAK,MAAM,SAAS,IAAI,CAAC,EAAE,CAAC;EAC9E,SAAS,OAAO;AACd,IAAI,sBAAsB,SACvB,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU;MACtB,MAAM;MACN,SAAS,gBAAgB,KAAK;KAC/B;AAEH,UAAM,UAAU,gBAAgB,KAAK;AACrC,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,IAAI,GACZ,QAAQ,KAAK,CAAC;EAChB;AACE,YAAQ,IAAI;EACd;AACF;",
+  "sourcesContent": ["/**\n * Initialize a new Documentation Robotics model\n */\n\nimport { intro, text, outro } from \"@clack/prompts\";\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { fileExists } from \"../utils/file-io.js\";\nimport { logVerbose, logDebug } from \"../utils/globals.js\";\nimport { installSpecReference } from \"../utils/spec-installer.js\";\nimport { getCliBundledSpecVersion } from \"../utils/spec-version.js\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { regenerateLayerReports } from \"./reports.js\";\n\nexport interface InitOptions {\n  name?: string;\n  author?: string;\n  description?: string;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function initCommand(options: InitOptions): Promise<void> {\n  intro(ansis.bold(ansis.blue(\"\u2699\uFE0F  Initialize Documentation Robotics Model\")));\n\n  const span = isTelemetryEnabled\n    ? startSpan(\"model.init\", {\n        \"init.hasName\": !!options.name,\n        \"init.hasDescription\": !!options.description,\n        \"init.hasAuthor\": !!options.author,\n      })\n    : null;\n\n  try {\n    const rootPath = process.cwd();\n    const modelPath = `${rootPath}/documentation-robotics/model`;\n    const manifestPath = `${modelPath}/manifest.yaml`;\n\n    // Check if model already exists\n    if (await fileExists(manifestPath)) {\n      console.error(ansis.red(\"Error: Model already initialized in this directory\"));\n      if (isTelemetryEnabled && span) {\n        (span as any).setStatus({ code: 2, message: \"Model already exists\" });\n      }\n      endSpan(span);\n      process.exit(1);\n    }\n\n    // Gather model metadata\n    // Check if stdin is a TTY to determine if we should prompt\n    const isInteractive = process.stdin.isTTY;\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"cli.interactive\", isInteractive);\n    }\n\n    // If name is provided, skip all prompts\n    const skipPrompts = !!options.name;\n\n    const name =\n      options.name ||\n      (isInteractive\n        ? await text({\n            message: \"Model name:\",\n            validate: (value) => (value.length === 0 ? \"Name is required\" : undefined),\n          })\n        : (() => {\n            console.error(ansis.red(\"Error: Model name is required (use --name option)\"));\n            if (isTelemetryEnabled && span) {\n              (span as any).setStatus({ code: 2, message: \"Model name required\" });\n            }\n            endSpan(span);\n            process.exit(1);\n          })());\n\n    const description =\n      options.description ||\n      (skipPrompts\n        ? \"\"\n        : isInteractive\n          ? await text({\n              message: \"Description (optional):\",\n              defaultValue: \"\",\n            })\n          : \"\");\n\n    const author =\n      options.author ||\n      (skipPrompts\n        ? \"\"\n        : isInteractive\n          ? await text({\n              message: \"Author (optional):\",\n              defaultValue: \"\",\n            })\n          : \"\");\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"model.name\", name as string);\n      (span as any).setAttribute(\"model.specVersion\", getCliBundledSpecVersion());\n    }\n\n    // Initialize model\n    logDebug(`Creating model directory at ${rootPath}/documentation-robotics/model`);\n    const model = await Model.init(\n      rootPath,\n      {\n        name: name as string,\n        version: \"0.1.0\",\n        description: (description as string) || undefined,\n        author: (author as string) || undefined,\n        specVersion: getCliBundledSpecVersion(),\n        created: new Date().toISOString(),\n      },\n      { lazyLoad: false }\n    );\n\n    logVerbose(`Model saved with:\n  - Version: 0.1.0\n  - Spec Version: ${getCliBundledSpecVersion()}\n  - Location: ${rootPath}/documentation-robotics/model`);\n\n    // Install spec reference (.dr/ folder)\n    logDebug(\"Installing spec reference (.dr/ folder)...\");\n    await installSpecReference(rootPath, false);\n    logVerbose(\"Spec reference installed\");\n\n    // Generate README and layer reports\n    logDebug(\"Generating reports and README...\");\n    try {\n      await regenerateLayerReports(rootPath);\n      logVerbose(\"Reports and README generated\");\n    } catch (reportError) {\n      const reportMessage = getErrorMessage(reportError);\n      console.warn(\n        ansis.yellow(\n          `\u26A0 Warning: Failed to generate reports and README: ${reportMessage}\\n` +\n          `  Model initialized successfully. To regenerate reports later, run:\\n` +\n          `  dr reports regenerate`\n        )\n      );\n      logDebug(`Report generation failed (non-fatal): ${reportMessage}`);\n    }\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"model.path\", rootPath);\n      (span as any).setStatus({ code: 0 });\n    }\n\n    outro(ansis.green(`\u2713 Model initialized: ${ansis.bold(model.manifest.name)}`));\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({\n        code: 2,\n        message: getErrorMessage(error),\n      });\n    }\n    const message = getErrorMessage(error);\n    console.error(ansis.red(`Error: ${message}`));\n    endSpan(span);\n    process.exit(1);\n  } finally {\n    endSpan(span);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/commands/mcp.js

@@ -0,0 +1,107 @@
+import { isCancel, text } from "@clack/prompts";
+import { ApiKeyManager } from "../mcp/api-key-manager.js";
+import { McpResourceRegistry } from "../mcp/resource-registry.js";
+import { McpToolRegistry } from "../mcp/tool-registry.js";
+import { loadModel } from "../mcp/tools/shared.js";
+import { startActiveSpan } from "../telemetry/index.js";
+import { CLIError, getErrorMessage } from "../utils/errors.js";
+import { getCliVersion } from "../utils/spec-version.js";
+const cliVersion = getCliVersion(), promptForKeyPath = async (defaultPath) => {
+  const result = await text({
+    message: "Where should the MCP API key be stored?",
+    placeholder: defaultPath,
+    defaultValue: defaultPath
+  });
+  return isCancel(result) || typeof result != "string" || result.trim().length === 0 ? defaultPath : result.trim();
+};
+async function createConfiguredServer() {
+  const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js"), server = new McpServer({
+    name: "documentation-robotics",
+    version: cliVersion
+  });
+  new McpToolRegistry().registerAll(server), await new McpResourceRegistry().registerAll(server);
+  try {
+    await loadModel();
+  } catch (error) {
+    process.stderr.write(`[mcp] model warmup skipped: ${getErrorMessage(error)}
+`);
+  }
+  return server;
+}
+async function mcpCommand(options = {}) {
+  const keyManager = new ApiKeyManager();
+  try {
+    if (options.regenerateKey) {
+      await startActiveSpan("mcp.key.rotate", async (span) => {
+        const isInteractive2 = process.stdin.isTTY === !0, { key: key2, path: path2 } = await keyManager.rotate(isInteractive2 ? promptForKeyPath : void 0);
+        span.setAttribute("mcp.key.path", path2), process.stderr.write(`Generated new MCP API key, stored at ${path2}
+`), process.stderr.write(`MCP API key: ${key2}
+`);
+      });
+      return;
+    }
+    const isInteractive = process.stdin.isTTY === !0, { key, path, isNew } = await keyManager.ensureKey(isInteractive ? promptForKeyPath : void 0);
+    if (isNew && process.stderr.write(`Generated new MCP API key, stored at ${path}
+`), process.stderr.write(`MCP API key: ${key}
+`), options.transport === "http") {
+      const { createMcpHttpApp, startHttpServer, closeHttpServer } = await import("../mcp/http-transport.js"), host = options.host || "127.0.0.1", port = options.port || 3100;
+      let httpApp;
+      const httpServer = await startActiveSpan("mcp.server.start", async (span) => {
+        httpApp = await createMcpHttpApp(keyManager, key, createConfiguredServer, host);
+        const server = await startHttpServer(httpApp, host, port);
+        return span.setAttribute("mcp.server.name", "documentation-robotics"), span.setAttribute("mcp.server.version", cliVersion), span.setAttribute("mcp.server.transport", "http"), span.setAttribute("mcp.server.host", host), span.setAttribute("mcp.server.port", port), server;
+      });
+      host === "0.0.0.0" && process.stderr.write(`Warning: Server bound to 0.0.0.0. DNS rebinding protection is not automatic; ensure your MCP client validates the Host header.
+`), process.stderr.write(`Documentation Robotics MCP server ready (http://${host}:${port}/mcp)
+`);
+      let resolveKeepAlive;
+      const keepAlive = new Promise((resolve) => {
+        resolveKeepAlive = resolve;
+      });
+      let isShuttingDown = !1;
+      const shutdown = async () => {
+        if (!isShuttingDown) {
+          isShuttingDown = !0;
+          try {
+            process.stderr.write(`
+Shutting down HTTP server...
+`), await closeHttpServer(httpServer, httpApp);
+          } catch (error) {
+            const errorMsg = error instanceof Error ? error.message : "unknown error";
+            process.stderr.write(`[mcp] Error closing server: ${errorMsg}
+`);
+          } finally {
+            resolveKeepAlive();
+          }
+        }
+      };
+      process.on("SIGINT", shutdown), process.on("SIGTERM", shutdown), await keepAlive;
+    } else {
+      if (!keyManager.validate(process.env.DR_MCP_API_KEY, key))
+        throw process.stderr.write(`Error: DR_MCP_API_KEY environment variable is missing or does not match the stored API key.
+`), process.stderr.write(`Set DR_MCP_API_KEY to the key above when configuring the MCP client, e.g.:
+`), process.stderr.write(`  { "command": "dr", "args": ["mcp"], "env": { "DR_MCP_API_KEY": "<key>" } }
+`), new CLIError("MCP authentication failed: invalid or missing DR_MCP_API_KEY", 1);
+      const transport = await startActiveSpan("mcp.server.start", async (span) => {
+        const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js"), server = await createConfiguredServer();
+        span.setAttribute("mcp.server.name", "documentation-robotics"), span.setAttribute("mcp.server.version", cliVersion), span.setAttribute("mcp.server.transport", "stdio");
+        const serverTransport = new StdioServerTransport();
+        return await server.connect(serverTransport), serverTransport;
+      });
+      process.stderr.write(`Documentation Robotics MCP server ready (stdio)
+`), await new Promise((resolve) => {
+        transport.onclose = () => resolve();
+      });
+    }
+  } catch (error) {
+    if (error instanceof CLIError)
+      throw error;
+    let message = getErrorMessage(error);
+    throw error instanceof Error && error.code === "EADDRINUSE" && (message = `Port ${options.port || 3100} is already in use. Try a different port with --port or kill the process using that port.`), process.stderr.write(`Error: ${message}
+`), new CLIError(message, 1);
+  }
+}
+export {
+  mcpCommand
+};
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/mcp.ts"],
+  "sourcesContent": ["/**\n * MCP server command - Starts an MCP server for AI assistant integration\n *\n * Supports two transport modes:\n * - stdio (default): In-process over stdio; stdout carries the MCP JSON-RPC protocol\n * - http: HTTP server with Express, exposing MCP at /mcp endpoint with bearer token auth\n *\n * All non-protocol output goes to stderr.\n */\n\nimport { isCancel, text } from \"@clack/prompts\";\nimport { ApiKeyManager, type ApiKeyStoragePrompt } from \"../mcp/api-key-manager.js\";\nimport { type HttpTransportApp } from \"../mcp/http-transport.js\";\nimport { McpResourceRegistry } from \"../mcp/resource-registry.js\";\nimport { McpToolRegistry } from \"../mcp/tool-registry.js\";\nimport { loadModel } from \"../mcp/tools/shared.js\";\nimport { startActiveSpan } from \"../telemetry/index.js\";\nimport { CLIError, getErrorMessage } from \"../utils/errors.js\";\nimport { getCliVersion } from \"../utils/spec-version.js\";\n\nconst cliVersion = getCliVersion();\n\n/**\n * Prompt the user (via stdout/stdin) for where to store a newly generated API key.\n * Only invoked when stdin is a TTY \u2014 non-interactive launches (e.g. an MCP client\n * spawning `dr mcp`) fall back to the default path without prompting.\n */\nconst promptForKeyPath: ApiKeyStoragePrompt = async (defaultPath) => {\n  const result = await text({\n    message: \"Where should the MCP API key be stored?\",\n    placeholder: defaultPath,\n    defaultValue: defaultPath,\n  });\n\n  if (isCancel(result) || typeof result !== \"string\" || result.trim().length === 0) {\n    return defaultPath;\n  }\n  return result.trim();\n};\n\nasync function createConfiguredServer() {\n  const { McpServer } = await import(\"@modelcontextprotocol/sdk/server/mcp.js\");\n\n  const server = new McpServer({\n    name: \"documentation-robotics\",\n    version: cliVersion,\n  });\n\n  // Register the model tool surface and spec/model manifest resources.\n  new McpToolRegistry().registerAll(server);\n  await new McpResourceRegistry().registerAll(server);\n\n  // Warm the model cache at startup so it's loaded once and held in memory\n  // for the session, rather than waiting for the first tool call. Best-effort:\n  // a server started outside a DR project still starts up cleanly \u2014 the first\n  // tool call that supplies a valid rootPath will load and cache it.\n  try {\n    await loadModel();\n  } catch (error) {\n    process.stderr.write(`[mcp] model warmup skipped: ${getErrorMessage(error)}\\n`);\n  }\n\n  return server;\n}\n\nexport interface McpCommandOptions {\n  /** Force-generate a new API key, overwrite it at the configured storage path, and exit. */\n  regenerateKey?: boolean;\n  /** Transport type: \"stdio\" or \"http\" (default: \"stdio\") */\n  transport?: \"stdio\" | \"http\";\n  /** Port for HTTP transport (default: 3100, only meaningful with --transport http) */\n  port?: number;\n  /** Host address for HTTP transport (default: \"127.0.0.1\", only meaningful with --transport http) */\n  host?: string;\n}\n\nexport async function mcpCommand(options: McpCommandOptions = {}): Promise<void> {\n  const keyManager = new ApiKeyManager();\n\n  try {\n    if (options.regenerateKey) {\n      await startActiveSpan(\"mcp.key.rotate\", async (span) => {\n        const isInteractive = process.stdin.isTTY === true;\n        const { key, path } = await keyManager.rotate(\n          isInteractive ? promptForKeyPath : undefined\n        );\n        span.setAttribute(\"mcp.key.path\", path);\n        process.stderr.write(`Generated new MCP API key, stored at ${path}\\n`);\n        process.stderr.write(`MCP API key: ${key}\\n`);\n      });\n      return;\n    }\n\n    const isInteractive = process.stdin.isTTY === true;\n    const { key, path, isNew } = await keyManager.ensureKey(\n      isInteractive ? promptForKeyPath : undefined\n    );\n\n    if (isNew) {\n      process.stderr.write(`Generated new MCP API key, stored at ${path}\\n`);\n    }\n    // Required every launch: print the API key to stderr (never stdout, which\n    // carries the MCP protocol).\n    process.stderr.write(`MCP API key: ${key}\\n`);\n\n    if (options.transport === \"http\") {\n      // HTTP transport implementation\n      const { createMcpHttpApp, startHttpServer, closeHttpServer } = await import(\n        \"../mcp/http-transport.js\"\n      );\n\n      const host = options.host || \"127.0.0.1\";\n      const port = options.port || 3100;\n\n      let httpApp: HttpTransportApp;\n      const httpServer = await startActiveSpan(\n        \"mcp.server.start\",\n        async (span) => {\n          httpApp = await createMcpHttpApp(keyManager, key, createConfiguredServer, host);\n          const server = await startHttpServer(httpApp, host, port);\n\n          span.setAttribute(\"mcp.server.name\", \"documentation-robotics\");\n          span.setAttribute(\"mcp.server.version\", cliVersion);\n          span.setAttribute(\"mcp.server.transport\", \"http\");\n          span.setAttribute(\"mcp.server.host\", host);\n          span.setAttribute(\"mcp.server.port\", port);\n\n          return server;\n        }\n      );\n\n      // Warn if bound to 0.0.0.0\n      if (host === \"0.0.0.0\") {\n        process.stderr.write(\n          \"Warning: Server bound to 0.0.0.0. DNS rebinding protection is not automatic; ensure your MCP client validates the Host header.\\n\"\n        );\n      }\n\n      process.stderr.write(`Documentation Robotics MCP server ready (http://${host}:${port}/mcp)\\n`);\n\n      // Set up graceful shutdown on SIGINT/SIGTERM\n      let resolveKeepAlive: () => void;\n      const keepAlive = new Promise<void>((resolve) => {\n        resolveKeepAlive = resolve;\n      });\n\n      let isShuttingDown = false;\n      const shutdown = async () => {\n        if (isShuttingDown) {\n          return;\n        }\n        isShuttingDown = true;\n\n        try {\n          process.stderr.write(\"\\nShutting down HTTP server...\\n\");\n          await closeHttpServer(httpServer, httpApp);\n        } catch (error) {\n          const errorMsg = error instanceof Error ? error.message : \"unknown error\";\n          process.stderr.write(`[mcp] Error closing server: ${errorMsg}\\n`);\n        } finally {\n          resolveKeepAlive!();\n        }\n      };\n\n      process.on(\"SIGINT\", shutdown);\n      process.on(\"SIGTERM\", shutdown);\n\n      // Keep the process alive until explicitly terminated\n      await keepAlive;\n    } else {\n      // Stdio transport (default)\n      // Validate that the environment has the correct API key configured\n      if (!keyManager.validate(process.env.DR_MCP_API_KEY, key)) {\n        process.stderr.write(\n          \"Error: DR_MCP_API_KEY environment variable is missing or does not match the stored API key.\\n\"\n        );\n        process.stderr.write(\n          \"Set DR_MCP_API_KEY to the key above when configuring the MCP client, e.g.:\\n\"\n        );\n        process.stderr.write(\n          '  { \"command\": \"dr\", \"args\": [\"mcp\"], \"env\": { \"DR_MCP_API_KEY\": \"<key>\" } }\\n'\n        );\n        throw new CLIError(\"MCP authentication failed: invalid or missing DR_MCP_API_KEY\", 1);\n      }\n\n      const transport = await startActiveSpan(\n        \"mcp.server.start\",\n        async (span) => {\n          const { StdioServerTransport } = await import(\"@modelcontextprotocol/sdk/server/stdio.js\");\n\n          const server = await createConfiguredServer();\n\n          span.setAttribute(\"mcp.server.name\", \"documentation-robotics\");\n          span.setAttribute(\"mcp.server.version\", cliVersion);\n          span.setAttribute(\"mcp.server.transport\", \"stdio\");\n\n          const serverTransport = new StdioServerTransport();\n          await server.connect(serverTransport);\n          return serverTransport;\n        }\n      );\n\n      process.stderr.write(\"Documentation Robotics MCP server ready (stdio)\\n\");\n\n      // Keep the process alive for the lifetime of the stdio session; the\n      // transport closes (and the process exits) when stdin closes. Shutdown\n      // is implicit in the `mcp.server.start` span's end, so no separate\n      // zero-duration \"stop\" span is recorded here.\n      await new Promise<void>((resolve) => {\n        transport.onclose = () => resolve();\n      });\n    }\n  } catch (error) {\n    if (error instanceof CLIError) {\n      throw error;\n    }\n\n    let message = getErrorMessage(error);\n\n    // Handle port-in-use errors with actionable message\n    if (error instanceof Error && (error as NodeJS.ErrnoException).code === \"EADDRINUSE\") {\n      const port = options.port || 3100;\n      message = `Port ${port} is already in use. Try a different port with --port or kill the process using that port.`;\n    }\n\n    process.stderr.write(`Error: ${message}\\n`);\n    throw new CLIError(message, 1);\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["isInteractive", "key", "path"]
+}

package/dist/commands/relationship.js

@@ -3,7 +3,7 @@ import { Model } from "../core/model.js";
 import { StagingAreaManager } from "../core/staging-area.js";
 import { findElementLayer } from "../utils/element-utils.js";
 import { isValidLayerName } from "../core/layers.js";
-import { CLIError, ErrorCategory, handleError, getErrorMessage } from "../utils/errors.js";
+import { CLIError, ErrorCategory, handleError, handleSuccess, handleInfo, getErrorMessage } from "../utils/errors.js";
 import { getValidRelationships, getValidPredicatesForSource, getValidDestinationsForSourceAndPredicate } from "../generated/relationship-index.js";
 import { normalizeNodeType } from "../generated/node-types.js";
 import { ModelReportOrchestrator } from "../reports/model-report-orchestrator.js";
@@ -69,7 +69,7 @@ async function addRelationshipHandler(model, source, target, predicate, properti
       throw new CLIError(`Invalid relationship: predicate "${predicate}" does not allow reflexive relationships (${source})`, ErrorCategory.USER);
   }
   if (model.relationships.find(source, target, predicate).length > 0)
-    return console.warn(ansis.yellow(`Warning: Relationship ${source} --[${predicate}]--> ${target} already exists. Skipping.`)), !1;
+    return !1;
   const stagingManager = new StagingAreaManager(model.rootPath, model), activeChangesetId = await stagingManager.getActiveId(), relData = {
     source,
     target,
@@ -161,15 +161,15 @@ async function deleteRelationshipHandler(model, source, target, predicate, preRe
   }
   return { deletedCount: resolvedToDelete.length };
 }
-function relationshipCommands(program) {
-  program.command("add <source> <target>").description("Add a relationship between elements (intra-layer or cross-layer)").requiredOption("--predicate <predicate>", "Relationship predicate (e.g., depends-on, realizes, exposes)").option("--properties <json>", "Relationship properties (JSON)").addHelpText("after", `
+function relationshipCommands(program, rootProgram) {
+  program.command("add <source> <target>").description("Add a relationship between elements (intra-layer or cross-layer)").option("--model <path>", "Path to model root (contains model/manifest.yaml)").requiredOption("--predicate <predicate>", "Relationship predicate (e.g., depends-on, realizes, exposes)").option("--properties <json>", "Relationship properties (JSON)").addHelpText("after", `
 Examples:
   $ dr relationship add motivation.goal.goal-a motivation.goal.goal-b --predicate aggregates
   $ dr relationship add api.operation.create-order application.service.order-service --predicate exposes
   $ dr relationship add business.businessprocess.checkout application.applicationprocess.checkout --predicate aggregates
   $ dr relationship add element-1 element-2 --predicate realizes --properties '{"strength":"high"}'`).action(async (source, target, options) => {
     try {
-      const model = await Model.load(), sourceLayerName = await findElementLayer(model, source);
+      const model = await Model.load(options.model || process.cwd()), sourceLayerName = await findElementLayer(model, source);
       if (!sourceLayerName)
         throw new CLIError(`Source element ${source} not found`, ErrorCategory.USER);
       const sourceLayer = await model.getLayer(sourceLayerName);
@@ -199,19 +199,33 @@ Examples:
       if (!await addRelationshipHandler(model, source, target, options.predicate, properties, {
         source: { element: sourceElement, layerName: sourceLayerName },
         target: { element: targetElement, layerName: targetLayerName }
-      }))
+      })) {
+        handleSuccess(`Relationship ${source} --[${options.predicate}]--> ${target} already exists`, {
+          source,
+          target,
+          predicate: options.predicate,
+          layer: sourceLayerName,
+          duplicate: !0
+        }, { verbose: options.verbose });
         return;
-      let message = `\u2713 Added relationship: ${ansis.bold(source)} ${options.predicate} ${ansis.bold(target)}`;
-      constraints && (message += ansis.dim(` (${constraints.cardinality}, ${constraints.strength} strength)`)), activeChangesetId && (message += ansis.dim(" [staged]")), console.log(ansis.green(message));
+      }
+      let message = `Added relationship: ${ansis.bold(source)} ${options.predicate} ${ansis.bold(target)}`;
+      const details = {
+        source,
+        target,
+        predicate: options.predicate,
+        layer: sourceLayerName
+      };
+      constraints && (message += ansis.dim(` (${constraints.cardinality}, ${constraints.strength} strength)`), details.cardinality = constraints.cardinality, details.strength = constraints.strength), activeChangesetId && (message += ansis.dim(" [staged]"), details.changesetStatus = "staged"), handleSuccess(message, details, { verbose: options.verbose });
     } catch (error) {
       handleError(error);
     }
-  }), program.command("delete <source> <target>").description("Delete a relationship").option("--predicate <predicate>", "Specific predicate to delete (optional, delete all if not specified)").option("--force", "Skip confirmation prompt").addHelpText("after", `
+  }), program.command("delete <source> <target>").description("Delete a relationship").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--predicate <predicate>", "Specific predicate to delete (optional, delete all if not specified)").option("--force", "Skip confirmation prompt").addHelpText("after", `
 Examples:
   $ dr relationship delete element-1 element-2 --predicate depends-on
   $ dr relationship delete element-1 element-2 --force`).action(async (source, target, options) => {
     try {
-      const model = await Model.load(), sourceLayerName = await findElementLayer(model, source);
+      const model = await Model.load(options.model || process.cwd()), sourceLayerName = await findElementLayer(model, source);
       if (!sourceLayerName)
         throw new CLIError(`Source element ${source} not found`, ErrorCategory.USER);
       const toDelete = model.relationships.find(source, target, options.predicate);
@@ -224,73 +238,82 @@ Examples:
           message: `Delete ${toDelete.length} relationship(s)? This cannot be undone.`,
           initialValue: !1
         })) {
-          console.log(ansis.dim("Cancelled"));
+          handleSuccess("Deletion cancelled", {
+            source,
+            target,
+            status: "cancelled"
+          });
           return;
         }
       }
       const activeChangesetId = await new StagingAreaManager(model.rootPath, model).getActiveId(), result = await deleteRelationshipHandler(model, source, target, options.predicate, {
         sourceLayerName,
         toDelete
-      }), stagedSuffix = activeChangesetId ? " [staged]" : "";
-      console.log(ansis.green(`\u2713 Deleted ${result.deletedCount} relationship(s) from ${ansis.bold(source)} to ${ansis.bold(target)}${stagedSuffix}`));
+      }), stagedSuffix = activeChangesetId ? " [staged]" : "", deleteDetails = {
+        source,
+        target,
+        layer: sourceLayerName,
+        deletedCount: result.deletedCount
+      };
+      options.predicate && (deleteDetails.predicate = options.predicate), activeChangesetId && (deleteDetails.changesetStatus = "staged"), handleSuccess(`Deleted ${result.deletedCount} relationship(s) from ${ansis.bold(source)} to ${ansis.bold(target)}${stagedSuffix}`, deleteDetails, { verbose: options.verbose });
     } catch (error) {
       handleError(error);
     }
-  }), program.command("list <id>").description("List relationships for an element").option("--direction <dir>", "Filter by direction (incoming/outgoing/all)", "all").option("--json", "Output as JSON").addHelpText("after", `
+  }), program.command("list <id>").description("List relationships for an element").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--direction <dir>", "Filter by direction (incoming/outgoing/all)", "all").option("--json", "Output as JSON").addHelpText("after", `
 Examples:
   $ dr relationship list api-endpoint-create-customer
   $ dr relationship list business-service-order --direction outgoing
   $ dr relationship list element-1 --json`).action(async (id, options) => {
     try {
-      const model = await Model.load();
+      const model = await Model.load(options.model || process.cwd());
       if (!await findElementLayer(model, id))
         throw new CLIError(`Element ${id} not found`, ErrorCategory.USER);
       const { outgoing, incoming } = model.relationships.getForElement(id);
       let relationships = [];
-      if ((options.direction === "outgoing" || options.direction === "all") && relationships.push(...outgoing), (options.direction === "incoming" || options.direction === "all") && relationships.push(...incoming), options.json) {
+      if ((options.direction === "outgoing" || options.direction === "all") && relationships.push(...outgoing), (options.direction === "incoming" || options.direction === "all") && relationships.push(...incoming), options.json ?? rootProgram?.opts().json) {
         console.log(JSON.stringify(relationships, null, 2));
         return;
       }
       if (relationships.length === 0) {
-        console.log(ansis.yellow(`No ${options.direction} relationships for ${id}`));
+        handleInfo(ansis.yellow(`No ${options.direction} relationships for ${id}`));
         return;
       }
-      console.log(""), console.log(ansis.bold(`${options.direction === "all" ? "" : options.direction + " "}relationships for ${ansis.cyan(id)}:`)), console.log(ansis.dim("\u2500".repeat(80)));
+      handleInfo(""), handleInfo(ansis.bold(`${options.direction === "all" ? "" : options.direction + " "}relationships for ${ansis.cyan(id)}:`)), handleInfo(ansis.dim("\u2500".repeat(80)));
       for (const rel of relationships) {
         const isOutgoing = rel.source === id, direction = isOutgoing ? "\u2192" : "\u2190", otherElement = isOutgoing ? rel.target : rel.source, crossLayer = rel.targetLayer && rel.targetLayer !== rel.layer ? ansis.dim(` [${rel.layer} \u2192 ${rel.targetLayer}]`) : "";
-        if (console.log(`  ${direction} ${ansis.magenta(rel.predicate)}: ${ansis.yellow(otherElement)}${crossLayer}`), rel.properties) {
+        if (handleInfo(`  ${direction} ${ansis.magenta(rel.predicate)}: ${ansis.yellow(otherElement)}${crossLayer}`), rel.properties) {
           const propStr = Object.entries(rel.properties).map(([k, v]) => `${k}=${v}`).join(", ");
-          console.log(`    ${ansis.dim(propStr)}`);
+          handleInfo(`    ${ansis.dim(propStr)}`);
         }
       }
-      console.log(ansis.dim("\u2500".repeat(80))), console.log(ansis.dim(`Total: ${relationships.length} relationship(s)`)), console.log("");
+      handleInfo(ansis.dim("\u2500".repeat(80))), handleInfo(ansis.dim(`Total: ${relationships.length} relationship(s)`)), handleInfo("");
     } catch (error) {
       handleError(error);
     }
-  }), program.command("show <source> <target>").description("Show relationship details").addHelpText("after", `
+  }), program.command("show <source> <target>").description("Show relationship details").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
 Examples:
   $ dr relationship show api-endpoint-create-customer business-service-customer-mgmt
-  $ dr relationship show application-component-api motivation-goal-sales-efficiency`).action(async (source, target) => {
+  $ dr relationship show application-component-api motivation-goal-sales-efficiency`).action(async (source, target, options) => {
     try {
-      const model = await Model.load();
+      const model = await Model.load(options.model || process.cwd());
       if (!await findElementLayer(model, source))
         throw new CLIError(`Source element ${source} not found`, ErrorCategory.USER);
       const relationships = model.relationships.find(source, target);
       if (relationships.length === 0)
         throw new CLIError(`No relationships from ${source} to ${target}`, ErrorCategory.USER);
-      console.log(""), console.log(ansis.bold(`Relationship${relationships.length > 1 ? "s" : ""} from ${ansis.cyan(source)} to ${ansis.yellow(target)}:`)), console.log(ansis.dim("\u2500".repeat(60)));
+      handleInfo(""), handleInfo(ansis.bold(`Relationship${relationships.length > 1 ? "s" : ""} from ${ansis.cyan(source)} to ${ansis.yellow(target)}:`)), handleInfo(ansis.dim("\u2500".repeat(60)));
       for (let i = 0; i < relationships.length; i++) {
         const rel = relationships[i];
-        if (i > 0 && console.log(""), console.log(`Predicate: ${ansis.magenta(rel.predicate)}`), console.log(`Layer:     ${ansis.cyan(rel.layer)}`), rel.targetLayer && rel.targetLayer !== rel.layer && console.log(`Target Layer: ${ansis.cyan(rel.targetLayer)}`), rel.properties && Object.keys(rel.properties).length > 0) {
-          console.log("Properties:");
+        if (i > 0 && handleInfo(""), handleInfo(`Predicate: ${ansis.magenta(rel.predicate)}`), handleInfo(`Layer:     ${ansis.cyan(rel.layer)}`), rel.targetLayer && rel.targetLayer !== rel.layer && handleInfo(`Target Layer: ${ansis.cyan(rel.targetLayer)}`), rel.properties && Object.keys(rel.properties).length > 0) {
+          handleInfo("Properties:");
           for (const [key, value] of Object.entries(rel.properties)) {
             const displayValue = typeof value == "string" ? value : JSON.stringify(value, null, 2);
-            console.log(`  ${ansis.cyan(key)}: ${displayValue}`);
+            handleInfo(`  ${ansis.cyan(key)}: ${displayValue}`);
           }
         } else
-          console.log("Properties: none");
+          handleInfo("Properties: none");
       }
-      console.log("");
+      handleInfo("");
     } catch (error) {
       handleError(error);
     }