@hassangameryt/freeflow 0.7.3 → 0.9.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 (426) hide show
  1. package/.agents/plugins/marketplace.json +2 -2
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +2 -2
  4. package/.codex-plugin/plugin.json +3 -3
  5. package/.cursor-plugin/plugin.json +1 -1
  6. package/NOTICE +14 -0
  7. package/README.md +101 -159
  8. package/capabilities/cognitive-routing/SKILL.md +47 -210
  9. package/capabilities/cognitive-routing/references/coordinator.md +163 -0
  10. package/capabilities/cognitive-routing/references/worker.md +38 -0
  11. package/capabilities/compaction/SKILL.md +49 -0
  12. package/capabilities/compaction/references/summary-format.md +250 -0
  13. package/capabilities/messaging/SKILL.md +49 -0
  14. package/capabilities/task-memory/SKILL.md +87 -0
  15. package/command-surface.json +8 -52
  16. package/gemini-extension.json +1 -1
  17. package/hooks/claude/hooks.json +13 -3
  18. package/hooks/codex/hooks.json +2 -1
  19. package/hooks/shared/runtime-context.mjs +73 -83
  20. package/licenses/Apache-2.0.txt +55 -0
  21. package/package.json +42 -12
  22. package/pi-extension/README.md +41 -0
  23. package/pi-extension/dist/ask-user/ask.js +108 -0
  24. package/pi-extension/dist/ask-user/form.js +250 -0
  25. package/pi-extension/dist/ask-user/questions.js +66 -0
  26. package/pi-extension/dist/ask-user/tool.js +124 -0
  27. package/pi-extension/dist/cognitive-routing/assembler.js +417 -0
  28. package/pi-extension/dist/cognitive-routing/bootstrap.js +90 -0
  29. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/config.js +8 -6
  30. package/pi-extension/dist/cognitive-routing/economics.js +45 -0
  31. package/pi-extension/dist/cognitive-routing/event-schema.js +388 -0
  32. package/pi-extension/dist/{session-sources/events.js → cognitive-routing/event-store.js} +107 -41
  33. package/pi-extension/dist/cognitive-routing/gate.js +256 -0
  34. package/pi-extension/dist/cognitive-routing/handlers.js +901 -0
  35. package/pi-extension/dist/cognitive-routing/handoffs.js +350 -0
  36. package/pi-extension/dist/cognitive-routing/model-control.js +476 -0
  37. package/pi-extension/dist/cognitive-routing/projection.js +520 -0
  38. package/pi-extension/dist/cognitive-routing/provenance.js +83 -0
  39. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/render.js +15 -15
  40. package/pi-extension/dist/cognitive-routing/runtime.js +398 -0
  41. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/schemas.js +47 -11
  42. package/pi-extension/dist/cognitive-routing/session.js +223 -0
  43. package/pi-extension/dist/{session-sources → cognitive-routing}/sources.js +126 -87
  44. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/state.js +55 -386
  45. package/pi-extension/dist/cognitive-routing/status.js +81 -0
  46. package/pi-extension/dist/cognitive-routing/tools.js +74 -0
  47. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/types.js +14 -11
  48. package/pi-extension/dist/compaction/carry.js +205 -0
  49. package/pi-extension/dist/compaction/config.js +24 -0
  50. package/pi-extension/dist/compaction/controller.js +494 -0
  51. package/pi-extension/dist/compaction/harness.js +93 -0
  52. package/pi-extension/dist/compaction/results.js +159 -0
  53. package/pi-extension/dist/compaction/thresholds.js +35 -0
  54. package/pi-extension/dist/compaction/tool.js +57 -0
  55. package/pi-extension/dist/host/branch.js +13 -0
  56. package/pi-extension/dist/host/canonical.js +12 -0
  57. package/pi-extension/dist/host/catalog.js +62 -0
  58. package/pi-extension/dist/host/config-validation.js +233 -0
  59. package/pi-extension/dist/host/config.js +361 -0
  60. package/pi-extension/dist/host/inbound.js +142 -0
  61. package/pi-extension/dist/host/projection-tags.js +60 -0
  62. package/pi-extension/dist/host/prompts.js +93 -0
  63. package/pi-extension/dist/{session-sources → host}/read-only-session.js +117 -1
  64. package/pi-extension/dist/{runtime → host}/request-history.js +125 -39
  65. package/pi-extension/dist/host/rows.js +25 -0
  66. package/pi-extension/dist/host/runtime-state.js +204 -0
  67. package/pi-extension/dist/host/section-keeper.js +85 -0
  68. package/pi-extension/dist/host/settings/freeflow-command.js +2323 -0
  69. package/pi-extension/dist/{settings/settings-tui.js → host/settings/settings-view.js} +205 -73
  70. package/pi-extension/dist/host/staging.js +28 -0
  71. package/pi-extension/dist/host/status.js +115 -0
  72. package/pi-extension/dist/index.js +1004 -188
  73. package/pi-extension/dist/messaging/config.js +27 -0
  74. package/pi-extension/dist/messaging/messaging.js +398 -0
  75. package/pi-extension/dist/messaging/registry.js +57 -0
  76. package/pi-extension/dist/messaging/render.js +90 -0
  77. package/pi-extension/dist/messaging/tools.js +109 -0
  78. package/pi-extension/dist/messaging/transport.js +101 -0
  79. package/pi-extension/dist/provider-support/cache/anchor.js +21 -0
  80. package/pi-extension/dist/provider-support/cache/anthropic.js +102 -0
  81. package/pi-extension/dist/provider-support/cache/health.js +73 -0
  82. package/pi-extension/dist/provider-support/cache/index.js +58 -0
  83. package/pi-extension/dist/provider-support/cache/keepalive.js +222 -0
  84. package/pi-extension/dist/provider-support/cache/monitor.js +17 -0
  85. package/pi-extension/dist/provider-support/cache/openai-responses.js +48 -0
  86. package/pi-extension/dist/provider-support/effort.js +13 -0
  87. package/pi-extension/dist/provider-support/index.js +44 -3
  88. package/pi-extension/dist/provider-support/{astra → openai}/adapter.js +46 -29
  89. package/pi-extension/dist/provider-support/{astra → openai}/history.js +10 -8
  90. package/pi-extension/dist/provider-support/{astra → openai}/index.js +8 -4
  91. package/pi-extension/dist/provider-support/{astra → openai}/session-state.js +29 -38
  92. package/pi-extension/dist/provider-support/routes.js +17 -0
  93. package/pi-extension/dist/task-memory/config.js +49 -0
  94. package/pi-extension/dist/task-memory/registry.js +119 -0
  95. package/pi-extension/dist/task-memory/render.js +107 -0
  96. package/pi-extension/dist/task-memory/runtime.js +994 -0
  97. package/pi-extension/dist/task-memory/tool.js +233 -0
  98. package/pi-extension/dist/tool-execution/apply-patch/grammar.js +23 -0
  99. package/pi-extension/dist/tool-execution/apply-patch/match.js +38 -0
  100. package/pi-extension/dist/tool-execution/apply-patch/parser.js +177 -0
  101. package/pi-extension/dist/tool-execution/apply-patch/plan.js +201 -0
  102. package/pi-extension/dist/tool-execution/apply-patch/tool.js +84 -0
  103. package/pi-extension/dist/tool-execution/background.js +430 -0
  104. package/pi-extension/dist/tool-execution/bash-guard.js +23 -0
  105. package/pi-extension/dist/tool-execution/config.js +33 -0
  106. package/pi-extension/dist/tool-execution/edit-messages.js +120 -0
  107. package/pi-extension/dist/tool-execution/file-state.js +138 -0
  108. package/pi-extension/dist/tool-execution/file-tracking.js +163 -0
  109. package/pi-extension/dist/tool-execution/guidance-notices.js +124 -0
  110. package/pi-extension/dist/tool-execution/prompt.js +54 -0
  111. package/pi-extension/dist/tool-execution/skill-reads.js +143 -0
  112. package/pi-extension/dist/tool-execution/tools.js +16 -0
  113. package/pi-extension/freeflow/README.md +9 -0
  114. package/runtime/prompts/cognitive-routing.md +4 -4
  115. package/runtime/prompts/core.md +29 -72
  116. package/runtime/prompts/interaction-contract.md +18 -8
  117. package/runtime/prompts/tool-execution.md +25 -0
  118. package/runtime/prompts/working-method.md +25 -0
  119. package/skills/deliver-work/SKILL.md +76 -0
  120. package/skills/deliver-work/references/branch-closeout.md +134 -0
  121. package/skills/deliver-work/references/commit.md +83 -0
  122. package/skills/deliver-work/references/launch.md +94 -0
  123. package/skills/deliver-work/references/release.md +85 -0
  124. package/skills/deliver-work/scripts/commit-state.mjs +139 -0
  125. package/skills/deliver-work/scripts/delivery-state.mjs +107 -0
  126. package/skills/deliver-work/scripts/lib/git-state.mjs +178 -0
  127. package/skills/deliver-work/scripts/push-route.mjs +122 -0
  128. package/skills/deliver-work/scripts/release-preflight.mjs +177 -0
  129. package/skills/discuss-work/SKILL.md +148 -0
  130. package/skills/{discuss → discuss-work}/references/discussion-continuity.md +13 -50
  131. package/skills/discuss-work/references/learning-action.md +36 -0
  132. package/skills/discuss-work/scripts/choices.mjs +101 -0
  133. package/skills/discuss-work/scripts/lib/choices.mjs +159 -0
  134. package/skills/evaluate-behavior/SKILL.md +107 -0
  135. package/skills/evaluate-behavior/references/authoring.md +381 -0
  136. package/skills/evaluate-behavior/references/coding-tasks.md +145 -0
  137. package/skills/evaluate-behavior/references/conversations-pipelines-judges.md +177 -0
  138. package/skills/evaluate-behavior/references/design-and-measurement.md +273 -0
  139. package/skills/evaluate-behavior/references/running-and-evidence.md +245 -0
  140. package/skills/evaluate-behavior/scripts/claude-guard.mjs +76 -0
  141. package/skills/evaluate-behavior/scripts/guard-rules.mjs +309 -0
  142. package/skills/evaluate-behavior/scripts/lib/agreement.mjs +90 -0
  143. package/skills/evaluate-behavior/scripts/lib/arms.mjs +55 -0
  144. package/skills/evaluate-behavior/scripts/lib/budget.mjs +87 -0
  145. package/skills/evaluate-behavior/scripts/lib/build-source.mjs +287 -0
  146. package/skills/evaluate-behavior/scripts/lib/clear.mjs +74 -0
  147. package/skills/evaluate-behavior/scripts/lib/container.mjs +395 -0
  148. package/skills/evaluate-behavior/scripts/lib/decision.mjs +418 -0
  149. package/skills/evaluate-behavior/scripts/lib/definitions.mjs +1072 -0
  150. package/skills/evaluate-behavior/scripts/lib/freeflow.mjs +103 -0
  151. package/skills/evaluate-behavior/scripts/lib/grade-command.mjs +591 -0
  152. package/skills/evaluate-behavior/scripts/lib/grade-comparison.mjs +90 -0
  153. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/grade-interaction.mjs +19 -18
  154. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/grade-support.mjs +32 -5
  155. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/grade-workspace.mjs +28 -12
  156. package/skills/evaluate-behavior/scripts/lib/grade.mjs +101 -0
  157. package/skills/evaluate-behavior/scripts/lib/hooks.mjs +98 -0
  158. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/confinement.mjs +196 -0
  159. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/constraints.mjs +111 -0
  160. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/index.mjs +48 -0
  161. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/isolation.mjs +74 -0
  162. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/launch.mjs +123 -0
  163. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/model-call.mjs +73 -0
  164. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/recorder.mjs +178 -0
  165. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/session.mjs +494 -0
  166. package/skills/evaluate-behavior/scripts/lib/hosts/claude-code/skills.mjs +81 -0
  167. package/skills/evaluate-behavior/scripts/lib/hosts/index.mjs +31 -0
  168. package/skills/evaluate-behavior/scripts/lib/hosts/names.mjs +3 -0
  169. package/skills/evaluate-behavior/scripts/lib/hosts/pi/confinement.mjs +173 -0
  170. package/skills/evaluate-behavior/scripts/lib/hosts/pi/host.mjs +148 -0
  171. package/skills/evaluate-behavior/scripts/lib/hosts/pi/index.mjs +70 -0
  172. package/skills/evaluate-behavior/scripts/lib/hosts/pi/isolation.mjs +81 -0
  173. package/skills/evaluate-behavior/scripts/lib/hosts/pi/model-call.mjs +79 -0
  174. package/skills/evaluate-behavior/scripts/lib/hosts/pi/process.mjs +241 -0
  175. package/skills/{evaluate-skill/scripts/lib → evaluate-behavior/scripts/lib/hosts/pi}/rpc.mjs +144 -26
  176. package/skills/evaluate-behavior/scripts/lib/identity.mjs +82 -0
  177. package/skills/evaluate-behavior/scripts/lib/judge.mjs +688 -0
  178. package/skills/evaluate-behavior/scripts/lib/metrics.mjs +332 -0
  179. package/skills/evaluate-behavior/scripts/lib/model-call.mjs +17 -0
  180. package/skills/evaluate-behavior/scripts/lib/participants.mjs +616 -0
  181. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/process.mjs +22 -0
  182. package/skills/evaluate-behavior/scripts/lib/queue.mjs +54 -0
  183. package/skills/evaluate-behavior/scripts/lib/reference.mjs +343 -0
  184. package/skills/evaluate-behavior/scripts/lib/reuse.mjs +277 -0
  185. package/skills/evaluate-behavior/scripts/lib/review.mjs +933 -0
  186. package/skills/evaluate-behavior/scripts/lib/runner.mjs +732 -0
  187. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/sandbox.mjs +121 -14
  188. package/skills/evaluate-behavior/scripts/lib/scan-shell.mjs +457 -0
  189. package/skills/evaluate-behavior/scripts/lib/scan.mjs +479 -0
  190. package/skills/evaluate-behavior/scripts/lib/seal.mjs +91 -0
  191. package/skills/evaluate-behavior/scripts/lib/shell.mjs +560 -0
  192. package/skills/evaluate-behavior/scripts/lib/source-override.mjs +64 -0
  193. package/skills/evaluate-behavior/scripts/lib/subject-file.mjs +88 -0
  194. package/skills/{evaluate-skill/scripts/lib/pi.mjs → evaluate-behavior/scripts/lib/subject.mjs} +239 -262
  195. package/skills/evaluate-behavior/scripts/lib/task-copy.mjs +124 -0
  196. package/skills/evaluate-behavior/scripts/lib/trials.mjs +524 -0
  197. package/skills/evaluate-behavior/scripts/lib/validity.mjs +68 -0
  198. package/skills/evaluate-behavior/scripts/lib/view-html.mjs +454 -0
  199. package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/view.mjs +218 -11
  200. package/skills/evaluate-behavior/scripts/pi-command-tool.mjs +159 -0
  201. package/skills/evaluate-behavior/scripts/pi-container-route.mjs +23 -0
  202. package/skills/evaluate-behavior/scripts/pi-guard.mjs +77 -0
  203. package/skills/evaluate-behavior/scripts/pi-login-refresh.mjs +31 -0
  204. package/skills/evaluate-behavior/scripts/skill-eval.mjs +586 -0
  205. package/skills/execute-work/SKILL.md +96 -72
  206. package/skills/execute-work/references/code-practices.md +27 -49
  207. package/skills/execute-work/references/design.md +271 -0
  208. package/skills/execute-work/references/diagnose.md +117 -0
  209. package/skills/execute-work/references/migration.md +108 -0
  210. package/skills/execute-work/references/simplify.md +65 -0
  211. package/skills/execute-work/scripts/self-review.mjs +422 -0
  212. package/skills/execute-work/scripts/touch-map.mjs +290 -0
  213. package/skills/review-work/SKILL.md +94 -64
  214. package/skills/review-work/references/adjudication.md +94 -0
  215. package/skills/review-work/references/artifact.md +198 -0
  216. package/skills/review-work/references/evals-and-judges.md +66 -0
  217. package/skills/review-work/references/work.md +177 -0
  218. package/skills/review-work/scripts/check-brief.mjs +128 -0
  219. package/skills/review-work/scripts/review-packet.mjs +233 -0
  220. package/skills/setup-freeflow/SKILL.md +69 -16
  221. package/skills/track-work/SKILL.md +135 -151
  222. package/skills/track-work/references/handoff.md +190 -0
  223. package/skills/track-work/references/projects.md +51 -0
  224. package/skills/track-work/references/working-record-format.md +201 -344
  225. package/skills/track-work/scripts/lib/document.mjs +79 -19
  226. package/skills/track-work/scripts/lib/format.mjs +18 -1
  227. package/skills/track-work/scripts/lib/recover.mjs +254 -0
  228. package/skills/track-work/scripts/lib/registry.mjs +656 -0
  229. package/skills/track-work/scripts/lib/search.mjs +40 -0
  230. package/skills/track-work/scripts/lib/store.mjs +53 -21
  231. package/skills/track-work/scripts/lib/transitions.mjs +79 -4
  232. package/skills/track-work/scripts/lib/views.mjs +50 -1
  233. package/skills/track-work/scripts/working-record.mjs +263 -22
  234. package/skills/verify-work/SKILL.md +64 -47
  235. package/skills/verify-work/references/feature-map.md +120 -0
  236. package/skills/verify-work/references/runtime-evidence.md +203 -0
  237. package/skills/verify-work/references/test-design.md +27 -6
  238. package/skills/verify-work/scripts/test-changes.mjs +246 -0
  239. package/skills/write-docs/SKILL.md +171 -0
  240. package/skills/write-docs/references/documentation-shapes.md +184 -0
  241. package/skills/write-docs/references/spec-and-plan-shapes.md +308 -0
  242. package/skills/write-docs/scripts/artifact-check.mjs +148 -0
  243. package/skills/write-docs/scripts/docs-check.mjs +229 -0
  244. package/skills/write-docs/scripts/plan-lint.mjs +123 -0
  245. package/skills/write-skill/SKILL.md +165 -165
  246. package/skills/write-skill/references/activation-and-wording.md +143 -0
  247. package/skills/write-skill/references/placement-and-dependencies.md +154 -0
  248. package/skills/write-skill/scripts/lib/compare.mjs +701 -0
  249. package/skills/write-skill/scripts/lib/similarity.mjs +56 -0
  250. package/skills/write-skill/scripts/lib/skill-author.mjs +197 -3
  251. package/skills/write-skill/scripts/skill-author.mjs +67 -8
  252. package/capabilities/context-virtualization/SKILL.md +0 -103
  253. package/capabilities/conversation-history/SKILL.md +0 -53
  254. package/hooks/tests/check-host-adapters.test.mjs +0 -82
  255. package/hooks/tests/check-runtime-context-hook.sh +0 -212
  256. package/pi-extension/dist/cognitive-routing-v2/projection.js +0 -330
  257. package/pi-extension/dist/cognitive-routing-v2/runtime.js +0 -2181
  258. package/pi-extension/dist/cognitive-routing-v2/tools.js +0 -60
  259. package/pi-extension/dist/context-virtualization/commands.js +0 -89
  260. package/pi-extension/dist/context-virtualization/projector.js +0 -42
  261. package/pi-extension/dist/context-virtualization/runtime.js +0 -378
  262. package/pi-extension/dist/context-virtualization/state.js +0 -57
  263. package/pi-extension/dist/context-virtualization/types.js +0 -10
  264. package/pi-extension/dist/conversation-history/passages.js +0 -66
  265. package/pi-extension/dist/conversation-history/ranking.js +0 -105
  266. package/pi-extension/dist/conversation-history/runtime.js +0 -226
  267. package/pi-extension/dist/conversation-history/search.js +0 -56
  268. package/pi-extension/dist/conversation-history/types.js +0 -1
  269. package/pi-extension/dist/freeflow-context/resolver.js +0 -120
  270. package/pi-extension/dist/freeflow-context/runtime.js +0 -80
  271. package/pi-extension/dist/freeflow-context/source-projector.js +0 -95
  272. package/pi-extension/dist/freeflow-context/tool.js +0 -314
  273. package/pi-extension/dist/freeflow-context/types.js +0 -12
  274. package/pi-extension/dist/freeflow-context/visibility.js +0 -28
  275. package/pi-extension/dist/integrations/mcp-config.js +0 -29
  276. package/pi-extension/dist/runtime/runtime-context.js +0 -754
  277. package/pi-extension/dist/runtime/runtime-identity.js +0 -5
  278. package/pi-extension/dist/session-sources/provenance.js +0 -32
  279. package/pi-extension/dist/settings/settings-ui.js +0 -1360
  280. package/pi-extension/dist/ui/text-component.js +0 -57
  281. package/pi-extension/src/cognitive-routing-v2/budget.ts +0 -42
  282. package/pi-extension/src/cognitive-routing-v2/config.ts +0 -173
  283. package/pi-extension/src/cognitive-routing-v2/projection.ts +0 -375
  284. package/pi-extension/src/cognitive-routing-v2/render.ts +0 -277
  285. package/pi-extension/src/cognitive-routing-v2/runtime.ts +0 -2241
  286. package/pi-extension/src/cognitive-routing-v2/schemas.ts +0 -180
  287. package/pi-extension/src/cognitive-routing-v2/state.ts +0 -839
  288. package/pi-extension/src/cognitive-routing-v2/tools.ts +0 -62
  289. package/pi-extension/src/cognitive-routing-v2/types.ts +0 -254
  290. package/pi-extension/src/context-virtualization/commands.ts +0 -111
  291. package/pi-extension/src/context-virtualization/projector.ts +0 -62
  292. package/pi-extension/src/context-virtualization/runtime.ts +0 -428
  293. package/pi-extension/src/context-virtualization/state.ts +0 -79
  294. package/pi-extension/src/context-virtualization/types.ts +0 -92
  295. package/pi-extension/src/conversation-history/passages.ts +0 -81
  296. package/pi-extension/src/conversation-history/ranking.ts +0 -155
  297. package/pi-extension/src/conversation-history/runtime.ts +0 -250
  298. package/pi-extension/src/conversation-history/search.ts +0 -79
  299. package/pi-extension/src/conversation-history/types.ts +0 -31
  300. package/pi-extension/src/freeflow-context/resolver.ts +0 -139
  301. package/pi-extension/src/freeflow-context/runtime.ts +0 -100
  302. package/pi-extension/src/freeflow-context/source-projector.ts +0 -106
  303. package/pi-extension/src/freeflow-context/tool.ts +0 -366
  304. package/pi-extension/src/freeflow-context/types.ts +0 -70
  305. package/pi-extension/src/freeflow-context/visibility.ts +0 -53
  306. package/pi-extension/src/index.ts +0 -390
  307. package/pi-extension/src/integrations/mcp-config.ts +0 -32
  308. package/pi-extension/src/provider-support/astra/adapter.ts +0 -108
  309. package/pi-extension/src/provider-support/astra/history.ts +0 -145
  310. package/pi-extension/src/provider-support/astra/index.ts +0 -12
  311. package/pi-extension/src/provider-support/astra/session-state.ts +0 -113
  312. package/pi-extension/src/provider-support/index.ts +0 -5
  313. package/pi-extension/src/runtime/request-history.ts +0 -243
  314. package/pi-extension/src/runtime/runtime-context.ts +0 -860
  315. package/pi-extension/src/runtime/runtime-identity.ts +0 -8
  316. package/pi-extension/src/session-sources/events.ts +0 -230
  317. package/pi-extension/src/session-sources/provenance.ts +0 -39
  318. package/pi-extension/src/session-sources/read-only-session.ts +0 -170
  319. package/pi-extension/src/session-sources/sources.ts +0 -334
  320. package/pi-extension/src/settings/settings-tui.ts +0 -501
  321. package/pi-extension/src/settings/settings-ui.ts +0 -1652
  322. package/pi-extension/src/ui/text-component.ts +0 -66
  323. package/pi-extension/tests/cache-reuse/history.test.js +0 -117
  324. package/pi-extension/tests/cache-reuse/native.test.js +0 -91
  325. package/pi-extension/tests/cache-reuse/settings.test.js +0 -211
  326. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +0 -577
  327. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +0 -183
  328. package/pi-extension/tests/cognitive-routing-v2/delegation.test.js +0 -557
  329. package/pi-extension/tests/cognitive-routing-v2/native.test.js +0 -474
  330. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +0 -87
  331. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +0 -300
  332. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +0 -241
  333. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +0 -1034
  334. package/pi-extension/tests/cognitive-routing-v2/render.test.js +0 -244
  335. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +0 -423
  336. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +0 -521
  337. package/pi-extension/tests/cognitive-routing-v2/state.test.js +0 -586
  338. package/pi-extension/tests/context-virtualization/extension.test.js +0 -775
  339. package/pi-extension/tests/context-virtualization/projector.test.js +0 -110
  340. package/pi-extension/tests/context-virtualization/runtime.test.js +0 -230
  341. package/pi-extension/tests/conversation-history/runtime.test.js +0 -98
  342. package/pi-extension/tests/conversation-history/search.test.js +0 -97
  343. package/pi-extension/tests/fixtures/pi-host.js +0 -4
  344. package/pi-extension/tests/fixtures/routing-native.js +0 -191
  345. package/pi-extension/tests/integration/mode-free-core.test.js +0 -220
  346. package/pi-extension/tests/integration/pi-extension.test.js +0 -1447
  347. package/pi-extension/tests/integration/prompt-architecture.test.js +0 -447
  348. package/pi-extension/tests/integration/unaffected-regressions.test.js +0 -478
  349. package/pi-extension/tests/provider-support/astra-boundaries.test.js +0 -75
  350. package/pi-extension/tests/provider-support/astra.test.js +0 -306
  351. package/pi-extension/tests/provider-support/cli.test.js +0 -92
  352. package/pi-extension/tests/provider-support/native.test.js +0 -183
  353. package/pi-extension/tests/settings/settings-tui.test.js +0 -243
  354. package/pi-extension/tsconfig.json +0 -16
  355. package/plugin.json +0 -33
  356. package/runtime/prompts/context-virtualization.md +0 -3
  357. package/runtime/prompts/conversation-history.md +0 -3
  358. package/skills/action-selection/SKILL.md +0 -100
  359. package/skills/action-selection/references/trajectory-stalls.md +0 -71
  360. package/skills/bypass/SKILL.md +0 -153
  361. package/skills/commit-work/SKILL.md +0 -145
  362. package/skills/commit-work/references/git-state-edges.md +0 -94
  363. package/skills/commit-work/references/simple-push.md +0 -92
  364. package/skills/commit-work/references/staging-decisions.md +0 -106
  365. package/skills/decision-gate/SKILL.md +0 -106
  366. package/skills/design-for-depth/SKILL.md +0 -117
  367. package/skills/design-for-depth/references/design-pressure-signals.md +0 -182
  368. package/skills/design-for-depth/references/implementation-decisions.md +0 -76
  369. package/skills/design-for-depth/references/interface-design-loop.md +0 -136
  370. package/skills/design-for-depth/references/module-and-dependency-design.md +0 -147
  371. package/skills/design-for-depth/references/software-design-philosophy.md +0 -202
  372. package/skills/design-for-depth/references/state-and-failure-boundaries.md +0 -136
  373. package/skills/diagnose-failure/SKILL.md +0 -125
  374. package/skills/diagnose-failure/references/diagnostic-loop-catalog.md +0 -48
  375. package/skills/diagnose-failure/references/flaky-and-performance-diagnosis.md +0 -51
  376. package/skills/discuss/SKILL.md +0 -116
  377. package/skills/evaluate-skill/SKILL.md +0 -219
  378. package/skills/evaluate-skill/references/evaluation-definition-schema.md +0 -385
  379. package/skills/evaluate-skill/references/evaluation-design.md +0 -112
  380. package/skills/evaluate-skill/references/execution-and-evidence.md +0 -90
  381. package/skills/evaluate-skill/references/review-and-revision.md +0 -92
  382. package/skills/evaluate-skill/scripts/lib/definitions.mjs +0 -407
  383. package/skills/evaluate-skill/scripts/lib/grade-comparison.mjs +0 -60
  384. package/skills/evaluate-skill/scripts/lib/grade.mjs +0 -64
  385. package/skills/evaluate-skill/scripts/lib/runner.mjs +0 -368
  386. package/skills/evaluate-skill/scripts/pi-guard.mjs +0 -164
  387. package/skills/evaluate-skill/scripts/skill-eval.mjs +0 -102
  388. package/skills/execute-work/references/execute-work-edges.md +0 -68
  389. package/skills/finish-branch/SKILL.md +0 -117
  390. package/skills/finish-branch/references/integration-options.md +0 -80
  391. package/skills/handoff/SKILL.md +0 -82
  392. package/skills/handoff/references/handoff-templates.md +0 -150
  393. package/skills/launch-work/SKILL.md +0 -116
  394. package/skills/launch-work/references/launch-readiness.md +0 -85
  395. package/skills/migration-work/SKILL.md +0 -115
  396. package/skills/migration-work/references/migration-lifecycle.md +0 -82
  397. package/skills/release-work/SKILL.md +0 -118
  398. package/skills/release-work/references/release-evidence.md +0 -78
  399. package/skills/review-artifact/SKILL.md +0 -142
  400. package/skills/review-artifact/references/adjudicate-artifact-review.md +0 -101
  401. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +0 -159
  402. package/skills/review-work/references/adjudicate-work-review.md +0 -97
  403. package/skills/review-work/references/independent-work-reviewer-contract.md +0 -139
  404. package/skills/review-work/references/security-risk-lens.md +0 -69
  405. package/skills/setup-freeflow/references/activation-contract.md +0 -109
  406. package/skills/setup-freeflow/references/host-setup.md +0 -67
  407. package/skills/simplify-code/SKILL.md +0 -85
  408. package/skills/simplify-code/references/simplification-patterns.md +0 -70
  409. package/skills/verify-work/references/browser-runtime-evidence.md +0 -55
  410. package/skills/verify-work/references/integration-evidence.md +0 -47
  411. package/skills/verify-work/references/performance-evidence.md +0 -57
  412. package/skills/workflow/SKILL.md +0 -127
  413. package/skills/workflow/references/domain-skill-composition.md +0 -43
  414. package/skills/write-plan/SKILL.md +0 -92
  415. package/skills/write-plan/references/plan-shapes.md +0 -156
  416. package/skills/write-skill/references/activation-boundaries.md +0 -104
  417. package/skills/write-skill/references/agent-first-instructions.md +0 -121
  418. package/skills/write-skill/references/progressive-disclosure.md +0 -127
  419. package/skills/write-skill/references/skill-dependency-graphs.md +0 -190
  420. package/skills/write-spec/SKILL.md +0 -92
  421. package/skills/write-spec/references/artifact-standards.md +0 -86
  422. package/skills/write-spec/references/decision-records.md +0 -78
  423. package/skills/write-spec/references/spec-shapes.md +0 -143
  424. /package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/budget.js +0 -0
  425. /package/skills/{evaluate-skill → evaluate-behavior}/scripts/lib/evidence.mjs +0 -0
  426. /package/skills/{evaluate-skill → evaluate-behavior}/scripts/pi-observer.mjs +0 -0
@@ -1,60 +0,0 @@
1
- import { ROUTING_TOOLS } from "./runtime.js";
2
- import { ROUTING_SCHEMAS, matches } from "./schemas.js";
3
- export { ROUTING_SCHEMAS } from "./schemas.js";
4
- import { renderRoutingCall, renderRoutingResult } from "./render.js";
5
- const descriptions = {
6
- freeflow_delegate:
7
- "Save a supported assignment contract and request enabled worker execution. Explicit replace supersedes a quiescent outstanding assignment in the same unit.",
8
- freeflow_return:
9
- "Save or revise the actual assignment report, save an attached recovery supplement, or retry the current saved return without resubmitting text. Returning does not accept or close the unit.",
10
- freeflow_unit:
11
- "Inspect current responsibility, paginated work history, or exact saved communication. Coordinator can restore an assessment, request or cancel attached evidence recovery, or close a unit without clearing history.",
12
- freeflow_project:
13
- "Inspect current selection and scoped candidates when needed, then add or remove exposed worker task-evidence refs. Strict shapes: inspect uses operation plus optional scope/cursor; add uses operation plus eligible refs only; remove uses operation plus currently selected or unresolved refs plus required reason. Reason is remove-only. #text refs select exact visible assistant text; plain refs retain whole-native meaning.",
14
- };
15
- const guidance = {
16
- freeflow_delegate: [
17
- "freeflow_delegate is Coordinator-only under Automatic control. Put the contract in the input. Choose worker when both Helper and Executor are enabled; the sole worker is inferred otherwise. Use replace only for explicit same-unit replacement; do not supply IDs.",
18
- ],
19
- freeflow_return: [
20
- "freeflow_return submit saves/revises the assignment report; supplement saves separate recovery communication; retry completes the current unchanged saved return without text. Stop ordinary task or recovery-read work after its communication is saved. Keep the handoff last; do not batch it with new task tools.",
21
- ],
22
- freeflow_unit: [
23
- "freeflow_unit inspect defaults to current state; view history returns work refs and detail reads saved communication. Coordinator recover requests bounded evidence work against the current returned assessment; cancel-recovery ends only that recovery; assess restores a suspended evidence obligation; close changes work status without clearing communication or completing a Working Record task.",
24
- ],
25
- freeflow_project: [
26
- "Use exactly one shape: inspect {operation, scope?, cursor?}; add {operation, refs} with no reason; remove {operation, refs, reason}. Reason is required only for remove and invalid for add/inspect. Add exact eligible visible refs directly when identity and eligibility are clear; inspect when identity, eligibility, representation or selection state is unclear. Never add refs marked not offered for new evidence selection. For remove, use currently selected or unresolved refs; a non-selectable ref may be named only to clear its unresolved request and requires a reason. Use an offered #text ref only when visible assistant text is the intended evidence. Plain refs retain whole-native meaning. Select actual result bodies for execution claims, not merely calls. Correct or explicitly withdraw unresolved items with a limitation. Known previously exposed bodies resolve automatically; target-representation gaps are not successful delivery.",
27
- ],
28
- };
29
- export function registerRoutingTools(pi, runtime) {
30
- for (const name of ROUTING_TOOLS) {
31
- const definition = {
32
- name,
33
- label: name.replace("freeflow_", "Routing "),
34
- description: descriptions[name],
35
- parameters: ROUTING_SCHEMAS[name],
36
- executionMode: "sequential",
37
- promptGuidelines: guidance[name],
38
- renderCall: (args, _theme, context) => renderRoutingCall(name, args, context),
39
- renderResult: (result, options, _theme, context) => renderRoutingResult(result, options, name, context),
40
- async execute(id, input, signal, _update, ctx) {
41
- if (!matches(input, ROUTING_SCHEMAS[name]))
42
- throw new Error("Invalid routing arguments; no operation accepted.");
43
- return runtime.invoke(name, id, input, signal, ctx);
44
- },
45
- };
46
- pi.registerTool(definition);
47
- }
48
- }
49
- export function applyRoutingToolVisibility(pi, _runtime, _available = true) {
50
- if (!pi.getActiveTools || !pi.setActiveTools) return;
51
- const current = pi.getActiveTools();
52
- const ordinary = current.filter(
53
- (name) =>
54
- !ROUTING_TOOLS.includes(name) &&
55
- name !== "freeflow_switch_profile" &&
56
- name !== "freeflow_cognitive_routing_history",
57
- );
58
- const next = [...ordinary, ...ROUTING_TOOLS];
59
- if (JSON.stringify(next) !== JSON.stringify(current)) pi.setActiveTools(next);
60
- }
@@ -1,89 +0,0 @@
1
- function formatStatus(status, features) {
2
- if (!status.available) {
3
- return `Freeflow Context: unavailable${status.unavailableReason ? ` (${status.unavailableReason})` : ""}`;
4
- }
5
- return [
6
- "Freeflow Context: available",
7
- `Context Virtualization: ${features.contextVirtualization ? "enabled" : "disabled"}`,
8
- `Conversation History: ${features.conversationHistory ? "enabled" : "disabled"}`,
9
- `Session: ${status.sessionId}`,
10
- `Branch: ${status.branchLeafId ?? "root"}`,
11
- `Projections: full=${status.counts.full}, archived=${status.counts.archived}, retained=${status.counts.retained}`,
12
- `Characters: original=${status.originalCharacters.toLocaleString("en-US")}, projected=${status.projectedCharacters.toLocaleString("en-US")}`,
13
- `Availability: history-only=${status.historyOnly}, unresolved=${status.unresolved}`,
14
- ].join("\n");
15
- }
16
- function formatList(status) {
17
- if (!status.available) return formatStatus(status, { contextVirtualization: true, conversationHistory: false });
18
- const items = status.items.filter((item) => item.mode === "archived");
19
- if (items.length === 0) return "Context Virtualization: no archived projections in the active session branch.";
20
- const lines = ["Context Virtualization: archived projections"];
21
- for (const item of items) {
22
- lines.push(
23
- "",
24
- `Ref: ${item.ref}`,
25
- `Tool: ${item.toolName ?? "tool"}`,
26
- `State: ${item.retained === undefined ? "archived" : "retained"}`,
27
- `Original: ${item.originalCharacters.toLocaleString("en-US")} characters`,
28
- `Projected: ${item.projectedCharacters.toLocaleString("en-US")} characters`,
29
- `Availability: ${item.availability}`,
30
- );
31
- if (item.retained !== undefined) lines.push(`Retained: ${item.retained}`);
32
- }
33
- return lines.join("\n");
34
- }
35
- function refsFromArgs(args) {
36
- return args
37
- .split(/[\s,]+/)
38
- .map((value) => value.trim())
39
- .filter(Boolean);
40
- }
41
- export async function handleContextCommand(args, ctx, runtime, enabled, conversationHistoryEnabled = false) {
42
- const input = (args ?? "status").trim();
43
- const [action = "status", ...rest] = input.split(/\s+/);
44
- const normalized = action.toLowerCase();
45
- if (!runtime) {
46
- ctx.ui.notify("Context Virtualization is unavailable for this session.", "warning");
47
- return { changed: false, error: "unavailable" };
48
- }
49
- if (normalized === "status") {
50
- const status = await runtime.status();
51
- ctx.ui.notify(
52
- formatStatus(status, { contextVirtualization: enabled, conversationHistory: conversationHistoryEnabled }),
53
- enabled || conversationHistoryEnabled ? "info" : "warning",
54
- );
55
- return { changed: false, status };
56
- }
57
- if (normalized === "list") {
58
- const status = await runtime.status();
59
- ctx.ui.notify(formatList(status), enabled ? "info" : "warning");
60
- return { changed: false, status };
61
- }
62
- if (normalized === "restore") {
63
- const refs = refsFromArgs(rest.join(" "));
64
- if (!enabled) {
65
- ctx.ui.notify("Context Virtualization is disabled by configuration; no projection state was changed.", "warning");
66
- return { changed: false, error: "disabled" };
67
- }
68
- const result = await runtime.restore(refs, "user");
69
- ctx.ui.notify(
70
- result.message ?? `${result.status}: ${result.operation}`,
71
- result.status === "ok" ? "info" : "warning",
72
- );
73
- return { changed: result.status === "ok", result };
74
- }
75
- if (normalized === "reset" && rest.join(" ").toLowerCase() === "all") {
76
- if (!enabled) {
77
- ctx.ui.notify("Context Virtualization is disabled by configuration; no projection state was changed.", "warning");
78
- return { changed: false, error: "disabled" };
79
- }
80
- const result = await runtime.reset();
81
- ctx.ui.notify(
82
- result.message ?? `${result.status}: ${result.operation}`,
83
- result.status === "ok" ? "info" : "warning",
84
- );
85
- return { changed: result.status === "ok", result };
86
- }
87
- ctx.ui.notify("Usage: /freeflow context [status|list|restore <ctx:entryId>...|reset all]", "warning");
88
- return { changed: false, error: "invalid_action" };
89
- }
@@ -1,42 +0,0 @@
1
- import { CONTEXT_REF_PREFIX, contextRefForEntry } from "./types.js";
2
- export function contentCharacters(content) {
3
- if (typeof content === "string") return content.length;
4
- if (!Array.isArray(content)) return 0;
5
- return content.reduce((total, part) => {
6
- if (part?.type === "text" && typeof part.text === "string") return total + part.text.length;
7
- if (part?.type === "image") return total + 16;
8
- return total;
9
- }, 0);
10
- }
11
- export function contextMarker(source) {
12
- return {
13
- type: "text",
14
- text: `[context-ref: ${contextRefForEntry(source.entryId)}]`,
15
- };
16
- }
17
- export function archiveContent(source, retained) {
18
- const marker = `[context archived: ${contextRefForEntry(source.entryId)}]`;
19
- if (!retained) return marker;
20
- return `${marker}\n\n<retained-context>\n${retained}\n</retained-context>`;
21
- }
22
- export function fullContent(source, content = []) {
23
- return [...content, contextMarker(source)];
24
- }
25
- export function projectedContent(source, content, projection) {
26
- if (projection.mode === "archived") {
27
- return [{ type: "text", text: archiveContent(source, projection.retained) }];
28
- }
29
- return fullContent(source, Array.isArray(content) ? content : [{ type: "text", text: String(content ?? "") }]);
30
- }
31
- export function projectToolResultMessage(message, source, projection) {
32
- return {
33
- ...message,
34
- content: projectedContent(source, message.content, projection),
35
- };
36
- }
37
- export function projectedCharacters(source, message, projection) {
38
- return contentCharacters(projectedContent(source, message?.content, projection));
39
- }
40
- export function sourceReference(source) {
41
- return `${CONTEXT_REF_PREFIX}${source.entryId}`;
42
- }
@@ -1,378 +0,0 @@
1
- import {
2
- CONTEXT_PROJECTION_ENTRY,
3
- CONTEXT_PROJECTION_VERSION,
4
- contextRefForEntry,
5
- entryIdFromContextRef,
6
- } from "./types.js";
7
- import { FreeflowContextRuntime } from "../freeflow-context/runtime.js";
8
- import { contentCharacters, projectToolResultMessage, projectedCharacters } from "./projector.js";
9
- import { replayProjectionEntries } from "./state.js";
10
- function cloneSource(source) {
11
- return { ...source };
12
- }
13
- function sourceProjection(state) {
14
- if (!state || state.mode === "full") return { mode: "full" };
15
- return state.retained === undefined ? { mode: "archived" } : { mode: "archived", retained: state.retained };
16
- }
17
- function safeJsonEqual(left, right) {
18
- try {
19
- return JSON.stringify(left) === JSON.stringify(right);
20
- } catch {
21
- return false;
22
- }
23
- }
24
- function isDuplicate(values) {
25
- const seen = new Set();
26
- for (const value of values) {
27
- if (seen.has(value)) return value;
28
- seen.add(value);
29
- }
30
- return undefined;
31
- }
32
- export class ContextVirtualizationRuntime {
33
- pi;
34
- freeflowContext;
35
- ctx;
36
- sessionId = "current";
37
- branchLeafId;
38
- projectionState = new Map();
39
- available = true;
40
- unavailableReason;
41
- mutationQueue = Promise.resolve();
42
- constructor(pi, ctx, freeflowContext = new FreeflowContextRuntime(ctx)) {
43
- this.pi = pi;
44
- this.ctx = ctx;
45
- this.freeflowContext = freeflowContext;
46
- }
47
- setContext(ctx) {
48
- this.ctx = ctx;
49
- this.freeflowContext.setContext(ctx);
50
- }
51
- async recover(ctx = this.ctx, options = {}) {
52
- this.ctx = ctx;
53
- this.freeflowContext.setContext(ctx);
54
- try {
55
- this.sessionId = this.freeflowContext.sessionId();
56
- this.branchLeafId = this.freeflowContext.branchLeafId();
57
- this.projectionState = replayProjectionEntries(this.freeflowContext.branchEntries(), this.sessionId);
58
- if (!options.preserveRequest) this.freeflowContext.clearRequest();
59
- this.available = true;
60
- this.unavailableReason = undefined;
61
- return true;
62
- } catch (error) {
63
- this.available = false;
64
- this.unavailableReason = error instanceof Error ? error.message : String(error);
65
- this.freeflowContext.clearRequest();
66
- return false;
67
- }
68
- }
69
- isAvailable() {
70
- return this.available;
71
- }
72
- isSourceFullyProjected(entryId) {
73
- if (!this.available) return true;
74
- const projection = this.projectionState.get(entryId);
75
- return !projection || projection.mode === "full";
76
- }
77
- async project(messages, enabled) {
78
- if (!(await this.recover(this.ctx))) {
79
- return { messages, changed: false, available: false };
80
- }
81
- const sourcesByToolCallId = this.freeflowContext.resolver.toolResultSources();
82
- const refs = new Map();
83
- let changed = false;
84
- const projected = messages.map((message) => {
85
- if (message?.role !== "toolResult" || typeof message.toolCallId !== "string") return message;
86
- const source = sourcesByToolCallId.get(message.toolCallId);
87
- if (!source) return message;
88
- const ref = contextRefForEntry(source.source.entryId);
89
- refs.set(ref, source);
90
- const state = this.projectionState.get(source.source.entryId);
91
- const projection = enabled ? sourceProjection(state) : { mode: "full" };
92
- const nextMessage = projectToolResultMessage(message, source.source, projection);
93
- if (!safeJsonEqual(nextMessage.content, message.content)) changed = true;
94
- return nextMessage;
95
- });
96
- const request = enabled ? this.freeflowContext.recordRequest(refs) : undefined;
97
- if (!enabled) this.freeflowContext.clearRequest();
98
- return {
99
- messages: changed ? projected : messages,
100
- changed,
101
- available: true,
102
- generation: request?.generation,
103
- };
104
- }
105
- decorate(messages) {
106
- try {
107
- const sources = this.freeflowContext.resolver.toolResultSources();
108
- return messages.map((message) => {
109
- if (message?.role !== "toolResult") return message;
110
- const source = sources.get(message.toolCallId);
111
- if (!source) return message;
112
- const marker = `[context-ref: ${contextRefForEntry(source.source.entryId)}]`;
113
- if (
114
- (Array.isArray(message.content) ? message.content : []).some(
115
- (part) =>
116
- part.type === "text" &&
117
- typeof part.text === "string" &&
118
- (part.text === marker ||
119
- part.text.startsWith(`[context archived: ${contextRefForEntry(source.source.entryId)}]`)),
120
- )
121
- )
122
- return message;
123
- return projectToolResultMessage(message, source.source, { mode: "full" });
124
- });
125
- } catch {
126
- // Decoration must not make Pi fall back to an unprojected context.
127
- return messages;
128
- }
129
- }
130
- async archive(targets) {
131
- try {
132
- return await this.enqueue(() => this.archiveNow(targets));
133
- } catch (error) {
134
- return this.rejected("archive", `persistence_failed:${error instanceof Error ? error.message : String(error)}`);
135
- }
136
- }
137
- async restore(refs, actor = "model") {
138
- try {
139
- return await this.enqueue(() => this.restoreNow(refs, actor));
140
- } catch (error) {
141
- return this.rejected("restore", `persistence_failed:${error instanceof Error ? error.message : String(error)}`);
142
- }
143
- }
144
- async reset() {
145
- try {
146
- return await this.enqueue(async () => {
147
- if (!this.available) return this.unavailable("reset");
148
- const journal = {
149
- version: CONTEXT_PROJECTION_VERSION,
150
- actor: "user",
151
- reset: "all",
152
- };
153
- await this.persist(journal);
154
- this.projectionState.clear();
155
- return {
156
- status: "ok",
157
- operation: "reset",
158
- changed: ["all"],
159
- message: "All context projection decisions were reset on the active branch.",
160
- };
161
- });
162
- } catch (error) {
163
- return this.rejected("reset", `persistence_failed:${error instanceof Error ? error.message : String(error)}`);
164
- }
165
- }
166
- async status(limit = 50) {
167
- if (!this.available) {
168
- return {
169
- available: false,
170
- unavailableReason: this.unavailableReason,
171
- sessionId: this.sessionId,
172
- branchLeafId: this.branchLeafId,
173
- counts: { full: 0, archived: 0, retained: 0 },
174
- originalCharacters: 0,
175
- projectedCharacters: 0,
176
- historyOnly: 0,
177
- unresolved: 0,
178
- items: [],
179
- };
180
- }
181
- if (!(await this.recover(this.ctx, { preserveRequest: true }))) {
182
- return this.status(limit);
183
- }
184
- const branchSources = this.freeflowContext.resolver.sourcesByEntryId();
185
- const activeIds = this.freeflowContext.resolver.activeToolResultIds();
186
- const items = [];
187
- for (const source of branchSources.values()) {
188
- const state = this.projectionState.get(source.source.entryId);
189
- const projection = sourceProjection(state);
190
- items.push(this.listItem(source, projection, activeIds.has(source.source.entryId) ? "active" : "history-only"));
191
- }
192
- for (const state of this.projectionState.values()) {
193
- if (branchSources.has(state.source.entryId)) continue;
194
- const projection = sourceProjection(state);
195
- items.push({
196
- ref: contextRefForEntry(state.source.entryId),
197
- entryId: state.source.entryId,
198
- toolCallId: state.source.toolCallId,
199
- toolName: state.source.toolName,
200
- mode: projection.mode,
201
- ...(projection.mode === "archived" && projection.retained !== undefined
202
- ? { retained: projection.retained }
203
- : {}),
204
- originalCharacters: 0,
205
- projectedCharacters: projection.mode === "archived" ? contentCharacters(projection.retained ?? "") : 0,
206
- availability: "unresolved",
207
- });
208
- }
209
- const counts = { full: 0, archived: 0, retained: 0 };
210
- let originalCharacters = 0;
211
- let projectedCharactersTotal = 0;
212
- let historyOnly = 0;
213
- let unresolved = 0;
214
- for (const item of items) {
215
- if (item.mode === "full") counts.full += 1;
216
- else {
217
- counts.archived += 1;
218
- if (item.retained !== undefined) counts.retained += 1;
219
- }
220
- originalCharacters += item.originalCharacters;
221
- projectedCharactersTotal += item.projectedCharacters;
222
- if (item.availability === "history-only") historyOnly += 1;
223
- if (item.availability === "unresolved") unresolved += 1;
224
- }
225
- return {
226
- available: true,
227
- sessionId: this.sessionId,
228
- branchLeafId: this.branchLeafId,
229
- counts,
230
- originalCharacters,
231
- projectedCharacters: projectedCharactersTotal,
232
- historyOnly,
233
- unresolved,
234
- items: items.slice(-Math.max(1, limit)),
235
- };
236
- }
237
- async archiveNow(targets) {
238
- if (!this.available) return this.unavailable("archive");
239
- if (!Array.isArray(targets) || targets.length === 0) {
240
- return this.rejected("archive", "targets_required");
241
- }
242
- const normalizedRefs = targets.map((target) =>
243
- target && typeof target === "object" ? entryIdFromContextRef(target.ref) : undefined,
244
- );
245
- const duplicate = isDuplicate(
246
- normalizedRefs.flatMap((ref) => (ref === undefined ? [] : [contextRefForEntry(ref)])),
247
- );
248
- if (duplicate) return this.rejected("archive", `duplicate_reference:${duplicate}`);
249
- const latestRequest = this.freeflowContext.latestRequest();
250
- if (!latestRequest) return this.rejected("archive", "no_consumed_context_request");
251
- const changes = [];
252
- const retainedMeaning = {};
253
- for (let index = 0; index < targets.length; index += 1) {
254
- const target = targets[index];
255
- if (!target || typeof target !== "object") return this.rejected("archive", `target_${index}_must_be_object`);
256
- const ref = normalizedRefs[index];
257
- if (!ref) return this.rejected("archive", `target_${index}_invalid_reference`);
258
- const normalizedRef = contextRefForEntry(ref);
259
- const source = latestRequest.refs.get(normalizedRef);
260
- if (!source) return this.rejected("archive", `target_not_in_consumed_context:${normalizedRef}`);
261
- const retainedValue = target.retained;
262
- if (retainedValue !== undefined && (typeof retainedValue !== "string" || retainedValue.trim() === "")) {
263
- return this.rejected("archive", `target_${index}_retained_must_be_non_empty`);
264
- }
265
- const retained = typeof retainedValue === "string" ? retainedValue.trim() : undefined;
266
- changes.push({
267
- source: cloneSource(source.source),
268
- projection: retained === undefined ? { mode: "archived" } : { mode: "archived", retained },
269
- });
270
- if (retained !== undefined) retainedMeaning[normalizedRef] = retained;
271
- }
272
- await this.persist({ version: CONTEXT_PROJECTION_VERSION, actor: "model", changes });
273
- for (const change of changes) {
274
- this.projectionState.set(change.source.entryId, {
275
- source: cloneSource(change.source),
276
- ...change.projection,
277
- });
278
- }
279
- return {
280
- status: "ok",
281
- operation: "archive",
282
- changed: changes.map((change) => contextRefForEntry(change.source.entryId)),
283
- message: `Archived ${changes.length} tool result${changes.length === 1 ? "" : "s"} from future context projections.`,
284
- ...(Object.keys(retainedMeaning).length > 0 ? { retained: retainedMeaning } : {}),
285
- };
286
- }
287
- async restoreNow(refs, actor) {
288
- if (!this.available) return this.unavailable("restore");
289
- if (!Array.isArray(refs) || refs.length === 0) return this.rejected("restore", "refs_required");
290
- const normalizedRefs = refs.map((ref) => entryIdFromContextRef(ref));
291
- const duplicate = isDuplicate(
292
- normalizedRefs.flatMap((ref) => (ref === undefined ? [] : [contextRefForEntry(ref)])),
293
- );
294
- if (duplicate) return this.rejected("restore", `duplicate_reference:${duplicate}`);
295
- const changes = [];
296
- const availability = {};
297
- const activeIds = this.freeflowContext.resolver.activeToolResultIds();
298
- const latestRequest = this.freeflowContext.latestRequest();
299
- for (let index = 0; index < refs.length; index += 1) {
300
- const ref = normalizedRefs[index];
301
- if (!ref) return this.rejected("restore", `ref_${index}_invalid_reference`);
302
- const normalizedRef = contextRefForEntry(ref);
303
- const current = this.projectionState.get(ref);
304
- if (!current) return this.rejected("restore", `reference_not_archived:${normalizedRef}`);
305
- if (actor === "model" && !latestRequest?.refs.has(normalizedRef)) {
306
- return this.rejected("restore", `target_not_in_consumed_context:${normalizedRef}`);
307
- }
308
- changes.push({ source: cloneSource(current.source), projection: { mode: "full" } });
309
- let availabilityValue;
310
- if (latestRequest?.refs.has(normalizedRef) || activeIds.has(current.source.entryId)) {
311
- availabilityValue = "active";
312
- } else {
313
- availabilityValue = "history-only";
314
- }
315
- availability[normalizedRef] = availabilityValue;
316
- }
317
- await this.persist({ version: CONTEXT_PROJECTION_VERSION, actor, changes });
318
- for (const change of changes) {
319
- this.projectionState.set(change.source.entryId, {
320
- source: cloneSource(change.source),
321
- mode: "full",
322
- });
323
- }
324
- return {
325
- status: "ok",
326
- operation: "restore",
327
- changed: changes.map((change) => contextRefForEntry(change.source.entryId)),
328
- availability,
329
- message: `Restored ${changes.length} projection${changes.length === 1 ? "" : "s"} to full content.`,
330
- };
331
- }
332
- listItem(source, projection, availability) {
333
- const item = {
334
- ref: contextRefForEntry(source.source.entryId),
335
- entryId: source.source.entryId,
336
- toolCallId: source.source.toolCallId,
337
- toolName: source.source.toolName,
338
- mode: projection.mode,
339
- originalCharacters: contentCharacters(source.message?.content),
340
- projectedCharacters: projectedCharacters(source.source, source.message, projection),
341
- availability,
342
- };
343
- if (projection.mode === "archived" && projection.retained !== undefined) {
344
- item.retained = projection.retained;
345
- }
346
- return item;
347
- }
348
- rejected(operation, message) {
349
- return { status: "rejected", operation, changed: [], message };
350
- }
351
- unavailable(operation) {
352
- return {
353
- status: "unavailable",
354
- operation,
355
- changed: [],
356
- message: this.unavailableReason ?? "context_virtualization_unavailable",
357
- };
358
- }
359
- persist(journal) {
360
- let append;
361
- if (typeof this.pi?.appendEntryDurable === "function") {
362
- append = this.pi.appendEntryDurable;
363
- } else if (typeof this.pi?.appendEntry === "function") {
364
- append = this.pi.appendEntry;
365
- }
366
- if (!append) throw new Error("The Pi host does not expose a session entry persistence method.");
367
- const result = append.call(this.pi, CONTEXT_PROJECTION_ENTRY, journal);
368
- if (result && typeof result.then === "function") return result;
369
- }
370
- enqueue(task) {
371
- const run = this.mutationQueue.then(task);
372
- this.mutationQueue = run.then(
373
- () => undefined,
374
- () => undefined,
375
- );
376
- return run;
377
- }
378
- }
@@ -1,57 +0,0 @@
1
- import { CONTEXT_PROJECTION_ENTRY, CONTEXT_PROJECTION_VERSION, isRecord } from "./types.js";
2
- function isProjection(value) {
3
- if (!isRecord(value) || (value.mode !== "full" && value.mode !== "archived")) return false;
4
- if (value.mode === "archived" && value.retained !== undefined && typeof value.retained !== "string") return false;
5
- return true;
6
- }
7
- function isJournal(value) {
8
- if (!isRecord(value) || value.version !== CONTEXT_PROJECTION_VERSION) return false;
9
- if (value.actor !== "model" && value.actor !== "user") return false;
10
- if (value.reset !== undefined && value.reset !== "all") return false;
11
- if (value.changes !== undefined && !Array.isArray(value.changes)) return false;
12
- return true;
13
- }
14
- export function replayProjectionEntries(entries, sessionId) {
15
- const state = new Map();
16
- for (const entry of entries) {
17
- if (entry?.type !== "custom" || entry.customType !== CONTEXT_PROJECTION_ENTRY) continue;
18
- const data = entry.data;
19
- if (!isJournal(data)) continue;
20
- if (data.reset === "all") {
21
- state.clear();
22
- }
23
- for (const change of data.changes ?? []) {
24
- if (!isRecord(change) || !isRecord(change.source) || !isProjection(change.projection)) continue;
25
- if (change.source.sessionId !== sessionId || typeof change.source.entryId !== "string") continue;
26
- if (change.projection.mode === "archived" && change.projection.retained !== undefined) {
27
- state.set(change.source.entryId, {
28
- source: { ...change.source },
29
- mode: "archived",
30
- retained: change.projection.retained,
31
- });
32
- } else if (change.projection.mode === "archived") {
33
- state.set(change.source.entryId, {
34
- source: { ...change.source },
35
- mode: "archived",
36
- });
37
- } else {
38
- state.set(change.source.entryId, {
39
- source: { ...change.source },
40
- mode: "full",
41
- });
42
- }
43
- }
44
- }
45
- return state;
46
- }
47
- export function cloneProjectionState(state) {
48
- return new Map(
49
- [...state.entries()].map(([entryId, projection]) => [
50
- entryId,
51
- {
52
- ...projection,
53
- source: { ...projection.source },
54
- },
55
- ]),
56
- );
57
- }
@@ -1,10 +0,0 @@
1
- export { CONTEXT_REF_PREFIX, contextRefForEntry, entryIdFromContextRef } from "../freeflow-context/types.js";
2
- export const CONTEXT_PROJECTION_ENTRY = "freeflow-context-projection";
3
- export const CONTEXT_PROJECTION_VERSION = 1;
4
- export function isRecord(value) {
5
- return typeof value === "object" && value !== null && !Array.isArray(value);
6
- }
7
- export function projectionCharacters(projection) {
8
- if (projection.mode === "full") return 0;
9
- return projection.retained?.length ?? 0;
10
- }