@hassangameryt/freeflow 0.7.2 → 0.8.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 (267) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.cursor-plugin/plugin.json +1 -1
  5. package/NOTICE +14 -0
  6. package/README.md +151 -136
  7. package/capabilities/cognitive-routing/SKILL.md +110 -96
  8. package/capabilities/cognitive-routing/references/both-mode.md +36 -0
  9. package/capabilities/cognitive-routing/references/executor-mode.md +48 -0
  10. package/capabilities/cognitive-routing/references/helper-mode.md +47 -0
  11. package/capabilities/compaction/SKILL.md +49 -0
  12. package/capabilities/compaction/references/summary-format.md +239 -0
  13. package/command-surface.json +4 -0
  14. package/gemini-extension.json +1 -1
  15. package/hooks/shared/runtime-context.mjs +28 -30
  16. package/licenses/Apache-2.0.txt +55 -0
  17. package/package.json +22 -9
  18. package/pi-extension/README.md +41 -0
  19. package/pi-extension/dist/cognitive-routing/assembler.js +393 -0
  20. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/config.js +40 -21
  21. package/pi-extension/dist/cognitive-routing/economics.js +45 -0
  22. package/pi-extension/dist/cognitive-routing/event-schema.js +388 -0
  23. package/pi-extension/dist/cognitive-routing/event-store.js +280 -0
  24. package/pi-extension/dist/cognitive-routing/gate.js +241 -0
  25. package/pi-extension/dist/cognitive-routing/handlers.js +899 -0
  26. package/pi-extension/dist/cognitive-routing/handoffs.js +350 -0
  27. package/pi-extension/dist/cognitive-routing/model-control.js +467 -0
  28. package/pi-extension/dist/cognitive-routing/projection.js +503 -0
  29. package/pi-extension/dist/cognitive-routing/provenance.js +81 -0
  30. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/render.js +31 -10
  31. package/pi-extension/dist/cognitive-routing/runtime.js +396 -0
  32. package/pi-extension/dist/cognitive-routing/schemas.js +209 -0
  33. package/pi-extension/dist/cognitive-routing/session.js +221 -0
  34. package/pi-extension/dist/cognitive-routing/sources.js +291 -0
  35. package/pi-extension/dist/cognitive-routing/state.js +487 -0
  36. package/pi-extension/dist/cognitive-routing/status.js +80 -0
  37. package/pi-extension/dist/cognitive-routing/tools.js +60 -0
  38. package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/types.js +10 -12
  39. package/pi-extension/dist/compaction/carry.js +191 -0
  40. package/pi-extension/dist/compaction/config.js +22 -0
  41. package/pi-extension/dist/compaction/controller.js +471 -0
  42. package/pi-extension/dist/compaction/harness.js +77 -0
  43. package/pi-extension/dist/compaction/results.js +158 -0
  44. package/pi-extension/dist/compaction/thresholds.js +35 -0
  45. package/pi-extension/dist/compaction/tool.js +57 -0
  46. package/pi-extension/dist/host/branch.js +13 -0
  47. package/pi-extension/dist/host/canonical.js +12 -0
  48. package/pi-extension/dist/host/catalog.js +77 -0
  49. package/pi-extension/dist/host/config.js +374 -0
  50. package/pi-extension/dist/host/projection-tags.js +60 -0
  51. package/pi-extension/dist/host/prompts.js +82 -0
  52. package/pi-extension/dist/{session-sources → host}/read-only-session.js +112 -1
  53. package/pi-extension/dist/host/request-history.js +298 -0
  54. package/pi-extension/dist/host/runtime-state.js +189 -0
  55. package/pi-extension/dist/host/settings/freeflow-command.js +1570 -0
  56. package/pi-extension/dist/{settings/settings-tui.js → host/settings/settings-view.js} +186 -73
  57. package/pi-extension/dist/host/staging.js +28 -0
  58. package/pi-extension/dist/host/status.js +101 -0
  59. package/pi-extension/dist/index.js +441 -170
  60. package/pi-extension/dist/provider-support/cache/anchor.js +21 -0
  61. package/pi-extension/dist/provider-support/cache/anthropic.js +102 -0
  62. package/pi-extension/dist/provider-support/cache/health.js +73 -0
  63. package/pi-extension/dist/provider-support/cache/index.js +58 -0
  64. package/pi-extension/dist/provider-support/cache/keepalive.js +210 -0
  65. package/pi-extension/dist/provider-support/cache/monitor.js +17 -0
  66. package/pi-extension/dist/provider-support/cache/openai-responses.js +48 -0
  67. package/pi-extension/dist/provider-support/effort.js +13 -0
  68. package/pi-extension/dist/provider-support/index.js +45 -0
  69. package/pi-extension/dist/provider-support/openai/adapter.js +127 -0
  70. package/pi-extension/dist/provider-support/openai/history.js +127 -0
  71. package/pi-extension/dist/provider-support/openai/index.js +15 -0
  72. package/pi-extension/dist/provider-support/openai/session-state.js +105 -0
  73. package/pi-extension/dist/provider-support/routes.js +17 -0
  74. package/pi-extension/dist/tool-execution/apply-patch/grammar.js +23 -0
  75. package/pi-extension/dist/tool-execution/apply-patch/match.js +38 -0
  76. package/pi-extension/dist/tool-execution/apply-patch/parser.js +177 -0
  77. package/pi-extension/dist/tool-execution/apply-patch/plan.js +201 -0
  78. package/pi-extension/dist/tool-execution/apply-patch/tool.js +84 -0
  79. package/pi-extension/dist/tool-execution/background.js +238 -0
  80. package/pi-extension/dist/tool-execution/bash-guard.js +23 -0
  81. package/pi-extension/dist/tool-execution/config.js +22 -0
  82. package/pi-extension/dist/tool-execution/edit-messages.js +120 -0
  83. package/pi-extension/dist/tool-execution/file-state.js +138 -0
  84. package/pi-extension/dist/tool-execution/file-tracking.js +143 -0
  85. package/pi-extension/dist/tool-execution/prompt.js +54 -0
  86. package/pi-extension/dist/tool-execution/tools.js +16 -0
  87. package/pi-extension/freeflow/README.md +9 -0
  88. package/plugin.json +1 -1
  89. package/runtime/prompts/cognitive-routing.md +4 -4
  90. package/runtime/prompts/core.md +22 -75
  91. package/runtime/prompts/interaction-contract.md +15 -8
  92. package/runtime/prompts/tool-execution.md +38 -0
  93. package/runtime/prompts/working-method.md +108 -0
  94. package/skills/action-selection/SKILL.md +39 -47
  95. package/skills/action-selection/references/trajectory-stalls.md +2 -0
  96. package/skills/bypass/SKILL.md +2 -2
  97. package/skills/commit-work/SKILL.md +31 -83
  98. package/skills/commit-work/references/git-state-edges.md +1 -1
  99. package/skills/commit-work/references/simple-push.md +2 -0
  100. package/skills/commit-work/references/staging-decisions.md +1 -1
  101. package/skills/decision-gate/SKILL.md +31 -50
  102. package/skills/design-for-depth/SKILL.md +44 -53
  103. package/skills/design-for-depth/references/design-pressure-signals.md +46 -144
  104. package/skills/design-for-depth/references/implementation-decisions.md +4 -4
  105. package/skills/design-for-depth/references/interface-design-loop.md +5 -36
  106. package/skills/design-for-depth/references/module-and-dependency-design.md +2 -32
  107. package/skills/design-for-depth/references/state-and-failure-boundaries.md +2 -13
  108. package/skills/diagnose-failure/SKILL.md +39 -24
  109. package/skills/diagnose-failure/references/diagnostic-loop-catalog.md +2 -0
  110. package/skills/diagnose-failure/references/flaky-and-performance-diagnosis.md +2 -2
  111. package/skills/discuss/SKILL.md +37 -13
  112. package/skills/discuss/references/discussion-continuity.md +7 -27
  113. package/skills/evaluate-skill/SKILL.md +49 -80
  114. package/skills/evaluate-skill/references/evaluation-definition-schema.md +35 -5
  115. package/skills/evaluate-skill/references/evaluation-design.md +14 -14
  116. package/skills/evaluate-skill/references/execution-and-evidence.md +26 -5
  117. package/skills/evaluate-skill/references/review-and-revision.md +3 -1
  118. package/skills/evaluate-skill/scripts/lib/definitions.mjs +49 -8
  119. package/skills/evaluate-skill/scripts/lib/pi.mjs +14 -7
  120. package/skills/evaluate-skill/scripts/lib/review.mjs +196 -0
  121. package/skills/evaluate-skill/scripts/lib/runner.mjs +45 -8
  122. package/skills/evaluate-skill/scripts/lib/sandbox.mjs +2 -0
  123. package/skills/evaluate-skill/scripts/lib/trials.mjs +103 -0
  124. package/skills/evaluate-skill/scripts/lib/view.mjs +67 -1
  125. package/skills/evaluate-skill/scripts/pi-command-tool.mjs +144 -0
  126. package/skills/evaluate-skill/scripts/pi-guard.mjs +30 -13
  127. package/skills/evaluate-skill/scripts/skill-eval.mjs +114 -34
  128. package/skills/execute-work/SKILL.md +41 -9
  129. package/skills/execute-work/references/code-practices.md +2 -0
  130. package/skills/execute-work/references/execute-work-edges.md +11 -1
  131. package/skills/handoff/SKILL.md +1 -1
  132. package/skills/handoff/references/handoff-templates.md +1 -1
  133. package/skills/review-artifact/SKILL.md +42 -41
  134. package/skills/review-artifact/references/adjudicate-artifact-review.md +1 -1
  135. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
  136. package/skills/review-work/SKILL.md +38 -32
  137. package/skills/review-work/references/adjudicate-work-review.md +1 -1
  138. package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
  139. package/skills/review-work/references/security-risk-lens.md +2 -4
  140. package/skills/setup-freeflow/SKILL.md +3 -1
  141. package/skills/setup-freeflow/references/activation-contract.md +7 -13
  142. package/skills/setup-freeflow/references/host-setup.md +3 -3
  143. package/skills/track-work/SKILL.md +113 -161
  144. package/skills/track-work/references/working-record-format.md +189 -350
  145. package/skills/track-work/scripts/lib/document.mjs +62 -6
  146. package/skills/track-work/scripts/lib/format.mjs +16 -1
  147. package/skills/track-work/scripts/lib/store.mjs +9 -8
  148. package/skills/track-work/scripts/lib/transitions.mjs +79 -4
  149. package/skills/track-work/scripts/working-record.mjs +34 -12
  150. package/skills/verify-work/SKILL.md +29 -20
  151. package/skills/verify-work/references/browser-runtime-evidence.md +1 -5
  152. package/skills/verify-work/references/integration-evidence.md +2 -0
  153. package/skills/verify-work/references/performance-evidence.md +3 -1
  154. package/skills/verify-work/references/test-design.md +3 -1
  155. package/skills/workflow/SKILL.md +65 -21
  156. package/skills/workflow/references/domain-skill-composition.md +5 -3
  157. package/skills/write-docs/SKILL.md +83 -0
  158. package/skills/write-docs/references/documentation-shapes.md +119 -0
  159. package/skills/write-docs/scripts/docs-check.mjs +139 -0
  160. package/skills/write-plan/SKILL.md +40 -40
  161. package/skills/write-plan/references/plan-shapes.md +1 -1
  162. package/skills/write-skill/SKILL.md +107 -147
  163. package/skills/write-skill/references/activation-boundaries.md +2 -0
  164. package/skills/write-skill/references/agent-first-instructions.md +22 -10
  165. package/skills/write-skill/references/progressive-disclosure.md +4 -2
  166. package/skills/write-skill/references/skill-dependency-graphs.md +2 -0
  167. package/skills/write-skill/scripts/lib/similarity.mjs +56 -0
  168. package/skills/write-skill/scripts/skill-author.mjs +18 -2
  169. package/skills/write-spec/SKILL.md +34 -41
  170. package/skills/write-spec/references/artifact-standards.md +1 -1
  171. package/skills/write-spec/references/decision-records.md +2 -0
  172. package/skills/write-spec/references/spec-shapes.md +1 -1
  173. package/capabilities/context-virtualization/SKILL.md +0 -103
  174. package/capabilities/conversation-history/SKILL.md +0 -53
  175. package/hooks/tests/check-host-adapters.test.mjs +0 -82
  176. package/hooks/tests/check-runtime-context-hook.sh +0 -212
  177. package/pi-extension/dist/cognitive-routing-v2/projection.js +0 -321
  178. package/pi-extension/dist/cognitive-routing-v2/runtime.js +0 -1585
  179. package/pi-extension/dist/cognitive-routing-v2/schemas.js +0 -107
  180. package/pi-extension/dist/cognitive-routing-v2/state.js +0 -612
  181. package/pi-extension/dist/cognitive-routing-v2/tools.js +0 -91
  182. package/pi-extension/dist/context-virtualization/commands.js +0 -89
  183. package/pi-extension/dist/context-virtualization/projector.js +0 -42
  184. package/pi-extension/dist/context-virtualization/runtime.js +0 -356
  185. package/pi-extension/dist/context-virtualization/state.js +0 -57
  186. package/pi-extension/dist/context-virtualization/types.js +0 -10
  187. package/pi-extension/dist/conversation-history/passages.js +0 -66
  188. package/pi-extension/dist/conversation-history/ranking.js +0 -105
  189. package/pi-extension/dist/conversation-history/runtime.js +0 -226
  190. package/pi-extension/dist/conversation-history/search.js +0 -56
  191. package/pi-extension/dist/conversation-history/types.js +0 -1
  192. package/pi-extension/dist/freeflow-context/resolver.js +0 -120
  193. package/pi-extension/dist/freeflow-context/runtime.js +0 -80
  194. package/pi-extension/dist/freeflow-context/source-projector.js +0 -95
  195. package/pi-extension/dist/freeflow-context/tool.js +0 -313
  196. package/pi-extension/dist/freeflow-context/types.js +0 -12
  197. package/pi-extension/dist/freeflow-context/visibility.js +0 -28
  198. package/pi-extension/dist/integrations/mcp-config.js +0 -29
  199. package/pi-extension/dist/runtime/runtime-context.js +0 -735
  200. package/pi-extension/dist/runtime/runtime-identity.js +0 -5
  201. package/pi-extension/dist/session-sources/events.js +0 -195
  202. package/pi-extension/dist/session-sources/sources.js +0 -233
  203. package/pi-extension/dist/settings/settings-ui.js +0 -1160
  204. package/pi-extension/dist/ui/text-component.js +0 -57
  205. package/pi-extension/src/cognitive-routing-v2/budget.ts +0 -42
  206. package/pi-extension/src/cognitive-routing-v2/config.ts +0 -143
  207. package/pi-extension/src/cognitive-routing-v2/projection.ts +0 -365
  208. package/pi-extension/src/cognitive-routing-v2/render.ts +0 -256
  209. package/pi-extension/src/cognitive-routing-v2/runtime.ts +0 -1634
  210. package/pi-extension/src/cognitive-routing-v2/schemas.ts +0 -109
  211. package/pi-extension/src/cognitive-routing-v2/state.ts +0 -622
  212. package/pi-extension/src/cognitive-routing-v2/tools.ts +0 -93
  213. package/pi-extension/src/cognitive-routing-v2/types.ts +0 -222
  214. package/pi-extension/src/context-virtualization/commands.ts +0 -111
  215. package/pi-extension/src/context-virtualization/projector.ts +0 -62
  216. package/pi-extension/src/context-virtualization/runtime.ts +0 -406
  217. package/pi-extension/src/context-virtualization/state.ts +0 -79
  218. package/pi-extension/src/context-virtualization/types.ts +0 -92
  219. package/pi-extension/src/conversation-history/passages.ts +0 -81
  220. package/pi-extension/src/conversation-history/ranking.ts +0 -155
  221. package/pi-extension/src/conversation-history/runtime.ts +0 -250
  222. package/pi-extension/src/conversation-history/search.ts +0 -79
  223. package/pi-extension/src/conversation-history/types.ts +0 -31
  224. package/pi-extension/src/freeflow-context/resolver.ts +0 -139
  225. package/pi-extension/src/freeflow-context/runtime.ts +0 -100
  226. package/pi-extension/src/freeflow-context/source-projector.ts +0 -106
  227. package/pi-extension/src/freeflow-context/tool.ts +0 -365
  228. package/pi-extension/src/freeflow-context/types.ts +0 -70
  229. package/pi-extension/src/freeflow-context/visibility.ts +0 -53
  230. package/pi-extension/src/index.ts +0 -368
  231. package/pi-extension/src/integrations/mcp-config.ts +0 -32
  232. package/pi-extension/src/runtime/runtime-context.ts +0 -838
  233. package/pi-extension/src/runtime/runtime-identity.ts +0 -8
  234. package/pi-extension/src/session-sources/events.ts +0 -208
  235. package/pi-extension/src/session-sources/read-only-session.ts +0 -170
  236. package/pi-extension/src/session-sources/sources.ts +0 -263
  237. package/pi-extension/src/settings/settings-tui.ts +0 -501
  238. package/pi-extension/src/settings/settings-ui.ts +0 -1422
  239. package/pi-extension/src/ui/text-component.ts +0 -66
  240. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +0 -484
  241. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +0 -183
  242. package/pi-extension/tests/cognitive-routing-v2/native.test.js +0 -441
  243. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +0 -87
  244. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +0 -245
  245. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +0 -241
  246. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +0 -236
  247. package/pi-extension/tests/cognitive-routing-v2/render.test.js +0 -230
  248. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +0 -153
  249. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +0 -521
  250. package/pi-extension/tests/cognitive-routing-v2/state.test.js +0 -275
  251. package/pi-extension/tests/context-virtualization/extension.test.js +0 -765
  252. package/pi-extension/tests/context-virtualization/projector.test.js +0 -110
  253. package/pi-extension/tests/context-virtualization/runtime.test.js +0 -216
  254. package/pi-extension/tests/conversation-history/runtime.test.js +0 -98
  255. package/pi-extension/tests/conversation-history/search.test.js +0 -97
  256. package/pi-extension/tests/fixtures/pi-host.js +0 -4
  257. package/pi-extension/tests/fixtures/routing-native.js +0 -188
  258. package/pi-extension/tests/integration/mode-free-core.test.js +0 -219
  259. package/pi-extension/tests/integration/pi-extension.test.js +0 -968
  260. package/pi-extension/tests/integration/prompt-architecture.test.js +0 -431
  261. package/pi-extension/tests/integration/unaffected-regressions.test.js +0 -478
  262. package/pi-extension/tests/settings/settings-tui.test.js +0 -243
  263. package/pi-extension/tsconfig.json +0 -16
  264. package/runtime/prompts/context-virtualization.md +0 -3
  265. package/runtime/prompts/conversation-history.md +0 -3
  266. package/skills/design-for-depth/references/software-design-philosophy.md +0 -202
  267. /package/pi-extension/dist/{cognitive-routing-v2 → cognitive-routing}/budget.js +0 -0
@@ -1,478 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import { execFile } from "node:child_process";
3
- import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
4
- import { join } from "node:path";
5
- import { tmpdir } from "node:os";
6
- import test from "node:test";
7
- import { promisify } from "node:util";
8
-
9
- import freeflowExtension from "../../dist/index.js";
10
- import { resetSessionOverrides, setSessionCoreOverride } from "../../dist/runtime/runtime-context.js";
11
- import { PIFLOW_HOST } from "../fixtures/pi-host.js";
12
-
13
- const execFileAsync = promisify(execFile);
14
-
15
- const theme = {
16
- fg(_color, text) {
17
- return text;
18
- },
19
- bold(text) {
20
- return text;
21
- },
22
- };
23
-
24
- function context(cwd, options = {}) {
25
- const notifications = [];
26
- const reloads = [];
27
- const statuses = [];
28
- return {
29
- cwd,
30
- notifications,
31
- reloads,
32
- statuses,
33
- mode: options.mode,
34
- hasUI: options.hasUI,
35
- isIdle: options.isIdle,
36
- async reload() {
37
- reloads.push(true);
38
- },
39
- sessionManager: {
40
- getBranch: () => options.entries ?? [],
41
- getEntries: () => options.entries ?? [],
42
- },
43
- ui: {
44
- setStatus(name, value) {
45
- statuses.push({ name, value });
46
- },
47
- notify(message, level) {
48
- notifications.push({ message, level });
49
- },
50
- },
51
- };
52
- }
53
-
54
- function loadExtension(host = PIFLOW_HOST, runtimeApi = {}) {
55
- const handlers = new Map();
56
- const commands = [];
57
- const tools = [];
58
- const pi = {
59
- host,
60
- registerTool(tool) {
61
- tools.push(tool);
62
- },
63
- registerCommand(name, definition) {
64
- commands.push({ name, definition });
65
- },
66
- registerShortcut() {},
67
- on(name, handler) {
68
- handlers.set(name, handler);
69
- },
70
- appendEntry() {},
71
- sendUserMessage() {},
72
- getAllTools() {
73
- return tools.map((tool) => ({ name: tool.name }));
74
- },
75
- getActiveTools() {
76
- return tools.map((tool) => tool.name);
77
- },
78
- setActiveTools() {},
79
- };
80
- Object.assign(pi, runtimeApi);
81
- freeflowExtension(pi);
82
- return { handlers, commands, pi };
83
- }
84
-
85
- async function configuredRepo(config = {}) {
86
- const cwd = await mkdtemp(join(tmpdir(), "freeflow-unaffected-regressions-"));
87
- await mkdir(join(cwd, ".freeflow"));
88
- await writeFile(join(cwd, ".freeflow/config.json"), JSON.stringify(config, null, 2), "utf8");
89
- return cwd;
90
- }
91
-
92
- function freeflowCommand(commands) {
93
- const command = commands.find((candidate) => candidate.name === "freeflow");
94
- assert.ok(command);
95
- return command;
96
- }
97
-
98
- test("non-TUI settings selectors provide guidance without mutation", async () => {
99
- const cwd = await configuredRepo();
100
- const configPath = join(cwd, ".freeflow/config.json");
101
- const original = await readFile(configPath, "utf8");
102
- try {
103
- const { commands } = loadExtension();
104
- const command = freeflowCommand(commands);
105
- const rpc = context(cwd, { mode: "rpc" });
106
- rpc.ui.custom = async () => assert.fail("RPC settings must not open the TUI");
107
- await command.definition.handler("settings", rpc);
108
- assert.match(rpc.notifications.at(-1).message, /require Pi TUI/);
109
- assert.equal(await readFile(configPath, "utf8"), original);
110
-
111
- const print = context(cwd, { mode: "json", hasUI: false });
112
- await assert.rejects(() => command.definition.handler("settings", print), /require Pi TUI/);
113
- assert.equal(await readFile(configPath, "utf8"), original);
114
- } finally {
115
- await rm(cwd, { recursive: true, force: true });
116
- }
117
- });
118
-
119
- test("settings refuse a mid-run mutation before opening the TUI", async () => {
120
- const cwd = await configuredRepo();
121
- const configPath = join(cwd, ".freeflow/config.json");
122
- const original = await readFile(configPath, "utf8");
123
- try {
124
- const { commands } = loadExtension();
125
- const command = freeflowCommand(commands);
126
- const settings = context(cwd, { isIdle: () => false });
127
- settings.ui.custom = async () => assert.fail("settings UI must not open while Pi is running");
128
- await command.definition.handler("settings repo", settings);
129
- assert.match(settings.notifications.at(-1).message, /only while Pi is idle/);
130
- assert.equal(await readFile(configPath, "utf8"), original);
131
- } finally {
132
- await rm(cwd, { recursive: true, force: true });
133
- }
134
- });
135
-
136
- test("settings recheck idle state before committing a master-switch selection", async () => {
137
- const cwd = await configuredRepo({ enabled: false });
138
- const configPath = join(cwd, ".freeflow/config.json");
139
- const original = await readFile(configPath, "utf8");
140
- let idle = true;
141
- try {
142
- const { commands } = loadExtension();
143
- const command = freeflowCommand(commands);
144
- const settings = context(cwd, { isIdle: () => idle });
145
- settings.ui.custom = async (factory) => {
146
- let result;
147
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
148
- result = value;
149
- });
150
- idle = false;
151
- component.handleInput("\r");
152
- component.handleInput("\u001b[A");
153
- component.handleInput("\r");
154
- await component.waitForWrites();
155
- component.handleInput("\u001b");
156
- return result;
157
- };
158
- await command.definition.handler("settings repo", settings);
159
- assert.match(settings.notifications.at(-1).message, /only while Pi is idle/);
160
- assert.equal(await readFile(configPath, "utf8"), original);
161
- } finally {
162
- await rm(cwd, { recursive: true, force: true });
163
- }
164
- });
165
-
166
- test("personal settings keep repository state unchanged while editing context", async () => {
167
- const cwd = await configuredRepo();
168
- const configPath = join(cwd, ".freeflow/config.json");
169
- const original = await readFile(configPath, "utf8");
170
- try {
171
- const { commands } = loadExtension();
172
- const command = freeflowCommand(commands);
173
- const settings = context(cwd);
174
- settings.ui.custom = async (factory) => {
175
- let result;
176
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
177
- result = value;
178
- });
179
- component.handleInput("\u001b[B");
180
- component.handleInput("\u001b[B");
181
- component.handleInput("\r");
182
- component.handleInput("\r");
183
- component.handleInput("\u001b[B");
184
- component.handleInput("\r");
185
- await component.waitForWrites();
186
- component.handleInput("\u001b");
187
- component.handleInput("\u001b");
188
- return result;
189
- };
190
- await command.definition.handler("settings", settings);
191
- assert.equal(await readFile(configPath, "utf8"), original);
192
- assert.equal(JSON.parse(await readFile(join(cwd, ".freeflow/local.json"), "utf8")).contextVirtualization, true);
193
- } finally {
194
- await rm(cwd, { recursive: true, force: true });
195
- }
196
- });
197
-
198
- test("context settings refresh their parent summary after a child changes", async () => {
199
- const cwd = await configuredRepo({ contextVirtualization: true });
200
- try {
201
- const { commands } = loadExtension();
202
- const command = freeflowCommand(commands);
203
- const settings = context(cwd);
204
- settings.ui.custom = async (factory) => {
205
- let result;
206
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
207
- result = value;
208
- });
209
- assert.match(component.render(120).join("\n"), /Freeflow Context\s+enabled \(2\) 1\/2 enabled/);
210
- component.handleInput("\u001b[B");
211
- component.handleInput("\u001b[B");
212
- component.handleInput("\r");
213
- component.handleInput("\r");
214
- component.handleInput("\u001b[B");
215
- component.handleInput("\u001b[B");
216
- component.handleInput("\r");
217
- await component.waitForWrites();
218
- component.handleInput("\u001b");
219
- assert.match(component.render(120).join("\n"), /Freeflow Context\s+disabled \(2\) 0\/2 enabled/);
220
- component.handleInput("\u001b");
221
- return result;
222
- };
223
- await command.definition.handler("settings", settings);
224
- const local = JSON.parse(await readFile(join(cwd, ".freeflow/local.json"), "utf8"));
225
- assert.equal(local.contextVirtualization, false);
226
- assert.equal(settings.reloads.length, 1);
227
- } finally {
228
- await rm(cwd, { recursive: true, force: true });
229
- }
230
- });
231
-
232
- test("repository settings show personal effective sources without changing shared state", async () => {
233
- const cwd = await configuredRepo({ contextVirtualization: false });
234
- const repositoryPath = join(cwd, ".freeflow/config.json");
235
- const localPath = join(cwd, ".freeflow/local.json");
236
- try {
237
- await writeFile(localPath, JSON.stringify({ contextVirtualization: true }, null, 2), "utf8");
238
- const { commands } = loadExtension();
239
- const command = freeflowCommand(commands);
240
- const settings = context(cwd, { isIdle: () => true });
241
- settings.ui.custom = async (factory) => {
242
- let result;
243
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
244
- result = value;
245
- });
246
- component.handleInput("\u001b[B");
247
- component.handleInput("\u001b[B");
248
- component.handleInput("\r");
249
- assert.match(component.render(120).join("\n"), /Context Virtualization\s+disabled \(effective enabled · local\)/);
250
- component.handleInput("\u001b");
251
- return result;
252
- };
253
- await command.definition.handler("settings repo", settings);
254
- assert.deepEqual(JSON.parse(await readFile(repositoryPath, "utf8")), { contextVirtualization: false });
255
- assert.deepEqual(JSON.parse(await readFile(localPath, "utf8")), { contextVirtualization: true });
256
- assert.equal(settings.reloads.length, 0);
257
- } finally {
258
- await rm(cwd, { recursive: true, force: true });
259
- }
260
- });
261
-
262
- test("Cognitive Routing preset cancellation preserves the previous repository value", async () => {
263
- const cwd = await configuredRepo({
264
- cognitiveRouting: {
265
- enabled: true,
266
- profiles: {
267
- coordinator: { provider: "test", model: "model-a", thinking: "low" },
268
- executor: { provider: "test", model: "model-b", thinking: "high" },
269
- },
270
- },
271
- });
272
- const original = await readFile(join(cwd, ".freeflow/config.json"), "utf8");
273
- try {
274
- const { commands } = loadExtension(
275
- {},
276
- {
277
- setModel() {
278
- return true;
279
- },
280
- setThinkingLevel() {},
281
- },
282
- );
283
- const command = freeflowCommand(commands);
284
- const settings = context(cwd, { isIdle: () => true });
285
- settings.modelRegistry = cognitiveRoutingModelRegistry();
286
- settings.ui.custom = async (factory) => {
287
- let result;
288
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
289
- result = value;
290
- });
291
- component.handleInput("\u001b[B");
292
- component.handleInput("\r");
293
- component.handleInput("\u001b[B");
294
- component.handleInput("\r");
295
- component.handleInput("\u001b");
296
- component.handleInput("\u001b");
297
- return result;
298
- };
299
- await command.definition.handler("settings repo", settings);
300
- assert.equal(await readFile(join(cwd, ".freeflow/config.json"), "utf8"), original);
301
- assert.equal(settings.reloads.length, 0);
302
- } finally {
303
- await rm(cwd, { recursive: true, force: true });
304
- }
305
- });
306
-
307
- test("Cognitive Routing settings refresh after enabling the capability", async () => {
308
- const cwd = await configuredRepo({
309
- cognitiveRouting: {
310
- enabled: false,
311
- profiles: {
312
- coordinator: { provider: "test", model: "model-a", thinking: "low" },
313
- executor: { provider: "test", model: "model-b", thinking: "high" },
314
- },
315
- },
316
- });
317
- try {
318
- const { commands } = loadExtension(
319
- {},
320
- {
321
- setModel() {
322
- return true;
323
- },
324
- setThinkingLevel() {},
325
- },
326
- );
327
- const command = freeflowCommand(commands);
328
- const settings = context(cwd, { isIdle: () => true });
329
- settings.modelRegistry = cognitiveRoutingModelRegistry();
330
- settings.ui.custom = async (factory) => {
331
- let result;
332
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
333
- result = value;
334
- });
335
- component.handleInput("\u001b[B");
336
- component.handleInput("\r");
337
- component.handleInput("\r");
338
- component.handleInput("\u001b[A");
339
- component.handleInput("\r");
340
- await component.waitForWrites();
341
- component.handleInput("\u001b");
342
- assert.match(component.render(120).join("\n"), /Cognitive Routing\s+enabled \(4\) configured/);
343
- component.handleInput("\u001b");
344
- return result;
345
- };
346
- await command.definition.handler("settings repo", settings);
347
- const saved = JSON.parse(await readFile(join(cwd, ".freeflow/config.json"), "utf8"));
348
- assert.equal(saved.cognitiveRouting.enabled, true);
349
- assert.equal(settings.reloads.length, 1);
350
- } finally {
351
- await rm(cwd, { recursive: true, force: true });
352
- }
353
- });
354
-
355
- test("Cognitive Routing settings can disable projection without disabling routing", async () => {
356
- const cwd = await configuredRepo({
357
- cognitiveRouting: {
358
- enabled: true,
359
- projection: true,
360
- profiles: {
361
- coordinator: { provider: "test", model: "model-a", thinking: "low" },
362
- executor: { provider: "test", model: "model-b", thinking: "high" },
363
- },
364
- },
365
- });
366
- try {
367
- const { commands } = loadExtension(
368
- {},
369
- {
370
- setModel() {
371
- return true;
372
- },
373
- setThinkingLevel() {},
374
- },
375
- );
376
- const command = freeflowCommand(commands);
377
- const settings = context(cwd, { isIdle: () => true });
378
- settings.modelRegistry = cognitiveRoutingModelRegistry();
379
- settings.ui.custom = async (factory) => {
380
- let result;
381
- const component = factory({ requestRender() {} }, theme, {}, (value) => {
382
- result = value;
383
- });
384
- component.handleInput("\u001b[B");
385
- component.handleInput("\r");
386
- for (let index = 0; index < 3; index += 1) component.handleInput("\u001b[B");
387
- component.handleInput("\r");
388
- component.handleInput("\u001b[B");
389
- component.handleInput("\r");
390
- await component.waitForWrites();
391
- component.handleInput("\u001b");
392
- component.handleInput("\u001b");
393
- return result;
394
- };
395
- await command.definition.handler("settings repo", settings);
396
- const saved = JSON.parse(await readFile(join(cwd, ".freeflow/config.json"), "utf8"));
397
- assert.equal(saved.cognitiveRouting.enabled, true);
398
- assert.equal(saved.cognitiveRouting.projection ?? false, false);
399
- assert.equal(settings.reloads.length, 1);
400
- } finally {
401
- await rm(cwd, { recursive: true, force: true });
402
- }
403
- });
404
-
405
- test("session settings preserve mandatory prompts through compaction and resume", async () => {
406
- const cwd = await configuredRepo();
407
- try {
408
- const { handlers } = loadExtension();
409
- const ctx = context(cwd);
410
- const before = await handlers.get("before_agent_start")({ systemPrompt: "base prompt" }, ctx);
411
- assert.match(before.systemPrompt, /# Freeflow Interaction Contract/);
412
- await handlers.get("session_compact")({ reason: "manual" }, ctx);
413
- const afterCompact = await handlers.get("before_agent_start")({ systemPrompt: "base prompt" }, ctx);
414
- assert.match(afterCompact.systemPrompt, /# Freeflow Interaction Contract/);
415
- await handlers.get("session_start")({ reason: "resume" }, ctx);
416
- const afterResume = await handlers.get("before_agent_start")({ systemPrompt: "base prompt" }, ctx);
417
- assert.match(afterResume.systemPrompt, /# Freeflow Interaction Contract/);
418
- } finally {
419
- await rm(cwd, { recursive: true, force: true });
420
- }
421
- });
422
-
423
- test("retired router-shaped configuration remains inert while core activation works", async () => {
424
- const cwd = await configuredRepo({ outputRouter: { postToolRouting: "always" } });
425
- try {
426
- const { handlers } = loadExtension();
427
- const ctx = context(cwd);
428
- const before = await handlers.get("before_agent_start")({ systemPrompt: "base prompt" }, ctx);
429
- assert.match(before.systemPrompt, /# Freeflow Interaction Contract/);
430
- assert.doesNotMatch(before.systemPrompt, /Output Router|freeflow_(search|run|batch)/i);
431
- } finally {
432
- await rm(cwd, { recursive: true, force: true });
433
- }
434
- });
435
-
436
- test("remaining session overrides apply without changing repository configuration", async () => {
437
- const cwd = await configuredRepo();
438
- try {
439
- const configPath = join(cwd, ".freeflow/config.json");
440
- const original = await readFile(configPath, "utf8");
441
- const { pi } = loadExtension();
442
- const ctx = context(cwd);
443
- await setSessionCoreOverride("contextVirtualization", true, ctx, pi);
444
- const state = await import("../../dist/runtime/runtime-context.js").then(({ readCapabilityState }) =>
445
- readCapabilityState(cwd, undefined, PIFLOW_HOST),
446
- );
447
- assert.equal(state.contextVirtualization.effective, true);
448
- assert.equal(await readFile(configPath, "utf8"), original);
449
- await resetSessionOverrides(ctx, pi);
450
- } finally {
451
- await rm(cwd, { recursive: true, force: true });
452
- }
453
- });
454
-
455
- function cognitiveRoutingModelRegistry() {
456
- const models = [
457
- { provider: "test", id: "model-a", name: "Model A", reasoning: true },
458
- { provider: "test", id: "model-b", name: "Model B", reasoning: true },
459
- ];
460
- const supported = new Map([
461
- ["model-a", new Set(["off", "low", "medium", "high"])],
462
- ["model-b", new Set(["off", "low", "medium", "high", "max"])],
463
- ]);
464
- return {
465
- getAvailable() {
466
- return models;
467
- },
468
- find(provider, id) {
469
- return models.find((model) => model.provider === provider && model.id === id);
470
- },
471
- async getApiKeyAndHeaders() {
472
- return { ok: true };
473
- },
474
- clampThinkingLevel(model, level) {
475
- return supported.get(model.id)?.has(level) ? level : "off";
476
- },
477
- };
478
- }