@nxuss/lemma 1.32.0 → 1.33.0

package/dist/cjs/languages/csharp/csharpSymbols.d.ts

@@ -0,0 +1,33 @@
+export interface CSharpFileSymbols {
+    namespaces: string[];
+    usings: string[];
+    classes: string[];
+    interfaces: string[];
+    enums: string[];
+    records: string[];
+    structs: string[];
+    /** Best-effort `TypeName.MethodName`; methods that cannot be attributed appear bare. */
+    methods: string[];
+}
+export interface CsprojInfo {
+    targetFrameworks: string[];
+    projectReferences: string[];
+    packageReferences: Array<{
+        name: string;
+        version?: string;
+    }>;
+}
+export declare const CSHARP_MAX_FILE_BYTES = 300000;
+/**
+ * Replace comments and string/char literals with spaces (newlines preserved)
+ * so declaration regexes never match inside them.
+ */
+export declare function maskNonCode(content: string): string;
+/**
+ * Deterministic line-based C# symbol extraction. Documented limits:
+ * methods are attributed to the innermost lexically-open type; expression edge
+ * cases (local functions, lambdas assigned to fields) are ignored by design.
+ */
+export declare function parseCSharpFile(content: string): CSharpFileSymbols;
+export declare function parseCsproj(content: string): CsprojInfo;
+//# sourceMappingURL=csharpSymbols.d.ts.map

package/dist/cjs/languages/csharp/csharpSymbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csharpSymbols.d.ts","sourceRoot":"","sources":["../../../../src/languages/csharp/csharpSymbols.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wFAAwF;IACxF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,eAAO,MAAM,qBAAqB,SAAU,CAAC;AA8B7C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA4GnD;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAgGlE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAgCvD"}

package/dist/cjs/languages/csharp/csharpSymbols.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSHARP_MAX_FILE_BYTES = void 0;
+exports.maskNonCode = maskNonCode;
+exports.parseCSharpFile = parseCSharpFile;
+exports.parseCsproj = parseCsproj;
+exports.CSHARP_MAX_FILE_BYTES = 300000;
+const TYPE_RE = /^\s*(?:\[[^\]]*\]\s*)?(?:(?:public|private|protected|internal|static|sealed|abstract|partial|unsafe|readonly|ref)\s+)*(class|interface|enum|record|struct)\s+(\w+)/;
+const USING_RE = /^\s*using\s+([\w.]+)\s*;/;
+const NAMESPACE_RE = /^\s*namespace\s+([\w.]+)\s*[;{]?/;
+const METHOD_RE = /^\s*(?:(?:public|private|protected|internal|static|virtual|override|abstract|async|sealed|extern|unsafe|new|partial|readonly)\s+)+([\w<>[\],\s?.]+?)\s+(\w+)\s*\(/;
+const CTOR_RE = /^\s*(?:(?:public|private|protected|internal|static|extern|unsafe)\s+)+(\w+)\s*\([^;=]*\)\s*({)?\s*$/;
+const NON_METHOD_NAMES = new Set([
+    "if",
+    "for",
+    "foreach",
+    "while",
+    "switch",
+    "catch",
+    "using",
+    "lock",
+    "fixed",
+    "return",
+    "new",
+    "where",
+    "else",
+    "do",
+    "try",
+    "get",
+    "set",
+]);
+/**
+ * Replace comments and string/char literals with spaces (newlines preserved)
+ * so declaration regexes never match inside them.
+ */
+function maskNonCode(content) {
+    const out = [];
+    let i = 0;
+    const n = content.length;
+    while (i < n) {
+        const c = content[i];
+        const next = content[i + 1];
+        // line comment
+        if (c === "/" && next === "/") {
+            while (i < n && content[i] !== "\n") {
+                out.push(" ");
+                i++;
+            }
+            continue;
+        }
+        // block comment
+        if (c === "/" && next === "*") {
+            out.push(" ", " ");
+            i += 2;
+            while (i < n && !(content[i] === "*" && content[i + 1] === "/")) {
+                out.push(content[i] === "\n" ? "\n" : " ");
+                i++;
+            }
+            out.push(" ", " ");
+            i += 2;
+            continue;
+        }
+        // verbatim / interpolated-verbatim strings @".." $@"" $".."
+        if ((c === "@" && next === '"') ||
+            (c === "$" && (next === "@" || next === '"'))) {
+            // find opening quote
+            let j = i;
+            if (content[j] === "$" && content[j + 1] === "@")
+                j += 2;
+            else
+                j += 1;
+            if (content[j] !== '"') {
+                // not actually a string literal — emit and advance, never stall
+                out.push(" ".repeat(j - i));
+                i = j;
+                continue;
+            }
+            out.push(" ".repeat(j - i + 1));
+            i = j + 1;
+            while (i < n) {
+                if (content[i] === '"' && content[i + 1] === '"') {
+                    out.push(" ", " ");
+                    i += 2;
+                    continue;
+                }
+                if (content[i] === '"') {
+                    out.push(" ");
+                    i++;
+                    break;
+                }
+                out.push(content[i] === "\n" ? "\n" : " ");
+                i++;
+            }
+            continue;
+        }
+        // regular / interpolated string "..."
+        if (c === '"') {
+            out.push(" ");
+            i++;
+            while (i < n) {
+                if (content[i] === "\\" && i + 1 < n) {
+                    out.push(content[i] === "\n" ? "\n" : " ", " ");
+                    i += 2;
+                    continue;
+                }
+                if (content[i] === '"') {
+                    out.push(" ");
+                    i++;
+                    break;
+                }
+                if (content[i] === "\n") {
+                    out.push("\n");
+                    i++;
+                    break;
+                }
+                out.push(" ");
+                i++;
+            }
+            continue;
+        }
+        // char literal '.'
+        if (c === "'") {
+            out.push(" ");
+            i++;
+            while (i < n && content[i] !== "\n") {
+                if (content[i] === "\\" && i + 1 < n) {
+                    out.push(" ", " ");
+                    i += 2;
+                    continue;
+                }
+                out.push(" ");
+                if (content[i] === "'") {
+                    i++;
+                    break;
+                }
+                i++;
+            }
+            continue;
+        }
+        out.push(c);
+        i++;
+    }
+    return out.join("");
+}
+function pushUnique(list, item) {
+    if (item && !list.includes(item))
+        list.push(item);
+}
+/**
+ * Deterministic line-based C# symbol extraction. Documented limits:
+ * methods are attributed to the innermost lexically-open type; expression edge
+ * cases (local functions, lambdas assigned to fields) are ignored by design.
+ */
+function parseCSharpFile(content) {
+    const result = {
+        namespaces: [],
+        usings: [],
+        classes: [],
+        interfaces: [],
+        enums: [],
+        records: [],
+        structs: [],
+        methods: [],
+    };
+    if (content.length > exports.CSHARP_MAX_FILE_BYTES)
+        return result;
+    const masked = maskNonCode(content);
+    const typeStack = [];
+    let depth = 0;
+    for (const rawLine of masked.split("\n")) {
+        const line = rawLine;
+        const usingMatch = line.match(USING_RE);
+        // `using (...)` and `using var x =` are statements, not directives.
+        if (usingMatch &&
+            !/^\s*using\s*\(/.test(line) &&
+            !/^\s*using\s+\w+\s+\w+\s*=/.test(line)) {
+            pushUnique(result.usings, usingMatch[1]);
+        }
+        const nsMatch = line.match(NAMESPACE_RE);
+        if (nsMatch)
+            pushUnique(result.namespaces, nsMatch[1]);
+        const typeMatch = line.match(TYPE_RE);
+        if (typeMatch && !NON_METHOD_NAMES.has(typeMatch[2])) {
+            const [, kind, name] = typeMatch;
+            if (kind === "class")
+                pushUnique(result.classes, name);
+            else if (kind === "interface")
+                pushUnique(result.interfaces, name);
+            else if (kind === "enum")
+                pushUnique(result.enums, name);
+            else if (kind === "record")
+                pushUnique(result.records, name);
+            else if (kind === "struct")
+                pushUnique(result.structs, name);
+            typeStack.push({ name, kind, depth });
+        }
+        else {
+            const methodMatch = line.match(METHOD_RE);
+            if (methodMatch) {
+                const name = methodMatch[2];
+                if (!NON_METHOD_NAMES.has(name)) {
+                    while (typeStack.length > 0 &&
+                        typeStack[typeStack.length - 1].depth > depth)
+                        typeStack.pop();
+                    const owner = typeStack.length > 0 ? typeStack[typeStack.length - 1].name : null;
+                    pushUnique(result.methods, owner ? `${owner}.${name}` : name);
+                }
+            }
+            else {
+                const ctorMatch = line.match(CTOR_RE);
+                if (ctorMatch && !NON_METHOD_NAMES.has(ctorMatch[1])) {
+                    while (typeStack.length > 0 &&
+                        typeStack[typeStack.length - 1].depth > depth)
+                        typeStack.pop();
+                    const owner = typeStack.length > 0 ? typeStack[typeStack.length - 1].name : null;
+                    if (owner && ctorMatch[1] === owner)
+                        pushUnique(result.methods, `${owner}.${owner}`);
+                    else if (!owner)
+                        pushUnique(result.methods, ctorMatch[1]);
+                }
+                else {
+                    // Modifier-less declarations only occur in interfaces
+                    // (`Order? Find(int id);`). Anywhere else `Foo(x);` is a call.
+                    const top = typeStack.length > 0 ? typeStack[typeStack.length - 1] : null;
+                    if (top && top.kind === "interface" && top.depth < depth) {
+                        const im = line.match(/^\s*([\w<>[\],\s?.]+?)\s+(\w+)\s*\([^;{}]*\)\s*;\s*$/);
+                        if (im && !NON_METHOD_NAMES.has(im[2])) {
+                            pushUnique(result.methods, `${top.name}.${im[2]}`);
+                        }
+                    }
+                }
+            }
+        }
+        for (const ch of line) {
+            if (ch === "{")
+                depth++;
+            else if (ch === "}") {
+                depth = Math.max(0, depth - 1);
+                while (typeStack.length > 0 &&
+                    typeStack[typeStack.length - 1].depth >= depth)
+                    typeStack.pop();
+            }
+        }
+    }
+    return result;
+}
+function parseCsproj(content) {
+    const info = {
+        targetFrameworks: [],
+        projectReferences: [],
+        packageReferences: [],
+    };
+    const tfm = content.match(/<TargetFramework>\s*([^<]+?)\s*<\/TargetFramework>/i);
+    if (tfm)
+        pushUnique(info.targetFrameworks, tfm[1].trim());
+    const tfms = content.match(/<TargetFrameworks>\s*([^<]+?)\s*<\/TargetFrameworks>/i);
+    if (tfms)
+        tfms[1]
+            .split(";")
+            .map((s) => s.trim())
+            .filter(Boolean)
+            .forEach((f) => pushUnique(info.targetFrameworks, f));
+    const projRef = content.matchAll(/<ProjectReference\s+Include="([^"]+)"/gi);
+    for (const m of projRef)
+        pushUnique(info.projectReferences, m[1]);
+    const pkgRef = content.matchAll(/<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/gi);
+    for (const m of pkgRef) {
+        if (!info.packageReferences.some((p) => p.name === m[1])) {
+            info.packageReferences.push(m[2] ? { name: m[1], version: m[2] } : { name: m[1] });
+        }
+    }
+    return info;
+}
+//# sourceMappingURL=csharpSymbols.js.map

package/dist/cjs/languages/csharp/csharpSymbols.js.map

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

package/dist/cjs/mcp/cognitiveMap.d.ts

@@ -6,22 +6,51 @@ export interface CognitiveDomain {
     decisions: string[];
     symbols: string[];
 }
+export type CanonIntentBucket = "config" | "routing" | "schemas" | "mcp" | "security" | "subconscious" | "others";
+export type CanonIntent = Record<CanonIntentBucket, string[]>;
+export interface CanonStamp {
+    fileCount: number;
+    fingerprint: string;
+    gitHead: string;
+}
 export interface CognitiveMapSchema {
     workspace: string;
     lastBuilt: string;
+    /** Canon format version. Legacy global maps have no version. */
+    version?: number;
+    projectRoot?: string;
+    projectId?: string;
+    stamp?: CanonStamp;
+    intent?: CanonIntent;
     nodes: Record<string, CognitiveDomain>;
+    /** True when curated fields were carried over from the legacy global map. */
+    migrated?: boolean;
 }
+export declare const CANON_VERSION = 1;
+/** Legacy global map (pre-canon). Kept as read-only migration source. */
 export declare const COG_MAP_FILE: string;
+export declare function canonFileFor(workspaceRoot: string): string;
+export declare function classifyDomain(relPath: string): string;
+export declare function classifyIntent(relPath: string): CanonIntentBucket;
+export declare function emptyIntent(): CanonIntent;
+export declare function buildCanonMap(workspaceRoot: string, prev?: CognitiveMapSchema): CognitiveMapSchema;
+export declare function loadCanonMap(workspaceRoot: string): CognitiveMapSchema | null;
+export declare function saveCanonMap(workspaceRoot: string, map: CognitiveMapSchema): void;
+export interface CanonStatus {
+    map: CognitiveMapSchema;
+    fresh: boolean;
+    rebuilt: boolean;
+    reason: string;
+}
 /**
- * Best-effort domain for a repo-relative file path, so store_memory and the test-oracle
- * auto-store below don't require a human to type `domain` by hand every time.
- *
- * Prefers the persisted Cognitive Map (built via `cognitive_map` action "build") when it
- * has this exact file listed — that reflects an actual workspace scan. Falls back to the
- * same lightweight substring heuristic "build" uses, so a project that never ran "build"
- * still gets a reasonable tag instead of none at all. Returns undefined rather than
- * "general" when nothing matches — an absent domain stays visible to every domain-scoped
- * search (see BrainEntry.domain), while a wrong guess would actively mislead one.
+ * Single entry point for reads. Cheap when fresh: one traversal for the
+ * fingerprint (readdir only, no content reads) + one JSON read. Rebuilds
+ * (with content reads) only when the file set or git HEAD actually changed.
  */
-export declare function deriveDomainForFile(relPath: string): string | undefined;
+export declare function ensureCanonMap(workspaceRoot: string, opts?: {
+    autoBuild?: boolean;
+}): CanonStatus;
+export declare function briefCanon(map: CognitiveMapSchema): string;
+export declare function summarizeIntent(intent: CanonIntent): string;
+export declare function deriveDomainForFile(relPath: string, workspaceRoot?: string): string | undefined;
 //# sourceMappingURL=cognitiveMap.d.ts.map

package/dist/cjs/mcp/cognitiveMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cognitiveMap.d.ts","sourceRoot":"","sources":["../../../src/mcp/cognitiveMap.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,YAAY,QAA0D,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBvE"}
+{"version":3,"file":"cognitiveMap.d.ts","sourceRoot":"","sources":["../../../src/mcp/cognitiveMap.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,KAAK,GACL,UAAU,GACV,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,yEAAyE;AACzE,eAAO,MAAM,YAAY,QAA0D,CAAC;AAEpF,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE1D;AAyBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAmCjE;AAED,wBAAgB,WAAW,IAAI,WAAW,CAUzC;AAkID,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,kBAAkB,GACxB,kBAAkB,CA2EpB;AAeD,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,GACpB,kBAAkB,GAAG,IAAI,CAY3B;AAED,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,kBAAkB,GACtB,IAAI,CAIN;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,kBAAkB,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,CAiDb;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAqB1D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAW3D;AAMD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAsB,GACpC,MAAM,GAAG,SAAS,CA2CpB"}