@documentation-robotics/cli 0.2.0 → 0.4.0

package/README.md

@@ -132,6 +132,31 @@ dr validate                 # Validate model integrity
 dr upgrade                  # Check for spec upgrades
 ```
 
+### Model Farms
+
+A farm (`farm.yaml`) groups several projects' models so they can be synced and validated
+together with cross-model references.
+
+```bash
+dr farm init                              # Create a farm in the current directory
+dr farm add my-service                    # Register ./my-service; scaffolds my-service-model
+dr farm add my-service --codebase ../my-service   # Sibling checkout outside the farm root
+dr farm add my-service --new-model        # Scaffold even if the codebase has its own model
+dr farm add my-service --model ../models/my-service   # Register an existing model explicitly
+dr farm status                            # Pending changes per project
+dr farm validate                          # Validate with farm-aware references
+dr farm sync [--auto-commit]              # Map codebase changes into staged changesets
+dr farm remove my-service [--delete-model]
+```
+
+A codebase that already carries a model (`documentation-robotics/model/manifest.yaml`, or
+`model/manifest.yaml`, or `manifest.yaml` at the codebase path) is adopted in place by
+`dr farm add` rather than shadowed by an empty duplicate: `farm.yaml` points at it, even outside
+the farm root, and the other farm commands read and write it there. `--delete-model` never
+deletes an adopted model, and `sync --auto-commit` leaves committing a model in another git
+repository to that repository (reported as `git_committed: false` with a warning). See
+[docs/FARM_AUTOMATION.md](../docs/FARM_AUTOMATION.md) for flags, JSON output and CI recipes.
+
 ### Working with Elements
 
 ```bash
@@ -277,31 +302,27 @@ dr mcp
 dr mcp --regenerate-key
 ```
 
-**API key**:
-
-- On first launch, `dr mcp` generates a random API key and stores it on disk with `0600` permissions. Interactive sessions are prompted for a storage path; non-interactive launches (the normal case — an MCP client spawning `dr mcp`) default to `~/.dr-mcp-key`.
-- The chosen path is recorded under `mcp.api_key_path` in `~/.dr-config.yaml` (or the path from `DR_CONFIG_PATH`, if set), so subsequent launches reuse the same key without re-prompting.
-- Every launch prints the current key to stderr (never stdout, which carries the MCP protocol) and requires the client to supply it back via the `DR_MCP_API_KEY` environment variable. The connection is rejected if `DR_MCP_API_KEY` is missing or doesn't match.
-- Run `dr mcp --regenerate-key` to rotate the key (e.g. after a suspected leak). This overwrites the key at its existing configured path (or the default path, prompting once if none is configured yet), updates `~/.dr-config.yaml`, prints the new key, and exits without starting the server — no manual deletion of config or key files required.
+**Which project**: the server serves the project the client has open. It asks the client for its MCP roots after connecting and moves to the first root inside a DR project (or the first root, if none has a model yet). `DR_MCP_ROOT_PATH` pins it to one model instead, and tool calls can pass `rootPath`.
 
-**Configuring an MCP client**:
-
-Point your MCP client at the `dr` binary and pass the key via `env`:
+**Configuring an MCP client**: in Claude Code, install the `dr` plugin (see [MCP_SERVER.md](../integrations/claude_code/docs/MCP_SERVER.md)). Other clients point at the `dr` binary:
 
 ```json
 {
   "mcpServers": {
-    "documentation-robotics": {
+    "dr": {
       "command": "dr",
-      "args": ["mcp"],
-      "env": {
-        "DR_MCP_API_KEY": "<key printed by dr mcp>"
-      }
+      "args": ["mcp"]
     }
   }
 }
 ```
 
+**API key (HTTP transport only)**: over stdio the client starts the server as your own user, so there is no key. `dr mcp --transport http` requires the key as a bearer token:
+
+- On first launch it generates a random key and stores it with `0600` permissions. Interactive sessions are prompted for a storage path; non-interactive launches default to `~/.dr-mcp-key`. The path is recorded under `mcp.api_key_path` in `~/.dr-config.yaml` (or the path from `DR_CONFIG_PATH`).
+- Every HTTP launch prints the key to stderr (`DR_MCP_QUIET_KEY=1` suppresses it).
+- `dr mcp --regenerate-key` rotates it: it overwrites the key at its configured path, updates `~/.dr-config.yaml`, prints the new key and exits without starting the server.
+
 ## Configuration
 
 ### Model Structure
@@ -327,7 +348,7 @@ your-project/
 │       └── ...
 ```
 
-**Spec-version migrations**: When the model's spec version is older than the CLI's bundled spec (e.g. after a layer renumbering), run `dr upgrade` to migrate the on-disk model in place — see `MigrationRegistry` in `cli/src/core/migration-registry.ts` for the supported version paths.
+**Spec-version migrations**: When the model's spec version is older than the CLI's bundled spec (e.g. after a layer renumbering), run `dr upgrade` to migrate the on-disk model in place — see `MigrationRegistry` in `cli/src/core/migration-registry.ts` for the supported version paths. `dr upgrade` also applies catalog changes (renamed element types, retired relationship types) to a model already at the current spec version, since the catalog can change between version bumps; see `cli/src/core/catalog-migration.ts`.
 
 ### Specification Reference
 
@@ -478,10 +499,19 @@ dr relationship add business-process-order business-process-payment \
 # List all relationships for an element
 dr relationship list business-process-order
 
-# Delete a relationship
+# Delete a relationship (works even when an endpoint element no longer exists)
 dr relationship delete business-process-order business-process-payment
+
+# Remove rows whose source or target no longer resolves to an element
+# (matches both UUID ids and dotted paths; --dry-run lists without writing)
+dr relationship prune --dry-run
+dr relationship prune --layers api application --format json
 ```
 
+`dr delete` removes the relationships that name the deleted element, so `prune` is for models
+that already carry dangling rows (earlier deletes, hand edits, imports). Inside an active changeset
+it stages the removals instead of writing `relationships.yaml`.
+
 ### Staging Workflow
 
 The staging feature allows you to safely prepare and review changes before committing them to the base model:

package/dist/analysis/relationship-classifier.js

@@ -1,4 +1,4 @@
-import { getLayerOrder, isValidLayerName } from "../core/layers.js";
+import { isValidLayerName } from "../core/layers.js";
 var RelationshipStrength;
 (function(RelationshipStrength2) {
   RelationshipStrength2.Weak = "weak", RelationshipStrength2.Medium = "medium", RelationshipStrength2.Strong = "strong";
@@ -108,7 +108,7 @@ class RelationshipClassifier {
   async validateSemantics(rel) {
     await this.load();
     const issues = [], warnings = [], relationshipType = this.relationshipTypeMap.get(rel.predicate);
-    return relationshipType ? (!relationshipType.semantics.reflexivity && rel.source === rel.target && issues.push(`Predicate "${rel.predicate}" does not support reflexive relationships`), relationshipType.semantics.symmetry && rel.directionality === "unidirectional" && warnings.push(`Predicate "${rel.predicate}" is symmetric but may be unidirectional`), rel.isCrossLayer && (!isValidLayerName(rel.sourceLayer) || !isValidLayerName(rel.targetLayer) ? warnings.push(`Cross-layer relationship references unknown layer(s): ${rel.sourceLayer} \u2192 ${rel.targetLayer}`) : this.getLayerOrder(rel.sourceLayer, rel.targetLayer) < 0 && warnings.push(`Cross-layer relationship violates layer hierarchy: ${rel.sourceLayer} \u2192 ${rel.targetLayer}`))) : issues.push(`Unknown predicate: ${rel.predicate}`), {
+    return relationshipType ? (!relationshipType.semantics.reflexivity && rel.source === rel.target && issues.push(`Predicate "${rel.predicate}" does not support reflexive relationships`), relationshipType.semantics.symmetry && rel.directionality === "unidirectional" && warnings.push(`Predicate "${rel.predicate}" is symmetric but may be unidirectional`), rel.isCrossLayer && (!isValidLayerName(rel.sourceLayer) || !isValidLayerName(rel.targetLayer)) && warnings.push(`Cross-layer relationship references unknown layer(s): ${rel.sourceLayer} \u2192 ${rel.targetLayer}`)) : issues.push(`Unknown predicate: ${rel.predicate}`), {
       isValid: issues.length === 0,
       category: rel.category,
       predicate: rel.predicate,
@@ -166,13 +166,6 @@ class RelationshipClassifier {
     const strongPercentage = strongCount / relationships.length * 100, weakPercentage = weakCount / relationships.length * 100;
     return strongPercentage > 50 ? RelationshipStrength.Strong : weakPercentage > 50 ? RelationshipStrength.Weak : RelationshipStrength.Medium;
   }
-  /**
-   * Get layer ordering for compliance checking
-   */
-  getLayerOrder(layer1, layer2) {
-    const order1 = getLayerOrder(layer1), order2 = getLayerOrder(layer2);
-    return order1 - order2;
-  }
 }
 export {
   RelationshipClassifier,

package/dist/analysis/relationship-classifier.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/analysis/relationship-classifier.ts"],
-  "sourcesContent": ["/**\n * Relationship Classifier - Semantic classification of relationships\n *\n * Classifies relationships by semantic category, strength, and directionality.\n * Analyzes relationship patterns, validates against schemas, and detects issues.\n */\n\nimport { RelationshipCatalog, RelationshipType } from \"../core/relationship-catalog.js\";\nimport { ClassifiedRelationship } from \"../core/report-data-model.js\";\nimport { getLayerOrder, isValidLayerName } from \"../core/layers.js\";\nimport type { Relationship } from \"../types/index.js\";\n\n/**\n * Relationship strength assessment\n */\nexport enum RelationshipStrength {\n  Weak = \"weak\",\n  Medium = \"medium\",\n  Strong = \"strong\",\n}\n\n/**\n * Relationship pattern analysis result\n */\nexport interface RelationshipPattern {\n  predicate: string;\n  category: string;\n  count: number;\n  percentage: number;\n  averageStrength: RelationshipStrength;\n  examples: string[];\n}\n\n/**\n * Transitive analysis result\n */\nexport interface TransitiveAnalysis {\n  predicate: string;\n  isTransitive: boolean;\n  chains: TransitiveChain[];\n}\n\n/**\n * Transitive chain (A -> B -> C where A is implied to relate to C)\n */\nexport interface TransitiveChain {\n  elements: string[];\n  pathLength: number;\n}\n\n/**\n * Classification statistics grouped by category\n */\nexport interface CategoryStatistics {\n  category: string;\n  count: number;\n  percentage: number;\n  predicates: string[];\n  avgStrength: RelationshipStrength;\n}\n\n/**\n * Validates and analyzes semantic compliance\n */\nexport interface SemanticValidationResult {\n  isValid: boolean;\n  category: string;\n  predicate: string;\n  issues: string[];\n  warnings: string[];\n}\n\n/**\n * Relationship Classifier\n */\nexport class RelationshipClassifier {\n  private catalog: RelationshipCatalog;\n  private relationshipTypeMap: Map<string, RelationshipType> = new Map();\n  private catalogLoaded = false;\n\n  constructor(catalog: RelationshipCatalog) {\n    this.catalog = catalog;\n  }\n\n  /**\n   * Load and prepare the catalog\n   */\n  async load(): Promise<void> {\n    if (this.catalogLoaded) return;\n\n    await this.catalog.load();\n    const types = this.catalog.getAllTypes();\n\n    for (const type of types) {\n      this.relationshipTypeMap.set(type.predicate, type);\n    }\n\n    this.catalogLoaded = true;\n  }\n\n  /**\n   * Classify a single relationship with detailed semantic information\n   */\n  async classify(\n    rel: Relationship,\n    relationshipId?: string\n  ): Promise<ClassifiedRelationship> {\n    await this.load();\n\n    const sourceLayer = rel.source.split(\".\")[0];\n    const targetLayer = rel.target.split(\".\")[0];\n    const isCrossLayer = sourceLayer !== targetLayer;\n\n    const relationshipType = this.relationshipTypeMap.get(rel.predicate);\n\n    return {\n      id: relationshipId || `${rel.source}\u2192${rel.predicate}\u2192${rel.target}`,\n      source: rel.source,\n      target: rel.target,\n      predicate: rel.predicate,\n      category: relationshipType?.category || \"unknown\",\n      archimateAlignment: relationshipType?.archimateAlignment || null,\n      directionality: relationshipType?.semantics?.directionality || \"unidirectional\",\n      transitivity: relationshipType?.semantics?.transitivity || false,\n      symmetry: relationshipType?.semantics?.symmetry || false,\n      reflexivity: relationshipType?.semantics?.reflexivity,\n      sourceLayer,\n      targetLayer,\n      isCrossLayer,\n      isSpecCompliant: relationshipType !== undefined,\n    };\n  }\n\n  /**\n   * Classify a batch of relationships\n   */\n  async classifyBatch(\n    relationships: Relationship[]\n  ): Promise<ClassifiedRelationship[]> {\n    const classified: ClassifiedRelationship[] = [];\n\n    for (let i = 0; i < relationships.length; i++) {\n      const rel = relationships[i];\n      const relationshipId = `${rel.source}\u2192${rel.predicate}\u2192${rel.target}`;\n      const classifiedRel = await this.classify(rel, relationshipId);\n      classified.push(classifiedRel);\n    }\n\n    return classified;\n  }\n\n  /**\n   * Get relationship breakdown by category\n   */\n  async getCategoryBreakdown(\n    relationships: ClassifiedRelationship[]\n  ): Promise<CategoryStatistics[]> {\n    const byCategory: Record<string, ClassifiedRelationship[]> = {};\n\n    for (const rel of relationships) {\n      if (!byCategory[rel.category]) {\n        byCategory[rel.category] = [];\n      }\n      byCategory[rel.category].push(rel);\n    }\n\n    const breakdown: CategoryStatistics[] = [];\n\n    for (const [category, rels] of Object.entries(byCategory)) {\n      const predicates = Array.from(new Set(rels.map((r) => r.predicate)));\n      const avgStrength = this.calculateAverageStrength(rels);\n\n      breakdown.push({\n        category,\n        count: rels.length,\n        percentage: (rels.length / relationships.length) * 100,\n        predicates,\n        avgStrength,\n      });\n    }\n\n    return breakdown.sort((a, b) => b.count - a.count);\n  }\n\n  /**\n   * Analyze transitive relationships for a specific predicate\n   */\n  async analyzeTransitivity(\n    relationships: ClassifiedRelationship[],\n    predicate: string\n  ): Promise<TransitiveAnalysis> {\n    const type = this.relationshipTypeMap.get(predicate);\n    const isTransitive = type?.semantics.transitivity || false;\n\n    const chains: TransitiveChain[] = [];\n\n    if (isTransitive) {\n      // Build a map of relationships for this predicate\n      const relsByPredicate = relationships.filter((r) => r.predicate === predicate);\n\n      // Find chains A -> B -> C\n      for (const rel1 of relsByPredicate) {\n        for (const rel2 of relsByPredicate) {\n          if (rel1.target === rel2.source && rel1.source !== rel2.target) {\n            chains.push({\n              elements: [rel1.source, rel1.target, rel2.target],\n              pathLength: 2,\n            });\n          }\n        }\n      }\n\n      // Remove duplicate chains\n      const uniqueChains = Array.from(\n        new Map(chains.map((c) => [c.elements.join(\"\u2192\"), c])).values()\n      );\n\n      return {\n        predicate,\n        isTransitive: true,\n        chains: uniqueChains,\n      };\n    }\n\n    return {\n      predicate,\n      isTransitive: false,\n      chains: [],\n    };\n  }\n\n  /**\n   * Validate a relationship against semantic rules\n   */\n  async validateSemantics(\n    rel: ClassifiedRelationship\n  ): Promise<SemanticValidationResult> {\n    await this.load();\n\n    const issues: string[] = [];\n    const warnings: string[] = [];\n\n    const relationshipType = this.relationshipTypeMap.get(rel.predicate);\n\n    if (!relationshipType) {\n      issues.push(`Unknown predicate: ${rel.predicate}`);\n    } else {\n      // Check reflexivity\n      if (!relationshipType.semantics.reflexivity && rel.source === rel.target) {\n        issues.push(`Predicate \"${rel.predicate}\" does not support reflexive relationships`);\n      }\n\n      // Check symmetry\n      if (relationshipType.semantics.symmetry && rel.directionality === \"unidirectional\") {\n        warnings.push(`Predicate \"${rel.predicate}\" is symmetric but may be unidirectional`);\n      }\n\n      // Check layer direction for cross-layer relationships\n      if (rel.isCrossLayer) {\n        // First check if both layers are valid\n        if (!isValidLayerName(rel.sourceLayer) || !isValidLayerName(rel.targetLayer)) {\n          warnings.push(\n            `Cross-layer relationship references unknown layer(s): ${rel.sourceLayer} \u2192 ${rel.targetLayer}`\n          );\n        } else {\n          // Only check hierarchy if both layers are known\n          const layerOrder = this.getLayerOrder(rel.sourceLayer, rel.targetLayer);\n          if (layerOrder < 0) {\n            warnings.push(\n              `Cross-layer relationship violates layer hierarchy: ${rel.sourceLayer} \u2192 ${rel.targetLayer}`\n            );\n          }\n        }\n      }\n    }\n\n    return {\n      isValid: issues.length === 0,\n      category: rel.category,\n      predicate: rel.predicate,\n      issues,\n      warnings,\n    };\n  }\n\n  /**\n   * Validate a batch of relationships\n   */\n  async validateBatch(\n    relationships: ClassifiedRelationship[]\n  ): Promise<SemanticValidationResult[]> {\n    const results: SemanticValidationResult[] = [];\n\n    for (const rel of relationships) {\n      const result = await this.validateSemantics(rel);\n      results.push(result);\n    }\n\n    return results;\n  }\n\n  /**\n   * Find relationships that violate semantic rules\n   */\n  async findSemanticViolations(\n    relationships: ClassifiedRelationship[]\n  ): Promise<SemanticValidationResult[]> {\n    const validations = await this.validateBatch(relationships);\n    return validations.filter((v) => !v.isValid || v.issues.length > 0);\n  }\n\n  /**\n   * Analyze relationship patterns\n   */\n  async analyzePatterns(\n    relationships: ClassifiedRelationship[]\n  ): Promise<RelationshipPattern[]> {\n    const byPredicate: Record<string, ClassifiedRelationship[]> = {};\n\n    for (const rel of relationships) {\n      if (!byPredicate[rel.predicate]) {\n        byPredicate[rel.predicate] = [];\n      }\n      byPredicate[rel.predicate].push(rel);\n    }\n\n    const patterns: RelationshipPattern[] = [];\n\n    for (const [predicate, rels] of Object.entries(byPredicate)) {\n      const relationshipType = this.relationshipTypeMap.get(predicate);\n      const examples = rels.slice(0, 3).map((r) => `${r.source} \u2192 ${r.target}`);\n      const avgStrength = this.calculateAverageStrength(rels);\n\n      patterns.push({\n        predicate,\n        category: relationshipType?.category || \"unknown\",\n        count: rels.length,\n        percentage: (rels.length / relationships.length) * 100,\n        averageStrength: avgStrength,\n        examples,\n      });\n    }\n\n    return patterns.sort((a, b) => b.count - a.count);\n  }\n\n  /**\n   * Calculate average relationship strength\n   */\n  private calculateAverageStrength(\n    relationships: ClassifiedRelationship[]\n  ): RelationshipStrength {\n    if (relationships.length === 0) return RelationshipStrength.Medium;\n\n    let strongCount = 0;\n    let weakCount = 0;\n\n    for (const rel of relationships) {\n      // Strong: transitive, symmetric relationships\n      if (rel.transitivity && rel.symmetry) {\n        strongCount++;\n      }\n      // Weak: unidirectional, non-reflexive\n      else if (rel.directionality === \"unidirectional\" && rel.reflexivity === false) {\n        weakCount++;\n      }\n    }\n\n    const strongPercentage = (strongCount / relationships.length) * 100;\n    const weakPercentage = (weakCount / relationships.length) * 100;\n\n    if (strongPercentage > 50) {\n      return RelationshipStrength.Strong;\n    } else if (weakPercentage > 50) {\n      return RelationshipStrength.Weak;\n    }\n\n    return RelationshipStrength.Medium;\n  }\n\n  /**\n   * Get layer ordering for compliance checking\n   */\n  private getLayerOrder(layer1: string, layer2: string): number {\n    const order1 = getLayerOrder(layer1);\n    const order2 = getLayerOrder(layer2);\n    return order1 - order2;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Relationship Classifier - Semantic classification of relationships\n *\n * Classifies relationships by semantic category, strength, and directionality.\n * Analyzes relationship patterns, validates against schemas, and detects issues.\n */\n\nimport { RelationshipCatalog, RelationshipType } from \"../core/relationship-catalog.js\";\nimport { ClassifiedRelationship } from \"../core/report-data-model.js\";\nimport { isValidLayerName } from \"../core/layers.js\";\nimport type { Relationship } from \"../types/index.js\";\n\n/**\n * Relationship strength assessment\n */\nexport enum RelationshipStrength {\n  Weak = \"weak\",\n  Medium = \"medium\",\n  Strong = \"strong\",\n}\n\n/**\n * Relationship pattern analysis result\n */\nexport interface RelationshipPattern {\n  predicate: string;\n  category: string;\n  count: number;\n  percentage: number;\n  averageStrength: RelationshipStrength;\n  examples: string[];\n}\n\n/**\n * Transitive analysis result\n */\nexport interface TransitiveAnalysis {\n  predicate: string;\n  isTransitive: boolean;\n  chains: TransitiveChain[];\n}\n\n/**\n * Transitive chain (A -> B -> C where A is implied to relate to C)\n */\nexport interface TransitiveChain {\n  elements: string[];\n  pathLength: number;\n}\n\n/**\n * Classification statistics grouped by category\n */\nexport interface CategoryStatistics {\n  category: string;\n  count: number;\n  percentage: number;\n  predicates: string[];\n  avgStrength: RelationshipStrength;\n}\n\n/**\n * Validates and analyzes semantic compliance\n */\nexport interface SemanticValidationResult {\n  isValid: boolean;\n  category: string;\n  predicate: string;\n  issues: string[];\n  warnings: string[];\n}\n\n/**\n * Relationship Classifier\n */\nexport class RelationshipClassifier {\n  private catalog: RelationshipCatalog;\n  private relationshipTypeMap: Map<string, RelationshipType> = new Map();\n  private catalogLoaded = false;\n\n  constructor(catalog: RelationshipCatalog) {\n    this.catalog = catalog;\n  }\n\n  /**\n   * Load and prepare the catalog\n   */\n  async load(): Promise<void> {\n    if (this.catalogLoaded) return;\n\n    await this.catalog.load();\n    const types = this.catalog.getAllTypes();\n\n    for (const type of types) {\n      this.relationshipTypeMap.set(type.predicate, type);\n    }\n\n    this.catalogLoaded = true;\n  }\n\n  /**\n   * Classify a single relationship with detailed semantic information\n   */\n  async classify(\n    rel: Relationship,\n    relationshipId?: string\n  ): Promise<ClassifiedRelationship> {\n    await this.load();\n\n    const sourceLayer = rel.source.split(\".\")[0];\n    const targetLayer = rel.target.split(\".\")[0];\n    const isCrossLayer = sourceLayer !== targetLayer;\n\n    const relationshipType = this.relationshipTypeMap.get(rel.predicate);\n\n    return {\n      id: relationshipId || `${rel.source}\u2192${rel.predicate}\u2192${rel.target}`,\n      source: rel.source,\n      target: rel.target,\n      predicate: rel.predicate,\n      category: relationshipType?.category || \"unknown\",\n      archimateAlignment: relationshipType?.archimateAlignment || null,\n      directionality: relationshipType?.semantics?.directionality || \"unidirectional\",\n      transitivity: relationshipType?.semantics?.transitivity || false,\n      symmetry: relationshipType?.semantics?.symmetry || false,\n      reflexivity: relationshipType?.semantics?.reflexivity,\n      sourceLayer,\n      targetLayer,\n      isCrossLayer,\n      isSpecCompliant: relationshipType !== undefined,\n    };\n  }\n\n  /**\n   * Classify a batch of relationships\n   */\n  async classifyBatch(\n    relationships: Relationship[]\n  ): Promise<ClassifiedRelationship[]> {\n    const classified: ClassifiedRelationship[] = [];\n\n    for (let i = 0; i < relationships.length; i++) {\n      const rel = relationships[i];\n      const relationshipId = `${rel.source}\u2192${rel.predicate}\u2192${rel.target}`;\n      const classifiedRel = await this.classify(rel, relationshipId);\n      classified.push(classifiedRel);\n    }\n\n    return classified;\n  }\n\n  /**\n   * Get relationship breakdown by category\n   */\n  async getCategoryBreakdown(\n    relationships: ClassifiedRelationship[]\n  ): Promise<CategoryStatistics[]> {\n    const byCategory: Record<string, ClassifiedRelationship[]> = {};\n\n    for (const rel of relationships) {\n      if (!byCategory[rel.category]) {\n        byCategory[rel.category] = [];\n      }\n      byCategory[rel.category].push(rel);\n    }\n\n    const breakdown: CategoryStatistics[] = [];\n\n    for (const [category, rels] of Object.entries(byCategory)) {\n      const predicates = Array.from(new Set(rels.map((r) => r.predicate)));\n      const avgStrength = this.calculateAverageStrength(rels);\n\n      breakdown.push({\n        category,\n        count: rels.length,\n        percentage: (rels.length / relationships.length) * 100,\n        predicates,\n        avgStrength,\n      });\n    }\n\n    return breakdown.sort((a, b) => b.count - a.count);\n  }\n\n  /**\n   * Analyze transitive relationships for a specific predicate\n   */\n  async analyzeTransitivity(\n    relationships: ClassifiedRelationship[],\n    predicate: string\n  ): Promise<TransitiveAnalysis> {\n    const type = this.relationshipTypeMap.get(predicate);\n    const isTransitive = type?.semantics.transitivity || false;\n\n    const chains: TransitiveChain[] = [];\n\n    if (isTransitive) {\n      // Build a map of relationships for this predicate\n      const relsByPredicate = relationships.filter((r) => r.predicate === predicate);\n\n      // Find chains A -> B -> C\n      for (const rel1 of relsByPredicate) {\n        for (const rel2 of relsByPredicate) {\n          if (rel1.target === rel2.source && rel1.source !== rel2.target) {\n            chains.push({\n              elements: [rel1.source, rel1.target, rel2.target],\n              pathLength: 2,\n            });\n          }\n        }\n      }\n\n      // Remove duplicate chains\n      const uniqueChains = Array.from(\n        new Map(chains.map((c) => [c.elements.join(\"\u2192\"), c])).values()\n      );\n\n      return {\n        predicate,\n        isTransitive: true,\n        chains: uniqueChains,\n      };\n    }\n\n    return {\n      predicate,\n      isTransitive: false,\n      chains: [],\n    };\n  }\n\n  /**\n   * Validate a relationship against semantic rules\n   */\n  async validateSemantics(\n    rel: ClassifiedRelationship\n  ): Promise<SemanticValidationResult> {\n    await this.load();\n\n    const issues: string[] = [];\n    const warnings: string[] = [];\n\n    const relationshipType = this.relationshipTypeMap.get(rel.predicate);\n\n    if (!relationshipType) {\n      issues.push(`Unknown predicate: ${rel.predicate}`);\n    } else {\n      // Check reflexivity\n      if (!relationshipType.semantics.reflexivity && rel.source === rel.target) {\n        issues.push(`Predicate \"${rel.predicate}\" does not support reflexive relationships`);\n      }\n\n      // Check symmetry\n      if (relationshipType.semantics.symmetry && rel.directionality === \"unidirectional\") {\n        warnings.push(`Predicate \"${rel.predicate}\" is symmetric but may be unidirectional`);\n      }\n\n      // Cross-layer relationships: both layers must exist. Direction is a property of the\n      // predicate, not of the layers (spec/DESIGN_CHARTER.md), so no hierarchy check.\n      if (rel.isCrossLayer) {\n        if (!isValidLayerName(rel.sourceLayer) || !isValidLayerName(rel.targetLayer)) {\n          warnings.push(\n            `Cross-layer relationship references unknown layer(s): ${rel.sourceLayer} \u2192 ${rel.targetLayer}`\n          );\n        }\n      }\n    }\n\n    return {\n      isValid: issues.length === 0,\n      category: rel.category,\n      predicate: rel.predicate,\n      issues,\n      warnings,\n    };\n  }\n\n  /**\n   * Validate a batch of relationships\n   */\n  async validateBatch(\n    relationships: ClassifiedRelationship[]\n  ): Promise<SemanticValidationResult[]> {\n    const results: SemanticValidationResult[] = [];\n\n    for (const rel of relationships) {\n      const result = await this.validateSemantics(rel);\n      results.push(result);\n    }\n\n    return results;\n  }\n\n  /**\n   * Find relationships that violate semantic rules\n   */\n  async findSemanticViolations(\n    relationships: ClassifiedRelationship[]\n  ): Promise<SemanticValidationResult[]> {\n    const validations = await this.validateBatch(relationships);\n    return validations.filter((v) => !v.isValid || v.issues.length > 0);\n  }\n\n  /**\n   * Analyze relationship patterns\n   */\n  async analyzePatterns(\n    relationships: ClassifiedRelationship[]\n  ): Promise<RelationshipPattern[]> {\n    const byPredicate: Record<string, ClassifiedRelationship[]> = {};\n\n    for (const rel of relationships) {\n      if (!byPredicate[rel.predicate]) {\n        byPredicate[rel.predicate] = [];\n      }\n      byPredicate[rel.predicate].push(rel);\n    }\n\n    const patterns: RelationshipPattern[] = [];\n\n    for (const [predicate, rels] of Object.entries(byPredicate)) {\n      const relationshipType = this.relationshipTypeMap.get(predicate);\n      const examples = rels.slice(0, 3).map((r) => `${r.source} \u2192 ${r.target}`);\n      const avgStrength = this.calculateAverageStrength(rels);\n\n      patterns.push({\n        predicate,\n        category: relationshipType?.category || \"unknown\",\n        count: rels.length,\n        percentage: (rels.length / relationships.length) * 100,\n        averageStrength: avgStrength,\n        examples,\n      });\n    }\n\n    return patterns.sort((a, b) => b.count - a.count);\n  }\n\n  /**\n   * Calculate average relationship strength\n   */\n  private calculateAverageStrength(\n    relationships: ClassifiedRelationship[]\n  ): RelationshipStrength {\n    if (relationships.length === 0) return RelationshipStrength.Medium;\n\n    let strongCount = 0;\n    let weakCount = 0;\n\n    for (const rel of relationships) {\n      // Strong: transitive, symmetric relationships\n      if (rel.transitivity && rel.symmetry) {\n        strongCount++;\n      }\n      // Weak: unidirectional, non-reflexive\n      else if (rel.directionality === \"unidirectional\" && rel.reflexivity === false) {\n        weakCount++;\n      }\n    }\n\n    const strongPercentage = (strongCount / relationships.length) * 100;\n    const weakPercentage = (weakCount / relationships.length) * 100;\n\n    if (strongPercentage > 50) {\n      return RelationshipStrength.Strong;\n    } else if (weakPercentage > 50) {\n      return RelationshipStrength.Weak;\n    }\n\n    return RelationshipStrength.Medium;\n  }\n}\n"],
+  "mappings": "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",
   "names": ["RelationshipStrength"]
 }

package/dist/analyzers/active-analyzer.js

@@ -0,0 +1,62 @@
+import { spawnSync } from "node:child_process";
+import { AnalyzerRegistry } from "./registry.js";
+import { MappingLoader } from "./mapping-loader.js";
+import { readIndexMeta, readSession } from "./session-state.js";
+import { CLIError, ErrorCategory } from "../utils/errors.js";
+const NO_ANALYZER_SELECTED = "No analyzer selected. Run `dr analyzer discover` first.", VERIFIABLE_LAYERS = Object.freeze(["api"]);
+async function resolveAnalyzerName(projectRoot, explicit) {
+  if (explicit)
+    return explicit;
+  const session = await readSession(projectRoot);
+  if (!session)
+    throw new CLIError(NO_ANALYZER_SELECTED, ErrorCategory.USER);
+  return session.active_analyzer;
+}
+async function getAnalyzerBackend(name, suggestions) {
+  const registry = AnalyzerRegistry.getInstance();
+  await registry.initialize();
+  const backend = await registry.getAnalyzer(name);
+  if (!backend)
+    throw new CLIError(`Analyzer not found: ${name}`, ErrorCategory.NOT_FOUND, suggestions);
+  return backend;
+}
+async function analyzerHomepage(name) {
+  try {
+    return (await MappingLoader.load(name)).getAnalyzerMetadata()?.homepage || "https://github.com/search?q=codebase-memory";
+  } catch {
+    return "https://github.com/search?q=codebase-memory";
+  }
+}
+function splitVerifyLayers(requested) {
+  const layers = requested && requested.length > 0 ? [...requested] : ["api"];
+  return {
+    verifiable: layers.filter((layer) => VERIFIABLE_LAYERS.includes(layer)),
+    unsupported: layers.filter((layer) => !VERIFIABLE_LAYERS.includes(layer))
+  };
+}
+function currentGitHead(dir) {
+  try {
+    const result = spawnSync("git", ["rev-parse", "HEAD"], { cwd: dir, stdio: "pipe", encoding: "utf-8" });
+    return result.status !== 0 ? null : result.stdout.trim() || null;
+  } catch {
+    return null;
+  }
+}
+async function readIndexFreshness(projectRoot, analyzerName, codebaseRoot, gitHead = currentGitHead) {
+  const meta = await readIndexMeta(projectRoot, analyzerName);
+  if (!meta)
+    return { indexed: !1, fresh: !1 };
+  const head = gitHead(codebaseRoot);
+  return { indexed: !0, fresh: head !== null && head === meta.git_head, meta, currentGitHead: head };
+}
+export {
+  NO_ANALYZER_SELECTED,
+  VERIFIABLE_LAYERS,
+  analyzerHomepage,
+  currentGitHead,
+  getAnalyzerBackend,
+  readIndexFreshness,
+  resolveAnalyzerName,
+  splitVerifyLayers
+};
+//# sourceMappingURL=active-analyzer.js.map

package/dist/analyzers/active-analyzer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/analyzers/active-analyzer.ts"],
+  "sourcesContent": ["/**\n * Shared steps of the analyzer commands (`dr analyzer index`, `dr analyzer verify`) and the\n * codebase MCP tools (`codebase_index`, `codebase_verify`): which analyzer a project uses, its\n * backend, how to install it, which layers verify covers, and whether the index is fresh.\n */\n\nimport { spawnSync } from \"node:child_process\";\nimport { AnalyzerRegistry } from \"./registry.js\";\nimport { MappingLoader } from \"./mapping-loader.js\";\nimport { readIndexMeta, readSession } from \"./session-state.js\";\nimport type { AnalyzerBackend } from \"./base-analyzer.js\";\nimport type { IndexMeta } from \"./types.js\";\nimport { CLIError, ErrorCategory } from \"../utils/errors.js\";\n\nexport const NO_ANALYZER_SELECTED = \"No analyzer selected. Run `dr analyzer discover` first.\";\n\n/** Layers `verify` can check. Others are reported as having no verification. */\nexport const VERIFIABLE_LAYERS: readonly string[] = Object.freeze([\"api\"]);\n\n/** The analyzer to use: `explicit`, else the one selected for the project (session.json). */\nexport async function resolveAnalyzerName(projectRoot: string, explicit?: string): Promise<string> {\n  if (explicit) return explicit;\n  const session = await readSession(projectRoot);\n  if (!session) {\n    throw new CLIError(NO_ANALYZER_SELECTED, ErrorCategory.USER);\n  }\n  return session.active_analyzer;\n}\n\n/** The registered backend for `name`. Throws a not-found CLIError, with `suggestions`, if none. */\nexport async function getAnalyzerBackend(name: string, suggestions?: string[]): Promise<AnalyzerBackend> {\n  const registry = AnalyzerRegistry.getInstance();\n  await registry.initialize();\n  const backend = await registry.getAnalyzer(name);\n  if (!backend) {\n    throw new CLIError(`Analyzer not found: ${name}`, ErrorCategory.NOT_FOUND, suggestions);\n  }\n  return backend;\n}\n\n/** The analyzer's homepage, from its mapping metadata. */\nexport async function analyzerHomepage(name: string): Promise<string> {\n  try {\n    const mapper = await MappingLoader.load(name);\n    return mapper.getAnalyzerMetadata()?.homepage || \"https://github.com/search?q=codebase-memory\";\n  } catch {\n    return \"https://github.com/search?q=codebase-memory\";\n  }\n}\n\n/** Splits requested layers into the ones verify checks and the ones it has no check for. */\nexport function splitVerifyLayers(requested: readonly string[] | undefined): {\n  verifiable: string[];\n  unsupported: string[];\n} {\n  const layers = requested && requested.length > 0 ? [...requested] : [\"api\"];\n  return {\n    verifiable: layers.filter((layer) => VERIFIABLE_LAYERS.includes(layer)),\n    unsupported: layers.filter((layer) => !VERIFIABLE_LAYERS.includes(layer)),\n  };\n}\n\n/** The git HEAD of `dir`, or null when it isn't a git repository or git fails. */\nexport function currentGitHead(dir: string): string | null {\n  try {\n    const result = spawnSync(\"git\", [\"rev-parse\", \"HEAD\"], { cwd: dir, stdio: \"pipe\", encoding: \"utf-8\" });\n    if (result.status !== 0) return null;\n    return result.stdout.trim() || null;\n  } catch {\n    return null;\n  }\n}\n\nexport type IndexFreshness =\n  | { indexed: false; fresh: false }\n  | {\n      indexed: true;\n      /** The index was taken at the code's current git HEAD. */\n      fresh: boolean;\n      meta: IndexMeta;\n      /** The code's current git HEAD; null when it can't be read (the index then counts as stale). */\n      currentGitHead: string | null;\n    };\n\n/**\n * Whether the project has an index from `analyzerName`, and whether it was taken at the code's\n * current git HEAD. Reads `.dr/analyzers/{analyzer}/index-meta.json` and runs git; it does not\n * start the analyzer. The same test as the analyzer's own `status()`.\n */\nexport async function readIndexFreshness(\n  projectRoot: string,\n  analyzerName: string,\n  codebaseRoot: string,\n  gitHead: (dir: string) => string | null = currentGitHead\n): Promise<IndexFreshness> {\n  const meta = await readIndexMeta(projectRoot, analyzerName);\n  if (!meta) return { indexed: false, fresh: false };\n  const head = gitHead(codebaseRoot);\n  return { indexed: true, fresh: head !== null && head === meta.git_head, meta, currentGitHead: head };\n}\n"],
+  "mappings": "AAMA,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB;AACjC,SAAS,qBAAqB;AAC9B,SAAS,eAAe,mBAAmB;AAG3C,SAAS,UAAU,qBAAqB;AAEjC,MAAM,uBAAuB,2DAGvB,oBAAuC,OAAO,OAAO,CAAC,KAAK,CAAC;AAGzE,eAAsB,oBAAoB,aAAqB,UAAiB;AAC9E,MAAI;AAAU,WAAO;AACrB,QAAM,UAAU,MAAM,YAAY,WAAW;AAC7C,MAAI,CAAC;AACH,UAAM,IAAI,SAAS,sBAAsB,cAAc,IAAI;AAE7D,SAAO,QAAQ;AACjB;AAGA,eAAsB,mBAAmB,MAAc,aAAsB;AAC3E,QAAM,WAAW,iBAAiB,YAAW;AAC7C,QAAM,SAAS,WAAU;AACzB,QAAM,UAAU,MAAM,SAAS,YAAY,IAAI;AAC/C,MAAI,CAAC;AACH,UAAM,IAAI,SAAS,uBAAuB,IAAI,IAAI,cAAc,WAAW,WAAW;AAExF,SAAO;AACT;AAGA,eAAsB,iBAAiB,MAAY;AACjD,MAAI;AAEF,YADe,MAAM,cAAc,KAAK,IAAI,GAC9B,oBAAmB,GAAI,YAAY;EACnD,QAAQ;AACN,WAAO;EACT;AACF;AAGM,SAAU,kBAAkB,WAAwC;AAIxE,QAAM,SAAS,aAAa,UAAU,SAAS,IAAI,CAAC,GAAG,SAAS,IAAI,CAAC,KAAK;AAC1E,SAAO;IACL,YAAY,OAAO,OAAO,CAAC,UAAU,kBAAkB,SAAS,KAAK,CAAC;IACtE,aAAa,OAAO,OAAO,CAAC,UAAU,CAAC,kBAAkB,SAAS,KAAK,CAAC;;AAE5E;AAGM,SAAU,eAAe,KAAW;AACxC,MAAI;AACF,UAAM,SAAS,UAAU,OAAO,CAAC,aAAa,MAAM,GAAG,EAAE,KAAK,KAAK,OAAO,QAAQ,UAAU,QAAO,CAAE;AACrG,WAAI,OAAO,WAAW,IAAU,OACzB,OAAO,OAAO,KAAI,KAAM;EACjC,QAAQ;AACN,WAAO;EACT;AACF;AAkBA,eAAsB,mBACpB,aACA,cACA,cACA,UAA0C,gBAAc;AAExD,QAAM,OAAO,MAAM,cAAc,aAAa,YAAY;AAC1D,MAAI,CAAC;AAAM,WAAO,EAAE,SAAS,IAAO,OAAO,GAAK;AAChD,QAAM,OAAO,QAAQ,YAAY;AACjC,SAAO,EAAE,SAAS,IAAM,OAAO,SAAS,QAAQ,SAAS,KAAK,UAAU,MAAM,gBAAgB,KAAI;AACpG;",
+  "names": []
+}

package/dist/analyzers/call-graph-utils.js

@@ -1,4 +1,4 @@
-import { relative } from "node:path";
+import { isAbsolute, relative } from "node:path";
 function isEdgeType(value) {
   return value === "CALLS" || value === "HTTP_CALLS" || value === "HANDLES";
 }
@@ -11,7 +11,7 @@ function shapeCallGraphNode(responseNode, projectRoot) {
     try {
       if (typeof sourceFile != "string" || typeof projectRoot != "string")
         throw new TypeError(`Invalid path types: sourceFile=${typeof sourceFile}, projectRoot=${typeof projectRoot}`);
-      sourceFile = relative(projectRoot, sourceFile);
+      sourceFile = isAbsolute(sourceFile) ? relative(projectRoot, sourceFile) : sourceFile;
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.warn(`Warning: Failed to compute relative path for "${sourceFile}": ${errorMessage}`);

package/dist/analyzers/call-graph-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/analyzers/call-graph-utils.ts"],
-  "sourcesContent": ["/**\n * Utilities for call graph analysis\n */\n\nimport { relative } from \"node:path\";\nimport type { CallGraphNode } from \"./types.js\";\n\n/**\n * Valid edge types for call graph edges\n */\ntype EdgeType = \"CALLS\" | \"HTTP_CALLS\" | \"HANDLES\";\n\n/**\n * Type guard to ensure a value is a valid edge type\n */\nfunction isEdgeType(value: unknown): value is EdgeType {\n  return value === \"CALLS\" || value === \"HTTP_CALLS\" || value === \"HANDLES\";\n}\n\n/**\n * Clamp depth to valid range (default 3, min 0, max 10)\n */\nexport function clampDepth(depth: number | undefined): number {\n  return Math.max(Math.min(depth ?? 3, 10), 0);\n}\n\n/**\n * Shape raw response node to CallGraphNode\n */\nexport function shapeCallGraphNode(\n  responseNode: any,\n  projectRoot?: string\n): CallGraphNode {\n  // Extract source file and compute relative path if projectRoot provided\n  let sourceFile = responseNode.file_path || responseNode.source_file || \"\";\n  if (sourceFile && projectRoot) {\n    try {\n      // Validate inputs are strings before calling path.relative()\n      if (typeof sourceFile !== \"string\" || typeof projectRoot !== \"string\") {\n        throw new TypeError(\n          `Invalid path types: sourceFile=${typeof sourceFile}, projectRoot=${typeof projectRoot}`\n        );\n      }\n      sourceFile = relative(projectRoot, sourceFile);\n    } catch (error) {\n      // Log the error but keep the original path\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      console.warn(\n        `Warning: Failed to compute relative path for \"${sourceFile}\": ${errorMessage}`\n      );\n    }\n  }\n\n  return {\n    qualified_name: responseNode.qualified_name || responseNode.id,\n    source_file: sourceFile,\n    source_symbol: responseNode.source_symbol || responseNode.id || \"\",\n    depth: typeof responseNode.depth === \"number\" ? responseNode.depth : 0,\n    edge_type: \"CALLS\",\n  };\n}\n\n/**\n * Determine edge type based on node depth and edges list\n */\nexport function determineEdgeType(\n  nodeDepth: number,\n  edges: Array<{ from_node: string; to_node: string; type?: string }>,\n  targetNodeQualifiedName: string,\n  validEdgeTypes: string[] = [\"CALLS\", \"HTTP_CALLS\", \"HANDLES\"]\n): EdgeType {\n  const defaultEdgeType = validEdgeTypes[0] || \"CALLS\";\n\n  // For root nodes (depth 0), always use default\n  if (nodeDepth === 0) {\n    // Validate that default is a known edge type\n    if (!isEdgeType(defaultEdgeType)) {\n      return \"CALLS\"; // Fallback to safe default\n    }\n    return defaultEdgeType;\n  }\n\n  // For non-root nodes, find incoming edge\n  const incomingEdge = edges.find(\n    (edge) => edge.to_node === targetNodeQualifiedName\n  );\n  if (incomingEdge && incomingEdge.type && validEdgeTypes.includes(incomingEdge.type)) {\n    // Validate that the edge type is known\n    if (isEdgeType(incomingEdge.type)) {\n      return incomingEdge.type;\n    }\n  }\n\n  // Return validated default\n  if (!isEdgeType(defaultEdgeType)) {\n    return \"CALLS\"; // Fallback to safe default\n  }\n  return defaultEdgeType;\n}\n"],
-  "mappings": "AAIA,SAAS,gBAAgB;AAWzB,SAAS,WAAW,OAAc;AAChC,SAAO,UAAU,WAAW,UAAU,gBAAgB,UAAU;AAClE;AAKM,SAAU,WAAW,OAAyB;AAClD,SAAO,KAAK,IAAI,KAAK,IAAI,SAAS,GAAG,EAAE,GAAG,CAAC;AAC7C;AAKM,SAAU,mBACd,cACA,aAAoB;AAGpB,MAAI,aAAa,aAAa,aAAa,aAAa,eAAe;AACvE,MAAI,cAAc;AAChB,QAAI;AAEF,UAAI,OAAO,cAAe,YAAY,OAAO,eAAgB;AAC3D,cAAM,IAAI,UACR,kCAAkC,OAAO,UAAU,iBAAiB,OAAO,WAAW,EAAE;AAG5F,mBAAa,SAAS,aAAa,UAAU;IAC/C,SAAS,OAAO;AAEd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,cAAQ,KACN,iDAAiD,UAAU,MAAM,YAAY,EAAE;IAEnF;AAGF,SAAO;IACL,gBAAgB,aAAa,kBAAkB,aAAa;IAC5D,aAAa;IACb,eAAe,aAAa,iBAAiB,aAAa,MAAM;IAChE,OAAO,OAAO,aAAa,SAAU,WAAW,aAAa,QAAQ;IACrE,WAAW;;AAEf;AAKM,SAAU,kBACd,WACA,OACA,yBACA,iBAA2B,CAAC,SAAS,cAAc,SAAS,GAAC;AAE7D,QAAM,kBAAkB,eAAe,CAAC,KAAK;AAG7C,MAAI,cAAc;AAEhB,WAAK,WAAW,eAAe,IAGxB,kBAFE;AAMX,QAAM,eAAe,MAAM,KACzB,CAAC,SAAS,KAAK,YAAY,uBAAuB;AAEpD,SAAI,gBAAgB,aAAa,QAAQ,eAAe,SAAS,aAAa,IAAI,KAE5E,WAAW,aAAa,IAAI,IACvB,aAAa,OAKnB,WAAW,eAAe,IAGxB,kBAFE;AAGX;",
+  "sourcesContent": ["/**\n * Utilities for call graph analysis\n */\n\nimport { isAbsolute, relative } from \"node:path\";\nimport type { CallGraphNode } from \"./types.js\";\n\n/**\n * Valid edge types for call graph edges\n */\ntype EdgeType = \"CALLS\" | \"HTTP_CALLS\" | \"HANDLES\";\n\n/**\n * Type guard to ensure a value is a valid edge type\n */\nfunction isEdgeType(value: unknown): value is EdgeType {\n  return value === \"CALLS\" || value === \"HTTP_CALLS\" || value === \"HANDLES\";\n}\n\n/**\n * Clamp depth to valid range (default 3, min 0, max 10)\n */\nexport function clampDepth(depth: number | undefined): number {\n  return Math.max(Math.min(depth ?? 3, 10), 0);\n}\n\n/**\n * Shape raw response node to CallGraphNode\n */\nexport function shapeCallGraphNode(\n  responseNode: any,\n  projectRoot?: string\n): CallGraphNode {\n  // Extract source file and compute relative path if projectRoot provided\n  let sourceFile = responseNode.file_path || responseNode.source_file || \"\";\n  if (sourceFile && projectRoot) {\n    try {\n      // Validate inputs are strings before calling path.relative()\n      if (typeof sourceFile !== \"string\" || typeof projectRoot !== \"string\") {\n        throw new TypeError(\n          `Invalid path types: sourceFile=${typeof sourceFile}, projectRoot=${typeof projectRoot}`\n        );\n      }\n      // CBM paths are repository-relative; only absolute ones need relativising\n      sourceFile = isAbsolute(sourceFile) ? relative(projectRoot, sourceFile) : sourceFile;\n    } catch (error) {\n      // Log the error but keep the original path\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      console.warn(\n        `Warning: Failed to compute relative path for \"${sourceFile}\": ${errorMessage}`\n      );\n    }\n  }\n\n  return {\n    qualified_name: responseNode.qualified_name || responseNode.id,\n    source_file: sourceFile,\n    source_symbol: responseNode.source_symbol || responseNode.id || \"\",\n    depth: typeof responseNode.depth === \"number\" ? responseNode.depth : 0,\n    edge_type: \"CALLS\",\n  };\n}\n\n/**\n * Determine edge type based on node depth and edges list\n */\nexport function determineEdgeType(\n  nodeDepth: number,\n  edges: Array<{ from_node: string; to_node: string; type?: string }>,\n  targetNodeQualifiedName: string,\n  validEdgeTypes: string[] = [\"CALLS\", \"HTTP_CALLS\", \"HANDLES\"]\n): EdgeType {\n  const defaultEdgeType = validEdgeTypes[0] || \"CALLS\";\n\n  // For root nodes (depth 0), always use default\n  if (nodeDepth === 0) {\n    // Validate that default is a known edge type\n    if (!isEdgeType(defaultEdgeType)) {\n      return \"CALLS\"; // Fallback to safe default\n    }\n    return defaultEdgeType;\n  }\n\n  // For non-root nodes, find incoming edge\n  const incomingEdge = edges.find(\n    (edge) => edge.to_node === targetNodeQualifiedName\n  );\n  if (incomingEdge && incomingEdge.type && validEdgeTypes.includes(incomingEdge.type)) {\n    // Validate that the edge type is known\n    if (isEdgeType(incomingEdge.type)) {\n      return incomingEdge.type;\n    }\n  }\n\n  // Return validated default\n  if (!isEdgeType(defaultEdgeType)) {\n    return \"CALLS\"; // Fallback to safe default\n  }\n  return defaultEdgeType;\n}\n"],
+  "mappings": "AAIA,SAAS,YAAY,gBAAgB;AAWrC,SAAS,WAAW,OAAc;AAChC,SAAO,UAAU,WAAW,UAAU,gBAAgB,UAAU;AAClE;AAKM,SAAU,WAAW,OAAyB;AAClD,SAAO,KAAK,IAAI,KAAK,IAAI,SAAS,GAAG,EAAE,GAAG,CAAC;AAC7C;AAKM,SAAU,mBACd,cACA,aAAoB;AAGpB,MAAI,aAAa,aAAa,aAAa,aAAa,eAAe;AACvE,MAAI,cAAc;AAChB,QAAI;AAEF,UAAI,OAAO,cAAe,YAAY,OAAO,eAAgB;AAC3D,cAAM,IAAI,UACR,kCAAkC,OAAO,UAAU,iBAAiB,OAAO,WAAW,EAAE;AAI5F,mBAAa,WAAW,UAAU,IAAI,SAAS,aAAa,UAAU,IAAI;IAC5E,SAAS,OAAO;AAEd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,cAAQ,KACN,iDAAiD,UAAU,MAAM,YAAY,EAAE;IAEnF;AAGF,SAAO;IACL,gBAAgB,aAAa,kBAAkB,aAAa;IAC5D,aAAa;IACb,eAAe,aAAa,iBAAiB,aAAa,MAAM;IAChE,OAAO,OAAO,aAAa,SAAU,WAAW,aAAa,QAAQ;IACrE,WAAW;;AAEf;AAKM,SAAU,kBACd,WACA,OACA,yBACA,iBAA2B,CAAC,SAAS,cAAc,SAAS,GAAC;AAE7D,QAAM,kBAAkB,eAAe,CAAC,KAAK;AAG7C,MAAI,cAAc;AAEhB,WAAK,WAAW,eAAe,IAGxB,kBAFE;AAMX,QAAM,eAAe,MAAM,KACzB,CAAC,SAAS,KAAK,YAAY,uBAAuB;AAEpD,SAAI,gBAAgB,aAAa,QAAQ,eAAe,SAAS,aAAa,IAAI,KAE5E,WAAW,aAAa,IAAI,IACvB,aAAa,OAKnB,WAAW,eAAe,IAGxB,kBAFE;AAGX;",
   "names": []
 }

package/dist/analyzers/cards/build.js

@@ -0,0 +1,191 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+const CARD_VERSION = 1, CARD_LABELS = Object.freeze(["Class", "Interface", "Function", "Method", "Module", "Route"]), CARD_FIELDS = Object.freeze({
+  Class: ["docstring", "base_classes", "is_exported", "is_entry_point", "complexity", "start_line", "end_line"],
+  Interface: ["docstring", "base_classes", "is_exported", "start_line", "end_line"],
+  Function: ["signature", "docstring", "is_exported", "is_entry_point", "complexity", "return_type", "start_line", "end_line"],
+  Method: ["signature", "docstring", "parent_class", "is_exported", "is_entry_point", "complexity", "return_type", "start_line", "end_line"],
+  Module: ["is_entry_point", "is_exported", "lines", "start_line", "end_line"],
+  Route: ["method", "source"],
+  Type: ["docstring", "is_exported", "start_line", "end_line"],
+  Enum: ["docstring", "is_exported", "start_line", "end_line"],
+  Trait: ["docstring", "is_exported", "start_line", "end_line"],
+  Struct: ["docstring", "is_exported", "start_line", "end_line"]
+}), SOURCE_EXTENSIONS = Object.freeze([
+  "ts",
+  "tsx",
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  "py",
+  "go",
+  "java",
+  "kt",
+  "rs",
+  "cs",
+  "php",
+  "rb",
+  "swift",
+  "scala",
+  "vue",
+  "svelte"
+]), SOURCE_EXT = new RegExp(`\\.(${SOURCE_EXTENSIONS.join("|")})$`, "i"), VENDOR_EXCLUDE = /(^|\/)(dist|build|node_modules|vendor|\.venv|venv|__pycache__)(\/|$)/, SAMPLE_EXCLUDE = /(^|\/)(tests?|__tests__|fixtures?|__fixtures__|test-[^/]*|examples?|scripts|dist|node_modules|\.venv|venv)(\/|$)|\.(test|spec)\.[cm]?[jt]sx?$|(^|\/)test_[^/]*\.py$|(^|\/)conftest\.py$/;
+function cardId(scope, qualifiedName) {
+  return createHash("sha1").update(`${scope}:${qualifiedName}`).digest("hex").slice(0, 12);
+}
+function isCandidate(node, label, exclude = VENDOR_EXCLUDE) {
+  return label === "Route" ? !/^__route__[A-Z]+__\//.test(node.name) || /\.(ts|js|py|json)$/.test(node.name) ? !1 : !(node.file_path && exclude.test(node.file_path)) : !(!node.file_path || !SOURCE_EXT.test(node.file_path) || node.file_path.startsWith("<") || exclude.test(node.file_path) || label === "Method" && /^(constructor|__init__|__str__|__repr__)$/.test(node.name) || label === "Function" && /^(anonymous|arrow|lambda|<anonymous>)$/i.test(node.name));
+}
+function lineRange(node) {
+  const s = node.start_line != null ? Number(node.start_line) : null, e = node.end_line != null ? Number(node.end_line) : null;
+  if (s != null && !Number.isNaN(s))
+    return { start: s, end: e != null && !Number.isNaN(e) ? e : null };
+  const m = /^(\d+)-(\d+)$/.exec(String(node.lines ?? ""));
+  return m ? { start: Number(m[1]), end: Number(m[2]) } : { start: null, end: null };
+}
+function strOrNull(v) {
+  return typeof v == "string" && v.trim() ? v : null;
+}
+function boolOrNull(v) {
+  return typeof v == "boolean" ? v : null;
+}
+function numOrNull(v) {
+  return typeof v == "number" ? v : null;
+}
+function strArray(v) {
+  return Array.isArray(v) ? v.filter((x) => typeof x == "string") : typeof v == "string" && v.trim() ? v.split(",").map((s) => s.trim()).filter(Boolean) : [];
+}
+class CardBuilder {
+  graph;
+  edges;
+  options;
+  sourceLines;
+  handlerCache = /* @__PURE__ */ new Map();
+  fileLines = /* @__PURE__ */ new Map();
+  root;
+  constructor(graph, edges, options) {
+    this.graph = graph, this.edges = edges, this.options = options, this.sourceLines = options.sourceLines ?? 120, this.root = options.sourceRoot ? path.resolve(options.sourceRoot) : null;
+  }
+  /** A file's lines, read once; null when it is outside the root or unreadable. */
+  lines(file) {
+    let cached = this.fileLines.get(file);
+    if (!cached) {
+      const abs = path.resolve(this.root, file);
+      cached = abs === this.root || !abs.startsWith(this.root + path.sep) ? Promise.resolve(null) : readFile(abs, "utf-8").then((text) => text.split(`
+`), () => null), this.fileLines.set(file, cached);
+    }
+    return cached;
+  }
+  /**
+   * A symbol's source: its line range read from disk when the builder has a root and the node
+   * has lines in a readable file, else CBM's snippet.
+   */
+  async sourceOf(qn, node) {
+    if (this.root && node && typeof node.file_path == "string" && node.file_path) {
+      const { start, end } = lineRange(node);
+      if (start !== null && end !== null && start >= 1 && end >= start) {
+        const lines = await this.lines(node.file_path);
+        if (lines && end <= lines.length)
+          return lines.slice(start - 1, end).join(`
+`);
+      }
+    }
+    return (await this.graph.snippet(qn))?.source ?? null;
+  }
+  /** Strip the project prefix from a qualified name. */
+  shortQn(qn) {
+    const p = this.graph.project;
+    return qn.startsWith(p + ".") ? qn.slice(p.length + 1) : qn;
+  }
+  /**
+   * A route's handler when no HANDLES edge names one: the function, in a file with an edge into
+   * the route, whose source quotes the route's path (or calls the route's method with it).
+   */
+  async resolveRouteHandler(routeName) {
+    const pathPart = routeName.replace(/^__route__[A-Z]+__/, "").replace(/\{\}.*$/, ""), method = (/^__route__([A-Z]+)__/.exec(routeName)?.[1] ?? "").toLowerCase(), files = /* @__PURE__ */ new Set();
+    for (const qn of this.edges.routeCallers.get(routeName) ?? []) {
+      const f = this.edges.qnFile.get(qn);
+      f && files.add(f);
+    }
+    for (const file of files) {
+      let fns = this.handlerCache.get(file);
+      if (!fns) {
+        fns = [];
+        for (const n of await this.graph.search("Function", file, ["start_line"])) {
+          const source = await this.sourceOf(n.qualified_name, n);
+          source && fns.push({ qn: n.qualified_name, source });
+        }
+        this.handlerCache.set(file, fns);
+      }
+      const hit = fns.find((f) => f.source.includes(`"${pathPart}`) || f.source.includes(`'${pathPart}`)) ?? fns.find((f) => method && f.source.includes(`.${method}(`) && f.source.includes(pathPart));
+      if (hit)
+        return hit.qn;
+    }
+    return null;
+  }
+  cut(source) {
+    const all = source.split(`
+`);
+    return all.length > this.sourceLines ? { source: all.slice(0, this.sourceLines).join(`
+`), total: all.length, truncated: !0 } : { source, total: all.length, truncated: !1 };
+  }
+  async build(node) {
+    const { edges } = this, qn = node.qualified_name, short = (s) => this.shortQn(s), { start, end } = lineRange(node);
+    let source = null, totalLines = null, truncated = !1, routeHandlerQn = null;
+    if (node.label !== "Route") {
+      const text = await this.sourceOf(qn, node);
+      text && ({ source, total: totalLines, truncated } = this.cut(text));
+    } else if (routeHandlerQn = (edges.routeHandlers.get(qn) ?? []).filter((h) => edges.qnFile.has(h))[0] ?? await this.resolveRouteHandler(qn), routeHandlerQn) {
+      const text = await this.sourceOf(routeHandlerQn, null);
+      text && ({ source, total: totalLines, truncated } = this.cut(text));
+    }
+    const callers = (edges.callers.get(qn) ?? []).map(short), callees = (edges.callees.get(qn) ?? []).map(short);
+    return {
+      // Hashed on the full qualified name, as the labelled card sets were.
+      id: cardId(this.options.scope, qn),
+      label: node.label,
+      name: node.name,
+      qualified_name: short(qn),
+      file_path: node.file_path || (routeHandlerQn ? edges.qnFile.get(routeHandlerQn) ?? null : null),
+      start_line: start,
+      end_line: end,
+      signature: strOrNull(node.signature),
+      docstring: strOrNull(node.docstring),
+      is_exported: boolOrNull(node.is_exported),
+      is_entry_point: boolOrNull(node.is_entry_point),
+      complexity: numOrNull(node.complexity),
+      parent_class: node.parent_class ? short(String(node.parent_class)) : null,
+      base_classes: strArray(node.base_classes),
+      return_type: strOrNull(node.return_type),
+      callers: (node.label === "Route" && routeHandlerQn ? [short(routeHandlerQn), ...callers] : callers).slice(0, 12),
+      callees: callees.slice(0, 12),
+      callers_total: callers.length,
+      callees_total: callees.length,
+      imports: (node.file_path ? edges.importsByFile.get(node.file_path) ?? [] : []).slice(0, 15),
+      env_vars: edges.envVars.get(qn) ?? [],
+      routes_handled: node.label === "Route" ? [node.name.replace(/^__route__[A-Z]+__/, "")] : edges.handles.get(qn) ?? [],
+      http_calls: (edges.httpCalls.get(qn) ?? []).slice(0, 8),
+      inherits: (edges.inherits.get(qn) ?? []).map(short),
+      implements: (edges.implements.get(qn) ?? []).map(short),
+      route_method: node.label === "Route" ? strOrNull(node.method) : null,
+      source,
+      source_lines_total: totalLines,
+      source_truncated: truncated
+    };
+  }
+}
+export {
+  CARD_FIELDS,
+  CARD_LABELS,
+  CARD_VERSION,
+  CardBuilder,
+  SAMPLE_EXCLUDE,
+  SOURCE_EXT,
+  SOURCE_EXTENSIONS,
+  VENDOR_EXCLUDE,
+  cardId,
+  isCandidate
+};
+//# sourceMappingURL=build.js.map

package/dist/analyzers/cards/build.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/analyzers/cards/build.ts"],
+  "sourcesContent": ["/**\n * Build symbol cards from a CBM project.\n *\n * The classify-eval harness (cli/scripts/classify-eval/) builds its labelled card sets with this\n * module, so its accuracy numbers measure the code `dr analyzer classify` runs.\n */\nimport { createHash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { EdgeIndex } from \"./edge-index.js\";\nimport type { CardGraph, GraphNode, SymbolCard } from \"./types.js\";\n\n/**\n * Version of the card's fields and how they are derived. Bump it when a change would make a card\n * built now differ from one built before for the same graph, so stored cards and their\n * classifications can be told apart.\n */\nexport const CARD_VERSION = 1;\n\n/** CBM labels that become cards in the harness's card sets (classify adds the rules' labels). */\nexport const CARD_LABELS: readonly string[] = Object.freeze([\"Class\", \"Interface\", \"Function\", \"Method\", \"Module\", \"Route\"]);\n\n/** Extra search_graph fields each label's card reads. */\nexport const CARD_FIELDS: Readonly<Record<string, string[]>> = Object.freeze({\n  Class: [\"docstring\", \"base_classes\", \"is_exported\", \"is_entry_point\", \"complexity\", \"start_line\", \"end_line\"],\n  Interface: [\"docstring\", \"base_classes\", \"is_exported\", \"start_line\", \"end_line\"],\n  Function: [\"signature\", \"docstring\", \"is_exported\", \"is_entry_point\", \"complexity\", \"return_type\", \"start_line\", \"end_line\"],\n  Method: [\"signature\", \"docstring\", \"parent_class\", \"is_exported\", \"is_entry_point\", \"complexity\", \"return_type\", \"start_line\", \"end_line\"],\n  Module: [\"is_entry_point\", \"is_exported\", \"lines\", \"start_line\", \"end_line\"],\n  Route: [\"method\", \"source\"],\n  Type: [\"docstring\", \"is_exported\", \"start_line\", \"end_line\"],\n  Enum: [\"docstring\", \"is_exported\", \"start_line\", \"end_line\"],\n  Trait: [\"docstring\", \"is_exported\", \"start_line\", \"end_line\"],\n  Struct: [\"docstring\", \"is_exported\", \"start_line\", \"end_line\"],\n});\n\n/** Source file extensions: files whose symbols become cards. */\nexport const SOURCE_EXTENSIONS: readonly string[] = Object.freeze([\n  \"ts\", \"tsx\", \"js\", \"jsx\", \"mjs\", \"cjs\", \"py\", \"go\", \"java\", \"kt\", \"rs\", \"cs\", \"php\", \"rb\", \"swift\", \"scala\", \"vue\", \"svelte\",\n]);\n\nexport const SOURCE_EXT = new RegExp(`\\\\.(${SOURCE_EXTENSIONS.join(\"|\")})$`, \"i\");\n\n/** Build output and vendored dependencies: never cards. The default for `dr analyzer classify`. */\nexport const VENDOR_EXCLUDE = /(^|\\/)(dist|build|node_modules|vendor|\\.venv|venv|__pycache__)(\\/|$)/;\n\n/**\n * The harness's sampling exclusion: vendor paths plus tests, fixtures, examples and scripts, so\n * labelled card sets are about application code. Tests are not excluded in production, where the\n * Tier-0 test rules file them in the testing layer.\n */\nexport const SAMPLE_EXCLUDE =\n  /(^|\\/)(tests?|__tests__|fixtures?|__fixtures__|test-[^/]*|examples?|scripts|dist|node_modules|\\.venv|venv)(\\/|$)|\\.(test|spec)\\.[cm]?[jt]sx?$|(^|\\/)test_[^/]*\\.py$|(^|\\/)conftest\\.py$/;\n\n/** Stable card id for a symbol (full, project-prefixed qualified name) within a scope. */\nexport function cardId(scope: string, qualifiedName: string): string {\n  return createHash(\"sha1\").update(`${scope}:${qualifiedName}`).digest(\"hex\").slice(0, 12);\n}\n\n/**\n * Whether a node of this label becomes a card: a route with a path, or a symbol in a source file\n * outside `exclude`, leaving out constructors, dunder methods and anonymous functions.\n */\nexport function isCandidate(node: GraphNode, label: string, exclude: RegExp = VENDOR_EXCLUDE): boolean {\n  if (label === \"Route\") {\n    if (!/^__route__[A-Z]+__\\//.test(node.name) || /\\.(ts|js|py|json)$/.test(node.name)) return false;\n    return !(node.file_path && exclude.test(node.file_path));\n  }\n  if (!node.file_path) return false;\n  if (!SOURCE_EXT.test(node.file_path) || node.file_path.startsWith(\"<\")) return false;\n  if (exclude.test(node.file_path)) return false;\n  if (label === \"Method\" && /^(constructor|__init__|__str__|__repr__)$/.test(node.name)) return false;\n  if (label === \"Function\" && /^(anonymous|arrow|lambda|<anonymous>)$/i.test(node.name)) return false;\n  return true;\n}\n\nfunction lineRange(node: GraphNode): { start: number | null; end: number | null } {\n  const s = node.start_line != null ? Number(node.start_line) : null;\n  const e = node.end_line != null ? Number(node.end_line) : null;\n  if (s != null && !Number.isNaN(s)) return { start: s, end: e != null && !Number.isNaN(e) ? e : null };\n  const m = /^(\\d+)-(\\d+)$/.exec(String(node.lines ?? \"\"));\n  return m ? { start: Number(m[1]), end: Number(m[2]) } : { start: null, end: null };\n}\n\nfunction strOrNull(v: unknown): string | null {\n  return typeof v === \"string\" && v.trim() ? v : null;\n}\nfunction boolOrNull(v: unknown): boolean | null {\n  return typeof v === \"boolean\" ? v : null;\n}\nfunction numOrNull(v: unknown): number | null {\n  return typeof v === \"number\" ? v : null;\n}\nfunction strArray(v: unknown): string[] {\n  if (Array.isArray(v)) return v.filter((x): x is string => typeof x === \"string\");\n  if (typeof v === \"string\" && v.trim()) return v.split(\",\").map((s) => s.trim()).filter(Boolean);\n  return [];\n}\n\nexport interface CardBuilderOptions {\n  /** Scope for card ids: a corpus name in the harness, the CBM project in production. */\n  scope: string;\n  /** Source lines kept per card (default 120). */\n  sourceLines?: number;\n  /**\n   * Absolute path of the indexed codebase. When set, a symbol's source is read from its file by\n   * the node's line range, one read per file; CBM's `get_code_snippet` (full source, at most 500\n   * lines) is the fallback. Without it every card costs a snippet call, about 15 ms each.\n   */\n  sourceRoot?: string;\n}\n\n/**\n * Builds cards for one project. Holds the per-file handler cache that route-handler resolution\n * fills, so build every card of a run with the same builder.\n */\nexport class CardBuilder {\n  private readonly sourceLines: number;\n  private readonly handlerCache = new Map<string, Array<{ qn: string; source: string }>>();\n  private readonly fileLines = new Map<string, Promise<string[] | null>>();\n  private readonly root: string | null;\n\n  constructor(\n    private readonly graph: CardGraph,\n    private readonly edges: EdgeIndex,\n    private readonly options: CardBuilderOptions\n  ) {\n    this.sourceLines = options.sourceLines ?? 120;\n    this.root = options.sourceRoot ? path.resolve(options.sourceRoot) : null;\n  }\n\n  /** A file's lines, read once; null when it is outside the root or unreadable. */\n  private lines(file: string): Promise<string[] | null> {\n    let cached = this.fileLines.get(file);\n    if (!cached) {\n      const abs = path.resolve(this.root!, file);\n      cached =\n        abs === this.root || !abs.startsWith(this.root! + path.sep)\n          ? Promise.resolve(null)\n          : readFile(abs, \"utf-8\").then((text) => text.split(\"\\n\"), () => null);\n      this.fileLines.set(file, cached);\n    }\n    return cached;\n  }\n\n  /**\n   * A symbol's source: its line range read from disk when the builder has a root and the node\n   * has lines in a readable file, else CBM's snippet.\n   */\n  private async sourceOf(qn: string, node: { file_path?: unknown; start_line?: unknown; end_line?: unknown; lines?: unknown } | null): Promise<string | null> {\n    if (this.root && node && typeof node.file_path === \"string\" && node.file_path) {\n      const { start, end } = lineRange(node as GraphNode);\n      if (start !== null && end !== null && start >= 1 && end >= start) {\n        const lines = await this.lines(node.file_path);\n        if (lines && end <= lines.length) return lines.slice(start - 1, end).join(\"\\n\");\n      }\n    }\n    return (await this.graph.snippet(qn))?.source ?? null;\n  }\n\n  /** Strip the project prefix from a qualified name. */\n  shortQn(qn: string): string {\n    const p = this.graph.project;\n    return qn.startsWith(p + \".\") ? qn.slice(p.length + 1) : qn;\n  }\n\n  /**\n   * A route's handler when no HANDLES edge names one: the function, in a file with an edge into\n   * the route, whose source quotes the route's path (or calls the route's method with it).\n   */\n  private async resolveRouteHandler(routeName: string): Promise<string | null> {\n    const pathPart = routeName.replace(/^__route__[A-Z]+__/, \"\").replace(/\\{\\}.*$/, \"\");\n    const method = (/^__route__([A-Z]+)__/.exec(routeName)?.[1] ?? \"\").toLowerCase();\n    const files = new Set<string>();\n    for (const qn of this.edges.routeCallers.get(routeName) ?? []) {\n      const f = this.edges.qnFile.get(qn);\n      if (f) files.add(f);\n    }\n    for (const file of files) {\n      let fns = this.handlerCache.get(file);\n      if (!fns) {\n        fns = [];\n        for (const n of await this.graph.search(\"Function\", file, [\"start_line\"])) {\n          const source = await this.sourceOf(n.qualified_name, n);\n          if (source) fns.push({ qn: n.qualified_name, source });\n        }\n        this.handlerCache.set(file, fns);\n      }\n      const hit =\n        fns.find((f) => f.source.includes(`\"${pathPart}`) || f.source.includes(`'${pathPart}`)) ??\n        fns.find((f) => method && f.source.includes(`.${method}(`) && f.source.includes(pathPart));\n      if (hit) return hit.qn;\n    }\n    return null;\n  }\n\n  private cut(source: string): { source: string; total: number; truncated: boolean } {\n    const all = source.split(\"\\n\");\n    return all.length > this.sourceLines\n      ? { source: all.slice(0, this.sourceLines).join(\"\\n\"), total: all.length, truncated: true }\n      : { source, total: all.length, truncated: false };\n  }\n\n  async build(node: GraphNode): Promise<SymbolCard> {\n    const { edges } = this;\n    const qn = node.qualified_name;\n    const short = (s: string) => this.shortQn(s);\n    const { start, end } = lineRange(node);\n    let source: string | null = null;\n    let totalLines: number | null = null;\n    let truncated = false;\n    let routeHandlerQn: string | null = null;\n    if (node.label !== \"Route\") {\n      const text = await this.sourceOf(qn, node);\n      if (text) ({ source, total: totalLines, truncated } = this.cut(text));\n    } else {\n      // A Route borrows its handler's source: by HANDLES edge, else by resolveRouteHandler.\n      const direct = (edges.routeHandlers.get(qn) ?? []).filter((h) => edges.qnFile.has(h));\n      routeHandlerQn = direct[0] ?? (await this.resolveRouteHandler(qn));\n      if (routeHandlerQn) {\n        const text = await this.sourceOf(routeHandlerQn, null);\n        if (text) ({ source, total: totalLines, truncated } = this.cut(text));\n      }\n    }\n    const callers = (edges.callers.get(qn) ?? []).map(short);\n    const callees = (edges.callees.get(qn) ?? []).map(short);\n    return {\n      // Hashed on the full qualified name, as the labelled card sets were.\n      id: cardId(this.options.scope, qn),\n      label: node.label,\n      name: node.name,\n      qualified_name: short(qn),\n      file_path: node.file_path || (routeHandlerQn ? edges.qnFile.get(routeHandlerQn) ?? null : null),\n      start_line: start,\n      end_line: end,\n      signature: strOrNull(node.signature),\n      docstring: strOrNull(node.docstring),\n      is_exported: boolOrNull(node.is_exported),\n      is_entry_point: boolOrNull(node.is_entry_point),\n      complexity: numOrNull(node.complexity),\n      parent_class: node.parent_class ? short(String(node.parent_class)) : null,\n      base_classes: strArray(node.base_classes),\n      return_type: strOrNull(node.return_type),\n      callers: (node.label === \"Route\" && routeHandlerQn ? [short(routeHandlerQn), ...callers] : callers).slice(0, 12),\n      callees: callees.slice(0, 12),\n      callers_total: callers.length,\n      callees_total: callees.length,\n      imports: (node.file_path ? edges.importsByFile.get(node.file_path) ?? [] : []).slice(0, 15),\n      env_vars: edges.envVars.get(qn) ?? [],\n      routes_handled: node.label === \"Route\" ? [node.name.replace(/^__route__[A-Z]+__/, \"\")] : edges.handles.get(qn) ?? [],\n      http_calls: (edges.httpCalls.get(qn) ?? []).slice(0, 8),\n      inherits: (edges.inherits.get(qn) ?? []).map(short),\n      implements: (edges.implements.get(qn) ?? []).map(short),\n      route_method: node.label === \"Route\" ? strOrNull(node.method) : null,\n      source,\n      source_lines_total: totalLines,\n      source_truncated: truncated,\n    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/analyzers/cards/classify.js

@@ -0,0 +1,42 @@
+import { CARD_FIELDS, CARD_LABELS, CARD_VERSION, CardBuilder, VENDOR_EXCLUDE, isCandidate } from "./build.js";
+import { buildEdgeIndex } from "./edge-index.js";
+import { buildFactsIndex, factsFor } from "./facts.js";
+import { tier0ForCard } from "./tier0.js";
+function defaultLabels(rules) {
+  return [.../* @__PURE__ */ new Set([...CARD_LABELS, ...rules.flatMap((r) => r.labels)])];
+}
+async function classifyTier0(graph, rules, analyzer, options = {}) {
+  const labels = options.labels?.length ? options.labels : defaultLabels(rules), exclude = options.exclude ? new RegExp(`(?:${VENDOR_EXCLUDE.source})|(?:${options.exclude.source})`, options.exclude.flags.replace("g", "")) : VENDOR_EXCLUDE, nodes = [], seen = /* @__PURE__ */ new Set();
+  for (const label of labels)
+    for (const node of await graph.search(label, options.filePattern, CARD_FIELDS[label] ?? []))
+      !isCandidate(node, label, exclude) || seen.has(node.qualified_name) || (seen.add(node.qualified_name), nodes.push(node));
+  const selected = options.limit !== void 0 ? nodes.slice(0, options.limit) : nodes, edges = await buildEdgeIndex(graph), factsIndex = await buildFactsIndex(graph), builder = new CardBuilder(graph, edges, { scope: graph.project, sourceRoot: options.sourceRoot }), results = [], summary = { cards: 0, decided: 0, rejected: 0, narrowed: 0, undecided: 0, no_source: 0, by_rule: {}, by_target: {} };
+  for (const node of selected) {
+    const card = await builder.build(node), facts = factsFor(factsIndex, node.qualified_name, card.file_path), tier0 = tier0ForCard(card, facts, rules);
+    if (summary.cards++, card.source === null && card.label !== "Route" && summary.no_source++, !tier0)
+      summary.undecided++;
+    else if (summary.by_rule[tier0.rule] = (summary.by_rule[tier0.rule] ?? 0) + 1, tier0.kind === "decide") {
+      summary.decided++;
+      const target = `${tier0.layer}.${tier0.type}`;
+      summary.by_target[target] = (summary.by_target[target] ?? 0) + 1;
+    } else tier0.kind === "reject" ? summary.rejected++ : summary.narrowed++;
+    results.push({
+      card_id: card.id,
+      label: card.label,
+      name: card.name,
+      qualified_name: card.qualified_name,
+      file_path: card.file_path,
+      start_line: card.start_line,
+      end_line: card.end_line,
+      tier0,
+      facts,
+      ...options.includeCards ? { card } : {}
+    }), options.onProgress?.(results.length, selected.length);
+  }
+  return { analyzer, project: graph.project, mode: "tier0", card_version: CARD_VERSION, rules: rules.length, summary, results };
+}
+export {
+  classifyTier0,
+  defaultLabels
+};
+//# sourceMappingURL=classify.js.map