@documentation-robotics/cli 0.1.13 → 0.3.0

package/dist/commands/add.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/add.ts"],
-  "sourcesContent": ["/**\n * Add an element to a layer\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { Layer } from \"../core/layer.js\";\nimport { Element } from \"../core/element.js\";\nimport { MutationHandler } from \"../core/mutation-handler.js\";\nimport { validateSourceReferenceOptions, buildSourceReference } from \"../utils/source-reference.js\";\nimport { SchemaValidator } from \"../validators/schema-validator.js\";\nimport { getActiveSpan } from \"../telemetry/index.js\";\nimport { generateElementId, generateUUID } from \"../utils/id-generator.js\";\nimport { getAllLayerIds, isValidLayer } from \"../generated/layer-registry.js\";\nimport { isValidNodeType, getNodeTypesForLayer, normalizeNodeType } from \"../generated/node-types.js\";\nimport {\n  CLIError,\n  ErrorCategory,\n  InvalidJSONError,\n  ModelNotFoundError,\n  findSimilar,\n  formatValidOptions,\n  getErrorMessage,\n  handleError,\n  handleSuccess,\n} from \"../utils/errors.js\";\n\n\nexport interface AddOptions {\n  name?: string;\n  description?: string;\n  attributes?: string;\n  sourceFile?: string;\n  sourceSymbol?: string;\n  sourceProvenance?: string;\n  sourceRepoRemote?: string;\n  sourceRepoCommit?: string;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function addCommand(\n  layer: string,\n  type: string,\n  name: string,\n  options: AddOptions\n): Promise<void> {\n  try {\n    // Validate layer name\n    if (!isValidLayer(layer)) {\n      const validLayers = getAllLayerIds();\n      const similar = findSimilar(layer, validLayers, 3);\n      const suggestions: string[] = [`Use a valid layer name: ${formatValidOptions(validLayers)}`];\n      if (similar.length > 0) {\n        suggestions.unshift(`Did you mean: ${similar.join(\" or \")}?`);\n      }\n      throw new CLIError(`Unknown layer \"${layer}\"`, ErrorCategory.USER, suggestions, {\n        operation: \"add\",\n        context: `Layer: ${layer}, Type: ${type}, Name: ${name}`,\n      });\n    }\n\n    // Validate element type for this layer\n    if (!isValidNodeType(layer, type)) {\n      const validNodeTypes = getNodeTypesForLayer(layer);\n      const typeNames = validNodeTypes.map((t) => t.type).sort();\n      const similar = findSimilar(type, typeNames, 3);\n      const suggestions: string[] = [`Valid types for ${layer}: ${formatValidOptions(typeNames)}`];\n      if (similar.length > 0) {\n        suggestions.unshift(`Did you mean: ${similar.join(\" or \")}?`);\n      }\n      throw new CLIError(\n        `Invalid element type \"${type}\" for layer \"${layer}\"`,\n        ErrorCategory.USER,\n        suggestions,\n        {\n          operation: \"add\",\n          context: `Layer: ${layer}, Type: ${type}, Name: ${name}`,\n        }\n      );\n    }\n\n    // Resolve abbreviated type names to their canonical spec names\n    // e.g., \"service\" \u2192 \"applicationservice\" for the application layer\n    const resolvedType = normalizeNodeType(layer, type);\n\n    // Generate slug path: {layer}.{resolvedType}.{kebab-name}\n    const elementPath = generateElementId(layer, resolvedType, name);  // slug\n    const elementUUID = generateUUID();                         // UUIDv4\n\n    // Validate the generated slug is non-empty (name may collapse to empty after stripping special chars)\n    const slugPart = elementPath.split(\".\")[2];\n    if (!slugPart) {\n      throw new CLIError(\n        `Cannot generate a valid element ID from name \"${name}\"`,\n        ErrorCategory.USER,\n        [\n          \"Element names must contain at least one letter or digit\",\n          `Generated ID would be: ${elementPath}`,\n        ]\n      );\n    }\n\n    const span = getActiveSpan();\n    span?.setAttribute(\"layer.name\", layer);\n    span?.setAttribute(\"element.type\", resolvedType);\n    span?.setAttribute(\"element.id\", elementPath);\n\n    // Validate source reference options\n    validateSourceReferenceOptions(options);\n\n    // Load model (with error handling for missing models)\n    let model: Model;\n    try {\n      model = await Model.load(undefined, { layers: [layer] });\n    } catch (error) {\n      const message = getErrorMessage(error);\n      if (message.includes(\"No DR project\") || message.includes(\"Model not found\")) {\n        throw new ModelNotFoundError();\n      }\n      throw error;\n    }\n\n    // Get or create layer\n    let layerObj = await model.getLayer(layer);\n    if (!layerObj) {\n      layerObj = new Layer(layer);\n      model.addLayer(layerObj);\n    }\n\n    // Parse attributes if provided\n    let attributes: Record<string, unknown> = {};\n    if (options.attributes) {\n      try {\n        attributes = JSON.parse(options.attributes);\n      } catch (e) {\n        throw new InvalidJSONError(options.attributes, \"--attributes\");\n      }\n    }\n\n    // Create element in spec-node format\n    // id = UUIDv4 for schema compliance; path = slug for human-readable identifier\n    const element = new Element({\n      id: elementUUID,          // UUIDv4\n      path: elementPath,        // slug: {layer}.{resolvedType}.{kebab-name}\n      spec_node_id: `${layer}.${resolvedType}`,\n      layer_id: layer,\n      type: resolvedType,\n      name: options.name || name,\n      description: options.description,\n      attributes: attributes,\n      metadata: {\n        created_at: new Date().toISOString(),\n        updated_at: new Date().toISOString(),\n        version: 1,\n      },\n      layer, // Set layer so setSourceReference can use it\n    });\n\n\n    // Add source reference if provided\n    const sourceRef = buildSourceReference(options);\n    if (sourceRef) {\n      element.setSourceReference(sourceRef);\n    }\n\n    // Validate element attributes against spec schema before persisting\n    {\n      const schemaValidator = new SchemaValidator();\n      const tempLayer = new Layer(layer);\n      tempLayer.addElement(element);\n      const attrValidation = await schemaValidator.validateLayer(tempLayer);\n      if (!attrValidation.isValid()) {\n        const errorMessages = attrValidation.errors\n          .map((e) => `  ${e.message}`)\n          .join(\"\\n\");\n        throw new CLIError(\n          `Element ${elementPath} has invalid attributes:\\n${errorMessages}`,\n          ErrorCategory.USER,\n          [`Run \"dr schema ${layer} ${type}\" to see the required attributes`]\n        );\n      }\n    }\n\n    // Check if element already exists (look up by path)\n    if (layerObj.getElement(elementPath)) {\n      throw new CLIError(\n        `Element ${elementPath} already exists in ${layer} layer`,\n        ErrorCategory.USER,\n        [\n          `Use \"dr show ${elementPath}\" to view the existing element`,\n          `Use \"dr update ${elementPath}\" to modify it`,\n          `Use \"dr delete ${elementPath}\" to remove it first if you want to recreate it`,\n        ],\n        { operation: \"add\", context: `Duplicate element path` }\n      );\n    }\n\n    // Unified mutation handler for add operation\n    const handler = new MutationHandler(model, elementPath, layer);\n\n    // Execute add through unified path (handles staging and base model consistently)\n    await handler.executeAdd(element, (elem) => {\n      // This mutator is called by executeAdd for base model path only\n      layerObj.addElement(elem);\n    });\n\n    // Determine if operation was staged or applied to base model\n    if (handler.getAfterState()) {\n      // Check if we went through staging path\n      const stagingManager = handler.getStagingManager();\n      const activeChangeset = await stagingManager.getActive();\n      if (activeChangeset && activeChangeset.status === \"staged\") {\n        // Staging path\n        handleSuccess(\n          `Staged element ${ansis.bold(elementPath)} to ${ansis.bold(activeChangeset.name)}`,\n          {\n            status: \"staged\",\n            changeset: activeChangeset.name,\n            type: resolvedType,\n            name: options.name || name,\n          }\n        );\n      } else {\n        // Base model path\n        handleSuccess(`Added element ${ansis.bold(elementPath)} to ${ansis.bold(layer)} layer`, {\n          type: resolvedType,\n          name: options.name || name,\n          description: options.description || \"(none)\",\n        });\n      }\n    }\n  } catch (error) {\n    handleError(error);\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Add an element to a layer\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { Layer } from \"../core/layer.js\";\nimport { Element } from \"../core/element.js\";\nimport { MutationHandler } from \"../core/mutation-handler.js\";\nimport { validateSourceReferenceOptions, buildSourceReference } from \"../utils/source-reference.js\";\nimport { schemaLookupHint } from \"../utils/error-hints.js\";\nimport { SchemaValidator } from \"../validators/schema-validator.js\";\nimport { getActiveSpan } from \"../telemetry/index.js\";\nimport { generateElementId, generateUUID } from \"../utils/id-generator.js\";\nimport { getAllLayerIds, isValidLayer } from \"../generated/layer-registry.js\";\nimport { isValidNodeType, getNodeTypesForLayer, normalizeNodeType } from \"../generated/node-types.js\";\nimport {\n  CLIError,\n  ErrorCategory,\n  InvalidJSONError,\n  ModelNotFoundError,\n  findSimilar,\n  formatValidOptions,\n  getErrorMessage,\n  handleError,\n  handleSuccess,\n} from \"../utils/errors.js\";\n\n\nexport interface AddOptions {\n  model?: string;\n  name?: string;\n  description?: string;\n  attributes?: string;\n  sourceFile?: string;\n  sourceSymbol?: string;\n  sourceProvenance?: string;\n  sourceRepoRemote?: string;\n  sourceRepoCommit?: string;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function addCommand(\n  layer: string,\n  type: string,\n  name: string,\n  options: AddOptions\n): Promise<void> {\n  try {\n    // Validate layer name\n    if (!isValidLayer(layer)) {\n      const validLayers = getAllLayerIds();\n      const similar = findSimilar(layer, validLayers, 3);\n      const suggestions: string[] = [`Use a valid layer name: ${formatValidOptions(validLayers)}`];\n      if (similar.length > 0) {\n        suggestions.unshift(`Did you mean: ${similar.join(\" or \")}?`);\n      }\n      throw new CLIError(`Unknown layer \"${layer}\"`, ErrorCategory.USER, suggestions, {\n        operation: \"add\",\n        context: `Layer: ${layer}, Type: ${type}, Name: ${name}`,\n      });\n    }\n\n    // Validate element type for this layer\n    if (!isValidNodeType(layer, type)) {\n      const validNodeTypes = getNodeTypesForLayer(layer);\n      const typeNames = validNodeTypes.map((t) => t.type).sort();\n      const similar = findSimilar(type, typeNames, 3);\n      const suggestions: string[] = [`Valid types for ${layer}: ${formatValidOptions(typeNames)}`];\n      if (similar.length > 0) {\n        suggestions.unshift(`Did you mean: ${similar.join(\" or \")}?`);\n      }\n      throw new CLIError(\n        `Invalid element type \"${type}\" for layer \"${layer}\"`,\n        ErrorCategory.USER,\n        suggestions,\n        {\n          operation: \"add\",\n          context: `Layer: ${layer}, Type: ${type}, Name: ${name}`,\n        }\n      );\n    }\n\n    // Resolve abbreviated type names to their canonical spec names\n    // e.g., \"service\" \u2192 \"applicationservice\" for the application layer\n    const resolvedType = normalizeNodeType(layer, type);\n\n    // Generate slug path: {layer}.{resolvedType}.{kebab-name}\n    const elementPath = generateElementId(layer, resolvedType, name);  // slug\n    const elementUUID = generateUUID();                         // UUIDv4\n\n    // Validate the generated slug is non-empty (name may collapse to empty after stripping special chars)\n    const slugPart = elementPath.split(\".\")[2];\n    if (!slugPart) {\n      throw new CLIError(\n        `Cannot generate a valid element ID from name \"${name}\"`,\n        ErrorCategory.USER,\n        [\n          \"Element names must contain at least one letter or digit\",\n          `Generated ID would be: ${elementPath}`,\n        ]\n      );\n    }\n\n    const span = getActiveSpan();\n    span?.setAttribute(\"layer.name\", layer);\n    span?.setAttribute(\"element.type\", resolvedType);\n    span?.setAttribute(\"element.id\", elementPath);\n\n    // Validate source reference options\n    validateSourceReferenceOptions(options);\n\n    // Load model (with error handling for missing models)\n    let model: Model;\n    try {\n      model = await Model.load(options.model, { layers: [layer] });\n    } catch (error) {\n      const message = getErrorMessage(error);\n      if (message.includes(\"No DR project\") || message.includes(\"Model not found\")) {\n        throw new ModelNotFoundError();\n      }\n      throw error;\n    }\n\n    // Get or create layer\n    let layerObj = await model.getLayer(layer);\n    if (!layerObj) {\n      layerObj = new Layer(layer);\n      model.addLayer(layerObj);\n    }\n\n    // Parse attributes if provided\n    let attributes: Record<string, unknown> = {};\n    if (options.attributes) {\n      try {\n        attributes = JSON.parse(options.attributes);\n      } catch (e) {\n        throw new InvalidJSONError(options.attributes, \"--attributes\");\n      }\n    }\n\n    // Create element in spec-node format\n    // id = UUIDv4 for schema compliance; path = slug for human-readable identifier\n    const element = new Element({\n      id: elementUUID,          // UUIDv4\n      path: elementPath,        // slug: {layer}.{resolvedType}.{kebab-name}\n      spec_node_id: `${layer}.${resolvedType}`,\n      layer_id: layer,\n      type: resolvedType,\n      name: options.name || name,\n      description: options.description,\n      attributes: attributes,\n      metadata: {\n        created_at: new Date().toISOString(),\n        updated_at: new Date().toISOString(),\n        version: 1,\n      },\n      layer, // Set layer so setSourceReference can use it\n    });\n\n\n    // Add source reference if provided\n    const sourceRef = buildSourceReference(options);\n    if (sourceRef) {\n      element.setSourceReference(sourceRef);\n    }\n\n    // Validate element attributes against spec schema before persisting\n    {\n      const schemaValidator = new SchemaValidator();\n      const tempLayer = new Layer(layer);\n      tempLayer.addElement(element);\n      const attrValidation = await schemaValidator.validateLayer(tempLayer);\n      if (!attrValidation.isValid()) {\n        const errorMessages = attrValidation.errors\n          .map((e) => `  ${e.message}`)\n          .join(\"\\n\");\n        throw new CLIError(\n          `Element ${elementPath} has invalid attributes:\\n${errorMessages}`,\n          ErrorCategory.USER,\n          [schemaLookupHint(\"cli\", layer, resolvedType)]\n        );\n      }\n    }\n\n    // Check if element already exists (look up by path)\n    if (layerObj.getElement(elementPath)) {\n      throw new CLIError(\n        `Element ${elementPath} already exists in ${layer} layer`,\n        ErrorCategory.USER,\n        [\n          `Use \"dr show ${elementPath}\" to view the existing element`,\n          `Use \"dr update ${elementPath}\" to modify it`,\n          `Use \"dr delete ${elementPath}\" to remove it first if you want to recreate it`,\n        ],\n        { operation: \"add\", context: `Duplicate element path` }\n      );\n    }\n\n    // Unified mutation handler for add operation\n    const handler = new MutationHandler(model, elementPath, layer);\n\n    // Execute add through unified path (handles staging and base model consistently)\n    await handler.executeAdd(element, (elem) => {\n      // This mutator is called by executeAdd for base model path only\n      layerObj.addElement(elem);\n    });\n\n    // Determine if operation was staged or applied to base model\n    if (handler.getAfterState()) {\n      // Check if we went through staging path\n      const stagingManager = handler.getStagingManager();\n      const activeChangeset = await stagingManager.getActive();\n      if (activeChangeset && activeChangeset.status === \"staged\") {\n        // Staging path\n        handleSuccess(\n          `Staged element ${ansis.bold(elementPath)} to ${ansis.bold(activeChangeset.name)}`,\n          {\n            elementId: elementPath,\n            layer,\n            type: resolvedType,\n            name: options.name || name,\n            changesetStatus: \"staged\",\n            changeset: activeChangeset.name,\n          },\n          { verbose: options.verbose }\n        );\n      } else {\n        // Base model path\n        handleSuccess(`Added element ${ansis.bold(elementPath)} to ${ansis.bold(layer)} layer`, {\n          elementId: elementPath,\n          layer,\n          type: resolvedType,\n          name: options.name || name,\n          description: options.description || \"(none)\",\n        }, { verbose: true });\n      }\n    }\n  } catch (error) {\n    handleError(error);\n  }\n}\n"],
+  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SAAS,aAAa;AACtB,SAAS,eAAe;AACxB,SAAS,uBAAuB;AAChC,SAAS,gCAAgC,4BAA4B;AACrE,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,mBAAmB,oBAAoB;AAChD,SAAS,gBAAgB,oBAAoB;AAC7C,SAAS,iBAAiB,sBAAsB,yBAAyB;AACzE,SACE,UACA,eACA,kBACA,oBACA,aACA,oBACA,iBACA,aACA,qBACK;AAiBP,eAAsB,WACpB,OACA,MACA,MACA,SAAmB;AAEnB,MAAI;AAEF,QAAI,CAAC,aAAa,KAAK,GAAG;AACxB,YAAM,cAAc,eAAc,GAC5B,UAAU,YAAY,OAAO,aAAa,CAAC,GAC3C,cAAwB,CAAC,2BAA2B,mBAAmB,WAAW,CAAC,EAAE;AAC3F,YAAI,QAAQ,SAAS,KACnB,YAAY,QAAQ,iBAAiB,QAAQ,KAAK,MAAM,CAAC,GAAG,GAExD,IAAI,SAAS,kBAAkB,KAAK,KAAK,cAAc,MAAM,aAAa;QAC9E,WAAW;QACX,SAAS,UAAU,KAAK,WAAW,IAAI,WAAW,IAAI;OACvD;IACH;AAGA,QAAI,CAAC,gBAAgB,OAAO,IAAI,GAAG;AAEjC,YAAM,YADiB,qBAAqB,KAAK,EAChB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAI,GAClD,UAAU,YAAY,MAAM,WAAW,CAAC,GACxC,cAAwB,CAAC,mBAAmB,KAAK,KAAK,mBAAmB,SAAS,CAAC,EAAE;AAC3F,YAAI,QAAQ,SAAS,KACnB,YAAY,QAAQ,iBAAiB,QAAQ,KAAK,MAAM,CAAC,GAAG,GAExD,IAAI,SACR,yBAAyB,IAAI,gBAAgB,KAAK,KAClD,cAAc,MACd,aACA;QACE,WAAW;QACX,SAAS,UAAU,KAAK,WAAW,IAAI,WAAW,IAAI;OACvD;IAEL;AAIA,UAAM,eAAe,kBAAkB,OAAO,IAAI,GAG5C,cAAc,kBAAkB,OAAO,cAAc,IAAI,GACzD,cAAc,aAAY;AAIhC,QAAI,CADa,YAAY,MAAM,GAAG,EAAE,CAAC;AAEvC,YAAM,IAAI,SACR,iDAAiD,IAAI,KACrD,cAAc,MACd;QACE;QACA,0BAA0B,WAAW;OACtC;AAIL,UAAM,OAAO,cAAa;AAC1B,UAAM,aAAa,cAAc,KAAK,GACtC,MAAM,aAAa,gBAAgB,YAAY,GAC/C,MAAM,aAAa,cAAc,WAAW,GAG5C,+BAA+B,OAAO;AAGtC,QAAI;AACJ,QAAI;AACF,cAAQ,MAAM,MAAM,KAAK,QAAQ,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAC,CAAE;IAC7D,SAAS,OAAO;AACd,YAAM,UAAU,gBAAgB,KAAK;AACrC,YAAI,QAAQ,SAAS,eAAe,KAAK,QAAQ,SAAS,iBAAiB,IACnE,IAAI,mBAAkB,IAExB;IACR;AAGA,QAAI,WAAW,MAAM,MAAM,SAAS,KAAK;AACzC,IAAK,aACH,WAAW,IAAI,MAAM,KAAK,GAC1B,MAAM,SAAS,QAAQ;AAIzB,QAAI,aAAsC,CAAA;AAC1C,QAAI,QAAQ;AACV,UAAI;AACF,qBAAa,KAAK,MAAM,QAAQ,UAAU;MAC5C,QAAY;AACV,cAAM,IAAI,iBAAiB,QAAQ,YAAY,cAAc;MAC/D;AAKF,UAAM,UAAU,IAAI,QAAQ;MAC1B,IAAI;;MACJ,MAAM;;MACN,cAAc,GAAG,KAAK,IAAI,YAAY;MACtC,UAAU;MACV,MAAM;MACN,MAAM,QAAQ,QAAQ;MACtB,aAAa,QAAQ;MACrB;MACA,UAAU;QACR,aAAY,oBAAI,KAAI,GAAG,YAAW;QAClC,aAAY,oBAAI,KAAI,GAAG,YAAW;QAClC,SAAS;;MAEX;;KACD,GAIK,YAAY,qBAAqB,OAAO;AAC9C,IAAI,aACF,QAAQ,mBAAmB,SAAS;AAItC;AACE,YAAM,kBAAkB,IAAI,gBAAe,GACrC,YAAY,IAAI,MAAM,KAAK;AACjC,gBAAU,WAAW,OAAO;AAC5B,YAAM,iBAAiB,MAAM,gBAAgB,cAAc,SAAS;AACpE,UAAI,CAAC,eAAe,QAAO,GAAI;AAC7B,cAAM,gBAAgB,eAAe,OAClC,IAAI,CAAC,MAAM,KAAK,EAAE,OAAO,EAAE,EAC3B,KAAK;CAAI;AACZ,cAAM,IAAI,SACR,WAAW,WAAW;EAA6B,aAAa,IAChE,cAAc,MACd,CAAC,iBAAiB,OAAO,OAAO,YAAY,CAAC,CAAC;MAElD;IACF;AAGA,QAAI,SAAS,WAAW,WAAW;AACjC,YAAM,IAAI,SACR,WAAW,WAAW,sBAAsB,KAAK,UACjD,cAAc,MACd;QACE,gBAAgB,WAAW;QAC3B,kBAAkB,WAAW;QAC7B,kBAAkB,WAAW;SAE/B,EAAE,WAAW,OAAO,SAAS,yBAAwB,CAAE;AAK3D,UAAM,UAAU,IAAI,gBAAgB,OAAO,aAAa,KAAK;AAS7D,QANA,MAAM,QAAQ,WAAW,SAAS,CAAC,SAAQ;AAEzC,eAAS,WAAW,IAAI;IAC1B,CAAC,GAGG,QAAQ,cAAa,GAAI;AAG3B,YAAM,kBAAkB,MADD,QAAQ,kBAAiB,EACH,UAAS;AACtD,MAAI,mBAAmB,gBAAgB,WAAW,WAEhD,cACE,kBAAkB,MAAM,KAAK,WAAW,CAAC,OAAO,MAAM,KAAK,gBAAgB,IAAI,CAAC,IAChF;QACE,WAAW;QACX;QACA,MAAM;QACN,MAAM,QAAQ,QAAQ;QACtB,iBAAiB;QACjB,WAAW,gBAAgB;SAE7B,EAAE,SAAS,QAAQ,QAAO,CAAE,IAI9B,cAAc,iBAAiB,MAAM,KAAK,WAAW,CAAC,OAAO,MAAM,KAAK,KAAK,CAAC,UAAU;QACtF,WAAW;QACX;QACA,MAAM;QACN,MAAM,QAAQ,QAAQ;QACtB,aAAa,QAAQ,eAAe;SACnC,EAAE,SAAS,GAAI,CAAE;IAExB;EACF,SAAS,OAAO;AACd,gBAAY,KAAK;EACnB;AACF;",
   "names": []
 }

package/dist/commands/analyzer.js

@@ -9,6 +9,7 @@ import { CLIError, ModelNotFoundError, ErrorCategory, categorizeError } from "..
 import { findProjectRoot } from "../utils/project-paths.js";
 import { performDiscover } from "./discover-logic.js";
 import { formatVerifyReport } from "../export/verify-formatters.js";
+import { Model } from "../core/model.js";
 function analyzerCommands(program) {
   const analyzer = program.command("analyzer").description("Manage analyzer discovery and indexing");
   analyzer.command("discover").description("Discover and select an analyzer").option("--json", "Output as JSON").option("--reselect", "Force re-selection even if analyzer already selected").addHelpText("after", `
@@ -16,12 +17,13 @@ Examples:
   $ dr analyzer discover                    # Scan and select analyzer
   $ dr analyzer discover --reselect         # Force re-selection
   $ dr analyzer discover --json             # Output discovery results as JSON`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const projectRoot = await findProjectRoot() || process.cwd(), registry = AnalyzerRegistry.getInstance();
       if (await registry.initialize(), !options.reselect) {
         const session = await readSession(projectRoot);
         if (session)
-          if (options.json) {
+          if (jsonMode) {
             const analyzerNames = await registry.getAnalyzerNames(), analyzerOptions2 = [];
             for (const name of analyzerNames)
               try {
@@ -53,11 +55,11 @@ Examples:
           }
       }
       const discoverResult = await performDiscover(registry, {
-        json: options.json,
+        json: jsonMode,
         reselect: options.reselect,
         isTTY: process.stdin.isTTY
       }), { discoveryResult, installed, analyzerOptions, selectedAnalyzer, shouldWriteSession } = discoverResult;
-      if (options.json) {
+      if (jsonMode) {
         if (selectedAnalyzer && shouldWriteSession) {
           const state = {
             active_analyzer: selectedAnalyzer,
@@ -113,6 +115,7 @@ Examples:
   $ dr analyzer status              # Show status of active analyzer
   $ dr analyzer status --name cbm   # Show status of specific analyzer
   $ dr analyzer status --json       # Output as JSON`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const projectRoot = await findProjectRoot() || process.cwd();
       let analyzerName = options.name;
@@ -129,11 +132,16 @@ Examples:
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND, ["Check the analyzer name with `dr analyzer discover`"]);
       const actualProjectRoot = await findProjectRoot();
       let status;
-      if (actualProjectRoot ? status = await backend.status(actualProjectRoot) : status = {
-        detected: await backend.detect(),
-        indexed: !1,
-        fresh: !1
-      }, options.json) {
+      if (actualProjectRoot) {
+        const model = await Model.load(actualProjectRoot);
+        status = await backend.status(actualProjectRoot, { codebaseRoot: model.codebaseRoot });
+      } else
+        status = {
+          detected: await backend.detect(),
+          indexed: !1,
+          fresh: !1
+        };
+      if (jsonMode) {
         console.log(JSON.stringify(status, null, 2)), actualProjectRoot && await writeStatus(status, actualProjectRoot, analyzerName);
         return;
       }
@@ -172,8 +180,9 @@ Examples:
           `Visit: ${homepageUrl}`
         ]);
       }
+      const model = await Model.load(projectRoot);
       console.log(`Indexing project with ${analyzerName}...`);
-      const result = await backend.index(projectRoot, { force: options.force });
+      const result = await backend.index(projectRoot, { force: options.force, codebaseRoot: model.codebaseRoot });
       console.log(ansis.green("\u2713 Indexing complete")), console.log(`  Nodes: ${result.node_count}`), console.log(`  Edges: ${result.edge_count}`), console.log(`  Git HEAD: ${result.git_head}`);
     } catch (error) {
       if (error instanceof CLIError || error instanceof ModelNotFoundError)
@@ -186,6 +195,7 @@ Examples:
   $ dr analyzer endpoints              # List endpoints from active analyzer
   $ dr analyzer endpoints --json       # Output as JSON
   $ dr analyzer endpoints --name cbm   # List endpoints from specific analyzer`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const projectRoot = await findProjectRoot();
       if (!projectRoot)
@@ -202,10 +212,11 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
-      if (!(await backend.status(projectRoot)).indexed)
+      const model = await Model.load(projectRoot);
+      if (!(await backend.status(projectRoot, { codebaseRoot: model.codebaseRoot })).indexed)
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` to index the project first"]);
-      const endpoints = await backend.endpoints(projectRoot);
-      if (options.json) {
+      const endpoints = await backend.endpoints(projectRoot, { codebaseRoot: model.codebaseRoot });
+      if (jsonMode) {
         console.log(JSON.stringify(endpoints, null, 2));
         return;
       }
@@ -232,6 +243,7 @@ Examples:
   $ dr analyzer services              # List all services
   $ dr analyzer services --layer application
   $ dr analyzer services --json       # Output as JSON`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const projectRoot = await findProjectRoot();
       if (!projectRoot)
@@ -248,10 +260,11 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      const model = await Model.load(projectRoot);
       if (!await readIndexMeta(projectRoot, analyzerName))
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
-      let services = await backend.services(projectRoot);
-      if (options.layer && (services = services.filter((s) => s.suggested_layer === options.layer)), options.json) {
+      let services = await backend.services(projectRoot, { codebaseRoot: model.codebaseRoot });
+      if (options.layer && (services = services.filter((s) => s.suggested_layer === options.layer)), jsonMode) {
         console.log(JSON.stringify(services, null, 2));
         return;
       }
@@ -277,6 +290,7 @@ Examples:
 Examples:
   $ dr analyzer datastores        # List all inferred datastores
   $ dr analyzer datastores --json # Output as JSON`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const projectRoot = await findProjectRoot();
       if (!projectRoot)
@@ -293,10 +307,11 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      const model = await Model.load(projectRoot);
       if (!await readIndexMeta(projectRoot, analyzerName))
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
-      const datastores = await backend.datastores(projectRoot);
-      if (options.json) {
+      const datastores = await backend.datastores(projectRoot, { codebaseRoot: model.codebaseRoot });
+      if (jsonMode) {
         console.log(JSON.stringify(datastores, null, 2));
         return;
       }
@@ -323,6 +338,7 @@ Examples:
   $ dr analyzer callers com.example.Service.handleRequest
   $ dr analyzer callers com.example.Service.handleRequest --depth 5
   $ dr analyzer callers com.example.Service.handleRequest --json`).action(async (qualifiedName, options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const depth = parseInt(options.depth, 10);
       if (isNaN(depth) || depth < 1)
@@ -342,10 +358,11 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      const model = await Model.load(projectRoot);
       if (!await readIndexMeta(projectRoot, analyzerName))
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
-      const callers = await backend.callers(projectRoot, qualifiedName, depth);
-      if (options.json) {
+      const callers = await backend.callers(projectRoot, qualifiedName, depth, { codebaseRoot: model.codebaseRoot });
+      if (jsonMode) {
         console.log(JSON.stringify(callers, null, 2));
         return;
       }
@@ -368,6 +385,7 @@ Examples:
   $ dr analyzer callees com.example.Service.handleRequest
   $ dr analyzer callees com.example.Service.handleRequest --depth 5
   $ dr analyzer callees com.example.Service.handleRequest --json`).action(async (qualifiedName, options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       const depth = parseInt(options.depth, 10);
       if (isNaN(depth) || depth < 1)
@@ -387,10 +405,11 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      const model = await Model.load(projectRoot);
       if (!await readIndexMeta(projectRoot, analyzerName))
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
-      const callees = await backend.callees(projectRoot, qualifiedName, depth);
-      if (options.json) {
+      const callees = await backend.callees(projectRoot, qualifiedName, depth, { codebaseRoot: model.codebaseRoot });
+      if (jsonMode) {
         console.log(JSON.stringify(callees, null, 2));
         return;
       }
@@ -434,9 +453,10 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      const model = await Model.load(projectRoot);
       if (!await readIndexMeta(projectRoot, analyzerName))
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
-      const result = await backend.query(projectRoot, cypher);
+      const result = await backend.query(projectRoot, cypher, { codebaseRoot: model.codebaseRoot });
       options.json, console.log(JSON.stringify(result, null, 2));
     } catch (error) {
       if (error instanceof CLIError || error instanceof ModelNotFoundError)
@@ -452,9 +472,10 @@ Examples:
   $ dr analyzer verify --format markdown     # Output as Markdown to stdout
   $ dr analyzer verify --output report.json  # Save report to file (format inferred as JSON)
   $ dr analyzer verify --output report.md    # Save report as Markdown`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
     try {
       let format = "text";
-      if (options.json)
+      if (jsonMode)
         options.format && console.warn(ansis.yellow(`\u26A0 Both --json and --format "${options.format}" were provided. Using --json format (--format is ignored).`)), format = "json";
       else if (options.format) {
         const validFormats = ["text", "json", "markdown"];
@@ -485,11 +506,13 @@ Examples:
       const backend = await registry.getAnalyzer(analyzerName);
       if (!backend)
         throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      const model = await Model.load(projectRoot);
       if (!await readIndexMeta(projectRoot, analyzerName))
         throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
       const report = await backend.verify(projectRoot, {
         layers: apiLayers,
-        changesetAware: !0
+        changesetAware: !0,
+        codebaseRoot: model.codebaseRoot
       }), formatted = formatVerifyReport(report, { format });
       if (options.output) {
         const outputPath = path.resolve(options.output);
@@ -503,6 +526,94 @@ Examples:
       const cliError = new CLIError(error instanceof Error ? error.message : String(error), categorizeError(error));
       throw error instanceof Error && (cliError.cause = error), cliError;
     }
+  }), analyzer.command("classify").description("Classify the indexed project's symbols into model layers and types (Tier 0: rules only)").option("--name <n>", "Analyzer name (defaults to active from session.json)").option("--tier0-only", "Apply only the analyzer's Tier-0 rules: no model calls, no network (required for now)").option("--label <labels>", "Comma-separated analyzer labels to classify (default: Class, Interface, Function, Method, Module, Route and every label a rule names)").option("--file <glob>", "Only symbols in files matching this glob").option("--exclude <regex>", "Also leave out files matching this regular expression (build and vendored paths always are)").option("--limit <n>", "Stop after this many symbols").option("--cards", "Include each symbol's full card (source and graph neighbourhood) in JSON output").option("--output <file>", "Write the JSON report to a file").option("--json", "Output as JSON").addHelpText("after", `
+Tier 0 is the first step of the classification cascade (docs/analyzers/CASCADE_DESIGN.md):
+the analyzer's rules decide a symbol's layer and type, reject it as not a model element,
+or narrow its choices for a later tier. Symbols no rule covers are reported as undecided.
+Nothing is written to the model.
+
+Examples:
+  $ dr analyzer classify --tier0-only
+  $ dr analyzer classify --tier0-only --json > tier0.json
+  $ dr analyzer classify --tier0-only --label Class,Method --file "src/main/**"
+  $ dr analyzer classify --tier0-only --cards --output tier0-cards.json`).action(async (options) => {
+    const jsonMode = options.json ?? program.opts().json;
+    try {
+      if (!options.tier0Only)
+        throw new CLIError("Only Tier-0 classification is available so far: pass --tier0-only", ErrorCategory.USER, ["Model-backed classification (Tier 1) needs the per-project opt-in and is not built yet"]);
+      let exclude;
+      if (options.exclude !== void 0)
+        try {
+          exclude = new RegExp(String(options.exclude));
+        } catch (e) {
+          throw new CLIError(`Invalid --exclude regular expression: ${e instanceof Error ? e.message : String(e)}`, ErrorCategory.USER);
+        }
+      let limit;
+      if (options.limit !== void 0 && (limit = Number(options.limit), !Number.isInteger(limit) || limit < 1))
+        throw new CLIError(`--limit must be a positive integer, got '${options.limit}'`, ErrorCategory.USER);
+      const labels = options.label ? String(options.label).split(",").map((l) => l.trim()).filter(Boolean) : void 0;
+      options.cards && !jsonMode && !options.output && console.error(ansis.yellow("--cards only affects JSON output: add --json or --output <file>"));
+      const projectRoot = await findProjectRoot();
+      if (!projectRoot)
+        throw new ModelNotFoundError();
+      let analyzerName = options.name;
+      if (!analyzerName) {
+        const session = await readSession(projectRoot);
+        if (!session)
+          throw new CLIError("No analyzer selected. Run `dr analyzer discover` first.", ErrorCategory.USER);
+        analyzerName = session.active_analyzer;
+      }
+      const registry = AnalyzerRegistry.getInstance();
+      await registry.initialize();
+      const backend = await registry.getAnalyzer(analyzerName);
+      if (!backend)
+        throw new CLIError(`Analyzer not found: ${analyzerName}`, ErrorCategory.NOT_FOUND);
+      if (!backend.classify)
+        throw new CLIError(`The ${analyzerName} analyzer does not support classification`, ErrorCategory.USER);
+      if (!await readIndexMeta(projectRoot, analyzerName))
+        throw new CLIError("Project not indexed", ErrorCategory.USER, ["Run `dr analyzer index` first"]);
+      const model = await Model.load(projectRoot), showProgress = !jsonMode && !options.output && process.stderr.isTTY, report = await backend.classify(projectRoot, {
+        codebaseRoot: model.codebaseRoot,
+        labels,
+        filePattern: options.file,
+        exclude,
+        limit,
+        includeCards: !!options.cards,
+        onProgress: showProgress ? (done, total) => {
+          (done % 50 === 0 || done === total) && process.stderr.write(`\r  ${done}/${total} symbols`), done === total && process.stderr.write(`
+`);
+        } : void 0
+      });
+      if (options.output) {
+        const outputPath = path.resolve(options.output);
+        await fs.writeFile(outputPath, JSON.stringify(report, null, 2) + `
+`, "utf-8"), jsonMode || console.log(ansis.green(`\u2713 Report written to ${outputPath}`));
+      }
+      if (jsonMode) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+      }
+      const { summary } = report, pct = (n) => summary.cards ? `${(100 * n / summary.cards).toFixed(0)}%` : "0%";
+      console.log(""), console.log(ansis.bold(`Tier-0 classification: ${summary.cards} symbols, ${report.rules} rules`)), console.log(ansis.dim("\u2500".repeat(60))), console.log(`  ${ansis.green("decided")}    ${String(summary.decided).padStart(6)}  ${pct(summary.decided)}`), console.log(`  ${ansis.yellow("rejected")}   ${String(summary.rejected).padStart(6)}  ${pct(summary.rejected)}  (not model elements)`), console.log(`  ${ansis.cyan("narrowed")}   ${String(summary.narrowed).padStart(6)}  ${pct(summary.narrowed)}  (choices restricted for Tier 1)`), console.log(`  ${ansis.dim("undecided")}  ${String(summary.undecided).padStart(6)}  ${pct(summary.undecided)}`), summary.no_source && console.log(ansis.yellow(`  ${summary.no_source} symbol(s) had no source, so rules that read the declaration could not apply`));
+      const targets = Object.entries(summary.by_target).sort((a, b) => b[1] - a[1]);
+      if (targets.length) {
+        console.log(""), console.log(ansis.bold("Decided, by type:"));
+        for (const [target, n] of targets)
+          console.log(`  ${target.padEnd(40)} ${String(n).padStart(6)}`);
+      }
+      const rules = Object.entries(summary.by_rule).sort((a, b) => b[1] - a[1]);
+      if (rules.length) {
+        console.log(""), console.log(ansis.bold("Matches, by rule:"));
+        for (const [rule, n] of rules)
+          console.log(`  ${rule.padEnd(40)} ${String(n).padStart(6)}`);
+      }
+      console.log(ansis.dim("\u2500".repeat(60))), console.log(ansis.dim("Per-symbol outcomes: --json or --output <file>")), console.log("");
+    } catch (error) {
+      if (error instanceof CLIError || error instanceof ModelNotFoundError)
+        throw error;
+      const cliError = new CLIError(error instanceof Error ? error.message : String(error), categorizeError(error));
+      throw error instanceof Error && (cliError.cause = error), cliError;
+    }
   });
 }
 export {