@iflow-mcp/jkheadley-instar 0.26.2

package/dist/knowledge/SelfKnowledgeTree.js

@@ -0,0 +1,560 @@
+/**
+ * SelfKnowledgeTree — Orchestrator for tree-based agent self-knowledge.
+ *
+ * Coordinates triage, traversal, synthesis, caching, and observability
+ * into a unified search pipeline. Provides the main API surface:
+ *
+ *   - search(query)    — full self-knowledge search
+ *   - dryRun(query)    — preview what would be searched
+ *   - ground(topic)    — engagement grounding (Phase 2)
+ *   - validate()       — tree health check
+ *   - generateTree()   — auto-generate from AGENT.md
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { CACHE_TTL_MS } from './types.js';
+import { TreeTriage } from './TreeTriage.js';
+import { TreeTraversal } from './TreeTraversal.js';
+import { TreeSynthesis } from './TreeSynthesis.js';
+import { TreeGenerator } from './TreeGenerator.js';
+import { ProbeRegistry } from './ProbeRegistry.js';
+const TREE_FILENAME = 'self-knowledge-tree.json';
+const TRACE_FILENAME = 'tree-trace.jsonl';
+const MAX_TRACE_LINES = 5_000;
+export class SelfKnowledgeTree {
+    config = null;
+    triage;
+    traversal;
+    synthesis;
+    generator;
+    probeRegistry;
+    options;
+    // Grounding cache (Phase 2)
+    groundingCache = new Map();
+    groundingInProgress = new Map();
+    constructor(options) {
+        this.options = options;
+        this.probeRegistry = new ProbeRegistry();
+        this.triage = new TreeTriage(options.intelligence);
+        this.traversal = new TreeTraversal({
+            projectDir: options.projectDir,
+            stateDir: options.stateDir,
+            probeRegistry: this.probeRegistry,
+            memoryIndex: options.memoryIndex,
+            knowledgeManager: options.knowledgeManager,
+            decisionJournal: options.decisionJournal,
+        });
+        this.synthesis = new TreeSynthesis(options.intelligence);
+        this.generator = new TreeGenerator();
+    }
+    /**
+     * Get the probe registry for registering custom probes.
+     */
+    get probes() {
+        return this.probeRegistry;
+    }
+    // ── Core API ─────────────────────────────────────────────────────
+    /**
+     * Full self-knowledge search.
+     */
+    async search(query, options) {
+        const start = Date.now();
+        const config = this.loadConfig();
+        if (!config) {
+            return this.emptyResult(query, start, 'Tree config not found');
+        }
+        const budgetLimit = options?.maxBudget ?? config.budget.maxLlmCalls;
+        let budgetUsed = 0;
+        // 1. Triage — which layers are relevant?
+        // Rule-based is now the primary mode (zero token cost). LLM is fallback for ambiguous queries.
+        // "degraded" only means total triage failure (catch block), not rule-based mode.
+        let triageResult;
+        let degraded = false;
+        try {
+            triageResult = await this.triage.triage(query, config.layers);
+            if (triageResult.mode === 'llm')
+                budgetUsed++;
+        }
+        catch {
+            // Total triage failure — use alwaysInclude only
+            degraded = true;
+            triageResult = {
+                scores: Object.fromEntries(config.layers.map(l => [l.id, 0])),
+                mode: 'rule-based',
+                elapsedMs: 0,
+            };
+        }
+        // 2. Filter layers
+        let relevantLayers = options?.layerFilter
+            ? config.layers.filter(l => options.layerFilter.includes(l.id))
+            : this.triage.filterRelevantLayers(config.layers, triageResult.scores);
+        // 3. Collect nodes to search — two-stage: layer filter then node-level scoring
+        const nodesToSearch = [];
+        const nodesToSkip = [];
+        const nodeScores = triageResult.nodeScores ?? {};
+        for (const layer of config.layers) {
+            const isRelevant = relevantLayers.some(l => l.id === layer.id);
+            for (const node of layer.children) {
+                if (options?.publicOnly && node.sensitivity === 'internal') {
+                    nodesToSkip.push(node.id);
+                    continue;
+                }
+                if (node.alwaysInclude) {
+                    // alwaysInclude nodes are never skipped
+                    nodesToSearch.push(node);
+                }
+                else if (isRelevant) {
+                    // Within relevant layers, use node-level scores to filter
+                    const nodeScore = nodeScores[node.id] ?? 0;
+                    if (nodeScore >= this.triage.relevanceThreshold * 0.75 || Object.keys(nodeScores).length === 0) {
+                        // Include if node scores above threshold, or if no node scoring was done
+                        nodesToSearch.push(node);
+                    }
+                    else {
+                        nodesToSkip.push(node.id);
+                    }
+                }
+                else {
+                    nodesToSkip.push(node.id);
+                }
+            }
+        }
+        // 4. Traverse — gather content from sources
+        const { fragments, errors } = await this.traversal.gather(nodesToSearch, triageResult.scores, { publicOnly: options?.publicOnly });
+        // Count LLM calls from sources that used memory/knowledge search (not LLM, but budget-tracked)
+        // Actual LLM calls: triage + synthesis
+        const cacheStats = this.traversal.cacheStats();
+        // 5. Synthesis — combine fragments into narrative
+        let synthesisResult = { synthesis: null, tokensUsed: 0 };
+        if (!degraded && fragments.length > 0 && budgetUsed < budgetLimit) {
+            synthesisResult = await this.synthesis.synthesize(query, fragments, config.agentName);
+            if (synthesisResult.synthesis)
+                budgetUsed++;
+        }
+        // Compute max confidence from node scores
+        const searchedNodeScores = nodesToSearch
+            .map(n => nodeScores[n.id] ?? 0)
+            .filter(s => s > 0);
+        const confidence = searchedNodeScores.length > 0
+            ? Math.max(...searchedNodeScores)
+            : (fragments.length > 0 ? 0.5 : 0); // Default 0.5 if we have results but no scoring
+        const result = {
+            query,
+            degraded,
+            fragments,
+            synthesis: synthesisResult.synthesis,
+            budgetUsed,
+            elapsedMs: Date.now() - start,
+            cacheHitRate: cacheStats.hitRate,
+            errors,
+            triageMethod: triageResult.mode,
+            confidence,
+        };
+        // 6. Log trace
+        this.logTrace({
+            timestamp: new Date().toISOString(),
+            query,
+            triageMode: triageResult.mode,
+            triageScores: triageResult.scores,
+            nodesSearched: nodesToSearch.map(n => n.id),
+            nodesSkipped: nodesToSkip,
+            cacheHits: fragments.filter(f => f.cached).map(f => f.nodeId),
+            cacheMisses: fragments.filter(f => !f.cached).map(f => f.nodeId),
+            errors,
+            budgetUsed,
+            budgetLimit,
+            elapsedMs: result.elapsedMs,
+            synthesisTokens: synthesisResult.tokensUsed,
+            degraded,
+        });
+        return result;
+    }
+    /**
+     * Preview what a search would do without executing it.
+     */
+    async dryRun(query) {
+        const config = this.loadConfig();
+        if (!config) {
+            return {
+                query,
+                triageMode: 'rule-based',
+                layerScores: {},
+                nodesToSearch: [],
+                nodesToSkip: [],
+                estimatedLlmCalls: 0,
+            };
+        }
+        const triageResult = await this.triage.triage(query, config.layers);
+        const relevantLayers = this.triage.filterRelevantLayers(config.layers, triageResult.scores);
+        const nodeScores = triageResult.nodeScores ?? {};
+        const nodesToSearch = [];
+        const nodesToSkip = [];
+        for (const layer of config.layers) {
+            const isRelevant = relevantLayers.some(l => l.id === layer.id);
+            for (const node of layer.children) {
+                if (node.alwaysInclude) {
+                    nodesToSearch.push(node.id);
+                }
+                else if (isRelevant) {
+                    const nodeScore = nodeScores[node.id] ?? 0;
+                    if (nodeScore >= this.triage.relevanceThreshold * 0.75 || Object.keys(nodeScores).length === 0) {
+                        nodesToSearch.push(node.id);
+                    }
+                    else {
+                        nodesToSkip.push(node.id);
+                    }
+                }
+                else {
+                    nodesToSkip.push(node.id);
+                }
+            }
+        }
+        return {
+            query,
+            triageMode: triageResult.mode,
+            layerScores: triageResult.scores,
+            nodesToSearch,
+            nodesToSkip,
+            estimatedLlmCalls: triageResult.mode === 'llm' ? 2 : 0, // triage + synthesis
+        };
+    }
+    // ── Grounding (Phase 2) ──────────────────────────────────────────
+    /**
+     * Engagement grounding — tree-based identity + context for public actions.
+     * Uses a 10-minute cache per topic+platform combination.
+     */
+    async ground(topic, platform) {
+        // Truncate absurdly long topics at input (X2.8)
+        const safeTopic = topic.length > 500 ? topic.slice(0, 500) : topic;
+        // Hash-based cache key to prevent memory bloat (X2.8)
+        const cacheKey = this.groundingCacheKey(safeTopic, platform);
+        const now = Date.now();
+        const currentMtime = this.getAgentMdMtime();
+        // Check grounding cache
+        const cached = this.groundingCache.get(cacheKey);
+        if (cached) {
+            const expired = (now - cached.createdAt) >= CACHE_TTL_MS.synthesis;
+            const stale = currentMtime !== cached.agentMdMtime; // X2.2: AGENT.md changed
+            if (!expired && !stale) {
+                return { ...cached.result, cached: true };
+            }
+            // Cache invalid — remove it
+            this.groundingCache.delete(cacheKey);
+        }
+        // Check if already in progress (thundering herd protection — X2.7)
+        const inProgress = this.groundingInProgress.get(cacheKey);
+        if (inProgress) {
+            return inProgress;
+        }
+        // Start grounding
+        const promise = this.doGround(safeTopic, platform);
+        this.groundingInProgress.set(cacheKey, promise);
+        try {
+            const result = await promise;
+            this.groundingCache.set(cacheKey, {
+                result,
+                createdAt: now,
+                agentMdMtime: currentMtime,
+            });
+            return result;
+        }
+        finally {
+            this.groundingInProgress.delete(cacheKey);
+        }
+    }
+    async doGround(topic, platform) {
+        const start = Date.now();
+        const result = await this.search(topic, { publicOnly: true });
+        return {
+            topic,
+            platform,
+            fragments: result.fragments,
+            synthesis: result.synthesis,
+            degraded: result.degraded,
+            elapsedMs: Date.now() - start,
+            cached: false,
+        };
+    }
+    groundingCacheKey(topic, platform) {
+        const raw = `${topic}::${platform ?? 'general'}`;
+        // Hash for long topics to prevent memory bloat
+        if (raw.length > 200) {
+            return crypto.createHash('sha256').update(raw).digest('hex').slice(0, 32);
+        }
+        return raw;
+    }
+    getAgentMdMtime() {
+        try {
+            const agentMdPath = path.join(this.options.projectDir, 'AGENT.md');
+            return fs.statSync(agentMdPath).mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ── Tree Management ──────────────────────────────────────────────
+    /**
+     * Generate tree from AGENT.md + config.
+     */
+    generateTree(options = {}) {
+        const agentName = this.config?.agentName ?? this.readAgentName();
+        const config = this.generator.generate({
+            projectDir: this.options.projectDir,
+            stateDir: this.options.stateDir,
+            agentName,
+            ...options,
+        });
+        this.generator.save(config, this.options.stateDir);
+        this.config = config;
+        this.traversal.invalidateAll();
+        return config;
+    }
+    /**
+     * Add a node to an existing layer.
+     */
+    addNode(layerId, node) {
+        const config = this.loadConfig();
+        if (!config)
+            throw new Error('Tree config not found — run generateTree() first');
+        const layer = config.layers.find(l => l.id === layerId);
+        if (!layer)
+            throw new Error(`Layer "${layerId}" not found`);
+        // Check for duplicate
+        if (layer.children.some(n => n.id === node.id)) {
+            throw new Error(`Node "${node.id}" already exists in layer "${layerId}"`);
+        }
+        layer.children.push(node);
+        this.generator.save(config, this.options.stateDir);
+        this.config = config;
+    }
+    /**
+     * Remove a node by ID.
+     */
+    removeNode(nodeId) {
+        const config = this.loadConfig();
+        if (!config)
+            throw new Error('Tree config not found');
+        for (const layer of config.layers) {
+            const index = layer.children.findIndex(n => n.id === nodeId);
+            if (index >= 0) {
+                layer.children.splice(index, 1);
+                this.generator.save(config, this.options.stateDir);
+                this.config = config;
+                return;
+            }
+        }
+        throw new Error(`Node "${nodeId}" not found in any layer`);
+    }
+    /**
+     * Accept an evolution proposal — validates and adds as managed:false.
+     * Rejects proposals with unregistered probes or invalid sources.
+     */
+    acceptEvolutionProposal(layerId, node) {
+        // Force managed:false for evolution-added nodes
+        node.managed = false;
+        // Validate probe sources
+        for (const source of node.sources) {
+            if (source.type === 'probe' && !this.probeRegistry.has(source.name)) {
+                return {
+                    accepted: false,
+                    reason: `Probe "${source.name}" is not registered in ProbeRegistry`,
+                };
+            }
+            // Validate file sources exist
+            if (source.type === 'file' || source.type === 'file_section') {
+                const filePath = path.resolve(this.options.projectDir, source.path);
+                if (!fs.existsSync(filePath)) {
+                    return {
+                        accepted: false,
+                        reason: `Source file not found: ${source.path}`,
+                    };
+                }
+            }
+        }
+        // Check for duplicate node ID across all layers
+        const config = this.loadConfig();
+        if (config) {
+            for (const layer of config.layers) {
+                if (layer.children.some(n => n.id === node.id)) {
+                    return {
+                        accepted: false,
+                        reason: `Node "${node.id}" already exists in layer "${layer.id}"`,
+                    };
+                }
+            }
+        }
+        try {
+            this.addNode(layerId, node);
+            return { accepted: true };
+        }
+        catch (err) {
+            return {
+                accepted: false,
+                reason: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    // ── Validation ───────────────────────────────────────────────────
+    /**
+     * Validate tree config for health.
+     */
+    validate() {
+        const config = this.loadConfig();
+        if (!config) {
+            return {
+                valid: false,
+                warnings: [],
+                errors: [{ nodeId: '', type: 'invalid_schema', message: 'Tree config file not found' }],
+                coverageScore: 0,
+            };
+        }
+        const warnings = [];
+        const errors = [];
+        let totalNodes = 0;
+        let validNodes = 0;
+        for (const layer of config.layers) {
+            for (const node of layer.children) {
+                totalNodes++;
+                let nodeValid = true;
+                for (const source of node.sources) {
+                    if (source.type === 'file' || source.type === 'file_section') {
+                        const filePath = path.resolve(this.options.projectDir, source.path);
+                        if (!fs.existsSync(filePath)) {
+                            warnings.push({
+                                nodeId: node.id,
+                                type: 'missing_source',
+                                message: `Source file not found: ${source.path}`,
+                            });
+                            nodeValid = false;
+                        }
+                        else {
+                            // Check for empty/stub files
+                            try {
+                                const content = fs.readFileSync(filePath, 'utf-8');
+                                if (content.trim().length < 50) {
+                                    warnings.push({
+                                        nodeId: node.id,
+                                        type: 'empty_source',
+                                        message: `Source file has minimal content (${content.trim().length} chars): ${source.path}`,
+                                    });
+                                }
+                            }
+                            catch {
+                                // Already flagged as missing
+                            }
+                        }
+                    }
+                    if (source.type === 'probe') {
+                        if (!this.probeRegistry.has(source.name)) {
+                            errors.push({
+                                nodeId: node.id,
+                                type: 'unregistered_probe',
+                                message: `Probe "${source.name}" is not registered`,
+                            });
+                            nodeValid = false;
+                        }
+                    }
+                }
+                if (node.sources.length === 0) {
+                    warnings.push({
+                        nodeId: node.id,
+                        type: 'orphan_node',
+                        message: 'Node has no sources defined',
+                    });
+                    nodeValid = false;
+                }
+                if (nodeValid)
+                    validNodes++;
+            }
+        }
+        const coverageScore = totalNodes > 0 ? validNodes / totalNodes : 0;
+        return {
+            valid: errors.length === 0,
+            warnings,
+            errors,
+            coverageScore,
+        };
+    }
+    /**
+     * Get cache statistics from traversal layer.
+     */
+    cacheStats() {
+        return this.traversal.cacheStats();
+    }
+    /**
+     * Get loaded config (for inspection).
+     */
+    getConfig() {
+        return this.loadConfig();
+    }
+    /**
+     * Invalidate grounding cache (e.g., after AGENT.md change).
+     */
+    invalidateGroundingCache() {
+        this.groundingCache.clear();
+    }
+    // ── Private ──────────────────────────────────────────────────────
+    readAgentName() {
+        try {
+            const agentMd = fs.readFileSync(path.join(this.options.projectDir, 'AGENT.md'), 'utf-8');
+            const match = agentMd.match(/^#\s+(.+)$/m);
+            if (match)
+                return match[1].trim();
+        }
+        catch { /* fall through */ }
+        return path.basename(this.options.projectDir);
+    }
+    loadConfig() {
+        if (this.config)
+            return this.config;
+        const filePath = path.join(this.options.stateDir, TREE_FILENAME);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            this.config = JSON.parse(content);
+            return this.config;
+        }
+        catch {
+            return null;
+        }
+    }
+    emptyResult(query, startTime, error) {
+        return {
+            query,
+            degraded: true,
+            fragments: [],
+            synthesis: null,
+            budgetUsed: 0,
+            elapsedMs: Date.now() - startTime,
+            cacheHitRate: 0,
+            errors: [{ nodeId: '', sourceType: '', error, elapsedMs: 0 }],
+        };
+    }
+    logTrace(entry) {
+        const logsDir = path.join(this.options.stateDir, 'logs');
+        const tracePath = path.join(logsDir, TRACE_FILENAME);
+        try {
+            if (!fs.existsSync(logsDir)) {
+                fs.mkdirSync(logsDir, { recursive: true });
+            }
+            // Check file size for rotation
+            try {
+                const stat = fs.statSync(tracePath);
+                if (stat.size > 10 * 1024 * 1024) { // 10MB
+                    const rotatedPath = tracePath + `.${Date.now()}.bak`;
+                    fs.renameSync(tracePath, rotatedPath);
+                }
+            }
+            catch {
+                // File doesn't exist yet — fine
+            }
+            fs.appendFileSync(tracePath, JSON.stringify(entry) + '\n');
+        }
+        catch {
+            // Trace logging is best-effort — don't fail searches
+        }
+    }
+}
+//# sourceMappingURL=SelfKnowledgeTree.js.map

package/dist/knowledge/SelfKnowledgeTree.js.map

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

package/dist/knowledge/TreeGenerator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * TreeGenerator — Auto-generates self-knowledge tree from AGENT.md + config.
+ *
+ * Reads the agent's AGENT.md file and detected capabilities to produce
+ * the initial self-knowledge-tree.json. Not a template copy — structural
+ * analysis of what the agent actually has.
+ *
+ * On regeneration, uses managed/unmanaged merge strategy:
+ * - managed:true nodes are fully regenerated
+ * - managed:false nodes are preserved as-is
+ *
+ * Born from: PROP-XXX (Self-Knowledge Tree for Instar Agents)
+ */
+import type { SelfKnowledgeTreeConfig } from './types.js';
+interface GeneratorOptions {
+    projectDir: string;
+    stateDir: string;
+    agentName: string;
+    platforms?: string[];
+    skills?: string[];
+    hasMemory?: boolean;
+    hasKnowledge?: boolean;
+    hasDecisionJournal?: boolean;
+    hasJobs?: boolean;
+    hasEvolution?: boolean;
+    hasAutonomyProfile?: boolean;
+}
+export declare class TreeGenerator {
+    /**
+     * Generate a new tree config or merge with existing.
+     * If an existing tree has managed:false nodes, they are preserved.
+     */
+    generate(options: GeneratorOptions): SelfKnowledgeTreeConfig;
+    /**
+     * Save tree config to state directory.
+     * Uses atomic write (temp + rename) for safety.
+     */
+    save(config: SelfKnowledgeTreeConfig, stateDir: string): void;
+    /**
+     * Load existing tree config from state directory.
+     */
+    loadExisting(stateDir: string): SelfKnowledgeTreeConfig | null;
+    private readAgentMd;
+    private parseAgentMdSections;
+    private buildLayers;
+    private buildIdentityLayer;
+    private buildExperienceLayer;
+    private buildCapabilitiesLayer;
+    private buildStateLayer;
+    private buildEvolutionLayer;
+    /**
+     * Merge unmanaged (agent-evolved) nodes from existing tree into regenerated layers.
+     */
+    private mergeUnmanagedNodes;
+}
+export {};
+//# sourceMappingURL=TreeGenerator.d.ts.map

package/dist/knowledge/TreeGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeGenerator.d.ts","sourceRoot":"","sources":["../../src/knowledge/TreeGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,YAAY,CAAC;AAEpB,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,qBAAa,aAAa;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,uBAAuB;IA6B5D;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAa7D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAU9D,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,kBAAkB;IA0F1B,OAAO,CAAC,oBAAoB;IA4E5B,OAAO,CAAC,sBAAsB;IAoG9B,OAAO,CAAC,eAAe;IAwEvB,OAAO,CAAC,mBAAmB;IAiF3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAiC5B"}