@mrc2204/agent-smart-memo 5.0.2 → 5.1.0

package/dist/core/contracts/adapter-contracts.d.ts

@@ -17,7 +17,7 @@ export interface CoreRequestEnvelope<TPayload> {
         requestId?: string;
     };
 }
-export type MemoryUseCaseName = "slot.get" | "slot.set" | "slot.list" | "slot.delete" | "project.register" | "project.get" | "project.list" | "project.set_registration_state" | "project.set_tracker_mapping" | "project.register_command" | "project.link_tracker" | "project.trigger_index" | "project.reindex_diff" | "project.index_watch_get" | "project.task_registry_upsert" | "project.task_lineage_context" | "project.hybrid_search" | "project.legacy_backfill" | "project.telegram_onboarding" | "memory.capture" | "memory.search" | "graph.entity.get" | "graph.entity.set" | "graph.rel.add" | "graph.rel.remove" | "graph.search";
+export type MemoryUseCaseName = "slot.get" | "slot.set" | "slot.list" | "slot.delete" | "project.register" | "project.get" | "project.list" | "project.set_registration_state" | "project.set_tracker_mapping" | "project.register_command" | "project.link_tracker" | "project.trigger_index" | "project.reindex_diff" | "project.index_event" | "project.install_hooks" | "project.index_watch_get" | "project.task_registry_upsert" | "project.task_lineage_context" | "project.hybrid_search" | "project.legacy_backfill" | "project.telegram_onboarding" | "memory.capture" | "memory.search" | "graph.entity.get" | "graph.entity.set" | "graph.rel.add" | "graph.rel.remove" | "graph.search";
 export interface MemoryUseCasePort {
     run<TReq, TRes>(useCase: MemoryUseCaseName, req: CoreRequestEnvelope<TReq>): Promise<TRes>;
 }

package/dist/core/contracts/adapter-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-contracts.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/adapter-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;QAClD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,gCAAgC,GAChC,6BAA6B,GAC7B,0BAA0B,GAC1B,sBAAsB,GACtB,uBAAuB,GACvB,sBAAsB,GACtB,yBAAyB,GACzB,8BAA8B,GAC9B,8BAA8B,GAC9B,uBAAuB,GACvB,yBAAyB,GACzB,6BAA6B,GAC7B,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,IAAI,EACZ,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB,CAAC,WAAW;IAC/C,eAAe,CAAC,UAAU,EAAE,WAAW,GAAG,aAAa,CAAC;IACxD,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB,CAAC,WAAW;IAChD,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9C"}
+{"version":3,"file":"adapter-contracts.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/adapter-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ;IAC3C,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;QAClD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,gCAAgC,GAChC,6BAA6B,GAC7B,0BAA0B,GAC1B,sBAAsB,GACtB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,GACrB,uBAAuB,GACvB,yBAAyB,GACzB,8BAA8B,GAC9B,8BAA8B,GAC9B,uBAAuB,GACvB,yBAAyB,GACzB,6BAA6B,GAC7B,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,IAAI,EACZ,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB,CAAC,WAAW;IAC/C,eAAe,CAAC,UAAU,EAAE,WAAW,GAAG,aAAa,CAAC;IACxD,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB,CAAC,WAAW;IAChD,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;CAC9C"}

package/dist/core/ingest/contracts.d.ts

@@ -0,0 +1,44 @@
+export type IngestTriggerType = "bootstrap" | "incremental" | "manual" | "repair";
+export interface IngestPlanInput {
+    project_id: string;
+    source_rev: string;
+    trigger_type: IngestTriggerType;
+    index_profile: string;
+    include_overrides?: string[];
+    max_file_bytes?: number;
+}
+export interface FileCandidateInput {
+    relative_path: string;
+    content: string;
+    bytes?: number;
+}
+export interface FilePlanEntry {
+    relative_path: string;
+    file_id: string;
+    include: boolean;
+    reason: "included" | "ignored_path" | "binary_ext" | "oversized";
+    checksum: string;
+    bytes: number;
+}
+export type SemanticBlockKind = "function" | "class" | "method" | "doc_section" | "doc_paragraph";
+export interface SemanticBlock {
+    kind: SemanticBlockKind;
+    symbol_name: string;
+    semantic_path: string;
+    start_line: number;
+    end_line: number;
+    ordinal: number;
+    text: string;
+}
+export interface ChunkArtifact {
+    chunk_id: string;
+    file_id: string;
+    relative_path: string;
+    chunk_kind: SemanticBlockKind;
+    symbol_id: string | null;
+    checksum: string;
+    semantic_path: string;
+    ordinal: number;
+    text: string;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/core/ingest/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/core/ingest/contracts.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,iBAAiB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,OAAO,GACP,QAAQ,GACR,aAAa,GACb,eAAe,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/core/ingest/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/core/ingest/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/core/ingest/contracts.ts"],"names":[],"mappings":""}

package/dist/core/ingest/ids.d.ts

@@ -0,0 +1,5 @@
+export declare function buildFileId(projectId: string, relativePath: string): string;
+export declare function buildChunkId(fileId: string, chunkKind: string, semanticPath: string, ordinal: number): string;
+export declare function buildSymbolId(projectId: string, relativePath: string, symbolFqn: string): string;
+export declare function checksumOf(raw: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/ingest/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/core/ingest/ids.ts"],"names":[],"mappings":"AAMA,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhG;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/core/ingest/ids.js

@@ -0,0 +1,17 @@
+import { createHash } from "node:crypto";
+function sha1(raw) {
+    return createHash("sha1").update(raw).digest("hex");
+}
+export function buildFileId(projectId, relativePath) {
+    return sha1(`${projectId}:${relativePath}`);
+}
+export function buildChunkId(fileId, chunkKind, semanticPath, ordinal) {
+    return sha1(`${fileId}:${chunkKind}:${semanticPath}:${ordinal}`);
+}
+export function buildSymbolId(projectId, relativePath, symbolFqn) {
+    return sha1(`${projectId}:${relativePath}:${symbolFqn}`);
+}
+export function checksumOf(raw) {
+    return sha1(raw);
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/ingest/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/core/ingest/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,SAAS,IAAI,CAAC,GAAW;IACvB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,YAAoB;IACjE,OAAO,IAAI,CAAC,GAAG,SAAS,IAAI,YAAY,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,SAAiB,EACjB,YAAoB,EACpB,OAAe;IAEf,OAAO,IAAI,CAAC,GAAG,MAAM,IAAI,SAAS,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,YAAoB,EAAE,SAAiB;IACtF,OAAO,IAAI,CAAC,GAAG,SAAS,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/core/ingest/ingest-pipeline.d.ts

@@ -0,0 +1,4 @@
+import type { ChunkArtifact, FileCandidateInput, FilePlanEntry, IngestPlanInput, SemanticBlock } from "./contracts.js";
+export declare function planIngestFiles(input: IngestPlanInput, files: FileCandidateInput[]): FilePlanEntry[];
+export declare function buildChunkArtifacts(projectId: string, fileId: string, relativePath: string, blocks: SemanticBlock[]): ChunkArtifact[];
+//# sourceMappingURL=ingest-pipeline.d.ts.map

package/dist/core/ingest/ingest-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/ingest/ingest-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAoCxB,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,aAAa,EAAE,CA8DpG;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,aAAa,EAAE,GACtB,aAAa,EAAE,CAkBjB"}

package/dist/core/ingest/ingest-pipeline.js

@@ -0,0 +1,105 @@
+import { buildChunkId, buildFileId, buildSymbolId, checksumOf } from "./ids.js";
+const DEFAULT_MAX_FILE_BYTES = 256 * 1024;
+const IGNORED_DIRS = [
+    "node_modules",
+    ".venv",
+    "vendor",
+    "dist",
+    "build",
+    "coverage",
+    ".next",
+    ".git",
+];
+const BINARY_EXT = [
+    "png", "jpg", "jpeg", "gif", "webp", "pdf", "zip", "gz", "tar", "mp4", "mov", "mp3", "wav", "ico", "lockb",
+];
+function isIgnoredPath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, "/");
+    return IGNORED_DIRS.some((dir) => normalized.split("/").includes(dir));
+}
+function hasBinaryExt(relativePath) {
+    const idx = relativePath.lastIndexOf(".");
+    if (idx < 0)
+        return false;
+    const ext = relativePath.slice(idx + 1).toLowerCase();
+    return BINARY_EXT.includes(ext);
+}
+function isIncludeOverride(relativePath, includeOverrides) {
+    return includeOverrides.some((prefix) => relativePath.startsWith(prefix));
+}
+export function planIngestFiles(input, files) {
+    const includeOverrides = input.include_overrides ?? [];
+    const maxFileBytes = input.max_file_bytes ?? DEFAULT_MAX_FILE_BYTES;
+    return files.map((file) => {
+        const bytes = file.bytes ?? Buffer.byteLength(file.content, "utf8");
+        const fileId = buildFileId(input.project_id, file.relative_path);
+        const checksum = checksumOf(file.content);
+        if (isIncludeOverride(file.relative_path, includeOverrides)) {
+            return {
+                relative_path: file.relative_path,
+                file_id: fileId,
+                include: true,
+                reason: "included",
+                checksum,
+                bytes,
+            };
+        }
+        if (isIgnoredPath(file.relative_path)) {
+            return {
+                relative_path: file.relative_path,
+                file_id: fileId,
+                include: false,
+                reason: "ignored_path",
+                checksum,
+                bytes,
+            };
+        }
+        if (hasBinaryExt(file.relative_path)) {
+            return {
+                relative_path: file.relative_path,
+                file_id: fileId,
+                include: false,
+                reason: "binary_ext",
+                checksum,
+                bytes,
+            };
+        }
+        if (bytes > maxFileBytes) {
+            return {
+                relative_path: file.relative_path,
+                file_id: fileId,
+                include: false,
+                reason: "oversized",
+                checksum,
+                bytes,
+            };
+        }
+        return {
+            relative_path: file.relative_path,
+            file_id: fileId,
+            include: true,
+            reason: "included",
+            checksum,
+            bytes,
+        };
+    });
+}
+export function buildChunkArtifacts(projectId, fileId, relativePath, blocks) {
+    return blocks.map((block, ordinal) => {
+        const symbolId = ["function", "class", "method"].includes(block.kind)
+            ? buildSymbolId(projectId, relativePath, block.semantic_path)
+            : null;
+        return {
+            chunk_id: buildChunkId(fileId, block.kind, block.semantic_path, ordinal),
+            file_id: fileId,
+            relative_path: relativePath,
+            chunk_kind: block.kind,
+            symbol_id: symbolId,
+            checksum: checksumOf(block.text),
+            semantic_path: block.semantic_path,
+            ordinal,
+            text: block.text,
+        };
+    });
+}
+//# sourceMappingURL=ingest-pipeline.js.map

package/dist/core/ingest/ingest-pipeline.js.map

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

package/dist/core/ingest/semantic-block-extractor.d.ts

@@ -0,0 +1,9 @@
+import type { SemanticBlock } from "./contracts.js";
+interface ExtractInput {
+    relativePath: string;
+    content: string;
+    maxDocChunkChars?: number;
+}
+export declare function extractSemanticBlocks(input: ExtractInput): SemanticBlock[];
+export {};
+//# sourceMappingURL=semantic-block-extractor.d.ts.map

package/dist/core/ingest/semantic-block-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-block-extractor.d.ts","sourceRoot":"","sources":["../../../src/core/ingest/semantic-block-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,UAAU,YAAY;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA8ID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,EAAE,CAS1E"}

package/dist/core/ingest/semantic-block-extractor.js

@@ -0,0 +1,135 @@
+const DEFAULT_MAX_DOC_CHUNK = 1400;
+function ext(path) {
+    const idx = path.lastIndexOf(".");
+    return idx >= 0 ? path.slice(idx + 1).toLowerCase() : "";
+}
+function isCodeLike(path) {
+    return ["ts", "tsx", "js", "jsx", "mjs", "cjs", "py", "go", "java", "rs"].includes(ext(path));
+}
+function lineOf(content, offset) {
+    return content.slice(0, offset).split("\n").length;
+}
+function findBalancedBlock(content, startOffset) {
+    const firstBrace = content.indexOf("{", startOffset);
+    if (firstBrace < 0) {
+        const lineEnd = content.indexOf("\n", startOffset);
+        const endOffset = lineEnd >= 0 ? lineEnd : content.length;
+        return { text: content.slice(startOffset, endOffset), endOffset };
+    }
+    let depth = 0;
+    for (let i = firstBrace; i < content.length; i++) {
+        const ch = content[i];
+        if (ch === "{")
+            depth += 1;
+        else if (ch === "}") {
+            depth -= 1;
+            if (depth === 0) {
+                return { text: content.slice(startOffset, i + 1), endOffset: i + 1 };
+            }
+        }
+    }
+    return { text: content.slice(startOffset), endOffset: content.length };
+}
+function extractCodeBlocks(relativePath, content) {
+    const blocks = [];
+    const classRegex = /^\s*(?:export\s+)?class\s+([A-Za-z_][\w$]*)/gm;
+    const functionRegex = /^\s*(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_][\w$]*)\s*\(/gm;
+    const methodRegex = /^\s{2,}(?:public\s+|private\s+|protected\s+|static\s+|async\s+)*(?!if\b|for\b|while\b|switch\b|catch\b|return\b|throw\b|else\b)([A-Za-z_][\w$]*)\s*\([^\)]*\)\s*\{/gm;
+    const disallowedMethodNames = new Set(["if", "for", "while", "switch", "catch", "return", "throw", "else"]);
+    let match;
+    while ((match = classRegex.exec(content))) {
+        const symbolName = match[1];
+        const start = match.index;
+        const block = findBalancedBlock(content, start);
+        blocks.push({
+            kind: "class",
+            symbol_name: symbolName,
+            semantic_path: `class:${symbolName}`,
+            start_line: lineOf(content, start),
+            end_line: lineOf(content, block.endOffset),
+            ordinal: blocks.length,
+            text: block.text,
+        });
+    }
+    while ((match = functionRegex.exec(content))) {
+        const symbolName = match[1];
+        const start = match.index;
+        const block = findBalancedBlock(content, start);
+        blocks.push({
+            kind: "function",
+            symbol_name: symbolName,
+            semantic_path: `function:${symbolName}`,
+            start_line: lineOf(content, start),
+            end_line: lineOf(content, block.endOffset),
+            ordinal: blocks.length,
+            text: block.text,
+        });
+    }
+    while ((match = methodRegex.exec(content))) {
+        const symbolName = match[1];
+        if (disallowedMethodNames.has(symbolName))
+            continue;
+        const start = match.index;
+        const block = findBalancedBlock(content, start);
+        blocks.push({
+            kind: "method",
+            symbol_name: symbolName,
+            semantic_path: `method:${symbolName}`,
+            start_line: lineOf(content, start),
+            end_line: lineOf(content, block.endOffset),
+            ordinal: blocks.length,
+            text: block.text,
+        });
+    }
+    return blocks
+        .filter((b, idx, arr) => arr.findIndex((x) => x.semantic_path === b.semantic_path && x.start_line === b.start_line) === idx)
+        .sort((a, b) => a.start_line - b.start_line)
+        .map((b, i) => ({ ...b, ordinal: i }));
+}
+function extractDocBlocks(content, maxDocChunkChars) {
+    const blocks = [];
+    const sections = content
+        .split(/\n(?=#{1,3}\s+)/g)
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const sourceSections = sections.length > 0 ? sections : [content];
+    for (const section of sourceSections) {
+        if (section.length <= maxDocChunkChars) {
+            blocks.push({
+                kind: section.startsWith("#") ? "doc_section" : "doc_paragraph",
+                symbol_name: "doc",
+                semantic_path: section.startsWith("#") ? "doc:section" : "doc:paragraph",
+                start_line: 1,
+                end_line: section.split("\n").length,
+                ordinal: blocks.length,
+                text: section,
+            });
+            continue;
+        }
+        let cursor = 0;
+        while (cursor < section.length) {
+            const slice = section.slice(cursor, cursor + maxDocChunkChars);
+            blocks.push({
+                kind: "doc_paragraph",
+                symbol_name: "doc",
+                semantic_path: "doc:paragraph",
+                start_line: 1,
+                end_line: slice.split("\n").length,
+                ordinal: blocks.length,
+                text: slice,
+            });
+            cursor += maxDocChunkChars;
+        }
+    }
+    return blocks.map((b, i) => ({ ...b, ordinal: i }));
+}
+export function extractSemanticBlocks(input) {
+    const maxDocChunkChars = Math.max(300, input.maxDocChunkChars ?? DEFAULT_MAX_DOC_CHUNK);
+    if (isCodeLike(input.relativePath)) {
+        const codeBlocks = extractCodeBlocks(input.relativePath, input.content);
+        if (codeBlocks.length > 0)
+            return codeBlocks;
+    }
+    return extractDocBlocks(input.content, maxDocChunkChars);
+}
+//# sourceMappingURL=semantic-block-extractor.js.map

package/dist/core/ingest/semantic-block-extractor.js.map

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

package/dist/core/usecases/default-memory-usecase-port.d.ts

@@ -20,6 +20,7 @@ export declare class DefaultMemoryUseCasePort implements MemoryUseCasePort {
     private handleProjectTriggerIndex;
     private scheduleProjectReindexJob;
     private resolveProjectRef;
+    private installProjectGitHooks;
     private validateJiraTrackerFields;
     private tryResolveRepoRootFromCwd;
     private resolveWorkspaceRoot;
@@ -37,6 +38,8 @@ export declare class DefaultMemoryUseCasePort implements MemoryUseCasePort {
     private tryReadGitRemote;
     private collectGitTrackedPaths;
     private handleProjectReindexDiff;
+    private handleProjectIndexEvent;
+    private handleProjectInstallHooks;
     private handleProjectIndexWatchGet;
     private handleProjectTaskRegistryUpsert;
     private handleProjectTaskLineageContext;

package/dist/core/usecases/default-memory-usecase-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-memory-usecase-port.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/default-memory-usecase-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AA4T1E,qBAAa,wBAAyB,YAAW,iBAAiB;IAE9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBADhB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,qBAAqB,YAAA;IAGpD,GAAG,CAAC,IAAI,EAAE,IAAI,EAClB,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IA6DhB,OAAO,CAAC,aAAa;IAqDrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iCAAiC;IAkBzC,OAAO,CAAC,8BAA8B;IAuBtC,OAAO,CAAC,4BAA4B;IA8GpC,OAAO,CAAC,wBAAwB;IAyChC,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,yBAAyB;IAwCjC,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,0BAA0B;IAgGlC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,6BAA6B;IAuBrC,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,gBAAgB;IAmDxB,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,sBAAsB;IA4D9B,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,+BAA+B;IAwBvC,OAAO,CAAC,+BAA+B;IAqBvC,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,+BAA+B;IAmIvC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,oBAAoB;YAuBd,mBAAmB;YAOnB,kBAAkB;IAOhC,OAAO,CAAC,iBAAiB;CAmB1B"}
+{"version":3,"file":"default-memory-usecase-port.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/default-memory-usecase-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAO3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AA4U1E,qBAAa,wBAAyB,YAAW,iBAAiB;IAE9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBADhB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,qBAAqB,YAAA;IAGpD,GAAG,CAAC,IAAI,EAAE,IAAI,EAClB,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAiEhB,OAAO,CAAC,aAAa;IAqDrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iCAAiC;IAkBzC,OAAO,CAAC,8BAA8B;IAuBtC,OAAO,CAAC,4BAA4B;IAiHpC,OAAO,CAAC,wBAAwB;IAyChC,OAAO,CAAC,yBAAyB;IAoCjC,OAAO,CAAC,yBAAyB;IA0CjC,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,0BAA0B;IAgGlC,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,6BAA6B;IAuBrC,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,gBAAgB;IAmDxB,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,sBAAsB;IA+E9B,OAAO,CAAC,wBAAwB;IAiBhC,OAAO,CAAC,uBAAuB;IAyD/B,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,+BAA+B;IAwBvC,OAAO,CAAC,+BAA+B;IAqBvC,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,2BAA2B;IAYnC,OAAO,CAAC,+BAA+B;IAmIvC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,oBAAoB;YAuBd,mBAAmB;YAOnB,kBAAkB;IAOhC,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/core/usecases/default-memory-usecase-port.js

@@ -1,6 +1,6 @@
 import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
+import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, resolve } from "node:path";
 function asRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value)
@@ -75,6 +75,10 @@ export class DefaultMemoryUseCasePort {
                 return this.handleProjectTriggerIndex(payload, req);
             case "project.reindex_diff":
                 return this.handleProjectReindexDiff(payload, req);
+            case "project.index_event":
+                return this.handleProjectIndexEvent(payload, req);
+            case "project.install_hooks":
+                return this.handleProjectInstallHooks(payload, req);
             case "project.index_watch_get":
                 return this.handleProjectIndexWatchGet(payload, req);
             case "project.task_registry_upsert":
@@ -349,6 +353,7 @@ export class DefaultMemoryUseCasePort {
                 note: triggerResult?.note || null,
             };
         }
+        const autoIndexHook = this.installProjectGitHooks(registered.project.project_id, registered.project.repo_root);
         return {
             project_id: registered.project.project_id,
             project_alias: registered.alias.project_alias,
@@ -356,6 +361,7 @@ export class DefaultMemoryUseCasePort {
             validation_status: registered.registration.validation_status,
             completeness_score: Number((registered.registration.completeness_score / 100).toFixed(2)),
             warnings: [],
+            auto_index_hook: autoIndexHook,
             repo_resolution: {
                 resolution: selection.resolution,
                 clone_policy: selection.clone_policy || "not_applicable",
@@ -460,6 +466,7 @@ export class DefaultMemoryUseCasePort {
                     source_rev: input.sourceRev,
                     trigger_type: input.triggerType,
                     index_profile: input.indexProfile,
+                    full_snapshot: input.triggerType === "bootstrap",
                     paths,
                 });
             }
@@ -483,6 +490,31 @@ export class DefaultMemoryUseCasePort {
         }
         throw new Error("project reference requires project_id or project_alias");
     }
+    installProjectGitHooks(projectId, repoRoot) {
+        if (!repoRoot)
+            return { installed: false, hooks: [], note: 'repo_root_missing' };
+        const gitDir = resolve(repoRoot, '.git');
+        const hooksDir = resolve(gitDir, 'hooks');
+        if (!existsSync(gitDir))
+            return { installed: false, hooks: [], note: 'git_dir_missing' };
+        mkdirSync(hooksDir, { recursive: true });
+        const writeHook = (name, eventType) => {
+            const hookPath = resolve(hooksDir, name);
+            const script = `#!/bin/sh
+PROJECT_ID="${projectId}"
+REPO_ROOT="${repoRoot}"
+SOURCE_REV="$(git rev-parse HEAD 2>/dev/null || echo unknown)"
+CHANGED_FILES="$(git diff-tree --no-commit-id --name-only -r HEAD 2>/dev/null | paste -sd, -)"
+DELETED_FILES="$(git diff-tree --no-commit-id --name-only --diff-filter=D -r HEAD 2>/dev/null | paste -sd, -)"
+asm project-event --project-id "$PROJECT_ID" --repo-root "$REPO_ROOT" --event-type ${eventType} --source-rev "$SOURCE_REV" --changed-files "$CHANGED_FILES" --deleted-files "$DELETED_FILES" >/dev/null 2>&1 || true
+`;
+            writeFileSync(hookPath, script, 'utf8');
+            chmodSync(hookPath, 0o755);
+            return hookPath;
+        };
+        const hooks = [writeHook('post-commit', 'post_commit'), writeHook('post-merge', 'post_merge')];
+        return { installed: true, hooks };
+    }
     validateJiraTrackerFields(trackerSpaceKey, defaultEpicKey) {
         const space = String(trackerSpaceKey || "").trim();
         if (!space) {
@@ -804,11 +836,20 @@ export class DefaultMemoryUseCasePort {
                 .filter((p) => !p.startsWith(".git/"))
                 .map((relativePath) => {
                 const ext = relativePath.includes(".") ? relativePath.split(".").pop() || "" : "";
+                const abs = resolve(repoRoot, relativePath);
+                let content;
+                try {
+                    content = readFileSync(abs, "utf8");
+                }
+                catch {
+                    content = undefined;
+                }
                 return {
                     relative_path: relativePath,
                     checksum: `git:${relativePath}`,
                     module: relativePath.split("/")[0] || undefined,
                     language: ext || undefined,
+                    content,
                 };
             });
         }
@@ -835,12 +876,23 @@ export class DefaultMemoryUseCasePort {
             catch {
                 return [];
             }
-            return files.map((relativePath) => ({
-                relative_path: relativePath,
-                checksum: `fs:${relativePath}`,
-                module: relativePath.split("/")[0] || undefined,
-                language: relativePath.includes(".") ? relativePath.split(".").pop() || undefined : undefined,
-            }));
+            return files.map((relativePath) => {
+                const abs = resolve(repoRoot, relativePath);
+                let content;
+                try {
+                    content = readFileSync(abs, "utf8");
+                }
+                catch {
+                    content = undefined;
+                }
+                return {
+                    relative_path: relativePath,
+                    checksum: `fs:${relativePath}`,
+                    module: relativePath.split("/")[0] || undefined,
+                    language: relativePath.includes(".") ? relativePath.split(".").pop() || undefined : undefined,
+                    content,
+                };
+            });
         }
     }
     handleProjectReindexDiff(payload, req) {
@@ -853,9 +905,72 @@ export class DefaultMemoryUseCasePort {
             source_rev: payload.source_rev,
             trigger_type: payload.trigger_type,
             index_profile: payload.index_profile,
+            full_snapshot: payload.full_snapshot === true,
             paths: payload.paths || [],
         });
     }
+    handleProjectIndexEvent(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (!payload.project_id) {
+            throw new Error("project.index_event requires payload.project_id");
+        }
+        const project = this.slotDb.getProjectById(identity.userId, identity.agentId, payload.project_id);
+        if (!project || !project.repo_root) {
+            throw new Error("project.index_event requires a registered project with repo_root");
+        }
+        const changedFiles = Array.from(new Set((payload.changed_files || []).map((x) => String(x || "").trim()).filter(Boolean)));
+        const deletedFiles = Array.from(new Set((payload.deleted_files || []).map((x) => String(x || "").trim()).filter(Boolean)));
+        const paths = changedFiles.map((relativePath) => {
+            const abs = resolve(project.repo_root, relativePath);
+            let content = null;
+            try {
+                content = readFileSync(abs, "utf8");
+            }
+            catch {
+                content = null;
+            }
+            return {
+                relative_path: relativePath,
+                checksum: `event:${relativePath}:${payload.source_rev || "unknown"}`,
+                module: relativePath.split("/")[0] || undefined,
+                language: relativePath.includes(".") ? relativePath.split(".").pop() || undefined : undefined,
+                content,
+            };
+        });
+        const reindex = this.slotDb.reindexProjectByDiff(identity.userId, identity.agentId, {
+            project_id: payload.project_id,
+            source_rev: payload.source_rev || null,
+            trigger_type: "incremental",
+            index_profile: "default",
+            full_snapshot: false,
+            paths,
+        });
+        if (deletedFiles.length > 0) {
+            const tombstoneAt = new Date().toISOString();
+            for (const relativePath of deletedFiles) {
+                this.slotDb.markProjectFileDeletedForEvent(identity.userId, identity.agentId, payload.project_id, relativePath, tombstoneAt);
+            }
+        }
+        return {
+            project_id: payload.project_id,
+            event_type: payload.event_type || "manual",
+            source_rev: payload.source_rev || null,
+            changed_files: changedFiles,
+            deleted_files: deletedFiles,
+            reindex,
+        };
+    }
+    handleProjectInstallHooks(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (!payload.project_id) {
+            throw new Error("project.install_hooks requires payload.project_id");
+        }
+        const project = this.slotDb.getProjectById(identity.userId, identity.agentId, payload.project_id);
+        if (!project) {
+            throw new Error("project.install_hooks requires a registered project");
+        }
+        return this.installProjectGitHooks(project.project_id, project.repo_root);
+    }
     handleProjectIndexWatchGet(payload, req) {
         const identity = normalizePrivateIdentity(req.context);
         if (!payload.project_id) {