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,214 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agent-testing
|
|
3
|
+
description: "Run and evaluate coding agents programmatically: drive pi in RPC mode (JSON events over stdin/stdout), parse agent event streams, run multi-trial benchmarks, and verify tool execution results. Use when building a test harness for an agent, benchmarking or comparing agent configurations and models, asserting on the tool calls an agent made, or extracting structured results from agent runs. Triggers: agent benchmark, RPC mode, agent evaluation, multi-trial comparison, test harness, agent event parsing, tool execution verification."
|
|
4
|
+
validated: 2026-09-09
|
|
5
|
+
verdict: KEEP
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## trigger: "benchmarking, multi-trial comparisons, tool execution verification, evaluating agent configurations, building test suites"
|
|
9
|
+
|
|
10
|
+
# Agent Testing
|
|
11
|
+
|
|
12
|
+
Test agent behavior programmatically. pi runs in RPC mode as a subprocess - you send JSON events, receive structured events back.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## RPC Mode
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
# Replace /path/to/your-extension with your extension path
|
|
20
|
+
# Also: discover available models first with `pi --list-models`
|
|
21
|
+
TEMP_PI_DIR=$(mktemp -d)
|
|
22
|
+
|
|
23
|
+
PI_CODING_AGENT_DIR=$TEMP_PI_DIR pi --mode rpc --no-session \
|
|
24
|
+
--provider <provider> --model <model> \
|
|
25
|
+
-e /path/to/your-extension
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Key flags: `--no-extensions` for baseline · `-e <path>` for extensions · `--tools read,bash` to limit tools
|
|
29
|
+
|
|
30
|
+
**Discovering models**: Run `pi --list-models 2>/dev/null | grep -v 'Warning\|INFO'` to see available providers and models in your setup. Use `--no-extensions` with built-in providers (anthropic, openai, google, openrouter) or load extensions (`-e <path>`) for custom providers.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Event Protocol
|
|
35
|
+
|
|
36
|
+
Send one JSON event per line on stdin, read events from stdout.
|
|
37
|
+
|
|
38
|
+
**Start agent**:
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{ "type": "prompt", "message": "Your task here" }
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**Key event types**:
|
|
45
|
+
|
|
46
|
+
| Event | When | Your Action |
|
|
47
|
+
| -------------------------- | --------------------- | -------------------------------- |
|
|
48
|
+
| `agent_start` | Agent begins | Log start time |
|
|
49
|
+
| `message_end` | Response complete | Extract text/code |
|
|
50
|
+
| `tool_execution_start/end` | Tool runs | Track what was called |
|
|
51
|
+
| `extension_ui_request` | Extension needs input | Respond to every one (within 2s) |
|
|
52
|
+
| `agent_end` | Agent finishes | Collect results |
|
|
53
|
+
|
|
54
|
+
### Responding to `extension_ui_request`
|
|
55
|
+
|
|
56
|
+
```python
|
|
57
|
+
if event["type"] == "extension_ui_request":
|
|
58
|
+
resp = json.dumps({
|
|
59
|
+
"type": "extension_ui_response",
|
|
60
|
+
"id": event["id"],
|
|
61
|
+
"cancelled": True
|
|
62
|
+
}) + "\n"
|
|
63
|
+
proc.stdin.write(resp.encode())
|
|
64
|
+
proc.stdin.flush()
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## Python Harness
|
|
70
|
+
|
|
71
|
+
```python
|
|
72
|
+
import subprocess, json, select, time, os, tempfile
|
|
73
|
+
|
|
74
|
+
# Isolated agent dir keeps settings and sessions out of the default location
|
|
75
|
+
temp_dir = tempfile.mkdtemp()
|
|
76
|
+
|
|
77
|
+
proc = subprocess.Popen(
|
|
78
|
+
["pi", "--mode", "rpc", "--no-session",
|
|
79
|
+
"--provider", PROVIDER, "--model", MODEL, # see `pi --list-models`
|
|
80
|
+
"-e", "/path/to/your-extension"], # set to your extension path
|
|
81
|
+
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
|
|
82
|
+
env={**os.environ, "PI_CODING_AGENT_DIR": temp_dir},
|
|
83
|
+
)
|
|
84
|
+
|
|
85
|
+
proc.stdin.write(json.dumps({"type": "prompt", "message": "task"}).encode() + b"\n")
|
|
86
|
+
proc.stdin.flush()
|
|
87
|
+
|
|
88
|
+
while True:
|
|
89
|
+
ready, _, _ = select.select([proc.stdout], [], [], 2.0)
|
|
90
|
+
if not ready:
|
|
91
|
+
if proc.poll() is not None: break
|
|
92
|
+
continue
|
|
93
|
+
line = proc.stdout.readline()
|
|
94
|
+
if not line: break
|
|
95
|
+
event = json.loads(line.decode().strip())
|
|
96
|
+
|
|
97
|
+
if event["type"] == "extension_ui_request":
|
|
98
|
+
proc.stdin.write(json.dumps({
|
|
99
|
+
"type": "extension_ui_response", "id": event["id"], "cancelled": True
|
|
100
|
+
}).encode() + b"\n")
|
|
101
|
+
proc.stdin.flush()
|
|
102
|
+
|
|
103
|
+
if event["type"] == "message_end":
|
|
104
|
+
msg = event.get("message", {})
|
|
105
|
+
if msg.get("role") == "assistant":
|
|
106
|
+
for block in msg.get("content", []):
|
|
107
|
+
if block.get("type") == "text":
|
|
108
|
+
result = block["text"]
|
|
109
|
+
|
|
110
|
+
if event["type"] == "agent_end":
|
|
111
|
+
break
|
|
112
|
+
|
|
113
|
+
proc.kill(); proc.wait()
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Extract Code from Response
|
|
119
|
+
|
|
120
|
+
````python
|
|
121
|
+
import re
|
|
122
|
+
match = re.search(r'```(?:javascript|js|python)\n(.*?)```', final_text, re.DOTALL)
|
|
123
|
+
code = match.group(1).strip() if match else None
|
|
124
|
+
````
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Test Code Correctness
|
|
129
|
+
|
|
130
|
+
```python
|
|
131
|
+
import tempfile, subprocess
|
|
132
|
+
|
|
133
|
+
def test_code(code, test_code):
|
|
134
|
+
tmpdir = tempfile.mkdtemp()
|
|
135
|
+
with open(f"{tmpdir}/solution.js", "w") as f: f.write(code)
|
|
136
|
+
with open(f"{tmpdir}/test.js", "w") as f: f.write(test_code)
|
|
137
|
+
result = subprocess.run(["node", "test.js"], capture_output=True, text=True, cwd=tmpdir, timeout=10)
|
|
138
|
+
return result.returncode == 0
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## Timeout
|
|
144
|
+
|
|
145
|
+
```python
|
|
146
|
+
import signal
|
|
147
|
+
def timeout_handler(signum, frame): raise TimeoutError()
|
|
148
|
+
signal.signal(signal.SIGALRM, timeout_handler)
|
|
149
|
+
signal.alarm(60)
|
|
150
|
+
try:
|
|
151
|
+
# ... run agent ...
|
|
152
|
+
finally:
|
|
153
|
+
proc.kill(); proc.wait()
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## Benchmark Template
|
|
159
|
+
|
|
160
|
+
````python
|
|
161
|
+
import subprocess, json, os, select, re, time
|
|
162
|
+
|
|
163
|
+
MODEL = "<model>" # see `pi --list-models`
|
|
164
|
+
PROVIDER = "<provider>"
|
|
165
|
+
|
|
166
|
+
CONFIGS = [
|
|
167
|
+
{"name": "baseline", "args": ["--no-extensions", "--tools", "read,bash,edit,write"]},
|
|
168
|
+
{"name": "with-extensions", "args": ["-e", "/path/to/your-extension"]}, # set to your extension path
|
|
169
|
+
]
|
|
170
|
+
|
|
171
|
+
def run_pi(args, prompt, timeout=90):
|
|
172
|
+
cmd = ["pi", "--mode", "rpc", "--no-session",
|
|
173
|
+
"--provider", PROVIDER, "--model", MODEL] + args
|
|
174
|
+
# Isolated agent dir keeps settings and sessions out of the default location
|
|
175
|
+
temp_dir = tempfile.mkdtemp()
|
|
176
|
+
proc = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
|
|
177
|
+
stderr=subprocess.PIPE,
|
|
178
|
+
env={**os.environ, "PI_CODING_AGENT_DIR": temp_dir})
|
|
179
|
+
proc.stdin.write(json.dumps({"type": "prompt", "message": prompt}).encode() + b"\n")
|
|
180
|
+
proc.stdin.flush()
|
|
181
|
+
|
|
182
|
+
result = None
|
|
183
|
+
start = time.time()
|
|
184
|
+
while time.time() - start < timeout:
|
|
185
|
+
ready, _, _ = select.select([proc.stdout], [], [], 2.0)
|
|
186
|
+
if not ready:
|
|
187
|
+
if proc.poll() is not None: break
|
|
188
|
+
continue
|
|
189
|
+
line = proc.stdout.readline()
|
|
190
|
+
if not line: break
|
|
191
|
+
try:
|
|
192
|
+
event = json.loads(line.decode().strip())
|
|
193
|
+
if event["type"] == "extension_ui_request":
|
|
194
|
+
proc.stdin.write(json.dumps({
|
|
195
|
+
"type": "extension_ui_response", "id": event["id"], "cancelled": True
|
|
196
|
+
}).encode() + b"\n")
|
|
197
|
+
proc.stdin.flush()
|
|
198
|
+
if event["type"] == "message_end":
|
|
199
|
+
for block in event.get("message", {}).get("content", []):
|
|
200
|
+
if block.get("type") == "text" and "```" in block.get("text", ""):
|
|
201
|
+
result = block["text"]
|
|
202
|
+
if event["type"] == "agent_end": break
|
|
203
|
+
except: pass
|
|
204
|
+
|
|
205
|
+
proc.kill(); proc.wait()
|
|
206
|
+
return result
|
|
207
|
+
|
|
208
|
+
def extract_code(text):
|
|
209
|
+
if not text: return None
|
|
210
|
+
match = re.search(r'```(?:javascript|js)\n(.*?)```', text, re.DOTALL)
|
|
211
|
+
return match.group(1).strip() if match else None
|
|
212
|
+
````
|
|
213
|
+
|
|
214
|
+
For subprocess persistence and monitoring across trials, delegate to **process-control** for tmux patterns.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: braid-reference
|
|
3
|
+
description: "Find braid's own documentation: context policy and compaction, timers and wakes, workers and the orchestrator registry, the Telegram channel, prompt and discipline rules, memory stores, the skills catalog, release and install paths, health maintenance, extensions and the polyfill. Use when a question is about braid internals, before editing braid, or when a braid behavior needs its owning doc named instead of guessed."
|
|
4
|
+
validated: 2026-10-08
|
|
5
|
+
verdict: KEEP
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## trigger: "braid docs, pi-braid documentation, braid context policy, braid compaction bands, braid timers and wakes, braid workers, orchestrator registry, braid telegram channel, braid prompt rules, braid memory stores, braid skills catalog, braid release, braid install paths, braid health maintenance, braid extension, polyfill"
|
|
9
|
+
|
|
10
|
+
# Braid Reference
|
|
11
|
+
|
|
12
|
+
Where braid's own knowledge lives, and which file owns which question. Two readers use this: an agent answering a question about braid, and a contributor about to edit braid. For the second, the owning `AGENTS.md` chain is a binding contract - read it before the first edit (the `dox` skill defines that tree).
|
|
13
|
+
|
|
14
|
+
## Step 1: resolve the roots
|
|
15
|
+
|
|
16
|
+
Braid ships as separate packages, and docs live under each package root. Find the roots once, then read every path below as `<package root>/<path-after-the-package-name>`.
|
|
17
|
+
|
|
18
|
+
| Root | Contains |
|
|
19
|
+
| ---------- | ------------------------------------------------------------------------------------- |
|
|
20
|
+
| `core` | `docs/`, `src/`, `skills/` (the core skill set), `AGENTS.md`, `README.md`, `TOOLS.md` |
|
|
21
|
+
| `skills` | the on-demand pack: `skills/<name>/SKILL.md`, `README.md`, `AGENTS.md` |
|
|
22
|
+
| `telegram` | `README.md`, `docs/` |
|
|
23
|
+
|
|
24
|
+
This file sits at `<core>/skills/braid-reference/SKILL.md`, so the core root is two levels up. The core skill set ships with the core package; the `skills` package root carries only the on-demand pack; machine-local skills such as `v2raytun-reconnect` live in `~/.pi/agent/skills/`.
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# 1. core root — two levels above this SKILL.md
|
|
28
|
+
cd <skill-dir>/../..
|
|
29
|
+
|
|
30
|
+
# 2. pack root — monorepo layout first, then the installed layout
|
|
31
|
+
ls ../skills/skills/ 2>/dev/null || ls ../pi-braid-skills/skills/ 2>/dev/null
|
|
32
|
+
|
|
33
|
+
# 3. every registered package path, whatever the layout
|
|
34
|
+
grep -A10 '"packages"' ~/.pi/agent/settings.json
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
In the monorepo the roots are `packages/core`, `packages/skills`, `packages/telegram`. In an installed tree the npm packages sit side by side under one `node_modules/` (for example `~/.pi/agent/local-packages/node_modules/pi-braid` next to `pi-braid-skills`).
|
|
38
|
+
|
|
39
|
+
## Step 2: the topic index
|
|
40
|
+
|
|
41
|
+
Paths below are checkout paths: strip the leading `packages/<name>/` and prepend that package's root. The `Shipped` column says whether the file is in the published tarball (`npm`) or exists only in a checkout (`checkout`).
|
|
42
|
+
|
|
43
|
+
| Topic | Doc | Shipped |
|
|
44
|
+
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
|
|
45
|
+
| What braid is, install paths, module toggling, storage | `packages/core/README.md`, `packages/core/docs/SETUP.md` | npm |
|
|
46
|
+
| First walkthrough: anatomy of an extension, writing one | `packages/core/docs/BEGINNERS.md` | npm |
|
|
47
|
+
| Context policy: window, reserve, bands, caps, offload | `packages/core/docs/CONTEXT-POLICY.md` | npm |
|
|
48
|
+
| Context map: contexts, owners, seam registry, where state lives | `packages/core/docs/CONTEXT-MAP.md` | npm |
|
|
49
|
+
| Context automation: proposals, policy engine, cooldown | `packages/core/src/extensions/memory/context-lifecycle/AGENTS.md` | npm |
|
|
50
|
+
| What compaction loses and which guards exist | `packages/core/docs/COMPACTION-LOSS-INVESTIGATION.md` | npm |
|
|
51
|
+
| Timers, wakes, wake retry, wake-delivery alerts | `packages/core/src/extensions/scheduling/timer/AGENTS.md` | npm |
|
|
52
|
+
| Workers, the `orchestrate` tool, locks, merge verification | `packages/core/skills/subagent-orchestration/SKILL.md` | npm |
|
|
53
|
+
| Telegram channel: live update, pause control | `packages/telegram/docs/live-update.md`, `packages/telegram/docs/pause-control.md` | npm |
|
|
54
|
+
| Telegram package overview: tools, env vars, components; turn-complete auto-notify | `packages/telegram/README.md`, `packages/telegram/docs/turn-complete-notify.md` | npm |
|
|
55
|
+
| System prompt composition, identity, whisper sections | `packages/core/src/extensions/core/prompt-builder/AGENTS.md` | npm |
|
|
56
|
+
| Enforcement: whisper cap, dedup, nudges, verification judge | `packages/core/src/extensions/enforcement/AGENTS.md` | npm |
|
|
57
|
+
| Memory stores: episodes, semantic, heuristics | `packages/core/src/extensions/memory/three-memory-stores/AGENTS.md`, `packages/core/src/extensions/memory/AGENTS.md` | npm |
|
|
58
|
+
| Skills: the core set and the on-demand pack, catalog, adding a skill | `packages/skills/README.md`, `packages/skills/AGENTS.md` | npm |
|
|
59
|
+
| Release, publish, install paths, upstream pi updates | `packages/core/skills/release-pipeline/SKILL.md`, `packages/core/scripts/update-pipeline.mjs` (plan -> pins -> publishes -> runtime update), `packages/core/scripts/publish-local.mjs` (one target per run, core by default; republish every package whose content changed), `packages/core/docs/LOCAL_DEV.md`, `packages/core/docs/SETUP.md`, `packages/core/CONTRIBUTING.md` | npm |
|
|
60
|
+
| Health maintenance, checkpoints, self-repair | `packages/core/src/extensions/self/health-maintenance/AGENTS.md` | npm |
|
|
61
|
+
| Extension loading, manifest, module toggles, the polyfill | `packages/core/AGENTS.md`, `packages/core/src/AGENTS.md`, `packages/core/src/extensions/core/AGENTS.md` | npm |
|
|
62
|
+
| Every tool and command braid adds | `packages/core/TOOLS.md` | npm |
|
|
63
|
+
| Roadmap (forward-looking) and history | `packages/core/docs/ROADMAP.md`, `packages/core/docs/HISTORY.md` | npm |
|
|
64
|
+
|
|
65
|
+
Related skills in the core set: `dox` (the AGENTS.md tree), `placement-discipline` (which layer owns a fact), `release-pipeline` (the local publish flow), `skill-usage` (adoption measurement), `pi-reference` (pi core, the layer braid extends).
|
|
66
|
+
|
|
67
|
+
## Gaps: no shipped doc yet
|
|
68
|
+
|
|
69
|
+
Do not improvise around these; say the topic has no shipped doc and name the substitute.
|
|
70
|
+
|
|
71
|
+
| Topic | Where to look instead |
|
|
72
|
+
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|
|
73
|
+
| Worker registry internals: admission, lifecycle, result verdicts, locks | source headers in the core package: `packages/core/src/lib/orchestrator/`, `packages/core/src/extensions/orchestrator/index.ts` |
|
|
74
|
+
| Compaction defaults inside pi-core (reserve math, keep-recent window) | not braid's to own: the `pi-reference` skill, then pi-core's own compaction doc |
|
|
75
|
+
| Research reports, audits, worker reports | the author's private docs repo, NOT shipped with any package: background, never the contract |
|
|
76
|
+
|
|
77
|
+
## Reading a long doc without flooding the session
|
|
78
|
+
|
|
79
|
+
1. Headings first: `grep -n '^#'` on the file, then `read` with `offset`/`limit` for the section you need.
|
|
80
|
+
2. Oversized tool results are flushed to disk by braid itself (capture cap 262144 chars, `braid.context.toolResultSizeCap`): the transcript keeps a stub naming `<braid home>/offload/<sessionId>/<toolName>-<toolCallId>.txt`, and retrieving it costs one `read` - no re-fetch, nothing lost.
|
|
81
|
+
3. A file too big to read whole (PDF, docx, HTML) goes through `document_parse`; when the text layer is missing or the layout is the point, `document_screenshot` renders one page as an image.
|
|
82
|
+
4. Never pull a whole doc into context to answer a question about one section of it.
|
|
83
|
+
|
|
84
|
+
## Before you edit braid
|
|
85
|
+
|
|
86
|
+
- Read every `AGENTS.md` on the route from the repo root to the path you touch, then update the nearest owner after the edit.
|
|
87
|
+
- A doc change is a status decision: `current` (describes the code as it is), `forward-looking`, `aspirational`, or `historical`. `npm run check:docs` fails on a missing or unknown marker; `npm run check:doc-drift` fails when a `current` doc names an API the code does not have.
|
|
88
|
+
- Every file path in this skill resolves and carries an authority marker - `<!-- status: … -->` for docs, frontmatter for a `SKILL.md` - and `npm run check:doc-index` fails when one stops resolving, ships where the table says checkout, or loses its marker. A doc that is not in the topic table has no address; add the row in the same commit as the doc.
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: code-refactoring
|
|
3
|
+
description: "Use when restructure/move/rename files or symbols across a TypeScript codebase. Covers ast-grep import path rewrites, file moves, symbol renames, and multi-file batch updates. Always use ast-grep for structural changes over sed/regex."
|
|
4
|
+
validated: 2026-08-16
|
|
5
|
+
verdict: IMPROVE
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Code Refactoring
|
|
9
|
+
|
|
10
|
+
Move files, rename symbols, and update imports at scale using **ast-grep** (0.41.0+; the
|
|
11
|
+
older `sg` binary name is deprecated) and the TypeScript compiler. Search first, refactor second - this skill absorbs the former `code-search` skill (merged 2026-08-16).
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Searching First
|
|
16
|
+
|
|
17
|
+
Most searches → **ripgrep**. ast-grep for structural patterns. `find` for file discovery.
|
|
18
|
+
|
|
19
|
+
| Task | Tool | Why |
|
|
20
|
+
| ----------------------------------------------------------- | ------------------------------------ | --------------------------------- |
|
|
21
|
+
| Structural pattern (function call, import, specific syntax) | ast-grep | Understands AST, precise matching |
|
|
22
|
+
| Text search across files | ripgrep | Fast, handles large repos |
|
|
23
|
+
| File discovery | find | Glob patterns, path-based |
|
|
24
|
+
| Rename symbol safely | lang tool (tsc --rename) or ast-grep | Preserves scope |
|
|
25
|
+
|
|
26
|
+
ripgrep basics:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
rg "pattern" . # basic search
|
|
30
|
+
rg -i "pattern" . # case-insensitive
|
|
31
|
+
rg -l "pattern" . # just filenames
|
|
32
|
+
rg -C 3 "pattern" . # 3 lines of context
|
|
33
|
+
rg -l "old" . | xargs sed -i '' 's/old/new/g' # replace in place
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Common patterns:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
# Find a function's callers
|
|
40
|
+
rg "function_name\(" . --type-add 'typescript:*.ts' -t typescript
|
|
41
|
+
|
|
42
|
+
# Find all imports of a module
|
|
43
|
+
rg "^import .* from 'module-name'" .
|
|
44
|
+
|
|
45
|
+
# Dry run before a rename: see all occurrences
|
|
46
|
+
rg -l "old_name" . | head -20
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Tool Selection
|
|
52
|
+
|
|
53
|
+
| Task | Tool | Why |
|
|
54
|
+
| ----------------------------------- | --------------------------------------------------------- | --------------------------------------------------- |
|
|
55
|
+
| Rename symbol (all files) | `ast-grep run -p --rewrite --update-all` | AST-aware, scope-safe |
|
|
56
|
+
| Update import paths after file move | `ast-grep run -p --rewrite --update-all` | Precise string matching on import/export statements |
|
|
57
|
+
| Find all importers of a file | `rg "from.*'./path'"` | Fast text search, handles all relative patterns |
|
|
58
|
+
| Move file to new directory | `mkdir -p dst && mv src/file.ts dst/` then rewire imports | Simple, then fix refs |
|
|
59
|
+
| Bulk text replacement across files | Node.js script (REAMDE-driven) | When the pattern can't express the change |
|
|
60
|
+
| Verify no stale refs | `rg "old-path" src/` after move | |
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Standard Workflow
|
|
65
|
+
|
|
66
|
+
1. **Move the file(s)** - `mkdir -p dst && mv src/foo.ts dst/foo.ts`
|
|
67
|
+
2. **Fix internal lib references** - files that import from new location with `./` or `../` paths (these don't use `lib/` in path)
|
|
68
|
+
3. **Fix external references** - files in extensions/ that import via `lib/old-path`
|
|
69
|
+
4. **Verify** - `npx tsc --noEmit`
|
|
70
|
+
5. **Test** - `npm test`
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## Common Patterns
|
|
75
|
+
|
|
76
|
+
### Pattern A: Move a lib file to a subdirectory
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
# 1. Move
|
|
80
|
+
mkdir -p src/lib/subdir
|
|
81
|
+
mv src/lib/foo.ts src/lib/subdir/
|
|
82
|
+
|
|
83
|
+
# 2. Fix lib-internal imports (./foo → ./subdir/foo)
|
|
84
|
+
# These use relative paths like "./braid-paths.js"
|
|
85
|
+
# Use rg with literal pattern to find them:
|
|
86
|
+
rg "from \"\\./(foo|bar)\"" src/lib/
|
|
87
|
+
|
|
88
|
+
# 3. Fix extension imports (lib/foo → lib/subdir/foo)
|
|
89
|
+
# These use paths like "../../lib/foo.js"
|
|
90
|
+
rg "lib/foo" src/extensions/
|
|
91
|
+
|
|
92
|
+
# 4. Verify + test
|
|
93
|
+
npx tsc --noEmit && npm test
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
### Pattern B: Rename a symbol across all files
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
ast-grep run -p 'oldName($$$)' -r 'newName($$$)' --update-all src/
|
|
100
|
+
ast-grep run -p 'oldName' -r 'newName' --update-all src/ --data-type=string || true
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Pattern C: Update imports after file rename
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
# AST-aware: match exact import string
|
|
107
|
+
ast-grep run -p "'../lib/old-name.js'" -r "'../lib/new-name.js'" src/ --update-all
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### Pattern E: Barrel file for backward compat (REQUIRED for moved files)
|
|
111
|
+
|
|
112
|
+
Always create a barrel re-export at the old path when you move a file.
|
|
113
|
+
Tests and dist imports may reference the old path directly.
|
|
114
|
+
|
|
115
|
+
```typescript
|
|
116
|
+
// src/lib/foo.ts — backward-compat barrel (old path)
|
|
117
|
+
export * from "./subdir/foo.js";
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
Without this, `import { X } from "../../dist/lib/foo.js"` breaks in tests.
|
|
121
|
+
|
|
122
|
+
### Pattern F: Cross-subdir relative paths (easy to get wrong)
|
|
123
|
+
|
|
124
|
+
When you move file A from `lib/` to `lib/subdir/`, its OWN imports change:
|
|
125
|
+
|
|
126
|
+
| Old relative path | New relative path (A now in subdir/) |
|
|
127
|
+
| ------------------------ | ------------------------------------------------ |
|
|
128
|
+
| `"./logger.js"` | `"../core/logger.js"` (sibling subdir) |
|
|
129
|
+
| `"./config/foo.js"` | `"../config/foo.js"` (sibling subdir) |
|
|
130
|
+
| `"./extension-state.js"` | `"../state/extension-state.js"` (sibling subdir) |
|
|
131
|
+
| `"./sop-extractor.js"` | `"../sop-extractor.js"` (parent, still flat) |
|
|
132
|
+
|
|
133
|
+
**Key rule:** If both files stay flat → `"./foo"` stays. If one moves to a
|
|
134
|
+
subdir → the relative path needs `../` or stays `./` depending on target.
|
|
135
|
+
|
|
136
|
+
### Pattern G: Use a scratch Node.js script for bulk rewrites
|
|
137
|
+
|
|
138
|
+
```mjs
|
|
139
|
+
import { readFileSync, writeFileSync, readdirSync, statSync } from "fs";
|
|
140
|
+
const root = new URL(".", import.meta.url).pathname;
|
|
141
|
+
|
|
142
|
+
const REWRITES = [["lib/old-name.js", "lib/subdir/old-name.js"]];
|
|
143
|
+
|
|
144
|
+
function collect(dir) {
|
|
145
|
+
const out = [];
|
|
146
|
+
for (const n of readdirSync(dir)) {
|
|
147
|
+
const f = join(dir, n);
|
|
148
|
+
if (n === "node_modules") continue;
|
|
149
|
+
if (statSync(f).isDirectory()) out.push(...collect(f));
|
|
150
|
+
else if (n.endsWith(".ts")) out.push(f);
|
|
151
|
+
}
|
|
152
|
+
return out;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
for (const full of collect(join(root, "src"))) {
|
|
156
|
+
let content = readFileSync(full, "utf-8");
|
|
157
|
+
let changed = false;
|
|
158
|
+
for (const [from, to] of REWRITES) {
|
|
159
|
+
const re = new RegExp(from.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g");
|
|
160
|
+
const next = content.replace(re, to);
|
|
161
|
+
if (next !== content) {
|
|
162
|
+
changed = true;
|
|
163
|
+
content = next;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
if (changed) writeFileSync(full, content);
|
|
167
|
+
}
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
**Always clean up temp scripts after use.**
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## Import Path Convention
|
|
175
|
+
|
|
176
|
+
lib-internal files use relative paths:
|
|
177
|
+
|
|
178
|
+
| Depth | Pattern |
|
|
179
|
+
| -------------- | ------------------- |
|
|
180
|
+
| Same dir | `"./foo.js"` |
|
|
181
|
+
| Parent dir | `"../foo.js"` |
|
|
182
|
+
| Sibling subdir | `"./subdir/foo.js"` |
|
|
183
|
+
|
|
184
|
+
Extension files use multi-level relative paths:
|
|
185
|
+
|
|
186
|
+
| Depth | Pattern |
|
|
187
|
+
| ------------------------ | ----------------------------------------------- |
|
|
188
|
+
| `contrib/*/` | `"../../lib/foo.js"` |
|
|
189
|
+
| `extensions/*/` | `"../../lib/foo.js"` or `"../../../lib/foo.js"` |
|
|
190
|
+
| `extensions/*/handlers/` | `"../../../lib/foo.js"` |
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Verification
|
|
195
|
+
|
|
196
|
+
Before considering any refactor complete:
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
npx tsc --noEmit # must be clean
|
|
200
|
+
npm test # zero regressions in passing tests
|
|
201
|
+
rg "old-path" src/ # no stale references
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## Limitations
|
|
207
|
+
|
|
208
|
+
- ast-grep matches AST nodes, not arbitrary text - multiline imports need careful patterns
|
|
209
|
+
- For `import { X, Y } from "./path"`, match the entire string, not broken across lines
|
|
210
|
+
- ts-mcp-server (MCP) is not supported by pi - use ast-grep + scripts instead
|
|
211
|
+
- `ast-grep run --update-all` applies changes without confirmation - always `npx tsc --noEmit` after
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: code-search
|
|
3
|
+
description: "Use when searching code, refactoring, running codemods, or choosing between search tools. Covers ast-grep vs ripgrep selection and usage patterns."
|
|
4
|
+
status: merged
|
|
5
|
+
successor: code-refactoring
|
|
6
|
+
validated: 2026-08-16
|
|
7
|
+
verdict: MOVE
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
> **MERGED (2026-08-16)** - content folded into [`code-refactoring`](../code-refactoring/SKILL.md) (search-then-refactor is one workflow). Overlapped core grep/find tooling.
|
|
11
|
+
|
|
12
|
+
# Code Search
|
|
13
|
+
|
|
14
|
+
Use [`code-refactoring`](../code-refactoring/SKILL.md) - its "Searching First" section covers tool selection (ripgrep vs ast-grep vs find), ripgrep usage, and the search-before-refactor workflow.
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: documentation
|
|
3
|
+
description: "Analyze a repository and generate architecture documentation, README.md, or a full documentation ecosystem. Use when documenting a codebase, summarizing architecture, or creating project docs."
|
|
4
|
+
validated: 2026-08-16
|
|
5
|
+
verdict: IMPROVE
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Codebase Summary
|
|
9
|
+
|
|
10
|
+
Analyze a codebase and generate structured documentation for AI assistants and developers.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Process
|
|
15
|
+
|
|
16
|
+
### 1. Setup
|
|
17
|
+
|
|
18
|
+
- Validate `codebase_path` exists <!-- doc-ref-exempt: skill input placeholder -->
|
|
19
|
+
- Create `output_dir` (default: `.agents/summary`) if needed <!-- doc-ref-exempt: skill input placeholder -->
|
|
20
|
+
- If `update_mode`: check `{output_dir}/.last_commit` for baseline, use `git log` for changes since <!-- doc-ref-exempt: skill input placeholder -->
|
|
21
|
+
|
|
22
|
+
### 2. Analyze
|
|
23
|
+
|
|
24
|
+
- Map packages, modules, components
|
|
25
|
+
- Identify tech stack and dependencies
|
|
26
|
+
- Find key interfaces, APIs, integration points
|
|
27
|
+
- Analyze design patterns and code structure
|
|
28
|
+
- If `update_mode`: prioritize modified components <!-- doc-ref-exempt: skill input placeholder -->
|
|
29
|
+
- Save to `{output_dir}/codebase_info.md`
|
|
30
|
+
|
|
31
|
+
### 3. Generate Documentation
|
|
32
|
+
|
|
33
|
+
Create these files in `output_dir/`:
|
|
34
|
+
|
|
35
|
+
| File | Content |
|
|
36
|
+
| ----------------- | --------------------------------------------------------------------------- |
|
|
37
|
+
| `index.md` | Knowledge base index with metadata and TOC. Primary file for AI assistants. |
|
|
38
|
+
| `architecture.md` | System architecture and design patterns |
|
|
39
|
+
| `components.md` | Major components and responsibilities |
|
|
40
|
+
| `interfaces.md` | APIs, interfaces, integration points |
|
|
41
|
+
| `data_models.md` | Data structures and models |
|
|
42
|
+
| `workflows.md` | Key processes and workflows |
|
|
43
|
+
| `dependencies.md` | External dependencies and usage |
|
|
44
|
+
|
|
45
|
+
Write all documentation in clear, direct prose. Avoid filler signposting, inflated language, and uncalibrated certainty. Prefer specific statements to vague intensifiers.
|
|
46
|
+
|
|
47
|
+
Use **Mermaid diagrams** for visual representations (never ASCII art).
|
|
48
|
+
|
|
49
|
+
### 4. Review
|
|
50
|
+
|
|
51
|
+
- Cross-reference docs for conflicts
|
|
52
|
+
- Identify under-documented areas
|
|
53
|
+
- Save findings to `{output_dir}/review_notes.md`
|
|
54
|
+
|
|
55
|
+
### 5. Consolidate
|
|
56
|
+
|
|
57
|
+
Merge with existing content (don't overwrite manually-curated sections):
|
|
58
|
+
|
|
59
|
+
| Target | Location | Focus |
|
|
60
|
+
| ----------------- | ------------ | ------------------------------------------------------------------------ |
|
|
61
|
+
| `AGENTS.md` | Project root | AI assistant context, project structure, dev patterns, test instructions |
|
|
62
|
+
| `README.md` | Project root | Project overview, installation, usage |
|
|
63
|
+
| `CONTRIBUTING.md` | Project root | Dev setup, coding standards, contribution workflow |
|
|
64
|
+
|
|
65
|
+
The summary files in `.agents/summary/` feed into these root-level files. `index.md` remains the primary AI context file for ongoing sessions.
|
|
66
|
+
|
|
67
|
+
### 6. Finalize
|
|
68
|
+
|
|
69
|
+
- Save git HEAD to `{output_dir}/.last_commit`
|
|
70
|
+
- `index.md` → primary AI context file (referenced in prompt or loaded at session start)
|
|
71
|
+
- `AGENTS.md` → updated at project root with consolidated AI context
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## Output Structure
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
.agents/summary/
|
|
79
|
+
├── .last_commit
|
|
80
|
+
├── index.md
|
|
81
|
+
├── codebase_info.md
|
|
82
|
+
├── architecture.md
|
|
83
|
+
├── components.md
|
|
84
|
+
├── interfaces.md
|
|
85
|
+
├── data_models.md
|
|
86
|
+
├── workflows.md
|
|
87
|
+
├── dependencies.md
|
|
88
|
+
└── review_notes.md
|
|
89
|
+
```
|