pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,779 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Evidence Pool - Tracks knowledge from multiple sources with conflict detection.
|
|
3
|
+
* Uses the triple-critic LLM classification system for evidence conflict
|
|
4
|
+
* detection with three-tier fallback (heuristic -> utility -> session).
|
|
5
|
+
*
|
|
6
|
+
* XoT (Cross-observational Thinking) two-stage decomposition:
|
|
7
|
+
* Stage 1 - Evidence Explanation: classify conflicts via classify() + CRITICS.evidenceConflict
|
|
8
|
+
* Stage 2 - Faithful Reasoning: acknowledgment generation (formatConflictMessage)
|
|
9
|
+
*
|
|
10
|
+
* Flow:
|
|
11
|
+
* 1. memory (recall_search), web search, docs reading, code execution -> addEvidence()
|
|
12
|
+
* 2. tool_result -> addEvidence() (calibration tracking)
|
|
13
|
+
* 3. message_end -> detectConflicts() (heuristic O(N^2) pre-filter) ->
|
|
14
|
+
* classifyConflictsWithLLM() (async triple-critic LLM re-classification)
|
|
15
|
+
* 4. conflict-qa -> Stage 2: question generation + enforcement whisper
|
|
16
|
+
*
|
|
17
|
+
* Conflict detection is a two-phase process:
|
|
18
|
+
* Phase 1 (sync): O(N^2) token-overlap heuristic pre-filter + classifyConflict()
|
|
19
|
+
* Phase 2 (async): classifyConflictViaCritic() with classify() + CRITICS.evidenceConflict
|
|
20
|
+
* upgrades "implication" conflicts to "direct" when LLM detects a real contradiction.
|
|
21
|
+
*
|
|
22
|
+
* Replaces the previous implementation that maintained a local STOP_WORDS
|
|
23
|
+
* copy (80+ words) and used raw token-overlap thresholds for conflict detection.
|
|
24
|
+
* The stop-word list is now shared via import from critic-registry.ts, and
|
|
25
|
+
* conflict classification uses the triple-critic system.
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
29
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
30
|
+
import { STOP_WORDS, CRITICS } from "../ai/critic-registry.js";
|
|
31
|
+
import { classify } from "../ai/text-classifier.js";
|
|
32
|
+
import { nextId } from "../utils/id.js";
|
|
33
|
+
import { loadState, saveState } from "../state/async-storage.js";
|
|
34
|
+
import { evidencePoolFilePath } from "../config/braid-paths.js";
|
|
35
|
+
import { createLogger } from "../core/logger.js";
|
|
36
|
+
|
|
37
|
+
const log = createLogger("evidence-pool");
|
|
38
|
+
|
|
39
|
+
// ── Cross-session persistence ────────────────────────────────────────────────
|
|
40
|
+
|
|
41
|
+
let loadedFromDisk = false;
|
|
42
|
+
|
|
43
|
+
/** Warned once per process about a refused evidence-pool store. Persistence
|
|
44
|
+
* here is best-effort by design; a refusal is loud but never thrown. */
|
|
45
|
+
let _warnedSinkRefusal = false;
|
|
46
|
+
|
|
47
|
+
function reportSinkRefusal(action: string, err: unknown): void {
|
|
48
|
+
if (_warnedSinkRefusal) return;
|
|
49
|
+
_warnedSinkRefusal = true;
|
|
50
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
51
|
+
log.warn(`evidence pool ${action} refused (${message}); the pool is session-local`);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function loadFromDisk(ctx: ExtensionContext): void {
|
|
55
|
+
if (loadedFromDisk) return;
|
|
56
|
+
loadedFromDisk = true;
|
|
57
|
+
let file: string;
|
|
58
|
+
try {
|
|
59
|
+
file = evidencePoolFilePath();
|
|
60
|
+
} catch (err) {
|
|
61
|
+
reportSinkRefusal("read", err);
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
loadState<EvidencePoolState>(file)
|
|
65
|
+
.then((diskState) => {
|
|
66
|
+
if (!diskState) return;
|
|
67
|
+
const raw = getExtensionState(ctx, "evidence-pool", createEvidencePoolState);
|
|
68
|
+
const state = raw as unknown as EvidencePoolState;
|
|
69
|
+
// Merge: prefer in-memory evidence (current session) over disk
|
|
70
|
+
// but keep unresolved conflicts from previous sessions.
|
|
71
|
+
const existingIds = new Set(state.evidence.map((e) => e.id));
|
|
72
|
+
for (const e of diskState.evidence) {
|
|
73
|
+
if (!existingIds.has(e.id)) {
|
|
74
|
+
state.evidence.push(e);
|
|
75
|
+
existingIds.add(e.id);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
const existingConflictIds = new Set(state.conflicts.map((c) => c.id));
|
|
79
|
+
for (const c of diskState.conflicts) {
|
|
80
|
+
if (!existingConflictIds.has(c.id)) {
|
|
81
|
+
state.conflicts.push(c);
|
|
82
|
+
existingConflictIds.add(c.id);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
if (diskState.lastCleanup > state.lastCleanup) {
|
|
86
|
+
state.lastCleanup = diskState.lastCleanup;
|
|
87
|
+
}
|
|
88
|
+
})
|
|
89
|
+
.catch(() => {
|
|
90
|
+
// File doesn't exist yet - first session, no persistence needed
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
function persistState(state: EvidencePoolState): void {
|
|
95
|
+
let file: string;
|
|
96
|
+
try {
|
|
97
|
+
file = evidencePoolFilePath();
|
|
98
|
+
} catch (err) {
|
|
99
|
+
reportSinkRefusal("write", err);
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
saveState(file, {
|
|
103
|
+
evidence: state.evidence,
|
|
104
|
+
conflicts: state.conflicts,
|
|
105
|
+
lastCleanup: state.lastCleanup,
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// ── Types ────────────────────────────────────────────────────────────────────
|
|
110
|
+
|
|
111
|
+
export type EvidenceSource = "memory" | "web" | "docs" | "code" | "session" | "unknown";
|
|
112
|
+
|
|
113
|
+
/** How the confidence was derived - affects reliability weighting (XoT Stage 1) */
|
|
114
|
+
export type EvidenceConfidenceType = "parametric" | "retrieved" | "observed";
|
|
115
|
+
|
|
116
|
+
/** XoT Stage 1: Conflict classification */
|
|
117
|
+
export type ConflictClassification = "direct" | "implication" | "reliability";
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Source reliability baseline scores - prior probability that source is accurate.
|
|
121
|
+
* Used as multiplicative factor when computing evidence reliability.
|
|
122
|
+
*/
|
|
123
|
+
const SOURCE_RELIABILITY: Record<EvidenceSource, number> = {
|
|
124
|
+
code: 0.95, // Executed code is ground truth
|
|
125
|
+
docs: 0.85, // Documentation is highly reliable
|
|
126
|
+
memory: 0.7, // Memory is moderate reliability
|
|
127
|
+
web: 0.6, // Web is variable quality
|
|
128
|
+
session: 0.5, // Session knowledge may be outdated
|
|
129
|
+
unknown: 0.4,
|
|
130
|
+
};
|
|
131
|
+
|
|
132
|
+
export interface Evidence {
|
|
133
|
+
id: string;
|
|
134
|
+
claim: string;
|
|
135
|
+
normalized: string;
|
|
136
|
+
content: string;
|
|
137
|
+
source: EvidenceSource;
|
|
138
|
+
confidence: number; // Caller-provided confidence (0-1)
|
|
139
|
+
confidenceType: EvidenceConfidenceType;
|
|
140
|
+
reliability: number; // Computed: SOURCE_RELIABILITY[source] x confidence
|
|
141
|
+
/** Project path where this evidence was created. Used for provenance tagging (HaluMem, 2511.03506). */
|
|
142
|
+
project: string;
|
|
143
|
+
timestamp: number;
|
|
144
|
+
turn?: number;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
export interface Conflict {
|
|
148
|
+
id: string;
|
|
149
|
+
claim: string;
|
|
150
|
+
for: Evidence[];
|
|
151
|
+
against: Evidence[];
|
|
152
|
+
verdict: "unresolved" | "resolved_for" | "resolved_against" | "uncertain";
|
|
153
|
+
resolvedBy?: string;
|
|
154
|
+
resolvedAt?: number;
|
|
155
|
+
detectedAt: number;
|
|
156
|
+
/** XoT Stage 1 result - how the conflict was classified */
|
|
157
|
+
classification: ConflictClassification;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
export interface EvidencePoolState {
|
|
161
|
+
evidence: Evidence[];
|
|
162
|
+
conflicts: Conflict[];
|
|
163
|
+
lastCleanup: number;
|
|
164
|
+
classifierStats: ConflictClassifierStats;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Counters for the conflict-classifier's non-fatal failure paths. Each one is
|
|
169
|
+
* a place where a failed LLM check falls back to the heuristic or skips a
|
|
170
|
+
* pair; without the counters those paths are indistinguishable from a run
|
|
171
|
+
* where every classification succeeded.
|
|
172
|
+
*/
|
|
173
|
+
export interface ConflictClassifierStats {
|
|
174
|
+
/** classifyConflictViaCritic's classify() call threw and the heuristic took over. */
|
|
175
|
+
llmFallbacks: number;
|
|
176
|
+
/** One conflict in classifyConflictsWithLLM failed before classification finished. */
|
|
177
|
+
reclassifyFailures: number;
|
|
178
|
+
/** One candidate pair in detectSemanticConflicts failed its check. */
|
|
179
|
+
semanticFailures: number;
|
|
180
|
+
/** Message from the most recent recorded failure. */
|
|
181
|
+
lastError: string | null;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
// ── uniform conflicts cap ────────────────────────────────────────
|
|
185
|
+
//
|
|
186
|
+
// The conflicts array was capped ONLY inside detectConflicts() (20 -> 10);
|
|
187
|
+
// the detectConflictsFor (per-evidence) and detectSemanticConflicts paths
|
|
188
|
+
// pushed conflicts WITHOUT any cap — so conflicts (which hold Evidence
|
|
189
|
+
// references, keeping evicted evidence alive) grew unbounded on the most
|
|
190
|
+
// common path (every addEvidence call). This helper applies the SAME
|
|
191
|
+
// existing cap semantics after EVERY push path. Disk persistence (persist-)
|
|
192
|
+
// State) already mirrors the trimmed array, so disk and memory stay in step
|
|
193
|
+
// with the pre-existing cap semantics — no new persistence layer.
|
|
194
|
+
|
|
195
|
+
const CONFLICTS_CAP = 20;
|
|
196
|
+
const CONFLICTS_KEEP = 10;
|
|
197
|
+
|
|
198
|
+
function trimConflicts(state: EvidencePoolState): void {
|
|
199
|
+
if (state.conflicts.length > CONFLICTS_CAP) {
|
|
200
|
+
state.conflicts = state.conflicts.slice(-CONFLICTS_KEEP);
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
// ── State factory ────────────────────────────────────────────────────────────
|
|
205
|
+
|
|
206
|
+
function createEvidencePoolState(): EvidencePoolState {
|
|
207
|
+
return {
|
|
208
|
+
evidence: [],
|
|
209
|
+
conflicts: [],
|
|
210
|
+
lastCleanup: Date.now(),
|
|
211
|
+
classifierStats: {
|
|
212
|
+
llmFallbacks: 0,
|
|
213
|
+
reclassifyFailures: 0,
|
|
214
|
+
semanticFailures: 0,
|
|
215
|
+
lastError: null,
|
|
216
|
+
},
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
function getState(ctx: ExtensionContext): EvidencePoolState {
|
|
221
|
+
loadFromDisk(ctx);
|
|
222
|
+
return getExtensionState(ctx, "evidence-pool", createEvidencePoolState);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
function recordClassifierFailure(
|
|
226
|
+
state: EvidencePoolState,
|
|
227
|
+
kind: "llmFallbacks" | "reclassifyFailures" | "semanticFailures",
|
|
228
|
+
error: unknown,
|
|
229
|
+
context: string,
|
|
230
|
+
): void {
|
|
231
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
232
|
+
state.classifierStats[kind]++;
|
|
233
|
+
state.classifierStats.lastError = message;
|
|
234
|
+
log.warn(`[conflict-classifier] ${context}: ${message}`);
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/**
|
|
238
|
+
* Classifier degradation counters for this session. These are what make a
|
|
239
|
+
* dark classifier tier distinguishable from a quiet one.
|
|
240
|
+
*/
|
|
241
|
+
export function getConflictClassifierStats(ctx: ExtensionContext): ConflictClassifierStats {
|
|
242
|
+
return { ...getState(ctx).classifierStats };
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
// ── Normalization helpers (uses shared STOP_WORDS from critic-registry) ─
|
|
246
|
+
|
|
247
|
+
/** Normalize claim for comparison: lowercase, remove stopwords, sort words */
|
|
248
|
+
function normalize(text: string): string {
|
|
249
|
+
const tokens = text
|
|
250
|
+
.toLowerCase()
|
|
251
|
+
.split(/\W+/)
|
|
252
|
+
.filter((t) => t.length > 2 && !STOP_WORDS.has(t));
|
|
253
|
+
return tokens.sort().join(" ");
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/** Token overlap ratio between two texts. Exported for conflict-qa reuse. */
|
|
257
|
+
export function tokenOverlap(a: string, b: string): number {
|
|
258
|
+
const tokensA = new Set(normalize(a).split(" "));
|
|
259
|
+
const tokensB = new Set(normalize(b).split(" "));
|
|
260
|
+
if (tokensA.size === 0 || tokensB.size === 0) return 0;
|
|
261
|
+
let overlap = 0;
|
|
262
|
+
for (const t of tokensA) {
|
|
263
|
+
if (tokensB.has(t)) overlap++;
|
|
264
|
+
}
|
|
265
|
+
return overlap / Math.max(tokensA.size, tokensB.size);
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
/** Extract the core claim from text (first sentence, stripped) */
|
|
269
|
+
function extractClaim(text: string, maxLen = 80): string {
|
|
270
|
+
const first = text.split(/[.!?\n]/)[0].trim();
|
|
271
|
+
return first.length > maxLen ? first.slice(0, maxLen) + "..." : first;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
// ── XoT Stage 1: Conflict Classification (triple-critic) ──────────────────────
|
|
275
|
+
|
|
276
|
+
/**
|
|
277
|
+
* Classify a conflict using triple-critic LLM classification.
|
|
278
|
+
* XoT Stage 1: Evidence Explanation.
|
|
279
|
+
*
|
|
280
|
+
* Three-tier fallback:
|
|
281
|
+
* Tier 1: evidenceConflictFallback (token overlap)
|
|
282
|
+
* Tier 2: utility model (if configured)
|
|
283
|
+
* Tier 3: session model (always available)
|
|
284
|
+
*/
|
|
285
|
+
|
|
286
|
+
/**
|
|
287
|
+
* Classify a conflict using source reliability and claim overlap.
|
|
288
|
+
* Kept for backward compatibility (sync callers).
|
|
289
|
+
*
|
|
290
|
+
* @deprecated Prefer classifyConflictViaCritic for async contexts with ExtensionContext.
|
|
291
|
+
*/
|
|
292
|
+
export function classifyConflict(
|
|
293
|
+
forEvidence: Evidence[],
|
|
294
|
+
againstEvidence: Evidence[],
|
|
295
|
+
): ConflictClassification {
|
|
296
|
+
const forText = forEvidence.map((e) => e.normalized).join(" ");
|
|
297
|
+
const againstText = againstEvidence.map((e) => e.normalized).join(" ");
|
|
298
|
+
const overlap = tokenOverlap(forText, againstText);
|
|
299
|
+
|
|
300
|
+
// Direct: High overlap between the claims (same topic being contradicted)
|
|
301
|
+
if (overlap > 0.5) return "direct";
|
|
302
|
+
|
|
303
|
+
// Reliability: Source reliability difference > 0.2
|
|
304
|
+
const forReliability = forEvidence[0]?.reliability ?? 0.5;
|
|
305
|
+
const againstReliability = againstEvidence[0]?.reliability ?? 0.5;
|
|
306
|
+
if (Math.abs(forReliability - againstReliability) > 0.2) return "reliability";
|
|
307
|
+
|
|
308
|
+
// Default: implication-based (one claim may logically contradict another)
|
|
309
|
+
return "implication";
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
/**
|
|
313
|
+
* Classify a conflict using the triple-critic LLM system.
|
|
314
|
+
*
|
|
315
|
+
* The async replacement for classifyConflict(). Uses classify() with
|
|
316
|
+
* CRITICS.evidenceConflict to determine if two pieces of evidence
|
|
317
|
+
* directly contradict each other. When the LLM says "yes", returns
|
|
318
|
+
* "direct". When the LLM says "no" or is unavailable, falls back to
|
|
319
|
+
* the heuristic classifyConflict() result.
|
|
320
|
+
*
|
|
321
|
+
* This is the function that the deprecated classifyConflict() JSDoc
|
|
322
|
+
* tells callers to use -- it was referenced in a comment but never
|
|
323
|
+
* implemented.
|
|
324
|
+
*/
|
|
325
|
+
export async function classifyConflictViaCritic(
|
|
326
|
+
forEvidence: Evidence[],
|
|
327
|
+
againstEvidence: Evidence[],
|
|
328
|
+
ctx: ExtensionContext,
|
|
329
|
+
): Promise<ConflictClassification> {
|
|
330
|
+
const evidenceA = forEvidence.map((e) => e.claim).join("; ");
|
|
331
|
+
const evidenceB = againstEvidence.map((e) => e.claim).join("; ");
|
|
332
|
+
|
|
333
|
+
try {
|
|
334
|
+
const result = await classify(
|
|
335
|
+
ctx,
|
|
336
|
+
CRITICS.evidenceConflict.criteria,
|
|
337
|
+
{ evidenceA, evidenceB },
|
|
338
|
+
{
|
|
339
|
+
timeoutMs: 60_000,
|
|
340
|
+
label: CRITICS.evidenceConflict.label,
|
|
341
|
+
tierPolicy: "always-llm",
|
|
342
|
+
modelPreference: "quality",
|
|
343
|
+
},
|
|
344
|
+
);
|
|
345
|
+
|
|
346
|
+
if (result.label === "yes") return "direct";
|
|
347
|
+
} catch (e) {
|
|
348
|
+
// LLM failure -- fall through to heuristic, but leave a countable trace.
|
|
349
|
+
recordClassifierFailure(getState(ctx), "llmFallbacks", e, "classify() threw; using heuristic");
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
return classifyConflict(forEvidence, againstEvidence);
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
/**
|
|
356
|
+
* Re-classify all unresolved conflicts using the triple-critic LLM system.
|
|
357
|
+
* Runs in the background -- does not block the caller. Conflicts where the
|
|
358
|
+
* LLM detects a direct contradiction get upgraded from "implication" to
|
|
359
|
+
* "direct".
|
|
360
|
+
*/
|
|
361
|
+
export async function classifyConflictsWithLLM(
|
|
362
|
+
ctx: ExtensionContext,
|
|
363
|
+
conflicts: Conflict[],
|
|
364
|
+
): Promise<void> {
|
|
365
|
+
for (const conflict of conflicts) {
|
|
366
|
+
if (conflict.verdict !== "unresolved") continue;
|
|
367
|
+
if (conflict.classification === "direct") continue; // already classified
|
|
368
|
+
|
|
369
|
+
try {
|
|
370
|
+
const llmResult = await classifyConflictViaCritic(conflict.for, conflict.against, ctx);
|
|
371
|
+
if (llmResult === "direct") {
|
|
372
|
+
conflict.classification = llmResult;
|
|
373
|
+
}
|
|
374
|
+
} catch (e) {
|
|
375
|
+
// Per-conflict errors are non-fatal, but they must not be silent: this
|
|
376
|
+
// conflict was never re-classified.
|
|
377
|
+
recordClassifierFailure(
|
|
378
|
+
getState(ctx),
|
|
379
|
+
"reclassifyFailures",
|
|
380
|
+
e,
|
|
381
|
+
`re-classification failed for conflict ${conflict.id}`,
|
|
382
|
+
);
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
|
|
387
|
+
/**
|
|
388
|
+
* Detect semantically similar evidence pairs missed by the heuristic
|
|
389
|
+
* token-overlap pre-filter (< 0.3). Uses classify() with CRITICS.evidenceConflict
|
|
390
|
+
* to check if evidence about the same topic (but different wording) contradicts.
|
|
391
|
+
*
|
|
392
|
+
* Limited to MAX_SEMANTIC_CHECKS_PER_TURN (10) per call. Only checks pairs with
|
|
393
|
+
* overlap between SEMANTIC_OVERLAP_MIN (0.1) and SEMANTIC_OVERLAP_MAX (0.3) --
|
|
394
|
+
* pairs below 0.1 are considered truly unrelated.
|
|
395
|
+
*
|
|
396
|
+
* Returns newly detected conflicts.
|
|
397
|
+
*/
|
|
398
|
+
export async function detectSemanticConflicts(
|
|
399
|
+
ctx: ExtensionContext,
|
|
400
|
+
limit = MAX_SEMANTIC_CHECKS_PER_TURN,
|
|
401
|
+
): Promise<Conflict[]> {
|
|
402
|
+
const state = getState(ctx);
|
|
403
|
+
const evidence = state.evidence;
|
|
404
|
+
const newConflicts: Conflict[] = [];
|
|
405
|
+
|
|
406
|
+
// Collect candidate pairs with overlap in the semantic gap zone
|
|
407
|
+
const candidates: Array<{ a: Evidence; b: Evidence; overlap: number }> = [];
|
|
408
|
+
for (let i = 0; i < evidence.length; i++) {
|
|
409
|
+
for (let j = i + 1; j < evidence.length; j++) {
|
|
410
|
+
const a = evidence[i];
|
|
411
|
+
const b = evidence[j];
|
|
412
|
+
|
|
413
|
+
if (a.source === b.source) continue;
|
|
414
|
+
|
|
415
|
+
const overlap = tokenOverlap(a.normalized, b.normalized);
|
|
416
|
+
if (overlap < SEMANTIC_OVERLAP_MIN || overlap >= SEMANTIC_OVERLAP_MAX) continue;
|
|
417
|
+
|
|
418
|
+
const reliabilityDiff = Math.abs(a.reliability - b.reliability);
|
|
419
|
+
if (reliabilityDiff < 0.02) continue;
|
|
420
|
+
|
|
421
|
+
const existing = state.conflicts.find(
|
|
422
|
+
(c) =>
|
|
423
|
+
c.for.some((e) => e.id === a.id || e.id === b.id) ||
|
|
424
|
+
c.against.some((e) => e.id === a.id || e.id === b.id),
|
|
425
|
+
);
|
|
426
|
+
if (existing) continue;
|
|
427
|
+
|
|
428
|
+
candidates.push({ a, b, overlap });
|
|
429
|
+
}
|
|
430
|
+
}
|
|
431
|
+
|
|
432
|
+
// Sort by overlap descending -- most likely related first
|
|
433
|
+
candidates.sort((a, b) => b.overlap - a.overlap);
|
|
434
|
+
|
|
435
|
+
const toCheck = candidates.slice(0, limit);
|
|
436
|
+
|
|
437
|
+
for (const { a, b } of toCheck) {
|
|
438
|
+
try {
|
|
439
|
+
const evidenceA = a.claim;
|
|
440
|
+
const evidenceB = b.claim;
|
|
441
|
+
|
|
442
|
+
const result = await classify(
|
|
443
|
+
ctx,
|
|
444
|
+
CRITICS.evidenceConflict.criteria,
|
|
445
|
+
{ evidenceA, evidenceB },
|
|
446
|
+
{
|
|
447
|
+
timeoutMs: 60_000,
|
|
448
|
+
label: `semantic-${CRITICS.evidenceConflict.label}`,
|
|
449
|
+
tierPolicy: "always-llm",
|
|
450
|
+
modelPreference: "quality",
|
|
451
|
+
},
|
|
452
|
+
);
|
|
453
|
+
|
|
454
|
+
if (result.label !== "yes") continue;
|
|
455
|
+
|
|
456
|
+
// LLM confirmed these semantically similar claims contradict
|
|
457
|
+
const forEvidence = a.reliability > b.reliability ? [a] : [b];
|
|
458
|
+
const againstEvidence = a.reliability > b.reliability ? [b] : [a];
|
|
459
|
+
|
|
460
|
+
const conflict: Conflict = {
|
|
461
|
+
id: nextId("c"),
|
|
462
|
+
claim: `${a.claim.slice(0, 40)}... vs ${b.claim.slice(0, 40)}...`,
|
|
463
|
+
for: forEvidence,
|
|
464
|
+
against: againstEvidence,
|
|
465
|
+
verdict: "unresolved",
|
|
466
|
+
detectedAt: Date.now(),
|
|
467
|
+
classification: "direct",
|
|
468
|
+
};
|
|
469
|
+
state.conflicts.push(conflict);
|
|
470
|
+
newConflicts.push(conflict);
|
|
471
|
+
} catch (e) {
|
|
472
|
+
// Per-pair errors are non-fatal, but they must not be silent.
|
|
473
|
+
recordClassifierFailure(state, "semanticFailures", e, "semantic pair check failed");
|
|
474
|
+
}
|
|
475
|
+
}
|
|
476
|
+
|
|
477
|
+
// Semantic path previously pushed without any cap.
|
|
478
|
+
trimConflicts(state);
|
|
479
|
+
|
|
480
|
+
return newConflicts;
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
// ── Public API ──────────────────────────────────────────────────────────────
|
|
484
|
+
|
|
485
|
+
/**
|
|
486
|
+
* Add evidence to the pool from a knowledge source.
|
|
487
|
+
* Reliability is computed as: SOURCE_RELIABILITY[source] x confidence.
|
|
488
|
+
*/
|
|
489
|
+
export function addEvidence(
|
|
490
|
+
ctx: ExtensionContext,
|
|
491
|
+
claim: string,
|
|
492
|
+
source: EvidenceSource,
|
|
493
|
+
content: string,
|
|
494
|
+
confidence = 0.7,
|
|
495
|
+
confidenceType: EvidenceConfidenceType = "retrieved",
|
|
496
|
+
): string {
|
|
497
|
+
const state = getState(ctx);
|
|
498
|
+
|
|
499
|
+
const evidence: Evidence = {
|
|
500
|
+
id: nextId("e"),
|
|
501
|
+
claim: extractClaim(claim),
|
|
502
|
+
normalized: normalize(claim),
|
|
503
|
+
content: content.slice(0, 500),
|
|
504
|
+
source,
|
|
505
|
+
confidence,
|
|
506
|
+
confidenceType,
|
|
507
|
+
reliability: SOURCE_RELIABILITY[source] * confidence,
|
|
508
|
+
project: ctx.cwd ?? "unknown",
|
|
509
|
+
timestamp: Date.now(),
|
|
510
|
+
};
|
|
511
|
+
state.evidence.push(evidence);
|
|
512
|
+
|
|
513
|
+
// Cleanup old evidence (>50 entries -> keep last 30)
|
|
514
|
+
if (state.evidence.length > 50) {
|
|
515
|
+
state.evidence = state.evidence.slice(-30);
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
detectConflictsFor(ctx, evidence.id);
|
|
519
|
+
|
|
520
|
+
// DetectConflictsFor pushes conflicts with no cap — apply the
|
|
521
|
+
// uniform cap here too (same 20->10 semantics as detectConflicts).
|
|
522
|
+
trimConflicts(state);
|
|
523
|
+
|
|
524
|
+
persistState(state);
|
|
525
|
+
|
|
526
|
+
return evidence.id;
|
|
527
|
+
}
|
|
528
|
+
|
|
529
|
+
/**
|
|
530
|
+
* Get all evidence for a given context (optional filter by source).
|
|
531
|
+
*/
|
|
532
|
+
export function getEvidence(
|
|
533
|
+
ctx: ExtensionContext,
|
|
534
|
+
{
|
|
535
|
+
source,
|
|
536
|
+
project,
|
|
537
|
+
minConfidence,
|
|
538
|
+
maxAgeMs,
|
|
539
|
+
}: { source?: EvidenceSource; project?: string; minConfidence?: number; maxAgeMs?: number } = {},
|
|
540
|
+
): Evidence[] {
|
|
541
|
+
const state = getState(ctx);
|
|
542
|
+
const currentProject = ctx.cwd ?? "unknown";
|
|
543
|
+
let result = state.evidence;
|
|
544
|
+
|
|
545
|
+
if (source) result = result.filter((e) => e.source === source);
|
|
546
|
+
if (minConfidence !== undefined) result = result.filter((e) => e.confidence >= minConfidence);
|
|
547
|
+
if (maxAgeMs !== undefined) result = result.filter((e) => Date.now() - e.timestamp <= maxAgeMs);
|
|
548
|
+
|
|
549
|
+
// HaluMem (2511.03506): Cross-session isolation - project-aware filtering
|
|
550
|
+
if (project !== undefined) {
|
|
551
|
+
result = result.filter((e) => e.project === project);
|
|
552
|
+
} else if (source === undefined) {
|
|
553
|
+
// Default: prefer current project, allow legacy (project="unknown"), allow recent cross-project
|
|
554
|
+
result = result.filter((e) => {
|
|
555
|
+
if (!e.project || e.project === currentProject || e.project === "unknown") return true;
|
|
556
|
+
// Cross-project: only if <1h old and high confidence
|
|
557
|
+
const ageMs = Date.now() - e.timestamp;
|
|
558
|
+
return ageMs < 3600000 && e.confidence >= 0.8;
|
|
559
|
+
});
|
|
560
|
+
}
|
|
561
|
+
|
|
562
|
+
return result;
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
/**
|
|
566
|
+
* Get unresolved conflicts.
|
|
567
|
+
*/
|
|
568
|
+
export function getUnresolvedConflicts(ctx: ExtensionContext): Conflict[] {
|
|
569
|
+
return getState(ctx).conflicts.filter((c) => c.verdict === "unresolved");
|
|
570
|
+
}
|
|
571
|
+
|
|
572
|
+
/**
|
|
573
|
+
* Get all conflicts.
|
|
574
|
+
*/
|
|
575
|
+
export function getAllConflicts(ctx: ExtensionContext): Conflict[] {
|
|
576
|
+
return [...getState(ctx).conflicts];
|
|
577
|
+
}
|
|
578
|
+
|
|
579
|
+
/**
|
|
580
|
+
* Resolve a conflict with a verdict.
|
|
581
|
+
*/
|
|
582
|
+
export function resolveConflict(
|
|
583
|
+
ctx: ExtensionContext,
|
|
584
|
+
conflictId: string,
|
|
585
|
+
verdict: "resolved_for" | "resolved_against" | "uncertain",
|
|
586
|
+
resolvedBy: string,
|
|
587
|
+
): void {
|
|
588
|
+
const state = getState(ctx);
|
|
589
|
+
const conflict = state.conflicts.find((c) => c.id === conflictId);
|
|
590
|
+
if (!conflict) return;
|
|
591
|
+
conflict.verdict = verdict;
|
|
592
|
+
conflict.resolvedBy = resolvedBy;
|
|
593
|
+
conflict.resolvedAt = Date.now();
|
|
594
|
+
persistState(state);
|
|
595
|
+
}
|
|
596
|
+
|
|
597
|
+
/**
|
|
598
|
+
* Detect conflicts among all evidence in the pool.
|
|
599
|
+
* Uses triple-critic LLM classification (XoT Stage 1) with heuristic token-overlap
|
|
600
|
+
* as a cheap pre-filter to avoid O(N^2) LLM calls for unrelated evidence pairs.
|
|
601
|
+
*
|
|
602
|
+
* Returns newly detected conflicts.
|
|
603
|
+
*/
|
|
604
|
+
export function detectConflicts(ctx: ExtensionContext): Conflict[] {
|
|
605
|
+
const state = getState(ctx);
|
|
606
|
+
const evidence = state.evidence;
|
|
607
|
+
const newConflicts: Conflict[] = [];
|
|
608
|
+
|
|
609
|
+
for (let i = 0; i < evidence.length; i++) {
|
|
610
|
+
for (let j = i + 1; j < evidence.length; j++) {
|
|
611
|
+
const a = evidence[i];
|
|
612
|
+
const b = evidence[j];
|
|
613
|
+
|
|
614
|
+
if (a.source === b.source) continue;
|
|
615
|
+
|
|
616
|
+
// Cheap pre-filter: token overlap must be substantial
|
|
617
|
+
const overlap = tokenOverlap(a.normalized, b.normalized);
|
|
618
|
+
if (overlap < 0.3) continue;
|
|
619
|
+
|
|
620
|
+
const reliabilityDiff = Math.abs(a.reliability - b.reliability);
|
|
621
|
+
if (reliabilityDiff < 0.02) continue;
|
|
622
|
+
|
|
623
|
+
const existing = state.conflicts.find(
|
|
624
|
+
(c) =>
|
|
625
|
+
c.for.some((e) => e.id === a.id || e.id === b.id) ||
|
|
626
|
+
c.against.some((e) => e.id === a.id || e.id === b.id),
|
|
627
|
+
);
|
|
628
|
+
if (existing) continue;
|
|
629
|
+
|
|
630
|
+
// Higher reliability goes in "for"
|
|
631
|
+
const forEvidence = a.reliability > b.reliability ? [a] : [b];
|
|
632
|
+
const againstEvidence = a.reliability > b.reliability ? [b] : [a];
|
|
633
|
+
|
|
634
|
+
const conflict: Conflict = {
|
|
635
|
+
id: nextId("c"),
|
|
636
|
+
claim:
|
|
637
|
+
overlap >= 0.5 ? a.claim : `${a.claim.slice(0, 40)}... vs ${b.claim.slice(0, 40)}...`,
|
|
638
|
+
for: forEvidence,
|
|
639
|
+
against: againstEvidence,
|
|
640
|
+
verdict: "unresolved",
|
|
641
|
+
detectedAt: Date.now(),
|
|
642
|
+
classification: classifyConflict(forEvidence, againstEvidence),
|
|
643
|
+
};
|
|
644
|
+
state.conflicts.push(conflict);
|
|
645
|
+
newConflicts.push(conflict);
|
|
646
|
+
}
|
|
647
|
+
}
|
|
648
|
+
|
|
649
|
+
trimConflicts(state);
|
|
650
|
+
|
|
651
|
+
persistState(state);
|
|
652
|
+
|
|
653
|
+
return newConflicts;
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
/**
|
|
657
|
+
* Maximum semantic conflict checks per turn. Prevents O(N^2) LLM cost when
|
|
658
|
+
* the evidence pool is large. Only the most promising pairs (highest overlap)
|
|
659
|
+
* are checked in each call.
|
|
660
|
+
*/
|
|
661
|
+
const MAX_SEMANTIC_CHECKS_PER_TURN = 10;
|
|
662
|
+
|
|
663
|
+
/**
|
|
664
|
+
* Minimum token overlap for semantic conflict detection. Evidence pairs with
|
|
665
|
+
* overlap below this threshold are considered unrelated and skipped.
|
|
666
|
+
*/
|
|
667
|
+
const SEMANTIC_OVERLAP_MIN = 0.1;
|
|
668
|
+
|
|
669
|
+
/**
|
|
670
|
+
* Maximum token overlap for semantic conflict detection. Pairs above this
|
|
671
|
+
* threshold are already caught by the heuristic detectConflicts().
|
|
672
|
+
*/
|
|
673
|
+
const SEMANTIC_OVERLAP_MAX = 0.3;
|
|
674
|
+
|
|
675
|
+
/** Detect conflicts for a single new evidence entry */
|
|
676
|
+
function detectConflictsFor(ctx: ExtensionContext, evidenceId: string): Conflict[] {
|
|
677
|
+
const state = getState(ctx);
|
|
678
|
+
const newEvidence = state.evidence.find((e) => e.id === evidenceId);
|
|
679
|
+
if (!newEvidence) return [];
|
|
680
|
+
|
|
681
|
+
const newConflicts: Conflict[] = [];
|
|
682
|
+
for (const existing of state.evidence) {
|
|
683
|
+
if (existing.id === evidenceId) continue;
|
|
684
|
+
if (existing.source === newEvidence.source) continue;
|
|
685
|
+
|
|
686
|
+
const overlap = tokenOverlap(newEvidence.normalized, existing.normalized);
|
|
687
|
+
if (overlap < 0.3) continue;
|
|
688
|
+
|
|
689
|
+
const reliabilityDiff = Math.abs(newEvidence.reliability - existing.reliability);
|
|
690
|
+
if (reliabilityDiff < 0.02) continue;
|
|
691
|
+
|
|
692
|
+
const existingConflict = state.conflicts.find(
|
|
693
|
+
(c) =>
|
|
694
|
+
c.for.some((e) => e.id === evidenceId || e.id === existing.id) ||
|
|
695
|
+
c.against.some((e) => e.id === evidenceId || e.id === existing.id),
|
|
696
|
+
);
|
|
697
|
+
if (existingConflict) continue;
|
|
698
|
+
|
|
699
|
+
const forEvidence = newEvidence.reliability > existing.reliability ? [newEvidence] : [existing];
|
|
700
|
+
const againstEvidence =
|
|
701
|
+
newEvidence.reliability > existing.reliability ? [existing] : [newEvidence];
|
|
702
|
+
|
|
703
|
+
const conflict: Conflict = {
|
|
704
|
+
id: nextId("c"),
|
|
705
|
+
claim:
|
|
706
|
+
overlap >= 0.5
|
|
707
|
+
? newEvidence.claim
|
|
708
|
+
: `${newEvidence.claim.slice(0, 40)}... vs ${existing.claim.slice(0, 40)}...`,
|
|
709
|
+
for: forEvidence,
|
|
710
|
+
against: againstEvidence,
|
|
711
|
+
verdict: "unresolved",
|
|
712
|
+
detectedAt: Date.now(),
|
|
713
|
+
classification: classifyConflict(forEvidence, againstEvidence),
|
|
714
|
+
};
|
|
715
|
+
state.conflicts.push(conflict);
|
|
716
|
+
newConflicts.push(conflict);
|
|
717
|
+
}
|
|
718
|
+
|
|
719
|
+
return newConflicts;
|
|
720
|
+
}
|
|
721
|
+
|
|
722
|
+
/**
|
|
723
|
+
* Generate a faithful conflict acknowledgment message for enforcement.
|
|
724
|
+
* XoT Stage 2: Faithful reasoning - surfaces disagreement rather than picking sides.
|
|
725
|
+
*/
|
|
726
|
+
export function formatConflictMessage(conflict: Conflict): string {
|
|
727
|
+
const forSource = conflict.for[0]?.source || "unknown";
|
|
728
|
+
const againstSource = conflict.against[0]?.source || "unknown";
|
|
729
|
+
const forRel = (conflict.for[0]?.reliability ?? 0).toFixed(2);
|
|
730
|
+
const againstRel = (conflict.against[0]?.reliability ?? 0).toFixed(2);
|
|
731
|
+
|
|
732
|
+
return (
|
|
733
|
+
`[conflict:${conflict.classification}] Sources disagree: "${conflict.claim.slice(0, 60)}". ` +
|
|
734
|
+
`${forSource} (rel ${forRel}) vs ${againstSource} (rel ${againstRel}). ` +
|
|
735
|
+
`Consider acknowledging: "Sources disagree on X. Based on Y, I conclude Z."`
|
|
736
|
+
);
|
|
737
|
+
}
|
|
738
|
+
|
|
739
|
+
/**
|
|
740
|
+
* Prune evidence entries that are only referenced by resolved conflicts.
|
|
741
|
+
* Cleans up the evidence pool without losing unresolved or validated data.
|
|
742
|
+
*/
|
|
743
|
+
export function pruneResolvedEvidence(ctx: ExtensionContext): number {
|
|
744
|
+
const state = getState(ctx);
|
|
745
|
+
const unresolvedIds = new Set(
|
|
746
|
+
state.conflicts.filter((c) => c.verdict === "unresolved").map((c) => c.id),
|
|
747
|
+
);
|
|
748
|
+
const activeEvidenceIds = new Set<string>();
|
|
749
|
+
for (const c of state.conflicts) {
|
|
750
|
+
if (unresolvedIds.has(c.id)) {
|
|
751
|
+
for (const e of c.for) activeEvidenceIds.add(e.id);
|
|
752
|
+
for (const e of c.against) activeEvidenceIds.add(e.id);
|
|
753
|
+
}
|
|
754
|
+
}
|
|
755
|
+
// Keep evidence in unresolved conflicts, plus the "for" side of resolved_for conflicts (validated)
|
|
756
|
+
for (const c of state.conflicts) {
|
|
757
|
+
if (c.verdict === "resolved_for") {
|
|
758
|
+
for (const e of c.for) activeEvidenceIds.add(e.id);
|
|
759
|
+
}
|
|
760
|
+
if (c.verdict === "resolved_against") {
|
|
761
|
+
for (const e of c.against) activeEvidenceIds.add(e.id);
|
|
762
|
+
}
|
|
763
|
+
}
|
|
764
|
+
const before = state.evidence.length;
|
|
765
|
+
state.evidence = state.evidence.filter((e) => activeEvidenceIds.has(e.id));
|
|
766
|
+
const removed = before - state.evidence.length;
|
|
767
|
+
persistState(state);
|
|
768
|
+
return removed;
|
|
769
|
+
}
|
|
770
|
+
|
|
771
|
+
/**
|
|
772
|
+
* Clear all evidence and conflicts (for testing or session reset).
|
|
773
|
+
*/
|
|
774
|
+
export function clearEvidence(ctx: ExtensionContext): void {
|
|
775
|
+
const state = getState(ctx);
|
|
776
|
+
state.evidence = [];
|
|
777
|
+
state.conflicts = [];
|
|
778
|
+
persistState(state);
|
|
779
|
+
}
|