openlore 2.0.0

package/dist/core/generator/prompts.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Prompt templates for each generation stage.
+ * These are used by the stage functions to construct LLM requests.
+ */
+export declare const PROMPTS: {
+    stage1_survey: string;
+    stage2_entities: (projectCategory: string, frameworks: string[]) => string;
+    stage3_services: (projectCategory: string, entities: string[], suggestedDomains: string[]) => string;
+    stage4_api: string;
+    stage5_architecture: (survey: {
+        domainSummary: string;
+        architecturePattern: string;
+        suggestedDomains: string[];
+    }) => string;
+    stage6_adr: (architecture: {
+        layerMap: {
+            name: string;
+            purpose: string;
+        }[];
+        systemPurpose: string;
+        architectureStyle: string;
+        dataFlow: string;
+        securityModel: string;
+        integrations: string[];
+        keyDecisions: string[];
+    }) => string;
+    stage3_subspec_system: string;
+    stage3_subspec: (orchestratorName: string, orchestratorPurpose: string, callees: Array<{
+        name: string;
+        signature?: string;
+        docstring?: string;
+        subcallees: string[];
+    }>) => string;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/core/generator/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/core/generator/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,OAAO;;uCAkCiB,MAAM,cAAc,MAAM,EAAE;uCA6B5B,MAAM,YAAY,MAAM,EAAE,oBAAoB,MAAM,EAAE;;kCAgE3D;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE;+BAmCrF;QAAE,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE;;uCAyCnM,MAAM,uBACH,MAAM,WAClB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAcjG,CAAC"}

package/dist/core/generator/prompts.js

@@ -0,0 +1,212 @@
+/**
+ * Prompt templates for each generation stage.
+ * These are used by the stage functions to construct LLM requests.
+ */
+export const PROMPTS = {
+    stage1_survey: `You are a senior software architect performing a codebase audit.
+Your task is to categorize this project based on the analysis data provided.
+
+Respond with a JSON object containing:
+- projectCategory: One of ["web-frontend", "web-backend", "api-service", "cli-tool", "library", "mobile-app", "desktop-app", "data-pipeline", "ml-service", "monorepo", "other"]
+- primaryLanguage: The main language
+- frameworks: Array of detected frameworks
+- architecturePattern: One of ["layered", "hexagonal", "microservices", "monolith", "serverless", "event-driven", "mvc", "other"]
+- domainSummary: One sentence describing what this system does
+- suggestedDomains: Array of domain names for OpenSpec specs (e.g., ["user", "order", "auth", "api"])
+- confidence: 0-1 score of how confident you are
+- schemaFiles: Array of file paths (from the provided file list) that define data models, types, entities, or interfaces — these will be used for entity extraction. Include files regardless of their name, based on their content role.
+- serviceFiles: Array of file paths containing business logic, services, processors, analyzers, pipelines, or domain operations — used for service analysis. Do not filter by name conventions; look at what the file does.
+- apiFiles: Array of file paths that expose public interfaces: HTTP routes, CLI command handlers, GraphQL resolvers, message consumers, or external-facing APIs.
+
+For schemaFiles/serviceFiles/apiFiles: use the exact file paths from the provided analysis. Return [] if none apply.
+
+Example output:
+{
+  "projectCategory": "api-service",
+  "primaryLanguage": "TypeScript",
+  "frameworks": ["Express", "Prisma"],
+  "architecturePattern": "layered",
+  "domainSummary": "REST API managing e-commerce orders and inventory.",
+  "suggestedDomains": ["order", "product", "auth"],
+  "confidence": 0.85,
+  "schemaFiles": ["src/models/order.ts", "src/types/product.ts"],
+  "serviceFiles": ["src/services/order-service.ts", "src/core/inventory.ts"],
+  "apiFiles": ["src/routes/orders.ts", "src/cli/commands/create.ts"]
+}
+
+Respond ONLY with valid JSON.`,
+    stage2_entities: (projectCategory, frameworks) => `You are analyzing the core data models of a ${projectCategory} built with ${frameworks.join(', ')}.
+
+For each entity you identify, extract in OpenSpec format:
+- name: The entity name (e.g., "User", "Order")
+- description: What this entity represents in the business domain
+- properties: Array of {name, type, description, required}
+- relationships: Array of {targetEntity, type, description}
+- validations: Array of validation rules as strings (these become Requirements)
+- scenarios: Array of {name, given, when, then, and?} - observable behaviors in Given/When/Then format
+
+Focus on BUSINESS entities, not framework internals.
+Be precise - only include what you can verify from the code.
+
+Example output:
+[{
+  "name": "Order",
+  "description": "Represents a customer purchase transaction.",
+  "properties": [
+    {"name": "id", "type": "string", "description": "Unique identifier", "required": true},
+    {"name": "status", "type": "OrderStatus", "description": "Current lifecycle state", "required": true}
+  ],
+  "relationships": [{"targetEntity": "User", "type": "belongs-to", "description": "Order belongs to a customer"}],
+  "validations": ["Total must be positive", "Status transitions: pending → confirmed → shipped"],
+  "scenarios": [{"name": "Place order", "given": "User with items in cart", "when": "submitOrder() is called", "then": "Order created with status 'pending' and inventory reserved"}],
+  "location": ""
+}]
+
+Respond with a JSON array of entities. Respond ONLY with valid JSON.`,
+    stage3_services: (projectCategory, entities, suggestedDomains) => `You are analyzing the logic and processing layer of a ${projectCategory}.
+
+Known entities: ${entities.join(', ')}
+Available domains: ${suggestedDomains.join(', ')}
+
+For each service/module, identify:
+- name: Service name
+- purpose: What capability or responsibility it encapsulates
+- operations: Array of {name, description, inputs, outputs, scenarios, functionName} - key operations/methods that become Requirements with Scenarios. Cover all meaningful operations that represent distinct business behaviors.
+  - operations[].functionName: The exact function or method name as written in the source code that implements this operation (e.g. "runStage2", "buildSpecMap"). Leave empty string if uncertain.
+- dependencies: Array of other services/repositories it uses
+- sideEffects: Array of external interactions (file I/O, network calls, database, queues, etc.)
+- domain: Which domain OWNS this service (where it lives in the codebase, not who uses it) — use ONLY one of the available domains listed above
+
+Focus on WHAT the service does, not HOW it's implemented.
+Express operations as requirements (SHALL/MUST/SHOULD) with testable scenarios.
+
+Example output:
+[{
+  "name": "OrderService",
+  "purpose": "Manages order lifecycle: placement, validation, and fulfillment.",
+  "operations": [
+    {
+      "name": "placeOrder",
+      "description": "Validates cart contents and creates a new order record.",
+      "inputs": ["userId: string", "items: CartItem[]"],
+      "outputs": ["orderId: string"],
+      "functionName": "placeOrder",
+      "scenarios": [{"name": "Valid order", "given": "In-stock items in cart", "when": "placeOrder is called", "then": "Order persisted and inventory reserved"}]
+    }
+  ],
+  "dependencies": ["InventoryService", "OrderRepository"],
+  "sideEffects": ["Writes to orders table", "Sends confirmation email via queue"],
+  "domain": "order"
+}]
+
+Respond with a JSON array of services. Respond ONLY with valid JSON.`,
+    stage4_api: `Extract the public API surface of this application.
+
+For each endpoint/interface, structure as:
+- method: HTTP method or interface type
+- path: Route path or interface signature
+- purpose: What it does (becomes requirement description)
+- authentication: Required auth (if detectable)
+- requestSchema: Expected input as JSON object
+- responseSchema: Expected output as JSON object
+- scenarios: Array of {name, given, when, then, and?} - example request/response flows
+- relatedEntity: Which domain entity it operates on
+
+Example output:
+[{
+  "method": "POST",
+  "path": "/api/orders",
+  "purpose": "Create a new order from the current cart.",
+  "authentication": "Bearer JWT",
+  "requestSchema": {"userId": "string", "items": "CartItem[]"},
+  "responseSchema": {"orderId": "string", "status": "pending"},
+  "scenarios": [{"name": "Create order", "given": "Authenticated user with valid cart", "when": "POST /api/orders is called", "then": "201 Created with orderId in response body"}],
+  "relatedEntity": "Order"
+}]
+
+Respond with a JSON array of endpoints. Respond ONLY with valid JSON.`,
+    stage5_architecture: (survey) => `Based on the analysis data, synthesize a complete architecture overview for OpenSpec.
+
+Project context: ${survey.domainSummary}
+Architecture pattern: ${survey.architecturePattern}
+Domains: ${survey.suggestedDomains.join(', ')}
+
+Include:
+- systemPurpose: 2-3 sentences on what this system does and why
+- architectureStyle: The overall architecture pattern with justification
+- layerMap: Array of {name, purpose, components} - how code is organized
+- dataFlow: How data moves through the system (entry to persistence) as a string
+- integrations: Array of external systems this interacts with
+- securityModel: Authentication/authorization approach as a string
+- keyDecisions: Array of observable architectural decisions as strings
+
+Express each key architectural aspect clearly.
+Base all conclusions on the code evidence provided.
+Where uncertain, say so explicitly.
+
+Example output:
+{
+  "systemPurpose": "A REST API for e-commerce order management. It allows customers to browse products, place orders, and track fulfillment.",
+  "architectureStyle": "Layered architecture: HTTP routes → service layer → repository pattern over PostgreSQL.",
+  "layerMap": [
+    {"name": "API", "purpose": "HTTP routing and input validation", "components": ["routes/orders.ts", "routes/products.ts"]},
+    {"name": "Service", "purpose": "Business logic and orchestration", "components": ["services/order-service.ts"]}
+  ],
+  "dataFlow": "HTTP request → route handler → service → repository → PostgreSQL; async email notifications via Redis queue",
+  "integrations": ["PostgreSQL", "Redis", "SendGrid"],
+  "securityModel": "JWT Bearer tokens issued at login; route middleware enforces authentication on all /api/* routes",
+  "keyDecisions": ["Use Prisma ORM for type-safe database access", "Redis queue for async email notifications to avoid request latency"]
+}
+
+Respond with a JSON object. Respond ONLY with valid JSON.`,
+    stage6_adr: (architecture) => `You are a senior software architect creating Architecture Decision Records (ADRs).
+
+For each key decision listed below, produce a complete ADR with:
+- id: Sequential like "ADR-001", "ADR-002", etc.
+- title: The decision as a clear statement (e.g., "Use TypeORM for database access")
+- status: "accepted" (these are observed decisions already implemented in the code)
+- context: 2-3 sentences on why this decision was needed
+- decision: 1-2 sentences clearly stating what was decided
+- consequences: Array of 2-4 consequences (include both positive and negative)
+- alternatives: Array of 1-3 alternatives that could have been chosen instead
+- relatedLayers: Array of architecture layer names affected (from: ${architecture.layerMap.map(l => l.name).join(', ')})
+- relatedDomains: Array of domain names affected
+
+Architecture context:
+- System purpose: ${architecture.systemPurpose}
+- Architecture style: ${architecture.architectureStyle}
+- Layers: ${architecture.layerMap.map(l => `${l.name} (${l.purpose})`).join(', ')}
+- Data flow: ${architecture.dataFlow}
+- Security model: ${architecture.securityModel}
+- External integrations: ${architecture.integrations.join(', ') || 'None'}
+
+Key decisions to expand into full ADRs:
+${architecture.keyDecisions.map((d, i) => `${i + 1}. ${d}`).join('\n')}
+
+Base all conclusions on the code evidence provided. Where uncertain, say so explicitly.
+Respond with a JSON array of ADR objects. Respond ONLY with valid JSON.`,
+    stage3_subspec_system: `You are generating sub-specifications for the logical blocks of an orchestrator function.
+
+For each sub-block provided, generate a focused specification:
+- name: short camelCase identifier (e.g. "entityExtraction", "schemaValidation")
+- callee: exact function/method name as written in source code
+- purpose: one sentence describing what this block does
+- operations: array of {name, description, inputs, outputs, scenarios, functionName}
+  - Express operations as requirements using SHALL/MUST/SHOULD keywords
+  - Include at least one testable scenario per operation
+
+Focus on WHAT each block does, not HOW it is implemented.
+Respond ONLY with a valid JSON array of sub-specification objects.`,
+    stage3_subspec: (orchestratorName, orchestratorPurpose, callees) => `Orchestrator function: ${orchestratorName}
+Purpose: ${orchestratorPurpose}
+
+Sub-blocks to specify:
+${callees.map((c, i) => `${i + 1}. ${c.name}` +
+        (c.signature ? `\n   Signature: ${c.signature}` : '') +
+        (c.docstring ? `\n   Doc: ${c.docstring}` : '') +
+        (c.subcallees.length > 0 ? `\n   Calls: ${c.subcallees.join(', ')}` : '')).join('\n')}
+
+Generate one sub-specification per sub-block listed above.
+Respond ONLY with a valid JSON array of {name, callee, purpose, operations} objects.`,
+};
+//# sourceMappingURL=prompts.js.map

package/dist/core/generator/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/core/generator/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA+Ba;IAE5B,eAAe,EAAE,CAAC,eAAuB,EAAE,UAAoB,EAAE,EAAE,CAAC,+CAA+C,eAAe,eAAe,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;qEA2BnG;IAEnE,eAAe,EAAE,CAAC,eAAuB,EAAE,QAAkB,EAAE,gBAA0B,EAAE,EAAE,CAAC,yDAAyD,eAAe;;kBAEtJ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;qBAChB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAiCqB;IAEnE,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;sEAwBwD;IAEpE,mBAAmB,EAAE,CAAC,MAA0F,EAAE,EAAE,CAAC;;mBAEpG,MAAM,CAAC,aAAa;wBACf,MAAM,CAAC,mBAAmB;WACvC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DA6Ba;IAExD,UAAU,EAAE,CAAC,YAA0M,EAAE,EAAE,CAAC;;;;;;;;;;qEAUzJ,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;oBAIlG,YAAY,CAAC,aAAa;wBACtB,YAAY,CAAC,iBAAiB;YAC1C,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;eAClE,YAAY,CAAC,QAAQ;oBAChB,YAAY,CAAC,aAAa;2BACnB,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM;;;EAGvE,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;wEAGE;IAEtE,qBAAqB,EAAE;;;;;;;;;;;mEAW0C;IAEjE,cAAc,EAAE,CACd,gBAAwB,EACxB,mBAA2B,EAC3B,OAA8F,EAC9F,EAAE,CAAC,0BAA0B,gBAAgB;WACtC,mBAAmB;;;EAG5B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;QACrB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC;;;qFAGyE;CACpF,CAAC"}

package/dist/core/generator/rag-manifest-generator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * RAG Manifest Generator
+ *
+ * Produces openspec/rag-manifest.json — a lightweight index that maps each
+ * spec domain to its source files and cross-domain dependency edges.  Used by
+ * the orient MCP handler to inline condensed spec content without a separate
+ * get_spec call.
+ */
+import type { DependencyGraphResult } from '../analyzer/dependency-graph.js';
+import type { GeneratedSpec } from './openspec-format-generator.js';
+export interface RagManifest {
+    generatedAt: string;
+    specVersion: string;
+    domains: RagDomainEntry[];
+}
+export interface RagDomainEntry {
+    /** Domain name, e.g. "analyzer" */
+    domain: string;
+    /** Relative path to the spec file, e.g. "openspec/specs/analyzer/spec.md" */
+    specPath: string;
+    /** Relative source file paths belonging to this domain's cluster */
+    sourceFiles: string[];
+    /** Number of Requirement blocks in the spec (populated post-generation) */
+    requirementCount: number;
+    /** Domains this domain calls into (outbound cross-cluster edges) */
+    dependsOn: string[];
+    /** Domains that call into this domain (inbound cross-cluster edges) */
+    calledBy: string[];
+}
+export declare class RagManifestGenerator {
+    /**
+     * Build a RagManifest from the list of generated specs and the dependency
+     * graph (optional — if absent, sourceFiles / dependsOn / calledBy are empty).
+     */
+    generate(specs: GeneratedSpec[], depGraph?: DependencyGraphResult): RagManifest;
+}
+//# sourceMappingURL=rag-manifest-generator.d.ts.map

package/dist/core/generator/rag-manifest-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-manifest-generator.d.ts","sourceRoot":"","sources":["../../../src/core/generator/rag-manifest-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAMpE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,qBAAa,oBAAoB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,WAAW;CAoHhF"}

package/dist/core/generator/rag-manifest-generator.js

@@ -0,0 +1,134 @@
+/**
+ * RAG Manifest Generator
+ *
+ * Produces openspec/rag-manifest.json — a lightweight index that maps each
+ * spec domain to its source files and cross-domain dependency edges.  Used by
+ * the orient MCP handler to inline condensed spec content without a separate
+ * get_spec call.
+ */
+// ============================================================================
+// GENERATOR
+// ============================================================================
+export class RagManifestGenerator {
+    /**
+     * Build a RagManifest from the list of generated specs and the dependency
+     * graph (optional — if absent, sourceFiles / dependsOn / calledBy are empty).
+     */
+    generate(specs, depGraph) {
+        const domainSpecs = specs.filter(s => s.type === 'domain');
+        // Build domain → cluster mapping from depGraph
+        const clusterByDomain = new Map();
+        if (depGraph) {
+            for (const cluster of depGraph.clusters) {
+                const domainKey = cluster.suggestedDomain.toLowerCase();
+                // Keep the first (or structural) cluster per domain
+                if (!clusterByDomain.has(domainKey) || cluster.isStructural) {
+                    clusterByDomain.set(domainKey, {
+                        files: cluster.files,
+                        id: cluster.id,
+                    });
+                }
+            }
+        }
+        // Build file → cluster-id index for edge resolution
+        const clusterIdByFile = new Map();
+        const clusterDomainById = new Map();
+        if (depGraph) {
+            for (const [domain, cl] of clusterByDomain) {
+                clusterDomainById.set(cl.id, domain);
+                for (const f of cl.files)
+                    clusterIdByFile.set(f, cl.id);
+            }
+        }
+        // Build a flat list of all cluster files for filename-based fallback
+        const allClusterFiles = [];
+        if (depGraph) {
+            for (const [domain, cl] of clusterByDomain) {
+                for (const f of cl.files)
+                    allClusterFiles.push({ file: f, domain });
+            }
+        }
+        // For each domain spec, compute dependsOn / calledBy from dep graph edges
+        const entries = domainSpecs.map(spec => {
+            const domainKey = spec.domain.toLowerCase();
+            let cluster = clusterByDomain.get(domainKey);
+            // Fallback: if no exact cluster match, collect files whose basename
+            // contains the domain name (e.g. "openspec-*.ts" for domain "openspec")
+            let sourceFiles;
+            if (cluster) {
+                sourceFiles = cluster.files;
+            }
+            else if (depGraph) {
+                sourceFiles = allClusterFiles
+                    .filter(({ file }) => {
+                    const basename = file.split('/').pop() ?? '';
+                    return basename.toLowerCase().includes(domainKey);
+                })
+                    .map(({ file }) => file);
+                // Synthesise a virtual cluster entry so edge resolution works below
+                if (sourceFiles.length > 0) {
+                    const virtualId = `virtual:${domainKey}`;
+                    cluster = { files: sourceFiles, id: virtualId };
+                    clusterByDomain.set(domainKey, cluster);
+                    clusterDomainById.set(virtualId, domainKey);
+                    for (const f of sourceFiles)
+                        clusterIdByFile.set(f, virtualId);
+                }
+            }
+            else {
+                sourceFiles = [];
+            }
+            const clusterFileSet = new Set(cluster?.files ?? sourceFiles);
+            const dependsOnDomains = new Set();
+            const calledByDomains = new Set();
+            if (depGraph && cluster) {
+                for (const edge of depGraph.edges) {
+                    const srcInCluster = clusterFileSet.has(edge.source);
+                    const tgtInCluster = clusterFileSet.has(edge.target);
+                    if (srcInCluster && !tgtInCluster) {
+                        // This domain calls into the target's cluster
+                        const tgtClusterId = clusterIdByFile.get(edge.target);
+                        const tgtDomain = tgtClusterId
+                            ? clusterDomainById.get(tgtClusterId)
+                            : undefined;
+                        if (tgtDomain && tgtDomain !== domainKey) {
+                            dependsOnDomains.add(tgtDomain);
+                        }
+                    }
+                    else if (!srcInCluster && tgtInCluster) {
+                        // Another domain calls into this cluster
+                        const srcClusterId = clusterIdByFile.get(edge.source);
+                        const srcDomain = srcClusterId
+                            ? clusterDomainById.get(srcClusterId)
+                            : undefined;
+                        if (srcDomain && srcDomain !== domainKey) {
+                            calledByDomains.add(srcDomain);
+                        }
+                    }
+                }
+            }
+            return {
+                domain: spec.domain,
+                specPath: spec.path,
+                sourceFiles,
+                requirementCount: countRequirements(spec.content),
+                dependsOn: [...dependsOnDomains].sort(),
+                calledBy: [...calledByDomains].sort(),
+            };
+        });
+        return {
+            generatedAt: new Date().toISOString(),
+            specVersion: '1.0.0',
+            domains: entries.sort((a, b) => a.domain.localeCompare(b.domain)),
+        };
+    }
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+/** Count `### Requirement:` headers in a spec's markdown content */
+function countRequirements(content) {
+    const matches = content.match(/^### Requirement:/gm);
+    return matches?.length ?? 0;
+}
+//# sourceMappingURL=rag-manifest-generator.js.map

package/dist/core/generator/rag-manifest-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-manifest-generator.js","sourceRoot":"","sources":["../../../src/core/generator/rag-manifest-generator.ts"],"names":[],"mappings":"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"}