pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
# Compaction Message-Loss Investigation
|
|
2
|
+
|
|
3
|
+
<!-- status: historical -->
|
|
4
|
+
<!-- Restored from orphaned history. Retained as the audit record for the compaction fixes that
|
|
5
|
+
followed: batch-settle scheduling, honest archive/slide/deep_clean feedback, loss counters.
|
|
6
|
+
Body describes the pre-fix state at investigation time. -->
|
|
7
|
+
|
|
8
|
+
## Verdict (tl;dr)
|
|
9
|
+
|
|
10
|
+
**The risk is real, but so is the design intent.** The owner's caution is correct: not everything flagged
|
|
11
|
+
below is a bug. Git history and the pi-core event surface show at least two behaviors were deliberate:
|
|
12
|
+
|
|
13
|
+
- **Range-as-metadata was intentional** ("archive now actually frees space" was the deliberate
|
|
14
|
+
change): the
|
|
15
|
+
`context_compression` entry was always audit/report data; pi-core's independent budget cut is the
|
|
16
|
+
real removal engine. The _actual_ defect is the **misleading tool feedback** (claims a specific range
|
|
17
|
+
was removed when it was not), not the existence of the metadata entry.
|
|
18
|
+
- **Mid-turn deferred compaction was intentional**: the tool must return its result to the agent before
|
|
19
|
+
`ctx.compact()` aborts the turn. The defect is the **race with a still-executing parallel batch**
|
|
20
|
+
(`setTimeout(0)` vs in-flight sibling tools) - and the tool has the hooks
|
|
21
|
+
(`tool_execution_start`/`tool_execution_end`/`agent_settled`) to schedule at a safe boundary instead.
|
|
22
|
+
|
|
23
|
+
Corrected classification (**B = broken, I = intentional, Mixed = broken but intent-aware fix**):
|
|
24
|
+
|
|
25
|
+
1. **Mid-turn abort discards in-flight batch results (Mixed).** Real loss window, but the fix must
|
|
26
|
+
preserve the intended `return-result-then-compact` contract - schedule compaction at batch-settle
|
|
27
|
+
via tool-execution events, not by refusing mid-turn calls.
|
|
28
|
+
2. **Declared range/summary never honored (Mixed).** The metadata entry is intentional; the
|
|
29
|
+
**feedback is dishonest** (reports "Compressed N messages into summary X [range]" for a removal it
|
|
30
|
+
does not perform). Fix = either honor the range through `session_before_compact` consumption or
|
|
31
|
+
make the feedback describe reality.
|
|
32
|
+
3. **Manual + auto compaction lack mutual exclusion (B).** Separate abort controllers is pi-core's
|
|
33
|
+
design split; the gap is braid lacks serialization between the two entry points - only the
|
|
34
|
+
`session_before_compact` _handler_ is deduped, not the two compaction flows.
|
|
35
|
+
|
|
36
|
+
The tool description warns "never in a parallel batch (it aborts the turn)" - advisory only, no guard.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Mechanism 1: Mid-turn abort discards in-flight messages (CONFIRMED, root cause)
|
|
41
|
+
|
|
42
|
+
### Chain
|
|
43
|
+
|
|
44
|
+
- `context_compress` schedules its compaction asynchronously: every action path ends with
|
|
45
|
+
`setTimeout(() => ctx.compact(...), 0)` - `context-compress.ts:250, 490, 573, 753`.
|
|
46
|
+
- `setTimeout(0)` means: the tool's `execute()` **returns its result first**, then pi-core
|
|
47
|
+
`compact()` runs on a later tick - while the agent turn is still in progress.
|
|
48
|
+
- `compact()` immediately does `_disconnectFromAgent(); await this.abort();` -
|
|
49
|
+
`pi-coding-agent/dist/core/agent-session.js:1368-1369`.
|
|
50
|
+
- `abort()` = `agent.abort()` + `waitForIdle()` (`agent-session.js:1165-1170`).
|
|
51
|
+
- Agent events stop flowing through the session (`_disconnectFromAgent` unsubscribes;
|
|
52
|
+
persistence happens in `_handleAgentEvent` on `message_end`, `agent-session.js:355-378`).
|
|
53
|
+
- **Consequence:** any agent output produced between the `context_compress` call and the
|
|
54
|
+
compaction's `abort()` - an in-flight assistant message, or **tool results from the same
|
|
55
|
+
parallel batch** - is terminated before its `message_end` is persisted. It exists neither in
|
|
56
|
+
the session file nor in the rebuilt context.
|
|
57
|
+
|
|
58
|
+
### Evidence it is a known, real behavior
|
|
59
|
+
|
|
60
|
+
- `extensions/memory/AGENTS.md:21-22` - braid's own documentation:
|
|
61
|
+
> "`ctx.compact()` aborts the current turn via `_disconnectFromAgent()` + `abort()`, which
|
|
62
|
+
> discards any pending tool results from the same parallel batch."
|
|
63
|
+
- The tool description warns: "never in a parallel batch (it aborts the turn)"
|
|
64
|
+
(`context-compress.ts:155`).
|
|
65
|
+
- **But nothing enforces it.** Grep of enforcement handlers found no guard that refuses
|
|
66
|
+
`context_compress` mid-turn or in a parallel batch; `tool-tracker.ts` only _tracks_ the call.
|
|
67
|
+
The dedup guard (`markCompactProcessed`, `compaction.ts`) prevents double-processing of
|
|
68
|
+
`session_before_compact` - it does **not** prevent the turn abort.
|
|
69
|
+
|
|
70
|
+
### Why the owner saw it
|
|
71
|
+
|
|
72
|
+
The accidental turn-stop + "messages between compress tool calls" pattern this round: when an
|
|
73
|
+
agent calls `context_compress` and continues (or had queued parallel tools), the deferred
|
|
74
|
+
compaction aborts the turn, discarding whatever was in flight. The observed symptom is messages
|
|
75
|
+
that "should have been there" are gone after compaction.
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Mechanism 2: Declared range/summary is never honored (CONFIRMED)
|
|
80
|
+
|
|
81
|
+
### Chain
|
|
82
|
+
|
|
83
|
+
- The archive action computes `startIndex/endIndex` from `analyzeSession(ctx).branchLength`
|
|
84
|
+
**at tool-call time** (`context-compress.ts:291`), then `sm.appendCustomEntry("context_compression", {...})`
|
|
85
|
+
with the user's `topic`+`summary` (`context-compress.ts:436`), then schedules a plain
|
|
86
|
+
`ctx.compact({})` (`:490-499`).
|
|
87
|
+
- The custom entry is **write-only**. Grep across `packages/core/src` finds `context_compression`
|
|
88
|
+
in exactly one place - the two `appendCustomEntry` calls. **Nothing reads it.**
|
|
89
|
+
- Pi-core's `compact()` independently re-snapshots `getBranch()` at compaction time
|
|
90
|
+
(`agent-session.js:1377`), recomputes the cut via `prepareCompaction` (token-budget from the
|
|
91
|
+
**last real `type: "compaction"` entry boundary**, not the custom entry), and generates its own
|
|
92
|
+
LLM summary. `previousSummary` is seeded only from `type === "compaction"` entries
|
|
93
|
+
(`compaction.js → prepareCompaction`).
|
|
94
|
+
|
|
95
|
+
### Consequence
|
|
96
|
+
|
|
97
|
+
- The tool's feedback ("Compressed N messages into summary X [startIndex..endIndex]", with
|
|
98
|
+
estimated freed tokens) describes **nothing that actually happens**. Actual removal is pi-core's
|
|
99
|
+
independent `keepRecentTokens`-budget cut from the last real compaction boundary.
|
|
100
|
+
- The user-supplied archive summary is **dropped** - it never reaches the compaction summarizer,
|
|
101
|
+
never appears in context.
|
|
102
|
+
- If the branch grew between tool-call time and the deferred compaction, the reported range is
|
|
103
|
+
stale on arrival. This is the second, quieter way "messages get thrown away": the intended
|
|
104
|
+
archive boundary is silently ignored in favor of a different (budget) boundary.
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## Mechanism 3: Manual + auto compaction have no mutual exclusion (CONFIRMED overlap)
|
|
109
|
+
|
|
110
|
+
### Chain
|
|
111
|
+
|
|
112
|
+
- Two independent entry points both snapshot the branch and `appendCompaction`:
|
|
113
|
+
- Manual: `compact()` - `agent-session.js:1367`
|
|
114
|
+
- Auto: `_runAutoCompaction()` (threshold/overflow, fires from `_checkCompaction` at agent_end) - `agent-session.js:1591`
|
|
115
|
+
- Separate abort controllers: `_compactionAbortController` (manual) vs `_autoCompactionAbortController`
|
|
116
|
+
(auto). Neither aborts the other (`agent-session.js:1488-1495`).
|
|
117
|
+
- Braid's `markCompactProcessed(sessionId, leafId)` dedup guard stops a _second_ `session_before_compact`
|
|
118
|
+
on the same leaf (`compaction.ts`) - but it returns from the **handler**, not from pi-core's
|
|
119
|
+
compaction. The skipped flow means the second compaction appends **without** braid's pre-filter /
|
|
120
|
+
slide-mode / instruction safeguards, and both compactions can still append entries for the same region.
|
|
121
|
+
|
|
122
|
+
### Consequence
|
|
123
|
+
|
|
124
|
+
- If manual `setTimeout`-deferred compaction overlaps an auto-compaction (e.g., agent calls
|
|
125
|
+
`context_compress` then ends its turn → `_checkCompaction` fires while the deferred manual
|
|
126
|
+
compact is pending), two compactions run concurrently on the same branch, produce two summaries,
|
|
127
|
+
and both overwrite `agent.state.messages` (last writer wins). Not a confirmed message _drop_, but
|
|
128
|
+
a confirmed overlap hazard with duplicated LLM cost and potential summary confusion.
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## What is NOT lost (verified, to bound the claim)
|
|
133
|
+
|
|
134
|
+
- **Session file entries are not deleted.** Compaction appends a `compaction` entry with
|
|
135
|
+
`firstKeptEntryId`; `buildSessionContext` simply stops rendering older entries
|
|
136
|
+
(`session-manager.js:193-228`). The "removed" messages still exist in the `.jsonl` file - they are
|
|
137
|
+
removed from _context_, not from disk.
|
|
138
|
+
- The pre-append intercept (`compaction.ts` "queued message during compaction" fix) handles the
|
|
139
|
+
specific case of a **user TUI message typed during compaction** - that path is guarded.
|
|
140
|
+
|
|
141
|
+
So the honest framing: compaction loses messages from **agent-visible context** (and can discard
|
|
142
|
+
in-flight turn output entirely via the abort), not from the session file. For an agent, loss from
|
|
143
|
+
context is loss.
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Fix recommendation (scoped, intent-aware, awaiting owner approval)
|
|
148
|
+
|
|
149
|
+
Design principle (owner): fully understand how it is now done and how it should properly be made -
|
|
150
|
+
preserve the intentional contract, fix only the genuinely broken parts.
|
|
151
|
+
|
|
152
|
+
1. **Schedule compaction at batch-settle, not `setTimeout(0)` (P0, Mixed→fix).** After the tool returns,
|
|
153
|
+
instead of firing `ctx.compact()` on a raw macrotask that can land mid-parallel-batch, delay it until
|
|
154
|
+
the in-flight tool batch settles. The tool has `tool_execution_start`/`tool_execution_end` events and
|
|
155
|
+
`agent_settled` in reach - a one-shot "compact after current batch settles" avoids discarding sibling
|
|
156
|
+
tool results while keeping the intended mid-turn auto-resume. (Alternative, simpler P0: detect "other
|
|
157
|
+
tools in this batch still executing" and refuse with an advisory - but that breaks the legitimate
|
|
158
|
+
mid-turn use the design intends, so batch-settle scheduling is preferred.)
|
|
159
|
+
2. **Make `archive` feedback honest (P1, Mixed→fix).** Either (a) resolve the declared range + user
|
|
160
|
+
summary and feed them into the compaction via a `session_before_compact` consumption path so the
|
|
161
|
+
declared boundary is actually honored, or (b) drop the per-range claims from the tool feedback and
|
|
162
|
+
report only what pi-core will do ("will compact from last compaction boundary; estimate only").
|
|
163
|
+
Option (a) restores the tool's stated contract; option (b) is the smaller honest fix.
|
|
164
|
+
3. **Serialize manual vs auto compaction (P1, B→fix).** In braid's `session_before_compact`, when a
|
|
165
|
+
manual compaction is already scheduled/in-flight, defer or skip a concurrent auto-compaction so the
|
|
166
|
+
two never overlap the same region.
|
|
167
|
+
4. **Loss telemetry (P2).** Record in-flight-aborted counts in the compaction outcome so silent loss
|
|
168
|
+
becomes visible via heartbeat analytics.
|
|
169
|
+
|
|
170
|
+
Scope: `handlers/tools/context-compress.ts` + `handlers/compaction.ts` (+ a `session_before_compact`
|
|
171
|
+
consumption path if option 2a). Tests: batch-settle scheduling (sibling tool result preserved),
|
|
172
|
+
archive-range interop or honest-feedback, overlap serialization. Gates: tsc 0, `npm test` baseline +
|
|
173
|
+
new tests, docs, drift, deps. Not started - held pending owner approval of 2a vs 2b and the
|
|
174
|
+
batch-settle approach.
|
|
175
|
+
|
|
176
|
+
_Sources: `extensions/memory/context-manager/handlers/tools/context-compress.ts`,
|
|
177
|
+
`handlers/compaction.ts`, `extensions/memory/AGENTS.md:19-22`,
|
|
178
|
+
`@earendil-works/pi-coding-agent/dist/core/agent-session.js:1367-1481, 1591-1727`,
|
|
179
|
+
`.../session-manager.js:193-228, 802-880`, `.../compaction/compaction.js`._
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# Context Map: Contexts, Owners, Seams, and Where State Lives
|
|
4
|
+
|
|
5
|
+
How the tree divides into contexts, what each one owns, how they talk to each
|
|
6
|
+
other, and where state is allowed to live. Read it before deciding where a
|
|
7
|
+
change belongs or which side of a boundary a fact may cross.
|
|
8
|
+
|
|
9
|
+
A context here is a domain with its own vocabulary and its own invariants,
|
|
10
|
+
separated by a boundary that costs something to cross: a package boundary, a
|
|
11
|
+
CI-enforced import rule, or a sync-by-hand seam. The map is not a directory
|
|
12
|
+
listing - one context can span several directories, and a directory can host
|
|
13
|
+
more than one. Window and band numbers are the other half of the picture and
|
|
14
|
+
live in [CONTEXT-POLICY.md](CONTEXT-POLICY.md).
|
|
15
|
+
|
|
16
|
+
## Contexts and owners
|
|
17
|
+
|
|
18
|
+
| # | Context | Owns | Code seat | Must never learn |
|
|
19
|
+
| --- | ----------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
20
|
+
| 1 | Session runtime and turn pipeline | turn lifecycle, whisper delivery and capping, session health state machine | `src/extensions/enforcement/`, `src/lib/events/`, `src/lib/utils/injection-tracker.ts`, `src/lib/state/` (`src/extensions/enforcement/session-health.ts:8`) | provider status codes and error categories as vocabulary: the gate it publishes carries only "may a turn start" and "a turn ended cleanly" (`src/lib/state/global-state.ts:514-516`) |
|
|
21
|
+
| 2 | Context window management | window budget, bands, offload, compaction ladder | `src/lib/detection/context-thresholds.ts:17`, `src/extensions/memory/context-manager/`, `src/extensions/memory/context-lifecycle/` | which failure caused the pressure: the offload it publishes takes a short reason label and returns counts, not a classification (`src/lib/state/global-state.ts:538-558`) |
|
|
22
|
+
| 3 | Agent memory | episodes, heuristics, tool reliability, semantic store, session recall, scratchpad, snapshots | `src/extensions/memory/three-memory-stores/index.ts:1`, `src/extensions/memory/session-recall/`, `src/extensions/memory/scratchpad/persistence.ts:41` | branch identity: its stores are project-scoped and outlive any one session branch (`src/extensions/memory/scratchpad/persistence.ts:41-52`) |
|
|
23
|
+
| 4 | Verification stores | evidence pool, claim tracker, belief store, conflict QA | `src/lib/store/evidence-pool.ts:108`, `src/lib/store/claim-tracker.ts`, `src/lib/store/belief-store.ts`, `src/lib/store/conflict-qa.ts` | worker liveness and gate outcomes: gate evidence is the orchestrator registry's record (`src/lib/orchestrator/workers.ts:49`); these stores hold claims about the world (`src/lib/store/evidence-pool.ts:108`) |
|
|
24
|
+
| 5 | Multi-agent orchestration | worker registry, locks, branches, merge verification, result contract | `src/lib/orchestrator/workers.ts:11`, `src/extensions/orchestrator/` | provider and key-ring mechanics: gates are persisted as a command plus an exit code (`src/lib/orchestrator/workers.ts:49`) over git and a per-project registry file (`src/lib/orchestrator/workers.ts:11`) |
|
|
25
|
+
| 6 | Provider routing and key rings | keys, rings, routes, route walk, death and probe state | `packages/providers/` (`packages/providers/ring-lifecycle.ts:88`) | braid session and health policy: the package's only peer dependencies are pi-ai and pi-coding-agent (`packages/providers/package.json:37-40`), and its one core-facing shape is the feedback handler interface (`src/lib/state/global-state.ts:329`) |
|
|
26
|
+
| 7 | Telegram channel | inbound poller, owner messages, decisions, voice, notify | `packages/telegram/` (`packages/telegram/src/index.ts:29`) | braid's context and prompt internals: it advertises what it knows through slots (`src/lib/state/telegram-poller-liveness.ts:41`) and conforms to pi-core session semantics (`packages/telegram/src/index.ts:29`) |
|
|
27
|
+
| 8 | Prompt composition and guidance | identity blocks, sections, tool guidelines, skills loading, surface discipline | `src/extensions/core/prompt-builder/`, `src/extensions/core/skills-tool/` | unguarded live domain state: rendering goes through guarded accessors and probes, and a missing probe reads "unknown" (`src/extensions/core/prompt-builder/index.ts:493`) |
|
|
28
|
+
| 9 | Cognition and probing | think/verify tools, MARS, topic drift, sycophancy, turn outcome | `src/extensions/cognitive/` (`src/extensions/cognitive/metacognition/handlers/verify.ts:101`) | its own copy of history: it reads the branch it is given (`src/extensions/cognitive/metacognition/handlers/verify.ts:101`) instead of keeping a parallel timeline |
|
|
29
|
+
| 10 | Self-management and recovery | watchdog, auto-recovery, health maintenance, error tracking | `src/extensions/self/` (`src/extensions/self/watchdog/index.ts:175`) | timer internals: dead wake delivery crosses as ids and counts through the feed (`src/lib/state/global-state.ts:471-476`) |
|
|
30
|
+
| 11 | Scheduling | timers, wakes, wake retry | `src/extensions/scheduling/timer/` (`src/extensions/scheduling/timer/index.ts:326`) | provider status codes and error categories: the turn gate answers one yes/no question, and a missing gate never blocks (`src/extensions/scheduling/timer/index.ts:326-328`; `src/lib/state/global-state.ts:512`) |
|
|
31
|
+
| 12 | Heartbeat and background work | consolidation, analytics, drift detection | `src/extensions/heartbeat/` (`src/extensions/heartbeat/heartbeat-scheduler/index.ts:985`) | context-manager internals: it calls the published offload runner as a mechanism and treats an absent runner as "cannot shrink" (`src/lib/state/global-state.ts:564-566`) |
|
|
32
|
+
| 13 | Verification harness and governance | failure traces, weakness mining, gates, the AGENTS.md tree, placement/labels/doc checks | `src/lib/harness/`, `src/lib/verification/`, `scripts/check-deps.mjs:53` | runtime state: the gates walk source paths (`scripts/check-deps.mjs:102-104`) and own no process state |
|
|
33
|
+
|
|
34
|
+
## Relationship types
|
|
35
|
+
|
|
36
|
+
The code expresses five boundary relations, not one.
|
|
37
|
+
|
|
38
|
+
- **Separate ways, seam-mediated (packages).** `providers`, `telegram`, and
|
|
39
|
+
`contrib` do not import core except through the published surface and the
|
|
40
|
+
process-global seams. Core exports exactly two entries, `.` and `./lib`
|
|
41
|
+
(`packages/core/package.json:8-11`); `src/lib/public.ts:2` names
|
|
42
|
+
pi-braid-contrib as the primary consumer and stays backed by canonical
|
|
43
|
+
modules, with no duplicate copy.
|
|
44
|
+
- **Shared kernel (inside core).** `lib/core`, `lib/types`, `lib/state`,
|
|
45
|
+
`lib/events`, `lib/utils` are imported everywhere; extensions may import
|
|
46
|
+
`lib/`, and `lib/` must not import `extensions/` (`src/AGENTS.md:21`).
|
|
47
|
+
`scripts/check-deps.mjs:102-104` encodes the same rule as layers.
|
|
48
|
+
- **Allowlisted customer/supplier pairs.** 18 cross-extension pairs are
|
|
49
|
+
sanctioned by name in `scripts/check-deps.mjs:53`. The allowlist names a
|
|
50
|
+
caller pair, not the function used, so a new import inside a listed pair
|
|
51
|
+
passes on membership alone (`check-deps.mjs:290`).
|
|
52
|
+
- **Conformist (to pi-core).** Braid mirrors pi's retry semantics on purpose
|
|
53
|
+
(`packages/providers/ring-lifecycle.ts:88`) and depends on documented
|
|
54
|
+
pi-core internals in the telegram package
|
|
55
|
+
(`packages/telegram/src/index.ts:29`).
|
|
56
|
+
- **Governance over all.** The check scripts enforce rules across contexts
|
|
57
|
+
from outside: dependency layers, placement wording, labels, doc status
|
|
58
|
+
(`package.json` `ci:check`).
|
|
59
|
+
|
|
60
|
+
## Seam registry
|
|
61
|
+
|
|
62
|
+
A seam here is a process-global slot whose writer and reader sit in different
|
|
63
|
+
contexts. The slot carries a small mechanism-only shape, never a domain
|
|
64
|
+
vocabulary, and every consumer defines what absence means; none throws. Ten
|
|
65
|
+
slots meet this definition: five cross a package boundary, one crosses the
|
|
66
|
+
source and dist module instances of the same file, and four stay inside core
|
|
67
|
+
across extension boundaries. The event bus and the published `lib` surface are
|
|
68
|
+
boundary mechanisms too (`src/lib/events/event-bus.ts:1`, `src/lib/public.ts:2`), but
|
|
69
|
+
they have no slot-level absence contract and are covered under relationship
|
|
70
|
+
types instead.
|
|
71
|
+
|
|
72
|
+
| Seam | Crosses | What crosses | Absent policy |
|
|
73
|
+
| ------------------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
74
|
+
| `KEY_RING_FEEDBACK_KEY` (`src/lib/state/global-state.ts:314`) | providers -> core | a structural handler: `reportFailure(modelId, providerId, errText)` and `reportSuccess(modelId, providerId)` (`global-state.ts:323-324`); published at extension load (`packages/providers/ring-lifecycle.ts:2657`, called from `packages/providers/index.ts:429`) | no handler: every read is optional, a silent no-op (`src/lib/ai/llm-call.ts:771-772`); a direct call's 429/403 simply feeds no ring |
|
|
75
|
+
| `WATCHDOG_TUNNEL_KEY` (`src/lib/state/global-state.ts:360`) | telegram -> core | a hub: `status`, `failures`, `lastError`, `publish`, `subscribe` (`global-state.ts:376-381`); publisher `packages/telegram/src/lib/watchdog-tunnel.ts:26`, relayed from the poller at `packages/telegram/src/index.ts:471` | status reads "unknown" until telegram publishes, and subscribers see no transition (`global-state.ts:386`, `src/extensions/self/watchdog/index.ts:200-204`) |
|
|
76
|
+
| `WATCHDOG_TG_SIGNAL_KEY` (`src/lib/state/global-state.ts:439`) | telegram -> core | a best-effort one-line plain-text sender, returning a boolean or a promise of one (`global-state.ts:442`); writer `packages/telegram/src/index.ts:703` | absent: the optional escalation ping is a silent no-op (`global-state.ts:445`; consumer `src/extensions/self/watchdog/index.ts:209`) |
|
|
77
|
+
| `WATCHDOG_WAKE_DELIVERY_FEED_KEY` (`global-state.ts:468`) | watchdog -> scheduling | three fact sinks taking ids and counts: `recordWakeOutcomeTimeout`, `recordWakeUndelivered`, `recordWakeDelivered` (`global-state.ts:471-476`); publisher `src/extensions/self/watchdog/index.ts:257-261` | absent slot: every forward is a no-op (`global-state.ts:467`; the timer uses optional calls, `src/extensions/scheduling/timer/index.ts:1096`) |
|
|
78
|
+
| `TURN_START_GATE_KEY` (`src/lib/state/global-state.ts:517`) | enforcement -> scheduling | `isBlocked(ctx, threshold)` and `noteCleanTurn(ctx)`; the shape deliberately carries no provider, status code, or error category (`global-state.ts:514-516`); publisher `src/extensions/enforcement/handlers/register-session-start.ts:77` | absent: never blocked, a wake must fail open (`global-state.ts:512`; consumers `src/extensions/scheduling/timer/index.ts:326-328` and `wake-retry.ts:135-140`) |
|
|
79
|
+
| `CONTEXT_EMERGENCY_OFFLOAD_RUNNER_KEY` (`global-state.ts:535`) | context-manager -> lib/ai, heartbeat | `runner(ctx, reason)` returning counts and an optional error, never a failure classification (`global-state.ts:538-558`); publisher `src/extensions/memory/context-manager/handlers/context-emergency.ts:452` | null: callers treat it as "cannot shrink" and take their normal failure path (`global-state.ts:564-566`; `src/lib/ai/llm-call.ts:752`) |
|
|
80
|
+
| `TELEGRAM_POLLER_LIVENESS_KEY` (`src/lib/state/telegram-poller-liveness.ts:38`) | telegram -> prompt-builder | a live probe returning a boolean, not a start/stop flag; writer `packages/telegram/src/index.ts:535-536` | a missing or throwing probe reads "unknown"; consumers hedge and never assert reachability (`telegram-poller-liveness.ts:29-31`, `:59-61`; consumer `src/extensions/core/prompt-builder/index.ts:493`) |
|
|
81
|
+
| `PROVIDER_OUTAGE_NOTIFY_KEY` (`packages/providers/outage-watch.ts:90`) | telegram -> providers | a one-line sender returning a boolean or a promise of one (`outage-watch.ts:93`); writer `packages/telegram/src/index.ts:721` | absent is not an error: the transition still logs and its text reports the missing channel (`outage-watch.ts:87-89`; reader `outage-watch.ts:474`) |
|
|
82
|
+
| `EXTENSION_CTX_PROVIDER_KEY` (`src/lib/state/global-state.ts:588`) | enforcement -> lib/ai | a getter for the current session context (`global-state.ts:596`); publisher `src/extensions/enforcement/handlers/register-session-start.ts:131` | absent: auxiliary calls fall back to the compat transport and the degradation is announced once per process (`src/lib/ai/llm-call.ts:149-163`, `llm-call.ts:752`) |
|
|
83
|
+
| `CUSTOM_MODEL_KEYS_KEY` (`src/lib/state/global-state.ts:26`) | polyfill -> model-resolver, across source and dist | a Map of role key to one model pattern or an ordered list (`global-state.ts:28-33`); writer `src/extensions/core/polyfill/index.ts:397`; reader `src/lib/ai/model-resolver.ts:74` | key unset: the resolver falls through to its next priority (`global-state.ts:23`) |
|
|
84
|
+
|
|
85
|
+
Each seam has one home and one mirrored literal. The mirror sites carry the
|
|
86
|
+
same string plus a keep-in-sync comment on both sides, for example
|
|
87
|
+
`src/lib/state/global-state.ts:314` against
|
|
88
|
+
`packages/providers/ring-lifecycle.ts:2649`, and
|
|
89
|
+
`src/lib/state/global-state.ts:439` against
|
|
90
|
+
`packages/telegram/src/index.ts:222`. No package can import the other, so the
|
|
91
|
+
comment is the contract: a rename on one side silently turns the seam into its
|
|
92
|
+
absent case.
|
|
93
|
+
|
|
94
|
+
## Where state lives
|
|
95
|
+
|
|
96
|
+
The storage rule has three homes. Pick the home by the state's lifetime, not
|
|
97
|
+
by the tool that produced it.
|
|
98
|
+
|
|
99
|
+
1. **Branch-sensitive or session-scoped state goes into pi session entries.**
|
|
100
|
+
Write it once with `pi.appendEntry` and reconstruct it from
|
|
101
|
+
`sessionManager.getBranch()` at `session_start`. Example: context-lifecycle
|
|
102
|
+
snapshots are appended under their custom type
|
|
103
|
+
(`src/extensions/memory/context-lifecycle/index.ts:324`) and read back by
|
|
104
|
+
walking the branch (`context-lifecycle/index.ts:971`). Counter-example: the
|
|
105
|
+
worker registry is cross-session by nature, so it lives in a per-project
|
|
106
|
+
file under braid home (`src/lib/orchestrator/workers.ts:11`) - a successor
|
|
107
|
+
session must read it after the writing session is gone.
|
|
108
|
+
2. **Wall-clock or cross-session state goes into braid's own store, with the
|
|
109
|
+
reason recorded.** Example: timer wake-retry records carry a `sessionId`
|
|
110
|
+
because a fire outlives the turn that armed it
|
|
111
|
+
(`src/extensions/scheduling/timer/wake-retry.ts:195`), and a foreign record
|
|
112
|
+
is pruned only when two independent signals agree, since its owner may
|
|
113
|
+
still be coming back (`src/extensions/scheduling/timer/recovery.ts:17`).
|
|
114
|
+
Counter-example: task evidence is a view over the branch and is rebuilt on
|
|
115
|
+
demand (`src/extensions/enforcement/task-evidence.ts:138`); storing it
|
|
116
|
+
would go stale against the branch it describes.
|
|
117
|
+
3. **Tool state that follows the active branch goes into tool-result
|
|
118
|
+
details.** Example: the checkout action of `context_navigate` returns
|
|
119
|
+
details that bind the navigation to the branch it just created
|
|
120
|
+
(`src/extensions/memory/context-manager/handlers/tools/context-navigate.ts:369-374`).
|
|
121
|
+
Counter-example: the scratchpad persists under a project slug in braid home
|
|
122
|
+
(`src/extensions/memory/scratchpad/persistence.ts:41-52`) because it must
|
|
123
|
+
survive session end and serve the next session; a tool result would die
|
|
124
|
+
with the branch.
|
|
125
|
+
|
|
126
|
+
The rule fails in two familiar ways: a side file that mirrors branch state
|
|
127
|
+
forks silently on checkout, and branch state parked in a store keyed by
|
|
128
|
+
wall-clock survives a rollback that should have removed it.
|
|
129
|
+
|
|
130
|
+
## The durable-fact event law
|
|
131
|
+
|
|
132
|
+
Events are carriers; aggregates are records. Three rules decide where a new
|
|
133
|
+
fact goes.
|
|
134
|
+
|
|
135
|
+
1. **Transient channels carry hooks and intents.** pi's lifecycle hooks
|
|
136
|
+
(`session_start`, `turn_end`, `message_end`:
|
|
137
|
+
`src/lib/core/event-names.ts:11-22`) and braid's in-process bus
|
|
138
|
+
(`src/lib/events/event-bus.ts:96-106`) hand a notification to the handlers
|
|
139
|
+
registered at that moment. Neither keeps it: the bus holds handler sets in
|
|
140
|
+
Maps (`event-bus.ts:113`), and an emitted event is gone when `emit` returns
|
|
141
|
+
(`event-bus.ts:145`). A handler may write state, but the event is never the
|
|
142
|
+
record of it.
|
|
143
|
+
2. **A durable transition is a timestamped past-tense field on the aggregate
|
|
144
|
+
that owns the state.** The writer stamps the time, the store that owns the
|
|
145
|
+
aggregate persists the field, and a later reader asks the aggregate instead
|
|
146
|
+
of replaying events.
|
|
147
|
+
3. **A whisper is a notification, not an event.** `sendEnforcementWhisper`
|
|
148
|
+
delivers a message through `sendTrackedMessage`
|
|
149
|
+
(`src/extensions/enforcement/whisper.ts:119`), whose durable trace is the
|
|
150
|
+
`braid_injection` session entry the tracker appends
|
|
151
|
+
(`src/lib/utils/injection-tracker.ts:281`): a log of what entered the
|
|
152
|
+
context, not a state field. Only a critical whisper reaches the bus, as an
|
|
153
|
+
`enforcement_violation` notification (`whisper.ts:83-85`), and that emission
|
|
154
|
+
records nothing.
|
|
155
|
+
|
|
156
|
+
Durability is relative to the store that owns the aggregate: the worker
|
|
157
|
+
registry, the lock table, and the key-ring file outlive the session that wrote
|
|
158
|
+
them; session-health state outlives the turn. The demand is the same in each
|
|
159
|
+
case - a later reader gets the fact from the aggregate, without the event that
|
|
160
|
+
produced it.
|
|
161
|
+
|
|
162
|
+
| Field | Aggregate / registry | path:line | Written by | Why durable |
|
|
163
|
+
| ------------------------ | --------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
164
|
+
| `spawnedAt` | worker entry, `workers.json` | `src/lib/orchestrator/workers.ts:90` (decl), `:630` (write) | `registerWorker` | admission time is the left end of the spawn-to-result latency the fleet reports (`workers.ts:1166`) |
|
|
165
|
+
| `resultAt` | worker entry | `workers.ts:92` (decl), `:703` and `:736` (writes) | `recordWorkerMerge`, `closeWorker` | a successor session computes latency from the row after the writer is gone (`workers.ts:1166-1168`) |
|
|
166
|
+
| `mergedAt` | worker entry | `workers.ts:96` (decl), `:701` (write) | `recordWorkerMerge` | the merge mark is verdict evidence, and the row outlives the merged branch (`workers.ts:1029`) |
|
|
167
|
+
| `closedAt` | worker entry | `workers.ts:97` (decl), `:734` (write) | `closeWorker` | terminal state: a closed row is no obstacle to admission (`workers.ts:539`) and is hidden from `list-workers` unless asked (`src/extensions/orchestrator/index.ts:883`) |
|
|
168
|
+
| `admissionRefusals[].at` | worker entry | `workers.ts:60` (decl), `:567` (write) | `appendAdmissionRefusal`, from `registerWorker` (`:612`) and `recordAdmissionRefusal` (`:579`) | the refusal count is registry fact rather than inference, and a refusal changes no lifecycle field (`workers.ts:571-575`) |
|
|
169
|
+
| `gates[].at` | worker entry, gate row | `workers.ts:52` (decl), `:739` (write) | `closeWorker` | gate evidence is the registry's own record of the close (`workers.ts:737-740`) |
|
|
170
|
+
| `checkpoint.at` | worker entry | `workers.ts:76` (decl), `:652` (write) | `stampCheckpoint`, from `updateWorker` (`:672`) | the registry stamps the resume point, so a writer cannot backdate it (`workers.ts:63-66`) |
|
|
171
|
+
| `acquiredAt` | lock row, `locks.json` | `src/lib/orchestrator/locks.ts:22` (decl), `:92` (write) | `acquireLock` | the row is the claim another process checks; release deletes it (`locks.ts:106`) |
|
|
172
|
+
| `exhaustedAt` | key entry, persisted ring state | `packages/providers/key-ring.ts:134` (decl), `:400` (write) | `exhaustActiveKey` | decided in one process, read back by others: backoff expiry (`key-ring.ts:351`) and the merge guard (`:477`) compare it; serialized at `:860`, restored at `:798` |
|
|
173
|
+
| `modeEnteredAt` | session-health state, per-session | `src/extensions/enforcement/session-health.ts:47` (decl), `:156` (write) | `recordLlmError` (`:175-194`), `clearToHealthy` (`:232`), `setSessionHealthMode` (`:244`) | the mode's age is recovery evidence the health tool reports (`src/extensions/self/health-maintenance/handlers/session-health-tool.ts:64-65`) |
|
|
174
|
+
|
|
175
|
+
The table covers the state aggregates this map already names; it is not a
|
|
176
|
+
census of every `*At` field in the tree, because append-only records (memory
|
|
177
|
+
entries, scratchpad rows, session records) carry their own creation stamps
|
|
178
|
+
rather than transition fields.
|
|
179
|
+
|
|
180
|
+
Two encodings are in use, and a new field takes the one its store already
|
|
181
|
+
uses: ISO strings on the worker registry (`workers.ts:630`), epoch
|
|
182
|
+
milliseconds on the lock table and the key-ring file (`locks.ts:92`,
|
|
183
|
+
`key-ring.ts:400`).
|
|
184
|
+
|
|
185
|
+
Not every timestamp is a transition. `lastSeenAt` (`workers.ts:91`) is a
|
|
186
|
+
freshness cursor any handle write refreshes (`workers.ts:673`), and `savedAt`
|
|
187
|
+
(`key-ring.ts:713`) is a persistence cursor; neither marks a transition, and
|
|
188
|
+
neither substitutes for one.
|
|
189
|
+
|
|
190
|
+
Adding state: name the aggregate and its store first. If a later reader must
|
|
191
|
+
be able to ask when, the transition lands as a past-tense field stamped by the
|
|
192
|
+
writer; if only handlers in this process need the fact, an event is enough and
|
|
193
|
+
nothing is persisted.
|
|
194
|
+
|
|
195
|
+
## Recorded divergences
|
|
196
|
+
|
|
197
|
+
- **Worker spec vocabulary.** The `orchestrate` tool description advertises
|
|
198
|
+
five spec values (`src/extensions/orchestrator/index.ts:560`), while the
|
|
199
|
+
registry validates no spec at all - its result-schema check covers status
|
|
200
|
+
only (`src/lib/orchestrator/workers.ts:251`). The paired result validator in
|
|
201
|
+
the orchestrator home accepts a fifth value. Recorded here, not repaired.
|
|
202
|
+
- **Bus vocabulary vs. emitters.** The event union advertises `timer_fire`
|
|
203
|
+
(`src/lib/events/event-bus.ts:25`), but no production module emits it: the
|
|
204
|
+
timer's emit was removed as dead code and the wake path is direct
|
|
205
|
+
(`src/extensions/scheduling/timer/index.ts:371-373`, restated at
|
|
206
|
+
`event-bus.ts:8-17`). The type survives as a test fixture
|
|
207
|
+
(`test/runtime/lib/test-event-bus.mjs:24`). A reader of the law above should
|
|
208
|
+
not infer a bus path for timer fires. Recorded here, not repaired.
|
|
209
|
+
|
|
210
|
+
## Limits
|
|
211
|
+
|
|
212
|
+
- The absence policies above are read from consumer code at this revision; if
|
|
213
|
+
a consumer changes its absent handling, this table drifts, and review is the
|
|
214
|
+
gate for that, not a script.
|
|
215
|
+
- The durable-fact inventory lists the state aggregates this map names; a
|
|
216
|
+
store added later is checked against the law by review, not by a script.
|
|
217
|
+
- Only process-global slots are registered here. Ordinary imports between
|
|
218
|
+
contexts are governed by `scripts/check-deps.mjs`, not listed per import.
|
|
219
|
+
- Domain-language drift (one word for several concepts) is out of scope; it
|
|
220
|
+
belongs to the naming and placement checks.
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# Context Policy: Window, Reserve, Bands, Caps, Archiving
|
|
4
|
+
|
|
5
|
+
The numbers that decide when braid nudges, offloads, archives, or lets pi-core
|
|
6
|
+
compact. Each has one owner (a constant or a setting); this page names it.
|
|
7
|
+
|
|
8
|
+
## The window
|
|
9
|
+
|
|
10
|
+
`braid.context.contextLimitTokens` is the window every braid surface computes with:
|
|
11
|
+
usage math, density, fallbacks, pi-core's threshold compaction and overflow
|
|
12
|
+
detection, the TUI footer. It is a ceiling over the provider window: the
|
|
13
|
+
polyfill plumb hook reports `min(contextLimitTokens, true model window)` to the
|
|
14
|
+
session model on session start (startup, resume, fork, `/reload`) and re-applies
|
|
15
|
+
it at `before_agent_start`, so a mid-session model switch is re-plumbed and a cap
|
|
16
|
+
above a model's true size never widens it; only an unknown true window takes the
|
|
17
|
+
cap alone. Unset, the provider catalog's true size stands.
|
|
18
|
+
|
|
19
|
+
## Usage bands
|
|
20
|
+
|
|
21
|
+
| Band | Fires at | Effect |
|
|
22
|
+
| -------------- | -------- | ------------------------------------------------------ |
|
|
23
|
+
| soft, advisory | 30%, 50% | inspect and start tracking; light pruning, archive |
|
|
24
|
+
| warning | 65% | tag → checkout → archive pipeline |
|
|
25
|
+
| critical | 75% | immediate hygiene, high priority |
|
|
26
|
+
| compact 80/90 | 80%, 90% | auto-compaction, medium then aggressive aggressiveness |
|
|
27
|
+
|
|
28
|
+
Alongside the percent ladder, a token ladder arms at fixed shares of the resolved
|
|
29
|
+
window: 0.18W soft, 0.30W advisory, 0.45W warning, act min(0.60W, 130k), 0.85W
|
|
30
|
+
escalate, 0.90W backstop; a fired-threshold set clears below 50%. The act is the
|
|
31
|
+
one arm with an absolute ceiling, so it stops rising with a window raise; percent
|
|
32
|
+
arms fire late on large windows, which is why both ladders exist. `CONTEXT_COMPACT_REFUSE_PERCENT`
|
|
33
|
+
(70%) is a hard ceiling for LLM-supervised compaction, not a trigger: above it
|
|
34
|
+
`context_compress(action="compact")` refuses and redirects to deterministic slide
|
|
35
|
+
mode, guarding against max-call-stack crashes and session corruption at high
|
|
36
|
+
usage; hygiene acts re-arm at most once every three turns.
|
|
37
|
+
|
|
38
|
+
Owner: [`src/lib/detection/context-thresholds.ts`](../src/lib/detection/context-thresholds.ts)
|
|
39
|
+
(single home; consumers import, never restate).
|
|
40
|
+
|
|
41
|
+
## The compaction reserve
|
|
42
|
+
|
|
43
|
+
pi-core fires native threshold compaction when `contextTokens > contextWindow −
|
|
44
|
+
compaction.reserveTokens`: raw counts, never percents, default reserve 16384.
|
|
45
|
+
Untouched, that fixed count re-anchors the trigger to an arbitrary share of a
|
|
46
|
+
plumbed window. Braid derives the reserve instead - `window − 75% of window` on
|
|
47
|
+
the same ceiling window the plumb wrote or kept, floored at 16384, the floor
|
|
48
|
+
doubling as the budget for the post-compaction summary request pi-core caps at
|
|
49
|
+
80% of it. The value cannot be written into pi-core from an extension (no
|
|
50
|
+
writable settings handle; `pi.getSettings()` returns a copy), so the derivation
|
|
51
|
+
surfaces as a once-per-process warning (`applyCompactionReserveTokens`) naming
|
|
52
|
+
the value to set; nothing is saved to `settings.json`, and it is
|
|
53
|
+
recomputed on every run start: it is a derived invariant of the window, not an
|
|
54
|
+
owner setting; a hand-set reserve whose trigger lands outside the 65%..80% band
|
|
55
|
+
logs an incoherence warning once per process. Owner:
|
|
56
|
+
[`src/lib/config/braid-settings.ts`](../src/lib/config/braid-settings.ts), applied
|
|
57
|
+
from [`src/extensions/core/polyfill/index.ts`](../src/extensions/core/polyfill/index.ts).
|
|
58
|
+
|
|
59
|
+
## Caps and offload
|
|
60
|
+
|
|
61
|
+
| Setting | Default | Effect |
|
|
62
|
+
| --------------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------- |
|
|
63
|
+
| `braid.context.toolResultSizeCap` | ON, 262144 chars | capture-time cap: an oversized tool result is flushed to disk and replaced by a stub naming the file |
|
|
64
|
+
| `braid.context.staleToolResultOffload` | OFF | age/size offload of stale large results (minChars 4000, stalenessTurns 40, keepRecentTurns 20, 65536/run) |
|
|
65
|
+
| `braid.context.contextEmergencyOffload` | ON | on a context-window (413) error: offload the largest results, retry once (minChars 262144, 1048576/run) |
|
|
66
|
+
|
|
67
|
+
Offloaded payloads land at `<braid home>/offload/<sessionId>/<toolName>-<toolCallId>.txt`
|
|
68
|
+
(`offloadDir()` / `getOffloadFilePath` in
|
|
69
|
+
[`src/lib/config/braid-paths.ts`](../src/lib/config/braid-paths.ts)); the stub names
|
|
70
|
+
the path, so retrieval is a plain `read` and the flush is lossless.
|
|
71
|
+
|
|
72
|
+
## Archiving and compaction tools
|
|
73
|
+
|
|
74
|
+
| Tool | Use |
|
|
75
|
+
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
76
|
+
| `context_inspect` | health/usage audit before acting (`quick`, `detailed`, `full`, `prune`) |
|
|
77
|
+
| `context_compress` | `compact` (drop obsolete/duplicate entries), `archive` (range → topic summary, tag-based bounds), `deep_clean` (tag + archive + compact), `slide` (deterministic, no LLM) |
|
|
78
|
+
| `context_navigate` | `tag` before archiving, `log` history, `checkout` to a leaf |
|
|
79
|
+
| `context_proposals` | list, approve, or reject auto-generated proposals |
|
|
80
|
+
|
|
81
|
+
`context-lifecycle` automates the same tools: on `turn_end` it detects approaching
|
|
82
|
+
limits, evaluates a proposal through its policy engine (token budget, cooldown,
|
|
83
|
+
cost-benefit), and either injects a `propose` entry or auto-executes; same-type
|
|
84
|
+
proposals are debounced for five turns. Owner:
|
|
85
|
+
[`src/extensions/memory/context-lifecycle/AGENTS.md`](../src/extensions/memory/context-lifecycle/AGENTS.md);
|
|
86
|
+
what compaction loses: [`COMPACTION-LOSS-INVESTIGATION.md`](COMPACTION-LOSS-INVESTIGATION.md) (historical).
|
package/docs/HISTORY.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
<!-- status: historical -->
|
|
2
|
+
|
|
3
|
+
# pi-braid History
|
|
4
|
+
|
|
5
|
+
How pi-braid came to be, for visitors who want the story rather than the
|
|
6
|
+
release notes. Release-level detail lives in the
|
|
7
|
+
[changelog](../../../CHANGELOG.md); what's next is in [ROADMAP.md](ROADMAP.md);
|
|
8
|
+
first-time setup is in [SETUP.md](SETUP.md).
|
|
9
|
+
|
|
10
|
+
> A note on granularity: the public git history is a single consolidated commit,
|
|
11
|
+
> and the changelog's "Repository history" section records what it condensed.
|
|
12
|
+
> Milestones before the 2026-08-29 monorepo snapshot are summarized here from
|
|
13
|
+
> the project's own records - dated, but without per-commit references.
|
|
14
|
+
|
|
15
|
+
## The idea
|
|
16
|
+
|
|
17
|
+
pi is a coding agent with a base loop and a small built-in toolset.
|
|
18
|
+
pi-braid is a layer over it with one premise: an agent that can see and
|
|
19
|
+
manage its own cognition is more reliable than one that can't. Everything in
|
|
20
|
+
the repo serves that premise - enforcement of behavior policies, memory that
|
|
21
|
+
survives sessions, structured reasoning before hard decisions, verification
|
|
22
|
+
after edits, and background services that notice degradation before the user
|
|
23
|
+
does.
|
|
24
|
+
|
|
25
|
+
## Foundations (April – May 2026)
|
|
26
|
+
|
|
27
|
+
The repo was carved out of the earlier pi-mono/pi-braid lineage in mid-April
|
|
28
|
+
2026 and immediately went for capability with zero external dependencies: a
|
|
29
|
+
native `web_fetch` and CDP-driven browser automation (April 15), later joined
|
|
30
|
+
by a typed event bus for cross-extension signals, proactive context
|
|
31
|
+
projection, and analytics events.
|
|
32
|
+
|
|
33
|
+
May produced the three-memory-stores design - episodes (what
|
|
34
|
+
happened), semantic facts, and procedural heuristics - with deep merge,
|
|
35
|
+
cross-search, and project-scoped isolation. Memory with provenance is what
|
|
36
|
+
lets the rest of the suite reason about its own past without leaking one
|
|
37
|
+
project's context into another.
|
|
38
|
+
|
|
39
|
+
## Prompt architecture (June – August 2026)
|
|
40
|
+
|
|
41
|
+
The prompt-builder went through several rewrites, each shrinking token count
|
|
42
|
+
while increasing specificity. It was decomposed into composable
|
|
43
|
+
`PromptSection` fragments with pointer blocks (June 2026), a behavior-modes
|
|
44
|
+
system was dropped in favor of static identity invariants (July), and a
|
|
45
|
+
research pass - comparing four prompt generations - concluded that identity
|
|
46
|
+
framing beats explicit directives, and that descoped, anti-sycophancy framing
|
|
47
|
+
outperforms compliance theater. Later additions: a discovery stance, guarded
|
|
48
|
+
tool-usage pipelines, a once-per-session awareness whisper, per-tool
|
|
49
|
+
instruction ownership (a tool's owning package speaks for it), and a
|
|
50
|
+
time-awareness layer that renders every braid-facing timestamp in the owner's
|
|
51
|
+
timezone so long sessions never reason from a stale clock.
|
|
52
|
+
|
|
53
|
+
## Packaging and publishing (July 2026)
|
|
54
|
+
|
|
55
|
+
What began as a single extension folder became a disciplined five-workspace
|
|
56
|
+
monorepo (July 27): `core` (the suite), `skills` (a content-only skill pack),
|
|
57
|
+
`contrib` (code-only extras), `providers` (LLM providers with a multi-key API
|
|
58
|
+
key ring), and `telegram` (a bidirectional channel). The same period shipped
|
|
59
|
+
the user-facing docs (README rewrite, canonical [SETUP.md](SETUP.md)), a
|
|
60
|
+
versioned local publish pipeline (`publish-local.mjs`, `base-branch.iteration`
|
|
61
|
+
scheme with auto-revert), release guards, and the `0.40.0-main.N` iteration
|
|
62
|
+
scheme for weekly releases without semver churn.
|
|
63
|
+
|
|
64
|
+
## Reliability (August – September 2026)
|
|
65
|
+
|
|
66
|
+
The longest-running theme. Compaction became lossless by design - speaker
|
|
67
|
+
attribution and sliding-window compaction landed in late July, an append-only
|
|
68
|
+
originals archive in August - so nothing thrown away is truly gone. Heartbeat
|
|
69
|
+
telemetry was rebuilt on live
|
|
70
|
+
measurements (context tokens, cache-hit share, tokens/sec) after the old
|
|
71
|
+
pipeline was caught running on placeholder constants. A watchdog learned not
|
|
72
|
+
to bark storms. An OOM class was found and fixed where pi-core removed a
|
|
73
|
+
field the detector keyed on and every heartbeat tick started serializing the
|
|
74
|
+
entire session graph - the fix introduced scalar-whitelisted metrics and a
|
|
75
|
+
hard size limit on serialized state. Context hygiene got its own enforcement:
|
|
76
|
+
token-gated advisories that stay reachable on 1M-token windows, hard backstops
|
|
77
|
+
on runaway tool results, and a manual-compaction contract that treats a
|
|
78
|
+
compaction as a full stop. The memory layer gained a review-before-write gate
|
|
79
|
+
that rejects signal-free writes and dedupes repeats before they hit disk.
|
|
80
|
+
|
|
81
|
+
## Tooling and hygiene (September 2026)
|
|
82
|
+
|
|
83
|
+
As the suite matured, the project started gating itself: a whole-tree
|
|
84
|
+
private-data scan (home paths, API keys, session files) runs in CI and
|
|
85
|
+
locally; a placement checker scans for provenance tokens, domain literals in
|
|
86
|
+
generic layers, and owner paths; knip reports dead code; doc status markers
|
|
87
|
+
and a doc-drift detector keep prose from lying about the codebase. Comment
|
|
88
|
+
discipline is codified in CONTRIBUTING: comments explain why, history lives
|
|
89
|
+
in git.
|
|
90
|
+
|
|
91
|
+
## The satellite packages
|
|
92
|
+
|
|
93
|
+
- **providers** - grew a generalized API key ring (rotation, exponential
|
|
94
|
+
backoff, persisted exhaustion, self-healing retry), then consolidated onto
|
|
95
|
+
a single venice (a0 proxy) registration with per-model capability flags and
|
|
96
|
+
robust cost handling.
|
|
97
|
+
- **telegram** - grew from a one-way send tool into a bidirectional channel:
|
|
98
|
+
long-poll inbound, photo and voice messages with speech-to-text (an ordered
|
|
99
|
+
key pool with failover), inline-keyboard pause/resume, and a strict
|
|
100
|
+
truncation contract that never silently cuts the owner's messages.
|
|
101
|
+
- **skills** - a content-only pack (one SKILL.md per skill) that stays out of
|
|
102
|
+
every other package to avoid silent skill shadowing; it publishes through
|
|
103
|
+
the same local pipeline as the code packages.
|
|
104
|
+
|
|
105
|
+
## Where it stands
|
|
106
|
+
|
|
107
|
+
The monorepo publishes weekly `main.N` iterations, gates every change behind
|
|
108
|
+
typecheck, lint, tests, doc checks, and the private-data scan, and stays an
|
|
109
|
+
early-stage project by its own README's honest label. The open working set is
|
|
110
|
+
in [ROADMAP.md](ROADMAP.md).
|