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,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* TG poller liveness seam — cross-package soft registry (telegram →
|
|
3
|
+
* prompt-builder).
|
|
4
|
+
*
|
|
5
|
+
* The telegram package owns the inbound poller's live running state
|
|
6
|
+
* (packages/telegram/src/index.ts `activePoller` / `isRunning()`) and cannot
|
|
7
|
+
* import pi-braid core (standalone package, no core dep); the prompt-builder
|
|
8
|
+
* needs that state at whisper build time to gate the "TG inbound" reachability
|
|
9
|
+
* row in the awareness catalog. Neither side imports the other, so the state
|
|
10
|
+
* crosses through a process-global slot — the same deliberate seam pattern as
|
|
11
|
+
* the providers key-ring feedback (KEY_RING_FEEDBACK_KEY), the watchdog tunnel
|
|
12
|
+
* hub (WATCHDOG_TUNNEL_KEY), and the watchdog tg-signal sender
|
|
13
|
+
* (WATCHDOG_TG_SIGNAL_KEY).
|
|
14
|
+
*
|
|
15
|
+
* globalThis (not a module-level let): the prompt-builder runs from the TS
|
|
16
|
+
* SOURCE tree while the telegram package loads pi-braid from compiled DIST,
|
|
17
|
+
* giving this file two module instances in one process — the
|
|
18
|
+
* CUSTOM_MODEL_KEYS comment in global-state.ts documents the same hazard. The
|
|
19
|
+
* slot must also survive /reload.
|
|
20
|
+
*
|
|
21
|
+
* What is stored is a PROBE, not a start/stop boolean: the telegram factory
|
|
22
|
+
* publishes `() => Boolean(activePoller?.isRunning())` once at load and every
|
|
23
|
+
* whisper build re-asks the live source of truth. A boolean written on
|
|
24
|
+
* start/stop would go stale exactly in the failure mode (poller dies
|
|
25
|
+
* silently without calling stop; nothing would downgrade the row). The probe
|
|
26
|
+
* also makes reload and the post-reload auto-restart wiring-free: the rebuilt
|
|
27
|
+
* runtime re-publishes over the slot on the next factory run.
|
|
28
|
+
*
|
|
29
|
+
* Absent slot (telegram not loaded, pre-publish build) reads as "unknown" —
|
|
30
|
+
* consumers must hedge, never assert reachability. The reader never throws:
|
|
31
|
+
* a throwing probe degrades to "unknown".
|
|
32
|
+
*/
|
|
33
|
+
/**
|
|
34
|
+
* Process-global slot key — MUST stay in sync with the local literal in
|
|
35
|
+
* packages/telegram/src/index.ts (TELEGRAM_POLLER_LIVENESS_KEY).
|
|
36
|
+
*/
|
|
37
|
+
export const TELEGRAM_POLLER_LIVENESS_KEY = "__braid_tg_poller_liveness";
|
|
38
|
+
/** Publish (or clear, with null) the poller liveness probe. */
|
|
39
|
+
export function setTelegramPollerLivenessProbe(probe) {
|
|
40
|
+
globalThis[TELEGRAM_POLLER_LIVENESS_KEY] = probe ?? null;
|
|
41
|
+
}
|
|
42
|
+
/** Read the published probe (null when telegram has not loaded/published). */
|
|
43
|
+
export function getTelegramPollerLivenessProbe() {
|
|
44
|
+
const fn = globalThis[TELEGRAM_POLLER_LIVENESS_KEY];
|
|
45
|
+
return typeof fn === "function" ? fn : null;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Ask the probe live. "unknown" when the telegram extension has not published
|
|
49
|
+
* a probe (not loaded, pre-publish build) or the probe threw. Consumers treat
|
|
50
|
+
* "unknown" like "stopped": hedge, never assert reachability.
|
|
51
|
+
*/
|
|
52
|
+
export function readTelegramPollerLiveness() {
|
|
53
|
+
const probe = getTelegramPollerLivenessProbe();
|
|
54
|
+
if (!probe)
|
|
55
|
+
return "unknown";
|
|
56
|
+
try {
|
|
57
|
+
return probe() ? "running" : "stopped";
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
return "unknown";
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
/** Clear the slot. Test helper. */
|
|
64
|
+
export function resetTelegramPollerLivenessProbe() {
|
|
65
|
+
globalThis[TELEGRAM_POLLER_LIVENESS_KEY] = null;
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=telegram-poller-liveness.js.map
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool provenance: records which extension registered each tool.
|
|
3
|
+
*
|
|
4
|
+
* Written by the loader's `registerTool` wrapper (src/loader/loader.ts,
|
|
5
|
+
* wrapForProvenance) as each extension registers its tools. Read by nobody:
|
|
6
|
+
* the module exposes no getter, and the prompt-builder's Instance block builds
|
|
7
|
+
* its extension list from discoverTopLevelExtensions() instead
|
|
8
|
+
* (extensions/core/prompt-builder/instance-composition.ts).
|
|
9
|
+
*
|
|
10
|
+
* Pattern: per-process module-level state. The provenance is built
|
|
11
|
+
* once at session-start by the loader and is read-only
|
|
12
|
+
* after that. Cross-session state is fine here -- tool registration
|
|
13
|
+
* is determined by config, not by per-session data.
|
|
14
|
+
*
|
|
15
|
+
* Invariant: every entry has both a tool name and an extension id.
|
|
16
|
+
* Unregistered tools (pi-core built-ins not registered by an extension)
|
|
17
|
+
* are simply absent from the map; a consumer should treat absence as
|
|
18
|
+
* "from pi-core or unknown source."
|
|
19
|
+
*/
|
|
20
|
+
/** Record a tool registration. Called by the loader after each extension runs. */
|
|
21
|
+
export declare function recordToolRegistration(toolName: string, extensionId: string): void;
|
|
22
|
+
//# sourceMappingURL=tool-provenance.d.ts.map
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool provenance: records which extension registered each tool.
|
|
3
|
+
*
|
|
4
|
+
* Written by the loader's `registerTool` wrapper (src/loader/loader.ts,
|
|
5
|
+
* wrapForProvenance) as each extension registers its tools. Read by nobody:
|
|
6
|
+
* the module exposes no getter, and the prompt-builder's Instance block builds
|
|
7
|
+
* its extension list from discoverTopLevelExtensions() instead
|
|
8
|
+
* (extensions/core/prompt-builder/instance-composition.ts).
|
|
9
|
+
*
|
|
10
|
+
* Pattern: per-process module-level state. The provenance is built
|
|
11
|
+
* once at session-start by the loader and is read-only
|
|
12
|
+
* after that. Cross-session state is fine here -- tool registration
|
|
13
|
+
* is determined by config, not by per-session data.
|
|
14
|
+
*
|
|
15
|
+
* Invariant: every entry has both a tool name and an extension id.
|
|
16
|
+
* Unregistered tools (pi-core built-ins not registered by an extension)
|
|
17
|
+
* are simply absent from the map; a consumer should treat absence as
|
|
18
|
+
* "from pi-core or unknown source."
|
|
19
|
+
*/
|
|
20
|
+
const _provenance = new Map();
|
|
21
|
+
/** Record a tool registration. Called by the loader after each extension runs. */
|
|
22
|
+
export function recordToolRegistration(toolName, extensionId) {
|
|
23
|
+
_provenance.set(toolName, extensionId);
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=tool-provenance.js.map
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Workspace Snapshot - lightweight Time Travel for Braid.
|
|
3
|
+
*
|
|
4
|
+
* Captures atomic workspace snapshots: file state (modified files only) +
|
|
5
|
+
* session position (leaf ID / turn tag) + extension state (checkpoint ref) +
|
|
6
|
+
* working context (scratchpad goal/plan/decisions/learnings).
|
|
7
|
+
*
|
|
8
|
+
* Disk-backed under ~/.pi/agent/braid/snapshots/. No git dependency,
|
|
9
|
+
* no user repo pollution. Only files the agent has actually modified
|
|
10
|
+
* (traceable from the tool tracker) are captured, not the entire workspace.
|
|
11
|
+
*
|
|
12
|
+
* Inspired by Agent Zero's Time Travel (git-backed adaptive-debounced
|
|
13
|
+
* snapshots) but adapted for Braid's architecture - lightweight file
|
|
14
|
+
* copies + state references instead of git refs.
|
|
15
|
+
*
|
|
16
|
+
* Architecture:
|
|
17
|
+
* capture() -> snapshot v1 -> file copies + position + state ref
|
|
18
|
+
* (agent continues working)
|
|
19
|
+
* capture() -> snapshot v2 -> file copies + position + state ref
|
|
20
|
+
* (agent can navigate between snapshots)
|
|
21
|
+
* diff(snapId) -> what changed between snap v1 and now
|
|
22
|
+
* list() -> all snapshots with metadata
|
|
23
|
+
* restore(snapId) -> preview + apply file copies
|
|
24
|
+
* (auth preserved: ~/.pi/ files excluded)
|
|
25
|
+
*/
|
|
26
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
27
|
+
export interface WorkspaceSnapshotMeta {
|
|
28
|
+
id: string;
|
|
29
|
+
reason: string;
|
|
30
|
+
timestamp: number;
|
|
31
|
+
turn: number;
|
|
32
|
+
sessionLeafId: string;
|
|
33
|
+
sessionTag?: string;
|
|
34
|
+
fileCount: number;
|
|
35
|
+
/** File paths (relative to workspace root) captured in this snapshot */
|
|
36
|
+
files: string[];
|
|
37
|
+
/** Reference to state-checkpoint ID (if available at capture time) */
|
|
38
|
+
checkpointRef?: string;
|
|
39
|
+
/** Summary of working context at capture time */
|
|
40
|
+
context?: {
|
|
41
|
+
goal: string;
|
|
42
|
+
planStepCount: number;
|
|
43
|
+
decisionCount: number;
|
|
44
|
+
learningCount: number;
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
export interface DiffEntry {
|
|
48
|
+
status: "added" | "modified" | "removed" | "unchanged";
|
|
49
|
+
filePath: string;
|
|
50
|
+
}
|
|
51
|
+
export interface SnapshotManifest {
|
|
52
|
+
snapshots: WorkspaceSnapshotMeta[];
|
|
53
|
+
updatedAt: number;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Resolve a relative file path against a base directory.
|
|
57
|
+
* Returns the absolute path, or null if the result escapes the base.
|
|
58
|
+
*/
|
|
59
|
+
/**
|
|
60
|
+
* Capture a workspace snapshot.
|
|
61
|
+
*
|
|
62
|
+
* @param ctx - Extension context (for session position + scratchpad)
|
|
63
|
+
* @param reason - Human-readable reason for this snapshot
|
|
64
|
+
* @param modifiedFiles - List of absolute file paths the agent has modified
|
|
65
|
+
* @param workspaceRoot - Project root directory for relative path resolution
|
|
66
|
+
* @param checkpointRef - Optional state-checkpoint ID to reference
|
|
67
|
+
* @returns The snapshot metadata, or null on failure
|
|
68
|
+
*/
|
|
69
|
+
export declare function captureSnapshot(ctx: ExtensionContext, reason: string, modifiedFiles: string[], workspaceRoot: string, checkpointRef?: string): Promise<WorkspaceSnapshotMeta | null>;
|
|
70
|
+
/**
|
|
71
|
+
* Get a single snapshot's metadata by ID.
|
|
72
|
+
*/
|
|
73
|
+
export declare function getSnapshot(id: string): Promise<WorkspaceSnapshotMeta | null>;
|
|
74
|
+
/**
|
|
75
|
+
* Compute diff between a snapshot and the current state of the workspace.
|
|
76
|
+
*
|
|
77
|
+
* Returns per-file diff status: added (snapshot has file not in workspace),
|
|
78
|
+
* modified (content differs), removed (workspace has file not in snapshot),
|
|
79
|
+
* unchanged.
|
|
80
|
+
*/
|
|
81
|
+
export declare function diffSnapshot(id: string, workspaceRoot: string): Promise<{
|
|
82
|
+
meta: WorkspaceSnapshotMeta;
|
|
83
|
+
diff: DiffEntry[];
|
|
84
|
+
} | null>;
|
|
85
|
+
/**
|
|
86
|
+
* Restore files from a snapshot to the workspace.
|
|
87
|
+
* Returns a preview of what would change without applying.
|
|
88
|
+
*
|
|
89
|
+
* @param id - Snapshot ID
|
|
90
|
+
* @param workspaceRoot - Project root directory
|
|
91
|
+
* @param dryRun - If true, only return the diff without applying changes
|
|
92
|
+
* @returns Summary of restored files, or null on failure
|
|
93
|
+
*/
|
|
94
|
+
export declare function restoreSnapshot(id: string, workspaceRoot: string, dryRun?: boolean): Promise<{
|
|
95
|
+
meta: WorkspaceSnapshotMeta;
|
|
96
|
+
toRestore: DiffEntry[];
|
|
97
|
+
skipped: string[];
|
|
98
|
+
} | null>;
|
|
99
|
+
/**
|
|
100
|
+
* Delete a snapshot by ID.
|
|
101
|
+
*/
|
|
102
|
+
export declare function deleteSnapshot(id: string): Promise<boolean>;
|
|
103
|
+
/**
|
|
104
|
+
* Get snapshot storage usage info.
|
|
105
|
+
*/
|
|
106
|
+
export declare function getSnapshotInfo(): Promise<{
|
|
107
|
+
count: number;
|
|
108
|
+
snapshots: WorkspaceSnapshotMeta[];
|
|
109
|
+
storageBytes: number;
|
|
110
|
+
}>;
|
|
111
|
+
//# sourceMappingURL=workspace-snapshot.d.ts.map
|
|
@@ -0,0 +1,372 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Workspace Snapshot - lightweight Time Travel for Braid.
|
|
3
|
+
*
|
|
4
|
+
* Captures atomic workspace snapshots: file state (modified files only) +
|
|
5
|
+
* session position (leaf ID / turn tag) + extension state (checkpoint ref) +
|
|
6
|
+
* working context (scratchpad goal/plan/decisions/learnings).
|
|
7
|
+
*
|
|
8
|
+
* Disk-backed under ~/.pi/agent/braid/snapshots/. No git dependency,
|
|
9
|
+
* no user repo pollution. Only files the agent has actually modified
|
|
10
|
+
* (traceable from the tool tracker) are captured, not the entire workspace.
|
|
11
|
+
*
|
|
12
|
+
* Inspired by Agent Zero's Time Travel (git-backed adaptive-debounced
|
|
13
|
+
* snapshots) but adapted for Braid's architecture - lightweight file
|
|
14
|
+
* copies + state references instead of git refs.
|
|
15
|
+
*
|
|
16
|
+
* Architecture:
|
|
17
|
+
* capture() -> snapshot v1 -> file copies + position + state ref
|
|
18
|
+
* (agent continues working)
|
|
19
|
+
* capture() -> snapshot v2 -> file copies + position + state ref
|
|
20
|
+
* (agent can navigate between snapshots)
|
|
21
|
+
* diff(snapId) -> what changed between snap v1 and now
|
|
22
|
+
* list() -> all snapshots with metadata
|
|
23
|
+
* restore(snapId) -> preview + apply file copies
|
|
24
|
+
* (auth preserved: ~/.pi/ files excluded)
|
|
25
|
+
*/
|
|
26
|
+
import * as fs from "node:fs/promises";
|
|
27
|
+
import * as path from "node:path";
|
|
28
|
+
import { createLogger } from "../core/logger.js";
|
|
29
|
+
import { snapshotDir } from "../config/braid-paths.js";
|
|
30
|
+
import { readScratchpadState, getSessionLeafIdSafe, getSessionLabelSafe, } from "./extension-state.js";
|
|
31
|
+
const log = createLogger("workspace-snapshot");
|
|
32
|
+
// ── Constants ───────────────────────────────────────────────────────────────
|
|
33
|
+
const MANIFEST_FILE = "manifest.json";
|
|
34
|
+
const SNAPSHOT_PREFIX = "snap-";
|
|
35
|
+
/** Retention cap on persisted workspace snapshots (prune oldest past this). */
|
|
36
|
+
const SNAPSHOT_RETENTION_CAP = 20;
|
|
37
|
+
// Files/directories implicitly excluded from snapshots.
|
|
38
|
+
// These contain auth tokens, session state, or are managed by other systems.
|
|
39
|
+
const EXCLUDED_PATHS = [
|
|
40
|
+
/\/\.pi\//,
|
|
41
|
+
/\/node_modules\//,
|
|
42
|
+
/\/\.git\//,
|
|
43
|
+
/\/dist\//,
|
|
44
|
+
/\/\.tsbuildinfo$/,
|
|
45
|
+
/package-lock\.json$/,
|
|
46
|
+
/yarn\.lock$/,
|
|
47
|
+
];
|
|
48
|
+
// ── Storage ─────────────────────────────────────────────────────────────────
|
|
49
|
+
function snapshotDirPath(id) {
|
|
50
|
+
return path.join(snapshotDir(), id);
|
|
51
|
+
}
|
|
52
|
+
function manifestPath() {
|
|
53
|
+
return path.join(snapshotDir(), MANIFEST_FILE);
|
|
54
|
+
}
|
|
55
|
+
function filesDir(id) {
|
|
56
|
+
return path.join(snapshotDirPath(id), "files");
|
|
57
|
+
}
|
|
58
|
+
function metaFilePath(id) {
|
|
59
|
+
return path.join(snapshotDirPath(id), "meta.json");
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Generate a short, readable snapshot ID with a descriptive suffix.
|
|
63
|
+
* Format: snap-<timestamp-base36>-<reason-slug>
|
|
64
|
+
*/
|
|
65
|
+
function generateSnapshotId(reason) {
|
|
66
|
+
const ts = Date.now().toString(36);
|
|
67
|
+
const slug = reason
|
|
68
|
+
.toLowerCase()
|
|
69
|
+
.replace(/[^a-z0-9]+/g, "-")
|
|
70
|
+
.replace(/^-|-$/g, "")
|
|
71
|
+
.slice(0, 16);
|
|
72
|
+
return `${SNAPSHOT_PREFIX}${ts}-${slug}`;
|
|
73
|
+
}
|
|
74
|
+
// ── Manifest Management ─────────────────────────────────────────────────────
|
|
75
|
+
async function loadManifest() {
|
|
76
|
+
try {
|
|
77
|
+
const data = await fs.readFile(manifestPath(), "utf-8");
|
|
78
|
+
return JSON.parse(data);
|
|
79
|
+
}
|
|
80
|
+
catch {
|
|
81
|
+
return { snapshots: [], updatedAt: Date.now() };
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
async function saveManifest(manifest) {
|
|
85
|
+
await fs.mkdir(path.dirname(manifestPath()), { recursive: true });
|
|
86
|
+
await fs.writeFile(manifestPath(), JSON.stringify(manifest, null, 2), "utf-8");
|
|
87
|
+
}
|
|
88
|
+
function isExcluded(filePath) {
|
|
89
|
+
return EXCLUDED_PATHS.some((pattern) => pattern.test(filePath));
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Resolve a relative file path against a base directory.
|
|
93
|
+
* Returns the absolute path, or null if the result escapes the base.
|
|
94
|
+
*/
|
|
95
|
+
// ── Core Operations ─────────────────────────────────────────────────────────
|
|
96
|
+
/**
|
|
97
|
+
* Capture a workspace snapshot.
|
|
98
|
+
*
|
|
99
|
+
* @param ctx - Extension context (for session position + scratchpad)
|
|
100
|
+
* @param reason - Human-readable reason for this snapshot
|
|
101
|
+
* @param modifiedFiles - List of absolute file paths the agent has modified
|
|
102
|
+
* @param workspaceRoot - Project root directory for relative path resolution
|
|
103
|
+
* @param checkpointRef - Optional state-checkpoint ID to reference
|
|
104
|
+
* @returns The snapshot metadata, or null on failure
|
|
105
|
+
*/
|
|
106
|
+
export async function captureSnapshot(ctx, reason, modifiedFiles, workspaceRoot, checkpointRef) {
|
|
107
|
+
try {
|
|
108
|
+
// 1. Prune old snapshots if at capacity
|
|
109
|
+
const manifest = await loadManifest();
|
|
110
|
+
while (manifest.snapshots.length >= SNAPSHOT_RETENTION_CAP) {
|
|
111
|
+
const oldest = manifest.snapshots.shift();
|
|
112
|
+
await fs.rm(snapshotDirPath(oldest.id), { recursive: true, force: true }).catch(() => { });
|
|
113
|
+
}
|
|
114
|
+
// 2. Generate ID and create directories
|
|
115
|
+
const id = generateSnapshotId(reason);
|
|
116
|
+
await fs.mkdir(filesDir(id), { recursive: true });
|
|
117
|
+
// 3. Filter and copy modified files
|
|
118
|
+
const capturedFiles = [];
|
|
119
|
+
const fileContents = {};
|
|
120
|
+
const normalizedRoot = path.resolve(workspaceRoot);
|
|
121
|
+
for (const absPath of modifiedFiles) {
|
|
122
|
+
if (!absPath.startsWith(normalizedRoot))
|
|
123
|
+
continue;
|
|
124
|
+
if (isExcluded(absPath))
|
|
125
|
+
continue;
|
|
126
|
+
try {
|
|
127
|
+
const content = await fs.readFile(absPath, "utf-8");
|
|
128
|
+
const relPath = path.relative(normalizedRoot, absPath);
|
|
129
|
+
capturedFiles.push(relPath);
|
|
130
|
+
fileContents[relPath] = content;
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
// File may have been deleted between tracking and capture
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
if (capturedFiles.length === 0) {
|
|
137
|
+
log.warn("Snapshot capture: no modified files to capture");
|
|
138
|
+
return null;
|
|
139
|
+
}
|
|
140
|
+
// 4. Write file copies to snapshot directory
|
|
141
|
+
const fileMeta = {};
|
|
142
|
+
for (const [relPath, content] of Object.entries(fileContents)) {
|
|
143
|
+
const snapFilePath = path.join(filesDir(id), relPath.replace(/\//g, "__"));
|
|
144
|
+
await fs.mkdir(path.dirname(snapFilePath), { recursive: true }).catch(() => { });
|
|
145
|
+
await fs.writeFile(snapFilePath, content, "utf-8");
|
|
146
|
+
fileMeta[relPath] = snapFilePath;
|
|
147
|
+
}
|
|
148
|
+
// 5. Capture session position
|
|
149
|
+
let sessionLeafId = "";
|
|
150
|
+
let sessionTag;
|
|
151
|
+
try {
|
|
152
|
+
const leafId = getSessionLeafIdSafe(ctx);
|
|
153
|
+
if (leafId) {
|
|
154
|
+
sessionLeafId = leafId;
|
|
155
|
+
sessionTag = getSessionLabelSafe(ctx, leafId);
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
catch {
|
|
159
|
+
// Non-fatal: session position is best-effort
|
|
160
|
+
}
|
|
161
|
+
// 6. Capture working context from scratchpad (best-effort)
|
|
162
|
+
let context;
|
|
163
|
+
try {
|
|
164
|
+
const d = readScratchpadState(ctx);
|
|
165
|
+
if (d) {
|
|
166
|
+
context = {
|
|
167
|
+
goal: d.goal ?? "",
|
|
168
|
+
planStepCount: d.plan?.length ?? 0,
|
|
169
|
+
decisionCount: d.decisions?.length ?? 0,
|
|
170
|
+
learningCount: d.key_learnings?.length ?? 0,
|
|
171
|
+
};
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
catch {
|
|
175
|
+
// Non-fatal
|
|
176
|
+
}
|
|
177
|
+
// 7. Build metadata
|
|
178
|
+
const meta = {
|
|
179
|
+
id,
|
|
180
|
+
reason,
|
|
181
|
+
timestamp: Date.now(),
|
|
182
|
+
turn: 0, // Enforcement turn not directly accessible here - will be enriched
|
|
183
|
+
sessionLeafId,
|
|
184
|
+
sessionTag,
|
|
185
|
+
fileCount: capturedFiles.length,
|
|
186
|
+
files: capturedFiles,
|
|
187
|
+
checkpointRef,
|
|
188
|
+
context,
|
|
189
|
+
};
|
|
190
|
+
await fs.writeFile(metaFilePath(id), JSON.stringify(meta, null, 2), "utf-8");
|
|
191
|
+
// 8. Update manifest
|
|
192
|
+
manifest.snapshots.push(meta);
|
|
193
|
+
manifest.updatedAt = Date.now();
|
|
194
|
+
await saveManifest(manifest);
|
|
195
|
+
log.info(`Snapshot created: ${id} - ${capturedFiles.length} files, reason: ${reason}`);
|
|
196
|
+
return meta;
|
|
197
|
+
}
|
|
198
|
+
catch (err) {
|
|
199
|
+
log.error("Failed to capture snapshot:", err);
|
|
200
|
+
return null;
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
* Get a single snapshot's metadata by ID.
|
|
205
|
+
*/
|
|
206
|
+
export async function getSnapshot(id) {
|
|
207
|
+
const manifest = await loadManifest();
|
|
208
|
+
return manifest.snapshots.find((s) => s.id === id) ?? null;
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
* Compute diff between a snapshot and the current state of the workspace.
|
|
212
|
+
*
|
|
213
|
+
* Returns per-file diff status: added (snapshot has file not in workspace),
|
|
214
|
+
* modified (content differs), removed (workspace has file not in snapshot),
|
|
215
|
+
* unchanged.
|
|
216
|
+
*/
|
|
217
|
+
export async function diffSnapshot(id, workspaceRoot) {
|
|
218
|
+
const meta = await getSnapshot(id);
|
|
219
|
+
if (!meta)
|
|
220
|
+
return null;
|
|
221
|
+
const normalizedRoot = path.resolve(workspaceRoot);
|
|
222
|
+
const diff = [];
|
|
223
|
+
const snapFiles = new Map();
|
|
224
|
+
for (const relPath of meta.files) {
|
|
225
|
+
const snapFilePath = path.join(filesDir(id), relPath.replace(/\//g, "__"));
|
|
226
|
+
try {
|
|
227
|
+
snapFiles.set(relPath, await fs.readFile(snapFilePath, "utf-8"));
|
|
228
|
+
}
|
|
229
|
+
catch {
|
|
230
|
+
// Snapshot file missing - treat as empty
|
|
231
|
+
snapFiles.set(relPath, "");
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
for (const [relPath, snapContent] of snapFiles) {
|
|
235
|
+
const absPath = path.resolve(normalizedRoot, relPath);
|
|
236
|
+
try {
|
|
237
|
+
const currentContent = await fs.readFile(absPath, "utf-8");
|
|
238
|
+
if (currentContent === snapContent) {
|
|
239
|
+
diff.push({ status: "unchanged", filePath: relPath });
|
|
240
|
+
}
|
|
241
|
+
else {
|
|
242
|
+
diff.push({ status: "modified", filePath: relPath });
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
catch {
|
|
246
|
+
// File deleted from workspace since snapshot
|
|
247
|
+
diff.push({ status: "removed", filePath: relPath });
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
// Check for files in workspace root that exist but aren't in snapshot
|
|
251
|
+
// (only top-level check - deep scanning is expensive)
|
|
252
|
+
const rootEntries = await fs.readdir(normalizedRoot).catch(() => []);
|
|
253
|
+
for (const entry of rootEntries) {
|
|
254
|
+
if (!meta.files.includes(entry)) {
|
|
255
|
+
const fullPath = path.join(normalizedRoot, entry);
|
|
256
|
+
try {
|
|
257
|
+
const stat = await fs.stat(fullPath);
|
|
258
|
+
if (stat.isFile() && !isExcluded(fullPath) && !diff.some((d) => d.filePath === entry)) {
|
|
259
|
+
diff.push({ status: "added", filePath: entry });
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
catch {
|
|
263
|
+
// stat failed - skip
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
return { meta, diff };
|
|
268
|
+
}
|
|
269
|
+
/**
|
|
270
|
+
* Restore files from a snapshot to the workspace.
|
|
271
|
+
* Returns a preview of what would change without applying.
|
|
272
|
+
*
|
|
273
|
+
* @param id - Snapshot ID
|
|
274
|
+
* @param workspaceRoot - Project root directory
|
|
275
|
+
* @param dryRun - If true, only return the diff without applying changes
|
|
276
|
+
* @returns Summary of restored files, or null on failure
|
|
277
|
+
*/
|
|
278
|
+
export async function restoreSnapshot(id, workspaceRoot, dryRun = true) {
|
|
279
|
+
const meta = await getSnapshot(id);
|
|
280
|
+
if (!meta)
|
|
281
|
+
return null;
|
|
282
|
+
const normalizedRoot = path.resolve(workspaceRoot);
|
|
283
|
+
const toRestore = [];
|
|
284
|
+
const skipped = [];
|
|
285
|
+
for (const relPath of meta.files) {
|
|
286
|
+
const absPath = path.resolve(normalizedRoot, relPath);
|
|
287
|
+
// Safety: don't restore files outside workspace
|
|
288
|
+
if (!absPath.startsWith(normalizedRoot)) {
|
|
289
|
+
skipped.push(relPath);
|
|
290
|
+
continue;
|
|
291
|
+
}
|
|
292
|
+
// Safety: don't restore excluded paths
|
|
293
|
+
if (isExcluded(absPath)) {
|
|
294
|
+
skipped.push(relPath);
|
|
295
|
+
continue;
|
|
296
|
+
}
|
|
297
|
+
const snapFilePath = path.join(filesDir(id), relPath.replace(/\//g, "__"));
|
|
298
|
+
let snapContent;
|
|
299
|
+
try {
|
|
300
|
+
snapContent = await fs.readFile(snapFilePath, "utf-8");
|
|
301
|
+
}
|
|
302
|
+
catch {
|
|
303
|
+
skipped.push(relPath);
|
|
304
|
+
continue;
|
|
305
|
+
}
|
|
306
|
+
let currentContent;
|
|
307
|
+
try {
|
|
308
|
+
currentContent = await fs.readFile(absPath, "utf-8");
|
|
309
|
+
}
|
|
310
|
+
catch {
|
|
311
|
+
// File doesn't exist in workspace - it's a new file to restore
|
|
312
|
+
}
|
|
313
|
+
if (currentContent === snapContent) {
|
|
314
|
+
// Already up to date - skip
|
|
315
|
+
continue;
|
|
316
|
+
}
|
|
317
|
+
toRestore.push({
|
|
318
|
+
status: currentContent === undefined ? "added" : "modified",
|
|
319
|
+
filePath: relPath,
|
|
320
|
+
});
|
|
321
|
+
// Only apply if not a dry run
|
|
322
|
+
if (!dryRun) {
|
|
323
|
+
await fs.mkdir(path.dirname(absPath), { recursive: true });
|
|
324
|
+
await fs.writeFile(absPath, snapContent, "utf-8");
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
return { meta, toRestore, skipped };
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* Delete a snapshot by ID.
|
|
331
|
+
*/
|
|
332
|
+
export async function deleteSnapshot(id) {
|
|
333
|
+
const manifest = await loadManifest();
|
|
334
|
+
const idx = manifest.snapshots.findIndex((s) => s.id === id);
|
|
335
|
+
if (idx === -1)
|
|
336
|
+
return false;
|
|
337
|
+
manifest.snapshots.splice(idx, 1);
|
|
338
|
+
manifest.updatedAt = Date.now();
|
|
339
|
+
await saveManifest(manifest);
|
|
340
|
+
await fs.rm(snapshotDirPath(id), { recursive: true, force: true }).catch(() => { });
|
|
341
|
+
log.info(`Snapshot deleted: ${id}`);
|
|
342
|
+
return true;
|
|
343
|
+
}
|
|
344
|
+
/**
|
|
345
|
+
* Get snapshot storage usage info.
|
|
346
|
+
*/
|
|
347
|
+
export async function getSnapshotInfo() {
|
|
348
|
+
const manifest = await loadManifest();
|
|
349
|
+
let storageBytes = 0;
|
|
350
|
+
for (const snap of manifest.snapshots) {
|
|
351
|
+
try {
|
|
352
|
+
const dir = snapshotDirPath(snap.id);
|
|
353
|
+
const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
|
|
354
|
+
for (const entry of entries) {
|
|
355
|
+
if (entry.isFile()) {
|
|
356
|
+
const stat = await fs.stat(path.join(dir, entry.name)).catch(() => null);
|
|
357
|
+
if (stat)
|
|
358
|
+
storageBytes += stat.size;
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
catch {
|
|
363
|
+
// Snapshot directory missing - skip
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
return {
|
|
367
|
+
count: manifest.snapshots.length,
|
|
368
|
+
snapshots: manifest.snapshots.slice().reverse(),
|
|
369
|
+
storageBytes,
|
|
370
|
+
};
|
|
371
|
+
}
|
|
372
|
+
//# sourceMappingURL=workspace-snapshot.js.map
|