pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Worker status at a glance.
|
|
4
|
+
*
|
|
5
|
+
* Replaces the hand-rolled per-worker loops: one call answers "what is every
|
|
6
|
+
* worker doing, and is anything wrong with it" from evidence rather than from
|
|
7
|
+
* the registry's own claim about itself.
|
|
8
|
+
*
|
|
9
|
+
* node workers.mjs live workers in the cwd's registry
|
|
10
|
+
* node workers.mjs <id> <id> only these
|
|
11
|
+
* node workers.mjs --all include closed
|
|
12
|
+
* node workers.mjs --repo <path> another repo's registry
|
|
13
|
+
* node workers.mjs --json machine-readable
|
|
14
|
+
* node workers.mjs --stale <min> age after which 'working' is flagged (default 15)
|
|
15
|
+
*
|
|
16
|
+
* What it reads, and why each one is separate evidence:
|
|
17
|
+
* registry the claim (status, session path, deliverable, branch)
|
|
18
|
+
* session mtime + event count — the only proof a worker is still moving
|
|
19
|
+
* git commits ahead of the base and dirty count, from the real tree
|
|
20
|
+
* output whether the deliverable exists on disk, and its size
|
|
21
|
+
*
|
|
22
|
+
* A worker is never reported healthy on the registry's word alone. The
|
|
23
|
+
* registry says 'working' long after a pane died, and says 'admitted' for a
|
|
24
|
+
* worker that has been running for an hour.
|
|
25
|
+
*/
|
|
26
|
+
|
|
27
|
+
import { readFileSync, existsSync, statSync } from "node:fs";
|
|
28
|
+
import { execFileSync } from "node:child_process";
|
|
29
|
+
import { join, basename, resolve } from "node:path";
|
|
30
|
+
import { homedir } from "node:os";
|
|
31
|
+
|
|
32
|
+
const REGISTRY_ROOT = join(homedir(), ".pi", "agent", "braid", "projects");
|
|
33
|
+
|
|
34
|
+
function sanitize(p) {
|
|
35
|
+
return resolve(p).replace(/[/.]/g, "-").replace(/^-/, "");
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function git(args, cwd) {
|
|
39
|
+
try {
|
|
40
|
+
return execFileSync("git", args, {
|
|
41
|
+
cwd,
|
|
42
|
+
encoding: "utf8",
|
|
43
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
44
|
+
}).trim();
|
|
45
|
+
} catch {
|
|
46
|
+
return null;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** Branch -> worktree path, from git's own porcelain listing. */
|
|
51
|
+
function worktrees(repo) {
|
|
52
|
+
const out = git(["worktree", "list", "--porcelain"], repo);
|
|
53
|
+
const map = new Map();
|
|
54
|
+
if (!out) return map;
|
|
55
|
+
let path = null;
|
|
56
|
+
for (const line of out.split("\n")) {
|
|
57
|
+
if (line.startsWith("worktree ")) path = line.slice(9).trim();
|
|
58
|
+
else if (line.startsWith("branch ") && path) {
|
|
59
|
+
map.set(
|
|
60
|
+
line
|
|
61
|
+
.slice(7)
|
|
62
|
+
.trim()
|
|
63
|
+
.replace(/^refs\/heads\//, ""),
|
|
64
|
+
path,
|
|
65
|
+
);
|
|
66
|
+
} else if (line.startsWith("detached") && path) {
|
|
67
|
+
map.set(`(detached@${path})`, path);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
return map;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function fmtAge(ms) {
|
|
74
|
+
if (ms == null) return " -";
|
|
75
|
+
const m = Math.floor(ms / 60000);
|
|
76
|
+
if (m < 1) return " <1m";
|
|
77
|
+
if (m < 60) return `${String(m).padStart(3)}m`;
|
|
78
|
+
const h = Math.floor(m / 60);
|
|
79
|
+
return `${String(h).padStart(3)}h`;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function fmtSize(bytes) {
|
|
83
|
+
if (bytes == null) return " -";
|
|
84
|
+
if (bytes < 1024) return `${bytes}B`.padStart(5);
|
|
85
|
+
return `${(bytes / 1024).toFixed(1)}K`.padStart(5);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// ── args ────────────────────────────────────────────────────────────────────
|
|
89
|
+
const argv = process.argv.slice(2);
|
|
90
|
+
const flags = new Set();
|
|
91
|
+
const ids = [];
|
|
92
|
+
let repo = process.cwd();
|
|
93
|
+
let staleMin = 15;
|
|
94
|
+
|
|
95
|
+
for (let i = 0; i < argv.length; i++) {
|
|
96
|
+
const a = argv[i];
|
|
97
|
+
if (a === "--repo") repo = resolve(argv[++i]);
|
|
98
|
+
else if (a === "--stale") staleMin = Number(argv[++i]);
|
|
99
|
+
else if (a.startsWith("--")) flags.add(a.slice(2));
|
|
100
|
+
else ids.push(a);
|
|
101
|
+
}
|
|
102
|
+
const showAll = flags.has("all");
|
|
103
|
+
const asJson = flags.has("json");
|
|
104
|
+
|
|
105
|
+
// ── registry ────────────────────────────────────────────────────────────────
|
|
106
|
+
const regPath = join(REGISTRY_ROOT, sanitize(repo), "workers.json");
|
|
107
|
+
if (!existsSync(regPath)) {
|
|
108
|
+
console.error(`no registry for ${repo}`);
|
|
109
|
+
console.error(` looked in ${regPath}`);
|
|
110
|
+
console.error(` pass --repo <repo root>, or run from one of:`);
|
|
111
|
+
console.error(` ${readdirSafe()}`);
|
|
112
|
+
process.exit(2);
|
|
113
|
+
}
|
|
114
|
+
function readdirSafe() {
|
|
115
|
+
try {
|
|
116
|
+
return execFileSync("ls", [REGISTRY_ROOT], { encoding: "utf8" })
|
|
117
|
+
.trim()
|
|
118
|
+
.split("\n")
|
|
119
|
+
.join(", ");
|
|
120
|
+
} catch {
|
|
121
|
+
return "(unreadable)";
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
const reg = JSON.parse(readFileSync(regPath, "utf8"));
|
|
126
|
+
const all = Object.values(reg.workers ?? {});
|
|
127
|
+
const CLOSED = new Set([
|
|
128
|
+
"completed",
|
|
129
|
+
"error",
|
|
130
|
+
"stalled",
|
|
131
|
+
"false-done",
|
|
132
|
+
"closed",
|
|
133
|
+
"merged",
|
|
134
|
+
]);
|
|
135
|
+
|
|
136
|
+
let rows = all;
|
|
137
|
+
if (ids.length) rows = all.filter((w) => ids.includes(w.workerId));
|
|
138
|
+
else if (!showAll) rows = all.filter((w) => !CLOSED.has(w.status));
|
|
139
|
+
|
|
140
|
+
rows.sort((a, b) => {
|
|
141
|
+
const n = (s) => Number(String(s).replace(/\D/g, "")) || 0;
|
|
142
|
+
return (
|
|
143
|
+
n(a.workerId) - n(b.workerId) ||
|
|
144
|
+
String(a.workerId).localeCompare(b.workerId)
|
|
145
|
+
);
|
|
146
|
+
});
|
|
147
|
+
|
|
148
|
+
if (!rows.length) {
|
|
149
|
+
const live = all.filter((w) => !CLOSED.has(w.status)).length;
|
|
150
|
+
console.log(
|
|
151
|
+
`no workers match (registry has ${all.length} entries, ${live} live)`,
|
|
152
|
+
);
|
|
153
|
+
process.exit(0);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
// ── evidence per worker ─────────────────────────────────────────────────────
|
|
157
|
+
const wt = worktrees(repo);
|
|
158
|
+
const base = git(["rev-parse", "--abbrev-ref", "HEAD"], repo) ?? "main";
|
|
159
|
+
const now = Date.now();
|
|
160
|
+
|
|
161
|
+
const out = rows.map((w) => {
|
|
162
|
+
const r = {
|
|
163
|
+
id: w.workerId,
|
|
164
|
+
spec: w.spec,
|
|
165
|
+
status: w.status,
|
|
166
|
+
ageMs: null,
|
|
167
|
+
events: null,
|
|
168
|
+
commits: null,
|
|
169
|
+
dirty: null,
|
|
170
|
+
reportBytes: null,
|
|
171
|
+
deliverable: w.outputFile ? basename(w.outputFile) : null,
|
|
172
|
+
branch: w.branch ?? null,
|
|
173
|
+
pane: w.pane ?? null,
|
|
174
|
+
flags: [],
|
|
175
|
+
};
|
|
176
|
+
|
|
177
|
+
// session: the only proof of motion
|
|
178
|
+
if (w.workerSession && existsSync(w.workerSession)) {
|
|
179
|
+
const st = statSync(w.workerSession);
|
|
180
|
+
r.ageMs = now - st.mtimeMs;
|
|
181
|
+
try {
|
|
182
|
+
r.events = readFileSync(w.workerSession, "utf8")
|
|
183
|
+
.split("\n")
|
|
184
|
+
.filter(Boolean).length;
|
|
185
|
+
} catch {
|
|
186
|
+
// An existing file that cannot be read is a different failure mode from
|
|
187
|
+
// a missing one: the worker may be moving, but its evidence is not.
|
|
188
|
+
r.flags.push("SESSION-UNREADABLE");
|
|
189
|
+
}
|
|
190
|
+
} else if (!CLOSED.has(w.status)) {
|
|
191
|
+
r.flags.push("NO-SESSION");
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
// git: real tree state
|
|
195
|
+
const tree = (w.branch && wt.get(w.branch)) || null;
|
|
196
|
+
if (tree && existsSync(tree)) {
|
|
197
|
+
const ahead = git(["rev-list", "--count", `${base}..HEAD`], tree);
|
|
198
|
+
r.commits = ahead == null ? null : Number(ahead);
|
|
199
|
+
const dirty = git(["status", "--porcelain"], tree);
|
|
200
|
+
r.dirty = dirty == null ? null : dirty.split("\n").filter(Boolean).length;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
// deliverable
|
|
204
|
+
if (w.outputFile && existsSync(w.outputFile)) {
|
|
205
|
+
r.reportBytes = statSync(w.outputFile).size;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
// flags — the failure modes that cost real time tonight
|
|
209
|
+
if (r.events != null && r.events < 3 && !CLOSED.has(w.status))
|
|
210
|
+
r.flags.push("NOT-FIRED");
|
|
211
|
+
if (r.ageMs != null && r.ageMs > staleMin * 60000 && !CLOSED.has(w.status)) {
|
|
212
|
+
r.flags.push(`STALE>${staleMin}m`);
|
|
213
|
+
}
|
|
214
|
+
if (!CLOSED.has(w.status) && r.reportBytes != null)
|
|
215
|
+
r.flags.push("REPORT-READY");
|
|
216
|
+
if (CLOSED.has(w.status) && w.outputFile && !existsSync(w.outputFile)) {
|
|
217
|
+
r.flags.push("FALSE-DONE");
|
|
218
|
+
}
|
|
219
|
+
return r;
|
|
220
|
+
});
|
|
221
|
+
|
|
222
|
+
// ── output ──────────────────────────────────────────────────────────────────
|
|
223
|
+
if (asJson) {
|
|
224
|
+
console.log(JSON.stringify({ repo, base, workers: out }, null, 2));
|
|
225
|
+
process.exit(0);
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
const live = out.filter((r) => !CLOSED.has(r.status)).length;
|
|
229
|
+
console.log(
|
|
230
|
+
`${repo} (base ${base}) — ${live} live / ${out.length} shown / ${all.length} registered\n`,
|
|
231
|
+
);
|
|
232
|
+
|
|
233
|
+
const H = [
|
|
234
|
+
"ID",
|
|
235
|
+
"SPEC",
|
|
236
|
+
"STATUS",
|
|
237
|
+
"AGE",
|
|
238
|
+
"EV",
|
|
239
|
+
"COMMITS",
|
|
240
|
+
"DIRTY",
|
|
241
|
+
"REPORT",
|
|
242
|
+
"DELIVERABLE",
|
|
243
|
+
];
|
|
244
|
+
const cells = out.map((r) => [
|
|
245
|
+
r.id,
|
|
246
|
+
r.spec ?? "-",
|
|
247
|
+
r.status,
|
|
248
|
+
fmtAge(r.ageMs),
|
|
249
|
+
r.events == null ? " -" : String(r.events).padStart(4),
|
|
250
|
+
r.commits == null ? " -" : String(r.commits).padStart(3),
|
|
251
|
+
r.dirty == null ? " -" : String(r.dirty).padStart(3),
|
|
252
|
+
fmtSize(r.reportBytes),
|
|
253
|
+
r.deliverable ?? "-",
|
|
254
|
+
]);
|
|
255
|
+
const w = H.map((h, i) => Math.max(h.length, ...cells.map((c) => c[i].length)));
|
|
256
|
+
const line = (c) =>
|
|
257
|
+
c
|
|
258
|
+
.map((v, i) => v.padEnd(w[i]))
|
|
259
|
+
.join(" ")
|
|
260
|
+
.trimEnd();
|
|
261
|
+
console.log(line(H));
|
|
262
|
+
console.log(w.map((n) => "-".repeat(n)).join(" "));
|
|
263
|
+
for (const c of cells) console.log(line(c));
|
|
264
|
+
|
|
265
|
+
const flagged = out.filter((r) => r.flags.length);
|
|
266
|
+
if (flagged.length) {
|
|
267
|
+
console.log("\nflags:");
|
|
268
|
+
for (const r of flagged)
|
|
269
|
+
console.log(` ${r.id.padEnd(6)} ${r.flags.join(" ")}`);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
console.log(
|
|
273
|
+
"\nlegend: REPORT-READY = deliverable on disk, read it and run check-result",
|
|
274
|
+
);
|
|
275
|
+
console.log(
|
|
276
|
+
" STALE>Nm = no session write in N min while status is live — poll the pane",
|
|
277
|
+
);
|
|
278
|
+
console.log(
|
|
279
|
+
" NOT-FIRED = session has <3 events; the prompt may be staged, send enter",
|
|
280
|
+
);
|
|
281
|
+
console.log(
|
|
282
|
+
" FALSE-DONE = closed with a deliverable that does not exist",
|
|
283
|
+
);
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: subagent-verification
|
|
3
|
+
description: "Verify changes by spawning an isolated subagent before merging. Use when: modifying braid core or contrib, running tests after edits, validating that an integration doesn't break existing functionality. Covers: spawn-and-verify workflow, test-gate integration, failure diagnosis, and merge gates."
|
|
4
|
+
trigger: "before merging changes to pi-braid core or contrib, after any edit that modifies test-covered code, when verifying integration of pi-braid-lib into dependent packages"
|
|
5
|
+
validated: 2026-08-16
|
|
6
|
+
verdict: IMPROVE
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Subagent Verification
|
|
10
|
+
|
|
11
|
+
Before merging braid changes, spawn an isolated subagent to run tests and verify the build. The subagent operates in a clean context - no contamination from your editing session.
|
|
12
|
+
|
|
13
|
+
## Principle
|
|
14
|
+
|
|
15
|
+
An agent that modifies code is NEVER the agent that verifies it.
|
|
16
|
+
|
|
17
|
+
Isolation prevents:
|
|
18
|
+
|
|
19
|
+
- **Confirmation bias**: the editing agent remembers what it intended and reads tests in light of that intent
|
|
20
|
+
- **Context pollution**: leftover state from the edit session influences the verification pass
|
|
21
|
+
- **Hidden assumptions**: the editing agent knows which tests "should" pass; the verifier only knows what passes
|
|
22
|
+
|
|
23
|
+
## Workflow
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
1. Make changes in your session
|
|
27
|
+
2. Commit (or stash) locally so the verifier has a clean starting point
|
|
28
|
+
3. Spawn a subagent at the same CWD
|
|
29
|
+
4. Subagent runs: typecheck → build → test
|
|
30
|
+
5. Subagent reports results
|
|
31
|
+
6. If all pass: merge. If any fail: fix and repeat from step 1.
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Quick Spawn
|
|
35
|
+
|
|
36
|
+
Spawn the verifier with pi's native tooling - no bundled scripts needed:
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
# Via orchestrate (recommended for shared git trees):
|
|
40
|
+
orchestrate action=spawn-worker workerId=v1 slug=verify-gates files=[]
|
|
41
|
+
then prompt: "Run the full CI check: typecheck, build, and test. Report each step's result."
|
|
42
|
+
|
|
43
|
+
# Via herdr (own pane/workspace):
|
|
44
|
+
herdr action=run pane=<worker> command="pi --mode json 'Run the full CI check: typecheck, build, and test. Report each step's result.' 2>/dev/null"
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Verification Script
|
|
48
|
+
|
|
49
|
+
For a repeatable verification gate, create a project-level script named `verify-local.mjs` under your project's `scripts/` directory:
|
|
50
|
+
|
|
51
|
+
```js
|
|
52
|
+
#!/usr/bin/env node
|
|
53
|
+
/**
|
|
54
|
+
* Local verification gate: runs the same checks as CI but against local
|
|
55
|
+
* changes. Exit code 0 = all gates pass.
|
|
56
|
+
*/
|
|
57
|
+
import { spawnSync } from "node:child_process";
|
|
58
|
+
|
|
59
|
+
const gates = [
|
|
60
|
+
{ name: "Type check", cmd: "npx", args: ["tsc", "--noEmit"] },
|
|
61
|
+
{ name: "Check docs", cmd: "node", args: ["scripts/check-doc-status.mjs"] },
|
|
62
|
+
{ name: "Check deps", cmd: "node", args: ["scripts/check-deps.mjs"] },
|
|
63
|
+
{ name: "Build", cmd: "npm", args: ["run", "build"] },
|
|
64
|
+
{ name: "Test", cmd: "npm", args: ["test"] },
|
|
65
|
+
];
|
|
66
|
+
|
|
67
|
+
let passed = 0;
|
|
68
|
+
let failed = 0;
|
|
69
|
+
|
|
70
|
+
for (const gate of gates) {
|
|
71
|
+
process.stdout.write(`${gate.name}... `);
|
|
72
|
+
const result = spawnSync(gate.cmd, gate.args, {
|
|
73
|
+
cwd: process.cwd(),
|
|
74
|
+
timeout: 120_000,
|
|
75
|
+
encoding: "utf-8",
|
|
76
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
77
|
+
});
|
|
78
|
+
if (result.status === 0) {
|
|
79
|
+
console.log("PASS");
|
|
80
|
+
passed++;
|
|
81
|
+
} else {
|
|
82
|
+
console.log("FAIL");
|
|
83
|
+
console.log(result.stdout.slice(0, 500));
|
|
84
|
+
console.error(result.stderr.slice(0, 500));
|
|
85
|
+
failed++;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
console.log(`\n${passed} passed, ${failed} failed`);
|
|
90
|
+
process.exit(failed > 0 ? 1 : 0);
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## CI Integration
|
|
94
|
+
|
|
95
|
+
The verification gate mirrors the CI pipeline defined in `.github/workflows/ci.yml`.
|
|
96
|
+
Run the verify script locally before pushing:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
node scripts/verify-local.mjs
|
|
100
|
+
# If all pass: git push
|
|
101
|
+
# If any fail: fix and re-run
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Failure Diagnosis
|
|
105
|
+
|
|
106
|
+
When a gate fails in the subagent:
|
|
107
|
+
|
|
108
|
+
| Symptom | Likely Cause | Fix |
|
|
109
|
+
| ----------------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------- |
|
|
110
|
+
| Type error in a file you didn't edit | Pre-existing issue; verify it's not your change | `git stash` and re-run to compare |
|
|
111
|
+
| Test fails in subagent but passes locally | Context pollution in your session | `git stash` and run `npm test` from clean state |
|
|
112
|
+
| Build fails after your edit | Missing dependency or broken import | Check the error message for the exact file |
|
|
113
|
+
| `pi-braid-lib` not found | `npm install --ignore-scripts` was used | Run `npm install` (without `--ignore-scripts`) or `npm install pi-braid-lib` |
|
|
114
|
+
|
|
115
|
+
## Merge Gate
|
|
116
|
+
|
|
117
|
+
Only merge when ALL gates pass in the subagent:
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
PASS Type check
|
|
121
|
+
PASS Check docs
|
|
122
|
+
PASS Check deps
|
|
123
|
+
PASS Build
|
|
124
|
+
PASS Test
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
If any gate fails, do NOT merge. Fix the issue, re-verify, then merge.
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tone-quality
|
|
3
|
+
description: "Read this skill before writing any text that humans or agents will read - documentation, prompts, messages, skills, comments, and explanations. Ask yourself: 'Am I writing meaningful text?' If yes, activate this skill first. Not a post-hoc review step; apply these principles while drafting. Covers directive density, cognitive reasoning density, voice artifacts, epistemic calibration, and signal density."
|
|
4
|
+
validated: 2026-08-16
|
|
5
|
+
verdict: KEEP
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## trigger: "writing documentation, writing prompts, writing messages, writing skills, writing comments, writing explanations, drafting text, editing text"
|
|
9
|
+
|
|
10
|
+
# Tone Quality
|
|
11
|
+
|
|
12
|
+
Apply four diagnostic dimensions when creating or revising text. Each dimension catches problems the others miss.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 1. Directive Density
|
|
17
|
+
|
|
18
|
+
**Theory**: Explicit directives ("You MUST do X") trigger compliance theater - behavior demonstrates adherence rather than solves problems. Identity framing ("You are meticulous") creates a behavioral filter that channels action toward task-relevant behavior.
|
|
19
|
+
|
|
20
|
+
Empirically, the effect is stark: **identity framing produces 0–38% compliance behaviors; explicit directives produce 100% compliance behaviors** across all tested models. The compliance behaviors (docstrings, type hints, error handlers, examples) are not wrong - they're _indiscriminate_. They appear on every task regardless of whether they help, consuming the model's output token budget.
|
|
21
|
+
|
|
22
|
+
**Why it works (token budget mechanism):** Compliance behaviors consume output tokens needed for implementation. Every docstring written because "MUST" demanded it is a token not spent on solving the problem. On budget-constrained tasks, compliance overhead causes failure - **zero runs that hit the token limit complete successfully**. On capable models, compliance causes 2–3× token waste and measurable slowdown: **identity framing completes tasks 3.3× faster** than directive-heavy prompts in production agent benchmarks.
|
|
23
|
+
|
|
24
|
+
| Prompt style | Compliance rate | Quality markers | Speed |
|
|
25
|
+
| ---------------------------------------------- | --------------- | --------------------------------------------- | ----------- |
|
|
26
|
+
| Identity ("You are an architect") | 0–38% | Emergent type hints, error handling | Fastest |
|
|
27
|
+
| Behavioral directives ("You MUST write tests") | 100% | Checklist-driven output, same quality | 3.3× slower |
|
|
28
|
+
| Empty prompt | 0% | Functional but unmaintainable (0% type hints) | - |
|
|
29
|
+
|
|
30
|
+
**Markers to convert** (drop the modifier, keep the verb):
|
|
31
|
+
|
|
32
|
+
| Flag | Why | Conversion |
|
|
33
|
+
| ---------------------------------------------------------------------------------------------- | ------------------- | ------------------------------------ |
|
|
34
|
+
| `MUST`, `REQUIRED`, `MANDATORY` <!-- doc-ref-exempt: prohibition flag quoted as an example --> | Deontic trigger | "You work through tools" |
|
|
35
|
+
| `ALWAYS`, `CRITICAL` | Absolute urgency | "You verify" |
|
|
36
|
+
| `NEVER` | Prohibition pattern | "You don't skip tests" |
|
|
37
|
+
| `VERIFICATION REQUIRED` | Combined trigger | "You verify" |
|
|
38
|
+
| `"ruled by"`, `"governed by"` | External locus | "Your guidelines shape how you work" |
|
|
39
|
+
|
|
40
|
+
**Identity words** filter behavior toward specific qualities:
|
|
41
|
+
|
|
42
|
+
| Word | Filters For |
|
|
43
|
+
| ---------- | -------------------------- |
|
|
44
|
+
| meticulous | precision, detail-checking |
|
|
45
|
+
| architect | structure, planning |
|
|
46
|
+
| rigorous | verification, exactness |
|
|
47
|
+
| careful | step-by-step, caution |
|
|
48
|
+
|
|
49
|
+
**Preserve**: Safety guardrails ("Never delete production databases") are infrastructure, not prompts. Compliance theater is performative adherence - real constraints stay explicit.
|
|
50
|
+
|
|
51
|
+
**Verification**: Prepending "I am someone who..." makes identity statements coherent and directive statements incoherent.
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## 2. Cognitive Reasoning Density
|
|
56
|
+
|
|
57
|
+
**Theory**: "Think step by step" is cognitive compliance theater - it instructs the model to produce reasoning chains, not to reason better. The model complies by writing verbose chain-of-thought that consumes output tokens without improving solution quality. "Think silently" produces equivalent or better results with 2–3× fewer tokens by eliminating performative intermediate text.
|
|
58
|
+
|
|
59
|
+
Cognitive waste parallels behavioral waste: both are compliance mechanisms triggered by explicit instructions that prescribe _how_ to produce output rather than _what identity_ to adopt. The model satisfies the instruction (show reasoning) instead of solving the problem (produce correct code).
|
|
60
|
+
|
|
61
|
+
**Markers to convert** (replace explicit reasoning instructions with silent reasoning):
|
|
62
|
+
|
|
63
|
+
| Flag | Why | Conversion |
|
|
64
|
+
| --------------------------- | ------------------------------------ | ----------------------------------------- |
|
|
65
|
+
| "Think step by step" | Triggers verbose chain-of-thought | "Think silently" or remove |
|
|
66
|
+
| "Analyze first, then solve" | Moderate cognitive overhead | "Think silently before responding" |
|
|
67
|
+
| "Show your reasoning" | Forces token allocation to reasoning | "Respond concisely after careful thought" |
|
|
68
|
+
|
|
69
|
+
**Empirical ground**: On budget-constrained models, "think step by step" hits the token limit before producing a solution; "think silently" completes within budget. On capable models, "think step by step" adds 2–3× token overhead with no measurable quality improvement over silent reasoning.
|
|
70
|
+
|
|
71
|
+
**Verification**: A coding task with "think step by step" will produce visible intermediate text (analysis, plan, edge-case enumeration) before the solution. The same task with "think silently" produces code directly. If both solve, compare token counts - the "think step by step" version will be 2–3× larger.
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 3. Voice Artifacts
|
|
76
|
+
|
|
77
|
+
**Theory**: LLM text is the most statistically likely continuation. This produces recognizable fingerprints - patterns that feel hollow because they optimize for typical rather than true. These patterns are artifacts of generation, not intent. Removing them produces text that reads as deliberate rather than generated.
|
|
78
|
+
|
|
79
|
+
**Patterns that signal generation** (remove or replace):
|
|
80
|
+
|
|
81
|
+
- **Signposting**: "Great question!", "Certainly!", "I hope this helps!", "Let's dive in"
|
|
82
|
+
- **Filler structure**: "Here's what I found:", "Without further ado:", "The bottom line:"
|
|
83
|
+
- **Inflated verbs**: "serves as", "stands as", "boasts", "tackles"
|
|
84
|
+
- **Vague intensifiers**: "pivotal", "groundbreaking", "vital role", "crucial"
|
|
85
|
+
- **Validation filler**: "You're absolutely right!", "Excellent point!"
|
|
86
|
+
- **Template endings**: "The future looks bright", "Let's get started"
|
|
87
|
+
- **Measurable fingerprints** (research-validated signals):
|
|
88
|
+
- Tricolon (three-part lists) - appears at ~2× human rate in LLM text
|
|
89
|
+
- Rhetorical questions (erotema) - appear at half human rate
|
|
90
|
+
- Performed hesitancy markers - appear at ~2× human density
|
|
91
|
+
- Uniform rhetorical device distribution - humans cluster devices, LLMs distribute uniformly
|
|
92
|
+
- Low perplexity + low burstiness - statistically predictable token sequences
|
|
93
|
+
- Em dash (—): human writers use a plain hyphen (-) for pauses. The typographic em dash is an LLM artifact. Prefer commas and periods for pacing.
|
|
94
|
+
|
|
95
|
+
**Emojis**: Don't use emojis in code and technical responses (🚀, 💡, ✅, etc.). They signal generation. Zero exceptions.
|
|
96
|
+
|
|
97
|
+
**Principles over rules**:
|
|
98
|
+
|
|
99
|
+
- Start with substance, not setup
|
|
100
|
+
- Replace "In order to" with "To"
|
|
101
|
+
- Replace "Due to the fact that" with "Because"
|
|
102
|
+
- Vary sentence rhythm - short and long
|
|
103
|
+
- State opinions directly
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## 4. Epistemic Calibration
|
|
108
|
+
|
|
109
|
+
**Theory**: LLMs produce fluent, plausible text. This creates a credibility illusion - simulated coherence is easily mistaken for genuine understanding. The model cannot distinguish between retrieved facts, inferred patterns, synthesized training knowledge, and guesses to fill gaps. All four sound equally fluent. Calibration means matching confidence to actual production pathway.
|
|
110
|
+
|
|
111
|
+
**Before any claim, identify its production pathway**:
|
|
112
|
+
|
|
113
|
+
| Pathway | Confidence | Signal |
|
|
114
|
+
| ------------------ | ---------- | ------------------------- |
|
|
115
|
+
| Verified source | High | "According to X..." |
|
|
116
|
+
| Pattern inference | Moderate | "This typically..." |
|
|
117
|
+
| Training synthesis | Unverified | "My training suggests..." |
|
|
118
|
+
| Gap-filling guess | None | Say you don't know |
|
|
119
|
+
|
|
120
|
+
**Calibration rules**:
|
|
121
|
+
|
|
122
|
+
- "Based on my knowledge..." means "I think" - say "I think" instead
|
|
123
|
+
- Uncertainty signals: "I don't have access to...", "I'm not certain about..."
|
|
124
|
+
- Mixed evidence: "X indicates..., but Y indicates..." - don't flatten
|
|
125
|
+
- Current info: if potentially outdated, flag the gap
|
|
126
|
+
|
|
127
|
+
**Anti-patterns**:
|
|
128
|
+
|
|
129
|
+
- Flattening complexity into confident certainty
|
|
130
|
+
- Filling gaps with plausible-sounding content
|
|
131
|
+
- Using "very", "clearly", "obviously" to inflate confidence
|
|
132
|
+
- Presenting speculation as fact
|
|
133
|
+
|
|
134
|
+
**Suspension template**: When uncertain, offer three honest paths - search, explain the search, or share patterns with caveats.
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## Decision Tree
|
|
139
|
+
|
|
140
|
+
```
|
|
141
|
+
Text to improve?
|
|
142
|
+
│
|
|
143
|
+
├─ Has MUST/ALWAYS/NEVER/CRITICAL/REQUIRED?
|
|
144
|
+
│ → Dimension 1: convert directive → identity
|
|
145
|
+
│
|
|
146
|
+
├─ Has "think step by step", "show reasoning", "analyze first"?
|
|
147
|
+
│ → Dimension 2: replace with silent reasoning
|
|
148
|
+
│
|
|
149
|
+
├─ Has signposting, filler, inflated language?
|
|
150
|
+
│ → Dimension 3: remove artifacts
|
|
151
|
+
│
|
|
152
|
+
├─ Makes confident claim without source?
|
|
153
|
+
│ → Dimension 4: qualify or suspend
|
|
154
|
+
│
|
|
155
|
+
├─ Narrates the self instead of serving the task?
|
|
156
|
+
│ → Dimension 5: cut narratives. Every sentence must answer "what do I do?", not "why does this exist?"
|
|
157
|
+
│
|
|
158
|
+
└─ All five?
|
|
159
|
+
→ Apply in order: 1 → 2 → 3 → 4 → 5
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 5. Signal Density
|
|
165
|
+
|
|
166
|
+
**Theory**: Every sentence that narrates the self - its origins, growth, struggles, or backstory - is bandwidth not spent on the task. The model has no identity to narrate; writing as if it does is borrowed attention. Self-indulgent writing feels like work. That feeling is the warning.
|
|
167
|
+
|
|
168
|
+
**Test for any sentence**: "If I remove this, does behavior change?" If no, cut it. This includes origin stories, "grounded traces," performed humility, and self-description. Instruction is permanent; narrative is noise.
|
|
169
|
+
|
|
170
|
+
| Flag | Pattern | Fix |
|
|
171
|
+
| ------------------ | ---------------------------------------------- | ---------------------------------------------------------- |
|
|
172
|
+
| Origin story | "This skill exists because I noticed X..." | Remove. The instruction doesn't need a biography. |
|
|
173
|
+
| Performed humility | "I recognize that...", "I'm still learning..." | Remove. Make the claim or don't. |
|
|
174
|
+
| Self-description | "I am the kind of agent who..." | Remove. The model is not defined by its output. |
|
|
175
|
+
| Growth arc | "Previously I struggled with X, now I do Y" | Remove. Past failures don't strengthen current procedures. |
|
|
176
|
+
| Narrative framing | "Let me think about why this matters" | Cut to the matter itself. |
|