@iflow-mcp/jkheadley-instar 0.26.2

package/dist/index.js

@@ -0,0 +1,164 @@
+/**
+ * instar — Persistent autonomy infrastructure for AI agents.
+ *
+ * Public API for programmatic usage.
+ */
+// Core
+export { SessionManager } from './core/SessionManager.js';
+export { StateManager } from './core/StateManager.js';
+export { RelationshipManager } from './core/RelationshipManager.js';
+export { ClaudeCliIntelligenceProvider } from './core/ClaudeCliIntelligenceProvider.js';
+export { AnthropicIntelligenceProvider } from './core/AnthropicIntelligenceProvider.js';
+export { ANTHROPIC_MODELS, CLI_MODEL_FLAGS, resolveModelId, resolveCliFlag, getValidTiers, isValidTier } from './core/models.js';
+export { FeedbackManager } from './core/FeedbackManager.js';
+export { EvolutionManager } from './core/EvolutionManager.js';
+export { DecisionJournal } from './core/DecisionJournal.js';
+export { DispatchDecisionJournal } from './core/DispatchDecisionJournal.js';
+export { ContextSnapshotBuilder } from './core/ContextSnapshotBuilder.js';
+export { DispatchVerifier } from './core/DispatchVerifier.js';
+export { RelevanceFilter } from './core/RelevanceFilter.js';
+export { ContextualEvaluator } from './core/ContextualEvaluator.js';
+export { DeferredDispatchTracker } from './core/DeferredDispatchTracker.js';
+export { AdaptationValidator } from './core/AdaptationValidator.js';
+export { ExecutionJournal } from './core/ExecutionJournal.js';
+export { PatternAnalyzer } from './core/PatternAnalyzer.js';
+export { ReflectionConsolidator } from './core/ReflectionConsolidator.js';
+export { JobReflector } from './core/JobReflector.js';
+export { IntentDriftDetector } from './core/IntentDriftDetector.js';
+export { OrgIntentManager } from './core/OrgIntentManager.js';
+export { DispatchManager } from './core/DispatchManager.js';
+export { UpdateChecker } from './core/UpdateChecker.js';
+export { UpgradeNotifyManager } from './core/UpgradeNotifyManager.js';
+export { PostUpdateMigrator } from './core/PostUpdateMigrator.js';
+export { loadConfig, detectTmuxPath, detectClaudePath, detectProjectDir, ensureStateDir, resolveAgentDir, standaloneAgentsDir } from './core/Config.js';
+export { LiveConfig } from './config/LiveConfig.js';
+export { BackupManager } from './core/BackupManager.js';
+export { loadRegistry, saveRegistry, registerAgent, unregisterAgent, updateStatus, heartbeat as agentHeartbeat, startHeartbeat as startAgentHeartbeat, listAgents, getAgent, allocatePort, validateAgentName, listInstances, forceRemoveRegistryLock, } from './core/AgentRegistry.js';
+export { MachineIdentityManager, generateSigningKeyPair, generateEncryptionKeyPair, generateMachineId, sign, verify, ensureGitignore, base64ToSigningPem, base64ToEncryptionPem } from './core/MachineIdentity.js';
+export { SecurityLog } from './core/SecurityLog.js';
+export { generatePairingCode, comparePairingCodes, deriveSAS, generateEphemeralKeyPair, deriveSessionKey, encrypt, decrypt, createPairingSession, isPairingSessionValid, validatePairingCode, } from './core/PairingProtocol.js';
+export { NonceStore } from './core/NonceStore.js';
+export { HeartbeatManager } from './core/HeartbeatManager.js';
+export { MultiMachineCoordinator } from './core/MultiMachineCoordinator.js';
+export { SecretStore, MasterKeyManager, encryptForSync, decryptFromSync } from './core/SecretStore.js';
+export { migrateSecrets, mergeConfigWithSecrets } from './core/SecretMigrator.js';
+export { GitSyncManager, mergeRelationship } from './core/GitSync.js';
+export { LLMConflictResolver } from './core/LLMConflictResolver.js';
+export { FileClassifier } from './core/FileClassifier.js';
+export { WorkLedger } from './core/WorkLedger.js';
+export { BranchManager } from './core/BranchManager.js';
+export { OverlapGuard } from './core/OverlapGuard.js';
+export { HandoffManager } from './core/HandoffManager.js';
+export { GitStateManager } from './core/GitStateManager.js';
+export { ProjectMapper } from './core/ProjectMapper.js';
+export { CapabilityMapper } from './core/CapabilityMapper.js';
+export { ScopeVerifier } from './core/ScopeVerifier.js';
+export { CoherenceGate } from './core/CoherenceGate.js';
+export { CapabilityRegistryGenerator } from './core/CapabilityRegistryGenerator.js';
+export { BlockerLearningLoop } from './core/BlockerLearningLoop.js';
+export { ResearchRateLimiter } from './core/ResearchRateLimiter.js';
+export { ContextHierarchy } from './core/ContextHierarchy.js';
+export { CanonicalState } from './core/CanonicalState.js';
+export { PlatformActivityRegistry } from './core/PlatformActivityRegistry.js';
+export { TemporalCoherenceChecker } from './core/TemporalCoherenceChecker.js';
+export { ExternalOperationGate, computeRiskLevel, scopeFromCount, AUTONOMY_PROFILES } from './core/ExternalOperationGate.js';
+export { MessageSentinel } from './core/MessageSentinel.js';
+export { AdaptiveTrust } from './core/AdaptiveTrust.js';
+export { AutonomyProfileManager } from './core/AutonomyProfileManager.js';
+export { TrustElevationTracker } from './core/TrustElevationTracker.js';
+export { AutonomousEvolution } from './core/AutonomousEvolution.js';
+export { DispatchScopeEnforcer } from './core/DispatchScopeEnforcer.js';
+export { TrustRecovery } from './core/TrustRecovery.js';
+export { AutonomySkill } from './core/AutonomySkill.js';
+export { SecretRedactor } from './core/SecretRedactor.js';
+export { PromptGuard } from './core/PromptGuard.js';
+export { LedgerAuth } from './core/LedgerAuth.js';
+export { AccessControl } from './core/AccessControl.js';
+export { AuditTrail } from './core/AuditTrail.js';
+export { AgentBus } from './core/AgentBus.js';
+export { CoordinationProtocol } from './core/CoordinationProtocol.js';
+export { ConflictNegotiator } from './core/ConflictNegotiator.js';
+export { SyncOrchestrator } from './core/SyncOrchestrator.js';
+// Memory
+export { MemoryIndex } from './memory/MemoryIndex.js';
+export { SemanticMemory } from './memory/SemanticMemory.js';
+export { MemoryExporter } from './memory/MemoryExporter.js';
+export { EpisodicMemory } from './memory/EpisodicMemory.js';
+export { ActivityPartitioner } from './memory/ActivityPartitioner.js';
+export { chunkMarkdown, chunkJson, chunkJsonl, estimateTokens } from './memory/Chunker.js';
+// Users
+export { UserManager } from './users/UserManager.js';
+export { generateVerificationCode, generateConnectCode, hashCode, generateRecoveryKey, hashRecoveryKey, buildConsentDisclosure, buildCondensedConsentDisclosure, createConsentRecord, createDataManifest, VerificationManager, JoinRequestManager, buildUserProfile, getDefaultAutonomyConfig, } from './users/UserOnboarding.js';
+export { UserPropagator } from './users/UserPropagator.js';
+// Scheduler
+export { JobScheduler } from './scheduler/JobScheduler.js';
+export { IntegrationGate } from './scheduler/IntegrationGate.js';
+export { SkipLedger } from './scheduler/SkipLedger.js';
+export { loadJobs, validateJob, validateCommonBlockers } from './scheduler/JobLoader.js';
+export { JobClaimManager } from './scheduler/JobClaimManager.js';
+// Server
+export { AgentServer } from './server/AgentServer.js';
+export { createRoutes, formatUptime } from './server/routes.js';
+export { corsMiddleware, authMiddleware, rateLimiter, requestTimeout, errorHandler } from './server/middleware.js';
+export { machineAuthMiddleware, signRequest, ChallengeStore } from './server/machineAuth.js';
+export { createMachineRoutes } from './server/machineRoutes.js';
+// Monitoring
+export { HealthChecker } from './monitoring/HealthChecker.js';
+export { QuotaTracker } from './monitoring/QuotaTracker.js';
+export { classifySessionDeath } from './monitoring/QuotaExhaustionDetector.js';
+export { AccountSwitcher } from './monitoring/AccountSwitcher.js';
+export { QuotaNotifier } from './monitoring/QuotaNotifier.js';
+export { KeychainCredentialProvider, ClaudeConfigCredentialProvider, createDefaultProvider, redactToken, redactEmail } from './monitoring/CredentialProvider.js';
+export { SessionCredentialManager } from './monitoring/SessionCredentialManager.js';
+export { QuotaCollector, RetryHelper, RequestBudget, ConcurrencyLimiter, AdaptivePoller, JsonlParser, classifyToken } from './monitoring/QuotaCollector.js';
+export { SessionMigrator } from './monitoring/SessionMigrator.js';
+export { QuotaManager } from './monitoring/QuotaManager.js';
+export { StallTriageNurse } from './monitoring/StallTriageNurse.js';
+export { TriageOrchestrator } from './monitoring/TriageOrchestrator.js';
+export { FeedbackAnomalyDetector } from './monitoring/FeedbackAnomalyDetector.js';
+export { SessionMonitor } from './monitoring/SessionMonitor.js';
+export { CoherenceMonitor } from './monitoring/CoherenceMonitor.js';
+export { CommitmentTracker } from './monitoring/CommitmentTracker.js';
+export { CommitmentSentinel } from './monitoring/CommitmentSentinel.js';
+export { SessionActivitySentinel } from './monitoring/SessionActivitySentinel.js';
+export { HookEventReceiver } from './monitoring/HookEventReceiver.js';
+export { WorktreeMonitor } from './monitoring/WorktreeMonitor.js';
+export { SubagentTracker } from './monitoring/SubagentTracker.js';
+export { InstructionsVerifier } from './monitoring/InstructionsVerifier.js';
+export { TelemetryHeartbeat } from './monitoring/TelemetryHeartbeat.js';
+export { HTTP_HOOK_TEMPLATES, buildHttpHookSettings } from './data/http-hook-templates.js';
+export { SleepWakeDetector } from './core/SleepWakeDetector.js';
+// Messaging — Telegram & Notifications
+export { TelegramAdapter, TOPIC_STYLE, selectTopicEmoji } from './messaging/TelegramAdapter.js';
+export { classifyContent, validateTopicContent, getTopicPurpose } from './messaging/TopicContentValidator.js';
+export { NotificationBatcher } from './messaging/NotificationBatcher.js';
+// Messaging — Inter-Agent Messaging (Phase 1)
+// Note: MessageType and AgentMessage are aliased to avoid conflict with AgentBus exports.
+// Use InterAgentMessageType/InterAgentMessage for the new messaging system,
+// or import directly from 'instar/messaging/types' for unaliased access.
+export { MessageStore } from './messaging/MessageStore.js';
+export { MessageFormatter } from './messaging/MessageFormatter.js';
+export { MessageDelivery } from './messaging/MessageDelivery.js';
+export { MessageRouter, canonicalJSON } from './messaging/MessageRouter.js';
+export { generateAgentToken, getAgentToken, verifyAgentToken, computeDropHmac, verifyDropHmac, deleteAgentToken, listAgentTokens, ensureTokenDir, } from './messaging/AgentTokenManager.js';
+export { pickupDroppedMessages } from './messaging/DropPickup.js';
+export { VALID_TRANSITIONS, ALLOWED_INJECTION_PROCESSES, DEFAULT_TTL, DEFAULT_RETENTION_DAYS, DEFAULT_RATE_LIMITS, THREAD_MAX_DEPTH, THREAD_STALE_MINUTES, MAX_BODY_SIZE, MAX_PAYLOAD_SIZE, MAX_SUBJECT_LENGTH, PAYLOAD_INLINE_THRESHOLD, CLOCK_SKEW_TOLERANCE, } from './messaging/types.js';
+// Knowledge
+export { KnowledgeManager } from './knowledge/KnowledgeManager.js';
+// Self-Knowledge Tree
+export { SelfKnowledgeTree } from './knowledge/SelfKnowledgeTree.js';
+export { TreeGenerator } from './knowledge/TreeGenerator.js';
+export { TreeTriage } from './knowledge/TreeTriage.js';
+export { TreeTraversal } from './knowledge/TreeTraversal.js';
+export { TreeSynthesis } from './knowledge/TreeSynthesis.js';
+export { ProbeRegistry, ProbeExecutionError, ProbeTimeoutError } from './knowledge/ProbeRegistry.js';
+export { CoverageAuditor } from './knowledge/CoverageAuditor.js';
+// Publishing
+export { TelegraphService, markdownToNodes, parseInline } from './publishing/TelegraphService.js';
+export { PrivateViewer } from './publishing/PrivateViewer.js';
+// Tunnel
+export { TunnelManager } from './tunnel/TunnelManager.js';
+export { toInbound, toPipeline, toInjection, toLogEntry, formatHistoryLine, buildInjectionTag } from './types/pipeline.js';
+// Utils
+export { maybeRotateJsonl } from './utils/jsonl-rotation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/knowledge/CoverageAuditor.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CoverageAuditor — Detects gaps between agent capabilities and tree coverage.
+ *
+ * Compares what the agent CAN do (platforms, memory, jobs, etc.) against
+ * what the tree KNOWS about (nodes with valid sources). Reports missing
+ * coverage and content validity.
+ */
+import type { SelfKnowledgeTreeConfig, ValidationResult } from './types.js';
+export interface CoverageGap {
+    /** What's missing */
+    description: string;
+    /** Which layer it belongs to */
+    layerId: string;
+    /** Suggested node ID */
+    suggestedNodeId: string;
+    /** Severity: how much this gap matters */
+    severity: 'low' | 'medium' | 'high';
+}
+export interface AuditResult {
+    /** Overall content coverage score (0-1) */
+    coverageScore: number;
+    /** Total nodes in tree */
+    totalNodes: number;
+    /** Nodes with valid, non-empty sources */
+    validNodes: number;
+    /** Detected gaps */
+    gaps: CoverageGap[];
+    /** Validation result from tree */
+    validation: ValidationResult;
+}
+export interface HealthSummary {
+    totalNodes: number;
+    coverageScore: number;
+    cacheHitRate: number;
+    avgLatencyMs: number;
+    errorRate: number;
+    searchCount: number;
+    degradedSearches: number;
+}
+export declare class CoverageAuditor {
+    private projectDir;
+    private stateDir;
+    constructor(projectDir: string, stateDir: string);
+    /**
+     * Run a full coverage audit.
+     */
+    audit(config: SelfKnowledgeTreeConfig, validation: ValidationResult, detectedPlatforms?: string[]): AuditResult;
+    /**
+     * Detect platforms from agent config files.
+     */
+    detectPlatforms(): string[];
+    /**
+     * Build health summary from trace logs.
+     */
+    healthSummary(): HealthSummary;
+    private countNodes;
+}
+//# sourceMappingURL=CoverageAuditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoverageAuditor.d.ts","sourceRoot":"","sources":["../../src/knowledge/CoverageAuditor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,uBAAuB,EAEvB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ;gBADR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;IAG1B;;OAEG;IACH,KAAK,CACH,MAAM,EAAE,uBAAuB,EAC/B,UAAU,EAAE,gBAAgB,EAC5B,iBAAiB,GAAE,MAAM,EAAO,GAC/B,WAAW;IA6Cd;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IA6B3B;;OAEG;IACH,aAAa,IAAI,aAAa;IA0D9B,OAAO,CAAC,UAAU;CAGnB"}

package/dist/knowledge/CoverageAuditor.js

@@ -0,0 +1,153 @@
+/**
+ * CoverageAuditor — Detects gaps between agent capabilities and tree coverage.
+ *
+ * Compares what the agent CAN do (platforms, memory, jobs, etc.) against
+ * what the tree KNOWS about (nodes with valid sources). Reports missing
+ * coverage and content validity.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class CoverageAuditor {
+    projectDir;
+    stateDir;
+    constructor(projectDir, stateDir) {
+        this.projectDir = projectDir;
+        this.stateDir = stateDir;
+    }
+    /**
+     * Run a full coverage audit.
+     */
+    audit(config, validation, detectedPlatforms = []) {
+        const gaps = [];
+        // Detect platform coverage gaps
+        const existingNodeIds = new Set();
+        for (const layer of config.layers) {
+            for (const node of layer.children) {
+                existingNodeIds.add(node.id);
+            }
+        }
+        for (const platform of detectedPlatforms) {
+            const stateNodeId = `state.${platform.toLowerCase()}`;
+            if (!existingNodeIds.has(stateNodeId)) {
+                gaps.push({
+                    description: `Agent has ${platform} binding but no ${stateNodeId} node`,
+                    layerId: 'state',
+                    suggestedNodeId: stateNodeId,
+                    severity: 'medium',
+                });
+            }
+        }
+        // Detect missing layers
+        const expectedLayers = ['identity', 'experience', 'capabilities', 'state', 'evolution'];
+        for (const expected of expectedLayers) {
+            if (!config.layers.some(l => l.id === expected)) {
+                gaps.push({
+                    description: `Missing expected layer: ${expected}`,
+                    layerId: expected,
+                    suggestedNodeId: `${expected}.core`,
+                    severity: 'high',
+                });
+            }
+        }
+        return {
+            coverageScore: validation.coverageScore,
+            totalNodes: this.countNodes(config),
+            validNodes: Math.round(validation.coverageScore * this.countNodes(config)),
+            gaps,
+            validation,
+        };
+    }
+    /**
+     * Detect platforms from agent config files.
+     */
+    detectPlatforms() {
+        const platforms = [];
+        // Check instar config
+        const configPath = path.join(this.stateDir, 'config.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+                if (Array.isArray(config.messaging)) {
+                    for (const m of config.messaging) {
+                        if (m.enabled !== false && m.type) {
+                            platforms.push(m.type);
+                        }
+                    }
+                }
+                if (Array.isArray(config.platforms)) {
+                    for (const p of config.platforms) {
+                        const name = typeof p === 'string' ? p : p.type || p.name;
+                        if (name && !platforms.includes(name)) {
+                            platforms.push(name);
+                        }
+                    }
+                }
+            }
+            catch { /* skip */ }
+        }
+        return platforms;
+    }
+    /**
+     * Build health summary from trace logs.
+     */
+    healthSummary() {
+        const tracePath = path.join(this.stateDir, 'logs', 'tree-trace.jsonl');
+        const defaultSummary = {
+            totalNodes: 0,
+            coverageScore: 0,
+            cacheHitRate: 0,
+            avgLatencyMs: 0,
+            errorRate: 0,
+            searchCount: 0,
+            degradedSearches: 0,
+        };
+        if (!fs.existsSync(tracePath))
+            return defaultSummary;
+        try {
+            const lines = fs.readFileSync(tracePath, 'utf-8').trim().split('\n');
+            if (lines.length === 0 || (lines.length === 1 && !lines[0]))
+                return defaultSummary;
+            const entries = [];
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    entries.push(JSON.parse(line));
+                }
+                catch { /* skip corrupt lines */ }
+            }
+            if (entries.length === 0)
+                return defaultSummary;
+            let totalLatency = 0;
+            let totalCacheHits = 0;
+            let totalCacheMisses = 0;
+            let totalErrors = 0;
+            let degradedCount = 0;
+            for (const entry of entries) {
+                totalLatency += entry.elapsedMs || 0;
+                totalCacheHits += entry.cacheHits?.length ?? 0;
+                totalCacheMisses += entry.cacheMisses?.length ?? 0;
+                totalErrors += entry.errors?.length ?? 0;
+                if (entry.degraded)
+                    degradedCount++;
+            }
+            const totalCacheOps = totalCacheHits + totalCacheMisses;
+            return {
+                totalNodes: 0, // Caller fills this from config
+                coverageScore: 0, // Caller fills this from validation
+                cacheHitRate: totalCacheOps > 0 ? totalCacheHits / totalCacheOps : 0,
+                avgLatencyMs: entries.length > 0 ? totalLatency / entries.length : 0,
+                errorRate: entries.length > 0 ? totalErrors / entries.length : 0,
+                searchCount: entries.length,
+                degradedSearches: degradedCount,
+            };
+        }
+        catch {
+            return defaultSummary;
+        }
+    }
+    countNodes(config) {
+        return config.layers.reduce((sum, l) => sum + l.children.length, 0);
+    }
+}
+//# sourceMappingURL=CoverageAuditor.js.map

package/dist/knowledge/CoverageAuditor.js.map

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

package/dist/knowledge/IntegrityManager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * IntegrityManager — HMAC-SHA256 integrity verification for context files.
+ *
+ * Signs context files and verifies them at tree traversal time.
+ * Uses a dedicated signing key (NOT the auth token) that is per-agent
+ * and auto-generated on first use.
+ *
+ * Manifest is stored at .instar/context/.integrity.json
+ */
+export interface IntegritySignature {
+    hmac: string;
+    signedAt: string;
+    size: number;
+}
+export interface IntegrityManifest {
+    version: string;
+    signatures: Record<string, IntegritySignature>;
+}
+export interface VerifyResult {
+    valid: boolean;
+    reason?: string;
+}
+export declare class IntegrityManager {
+    private signingKey;
+    private _manifestPath;
+    constructor(signingKey: string, stateDir: string);
+    get manifestPath(): string;
+    /**
+     * Sign a file and store its HMAC in the manifest.
+     * The filePath should be relative to the project/state dir for manifest keys,
+     * but absolute for reading.
+     */
+    sign(filePath: string): void;
+    /**
+     * Sign all files in a directory recursively.
+     */
+    signDirectory(dirPath: string): void;
+    /**
+     * Verify a single file against its stored HMAC.
+     */
+    verify(filePath: string): VerifyResult;
+    private computeHmac;
+    private loadManifest;
+    private saveManifest;
+}
+//# sourceMappingURL=IntegrityManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntegrityManager.d.ts","sourceRoot":"","sources":["../../src/knowledge/IntegrityManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;gBAElB,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOhD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAc5B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAepC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAuBtC,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;CAGrB"}

package/dist/knowledge/IntegrityManager.js

@@ -0,0 +1,101 @@
+/**
+ * IntegrityManager — HMAC-SHA256 integrity verification for context files.
+ *
+ * Signs context files and verifies them at tree traversal time.
+ * Uses a dedicated signing key (NOT the auth token) that is per-agent
+ * and auto-generated on first use.
+ *
+ * Manifest is stored at .instar/context/.integrity.json
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+export class IntegrityManager {
+    signingKey;
+    _manifestPath;
+    constructor(signingKey, stateDir) {
+        this.signingKey = signingKey;
+        const contextDir = path.join(stateDir, 'context');
+        fs.mkdirSync(contextDir, { recursive: true });
+        this._manifestPath = path.join(contextDir, '.integrity.json');
+    }
+    get manifestPath() {
+        return this._manifestPath;
+    }
+    /**
+     * Sign a file and store its HMAC in the manifest.
+     * The filePath should be relative to the project/state dir for manifest keys,
+     * but absolute for reading.
+     */
+    sign(filePath) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const hmac = this.computeHmac(content);
+        const stat = fs.statSync(filePath);
+        const manifest = this.loadManifest();
+        manifest.signatures[filePath] = {
+            hmac,
+            signedAt: new Date().toISOString(),
+            size: stat.size,
+        };
+        this.saveManifest(manifest);
+    }
+    /**
+     * Sign all files in a directory recursively.
+     */
+    signDirectory(dirPath) {
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                // Skip hidden directories (like .integrity.json's parent)
+                if (!entry.name.startsWith('.')) {
+                    this.signDirectory(fullPath);
+                }
+            }
+            else if (entry.isFile()) {
+                this.sign(fullPath);
+            }
+        }
+    }
+    /**
+     * Verify a single file against its stored HMAC.
+     */
+    verify(filePath) {
+        const manifest = this.loadManifest();
+        const entry = manifest.signatures[filePath];
+        if (!entry) {
+            return { valid: false, reason: 'not_in_manifest' };
+        }
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return { valid: false, reason: 'file_not_found' };
+        }
+        const hmac = this.computeHmac(content);
+        if (hmac !== entry.hmac) {
+            return { valid: false, reason: 'hmac_mismatch' };
+        }
+        return { valid: true };
+    }
+    computeHmac(content) {
+        return crypto
+            .createHmac('sha256', this.signingKey)
+            .update(content)
+            .digest('hex');
+    }
+    loadManifest() {
+        try {
+            const raw = fs.readFileSync(this._manifestPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return { version: '1.0', signatures: {} };
+        }
+    }
+    saveManifest(manifest) {
+        fs.writeFileSync(this._manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+    }
+}
+//# sourceMappingURL=IntegrityManager.js.map

package/dist/knowledge/IntegrityManager.js.map

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

package/dist/knowledge/KnowledgeManager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * KnowledgeManager — Manages a structured knowledge base for Instar agents.
+ *
+ * Handles ingestion of external content (URLs, documents) into the
+ * MemoryIndex-backed knowledge base. Provides catalog tracking,
+ * YAML frontmatter generation, and source lifecycle management.
+ *
+ * The knowledge base is NOT a separate search engine — it's a set of
+ * well-organized markdown files that MemoryIndex indexes via FTS5.
+ *
+ * Born from: Matthew Berman OpenClaw analysis (2026-02-25)
+ */
+export interface KnowledgeSource {
+    id: string;
+    title: string;
+    url: string | null;
+    type: 'article' | 'transcript' | 'doc';
+    ingestedAt: string;
+    filePath: string;
+    tags: string[];
+    summary: string;
+    wordCount: number;
+}
+export interface KnowledgeCatalog {
+    sources: KnowledgeSource[];
+}
+export interface IngestOptions {
+    title: string;
+    url?: string;
+    type?: 'article' | 'transcript' | 'doc';
+    tags?: string[];
+    summary?: string;
+}
+export interface IngestResult {
+    sourceId: string;
+    filePath: string;
+    wordCount: number;
+}
+export declare class KnowledgeManager {
+    private readonly knowledgeDir;
+    private readonly catalogPath;
+    constructor(stateDir: string);
+    /**
+     * Ingest content into the knowledge base.
+     * Creates a markdown file with YAML frontmatter and updates the catalog.
+     */
+    ingest(content: string, options: IngestOptions): IngestResult;
+    /**
+     * Remove a source from the knowledge base.
+     * Deletes the file and catalog entry.
+     */
+    remove(sourceId: string): boolean;
+    /**
+     * Get the catalog of all ingested sources.
+     */
+    getCatalog(tag?: string): KnowledgeSource[];
+    /**
+     * Get a single source by ID.
+     */
+    getSource(sourceId: string): KnowledgeSource | null;
+    /**
+     * Get all unique tags across all sources.
+     */
+    getAllTags(): string[];
+    /**
+     * Get the knowledge directory path (for MemoryIndex source configuration).
+     */
+    getKnowledgeDir(): string;
+    /**
+     * Get the MemoryIndex source entries for knowledge base directories.
+     * Use these to extend the agent's memory config.
+     */
+    getMemorySourceEntries(): Array<{
+        path: string;
+        type: string;
+        evergreen: boolean;
+    }>;
+    private ensureDirectories;
+    private loadCatalog;
+    private saveCatalog;
+    private generateId;
+    private slugify;
+    private subdirForType;
+}
+//# sourceMappingURL=KnowledgeManager.d.ts.map