@hongmaple0820/scale-engine 0.40.2 → 0.44.0

package/dist/skills/interop/OMCInterop.d.ts

@@ -0,0 +1,15 @@
+import type { ParsedSkillMd } from '../SkillMdStandard.js';
+export interface OMCSkill {
+    id: string;
+    triggers: string[];
+    agentType: string;
+    category: string;
+}
+/**
+ * Convert a parsed SKILL.md to OMC-compatible skill format.
+ */
+export declare function convertToOMC(parsed: ParsedSkillMd): OMCSkill;
+/**
+ * Import an OMC skill into SCALE skill format.
+ */
+export declare function importFromOMC(omcSkill: OMCSkill, outputDir: string): void;

package/dist/skills/interop/OMCInterop.js

@@ -0,0 +1,34 @@
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Convert a parsed SKILL.md to OMC-compatible skill format.
+ */
+export function convertToOMC(parsed) {
+    return {
+        id: parsed.frontmatter.name,
+        triggers: parsed.frontmatter.triggers ?? [],
+        agentType: parsed.toolNamespaces['omc']?.join(',') ?? 'general-purpose',
+        category: parsed.frontmatter['preamble-tier']?.startsWith('tier-0') ? 'tier-0' : 'tier-1',
+    };
+}
+/**
+ * Import an OMC skill into SCALE skill format.
+ */
+export function importFromOMC(omcSkill, outputDir) {
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const content = [
+        '---',
+        `name: ${omcSkill.id}`,
+        `description: OMC skill: ${omcSkill.category}`,
+        `triggers: [${omcSkill.triggers.join(', ')}]`,
+        `allowed-tools: [${omcSkill.agentType.split(',').map(t => `omc:${t.trim()}`).join(', ')}]`,
+        '---',
+        '',
+        `# ${omcSkill.id}`,
+        '',
+        `> Imported from OMC. Category: ${omcSkill.category}`,
+    ].join('\n');
+    writeFileSync(join(outputDir, `${omcSkill.id.replace(/\s+/g, '-').toLowerCase()}.skill.md`), content);
+}
+//# sourceMappingURL=OMCInterop.js.map

package/dist/skills/interop/OMCInterop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OMCInterop.js","sourceRoot":"","sources":["../../../src/skills/interop/OMCInterop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAUhC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI;QAC3B,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,IAAI,EAAE;QAC3C,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,iBAAiB;QACvE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;KAC1F,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,SAAiB;IACjE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG;QACd,KAAK;QACL,SAAS,QAAQ,CAAC,EAAE,EAAE;QACtB,2BAA2B,QAAQ,CAAC,QAAQ,EAAE;QAC9C,cAAc,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7C,mBAAmB,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC1F,KAAK;QACL,EAAE;QACF,KAAK,QAAQ,CAAC,EAAE,EAAE;QAClB,EAAE;QACF,kCAAkC,QAAQ,CAAC,QAAQ,EAAE;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAA;AACvG,CAAC"}

package/dist/topology/DomainMapper.d.ts

@@ -0,0 +1,23 @@
+import type { TopologyGraph } from '../codegraph/CodeIntelligence.js';
+export interface BusinessDomain {
+    name: string;
+    nodes: string[];
+    confidence: number;
+}
+export interface DomainFlow {
+    name: string;
+    domain: string;
+    steps: string[];
+}
+export interface DomainMapping {
+    domains: BusinessDomain[];
+    flows: DomainFlow[];
+    unmappedNodes: string[];
+}
+interface DomainPattern {
+    domain: string;
+    pathPatterns: string[];
+    symbolPatterns: RegExp[];
+}
+export declare function mapDomains(graph: TopologyGraph, customPatterns?: DomainPattern[]): DomainMapping;
+export {};

package/dist/topology/DomainMapper.js

@@ -0,0 +1,179 @@
+const DEFAULT_DOMAIN_PATTERNS = [
+    {
+        domain: 'Authentication',
+        pathPatterns: ['**/auth/**', '**/authentication/**', '**/login/**', '**/session/**', '**/oauth/**', '**/jwt/**'],
+        symbolPatterns: [/auth/i, /login/i, /logout/i, /session/i, /token/i, /jwt/i, /credential/i, /password/i],
+    },
+    {
+        domain: 'Authorization',
+        pathPatterns: ['**/permission/**', '**/permissions/**', '**/rbac/**', '**/acl/**', '**/policy/**', '**/policies/**'],
+        symbolPatterns: [/permission/i, /authorize/i, /acl/i, /rbac/i, /role/i, /guard/i, /access.?control/i],
+    },
+    {
+        domain: 'User Management',
+        pathPatterns: ['**/user/**', '**/users/**', '**/account/**', '**/accounts/**', '**/profile/**'],
+        symbolPatterns: [/user/i, /account/i, /profile/i, /member/i, /subscriber/i],
+    },
+    {
+        domain: 'Governance',
+        pathPatterns: ['**/governance/**', '**/guardrails/**', '**/gate*/**', '**/policy/**', '**/detector*/**'],
+        symbolPatterns: [/govern/i, /guardrail/i, /gate/i, /detector/i, /policy/i, /compliance/i],
+    },
+    {
+        domain: 'Workflow',
+        pathPatterns: ['**/workflow/**', '**/workflows/**', '**/pipeline/**', '**/orchestrat*/**', '**/fsm/**'],
+        symbolPatterns: [/workflow/i, /pipeline/i, /orchestrat/i, /fsm/i, /state.?machine/i, /phase/i],
+    },
+    {
+        domain: 'Artifact Management',
+        pathPatterns: ['**/artifact/**', '**/artifacts/**', '**/document*/**'],
+        symbolPatterns: [/artifact/i, /document/i, /report/i, /evidence/i],
+    },
+    {
+        domain: 'Knowledge',
+        pathPatterns: ['**/knowledge/**', '**/memory/**', '**/brain/**', '**/learning/**'],
+        symbolPatterns: [/knowledge/i, /memory/i, /brain/i, /learn/i, /instinct/i, /lesson/i],
+    },
+    {
+        domain: 'CLI',
+        pathPatterns: ['**/cli/**', '**/command*/**', '**/terminal/**'],
+        symbolPatterns: [/cli/i, /command/i, /terminal/i, /arg/i, /flag/i, /subcommand/i],
+    },
+    {
+        domain: 'Monitoring',
+        pathPatterns: ['**/monitor*/**', '**/metric*/**', '**/telemetry/**', '**/observ*/**', '**/dashboard/**', '**/event*/**'],
+        symbolPatterns: [/metric/i, /monitor/i, /telemetry/i, /observ/i, /dashboard/i, /event/i, /log/i],
+    },
+    {
+        domain: 'Security',
+        pathPatterns: ['**/security/**', '**/crypto/**', '**/encrypt*/**', '**/secret*/**'],
+        symbolPatterns: [/security/i, /encrypt/i, /decrypt/i, /hash/i, /secret/i, /sanitize/i, /xss/i, /csrf/i, /owasp/i],
+    },
+    {
+        domain: 'Testing',
+        pathPatterns: ['**/test/**', '**/tests/**', '**/__tests__/**', '**/e2e/**', '**/eval/**'],
+        symbolPatterns: [/test/i, /mock/i, /stub/i, /fixture/i, /assert/i, /expect/i, /eval/i],
+    },
+    {
+        domain: 'AI/LLM Integration',
+        pathPatterns: ['**/ai/**', '**/llm/**', '**/agent*/**', '**/prompt*/**', '**/model*/**', '**/routing/**'],
+        symbolPatterns: [/agent/i, /llm/i, /prompt/i, /model/i, /token/i, /embedding/i, /completion/i],
+    },
+];
+export function mapDomains(graph, customPatterns) {
+    const patterns = customPatterns ?? DEFAULT_DOMAIN_PATTERNS;
+    const domainAssignments = new Map(); // domain -> nodeId -> confidence
+    for (const node of graph.nodes) {
+        const matches = matchNodeDomains(node, patterns);
+        for (const { domain, confidence } of matches) {
+            if (!domainAssignments.has(domain))
+                domainAssignments.set(domain, new Map());
+            domainAssignments.get(domain).set(node.id, confidence);
+        }
+    }
+    const domains = [];
+    for (const [domain, nodeMap] of domainAssignments) {
+        const nodeIds = Array.from(nodeMap.keys());
+        const avgConfidence = Array.from(nodeMap.values()).reduce((a, b) => a + b, 0) / nodeMap.size;
+        if (nodeIds.length >= 2) {
+            domains.push({ name: domain, nodes: nodeIds, confidence: Math.round(avgConfidence * 100) / 100 });
+        }
+    }
+    // Sort by node count descending
+    domains.sort((a, b) => b.nodes.length - a.nodes.length);
+    const mappedNodeIds = new Set(domains.flatMap(d => d.nodes));
+    const unmappedNodes = graph.nodes.map(n => n.id).filter(id => !mappedNodeIds.has(id));
+    // Detect flows: BFS through edges within each domain
+    const flows = detectFlows(graph, domains);
+    return { domains, flows, unmappedNodes };
+}
+function matchNodeDomains(node, patterns) {
+    const results = [];
+    const normalizedPath = node.filePath?.replace(/\\/g, '/') ?? '';
+    for (const pattern of patterns) {
+        let confidence = 0;
+        // Path pattern match (high confidence)
+        for (const pathPattern of pattern.pathPatterns) {
+            if (matchesGlob(normalizedPath, pathPattern)) {
+                confidence = Math.max(confidence, 0.85);
+                break;
+            }
+        }
+        // Symbol name match (medium confidence)
+        for (const symRegex of pattern.symbolPatterns) {
+            if (symRegex.test(node.name)) {
+                confidence = Math.max(confidence, 0.6);
+                break;
+            }
+        }
+        if (confidence > 0) {
+            results.push({ domain: pattern.domain, confidence });
+        }
+    }
+    return results;
+}
+function detectFlows(graph, domains) {
+    const flows = [];
+    const nodeToDomain = new Map();
+    for (const domain of domains) {
+        for (const nodeId of domain.nodes) {
+            nodeToDomain.set(nodeId, domain.name);
+        }
+    }
+    // For each domain, find entry points (nodes with no incoming edges within domain)
+    for (const domain of domains) {
+        const domainNodeSet = new Set(domain.nodes);
+        const incomingCount = new Map();
+        for (const edge of graph.edges) {
+            if (domainNodeSet.has(edge.source) && domainNodeSet.has(edge.target)) {
+                incomingCount.set(edge.target, (incomingCount.get(edge.target) ?? 0) + 1);
+            }
+        }
+        const entryPoints = domain.nodes.filter(id => (incomingCount.get(id) ?? 0) === 0);
+        if (entryPoints.length === 0 && domain.nodes.length > 0) {
+            entryPoints.push(domain.nodes[0]);
+        }
+        // BFS from each entry point to find flows
+        for (const entry of entryPoints.slice(0, 3)) {
+            const steps = bfsWithinDomain(graph, entry, domainNodeSet);
+            if (steps.length >= 2) {
+                flows.push({
+                    name: `${domain.name} flow`,
+                    domain: domain.name,
+                    steps,
+                });
+            }
+        }
+    }
+    return flows;
+}
+function bfsWithinDomain(graph, start, domainNodes) {
+    const visited = new Set();
+    const queue = [start];
+    const order = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        order.push(current);
+        for (const edge of graph.edges) {
+            if (edge.source === current && domainNodes.has(edge.target) && !visited.has(edge.target)) {
+                queue.push(edge.target);
+            }
+        }
+    }
+    return order;
+}
+function matchesGlob(path, glob) {
+    if (!path)
+        return false;
+    const regexStr = glob
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '{{GLOBSTAR}}')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\{\{GLOBSTAR\}\}/g, '.*')
+        .replace(/\?/g, '[^/]');
+    return new RegExp(`(^|/)${regexStr}($|/)`).test(path);
+}
+//# sourceMappingURL=DomainMapper.js.map

package/dist/topology/DomainMapper.js.map

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

package/dist/topology/LayerClassifier.d.ts

@@ -0,0 +1,8 @@
+import type { ArchitectureLayer, TopologyGraph } from '../codegraph/CodeIntelligence.js';
+export interface LayerRule {
+    layer: ArchitectureLayer;
+    patterns: string[];
+}
+export declare const DEFAULT_LAYER_RULES: LayerRule[];
+export declare function getLayerColor(layer: ArchitectureLayer): string;
+export declare function classifyLayers(graph: TopologyGraph, customRules?: LayerRule[]): TopologyGraph;

package/dist/topology/LayerClassifier.js

@@ -0,0 +1,109 @@
+export const DEFAULT_LAYER_RULES = [
+    { layer: 'api', patterns: ['**/api/**', '**/routes/**', '**/controllers/**', '**/handlers/**', '**/endpoints/**'] },
+    { layer: 'service', patterns: ['**/service/**', '**/services/**', '**/domain/**', '**/core/**', '**/business/**'] },
+    { layer: 'data', patterns: ['**/model/**', '**/models/**', '**/repository/**', '**/repositories/**', '**/store/**', '**/stores/**', '**/db/**', '**/database/**', '**/schema/**', '**/entities/**'] },
+    { layer: 'ui', patterns: ['**/components/**', '**/views/**', '**/pages/**', '**/dashboard/**', '**/templates/**', '**/layouts/**'] },
+    { layer: 'utility', patterns: ['**/util/**', '**/utils/**', '**/helpers/**', '**/lib/**', '**/common/**', '**/shared/**', '**/tools/**'] },
+    { layer: 'config', patterns: ['**/config/**', '**/configuration/**', '**/*.config.*', '**/setup/**', '**/settings/**'] },
+    { layer: 'test', patterns: ['**/*.test.*', '**/*.spec.*', '**/__tests__/**', '**/tests/**', '**/__mocks__/**', '**/fixtures/**', '**/test/**'] },
+];
+const LAYER_COLORS = {
+    api: '#3b82f6',
+    service: '#22c55e',
+    data: '#f97316',
+    ui: '#a855f7',
+    utility: '#6b7280',
+    config: '#eab308',
+    test: '#ec4899',
+    unknown: '#374151',
+};
+export function getLayerColor(layer) {
+    return LAYER_COLORS[layer] ?? LAYER_COLORS.unknown;
+}
+export function classifyLayers(graph, customRules) {
+    const rules = customRules ?? DEFAULT_LAYER_RULES;
+    return {
+        ...graph,
+        nodes: graph.nodes.map(node => ({
+            ...node,
+            layer: classifyNode(node, rules),
+        })),
+    };
+}
+function classifyNode(node, rules) {
+    // Test files are highest priority — always classify first
+    if (isTestFile(node.filePath))
+        return 'test';
+    // Path-based rules
+    for (const rule of rules) {
+        if (rule.layer === 'test')
+            continue; // already handled
+        for (const pattern of rule.patterns) {
+            if (matchesPattern(node.filePath, pattern))
+                return rule.layer;
+        }
+    }
+    // Symbol-name-based fallback for non-file nodes
+    if (node.kind !== 'file') {
+        const nameLayer = classifyBySymbolName(node.name);
+        if (nameLayer)
+            return nameLayer;
+    }
+    return 'unknown';
+}
+function isTestFile(path) {
+    if (!path)
+        return false;
+    const lower = path.toLowerCase();
+    return (lower.includes('.test.') ||
+        lower.includes('.spec.') ||
+        lower.includes('__tests__/') ||
+        lower.includes('/tests/') ||
+        lower.includes('/__mocks__/') ||
+        lower.includes('/fixtures/') ||
+        lower.endsWith('.test') ||
+        lower.endsWith('.spec'));
+}
+function classifyBySymbolName(name) {
+    if (!name)
+        return undefined;
+    const lower = name.toLowerCase();
+    // API patterns
+    if (/^(get|post|put|patch|delete|head|options)[A-Z]/.test(name))
+        return 'api';
+    if (/router|controller|handler|endpoint|middleware/i.test(lower))
+        return 'api';
+    // Service patterns
+    if (/service|manager|processor|executor|orchestrator|coordinator/i.test(lower))
+        return 'service';
+    // Data patterns
+    if (/repository|model|entity|schema|migration|dao|dto/i.test(lower))
+        return 'data';
+    // UI patterns
+    if (/component|view|page|template|layout|widget|render/i.test(lower))
+        return 'ui';
+    // Utility patterns
+    if (/util|helper|common|shared|lib|format|parse|validate|transform/i.test(lower))
+        return 'utility';
+    // Config patterns
+    if (/config|setting|option|env|constant/i.test(lower))
+        return 'config';
+    return undefined;
+}
+function matchesPattern(path, pattern) {
+    if (!path)
+        return false;
+    const normalized = path.replace(/\\/g, '/');
+    const regex = globToRegex(pattern);
+    return regex.test(normalized);
+}
+function globToRegex(glob) {
+    let regexStr = glob
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '{{GLOBSTAR}}')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\{\{GLOBSTAR\}\}/g, '.*')
+        .replace(/\?/g, '[^/]');
+    return new RegExp(`(^|/)${regexStr}($|/)`);
+}
+//# sourceMappingURL=LayerClassifier.js.map

package/dist/topology/LayerClassifier.js.map

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

package/dist/topology/TourGenerator.d.ts

@@ -0,0 +1,18 @@
+import type { TopologyGraph, ArchitectureLayer } from '../codegraph/CodeIntelligence.js';
+export interface TourStop {
+    nodeId: string;
+    title: string;
+    description: string;
+    layer: ArchitectureLayer;
+    relatedNodes: string[];
+    order: number;
+}
+export interface GuidedTour {
+    name: string;
+    stops: TourStop[];
+    estimatedMinutes: number;
+}
+export declare function generateTour(graph: TopologyGraph, options?: {
+    maxStops?: number;
+    focusDomain?: string;
+}): GuidedTour;

package/dist/topology/TourGenerator.js

@@ -0,0 +1,120 @@
+const LAYER_DESCRIPTIONS = {
+    api: 'API layer — handles external requests and routes them to the appropriate services',
+    service: 'Service layer — contains business logic and orchestrates operations',
+    data: 'Data layer — manages data persistence, models, and storage',
+    ui: 'UI layer — renders the user interface and handles user interactions',
+    utility: 'Utility layer — provides shared helpers and common functionality',
+    config: 'Configuration layer — defines settings and initialization',
+    test: 'Test layer — verifies correctness through automated tests',
+    unknown: 'Unclassified component',
+};
+export function generateTour(graph, options = {}) {
+    const maxStops = options.maxStops ?? 20;
+    const entryPoints = findEntryPoints(graph);
+    const orderedNodes = bfsFromEntries(graph, entryPoints);
+    const stops = [];
+    for (const nodeId of orderedNodes) {
+        if (stops.length >= maxStops)
+            break;
+        const node = graph.nodes.find(n => n.id === nodeId);
+        if (!node)
+            continue;
+        const relatedNodes = findRelatedNodes(graph, nodeId);
+        stops.push({
+            nodeId,
+            title: formatNodeTitle(node),
+            description: generateStopDescription(node, graph),
+            layer: node.layer ?? 'unknown',
+            relatedNodes,
+            order: stops.length + 1,
+        });
+    }
+    return {
+        name: options.focusDomain
+            ? `${options.focusDomain} Architecture Tour`
+            : 'Architecture Tour',
+        stops,
+        estimatedMinutes: Math.max(1, Math.ceil(stops.length * 0.5)),
+    };
+}
+function findEntryPoints(graph) {
+    const incomingCount = new Map();
+    for (const edge of graph.edges) {
+        incomingCount.set(edge.target, (incomingCount.get(edge.target) ?? 0) + 1);
+    }
+    // Entry points: nodes with no incoming edges, preferring main/index/app/server
+    const noIncoming = graph.nodes.filter(n => (incomingCount.get(n.id) ?? 0) === 0);
+    const priorityNames = ['main', 'index', 'app', 'server', 'cli', 'entry', 'run', 'start'];
+    const sorted = noIncoming.sort((a, b) => {
+        const aPriority = priorityNames.findIndex(name => a.name.toLowerCase().includes(name));
+        const bPriority = priorityNames.findIndex(name => b.name.toLowerCase().includes(name));
+        const aRank = aPriority === -1 ? 999 : aPriority;
+        const bRank = bPriority === -1 ? 999 : bPriority;
+        return aRank - bRank;
+    });
+    // If no entry points found, use all file-level nodes
+    if (sorted.length === 0) {
+        return graph.nodes.filter(n => n.kind === 'file').slice(0, 5).map(n => n.id);
+    }
+    return sorted.slice(0, 10).map(n => n.id);
+}
+function bfsFromEntries(graph, entries) {
+    const visited = new Set();
+    const order = [];
+    const queue = [...entries];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        order.push(current);
+        // Follow outgoing edges (dependencies, calls)
+        for (const edge of graph.edges) {
+            if (edge.source === current && !visited.has(edge.target)) {
+                queue.push(edge.target);
+            }
+        }
+    }
+    // Add any unvisited nodes at the end
+    for (const node of graph.nodes) {
+        if (!visited.has(node.id)) {
+            order.push(node.id);
+        }
+    }
+    return order;
+}
+function findRelatedNodes(graph, nodeId) {
+    const related = new Set();
+    for (const edge of graph.edges) {
+        if (edge.source === nodeId)
+            related.add(edge.target);
+        if (edge.target === nodeId)
+            related.add(edge.source);
+    }
+    return Array.from(related).slice(0, 5);
+}
+function formatNodeTitle(node) {
+    const layerTag = node.layer ? `[${node.layer.toUpperCase()}] ` : '';
+    const kindTag = node.kind === 'file' ? '' : ` (${node.kind})`;
+    return `${layerTag}${node.name}${kindTag}`;
+}
+function generateStopDescription(node, graph) {
+    const layerDesc = LAYER_DESCRIPTIONS[node.layer ?? 'unknown'];
+    const parts = [layerDesc];
+    if (node.filePath) {
+        parts.push(`Located in ${node.filePath}`);
+    }
+    // Count connections
+    const outgoing = graph.edges.filter(e => e.source === node.id).length;
+    const incoming = graph.edges.filter(e => e.target === node.id).length;
+    if (outgoing > 0 || incoming > 0) {
+        const connDesc = [];
+        if (outgoing > 0)
+            connDesc.push(`depends on ${outgoing}`);
+        if (incoming > 0)
+            connDesc.push(`depended on by ${incoming}`);
+        parts.push(`Connections: ${connDesc.join(', ')}`);
+    }
+    return parts.join('. ') + '.';
+}
+//# sourceMappingURL=TourGenerator.js.map

package/dist/topology/TourGenerator.js.map

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

package/dist/topology/index.d.ts

@@ -0,0 +1,3 @@
+export { classifyLayers, getLayerColor, DEFAULT_LAYER_RULES, type LayerRule } from './LayerClassifier.js';
+export { mapDomains, type BusinessDomain, type DomainFlow, type DomainMapping } from './DomainMapper.js';
+export { generateTour, type TourStop, type GuidedTour } from './TourGenerator.js';

package/dist/topology/index.js

@@ -0,0 +1,4 @@
+export { classifyLayers, getLayerColor, DEFAULT_LAYER_RULES } from './LayerClassifier.js';
+export { mapDomains } from './DomainMapper.js';
+export { generateTour } from './TourGenerator.js';
+//# sourceMappingURL=index.js.map

package/dist/topology/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/topology/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAkB,MAAM,sBAAsB,CAAA;AACzG,OAAO,EAAE,UAAU,EAA4D,MAAM,mBAAmB,CAAA;AACxG,OAAO,EAAE,YAAY,EAAkC,MAAM,oBAAoB,CAAA"}

package/dist/tui/TuiDashboard.d.ts

@@ -0,0 +1,3 @@
+import type { IArtifactStore } from '../artifact/store.js';
+import type { IEventBus } from '../core/eventBus.js';
+export declare function runTuiDashboard(artifactStore: IArtifactStore, eventBus: IEventBus): Promise<void>;