@folterung/project-memory 0.1.21 → 0.1.22

package/packages/cli/dist/config/load.js

@@ -5,6 +5,10 @@ import { DEFAULT_CONFIG, CONFIG_FILE } from "./types.js";
 function mergeConfig(loaded) {
     return {
         indexing: loaded.indexing ?? DEFAULT_CONFIG.indexing,
+        architectureAnchors: {
+            ...DEFAULT_CONFIG.architectureAnchors,
+            ...loaded.architectureAnchors,
+        },
         phase1: { ...DEFAULT_CONFIG.phase1, ...loaded.phase1 },
         qdrant: { ...DEFAULT_CONFIG.qdrant, ...loaded.qdrant },
         chunk: { ...DEFAULT_CONFIG.chunk, ...loaded.chunk },

package/packages/cli/dist/config/load.js.map

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,SAAS,WAAW,CAAC,MAAiB;IACpC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;QACpD,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;QACtD,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;QACtD,KAAK,EAAE,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE;QACnD,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;IACvD,OAAO,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,SAAS,WAAW,CAAC,MAAiB;IACpC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ;QACpD,mBAAmB,EAAE;YACnB,GAAG,cAAc,CAAC,mBAAmB;YACrC,GAAG,MAAM,CAAC,mBAAmB;SAC9B;QACD,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;QACtD,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;QACtD,KAAK,EAAE,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE;QACnD,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAA0B,CAAC;IACvD,OAAO,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/packages/cli/dist/config/types.d.ts

@@ -3,6 +3,10 @@ export interface MemConfig {
         include?: string[];
         exclude?: string[];
     };
+    architectureAnchors?: {
+        enabled?: boolean;
+        allowOutsideInclude?: boolean;
+    };
     phase1?: {
         maxEntrypointFiles?: number;
         maxEntrypointChunks?: number;
@@ -25,6 +29,10 @@ export declare const DEFAULT_CONFIG: Required<Pick<MemConfig, "phase1" | "qdrant
         include?: string[];
         exclude?: string[];
     };
+    architectureAnchors: {
+        enabled: boolean;
+        allowOutsideInclude: boolean;
+    };
 };
 export declare const CONFIG_DIR = ".mem";
 export declare const CONFIG_FILE = ".mem/config.yml";

package/packages/cli/dist/config/types.js

@@ -1,4 +1,6 @@
+const DEFAULT_ARCHITECTURE_ANCHORS = { enabled: true, allowOutsideInclude: false };
 export const DEFAULT_CONFIG = {
+    architectureAnchors: DEFAULT_ARCHITECTURE_ANCHORS,
     phase1: {
         maxEntrypointFiles: 50,
         maxEntrypointChunks: 300,

package/packages/cli/dist/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,cAAc,GAEoC;IAC7D,MAAM,EAAE;QACN,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,GAAG;KACzB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,gBAAgB;KAC7B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,EAAE;KACb;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,OAAO;KAClB;IACD,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AA2BA,MAAM,4BAA4B,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;AAEnF,MAAM,CAAC,MAAM,cAAc,GAKvB;IACF,mBAAmB,EAAE,4BAA4B;IACjD,MAAM,EAAE;QACN,kBAAkB,EAAE,EAAE;QACtB,mBAAmB,EAAE,GAAG;KACzB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,UAAU,EAAE,gBAAgB;KAC7B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,EAAE;KACb;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,OAAO;KAClB;IACD,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC"}

package/packages/cli/dist/phase2/deep-index.js

@@ -1,13 +1,13 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 import chalk from "chalk";
 import { loadConfig } from "../config/load.js";
 import { chunkFile } from "../chunking/chunker.js";
 import { embedBatch, textWithPathForEmbedding } from "../embedding/stub.js";
 import { createQdrantClient, ensureCollection, upsertPoints } from "../qdrant/upsert.js";
-import { listInScopeFiles } from "../scope/allowlist.js";
+import { listInScopeFiles, toRelativePath } from "../scope/allowlist.js";
 import { createIgnoreFilter } from "../scope/ignore.js";
-import { toRelativePath } from "../scope/allowlist.js";
+import { getArchitectureAnchorKind, listArchitectureAnchorPaths, DEFAULT_SOFT_ANCHOR_ROOTS, DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES, } from "../scope/architecture-anchors.js";
 import { DEEP_INDEX_STATE_FILE } from "../config/types.js";
 const BATCH_SIZE = 8;
 const BATCH_DELAY_MS = 200;
@@ -42,12 +42,36 @@ export async function runDeepIndex(cwd) {
     const config = loadConfig(cwd);
     const isIgnored = createIgnoreFilter(cwd, config.indexing?.exclude ?? []);
     const inScopePaths = listInScopeFiles(cwd, config);
-    const eligiblePaths = [];
+    let eligiblePaths = [];
     for (const abs of inScopePaths) {
         const rel = toRelativePath(cwd, abs);
         if (!isIgnored(rel))
             eligiblePaths.push(abs);
     }
+    const anchorsEnabled = config.architectureAnchors?.enabled !== false;
+    const allowOutsideInclude = config.architectureAnchors?.allowOutsideInclude === true;
+    if (anchorsEnabled && allowOutsideInclude) {
+        const anchorPaths = listArchitectureAnchorPaths(cwd, {
+            allowedRoots: DEFAULT_SOFT_ANCHOR_ROOTS,
+            maxSoftAnchorFileBytes: DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES,
+        });
+        const eligibleSet = new Set(eligiblePaths);
+        for (const abs of anchorPaths) {
+            const rel = toRelativePath(cwd, abs);
+            if (!isIgnored(rel))
+                eligibleSet.add(abs);
+        }
+        eligiblePaths = [...eligibleSet];
+    }
+    const pathToSize = new Map();
+    for (const abs of eligiblePaths) {
+        try {
+            pathToSize.set(toRelativePath(cwd, abs), statSync(abs).size);
+        }
+        catch {
+            // skip
+        }
+    }
     const allChunks = [];
     for (const abs of eligiblePaths) {
         try {
@@ -84,8 +108,18 @@ export async function runDeepIndex(cwd) {
         const vectors = embedBatch(texts);
         const indexedAt = new Date().toISOString();
         const points = batch.map((c, j) => {
+            let kind = "chunk";
+            if (anchorsEnabled) {
+                const anchorKind = getArchitectureAnchorKind(c.metadata.path, {
+                    fileSizeBytes: pathToSize.get(c.metadata.path),
+                    allowedRoots: DEFAULT_SOFT_ANCHOR_ROOTS,
+                    maxSoftAnchorFileBytes: DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES,
+                });
+                if (anchorKind != null)
+                    kind = anchorKind;
+            }
             const payload = {
-                kind: "chunk",
+                kind,
                 path: c.metadata.path,
                 text: texts[j],
                 indexedAt,

package/packages/cli/dist/phase2/deep-index.js.map

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

package/packages/cli/dist/scope/architecture-anchors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Architecture anchors: deterministic path rules for tagging entrypoints, routing,
+ * DI, bootstrap, and config so they can be retrieved for system-overview queries.
+ * Two tiers: hard anchors (explicit paths, always tag) and soft anchors (broader
+ * globs restricted to allowed roots and optional file size).
+ * Binaries (pdf, images, archives, fonts, etc.) are never considered anchors.
+ */
+export type ArchitectureAnchorKind = "entrypoint" | "routing" | "bootstrap" | "di" | "config";
+/** Extensions that are never considered architecture anchors (binaries / non-code). */
+export declare const BINARY_EXTENSIONS: Set<string>;
+/** Default roots under which soft anchors are allowed (reduces false positives). */
+export declare const DEFAULT_SOFT_ANCHOR_ROOTS: string[];
+/** Default max file size (bytes) for soft anchors; larger files are not tagged. */
+export declare const DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES: number;
+export interface GetArchitectureAnchorKindOptions {
+    fileSizeBytes?: number;
+    allowedRoots?: string[];
+    maxSoftAnchorFileBytes?: number;
+}
+/**
+ * Returns the architecture anchor kind for a relative path, or undefined if not an anchor.
+ * Hard anchors (explicit entrypoint/wiring paths) are always tagged when matched.
+ * Soft anchors (broader patterns) are only tagged when path is under allowedRoots
+ * and (when fileSizeBytes is provided) under maxSoftAnchorFileBytes.
+ * Paths with binary extensions are never anchors.
+ */
+export declare function getArchitectureAnchorKind(relativePath: string, options?: GetArchitectureAnchorKindOptions): ArchitectureAnchorKind | undefined;
+export interface ListArchitectureAnchorPathsOptions {
+    allowedRoots?: string[];
+    maxSoftAnchorFileBytes?: number;
+}
+/**
+ * Returns absolute paths of files in the repo that match architecture anchor rules.
+ * Used when allowOutsideInclude is true to merge anchor paths into eligible paths.
+ * Binary extensions are excluded; soft anchors are restricted to allowedRoots and file size.
+ */
+export declare function listArchitectureAnchorPaths(cwd: string, options?: ListArchitectureAnchorPathsOptions): string[];

package/packages/cli/dist/scope/architecture-anchors.js

@@ -0,0 +1,125 @@
+import fg from "fast-glob";
+import { statSync } from "node:fs";
+/** Extensions that are never considered architecture anchors (binaries / non-code). */
+export const BINARY_EXTENSIONS = new Set([
+    "pdf", "png", "jpg", "jpeg", "gif", "ico", "webp", "svg",
+    "woff", "woff2", "ttf", "eot", "otf",
+    "zip", "tar", "gz", "rar", "7z",
+    "exe", "dll", "so", "dylib", "bin",
+]);
+/** Default roots under which soft anchors are allowed (reduces false positives). */
+export const DEFAULT_SOFT_ANCHOR_ROOTS = ["app/", "src/", "public/", "server/", "api/"];
+/** Default max file size (bytes) for soft anchors; larger files are not tagged. */
+export const DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES = 200 * 1024;
+/**
+ * Returns the architecture anchor kind for a relative path, or undefined if not an anchor.
+ * Hard anchors (explicit entrypoint/wiring paths) are always tagged when matched.
+ * Soft anchors (broader patterns) are only tagged when path is under allowedRoots
+ * and (when fileSizeBytes is provided) under maxSoftAnchorFileBytes.
+ * Paths with binary extensions are never anchors.
+ */
+export function getArchitectureAnchorKind(relativePath, options) {
+    const normalized = relativePath.replace(/\\/g, "/");
+    const ext = extFromPath(normalized);
+    if (ext && BINARY_EXTENSIONS.has(ext.toLowerCase())) {
+        return undefined;
+    }
+    const kind = matchHardAnchor(normalized) ?? matchSoftAnchor(normalized, options);
+    return kind;
+}
+function extFromPath(path) {
+    const i = path.lastIndexOf(".");
+    if (i === -1)
+        return "";
+    return path.slice(i + 1);
+}
+/** Hard anchors: explicit, narrow paths. No size/root constraints. */
+function matchHardAnchor(normalized) {
+    const entrypointExts = ["ts", "tsx", "js", "jsx", "html", "php"];
+    if (pathMatches(normalized, "public/index", entrypointExts))
+        return "entrypoint";
+    if (pathMatches(normalized, "src/index", ["ts", "tsx", "js", "jsx"]))
+        return "entrypoint";
+    if (pathMatches(normalized, "server/index", ["ts", "js"]))
+        return "entrypoint";
+    if (pathMatches(normalized, "api/index", ["ts", "js"]))
+        return "entrypoint";
+    if (pathMatches(normalized, "app/index", ["ts", "tsx", "js", "jsx", "php"]))
+        return "entrypoint";
+    if (pathMatches(normalized, "app/routes", ["ts", "js"]))
+        return "routing";
+    if (pathMatches(normalized, "app/dependencies", ["ts", "js"]))
+        return "di";
+    if (pathMatches(normalized, "app/settings", ["ts", "js"]))
+        return "config";
+    return undefined;
+}
+function pathMatches(normalized, prefix, exts) {
+    for (const ext of exts) {
+        if (normalized === `${prefix}.${ext}`)
+            return true;
+    }
+    return false;
+}
+/** Soft anchors: broader patterns, only under allowed roots and optional size cap. */
+function matchSoftAnchor(normalized, options) {
+    const roots = options?.allowedRoots ?? DEFAULT_SOFT_ANCHOR_ROOTS;
+    const underRoot = roots.some((r) => normalized === r.slice(0, -1) || normalized.startsWith(r));
+    if (!underRoot)
+        return undefined;
+    const maxBytes = options?.maxSoftAnchorFileBytes ?? DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES;
+    if (options?.fileSizeBytes != null && options.fileSizeBytes > maxBytes) {
+        return undefined;
+    }
+    if (normalized.includes("/routes/") || /\/routes\.(ts|js)$/.test(normalized))
+        return "routing";
+    if (/\/container[\w.-]*\.(ts|js)$/.test(normalized))
+        return "di";
+    if (/\/di[\w.-]*\.(ts|js)$/.test(normalized))
+        return "di";
+    if (/\/middleware[\w.-]*\.(ts|js)$/.test(normalized))
+        return "bootstrap";
+    if (/\/bootstrap[\w.-]*\.(ts|js)$/.test(normalized))
+        return "bootstrap";
+    if (/\/config[\w.-]*\.(ts|js|yml|yaml)$/.test(normalized))
+        return "config";
+    if (/\/settings[\w.-]*\.(ts|js)$/.test(normalized))
+        return "config";
+    return undefined;
+}
+/**
+ * Returns absolute paths of files in the repo that match architecture anchor rules.
+ * Used when allowOutsideInclude is true to merge anchor paths into eligible paths.
+ * Binary extensions are excluded; soft anchors are restricted to allowedRoots and file size.
+ */
+export function listArchitectureAnchorPaths(cwd, options) {
+    const allowedRoots = options?.allowedRoots ?? DEFAULT_SOFT_ANCHOR_ROOTS;
+    const maxBytes = options?.maxSoftAnchorFileBytes ?? DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES;
+    const files = fg.sync("**/*", {
+        cwd,
+        dot: true,
+        onlyFiles: true,
+        absolute: true,
+        suppressErrors: true,
+    });
+    const result = [];
+    for (const abs of files) {
+        const rel = abs.slice(cwd.length).replace(/^[/\\]+/, "").replace(/\\/g, "/");
+        let fileSizeBytes;
+        try {
+            fileSizeBytes = statSync(abs).size;
+        }
+        catch {
+            continue;
+        }
+        const kind = getArchitectureAnchorKind(rel, {
+            fileSizeBytes,
+            allowedRoots,
+            maxSoftAnchorFileBytes: maxBytes,
+        });
+        if (kind != null)
+            result.push(abs);
+    }
+    return result;
+}
+//# sourceMappingURL=architecture-anchors.js.map

package/packages/cli/dist/scope/architecture-anchors.js.map

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

package/packages/cli/dist/scope/architecture-anchors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/cli/dist/scope/architecture-anchors.test.js

@@ -0,0 +1,58 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import { getArchitectureAnchorKind, BINARY_EXTENSIONS, DEFAULT_SOFT_ANCHOR_ROOTS, } from "./architecture-anchors.js";
+describe("getArchitectureAnchorKind", () => {
+    it("returns undefined for binary extensions", () => {
+        assert.strictEqual(getArchitectureAnchorKind("public/image.png"), undefined);
+        assert.strictEqual(getArchitectureAnchorKind("docs/readme.pdf"), undefined);
+        assert.strictEqual(getArchitectureAnchorKind("dist/app.dll"), undefined);
+    });
+    it("returns entrypoint for hard anchor paths", () => {
+        assert.strictEqual(getArchitectureAnchorKind("public/index.html"), "entrypoint");
+        assert.strictEqual(getArchitectureAnchorKind("src/index.ts"), "entrypoint");
+        assert.strictEqual(getArchitectureAnchorKind("app/index.js"), "entrypoint");
+        assert.strictEqual(getArchitectureAnchorKind("server/index.ts"), "entrypoint");
+        assert.strictEqual(getArchitectureAnchorKind("api/index.js"), "entrypoint");
+    });
+    it("returns routing for app/routes", () => {
+        assert.strictEqual(getArchitectureAnchorKind("app/routes.ts"), "routing");
+        assert.strictEqual(getArchitectureAnchorKind("app/routes.js"), "routing");
+    });
+    it("returns di for app/dependencies and container/di files", () => {
+        assert.strictEqual(getArchitectureAnchorKind("app/dependencies.ts"), "di");
+        assert.strictEqual(getArchitectureAnchorKind("src/container.ts"), "di");
+        assert.strictEqual(getArchitectureAnchorKind("app/di.ts"), "di");
+    });
+    it("returns config for app/settings and config files", () => {
+        assert.strictEqual(getArchitectureAnchorKind("app/settings.ts"), "config");
+        assert.strictEqual(getArchitectureAnchorKind("src/config.ts"), "config");
+        assert.strictEqual(getArchitectureAnchorKind("app/config.local.yml"), "config");
+    });
+    it("returns bootstrap for middleware and bootstrap under allowed roots", () => {
+        assert.strictEqual(getArchitectureAnchorKind("src/middleware.ts"), "bootstrap");
+        assert.strictEqual(getArchitectureAnchorKind("app/bootstrap.ts"), "bootstrap");
+    });
+    it("returns undefined for soft patterns outside allowed roots when roots provided", () => {
+        const roots = ["app/", "src/"];
+        assert.strictEqual(getArchitectureAnchorKind("lib/container.ts", { allowedRoots: roots }), undefined);
+        assert.strictEqual(getArchitectureAnchorKind("app/container.ts", { allowedRoots: roots }), "di");
+    });
+    it("returns undefined for soft anchor when file size over threshold", () => {
+        const overLimit = DEFAULT_SOFT_ANCHOR_ROOTS.length ? 300 * 1024 : 0;
+        assert.strictEqual(getArchitectureAnchorKind("src/config.ts", { fileSizeBytes: overLimit }), undefined);
+        assert.strictEqual(getArchitectureAnchorKind("src/config.ts", { fileSizeBytes: 1000 }), "config");
+    });
+    it("returns chunk-like path as undefined when not matching anchor", () => {
+        assert.strictEqual(getArchitectureAnchorKind("src/utils/helper.ts"), undefined);
+        assert.strictEqual(getArchitectureAnchorKind("app/components/Button.tsx"), undefined);
+    });
+});
+describe("BINARY_EXTENSIONS", () => {
+    it("includes common binary types", () => {
+        assert(BINARY_EXTENSIONS.has("pdf"));
+        assert(BINARY_EXTENSIONS.has("png"));
+        assert(BINARY_EXTENSIONS.has("woff2"));
+        assert(BINARY_EXTENSIONS.has("dll"));
+    });
+});
+//# sourceMappingURL=architecture-anchors.test.js.map

package/packages/cli/dist/scope/architecture-anchors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-anchors.test.js","sourceRoot":"","sources":["../../src/scope/architecture-anchors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,EAAE,YAAY,CAAC,CAAC;QACjF,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC;QAC5E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC;QAC5E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,YAAY,CAAC,CAAC;QAC/E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,CAAC;QAC1E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC,CAAC;QACxE,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzE,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC,CAAC;QAChF,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,WAAW,CAChB,yBAAyB,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EACtE,SAAS,CACV,CAAC;QACF,MAAM,CAAC,WAAW,CAChB,yBAAyB,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EACtE,IAAI,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,SAAS,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,WAAW,CAChB,yBAAyB,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,EACxE,SAAS,CACV,CAAC;QACF,MAAM,CAAC,WAAW,CAChB,yBAAyB,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EACnE,QAAQ,CACT,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,qBAAqB,CAAC,EAAE,SAAS,CAAC,CAAC;QAChF,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,2BAA2B,CAAC,EAAE,SAAS,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/packages/cli/src/config/load.ts

@@ -7,6 +7,10 @@ import { DEFAULT_CONFIG, CONFIG_FILE } from "./types.js";
 function mergeConfig(loaded: MemConfig): MemConfig {
   return {
     indexing: loaded.indexing ?? DEFAULT_CONFIG.indexing,
+    architectureAnchors: {
+      ...DEFAULT_CONFIG.architectureAnchors,
+      ...loaded.architectureAnchors,
+    },
     phase1: { ...DEFAULT_CONFIG.phase1, ...loaded.phase1 },
     qdrant: { ...DEFAULT_CONFIG.qdrant, ...loaded.qdrant },
     chunk: { ...DEFAULT_CONFIG.chunk, ...loaded.chunk },

package/packages/cli/src/config/types.ts

@@ -3,6 +3,10 @@ export interface MemConfig {
     include?: string[];
     exclude?: string[];
   };
+  architectureAnchors?: {
+    enabled?: boolean;
+    allowOutsideInclude?: boolean;
+  };
   phase1?: {
     maxEntrypointFiles?: number;
     maxEntrypointChunks?: number;
@@ -21,9 +25,15 @@ export interface MemConfig {
   };
 }
 
+const DEFAULT_ARCHITECTURE_ANCHORS = { enabled: true, allowOutsideInclude: false };
+
 export const DEFAULT_CONFIG: Required<
   Pick<MemConfig, "phase1" | "qdrant" | "chunk" | "embedding">
-> & { indexing: { include?: string[]; exclude?: string[] } } = {
+> & {
+  indexing: { include?: string[]; exclude?: string[] };
+  architectureAnchors: { enabled: boolean; allowOutsideInclude: boolean };
+} = {
+  architectureAnchors: DEFAULT_ARCHITECTURE_ANCHORS,
   phase1: {
     maxEntrypointFiles: 50,
     maxEntrypointChunks: 300,

package/packages/cli/src/phase2/deep-index.ts

@@ -1,4 +1,4 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 import chalk from "chalk";
 import { loadConfig } from "../config/load.js";
@@ -6,9 +6,14 @@ import { chunkFile } from "../chunking/chunker.js";
 import type { Chunk } from "../chunking/types.js";
 import { embedBatch, textWithPathForEmbedding } from "../embedding/stub.js";
 import { createQdrantClient, ensureCollection, upsertPoints } from "../qdrant/upsert.js";
-import { listInScopeFiles } from "../scope/allowlist.js";
+import { listInScopeFiles, toRelativePath } from "../scope/allowlist.js";
 import { createIgnoreFilter } from "../scope/ignore.js";
-import { toRelativePath } from "../scope/allowlist.js";
+import {
+  getArchitectureAnchorKind,
+  listArchitectureAnchorPaths,
+  DEFAULT_SOFT_ANCHOR_ROOTS,
+  DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES,
+} from "../scope/architecture-anchors.js";
 import { DEEP_INDEX_STATE_FILE } from "../config/types.js";
 
 const BATCH_SIZE = 8;
@@ -51,12 +56,36 @@ export async function runDeepIndex(cwd: string): Promise<void> {
   const config = loadConfig(cwd);
   const isIgnored = createIgnoreFilter(cwd, config.indexing?.exclude ?? []);
   const inScopePaths = listInScopeFiles(cwd, config);
-  const eligiblePaths: string[] = [];
+  let eligiblePaths: string[] = [];
   for (const abs of inScopePaths) {
     const rel = toRelativePath(cwd, abs);
     if (!isIgnored(rel)) eligiblePaths.push(abs);
   }
 
+  const anchorsEnabled = config.architectureAnchors?.enabled !== false;
+  const allowOutsideInclude = config.architectureAnchors?.allowOutsideInclude === true;
+  if (anchorsEnabled && allowOutsideInclude) {
+    const anchorPaths = listArchitectureAnchorPaths(cwd, {
+      allowedRoots: DEFAULT_SOFT_ANCHOR_ROOTS,
+      maxSoftAnchorFileBytes: DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES,
+    });
+    const eligibleSet = new Set(eligiblePaths);
+    for (const abs of anchorPaths) {
+      const rel = toRelativePath(cwd, abs);
+      if (!isIgnored(rel)) eligibleSet.add(abs);
+    }
+    eligiblePaths = [...eligibleSet];
+  }
+
+  const pathToSize = new Map<string, number>();
+  for (const abs of eligiblePaths) {
+    try {
+      pathToSize.set(toRelativePath(cwd, abs), statSync(abs).size);
+    } catch {
+      // skip
+    }
+  }
+
   const allChunks: Chunk[] = [];
   for (const abs of eligiblePaths) {
     try {
@@ -97,8 +126,17 @@ export async function runDeepIndex(cwd: string): Promise<void> {
     const vectors = embedBatch(texts);
     const indexedAt = new Date().toISOString();
     const points = batch.map((c, j) => {
+      let kind = "chunk";
+      if (anchorsEnabled) {
+        const anchorKind = getArchitectureAnchorKind(c.metadata.path, {
+          fileSizeBytes: pathToSize.get(c.metadata.path),
+          allowedRoots: DEFAULT_SOFT_ANCHOR_ROOTS,
+          maxSoftAnchorFileBytes: DEFAULT_MAX_SOFT_ANCHOR_FILE_BYTES,
+        });
+        if (anchorKind != null) kind = anchorKind;
+      }
       const payload: { kind: string; path: string; text: string; startLine?: number; endLine?: number; symbol?: string; indexedAt: string; source: string } = {
-        kind: "chunk",
+        kind,
         path: c.metadata.path,
         text: texts[j],
         indexedAt,

package/packages/cli/src/scope/architecture-anchors.test.ts

@@ -0,0 +1,83 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import {
+  getArchitectureAnchorKind,
+  BINARY_EXTENSIONS,
+  DEFAULT_SOFT_ANCHOR_ROOTS,
+} from "./architecture-anchors.js";
+
+describe("getArchitectureAnchorKind", () => {
+  it("returns undefined for binary extensions", () => {
+    assert.strictEqual(getArchitectureAnchorKind("public/image.png"), undefined);
+    assert.strictEqual(getArchitectureAnchorKind("docs/readme.pdf"), undefined);
+    assert.strictEqual(getArchitectureAnchorKind("dist/app.dll"), undefined);
+  });
+
+  it("returns entrypoint for hard anchor paths", () => {
+    assert.strictEqual(getArchitectureAnchorKind("public/index.html"), "entrypoint");
+    assert.strictEqual(getArchitectureAnchorKind("src/index.ts"), "entrypoint");
+    assert.strictEqual(getArchitectureAnchorKind("app/index.js"), "entrypoint");
+    assert.strictEqual(getArchitectureAnchorKind("server/index.ts"), "entrypoint");
+    assert.strictEqual(getArchitectureAnchorKind("api/index.js"), "entrypoint");
+  });
+
+  it("returns routing for app/routes", () => {
+    assert.strictEqual(getArchitectureAnchorKind("app/routes.ts"), "routing");
+    assert.strictEqual(getArchitectureAnchorKind("app/routes.js"), "routing");
+  });
+
+  it("returns di for app/dependencies and container/di files", () => {
+    assert.strictEqual(getArchitectureAnchorKind("app/dependencies.ts"), "di");
+    assert.strictEqual(getArchitectureAnchorKind("src/container.ts"), "di");
+    assert.strictEqual(getArchitectureAnchorKind("app/di.ts"), "di");
+  });
+
+  it("returns config for app/settings and config files", () => {
+    assert.strictEqual(getArchitectureAnchorKind("app/settings.ts"), "config");
+    assert.strictEqual(getArchitectureAnchorKind("src/config.ts"), "config");
+    assert.strictEqual(getArchitectureAnchorKind("app/config.local.yml"), "config");
+  });
+
+  it("returns bootstrap for middleware and bootstrap under allowed roots", () => {
+    assert.strictEqual(getArchitectureAnchorKind("src/middleware.ts"), "bootstrap");
+    assert.strictEqual(getArchitectureAnchorKind("app/bootstrap.ts"), "bootstrap");
+  });
+
+  it("returns undefined for soft patterns outside allowed roots when roots provided", () => {
+    const roots = ["app/", "src/"];
+    assert.strictEqual(
+      getArchitectureAnchorKind("lib/container.ts", { allowedRoots: roots }),
+      undefined
+    );
+    assert.strictEqual(
+      getArchitectureAnchorKind("app/container.ts", { allowedRoots: roots }),
+      "di"
+    );
+  });
+
+  it("returns undefined for soft anchor when file size over threshold", () => {
+    const overLimit = DEFAULT_SOFT_ANCHOR_ROOTS.length ? 300 * 1024 : 0;
+    assert.strictEqual(
+      getArchitectureAnchorKind("src/config.ts", { fileSizeBytes: overLimit }),
+      undefined
+    );
+    assert.strictEqual(
+      getArchitectureAnchorKind("src/config.ts", { fileSizeBytes: 1000 }),
+      "config"
+    );
+  });
+
+  it("returns chunk-like path as undefined when not matching anchor", () => {
+    assert.strictEqual(getArchitectureAnchorKind("src/utils/helper.ts"), undefined);
+    assert.strictEqual(getArchitectureAnchorKind("app/components/Button.tsx"), undefined);
+  });
+});
+
+describe("BINARY_EXTENSIONS", () => {
+  it("includes common binary types", () => {
+    assert(BINARY_EXTENSIONS.has("pdf"));
+    assert(BINARY_EXTENSIONS.has("png"));
+    assert(BINARY_EXTENSIONS.has("woff2"));
+    assert(BINARY_EXTENSIONS.has("dll"));
+  });
+});