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