pulseed 0.6.5 → 0.7.0

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

@@ -1,378 +0,0 @@
-import { searchKnowledge, searchAcrossGoals, searchByEmbedding, querySharedKnowledge, loadDomainKnowledge, } from "./knowledge-search.js";
-import { classifyDomainStability, getStaleEntries, generateRevalidationTasks, } 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";
-import { AGENT_MEMORY_PATH, loadAgentMemoryStore, projectAgentMemory, projectDomainKnowledge, projectSharedKnowledge, } from "./knowledge-manager-internals.js";
-import { archiveAgentMemoryEntries, applyAgentMemoryCorrection, autoConsolidateAgentMemory, consolidateAgentMemoryEntries, deleteAgentMemoryEntry, exportAgentMemoryGovernance, getAgentMemoryStatsForHost, listAgentMemoryCorrectionHistory, listAgentMemoryEntries, quarantineAgentMemoryEntries, recallAgentMemoryEntries, saveAgentMemoryEntry, } from "./knowledge-manager-agent-memory.js";
-import { formatRelationshipProfileRetrievalContext, } from "../profile/retrieval-context.js";
-import { saveDomainKnowledgeEntry, saveSharedKnowledgeEntry, } from "./knowledge-manager-store.js";
-export * from "./public-api.js";
-// ─── KnowledgeManager ───
-/**
- * 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) {
-        await saveDomainKnowledgeEntry(this.knowledgeStoreHost(), goalId, entry);
-    }
-    // ─── 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, options = {}) {
-        const entries = await this.loadKnowledge(goalId, [dimensionName]);
-        const profileEntries = this.relationshipProfileContextToKnowledgeEntries(goalId, options.relationshipProfileContext);
-        return [...profileEntries, ...entries];
-    }
-    // ─── 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, options = {}) {
-        const profileEntries = this.relationshipProfileContextToKnowledgeEntries(null, options.relationshipProfileContext);
-        const profileQuery = options.relationshipProfileContext
-            ? formatRelationshipProfileRetrievalContext(options.relationshipProfileContext)
-            : "";
-        return searchKnowledge({ stateManager: this.stateManager, vectorIndex: this.vectorIndex }, [query, profileQuery].filter((part) => part.trim().length > 0).join("\n"), topK).then((entries) => [...profileEntries, ...entries]);
-    }
-    relationshipProfileContextToKnowledgeEntries(goalId, context) {
-        if (!context || context.items.length === 0)
-            return [];
-        const acquiredAt = new Date(0).toISOString();
-        return context.items.map((item) => ({
-            entry_id: `relationship-profile:${item.id}`,
-            question: `Relationship profile context: ${item.stable_key}`,
-            answer: item.value,
-            sources: [{
-                    type: "document",
-                    reference: item.provenance.evidence_ref ?? item.id,
-                    reliability: item.confidence >= 0.8 ? "high" : item.confidence >= 0.5 ? "medium" : "low",
-                }],
-            confidence: item.confidence,
-            acquired_at: acquiredAt,
-            acquisition_task_id: "relationship-profile",
-            superseded_by: null,
-            embedding_id: null,
-            tags: [item.kind, context.scope, ...(goalId ? [goalId] : [])],
-        }));
-    }
-    // ─── 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) {
-        return saveSharedKnowledgeEntry(this.knowledgeStoreHost(), entry, goalId);
-    }
-    /**
-     * 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,
-        });
-    }
-    // ─── Agent Memory ───
-    /**
-     * Upsert an agent memory entry by key.
-     * If a matching key exists, update value/tags/category/memory_type/updated_at.
-     * If not, create a new entry with a UUID id and timestamps.
-     */
-    async saveAgentMemory(entry) {
-        return saveAgentMemoryEntry(this.agentMemoryHost(), entry);
-    }
-    /**
-     * Search agent memory entries by keyword or exact key match.
-     * exact=true: filter where entry.key === query.
-     * exact=false (default): case-insensitive substring match on key + value + tags.
-     * Optionally filter by category and/or memory_type.
-     * Excludes archived entries unless include_archived=true.
-     * Tiered sort: compiled entries first, then raw, both by updated_at desc.
-     */
-    async recallAgentMemory(query, opts) {
-        return recallAgentMemoryEntries(this.agentMemoryHost(), query, opts);
-    }
-    /**
-     * List all agent memory entries, optionally filtered by category and/or memory_type.
-     * Sorted by updated_at desc.
-     */
-    async listAgentMemory(opts) {
-        return listAgentMemoryEntries(this.agentMemoryHost(), opts);
-    }
-    /**
-     * Delete an agent memory entry by key.
-     * Returns true if the entry was found and removed, false otherwise.
-     */
-    async deleteAgentMemory(key) {
-        return deleteAgentMemoryEntry(this.agentMemoryHost(), key);
-    }
-    async correctAgentMemory(input) {
-        return applyAgentMemoryCorrection(this.agentMemoryHost(), input);
-    }
-    async listAgentMemoryCorrectionHistory(target) {
-        return listAgentMemoryCorrectionHistory(this.agentMemoryHost(), target);
-    }
-    async exportAgentMemoryGovernance(opts) {
-        return exportAgentMemoryGovernance(this.agentMemoryHost(), opts);
-    }
-    async quarantineAgentMemory(input) {
-        return quarantineAgentMemoryEntries(this.agentMemoryHost(), input);
-    }
-    // ─── consolidateAgentMemory ───
-    /**
-     * Consolidate raw agent memory entries into compiled entries via LLM.
-     * Groups entries by category+memory_type; groups with 2+ entries are consolidated.
-     * Source entries are archived after consolidation.
-     */
-    async consolidateAgentMemory(opts) {
-        return consolidateAgentMemoryEntries(this.agentMemoryHost(), opts);
-    }
-    // ─── archiveAgentMemory ───
-    /**
-     * Archive agent memory entries by IDs.
-     * Returns the count of entries actually archived (skips already-archived).
-     */
-    async archiveAgentMemory(ids) {
-        return archiveAgentMemoryEntries(this.agentMemoryHost(), ids);
-    }
-    // ─── getAgentMemoryStats ───
-    /**
-     * Return counts of agent memory entries grouped by status.
-     */
-    async getAgentMemoryStats() {
-        return getAgentMemoryStatsForHost(this.agentMemoryHost());
-    }
-    // ─── autoConsolidate ───
-    /**
-     * Automatically consolidate agent memory if raw entry count exceeds threshold.
-     * Non-fatal: errors are caught and logged; the loop continues regardless.
-     */
-    async autoConsolidate(opts) {
-        return autoConsolidateAgentMemory(this.agentMemoryHost(), opts);
-    }
-    // ─── Private Helpers ───
-    async _loadAgentMemoryStore() {
-        return loadAgentMemoryStore(this.stateManager);
-    }
-    async _loadDomainKnowledge(goalId) {
-        return loadDomainKnowledge(this.stateManager, goalId);
-    }
-    async _projectDomainKnowledgeToSoil(goalId, domainKnowledge) {
-        await projectDomainKnowledge(this.stateManager, goalId, domainKnowledge);
-    }
-    async _projectSharedKnowledgeToSoil(entries) {
-        await projectSharedKnowledge(this.stateManager, entries);
-    }
-    async _projectAgentMemoryToSoil(store) {
-        await projectAgentMemory(this.stateManager, store);
-    }
-    async loadAgentMemoryStore() {
-        return this._loadAgentMemoryStore();
-    }
-    async saveAgentMemoryStore(store) {
-        await this.stateManager.writeRaw(AGENT_MEMORY_PATH, store);
-        await this._projectAgentMemoryToSoil(store);
-    }
-    agentMemoryHost() {
-        return {
-            llmClient: this.llmClient,
-            embeddingClient: this.embeddingClient,
-            loadAgentMemoryStore: () => this._loadAgentMemoryStore(),
-            saveAgentMemoryStore: (store) => this.saveAgentMemoryStore(store),
-        };
-    }
-    knowledgeStoreHost() {
-        return {
-            stateManager: this.stateManager,
-            vectorIndex: this.vectorIndex,
-            loadDomainKnowledge: (goalId) => this._loadDomainKnowledge(goalId),
-            projectDomainKnowledge: (goalId, domainKnowledge) => this._projectDomainKnowledgeToSoil(goalId, domainKnowledge),
-            projectSharedKnowledge: (entries) => this._projectSharedKnowledgeToSoil(entries),
-        };
-    }
-    // ─── 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

@@ -1 +0,0 @@
-{"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

@@ -1,27 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,130 +0,0 @@
-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

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

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

@@ -1,42 +0,0 @@
-import type { KnowledgeEntry, SharedKnowledgeEntry } from "../../base/types/knowledge.js";
-import type { StateManager } from "../../base/state/state-manager.js";
-import type { VectorIndex } from "./vector-index.js";
-import type { DomainKnowledge } from "../../base/types/knowledge.js";
-export interface SearchDeps {
-    stateManager: StateManager;
-    vectorIndex?: VectorIndex;
-}
-/** Load all SharedKnowledgeEntries from the shared KB file. */
-export declare function loadSharedEntries(stateManager: StateManager): Promise<SharedKnowledgeEntry[]>;
-/** Load DomainKnowledge for a goal from state. */
-export declare function loadDomainKnowledge(stateManager: StateManager, goalId: string): Promise<DomainKnowledge>;
-export type MetadataSearchResult = {
-    id: string;
-    similarity: number;
-    metadata: Record<string, unknown>;
-};
-/**
- * Semantic search within a single goal's knowledge entries via VectorIndex.
- * Falls back to an empty array when no VectorIndex is configured.
- */
-export declare function searchKnowledge(deps: SearchDeps, 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.
- */
-export declare function searchAcrossGoals(deps: SearchDeps, query: string, topK?: number): Promise<KnowledgeEntry[]>;
-/**
- * Query the shared knowledge base by tags (AND logic).
- * Optionally filter to entries contributed by a specific goal.
- */
-export declare function querySharedKnowledge(stateManager: StateManager, 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.
- */
-export declare function searchByEmbedding(deps: SearchDeps, query: string, topK?: number): Promise<{
-    entry: SharedKnowledgeEntry;
-    similarity: number;
-}[]>;
-//# sourceMappingURL=knowledge-search.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-search.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/knowledge-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQrE,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAID,+DAA+D;AAC/D,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAYnG;AAED,kDAAkD;AAClD,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAa1B;AAID,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAuC3B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAK3B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAUjC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAkBhE"}