@genvidtech/c3-domain-manager 0.0.1 → 0.6.1

package/dist/domain/contextMap.js

@@ -0,0 +1,168 @@
+// Special characters that require quoting in mermaid node IDs
+function needsQuoting(name) {
+    return /[\s&()/\\,.'"]/.test(name);
+}
+function mermaidId(name) {
+    return needsQuoting(name) ? `"${name}"` : name;
+}
+function toMermaidArrow(type) {
+    switch (type) {
+        case "shared-kernel":
+            return "==SK==>";
+        case "customer-supplier":
+            return "-->|C/S|";
+        case "conformist":
+            return "-->|CF|";
+        case "anti-corruption-layer":
+            return "-->|ACL|";
+        case "open-host-service":
+            return "-->|OHS|";
+    }
+}
+function collectIncludedDomains(domains, config, focusDomain) {
+    const domainByName = new Map(domains.map((d) => [d.name, d]));
+    if (focusDomain === undefined) {
+        return new Set(domains.map((d) => d.name));
+    }
+    const focus = domainByName.get(focusDomain);
+    if (!focus)
+        return new Set();
+    const included = new Set();
+    included.add(focusDomain);
+    // 1-hop neighbors via includesFrom (outgoing deps from domain data)
+    for (const neighbor of focus.includesFrom.keys()) {
+        included.add(neighbor);
+    }
+    // 1-hop neighbors via includedBy (incoming deps from domain data)
+    for (const neighbor of focus.includedBy.keys()) {
+        included.add(neighbor);
+    }
+    // 1-hop neighbors via referencesFrom (outgoing event-var refs)
+    for (const neighbor of focus.referencesFrom.keys()) {
+        included.add(neighbor);
+    }
+    // 1-hop neighbors via referencedBy (incoming event-var refs)
+    for (const neighbor of focus.referencedBy.keys()) {
+        included.add(neighbor);
+    }
+    // 1-hop neighbors via declared relationships
+    for (const rel of config.relationships ?? []) {
+        if (rel.from === focusDomain)
+            included.add(rel.to);
+        if (rel.to === focusDomain)
+            included.add(rel.from);
+    }
+    return included;
+}
+function collectEdges(domains, config, includedNames, includeObserved) {
+    const edges = [];
+    const relationships = config.relationships ?? [];
+    // Add declared relationships between included domains
+    for (const rel of relationships) {
+        if (includedNames.has(rel.from) && includedNames.has(rel.to)) {
+            edges.push({ from: rel.from, to: rel.to, type: rel.type });
+        }
+    }
+    if (!includeObserved)
+        return edges;
+    // Build a set of pairs already covered by declared relationships
+    const declaredPairs = new Set();
+    for (const rel of relationships) {
+        declaredPairs.add(`${rel.from}::${rel.to}`);
+        declaredPairs.add(`${rel.to}::${rel.from}`);
+    }
+    // Add observed edges: domain.includesFrom entries not covered by any declared relationship
+    const observedIncludePairs = new Set();
+    for (const domain of domains) {
+        if (!includedNames.has(domain.name))
+            continue;
+        for (const targetDomain of domain.includesFrom.keys()) {
+            if (!includedNames.has(targetDomain))
+                continue;
+            const pairKey = `${domain.name}::${targetDomain}`;
+            if (!declaredPairs.has(pairKey)) {
+                edges.push({ from: domain.name, to: targetDomain, type: "observed" });
+                observedIncludePairs.add(pairKey);
+            }
+        }
+    }
+    // Add observed-ref edges: domain.referencesFrom entries not covered by declared or observed-include
+    for (const domain of domains) {
+        if (!includedNames.has(domain.name))
+            continue;
+        for (const targetDomain of domain.referencesFrom.keys()) {
+            if (!includedNames.has(targetDomain))
+                continue;
+            const pairKey = `${domain.name}::${targetDomain}`;
+            if (!declaredPairs.has(pairKey) && !observedIncludePairs.has(pairKey)) {
+                edges.push({ from: domain.name, to: targetDomain, type: "observed-ref" });
+            }
+        }
+    }
+    return edges;
+}
+function formatMermaid(includedNames, edges) {
+    if (edges.length === 0) {
+        return "graph LR";
+    }
+    const lines = ["graph LR"];
+    for (const edge of edges) {
+        const fromId = mermaidId(edge.from);
+        const toId = mermaidId(edge.to);
+        if (edge.type === "observed") {
+            lines.push(`  ${fromId} -.-> ${toId}`);
+        }
+        else if (edge.type === "observed-ref") {
+            lines.push(`  ${fromId} -.->|var| ${toId}`);
+        }
+        else {
+            const arrow = toMermaidArrow(edge.type);
+            lines.push(`  ${fromId} ${arrow} ${toId}`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatText(domains, includedNames, edges) {
+    const includedDomains = domains.filter((d) => includedNames.has(d.name));
+    if (includedDomains.length === 0) {
+        return "Context Map:\n\nNo domains.";
+    }
+    const lines = ["Context Map:", ""];
+    const outgoing = new Map();
+    const incoming = new Map();
+    for (const name of includedNames) {
+        outgoing.set(name, []);
+        incoming.set(name, []);
+    }
+    for (const edge of edges) {
+        outgoing.get(edge.from)?.push({ neighbor: edge.to, type: edge.type });
+        incoming.get(edge.to)?.push({ neighbor: edge.from, type: edge.type });
+    }
+    for (const domain of includedDomains) {
+        lines.push(domain.name);
+        const outs = outgoing.get(domain.name) ?? [];
+        const ins = incoming.get(domain.name) ?? [];
+        for (const entry of outs) {
+            lines.push(`  → ${entry.neighbor} [${entry.type}]`);
+        }
+        for (const entry of ins) {
+            lines.push(`  ← ${entry.neighbor} [${entry.type}]`);
+        }
+        lines.push("");
+    }
+    // Remove trailing empty line
+    if (lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    return lines.join("\n");
+}
+export function generateContextMap(domains, config, opts) {
+    const includeObserved = opts.includeObserved ?? true;
+    const includedNames = collectIncludedDomains(domains, config, opts.domain);
+    const edges = collectEdges(domains, config, includedNames, includeObserved);
+    if (opts.format === "mermaid") {
+        return formatMermaid(includedNames, edges);
+    }
+    return formatText(domains, includedNames, edges);
+}
+//# sourceMappingURL=contextMap.js.map

package/dist/domain/contextMap.js.map

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

package/dist/domain/domainAnalysis.d.ts

@@ -0,0 +1,25 @@
+import type { DomainConfig } from "./types.js";
+/**
+ * Scan eventSheets/, layouts/, and scripts/ directories and return files
+ * that classifyFile() returns null for (sorted).
+ */
+export declare function listUncategorized(rootDir: string, config: DomainConfig): string[];
+/**
+ * Check each key in config.overrides — return keys that point to non-existent files (sorted).
+ */
+export declare function listStaleOverrides(rootDir: string, config: DomainConfig): string[];
+/**
+ * Collect all valid domain and subdomain names from the config.
+ */
+export declare function collectValidDomainNames(config: DomainConfig): Set<string>;
+/**
+ * Validate override keys have a recognized path prefix.
+ * Returns error strings for invalid keys. Empty array = all valid.
+ */
+export declare function validateOverrideKeys(keys: string[]): string[];
+/**
+ * Validate override values are known domain/subdomain names.
+ * Returns error strings for invalid values. Empty array = all valid.
+ */
+export declare function validateOverrideValues(entries: Record<string, string>, validNames: Set<string>): string[];
+//# sourceMappingURL=domainAnalysis.d.ts.map

package/dist/domain/domainAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainAnalysis.d.ts","sourceRoot":"","sources":["../../src/domain/domainAnalysis.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiC/C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAwCjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAYlF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CASzE;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAU7D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,MAAM,EAAE,CAgBV"}

package/dist/domain/domainAnalysis.js

@@ -0,0 +1,136 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { openProject } from "@genvidtech/c3source";
+import { classifyFile } from "./classification.js";
+/**
+ * Recursively collect all files under a directory, returning paths relative to baseDir.
+ * Returns an empty array if the directory doesn't exist.
+ */
+function collectFiles(dir, baseDir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...collectFiles(fullPath, baseDir));
+        }
+        else {
+            results.push(path.relative(baseDir, fullPath).replace(/\\/g, "/"));
+        }
+    }
+    return results;
+}
+/**
+ * Collect root-level .ts files in a directory (non-recursive).
+ * Returns paths relative to baseDir.
+ */
+function collectRootTsFiles(dir, baseDir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isFile() && e.name.endsWith(".ts"))
+        .map((e) => path.relative(baseDir, path.join(dir, e.name)).replace(/\\/g, "/"));
+}
+/**
+ * Scan eventSheets/, layouts/, and scripts/ directories and return files
+ * that classifyFile() returns null for (sorted).
+ */
+export function listUncategorized(rootDir, config) {
+    const uncategorized = [];
+    const project = openProject(rootDir);
+    // EventSheets
+    const eventSheetFiles = collectFiles(project.eventSheetsDir, rootDir);
+    for (const file of eventSheetFiles) {
+        if (classifyFile(file, "eventSheet", config) === null) {
+            uncategorized.push(file);
+        }
+    }
+    // Layouts
+    const layoutFiles = collectFiles(project.layoutsDir, rootDir);
+    for (const file of layoutFiles) {
+        if (classifyFile(file, "layout", config) === null) {
+            uncategorized.push(file);
+        }
+    }
+    // Scripts: walk shared/, c3-runtime/, common/, ts-defs/ + root-level .ts files
+    const scriptSubdirs = ["shared", "c3-runtime", "common", "ts-defs"];
+    for (const subdir of scriptSubdirs) {
+        const files = collectFiles(path.join(project.scriptsDir, subdir), rootDir);
+        for (const file of files) {
+            if (classifyFile(file, "script", config) === null) {
+                uncategorized.push(file);
+            }
+        }
+    }
+    // Root-level .ts files in scripts/
+    const rootTsFiles = collectRootTsFiles(project.scriptsDir, rootDir);
+    for (const file of rootTsFiles) {
+        if (classifyFile(file, "script", config) === null) {
+            uncategorized.push(file);
+        }
+    }
+    return uncategorized.sort();
+}
+/**
+ * Check each key in config.overrides — return keys that point to non-existent files (sorted).
+ */
+export function listStaleOverrides(rootDir, config) {
+    if (!config.overrides)
+        return [];
+    const stale = [];
+    for (const key of Object.keys(config.overrides)) {
+        const fullPath = path.join(rootDir, key);
+        if (!fs.existsSync(fullPath)) {
+            stale.push(key);
+        }
+    }
+    return stale.sort();
+}
+/**
+ * Collect all valid domain and subdomain names from the config.
+ */
+export function collectValidDomainNames(config) {
+    const names = new Set();
+    for (const key of Object.keys(config.domains)) {
+        names.add(key);
+    }
+    for (const key of Object.keys(config.sharedSubdomains ?? {})) {
+        names.add(key);
+    }
+    return names;
+}
+const VALID_PREFIXES = ["eventSheets/", "layouts/", "scripts/"];
+/**
+ * Validate override keys have a recognized path prefix.
+ * Returns error strings for invalid keys. Empty array = all valid.
+ */
+export function validateOverrideKeys(keys) {
+    const errors = [];
+    for (const key of keys) {
+        if (!VALID_PREFIXES.some((prefix) => key.startsWith(prefix))) {
+            errors.push(`Invalid path prefix: '${key}' — must start with eventSheets/, layouts/, or scripts/`);
+        }
+    }
+    return errors;
+}
+/**
+ * Validate override values are known domain/subdomain names.
+ * Returns error strings for invalid values. Empty array = all valid.
+ */
+export function validateOverrideValues(entries, validNames) {
+    const errors = [];
+    const sortedNames = Array.from(validNames).sort();
+    const suggestion = sortedNames.length <= 5
+        ? sortedNames.join(", ")
+        : sortedNames.slice(0, 5).join(", ") + ", ...";
+    for (const [filePath, domainName] of Object.entries(entries)) {
+        if (!validNames.has(domainName)) {
+            errors.push(`Unknown domain '${domainName}' for path '${filePath}' — valid names: ${suggestion}`);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=domainAnalysis.js.map

package/dist/domain/domainAnalysis.js.map

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

package/dist/domain/domainGenerator.d.ts

@@ -0,0 +1,33 @@
+import type { EventSheet } from "@genvidtech/c3source";
+import type { DomainConfig, DomainData, FunctionDef } from "./types.js";
+import type { Logger } from "@genvidtech/mcp-utils";
+/**
+ * Map c3source's typed `ExtractedFunction` list for a sheet onto our `FunctionDef`
+ * shape: format params to a string, stamp the source sheet, and surface the
+ * custom-ACE `objectClass`/`aceName` that `formatting.ts` renders.
+ */
+export declare function extractFunctionDefs(sheet: EventSheet, sheetName: string): FunctionDef[];
+/**
+ * Top-level (sheet-root ≈ global-scope) event-variable declaration names for a sheet.
+ * Only root-level `variable` events are indexed — cross-sheet references in C3 require
+ * global variables, so root-level declarations are the global-scope approximation.
+ */
+export declare function extractEventVarDecls(sheet: EventSheet): string[];
+/**
+ * Deduped event-variable names referenced by System ACEs anywhere in a sheet's event tree.
+ * Walks every condition and action via `visitEvents`, applying c3source's
+ * `getEventVarReferenceName` (which gates on `objectClass === "System"`).
+ */
+export declare function extractEventVarRefs(sheet: EventSheet): string[];
+export declare function loadConfig(projectRoot: string, fileName: string): Promise<DomainConfig>;
+export declare function findScriptEntries(scriptsDir: string): Array<{
+    relativePath: string;
+    isDirectory: boolean;
+}>;
+export interface ComputeDomainDataResult {
+    domains: DomainData[];
+    unclassified: string[];
+}
+export declare function computeDomainData(rootDir: string, config: DomainConfig, log?: Logger): ComputeDomainDataResult;
+export declare function generateDomainIndex(rootDir: string, outDir: string, projectRoot: string, fileName: string, log?: Logger): Promise<void>;
+//# sourceMappingURL=domainGenerator.d.ts.map

package/dist/domain/domainGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainGenerator.d.ts","sourceRoot":"","sources":["../../src/domain/domainGenerator.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAA8C,MAAM,sBAAsB,CAAC;AAGnG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOpD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CASvF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAiB/D;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ7F;AAKD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAwB3G;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,EACpB,GAAG,GAAE,MAAiB,GACrB,uBAAuB,CAgNzB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAoB,GACxB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}