@veewo/claw-core 0.2.14 → 0.2.16

package/README.md

@@ -1,16 +1,16 @@
-# @veewo/claw-core
-
-`@veewo/claw-core` is the shared workflow engine behind `claw-kit`.
-
-It provides the core primitives that let `.claw` act as a project-level working surface for config resolution, planning, project recall, truth ingestion, and task retention.
-
-## Responsibilities
-
-- project config normalization and runtime resolution
-- plan lifecycle and workflow guidance primitives
-- project memory and search indexing behavior
-- truth ingestion and retention mechanics
-
-## Repository
-
-- [claw-kit](https://github.com/chanyuenpang/claw-kit)
+# @veewo/claw-core
+
+`@veewo/claw-core` is the shared workflow engine behind `claw-kit`.
+
+It provides the core primitives that let `.claw` act as a project-level working surface for config resolution, planning, project recall, truth ingestion, and task retention.
+
+## Responsibilities
+
+- project config normalization and runtime resolution
+- plan lifecycle and workflow guidance primitives
+- project memory and search indexing behavior
+- truth ingestion and retention mechanics
+
+## Repository
+
+- [claw-kit](https://github.com/chanyuenpang/claw-kit)

package/dist/src/memory.js

@@ -5,11 +5,11 @@ import { spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { DatabaseSync } from "node:sqlite";
 import { fileURLToPath } from "node:url";
-import { resolveProjectContext, resolveTaskContext } from "./context.js";
+import { resolveProjectContext } from "./context.js";
 import { resolveDefaultLocalEmbeddingDimensions } from "./embedding-defaults.js";
 import { requestPersistentEmbedding } from "./embedding-daemon-protocol.js";
 import { ClawError } from "./errors.js";
-import { readJsonFile, readTextFile } from "./io.js";
+import { readTextFile } from "./io.js";
 import { analyzeKnowledgeDocument } from "./knowledge-document.js";
 import { buildProjectKeywordSearchPlan, buildProjectQueryIntent } from "./memory-query.js";
 const DEFAULT_PROJECT_REFRESH_FILE_LIMIT = 100;
@@ -28,32 +28,27 @@ const DEFAULT_PERSISTENT_SEARCH_DATABASE_LIMIT = 2;
 const persistentMemoryDatabases = new Map();
 const projectVectorRowsByDatabase = new WeakMap();
 export function buildMemoryIndex(input) {
-    const { scope, project, task } = resolveMemoryScope(input);
+    const project = resolveProjectContext(input.cwd);
     if (!isProjectMemoryEnabled(project)) {
         return {
-            scope,
-            storePath: getMemoryStorePath(project, scope, task),
+            scope: "project",
+            storePath: getMemoryStorePath(project),
             indexedCount: 0,
             processedFileCount: 0,
             pendingFileCount: 0,
             sources: [],
-            ...(scope === "project" ? { embedding: null, vectorIndex: null } : {}),
+            embedding: null,
+            vectorIndex: null,
         };
     }
-    const storePath = getMemoryStorePath(project, scope, task);
-    const sources = collectMemorySources(project, scope, task);
-    const embedding = scope === "project" ? resolveProjectMemoryEmbeddingConfig(project) : undefined;
+    const storePath = getMemoryStorePath(project);
+    const sources = collectProjectMemorySources(project);
+    const embedding = resolveProjectMemoryEmbeddingConfig(project);
     fs.mkdirSync(path.dirname(storePath), { recursive: true });
     return withMemoryDatabase(storePath, "index refresh", "write", (db) => {
         prepareSchema(db);
-        const syncResult = scope === "project"
-            ? syncProjectMemoryIndex(db, sources, embedding ?? null, input.maxFiles ?? DEFAULT_PROJECT_REFRESH_FILE_LIMIT)
-            : {
-                vectorIndex: rebuildTaskMemoryIndex(db, sources),
-                processedFileCount: sources.length,
-                pendingFileCount: 0,
-            };
-        upsertMetadata(db, "scope", scope);
+        const syncResult = syncProjectMemoryIndex(db, sources, embedding ?? null, input.maxFiles ?? DEFAULT_PROJECT_REFRESH_FILE_LIMIT);
+        upsertMetadata(db, "scope", "project");
         upsertMetadata(db, "indexed_at", new Date().toISOString());
         if (embedding) {
             upsertMetadata(db, "embedding_config", JSON.stringify(embedding));
@@ -70,29 +65,17 @@ export function buildMemoryIndex(input) {
             deleteMetadata(db, "vector_index");
         }
         return {
-            scope,
+            scope: "project",
             storePath,
             indexedCount: sources.length,
             processedFileCount: syncResult.processedFileCount,
             pendingFileCount: syncResult.pendingFileCount,
             sources: sources.map((entry) => entry.sourcePath),
-            ...(scope === "project" ? { embedding, vectorIndex: syncResult.vectorIndex } : {}),
+            embedding,
+            vectorIndex: syncResult.vectorIndex,
         };
     });
 }
-function rebuildTaskMemoryIndex(db, sources) {
-    db.exec("DELETE FROM docs;");
-    db.exec("DELETE FROM docs_fts;");
-    db.exec("DELETE FROM doc_embeddings;");
-    db.exec("DELETE FROM doc_embedding_vectors;");
-    const insertDoc = db.prepare("INSERT INTO docs (source_path, kind, content, content_hash) VALUES (?, ?, ?, ?)");
-    const insertFts = db.prepare("INSERT INTO docs_fts (rowid, source_path, kind, content) VALUES (?, ?, ?, ?)");
-    for (const source of sources) {
-        const result = insertDoc.run(source.sourcePath, source.kind, source.content, hashMemoryContent(source.content));
-        insertFts.run(Number(result.lastInsertRowid), source.sourcePath, source.kind, source.content);
-    }
-    return null;
-}
 function syncProjectMemoryIndex(db, sources, embedding, maxFiles) {
     const currentEmbeddingConfig = embedding ? JSON.stringify(embedding) : null;
     const storedEmbeddingConfig = getMetadata(db, "embedding_config");
@@ -226,37 +209,22 @@ export function searchMemory(input) {
     if (!input.query.trim()) {
         throw new ClawError("MEMORY_QUERY_REQUIRED", "memory search requires a non-empty query.");
     }
-    const { scope, project, task } = resolveMemoryScope(input);
+    const project = resolveProjectContext(input.cwd);
     if (!isProjectMemoryEnabled(project)) {
         throw new ClawError("MEMORY_DISABLED", "Project memory is disabled by .claw/project.json `memory.enabled = false`.", {
-            scope,
+            scope: "project",
             projectRoot: project.projectRoot,
         });
     }
-    const storePath = getMemoryStorePath(project, scope, task);
+    const storePath = getMemoryStorePath(project);
     if (!fs.existsSync(storePath)) {
-        if (scope === "project") {
-            throw new ClawError("MEMORY_VECTOR_INDEX_REQUIRED", "Project search requires a refreshed vector index. Run `claw search index --refresh` first.");
-        }
-        buildMemoryIndex({
-            cwd: input.cwd,
-            scope,
-            ...(task ? { taskName: task.taskName } : {}),
-        });
+        throw new ClawError("MEMORY_VECTOR_INDEX_REQUIRED", "Project search requires a refreshed vector index. Run `claw search index --refresh` first.");
     }
     return withMemoryDatabase(storePath, "search", "read", (db) => {
         prepareSchema(db);
-        const searchResult = scope === "project"
-            ? searchProjectMemoryHybrid(db, input.query, input.limit ?? 10, project)
-            : {
-                results: searchTaskMemoryFts(db, input.query, input.limit ?? 10),
-                telemetry: {
-                    route: "task_fts",
-                    queryEmbedding: "skipped",
-                },
-            };
+        const searchResult = searchProjectMemoryHybrid(db, input.query, input.limit ?? 10, project);
         return {
-            scope,
+            scope: "project",
             storePath,
             results: searchResult.results,
             telemetry: {
@@ -278,15 +246,14 @@ export async function searchMemoryAsync(input) {
     return result;
 }
 async function primePersistentProjectQueryEmbedding(input) {
-    if (input.scope === "task"
-        || process.env.CLAW_EMBEDDING_MOCK === "1"
+    if (process.env.CLAW_EMBEDDING_MOCK === "1"
         || process.env.CLAW_EMBEDDING_PERSISTENT_WORKER === "0"
         || !input.query.trim()) {
         return null;
     }
     const project = resolveProjectContext(input.cwd);
     const embedding = resolveProjectMemoryEmbeddingConfig(project);
-    const storePath = getMemoryStorePath(project, "project");
+    const storePath = getMemoryStorePath(project);
     if (embedding?.provider !== "local" || !fs.existsSync(storePath)) {
         return null;
     }
@@ -321,34 +288,16 @@ async function primePersistentProjectQueryEmbedding(input) {
     return "persistent_daemon";
 }
 export function getMemory(input) {
-    const { scope, project, task } = resolveMemoryScope(input);
-    const storePath = getMemoryStorePath(project, scope, task);
-    const sources = isProjectMemoryEnabled(project) ? collectMemorySources(project, scope, task) : [];
+    const project = resolveProjectContext(input.cwd);
+    const storePath = getMemoryStorePath(project);
+    const sources = isProjectMemoryEnabled(project) ? collectProjectMemorySources(project) : [];
     return {
-        scope,
+        scope: "project",
         storePath,
         sources,
     };
 }
-function resolveMemoryScope(input) {
-    const project = resolveProjectContext(input.cwd);
-    const scope = input.scope ?? "project";
-    if (scope === "task") {
-        if (!input.taskName) {
-            throw new ClawError("TASK_NOT_FOUND", "Task scope memory commands require --task.", { scope });
-        }
-        return {
-            scope,
-            project,
-            task: resolveTaskContext(project, input.taskName),
-        };
-    }
-    return { scope, project };
-}
-function getMemoryStorePath(project, scope, task) {
-    if (scope === "task" && task) {
-        return path.join(task.taskDir, "memory.sqlite");
-    }
+function getMemoryStorePath(project) {
     return path.join(project.clawDir, "memory.sqlite");
 }
 function withMemoryDatabase(storePath, operation, access, callback) {
@@ -431,12 +380,6 @@ function buildMemoryStoreBusyError(storePath, operation, cause) {
         cause: causeMessage,
     });
 }
-function collectMemorySources(project, scope, task) {
-    if (scope === "task" && task) {
-        return collectTaskMemorySources(task);
-    }
-    return collectProjectMemorySources(project);
-}
 function collectProjectMemorySources(project) {
     const sources = [];
     addTextSourceIfExists(sources, path.join(project.clawDir, "memory.md"), "project_memory");
@@ -451,17 +394,6 @@ function collectProjectMemorySources(project) {
     }
     return sources;
 }
-function collectTaskMemorySources(task) {
-    const sources = [];
-    const plan = readJsonFile(task.activePlanPath);
-    sources.push({
-        sourcePath: task.activePlanPath,
-        kind: "active_plan",
-        content: renderStructuredPlanMemory(plan),
-    });
-    addTextSourceIfExists(sources, path.join(task.taskDir, "memory.md"), "task_memory");
-    return sources;
-}
 function addTextSourceIfExists(sources, sourcePath, kind) {
     if (!fs.existsSync(sourcePath) || !fs.statSync(sourcePath).isFile()) {
         return;
@@ -491,40 +423,6 @@ function addExternalDocSources(sources, projectRoot, externalPath) {
         addTextSourceIfExists(sources, filePath, "external_doc");
     }
 }
-function renderStructuredPlanMemory(plan) {
-    const parts = [
-        `# ${plan.title}`,
-        `Status: ${plan.status}`,
-        `Goal: ${plan.goal.text}`,
-    ];
-    if (plan.rules?.length) {
-        parts.push("Rules:");
-        parts.push(...plan.rules.map((rule) => `- ${rule}`));
-    }
-    if (plan.references?.length) {
-        parts.push("References:");
-        parts.push(...plan.references.map((reference) => `- ${reference.why}: ${reference.path}`));
-    }
-    if (plan.keyDecisions?.length) {
-        parts.push("Key Decisions:");
-        parts.push(...plan.keyDecisions.map((decision) => `- ${decision}`));
-    }
-    if (plan.retrospective) {
-        parts.push("Retrospective:");
-        parts.push(`- Summary: ${plan.retrospective.summary}`);
-        for (const item of plan.retrospective.whatWorked ?? []) {
-            parts.push(`- Worked: ${item}`);
-        }
-        for (const item of plan.retrospective.issues ?? []) {
-            parts.push(`- Issue: ${item}`);
-        }
-    }
-    if (plan.tasks.length) {
-        parts.push("Tasks:");
-        parts.push(...plan.tasks.map((task) => `- [${task.status}] ${task.id}: ${task.title}`));
-    }
-    return `${parts.join("\n")}\n`;
-}
 function prepareSchema(db) {
     db.exec([
         "CREATE TABLE IF NOT EXISTS docs (",
@@ -1084,23 +982,6 @@ function resolveEmbeddingDimensions(embedding, fallback) {
     }
     return fallback > 0 ? fallback : 1536;
 }
-function searchTaskMemoryFts(db, query, limit) {
-    const rows = db
-        .prepare([
-        "SELECT source_path, kind, snippet(docs_fts, 2, '[', ']', ' ... ', 18) AS snippet, bm25(docs_fts) AS score",
-        "FROM docs_fts",
-        "WHERE docs_fts MATCH ?",
-        "ORDER BY score ASC",
-        "LIMIT ?",
-    ].join(" "))
-        .all(query, limit);
-    return rows.map((row) => ({
-        sourcePath: row.source_path,
-        kind: row.kind,
-        snippet: row.snippet,
-        score: row.score,
-    }));
-}
 function searchProjectMemoryHybrid(db, query, limit, project) {
     const embedding = resolveProjectMemoryEmbeddingConfig(project);
     if (!embedding) {