pulseed 0.1.4 → 0.2.0

package/dist/platform/knowledge/knowledge-manager.d.ts

@@ -0,0 +1,128 @@
+import { StateManager } from "../../base/state/state-manager.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { IPromptGateway } from "../../prompt/gateway.js";
+import type { Task } from "../../base/types/task.js";
+import type { KnowledgeEntry, KnowledgeGapSignal, ContradictionResult, SharedKnowledgeEntry, DomainStability, DecisionRecord } from "../../base/types/knowledge.js";
+import type { VectorIndex } from "./vector-index.js";
+import type { IEmbeddingClient } from "./embedding-client.js";
+import { searchKnowledge, searchAcrossGoals, searchByEmbedding, querySharedKnowledge } from "./knowledge-search.js";
+import { classifyDomainStability, getStaleEntries, generateRevalidationTasks, computeRevalidationDue } from "./knowledge-revalidation.js";
+import type { ToolExecutor } from "../../tools/executor.js";
+import type { ToolCallContext } from "../../tools/types.js";
+export { searchKnowledge, searchAcrossGoals, searchByEmbedding, querySharedKnowledge, classifyDomainStability, getStaleEntries, generateRevalidationTasks, computeRevalidationDue, };
+export { detectKnowledgeGap, generateAcquisitionTask, checkContradiction } from "./knowledge-manager-query.js";
+/**
+ * KnowledgeManager detects knowledge gaps, generates research tasks,
+ * and persists/retrieves domain knowledge entries.
+ *
+ * File layout:
+ *   <base>/goals/<goal_id>/domain_knowledge.json
+ *   <base>/memory/shared-knowledge/entries.json  (Phase 2 shared KB)
+ */
+export declare class KnowledgeManager {
+    private readonly stateManager;
+    private readonly llmClient;
+    private readonly vectorIndex?;
+    private readonly embeddingClient?;
+    private readonly gateway?;
+    constructor(stateManager: StateManager, llmClient: ILLMClient, vectorIndex?: VectorIndex, embeddingClient?: IEmbeddingClient, gateway?: IPromptGateway);
+    detectKnowledgeGap(context: {
+        observations: unknown[];
+        strategies: unknown[] | null | undefined;
+        confidence: number;
+    }): Promise<KnowledgeGapSignal | null>;
+    generateAcquisitionTask(signal: KnowledgeGapSignal, goalId: string): Promise<Task>;
+    /**
+     * Persist a KnowledgeEntry to ~/.pulseed/goals/<goal_id>/domain_knowledge.json
+     */
+    saveKnowledge(goalId: string, entry: KnowledgeEntry): Promise<void>;
+    /**
+     * Load knowledge entries for a goal, optionally filtered by tags (exact match).
+     *
+     * An entry matches if ALL provided tags appear in the entry's tags array.
+     */
+    loadKnowledge(goalId: string, tags?: string[]): Promise<KnowledgeEntry[]>;
+    checkContradiction(goalId: string, newEntry: KnowledgeEntry): Promise<ContradictionResult>;
+    /**
+     * Returns knowledge entries whose tags include the given dimension name.
+     */
+    getRelevantKnowledge(goalId: string, dimensionName: string): Promise<KnowledgeEntry[]>;
+    /**
+     * Semantic search within a single goal's knowledge entries via VectorIndex.
+     * Falls back to an empty array when no VectorIndex is configured.
+     */
+    searchKnowledge(query: string, topK?: number): Promise<KnowledgeEntry[]>;
+    /**
+     * Cross-goal semantic search. Leverages the VectorIndex which is global
+     * across all goals. Returns entries from any goal ordered by similarity.
+     * Falls back to an empty array when no VectorIndex is configured.
+     */
+    searchAcrossGoals(query: string, topK?: number): Promise<KnowledgeEntry[]>;
+    /**
+     * Save a KnowledgeEntry into the shared knowledge base, associating it with
+     * the given goalId. If VectorIndex is available the entry is also embedded
+     * and the embedding_id is stored on the returned SharedKnowledgeEntry.
+     */
+    saveToSharedKnowledgeBase(entry: KnowledgeEntry, goalId: string): Promise<SharedKnowledgeEntry>;
+    /**
+     * Query the shared knowledge base by tags (AND logic).
+     * Optionally filter to entries contributed by a specific goal.
+     */
+    querySharedKnowledge(tags: string[], goalId?: string): Promise<SharedKnowledgeEntry[]>;
+    /**
+     * Semantic search across the shared knowledge base using VectorIndex.
+     * Falls back to an empty array when no VectorIndex is configured.
+     */
+    searchByEmbedding(query: string, topK?: number): Promise<{
+        entry: SharedKnowledgeEntry;
+        similarity: number;
+    }[]>;
+    /**
+     * Classify the domain stability of a set of knowledge entries via LLM.
+     * Returns "stable", "moderate", or "volatile".
+     */
+    classifyDomainStability(domain: string, entries: KnowledgeEntry[]): Promise<DomainStability>;
+    /**
+     * Return shared knowledge entries whose revalidation_due_at is in the past.
+     */
+    getStaleEntries(): Promise<SharedKnowledgeEntry[]>;
+    /**
+     * Generate KnowledgeAcquisitionTask-style Task objects for each stale entry,
+     * re-asking the original question.
+     */
+    generateRevalidationTasks(staleEntries: SharedKnowledgeEntry[]): Promise<Task[]>;
+    /**
+     * Save a DecisionRecord to ~/.pulseed/decisions/<goalId>-<timestamp>.json
+     * For completed records (outcome !== "pending"), enriches with LLM-extracted
+     * what_worked/what_failed/suggested_next before saving.
+     */
+    recordDecision(record: DecisionRecord): Promise<void>;
+    /**
+     * Enrich a completed DecisionRecord by extracting what_worked/what_failed/suggested_next via LLM.
+     * Falls back to default empty arrays on LLM failure.
+     */
+    enrichDecisionRecord(record: DecisionRecord): Promise<DecisionRecord>;
+    /**
+     * Load decision records filtered by goal_type, sorted by recency.
+     * Applies time-decay scoring (1.0 at day 0, 0.0 at day 30+).
+     */
+    queryDecisions(goalType: string, limit?: number): Promise<DecisionRecord[]>;
+    /**
+     * Update the outcome of a DecisionRecord identified by strategy_id.
+     * Finds the most recent pending record for the given strategy and rewrites it.
+     * No-op when no matching pending record is found.
+     */
+    updateDecisionOutcome(strategyId: string, outcome: "success" | "failure"): Promise<void>;
+    /**
+     * Remove decision records older than 90 days.
+     * Returns the count of purged records.
+     */
+    purgeOldDecisions(): Promise<number>;
+    private _loadDomainKnowledge;
+    /**
+     * Acquire knowledge by planning and executing tool calls, then synthesizing results via LLM.
+     * Uses read-only tools (glob, grep, read, http_fetch, json_query, shell) to gather data.
+     */
+    acquireWithTools(question: string, goalId: string, toolExecutor: ToolExecutor, context: ToolCallContext): Promise<KnowledgeEntry[]>;
+}
+//# sourceMappingURL=knowledge-manager.d.ts.map

package/dist/platform/knowledge/knowledge-manager.d.ts.map

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

package/dist/platform/knowledge/knowledge-manager.js

@@ -0,0 +1,301 @@
+import { KnowledgeEntrySchema, DomainKnowledgeSchema, SharedKnowledgeEntrySchema, } from "../../base/types/knowledge.js";
+import { searchKnowledge, searchAcrossGoals, searchByEmbedding, querySharedKnowledge, loadSharedEntries, loadDomainKnowledge, } from "./knowledge-search.js";
+import { classifyDomainStability, getStaleEntries, generateRevalidationTasks, computeRevalidationDue, } from "./knowledge-revalidation.js";
+import { recordDecision, enrichDecisionRecord, queryDecisions, updateDecisionOutcome, purgeOldDecisions, } from "./knowledge-decisions.js";
+import { detectKnowledgeGap as _detectKnowledgeGap, generateAcquisitionTask as _generateAcquisitionTask, checkContradiction as _checkContradiction, } from "./knowledge-manager-query.js";
+// Re-export for backward compatibility
+export { searchKnowledge, searchAcrossGoals, searchByEmbedding, querySharedKnowledge, classifyDomainStability, getStaleEntries, generateRevalidationTasks, computeRevalidationDue, };
+// Re-export standalone LLM query functions
+export { detectKnowledgeGap, generateAcquisitionTask, checkContradiction } from "./knowledge-manager-query.js";
+// ─── KnowledgeManager ───
+/** Key used to store all SharedKnowledgeEntries as a flat array. */
+const SHARED_KB_PATH = "memory/shared-knowledge/entries.json";
+/**
+ * KnowledgeManager detects knowledge gaps, generates research tasks,
+ * and persists/retrieves domain knowledge entries.
+ *
+ * File layout:
+ *   <base>/goals/<goal_id>/domain_knowledge.json
+ *   <base>/memory/shared-knowledge/entries.json  (Phase 2 shared KB)
+ */
+export class KnowledgeManager {
+    stateManager;
+    llmClient;
+    vectorIndex;
+    embeddingClient;
+    gateway;
+    constructor(stateManager, llmClient, vectorIndex, embeddingClient, gateway) {
+        this.stateManager = stateManager;
+        this.llmClient = llmClient;
+        this.vectorIndex = vectorIndex;
+        this.embeddingClient = embeddingClient;
+        this.gateway = gateway;
+    }
+    // ─── detectKnowledgeGap ───
+    async detectKnowledgeGap(context) {
+        return _detectKnowledgeGap({ llmClient: this.llmClient, gateway: this.gateway, stateManager: this.stateManager }, context);
+    }
+    // ─── generateAcquisitionTask ───
+    async generateAcquisitionTask(signal, goalId) {
+        return _generateAcquisitionTask({ llmClient: this.llmClient, gateway: this.gateway, stateManager: this.stateManager }, signal, goalId);
+    }
+    // ─── saveKnowledge ───
+    /**
+     * Persist a KnowledgeEntry to ~/.pulseed/goals/<goal_id>/domain_knowledge.json
+     */
+    async saveKnowledge(goalId, entry) {
+        const parsed = KnowledgeEntrySchema.parse(entry);
+        const domainKnowledge = await this._loadDomainKnowledge(goalId);
+        domainKnowledge.entries.push(parsed);
+        domainKnowledge.last_updated = new Date().toISOString();
+        const validated = DomainKnowledgeSchema.parse(domainKnowledge);
+        // Phase 2: index in VectorIndex first so writeRaw is the commit point.
+        // If writeRaw fails, roll back the vector index entry to keep consistency.
+        if (this.vectorIndex) {
+            await this.vectorIndex.add(parsed.entry_id, `${parsed.question} ${parsed.answer}`, { goal_id: goalId, tags: parsed.tags });
+        }
+        try {
+            await this.stateManager.writeRaw(`goals/${goalId}/domain_knowledge.json`, validated);
+        }
+        catch (err) {
+            if (this.vectorIndex) {
+                await this.vectorIndex.remove(parsed.entry_id);
+            }
+            throw err;
+        }
+    }
+    // ─── loadKnowledge ───
+    /**
+     * Load knowledge entries for a goal, optionally filtered by tags (exact match).
+     *
+     * An entry matches if ALL provided tags appear in the entry's tags array.
+     */
+    async loadKnowledge(goalId, tags) {
+        const domainKnowledge = await this._loadDomainKnowledge(goalId);
+        const entries = domainKnowledge.entries;
+        if (!tags || tags.length === 0) {
+            return entries;
+        }
+        return entries.filter((entry) => tags.every((tag) => entry.tags.includes(tag)));
+    }
+    // ─── checkContradiction ───
+    async checkContradiction(goalId, newEntry) {
+        return _checkContradiction({ llmClient: this.llmClient, gateway: this.gateway, stateManager: this.stateManager }, goalId, newEntry);
+    }
+    // ─── getRelevantKnowledge ───
+    /**
+     * Returns knowledge entries whose tags include the given dimension name.
+     */
+    async getRelevantKnowledge(goalId, dimensionName) {
+        return this.loadKnowledge(goalId, [dimensionName]);
+    }
+    // ─── searchKnowledge (Phase 2) ───
+    /**
+     * Semantic search within a single goal's knowledge entries via VectorIndex.
+     * Falls back to an empty array when no VectorIndex is configured.
+     */
+    async searchKnowledge(query, topK = 5) {
+        return searchKnowledge({ stateManager: this.stateManager, vectorIndex: this.vectorIndex }, query, topK);
+    }
+    // ─── searchAcrossGoals (Phase 2) ───
+    /**
+     * Cross-goal semantic search. Leverages the VectorIndex which is global
+     * across all goals. Returns entries from any goal ordered by similarity.
+     * Falls back to an empty array when no VectorIndex is configured.
+     */
+    async searchAcrossGoals(query, topK = 5) {
+        return searchAcrossGoals({ stateManager: this.stateManager, vectorIndex: this.vectorIndex }, query, topK);
+    }
+    // ─── 5.1a: Shared Knowledge Base ───
+    /**
+     * Save a KnowledgeEntry into the shared knowledge base, associating it with
+     * the given goalId. If VectorIndex is available the entry is also embedded
+     * and the embedding_id is stored on the returned SharedKnowledgeEntry.
+     */
+    async saveToSharedKnowledgeBase(entry, goalId) {
+        const now = new Date();
+        // Build shared entry (default stability: moderate)
+        const shared = SharedKnowledgeEntrySchema.parse({
+            ...entry,
+            source_goal_ids: [goalId],
+            domain_stability: "moderate",
+            revalidation_due_at: computeRevalidationDue(now, "moderate"),
+            embedding_id: null,
+        });
+        // Load existing entries and merge / append
+        const all = await loadSharedEntries(this.stateManager);
+        const existingIdx = all.findIndex((e) => e.entry_id === entry.entry_id);
+        let merged;
+        if (existingIdx >= 0) {
+            const existing = all[existingIdx];
+            const mergedGoalIds = Array.from(new Set([...existing.source_goal_ids, goalId]));
+            merged = SharedKnowledgeEntrySchema.parse({
+                ...existing,
+                source_goal_ids: mergedGoalIds,
+            });
+            all[existingIdx] = merged;
+        }
+        else {
+            merged = shared;
+            all.push(merged);
+        }
+        // Auto-register in VectorIndex if available
+        if (this.vectorIndex) {
+            const text = `${entry.question} ${entry.answer} ${entry.tags.join(" ")}`;
+            const vectorEntry = await this.vectorIndex.add(entry.entry_id, text, {
+                goal_id: goalId,
+                tags: entry.tags,
+                shared: true,
+            });
+            // Attach the embedding id (same as entry_id in our VectorIndex)
+            merged = SharedKnowledgeEntrySchema.parse({
+                ...merged,
+                embedding_id: vectorEntry.id,
+            });
+            // Update stored copy with embedding_id (use already-known index to avoid double scan)
+            const targetIdx = existingIdx >= 0 ? existingIdx : all.length - 1;
+            all[targetIdx] = merged;
+        }
+        await this.stateManager.writeRaw(SHARED_KB_PATH, all);
+        return merged;
+    }
+    /**
+     * Query the shared knowledge base by tags (AND logic).
+     * Optionally filter to entries contributed by a specific goal.
+     */
+    async querySharedKnowledge(tags, goalId) {
+        return querySharedKnowledge(this.stateManager, tags, goalId);
+    }
+    // ─── 5.1b: Vector Search for Knowledge Sharing ───
+    /**
+     * Semantic search across the shared knowledge base using VectorIndex.
+     * Falls back to an empty array when no VectorIndex is configured.
+     */
+    async searchByEmbedding(query, topK = 5) {
+        return searchByEmbedding({ stateManager: this.stateManager, vectorIndex: this.vectorIndex }, query, topK);
+    }
+    // ─── 5.1c: Domain Stability Auto-Revalidation ───
+    /**
+     * Classify the domain stability of a set of knowledge entries via LLM.
+     * Returns "stable", "moderate", or "volatile".
+     */
+    async classifyDomainStability(domain, entries) {
+        return classifyDomainStability({ stateManager: this.stateManager, llmClient: this.llmClient }, domain, entries);
+    }
+    /**
+     * Return shared knowledge entries whose revalidation_due_at is in the past.
+     */
+    async getStaleEntries() {
+        return getStaleEntries(this.stateManager);
+    }
+    /**
+     * Generate KnowledgeAcquisitionTask-style Task objects for each stale entry,
+     * re-asking the original question.
+     */
+    async generateRevalidationTasks(staleEntries) {
+        return generateRevalidationTasks(staleEntries);
+    }
+    // ─── Decision History (M14-S3) ───
+    /**
+     * Save a DecisionRecord to ~/.pulseed/decisions/<goalId>-<timestamp>.json
+     * For completed records (outcome !== "pending"), enriches with LLM-extracted
+     * what_worked/what_failed/suggested_next before saving.
+     */
+    async recordDecision(record) {
+        return recordDecision({ stateManager: this.stateManager, llmClient: this.llmClient }, record);
+    }
+    /**
+     * Enrich a completed DecisionRecord by extracting what_worked/what_failed/suggested_next via LLM.
+     * Falls back to default empty arrays on LLM failure.
+     */
+    async enrichDecisionRecord(record) {
+        return enrichDecisionRecord({ stateManager: this.stateManager, llmClient: this.llmClient }, record);
+    }
+    /**
+     * Load decision records filtered by goal_type, sorted by recency.
+     * Applies time-decay scoring (1.0 at day 0, 0.0 at day 30+).
+     */
+    async queryDecisions(goalType, limit = 20) {
+        return queryDecisions({ stateManager: this.stateManager, llmClient: this.llmClient }, goalType, limit);
+    }
+    /**
+     * Update the outcome of a DecisionRecord identified by strategy_id.
+     * Finds the most recent pending record for the given strategy and rewrites it.
+     * No-op when no matching pending record is found.
+     */
+    async updateDecisionOutcome(strategyId, outcome) {
+        return updateDecisionOutcome({ stateManager: this.stateManager, llmClient: this.llmClient }, strategyId, outcome);
+    }
+    /**
+     * Remove decision records older than 90 days.
+     * Returns the count of purged records.
+     */
+    async purgeOldDecisions() {
+        return purgeOldDecisions({
+            stateManager: this.stateManager,
+            llmClient: this.llmClient,
+        });
+    }
+    // ─── Private Helpers ───
+    async _loadDomainKnowledge(goalId) {
+        return loadDomainKnowledge(this.stateManager, goalId);
+    }
+    // ─── acquireWithTools (Phase 3-B) ───
+    /**
+     * Acquire knowledge by planning and executing tool calls, then synthesizing results via LLM.
+     * Uses read-only tools (glob, grep, read, http_fetch, json_query, shell) to gather data.
+     */
+    async acquireWithTools(question, goalId, toolExecutor, context) {
+        // Step 1: Plan tool calls via LLM
+        const planResponse = await this.llmClient.sendMessage([{ role: "user", content: `Question: ${question}\nWorkspace: ${context.cwd}` }], { system: "You are a research planner. Given a question, plan tool calls to gather information.\nAvailable read-only tools: glob (find files), grep (search content), read (read file), http_fetch (GET URL), json_query (query JSON file), shell (read-only commands like wc, git log, npm ls).\nReturn a JSON array of { toolName, input } objects. Return [] if the question cannot be answered with these tools." });
+        // Step 2: Parse plan, return [] on error or empty
+        let toolCalls;
+        try {
+            toolCalls = JSON.parse(planResponse.content);
+        }
+        catch {
+            return [];
+        }
+        if (!Array.isArray(toolCalls) || toolCalls.length === 0)
+            return [];
+        // Sanitize: cap length and validate element shape (CLAUDE.md: sanitize LLM responses)
+        const MAX_TOOL_CALLS = 10;
+        const validCalls = toolCalls
+            .slice(0, MAX_TOOL_CALLS)
+            .filter((tc) => typeof tc === "object" && tc !== null && typeof tc.toolName === "string");
+        if (validCalls.length === 0)
+            return [];
+        // Step 3: Execute batch
+        const results = await toolExecutor.executeBatch(validCalls, context);
+        const successfulResults = results
+            .filter((r) => r.success)
+            .map((r) => r.summary + "\n" + String(r.data).slice(0, 2000));
+        if (successfulResults.length === 0)
+            return [];
+        // Step 4: Synthesize via LLM
+        const synthesisResponse = await this.llmClient.sendMessage([{ role: "user", content: `Question: ${question}\n\nTool outputs:\n${successfulResults.join("\n---\n")}` }], { system: "Synthesize the following tool outputs to answer the question. Return a JSON object with: { answer: string, confidence: number (0-1), tags: string[] }" });
+        try {
+            const synthesis = JSON.parse(synthesisResponse.content);
+            return [{
+                    entry_id: crypto.randomUUID(),
+                    question,
+                    answer: synthesis.answer,
+                    sources: validCalls.map((tc) => ({
+                        type: "data_analysis",
+                        reference: `tool:${tc.toolName}`,
+                        reliability: "high",
+                    })),
+                    confidence: Math.min(synthesis.confidence, 0.92),
+                    acquired_at: new Date().toISOString(),
+                    acquisition_task_id: "tool_direct",
+                    superseded_by: null,
+                    tags: synthesis.tags ?? [],
+                    embedding_id: null,
+                }];
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=knowledge-manager.js.map

package/dist/platform/knowledge/knowledge-manager.js.map

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

package/dist/platform/knowledge/knowledge-revalidation.d.ts

@@ -0,0 +1,27 @@
+import type { Task } from "../../base/types/task.js";
+import type { KnowledgeEntry, SharedKnowledgeEntry, DomainStability } from "../../base/types/knowledge.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { IPromptGateway } from "../../prompt/gateway.js";
+import type { StateManager } from "../../base/state/state-manager.js";
+export interface RevalidationDeps {
+    stateManager: StateManager;
+    llmClient: ILLMClient;
+    gateway?: IPromptGateway;
+}
+/**
+ * Classify the domain stability of a set of knowledge entries via LLM.
+ * Returns "stable", "moderate", or "volatile".
+ */
+export declare function classifyDomainStability(deps: RevalidationDeps, domain: string, entries: KnowledgeEntry[]): Promise<DomainStability>;
+/**
+ * Return shared knowledge entries whose revalidation_due_at is in the past.
+ */
+export declare function getStaleEntries(stateManager: StateManager): Promise<SharedKnowledgeEntry[]>;
+/**
+ * Generate KnowledgeAcquisitionTask-style Task objects for each stale entry,
+ * re-asking the original question.
+ */
+export declare function generateRevalidationTasks(staleEntries: SharedKnowledgeEntry[]): Promise<Task[]>;
+/** Compute revalidation due date based on stability and a base date. */
+export declare function computeRevalidationDue(base: Date, stability: DomainStability): string;
+//# sourceMappingURL=knowledge-revalidation.d.ts.map

package/dist/platform/knowledge/knowledge-revalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-revalidation.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/knowledge-revalidation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAKrD,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAWtE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,eAAe,CAAC,CAoD1B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjG;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,oBAAoB,EAAE,GACnC,OAAO,CAAC,IAAI,EAAE,CAAC,CA4CjB;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAIrF"}

package/dist/platform/knowledge/knowledge-revalidation.js

@@ -0,0 +1,130 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { TaskSchema } from "../../base/types/task.js";
+import { DomainStabilitySchema, REVALIDATION_SCHEDULE, } from "../../base/types/knowledge.js";
+import { loadSharedEntries } from "./knowledge-search.js";
+// ─── LLM response schema ───
+const DomainStabilityResponseSchema = z.object({
+    stability: DomainStabilitySchema,
+    rationale: z.string().optional(),
+});
+// ─── Revalidation functions ───
+/**
+ * Classify the domain stability of a set of knowledge entries via LLM.
+ * Returns "stable", "moderate", or "volatile".
+ */
+export async function classifyDomainStability(deps, domain, entries) {
+    const sampleAnswers = entries
+        .slice(0, 5)
+        .map((e) => `Q: ${e.question}\nA: ${e.answer}`)
+        .join("\n\n");
+    const prompt = `You are classifying how quickly knowledge in a domain becomes outdated.
+
+Domain: ${domain}
+Sample knowledge entries:
+${sampleAnswers || "(no entries yet)"}
+
+Classify the domain stability:
+- "stable"   — knowledge rarely changes (math, history, established science)
+- "moderate" — knowledge changes every few months to a year (best practices, frameworks)
+- "volatile" — knowledge changes frequently (current events, fast-moving tech, prices)
+
+Respond with JSON:
+{ "stability": "stable" | "moderate" | "volatile", "rationale": "brief explanation" }`;
+    if (deps.gateway) {
+        try {
+            const parsed = await deps.gateway.execute({
+                purpose: "knowledge_stability",
+                additionalContext: { stability_prompt: prompt },
+                responseSchema: DomainStabilityResponseSchema,
+                maxTokens: 256,
+            });
+            return parsed.stability;
+        }
+        catch {
+            return "moderate";
+        }
+    }
+    else {
+        const response = await deps.llmClient.sendMessage([{ role: "user", content: prompt }], {
+            system: "You classify knowledge domain stability. Respond with JSON only.",
+            max_tokens: 256,
+        });
+        try {
+            const parsed = deps.llmClient.parseJSON(response.content, DomainStabilityResponseSchema);
+            return parsed.stability;
+        }
+        catch {
+            return "moderate";
+        }
+    }
+}
+/**
+ * Return shared knowledge entries whose revalidation_due_at is in the past.
+ */
+export async function getStaleEntries(stateManager) {
+    const all = await loadSharedEntries(stateManager);
+    const now = new Date();
+    return all.filter((entry) => {
+        if (!entry.revalidation_due_at) {
+            // No due date — consider stale based on stability interval from acquired_at
+            const acquiredAt = new Date(entry.acquired_at);
+            const intervalDays = REVALIDATION_SCHEDULE[entry.domain_stability];
+            const dueAt = new Date(acquiredAt.getTime() + intervalDays * 24 * 60 * 60 * 1000);
+            return now > dueAt;
+        }
+        return now > new Date(entry.revalidation_due_at);
+    });
+}
+/**
+ * Generate KnowledgeAcquisitionTask-style Task objects for each stale entry,
+ * re-asking the original question.
+ */
+export async function generateRevalidationTasks(staleEntries) {
+    const tasks = [];
+    for (const entry of staleEntries) {
+        const goalId = entry.source_goal_ids[0] ?? "shared";
+        const taskId = randomUUID();
+        const now = new Date().toISOString();
+        const task = TaskSchema.parse({
+            id: taskId,
+            goal_id: goalId,
+            strategy_id: null,
+            target_dimensions: entry.tags,
+            primary_dimension: entry.tags[0] ?? "knowledge",
+            work_description: `Revalidate knowledge: ${entry.question}`,
+            rationale: `Entry ${entry.entry_id} is stale (domain_stability: ${entry.domain_stability}, due: ${entry.revalidation_due_at ?? "overdue"})`,
+            approach: `Re-research the following question and verify whether the answer has changed:\n${entry.question}\n\nPrevious answer: ${entry.answer}`,
+            success_criteria: [
+                {
+                    description: `Confirm or update answer to: "${entry.question}"`,
+                    verification_method: "Compare new answer to existing answer with cited sources",
+                    is_blocking: true,
+                },
+            ],
+            scope_boundary: {
+                in_scope: ["Information collection", "Web search", "Document reading"],
+                out_of_scope: ["System modifications", "Code changes", "Data mutations"],
+                blast_radius: "None — read-only revalidation task",
+            },
+            constraints: [
+                "No system modifications allowed",
+                `Original entry_id: ${entry.entry_id}`,
+            ],
+            reversibility: "reversible",
+            estimated_duration: { value: 2, unit: "hours" },
+            task_category: "knowledge_acquisition",
+            status: "pending",
+            created_at: now,
+        });
+        tasks.push(task);
+    }
+    return tasks;
+}
+/** Compute revalidation due date based on stability and a base date. */
+export function computeRevalidationDue(base, stability) {
+    const days = REVALIDATION_SCHEDULE[stability];
+    const due = new Date(base.getTime() + days * 24 * 60 * 60 * 1000);
+    return due.toISOString();
+}
+//# sourceMappingURL=knowledge-revalidation.js.map

package/dist/platform/knowledge/knowledge-revalidation.js.map

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