pi-braid 0.0.0-stage → 0.40.0
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 +260 -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 +144 -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 +459 -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,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Frontmatter `triggers:` phrases for the suggestion matcher.
|
|
3
|
+
*
|
|
4
|
+
* pi's skill objects carry a fixed shape (name, description, path, source),
|
|
5
|
+
* so curated trigger phrases never reach braid through the prompt-builder
|
|
6
|
+
* cache — read them from the SKILL.md frontmatter directly. Reads are
|
|
7
|
+
* memoized by file mtime + size: repeated turns stat, only changed or
|
|
8
|
+
* first-seen files parse.
|
|
9
|
+
*
|
|
10
|
+
* A trigger hit scores like a name hit and qualifies a skill whose
|
|
11
|
+
* description alone would stay under the qualification bar — the phrase is
|
|
12
|
+
* the author's own signal of when the skill applies, sharper than any
|
|
13
|
+
* description keyword.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import { statSync, readFileSync } from "node:fs";
|
|
17
|
+
import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
|
|
18
|
+
|
|
19
|
+
/** Max trigger phrases read per skill — a longer list is an authoring bug, not a matcher input. */
|
|
20
|
+
export const MAX_TRIGGERS = 12;
|
|
21
|
+
|
|
22
|
+
/** Max characters of one trigger phrase. */
|
|
23
|
+
export const MAX_TRIGGER_CHARS = 64;
|
|
24
|
+
|
|
25
|
+
interface TriggerCacheEntry {
|
|
26
|
+
mtimeMs: number;
|
|
27
|
+
size: number;
|
|
28
|
+
triggers: string[];
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const cache = new Map<string, TriggerCacheEntry>();
|
|
32
|
+
|
|
33
|
+
/** Compiled word-boundary matchers, memoized per normalized phrase. */
|
|
34
|
+
const regexCache = new Map<string, RegExp>();
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Normalize a frontmatter `triggers` value into clean phrases. Accepts a YAML
|
|
38
|
+
* list or a comma-separated string; drops empty, overlong, and surplus
|
|
39
|
+
* entries. Pure.
|
|
40
|
+
*/
|
|
41
|
+
export function normalizeTriggers(value: unknown): string[] {
|
|
42
|
+
const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
|
|
43
|
+
const cleaned: string[] = [];
|
|
44
|
+
for (const item of raw) {
|
|
45
|
+
if (typeof item !== "string") continue;
|
|
46
|
+
const phrase = item.trim().toLowerCase();
|
|
47
|
+
if (!phrase || phrase.length > MAX_TRIGGER_CHARS || cleaned.includes(phrase)) continue;
|
|
48
|
+
cleaned.push(phrase);
|
|
49
|
+
if (cleaned.length >= MAX_TRIGGERS) break;
|
|
50
|
+
}
|
|
51
|
+
return cleaned;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Read a skill's trigger phrases: frontmatter `triggers:` first (canonical),
|
|
56
|
+
* then the description's trailing "Triggers: …" segment — the pack's existing
|
|
57
|
+
* convention (7 of 32 skills carry one) predates the frontmatter field, and
|
|
58
|
+
* the matcher should honor what authors already wrote. Missing/unreadable
|
|
59
|
+
* file or malformed YAML → no triggers (the matcher falls back to
|
|
60
|
+
* name/description scoring alone). Memoized: unchanged files never re-read.
|
|
61
|
+
*/
|
|
62
|
+
export function readSkillTriggers(filePath: string, description?: string): string[] {
|
|
63
|
+
let st;
|
|
64
|
+
try {
|
|
65
|
+
st = statSync(filePath);
|
|
66
|
+
} catch {
|
|
67
|
+
cache.delete(filePath);
|
|
68
|
+
return [];
|
|
69
|
+
}
|
|
70
|
+
const cached = cache.get(filePath);
|
|
71
|
+
if (cached && cached.mtimeMs === st.mtimeMs && cached.size === st.size) return cached.triggers;
|
|
72
|
+
let triggers: string[];
|
|
73
|
+
try {
|
|
74
|
+
const { frontmatter } = parseFrontmatter(readFileSync(filePath, "utf-8"));
|
|
75
|
+
triggers = normalizeTriggers((frontmatter as Record<string, unknown>).triggers);
|
|
76
|
+
} catch {
|
|
77
|
+
triggers = []; // malformed frontmatter — score on name/description only
|
|
78
|
+
}
|
|
79
|
+
if (!triggers.length && description) triggers = parseDescriptionTriggers(description);
|
|
80
|
+
cache.set(filePath, { mtimeMs: st.mtimeMs, size: st.size, triggers });
|
|
81
|
+
return triggers;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Trigger phrases from a description's trailing "Triggers: …" segment —
|
|
86
|
+
* the contrib pack convention ("… Use when X. Triggers: meme, image macro.").
|
|
87
|
+
* Pure.
|
|
88
|
+
*/
|
|
89
|
+
export function parseDescriptionTriggers(description: string): string[] {
|
|
90
|
+
const idx = description.toLowerCase().lastIndexOf("triggers:");
|
|
91
|
+
if (idx < 0) return [];
|
|
92
|
+
const tail = description
|
|
93
|
+
.slice(idx + "triggers:".length)
|
|
94
|
+
.replace(/[.。]*\s*$/, "")
|
|
95
|
+
.trim();
|
|
96
|
+
if (!tail || tail.length > 200) return [];
|
|
97
|
+
return normalizeTriggers(tail);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** Test seam: forget every memoized frontmatter read. */
|
|
101
|
+
export function clearSkillTriggerCache(): void {
|
|
102
|
+
cache.clear();
|
|
103
|
+
regexCache.clear();
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* True when the phrase occurs in the prompt on word boundaries ("pane" does
|
|
108
|
+
* not match "paneled"). Multi-word phrases match literally; hyphenated
|
|
109
|
+
* prompt tokens count as boundaries.
|
|
110
|
+
*/
|
|
111
|
+
export function triggerMatches(phrase: string, promptText: string): boolean {
|
|
112
|
+
let re = regexCache.get(phrase);
|
|
113
|
+
if (!re) {
|
|
114
|
+
const escaped = phrase.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
115
|
+
re = new RegExp(`(?:^|[^a-z0-9])${escaped}(?:$|[^a-z0-9])`);
|
|
116
|
+
regexCache.set(phrase, re);
|
|
117
|
+
}
|
|
118
|
+
return re.test(promptText);
|
|
119
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# src/extensions/enforcement/ - Enforcement Layer
|
|
4
|
+
|
|
5
|
+
The enforcement layer. Translates signals from detectors/heartbeat/agents
|
|
6
|
+
into whispers. Implements the per-turn whisper cap, the dedup logic, and
|
|
7
|
+
the wake-up policy.
|
|
8
|
+
|
|
9
|
+
## Files at this level
|
|
10
|
+
|
|
11
|
+
| File | Purpose |
|
|
12
|
+
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
13
|
+
| `state.ts` | Composed session-scoped state. Re-exports `ENFORCEMENT_PARAMS` and `EnforcementState` from `enforcement-types.ts`. |
|
|
14
|
+
| `enforcement-types.ts` | The shared `ENFORCEMENT_PARAMS` and `EnforcementState` definitions. **Lives outside `state.ts` to break the circular dep** that would otherwise form between `state.ts <-> session-state.ts <-> verification-judge-state.ts`. |
|
|
15
|
+
| `session-state.ts` | Per-turn tracking, config, topic-drift detector. |
|
|
16
|
+
| `whisper.ts` | The `sendTrackedMessage` wrapper with the whisper cap and metadata. |
|
|
17
|
+
| `judge-utils.ts` | Helpers for the verification judge. |
|
|
18
|
+
| `signals.ts` | The signal taxonomy (severity, source, priority). |
|
|
19
|
+
| `validation.ts` | Validation of whisper payloads. |
|
|
20
|
+
| `similarity.ts` | Cosine similarity for dedup. |
|
|
21
|
+
| `nudge-manager.ts` | Manages nudge cooldowns and dedup. |
|
|
22
|
+
| `verification-judge.ts` | The verification judge - runs in background. |
|
|
23
|
+
| `self-state-claims.ts` | Deterministic self-state claim detector for the judge: scans the visible response for liveness/delivery/progress claims, suppresses them when the evidence window shows a probe call (session_health, health_maintenance, v2raytun_status, telegram_send); renders the judge's SELF-STATE CLAIMS section only when candidates survive (prompt byte-unchanged otherwise). |
|
|
24
|
+
| `task-evidence.ts` | Task-wide evidence lines (since last real user message) rebuilt from the pi session store for the judge prompt; survives turn breaks (wake-retry redelivery). Logs over the cap are compacted into LLM chunk summaries (newest chunk raw), with drop-oldest truncation as the fallback. |
|
|
25
|
+
| `verification-judge-state.ts` | Judge/calibration helpers. |
|
|
26
|
+
| `handler-registry.ts` | Thin orchestrator that wires all handlers. |
|
|
27
|
+
| `register-tool-result-formatting.ts` | MI-3 Structured Output Catalyst - wraps read/grep/find/ls outputs in structured header format (opt-in). |
|
|
28
|
+
| `event-types.ts` | Types for events that flow through the enforcement layer. |
|
|
29
|
+
| `*-state.ts` | Sub-state files (tool-tracking, error-tracking, memory-hygiene, context-hygiene, scratchpad, thought-chain). Each owns its slice of the composed state. |
|
|
30
|
+
|
|
31
|
+
## Sub-directories
|
|
32
|
+
|
|
33
|
+
| Path | Purpose |
|
|
34
|
+
| ----------- | --------------------------------------------------------------- |
|
|
35
|
+
| `handlers/` | Event handlers - register-session-_, turn-_, message-_, tool-_. |
|
|
36
|
+
|
|
37
|
+
## State architecture (CRITICAL)
|
|
38
|
+
|
|
39
|
+
The state is **composed from focused sub-state files**, not defined in
|
|
40
|
+
`state.ts` directly. This is to avoid the file getting unwieldy and to
|
|
41
|
+
allow sub-state modules to be tested in isolation.
|
|
42
|
+
|
|
43
|
+
**Import contract:**
|
|
44
|
+
|
|
45
|
+
- `state.ts` imports sub-state factories/resets from sub-state files.
|
|
46
|
+
- Sub-state files do **NOT** import from `state.ts`.
|
|
47
|
+
- `enforcement-types.ts` is the only file imported by both `state.ts` and
|
|
48
|
+
the sub-state files that need `EnforcementState` or `ENFORCEMENT_PARAMS`.
|
|
49
|
+
- No structural test enforces this contract today; it is review-enforced.
|
|
50
|
+
|
|
51
|
+
## Wake-up policy
|
|
52
|
+
|
|
53
|
+
- **Wake (`triggerTurn: true`)**: enforcement-critical, turn-outcome,
|
|
54
|
+
reasoning, metacognition, auto-recovery, analytics-degrade,
|
|
55
|
+
threshold-exhausted, emergency-rotation, navigation-checkout, context-80%+,
|
|
56
|
+
three-memory-reliability, compaction-retry errors.
|
|
57
|
+
- **No wake**: everything else. The delivery class decides how the message
|
|
58
|
+
reaches the run (see the delivery contract in `lib/utils/injection-tracker.ts`):
|
|
59
|
+
`delivery: "live"` steers a streaming run and appends when idle;
|
|
60
|
+
`delivery: "park"` records for the end-of-turn flush. The whisper wrapper
|
|
61
|
+
(`whisper.ts`) defaults to `live`, so analysis handlers
|
|
62
|
+
(BPE/MARS/Dreamer/Drift), verification/conflict nudges, and reasoning
|
|
63
|
+
advisories reach the running loop. Advisories that must not force a
|
|
64
|
+
continuation turn pass `delivery: "park"`: tool-loop, post-compaction
|
|
65
|
+
re-orientation after a natural stop, cycle hygiene, discoverability, and
|
|
66
|
+
API-error guidance. Memory/hint/SOP channels park - they provide context
|
|
67
|
+
for the agent's natural flow.
|
|
68
|
+
|
|
69
|
+
See individual handler files in `handlers/` for the per-source policy.
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Malformed Tool Call Detection
|
|
3
|
+
*
|
|
4
|
+
* Detects when the agent outputs XML-like tool tags as plain text
|
|
5
|
+
* instead of using proper function calling format.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
9
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
10
|
+
import { getNudgeManager } from "../nudge-manager.js";
|
|
11
|
+
import {
|
|
12
|
+
MALFORMED_TOOL_CALL_RE,
|
|
13
|
+
MALFORMED_TOOL_NAME_RE,
|
|
14
|
+
} from "../../../lib/constants/tool-constants.js";
|
|
15
|
+
|
|
16
|
+
export function detectMalformedToolCalls(
|
|
17
|
+
text: string,
|
|
18
|
+
pi: ExtensionAPI,
|
|
19
|
+
ctx: ExtensionContext,
|
|
20
|
+
): void {
|
|
21
|
+
MALFORMED_TOOL_CALL_RE.lastIndex = 0;
|
|
22
|
+
const match = MALFORMED_TOOL_CALL_RE.exec(text);
|
|
23
|
+
MALFORMED_TOOL_CALL_RE.lastIndex = 0;
|
|
24
|
+
|
|
25
|
+
if (match) {
|
|
26
|
+
const toolNameMatch = text.match(MALFORMED_TOOL_NAME_RE);
|
|
27
|
+
const detectedTool = toolNameMatch ? toolNameMatch[1].toLowerCase() : "unknown";
|
|
28
|
+
|
|
29
|
+
// Rate-limit via NudgeManager: the 10s cooldown with no-dedup
|
|
30
|
+
// config is the right shape for a malformed-tool flood: a single
|
|
31
|
+
// malformed call is enough to fire, but repeat fires within 10s are
|
|
32
|
+
// suppressed so the agent isn't hammered while iterating on the fix.
|
|
33
|
+
const message =
|
|
34
|
+
"Malformed tool call detected: <" +
|
|
35
|
+
detectedTool +
|
|
36
|
+
"> as TEXT. Use proper function calling format - do NOT output XML tags as plain text.";
|
|
37
|
+
const { shouldSend } = getNudgeManager(ctx).shouldSendNudge("malformed", message);
|
|
38
|
+
if (shouldSend) {
|
|
39
|
+
sendEnforcementWhisper(pi, ctx, message);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Thorough Work Verification
|
|
3
|
+
*
|
|
4
|
+
* Detects missing verification after code changes.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
8
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
9
|
+
import type { ExtensionContext, ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
10
|
+
|
|
11
|
+
interface VerificationState {
|
|
12
|
+
pendingCodeChanges: boolean;
|
|
13
|
+
lastCodeChangeTurn: number;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
function getVerificationState(ctx?: ExtensionContext): VerificationState {
|
|
17
|
+
if (ctx)
|
|
18
|
+
return getExtensionState(ctx, "enforcement-verification", () => ({
|
|
19
|
+
pendingCodeChanges: false,
|
|
20
|
+
lastCodeChangeTurn: -100,
|
|
21
|
+
}));
|
|
22
|
+
return _default;
|
|
23
|
+
}
|
|
24
|
+
const _default: VerificationState = { pendingCodeChanges: false, lastCodeChangeTurn: -100 };
|
|
25
|
+
export const VERIFICATION_REMINDER_THRESHOLD = 12; // turns
|
|
26
|
+
|
|
27
|
+
export function detectMissingVerification(
|
|
28
|
+
pi: ExtensionAPI,
|
|
29
|
+
ctx: ExtensionContext,
|
|
30
|
+
currentTurn: number,
|
|
31
|
+
): void {
|
|
32
|
+
const s = getVerificationState(ctx);
|
|
33
|
+
const turnsSinceCodeChange = currentTurn - s.lastCodeChangeTurn;
|
|
34
|
+
|
|
35
|
+
// If there were code changes but no bash command within threshold turns, nudge
|
|
36
|
+
if (s.pendingCodeChanges && turnsSinceCodeChange >= VERIFICATION_REMINDER_THRESHOLD) {
|
|
37
|
+
sendEnforcementWhisper(
|
|
38
|
+
pi,
|
|
39
|
+
ctx,
|
|
40
|
+
"You modified code but haven't verified it works. " +
|
|
41
|
+
"Run tests or commands to confirm your implementation is correct.\n\n" +
|
|
42
|
+
"You verify code changes before declaring the task complete.",
|
|
43
|
+
);
|
|
44
|
+
s.pendingCodeChanges = false; // Only remind once per change session
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export function recordCodeChange(turn: number, ctx?: ExtensionContext): void {
|
|
49
|
+
const s = getVerificationState(ctx);
|
|
50
|
+
s.lastCodeChangeTurn = turn;
|
|
51
|
+
s.pendingCodeChanges = true;
|
|
52
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement types - shared interfaces and constants.
|
|
3
|
+
*
|
|
4
|
+
* This file exists to break the circular dependency between
|
|
5
|
+
* state.ts <-> session-state.ts (via ENFORCEMENT_PARAMS) and
|
|
6
|
+
* state.ts <-> verification-judge-state.ts (via EnforcementState).
|
|
7
|
+
*
|
|
8
|
+
* Both sub-state files can import from here without creating cycles.
|
|
9
|
+
*
|
|
10
|
+
* Contents:
|
|
11
|
+
* - ENFORCEMENT_PARAMS: the tunable thresholds config
|
|
12
|
+
* - EnforcementState: the composed interface (intersection of sub-states)
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import type { ToolTrackingState } from "./substate/tool-tracking-state.js";
|
|
16
|
+
import type { ErrorTrackingState } from "./substate/error-tracking-state.js";
|
|
17
|
+
import type { SessionState } from "./substate/session-state.js";
|
|
18
|
+
import type { MemoryHygieneState } from "./substate/memory-hygiene-state.js";
|
|
19
|
+
import type { ScratchpadState, ContextHygieneState } from "./substate/context-hygiene-state.js";
|
|
20
|
+
import type { ThoughtChainState } from "./substate/thought-chain-state.js";
|
|
21
|
+
|
|
22
|
+
export const ENFORCEMENT_PARAMS = {
|
|
23
|
+
memoryNudgeThreshold: 15,
|
|
24
|
+
maxSilentTurns: 6,
|
|
25
|
+
warnOnToolSequenceRepetition: 3,
|
|
26
|
+
judgeCooldownMs: 20000,
|
|
27
|
+
judgeSkipTurns: 1,
|
|
28
|
+
verificationJudgeInterval: 15,
|
|
29
|
+
maxClaimsBeforeVerification: 5,
|
|
30
|
+
blockExploreBeforeWrite: true,
|
|
31
|
+
} as const;
|
|
32
|
+
|
|
33
|
+
/** Full enforcement state - intersection of all sub-states. */
|
|
34
|
+
export interface EnforcementState
|
|
35
|
+
extends
|
|
36
|
+
ToolTrackingState,
|
|
37
|
+
ErrorTrackingState,
|
|
38
|
+
SessionState,
|
|
39
|
+
MemoryHygieneState,
|
|
40
|
+
ScratchpadState,
|
|
41
|
+
ContextHygieneState,
|
|
42
|
+
ThoughtChainState {}
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Handler Registry - thin coordinator.
|
|
3
|
+
*
|
|
4
|
+
* Imports and registers each focused handler. Each handler lives in its own
|
|
5
|
+
* file under handlers/ for independent testing.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
9
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
10
|
+
import { guard } from "../../lib/utils/error-guard.js";
|
|
11
|
+
import { registerInjectionTracker } from "../../lib/utils/injection-tracker.js";
|
|
12
|
+
import { registerWakeGate } from "../../lib/utils/wake-gate.js";
|
|
13
|
+
import { registerTurnEndHandler, dispatchTurnEnd } from "../../lib/events/turn-end-coordinator.js";
|
|
14
|
+
import { onEvent } from "../../lib/events/event-types.js";
|
|
15
|
+
import { sendEnforcementWhisper } from "./whisper.js";
|
|
16
|
+
import { processAgentResponse, formatContradictionWhisper } from "../../lib/store/claim-tracker.js";
|
|
17
|
+
import {
|
|
18
|
+
loadSpecs,
|
|
19
|
+
checkSpecCoverage,
|
|
20
|
+
getVerifierState,
|
|
21
|
+
} from "../../lib/store/bidirectional-verifier.js";
|
|
22
|
+
import { ingestArchives } from "../../lib/events/consolidation-channel.js";
|
|
23
|
+
import { isDegraded } from "../../lib/detection/degradation-detector.js";
|
|
24
|
+
import { autoRollback } from "../../lib/state/state-checkpoint.js";
|
|
25
|
+
import { getState } from "./state.js";
|
|
26
|
+
import { registerInputHandler } from "./handlers/register-input-handler.js";
|
|
27
|
+
import { registerSessionStart } from "./handlers/register-session-start.js";
|
|
28
|
+
import { registerToolCallHandler } from "./handlers/register-tool-call.js";
|
|
29
|
+
import { registerMessageEndHandler } from "./handlers/register-message-end.js";
|
|
30
|
+
import { registerToolResultHandler } from "./handlers/register-tool-result.js";
|
|
31
|
+
import { registerToolResultFormatting } from "./handlers/register-tool-result-formatting.js";
|
|
32
|
+
import { registerSessionCompactHandler } from "./handlers/register-session-compact.js";
|
|
33
|
+
import { registerAgentEndApiErrorHandler } from "./handlers/register-agent-end-api-error.js";
|
|
34
|
+
import { registerSessionShutdownHandler } from "./handlers/register-session-shutdown.js";
|
|
35
|
+
import { registerSessionShutdownResumption } from "./handlers/register-session-shutdown-resumption.js";
|
|
36
|
+
import { registerSessionStartDiscoverability } from "./handlers/register-session-start-discoverability.js";
|
|
37
|
+
import { registerAdherenceMeter } from "./handlers/register-adherence-meter.js";
|
|
38
|
+
import { registerTurnEndHygiene } from "./handlers/register-turn-end-hygiene.js";
|
|
39
|
+
import { registerPostCycleHygiene } from "./handlers/register-post-cycle-hygiene.js";
|
|
40
|
+
import { driftHandler } from "./handlers/analysis/drift-handler.js";
|
|
41
|
+
import { bpeHandler } from "./handlers/analysis/bpe-handler.js";
|
|
42
|
+
import { marsHandler } from "./handlers/analysis/mars-handler.js";
|
|
43
|
+
import { dreamerHandler } from "./handlers/analysis/dreamer-handler.js";
|
|
44
|
+
import { feedbackHandler } from "./handlers/analysis/feedback-handler.js";
|
|
45
|
+
import { reflectionHandler } from "./handlers/analysis/reflection-handler.js";
|
|
46
|
+
import { dispatchTurnEndLoop } from "./handlers/turn-end-handler.js";
|
|
47
|
+
import { beginTurn } from "../../lib/enforcement/turn-dedup.js";
|
|
48
|
+
import { INPUT, TURN_END } from "../../lib/core/event-names.js";
|
|
49
|
+
|
|
50
|
+
const log = createLogger("enforcement");
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Register all enforcement event handlers on the given pi instance.
|
|
54
|
+
*/
|
|
55
|
+
export function registerHandlers(pi: ExtensionAPI): void {
|
|
56
|
+
registerInjectionTracker(pi as Parameters<typeof registerInjectionTracker>[0]);
|
|
57
|
+
// The wake gate tracks the run-region (pre-flight tail +
|
|
58
|
+
// compaction) so triggerTurn wakes are delivered as queued steers instead
|
|
59
|
+
// of starting a competing agent run at the compaction boundary.
|
|
60
|
+
registerWakeGate(pi as Parameters<typeof registerWakeGate>[0]);
|
|
61
|
+
|
|
62
|
+
registerInputHandler(pi);
|
|
63
|
+
registerSessionStart(pi);
|
|
64
|
+
registerSessionStartDiscoverability(pi);
|
|
65
|
+
// Owner-facing adherence meter: per-rule repeat/suppression counters, a
|
|
66
|
+
// session-end report, and a bounded owner escalation. Never agent-facing.
|
|
67
|
+
registerAdherenceMeter(pi);
|
|
68
|
+
registerToolCallHandler(pi);
|
|
69
|
+
|
|
70
|
+
// Clear the turn-scoped whisper dedup registry at the start of each
|
|
71
|
+
// new user turn. Any pending claims from the previous turn are dropped
|
|
72
|
+
// so each turn gets a fresh dedup budget.
|
|
73
|
+
onEvent(pi, INPUT, () => {
|
|
74
|
+
beginTurn();
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
// Clear the natural-stop flag at the start of each assistant
|
|
78
|
+
// turn. dispatchTurnEndLoop sets it at turn_end (natural stop = assistant
|
|
79
|
+
// + stopReason "stop" + no tool calls); a new turn means the agent is
|
|
80
|
+
// working again, so a stale true from a previously-completed natural stop
|
|
81
|
+
// must not downgrade a genuine mid-work compaction resume into advisory.
|
|
82
|
+
onEvent(pi, "turn_start", (_event: any, ctx: ExtensionContext) => {
|
|
83
|
+
try {
|
|
84
|
+
getState(ctx).lastTurnWasNaturalStop = false;
|
|
85
|
+
} catch {
|
|
86
|
+
// enforcement state unavailable on this ctx — non-fatal
|
|
87
|
+
}
|
|
88
|
+
});
|
|
89
|
+
registerMessageEndHandler(pi);
|
|
90
|
+
registerToolResultFormatting(pi);
|
|
91
|
+
registerToolResultHandler(pi);
|
|
92
|
+
registerCompactAndSessionHandlers(pi);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function registerCompactAndSessionHandlers(pi: ExtensionAPI): void {
|
|
96
|
+
registerSessionCompactHandler(pi);
|
|
97
|
+
registerAgentEndApiErrorHandler(pi);
|
|
98
|
+
registerSessionShutdownHandler(pi);
|
|
99
|
+
registerSessionShutdownResumption(pi);
|
|
100
|
+
|
|
101
|
+
// turn_end: individual analysis handlers (split from dispatch-turn-end-analysis)
|
|
102
|
+
registerTurnEndHandler("enforcement-drift", 100, async (event, ctx) => {
|
|
103
|
+
await driftHandler(pi, event, ctx);
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
// turn_end: degradation->checkpoint rollback (before analysis handlers)
|
|
107
|
+
// heartbeatCheckpointTick runs every ~60s; this catches degradation between beats.
|
|
108
|
+
// Test-debug guard: autoRollback may return suppressed (test-runner-
|
|
109
|
+
// dominated burst) — downgrade to whisper-only: advice stays, the
|
|
110
|
+
// destructive conversation rewind is withheld.
|
|
111
|
+
registerTurnEndHandler("degradation-rollback", 99, async (_event, ctx) => {
|
|
112
|
+
if (!getState(ctx).enforcementActive) return;
|
|
113
|
+
if (!isDegraded(ctx)) return;
|
|
114
|
+
const sessionId = ctx.cwd ?? String(process.pid);
|
|
115
|
+
const result = await autoRollback(ctx, sessionId);
|
|
116
|
+
if (result.restored) {
|
|
117
|
+
log.warn(`Turn-end degradation rollback: ${result.note}`);
|
|
118
|
+
} else if (result.suppressed) {
|
|
119
|
+
log.warn(`Turn-end degradation rollback withheld: ${result.note}`);
|
|
120
|
+
sendEnforcementWhisper(
|
|
121
|
+
pi,
|
|
122
|
+
ctx,
|
|
123
|
+
`[auto-rollback withheld] Degradation detected but the recent error burst is ` +
|
|
124
|
+
`test-runner dominated (failing tests are expected in TDD/gate triage). Continuing. ` +
|
|
125
|
+
`If this is NOT an intentional test loop, run health_maintenance(action="check").`,
|
|
126
|
+
);
|
|
127
|
+
}
|
|
128
|
+
});
|
|
129
|
+
|
|
130
|
+
registerTurnEndHandler("enforcement-bpe", 95, async (event, ctx) => {
|
|
131
|
+
await bpeHandler(pi, event, ctx);
|
|
132
|
+
});
|
|
133
|
+
registerTurnEndHandler("enforcement-mars", 85, async (event, ctx) => {
|
|
134
|
+
await marsHandler(pi, event, ctx);
|
|
135
|
+
});
|
|
136
|
+
registerTurnEndHandler("enforcement-dreamer", 80, async (event, ctx) => {
|
|
137
|
+
await dreamerHandler(pi, event, ctx);
|
|
138
|
+
});
|
|
139
|
+
registerTurnEndHandler("enforcement-feedback", 60, async (event, ctx) => {
|
|
140
|
+
await feedbackHandler(pi, event, ctx);
|
|
141
|
+
});
|
|
142
|
+
registerTurnEndHandler("enforcement-reflection", 50, async (event, ctx) => {
|
|
143
|
+
await reflectionHandler(pi, event, ctx);
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
// turn_end: main enforcement loop
|
|
147
|
+
registerTurnEndHandler("enforcement-loop", 90, async (event, ctx) => {
|
|
148
|
+
await dispatchTurnEndLoop(pi, event, ctx);
|
|
149
|
+
});
|
|
150
|
+
|
|
151
|
+
// turn_end: claim tracker - cross-turn contradiction detection
|
|
152
|
+
registerTurnEndHandler("claim-tracker", 70, async (event, ctx) => {
|
|
153
|
+
if (!getState(ctx).enforcementActive) return;
|
|
154
|
+
const isBurst = getState(ctx).consecutiveErrorTurns >= 3;
|
|
155
|
+
if (isBurst || event.message?.role !== "assistant" || !event.message?.content) return;
|
|
156
|
+
|
|
157
|
+
const msgText = Array.isArray(event.message.content)
|
|
158
|
+
? event.message.content
|
|
159
|
+
.filter((c: any) => c?.type === "text")
|
|
160
|
+
.map((c: any) => c?.text || "")
|
|
161
|
+
.join(" ")
|
|
162
|
+
: typeof event.message.content === "string"
|
|
163
|
+
? event.message.content
|
|
164
|
+
: "";
|
|
165
|
+
|
|
166
|
+
if (msgText.length <= 50) return;
|
|
167
|
+
await guard(
|
|
168
|
+
"claim-tracker",
|
|
169
|
+
async () => {
|
|
170
|
+
const contradictions = await processAgentResponse(msgText, ctx, getState(ctx).currentTurn);
|
|
171
|
+
if (contradictions.length > 0) {
|
|
172
|
+
sendEnforcementWhisper(pi, ctx, formatContradictionWhisper(contradictions));
|
|
173
|
+
}
|
|
174
|
+
},
|
|
175
|
+
log,
|
|
176
|
+
);
|
|
177
|
+
});
|
|
178
|
+
|
|
179
|
+
// turn_end: spec verification - checks edited files against specs
|
|
180
|
+
registerTurnEndHandler("spec-verification", 30, async (_event, ctx) => {
|
|
181
|
+
if (!getState(ctx).enforcementActive) return;
|
|
182
|
+
await guard(
|
|
183
|
+
"spec-verification",
|
|
184
|
+
async () => {
|
|
185
|
+
const specs = await loadSpecs(ctx);
|
|
186
|
+
if (specs.length === 0) return;
|
|
187
|
+
const state = getVerifierState(ctx);
|
|
188
|
+
const editedFiles = [...state.editedFiles];
|
|
189
|
+
if (editedFiles.length === 0) return;
|
|
190
|
+
const results = checkSpecCoverage(editedFiles, specs);
|
|
191
|
+
const violations = results.filter((r) => !r.covered);
|
|
192
|
+
if (violations.length > 0) {
|
|
193
|
+
const msg = `[spec] ${violations.length} spec requirement(s) affected by recent edits:\n${violations.map((v) => ` - ${v.strength}: ${v.requirement}`).join("\n")}`;
|
|
194
|
+
sendEnforcementWhisper(pi, ctx, msg);
|
|
195
|
+
}
|
|
196
|
+
},
|
|
197
|
+
log,
|
|
198
|
+
);
|
|
199
|
+
});
|
|
200
|
+
|
|
201
|
+
// turn_end: archive ingestion
|
|
202
|
+
registerTurnEndHandler("archive-ingestion", 10, async (_event, ctx) => {
|
|
203
|
+
await guard(
|
|
204
|
+
"archive-ingestion",
|
|
205
|
+
async () => {
|
|
206
|
+
const ingested = await ingestArchives(ctx.cwd);
|
|
207
|
+
if (ingested > 0) {
|
|
208
|
+
log.info(`[archive-ingestion] Ingested ${ingested} archive(s) into consolidation queue`);
|
|
209
|
+
}
|
|
210
|
+
},
|
|
211
|
+
log,
|
|
212
|
+
);
|
|
213
|
+
});
|
|
214
|
+
|
|
215
|
+
// turn_end: context hygiene + discoverability (lowest priority)
|
|
216
|
+
registerTurnEndHygiene(pi);
|
|
217
|
+
|
|
218
|
+
// turn_end: post-cycle hygiene (dead last — runs only on text-only yields)
|
|
219
|
+
registerPostCycleHygiene(pi);
|
|
220
|
+
|
|
221
|
+
// turn_end: coordinator dispatch
|
|
222
|
+
onEvent(pi, TURN_END, async (event: any, ctx: any) => {
|
|
223
|
+
await dispatchTurnEnd(event, ctx);
|
|
224
|
+
});
|
|
225
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# src/extensions/enforcement/handlers/ - Event Wiring + Analysis Pipeline
|
|
4
|
+
|
|
5
|
+
The enforcement extension is the largest in pi-braid. Its `handlers/`
|
|
6
|
+
directory contains 16+ files with TWO distinct concerns:
|
|
7
|
+
|
|
8
|
+
1. **Framework event wiring** - files named `register-*.ts` that
|
|
9
|
+
subscribe to pi core events (`registerTool`, `pi.on(...)`, etc.)
|
|
10
|
+
2. **Analysis pipeline** - files in `analysis/` subdir that run as
|
|
11
|
+
part of the per-turn analysis phase
|
|
12
|
+
|
|
13
|
+
## What "handlers" means here
|
|
14
|
+
|
|
15
|
+
In this directory, "handlers" = "anything that handles an event or runs
|
|
16
|
+
in a pipeline." It's the broadest use of the term in the codebase.
|
|
17
|
+
|
|
18
|
+
## Categories of files here
|
|
19
|
+
|
|
20
|
+
### Framework event wiring (`register-*.ts`)
|
|
21
|
+
|
|
22
|
+
These are the entry points for enforcement. They register with pi core
|
|
23
|
+
and delegate to the actual enforcement logic.
|
|
24
|
+
|
|
25
|
+
| File | Event |
|
|
26
|
+
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
27
|
+
| `register-session-start.ts` | `session_start` |
|
|
28
|
+
| `register-session-start-discoverability.ts` | `session_start` (Background phase, via `registerSessionStartHandler`) - surfaces disk-backed prior state (scratchpad, memory, sessions, resume file, tags) before the first turn. Per-signal dedup with per-project disk persistence. |
|
|
29
|
+
| `register-session-compact.ts` | `session_compact` |
|
|
30
|
+
| `register-session-shutdown.ts` | `session_shutdown` |
|
|
31
|
+
| `register-session-shutdown-resumption.ts` | (read by discoverability handler) - resume file creation on shutdown. |
|
|
32
|
+
| `register-input-handler.ts` | `input` |
|
|
33
|
+
| `register-message-end.ts` | `message_end` |
|
|
34
|
+
| `register-tool-call.ts` | `tool_call` |
|
|
35
|
+
| `register-tool-result.ts` | `tool_execution_end` |
|
|
36
|
+
| `register-agent-end-api-error.ts` | `agent_end` (classifies a terminal assistant API error into guidance) |
|
|
37
|
+
| `register-post-cycle-hygiene.ts` | `turn_end` (priority 1 - auto-tag + inspect + advise on text-only yield after work) |
|
|
38
|
+
| `register-adherence-meter.ts` | `session_start` (Background - counts `enforcement_violation` events per session), `turn_end` (priority 40 - escalates a rule repeating past K to the owner, bounded), `session_shutdown` (writes the owner report). Owner-facing only: never sends a tracked message and never registers a tool. |
|
|
39
|
+
|
|
40
|
+
### Orchestrators (not `register-*`, but invoked at turn end)
|
|
41
|
+
|
|
42
|
+
| File | Purpose |
|
|
43
|
+
| --------------------- | ----------------------------------------------------------- |
|
|
44
|
+
| `turn-end-handler.ts` | Main turn-end orchestrator. 376L. |
|
|
45
|
+
| `routing-handler.ts` | Routes turn-end events to specific analysis handlers. 215L. |
|
|
46
|
+
| `turn-analysis.ts` | Turn-level analysis logic. 141L. |
|
|
47
|
+
| `message-analysis.ts` | Message-level analysis. 99L. |
|
|
48
|
+
|
|
49
|
+
### Other utilities
|
|
50
|
+
|
|
51
|
+
| File | Purpose |
|
|
52
|
+
| ------------------ | -------------------------------------- |
|
|
53
|
+
| `tool-tracker.ts` | Per-tool-call tracking. 137L. |
|
|
54
|
+
| `orphan-chains.ts` | Detects orphan tool call chains. 59L. |
|
|
55
|
+
| `blocking.ts` | Tool call blocking logic. 79L. |
|
|
56
|
+
| `probe-handler.ts` | Lightweight probe for LLM calls. 158L. |
|
|
57
|
+
|
|
58
|
+
### Analysis pipeline
|
|
59
|
+
|
|
60
|
+
See `./analysis/AGENTS.md` for the 6 analysis handlers
|
|
61
|
+
(bpe, dreamer, drift, feedback, mars, reflection).
|
|
62
|
+
|
|
63
|
+
## Why so mixed?
|
|
64
|
+
|
|
65
|
+
Historical: enforcement grew organically as new concerns were added.
|
|
66
|
+
A future refactor could split into `framework/`, `orchestrators/`,
|
|
67
|
+
`utilities/`, and `analysis/` (the last is already separated). For now,
|
|
68
|
+
the `register-*` prefix is the easiest way to spot framework wiring.
|