@hassangameryt/freeflow 0.7.0 → 0.7.2

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 (136) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +2 -1
  3. package/.codex-plugin/plugin.json +2 -2
  4. package/.cursor-plugin/plugin.json +25 -0
  5. package/README.md +57 -26
  6. package/capabilities/cognitive-routing/SKILL.md +94 -311
  7. package/com.github.copilot/hooks/hooks.json +11 -0
  8. package/command-surface.json +7 -1
  9. package/gemini-extension.json +5 -0
  10. package/hooks/adapters/claude-session-start.mjs +16 -0
  11. package/hooks/adapters/codex-session-start.mjs +16 -0
  12. package/hooks/adapters/copilot-session-start.mjs +13 -0
  13. package/hooks/adapters/cursor-session-start.mjs +13 -0
  14. package/hooks/adapters/gemini-session-start.mjs +15 -0
  15. package/hooks/claude/hooks.json +18 -0
  16. package/hooks/codex/hooks.json +18 -0
  17. package/hooks/cursor/hooks.json +9 -0
  18. package/hooks/freeflow-runtime-context.mjs +3 -215
  19. package/hooks/hooks.json +4 -5
  20. package/hooks/shared/runtime-context.mjs +210 -0
  21. package/hooks/tests/check-host-adapters.test.mjs +82 -0
  22. package/hooks/tests/check-runtime-context-hook.sh +34 -3
  23. package/package.json +20 -6
  24. package/pi-extension/dist/cognitive-routing-v2/budget.js +42 -0
  25. package/pi-extension/dist/cognitive-routing-v2/config.js +120 -0
  26. package/pi-extension/dist/cognitive-routing-v2/projection.js +321 -0
  27. package/pi-extension/dist/cognitive-routing-v2/render.js +231 -0
  28. package/pi-extension/dist/cognitive-routing-v2/runtime.js +1585 -0
  29. package/pi-extension/dist/cognitive-routing-v2/schemas.js +107 -0
  30. package/pi-extension/dist/cognitive-routing-v2/state.js +612 -0
  31. package/pi-extension/dist/cognitive-routing-v2/tools.js +91 -0
  32. package/pi-extension/dist/cognitive-routing-v2/types.js +44 -0
  33. package/pi-extension/dist/freeflow-context/tool.js +5 -0
  34. package/pi-extension/dist/index.js +279 -624
  35. package/pi-extension/dist/runtime/runtime-context.js +63 -13
  36. package/pi-extension/dist/session-sources/events.js +195 -0
  37. package/pi-extension/dist/session-sources/read-only-session.js +148 -0
  38. package/pi-extension/dist/session-sources/sources.js +233 -0
  39. package/pi-extension/dist/settings/settings-ui.js +44 -117
  40. package/pi-extension/src/cognitive-routing-v2/budget.ts +42 -0
  41. package/pi-extension/src/cognitive-routing-v2/config.ts +143 -0
  42. package/pi-extension/src/cognitive-routing-v2/projection.ts +365 -0
  43. package/pi-extension/src/cognitive-routing-v2/render.ts +256 -0
  44. package/pi-extension/src/cognitive-routing-v2/runtime.ts +1634 -0
  45. package/pi-extension/src/cognitive-routing-v2/schemas.ts +109 -0
  46. package/pi-extension/src/cognitive-routing-v2/state.ts +622 -0
  47. package/pi-extension/src/cognitive-routing-v2/tools.ts +93 -0
  48. package/pi-extension/src/cognitive-routing-v2/types.ts +222 -0
  49. package/pi-extension/src/freeflow-context/tool.ts +5 -0
  50. package/pi-extension/src/index.ts +285 -674
  51. package/pi-extension/src/runtime/runtime-context.ts +75 -14
  52. package/pi-extension/src/session-sources/events.ts +208 -0
  53. package/pi-extension/src/session-sources/read-only-session.ts +170 -0
  54. package/pi-extension/src/session-sources/sources.ts +263 -0
  55. package/pi-extension/src/settings/settings-ui.ts +54 -131
  56. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +484 -0
  57. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +183 -0
  58. package/pi-extension/tests/cognitive-routing-v2/native.test.js +441 -0
  59. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +87 -0
  60. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +245 -0
  61. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +241 -0
  62. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +236 -0
  63. package/pi-extension/tests/cognitive-routing-v2/render.test.js +230 -0
  64. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +153 -0
  65. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +521 -0
  66. package/pi-extension/tests/cognitive-routing-v2/state.test.js +275 -0
  67. package/pi-extension/tests/context-virtualization/extension.test.js +16 -0
  68. package/pi-extension/tests/fixtures/routing-native.js +188 -0
  69. package/pi-extension/tests/integration/mode-free-core.test.js +3 -2
  70. package/pi-extension/tests/integration/pi-extension.test.js +154 -37
  71. package/pi-extension/tests/integration/prompt-architecture.test.js +87 -6
  72. package/pi-extension/tests/integration/unaffected-regressions.test.js +77 -10
  73. package/plugin.json +33 -0
  74. package/runtime/prompts/cognitive-routing.md +4 -5
  75. package/runtime/prompts/core.md +51 -45
  76. package/runtime/prompts/interaction-contract.md +5 -5
  77. package/skills/action-selection/SKILL.md +57 -97
  78. package/skills/design-for-depth/SKILL.md +58 -193
  79. package/skills/design-for-depth/references/implementation-decisions.md +76 -0
  80. package/skills/diagnose-failure/SKILL.md +64 -196
  81. package/skills/discuss/SKILL.md +64 -123
  82. package/skills/discuss/references/discussion-continuity.md +7 -3
  83. package/skills/execute-work/SKILL.md +69 -88
  84. package/skills/execute-work/references/execute-work-edges.md +9 -3
  85. package/skills/handoff/SKILL.md +44 -54
  86. package/skills/handoff/references/handoff-templates.md +15 -6
  87. package/skills/review-artifact/SKILL.md +80 -127
  88. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
  89. package/skills/review-work/SKILL.md +65 -115
  90. package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
  91. package/skills/simplify-code/SKILL.md +47 -100
  92. package/skills/track-work/SKILL.md +128 -119
  93. package/skills/track-work/references/working-record-format.md +14 -2
  94. package/skills/verify-work/SKILL.md +58 -62
  95. package/skills/verify-work/references/integration-evidence.md +4 -2
  96. package/skills/verify-work/references/test-design.md +89 -0
  97. package/skills/workflow/SKILL.md +73 -119
  98. package/skills/write-plan/SKILL.md +46 -77
  99. package/skills/write-plan/references/plan-shapes.md +5 -5
  100. package/skills/write-spec/SKILL.md +51 -63
  101. package/skills/write-spec/references/artifact-standards.md +2 -2
  102. package/skills/write-spec/references/decision-records.md +3 -2
  103. package/skills/write-spec/references/spec-shapes.md +15 -0
  104. package/pi-extension/dist/cognitive-routing/commands.js +0 -96
  105. package/pi-extension/dist/cognitive-routing/config.js +0 -232
  106. package/pi-extension/dist/cognitive-routing/controller.js +0 -1292
  107. package/pi-extension/dist/cognitive-routing/history.js +0 -451
  108. package/pi-extension/dist/cognitive-routing/host.js +0 -188
  109. package/pi-extension/dist/cognitive-routing/pi-routing-session.js +0 -414
  110. package/pi-extension/dist/cognitive-routing/pi-session-control.js +0 -320
  111. package/pi-extension/dist/cognitive-routing/runtime.js +0 -43
  112. package/pi-extension/dist/cognitive-routing/tool.js +0 -212
  113. package/pi-extension/dist/cognitive-routing/types.js +0 -6
  114. package/pi-extension/src/cognitive-routing/commands.ts +0 -129
  115. package/pi-extension/src/cognitive-routing/config.ts +0 -303
  116. package/pi-extension/src/cognitive-routing/controller.ts +0 -1628
  117. package/pi-extension/src/cognitive-routing/history.ts +0 -650
  118. package/pi-extension/src/cognitive-routing/host.ts +0 -266
  119. package/pi-extension/src/cognitive-routing/pi-routing-session.ts +0 -538
  120. package/pi-extension/src/cognitive-routing/pi-session-control.ts +0 -444
  121. package/pi-extension/src/cognitive-routing/runtime.ts +0 -57
  122. package/pi-extension/src/cognitive-routing/tool.ts +0 -273
  123. package/pi-extension/src/cognitive-routing/types.ts +0 -89
  124. package/pi-extension/tests/cognitive-routing/commands.test.js +0 -134
  125. package/pi-extension/tests/cognitive-routing/controller.test.js +0 -1128
  126. package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +0 -1142
  127. package/pi-extension/tests/cognitive-routing/history.test.js +0 -274
  128. package/pi-extension/tests/cognitive-routing/host-identity.test.js +0 -63
  129. package/pi-extension/tests/cognitive-routing/pi-normal-lifecycle.test.js +0 -434
  130. package/pi-extension/tests/cognitive-routing/pi-session-control.test.js +0 -174
  131. package/pi-extension/tests/cognitive-routing/pi-session-history.test.js +0 -91
  132. package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +0 -279
  133. package/pi-extension/tests/cognitive-routing/tool.test.js +0 -230
  134. package/skills/tdd/SKILL.md +0 -143
  135. package/skills/tdd/references/test-design.md +0 -96
  136. /package/pi-extension/tests/{cognitive-routing/host-fixture.js → fixtures/pi-host.js} +0 -0
@@ -1,232 +0,0 @@
1
- import {
2
- COGNITIVE_ROUTING_PROFILE_NAMES,
3
- COGNITIVE_ROUTING_SESSION_START_CONTROLS,
4
- DEFAULT_COGNITIVE_ROUTING_SESSION_START,
5
- } from "./types.js";
6
- const THINKING_LEVELS = new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
7
- const PROFILE_NAME_SET = new Set(COGNITIVE_ROUTING_PROFILE_NAMES);
8
- function isRecord(value) {
9
- return typeof value === "object" && value !== null && !Array.isArray(value);
10
- }
11
- function invalid(source, code, message, profile) {
12
- return { code, message, ...(profile ? { profile } : {}), source };
13
- }
14
- function parseProfile(value, source, name) {
15
- if (!isRecord(value)) {
16
- return { error: invalid(source, "invalid_profile", `${source} ${name} profile must be an object`, name) };
17
- }
18
- const allowedKeys = new Set(["provider", "model", "thinkingLevel"]);
19
- const unsupportedKey = Object.keys(value).find((key) => !allowedKeys.has(key));
20
- if (unsupportedKey) {
21
- return {
22
- error: invalid(
23
- source,
24
- "unsupported_key",
25
- `${source} ${name} profile contains unsupported key: ${unsupportedKey}`,
26
- name,
27
- ),
28
- };
29
- }
30
- if (typeof value.provider !== "string" || value.provider.trim() === "") {
31
- return { error: invalid(source, "invalid_profile", `${source} ${name} profile requires provider`, name) };
32
- }
33
- if (typeof value.model !== "string" || value.model.trim() === "") {
34
- return { error: invalid(source, "invalid_profile", `${source} ${name} profile requires model`, name) };
35
- }
36
- if (typeof value.thinkingLevel !== "string" || !THINKING_LEVELS.has(value.thinkingLevel)) {
37
- return {
38
- error: invalid(source, "invalid_profile", `${source} ${name} profile requires a valid thinkingLevel`, name),
39
- };
40
- }
41
- return {
42
- profile: {
43
- provider: value.provider,
44
- model: value.model,
45
- thinkingLevel: value.thinkingLevel,
46
- },
47
- };
48
- }
49
- function parseSessionStart(value, source) {
50
- if (!isRecord(value)) {
51
- return {
52
- error: invalid(source, "invalid_session_start", `${source} cognitiveRouting.sessionStart must be an object`),
53
- };
54
- }
55
- const allowedKeys = new Set(["control", "profile"]);
56
- const unsupportedKey = Object.keys(value).find((key) => !allowedKeys.has(key));
57
- if (unsupportedKey) {
58
- return {
59
- error: invalid(
60
- source,
61
- "unsupported_key",
62
- `${source} cognitiveRouting.sessionStart contains unsupported key: ${unsupportedKey}`,
63
- ),
64
- };
65
- }
66
- let control;
67
- if (Object.hasOwn(value, "control")) {
68
- if (typeof value.control !== "string" || !COGNITIVE_ROUTING_SESSION_START_CONTROLS.includes(value.control)) {
69
- return {
70
- error: invalid(
71
- source,
72
- "invalid_session_start",
73
- `${source} cognitiveRouting.sessionStart.control must be automatic or manual`,
74
- ),
75
- };
76
- }
77
- control = value.control;
78
- }
79
- let profile;
80
- if (Object.hasOwn(value, "profile")) {
81
- if (typeof value.profile !== "string" || !PROFILE_NAME_SET.has(value.profile)) {
82
- return {
83
- error: invalid(
84
- source,
85
- "invalid_session_start",
86
- `${source} cognitiveRouting.sessionStart.profile must be standard or reasoning`,
87
- ),
88
- };
89
- }
90
- profile = value.profile;
91
- }
92
- return { sessionStart: { ...(control ? { control } : {}), ...(profile ? { profile } : {}) } };
93
- }
94
- function parseLayer(value, source) {
95
- if (value === undefined) {
96
- return { present: false, valid: true, profiles: {}, sessionStart: {} };
97
- }
98
- if (!isRecord(value)) {
99
- return {
100
- present: true,
101
- valid: false,
102
- profiles: {},
103
- sessionStart: {},
104
- error: invalid(source, "invalid_block", `${source} cognitiveRouting must be an object`),
105
- };
106
- }
107
- const allowedKeys = new Set(["enabled", "profiles", "sessionStart"]);
108
- const unsupportedKey = Object.keys(value).find((key) => !allowedKeys.has(key));
109
- if (unsupportedKey) {
110
- return {
111
- present: true,
112
- valid: false,
113
- profiles: {},
114
- sessionStart: {},
115
- error: invalid(
116
- source,
117
- "unsupported_key",
118
- `${source} cognitiveRouting contains unsupported key: ${unsupportedKey}`,
119
- ),
120
- };
121
- }
122
- let enabled;
123
- if (Object.hasOwn(value, "enabled")) {
124
- if (typeof value.enabled !== "boolean") {
125
- return {
126
- present: true,
127
- valid: false,
128
- profiles: {},
129
- sessionStart: {},
130
- error: invalid(source, "invalid_enabled", `${source} cognitiveRouting.enabled must be a boolean`),
131
- };
132
- }
133
- enabled = value.enabled;
134
- }
135
- let sessionStart = {};
136
- if (Object.hasOwn(value, "sessionStart")) {
137
- const parsed = parseSessionStart(value.sessionStart, source);
138
- if (parsed.error)
139
- return { present: true, valid: false, enabled, profiles: {}, sessionStart: {}, error: parsed.error };
140
- sessionStart = parsed.sessionStart ?? {};
141
- }
142
- const profiles = {};
143
- if (Object.hasOwn(value, "profiles")) {
144
- if (!isRecord(value.profiles)) {
145
- return {
146
- present: true,
147
- valid: false,
148
- profiles: {},
149
- sessionStart: {},
150
- error: invalid(source, "invalid_profiles", `${source} cognitiveRouting.profiles must be an object`),
151
- };
152
- }
153
- const unsupportedProfile = Object.keys(value.profiles).find((key) => !PROFILE_NAME_SET.has(key));
154
- if (unsupportedProfile) {
155
- return {
156
- present: true,
157
- valid: false,
158
- profiles: {},
159
- sessionStart: {},
160
- error: invalid(
161
- source,
162
- "unsupported_key",
163
- `${source} cognitiveRouting.profiles contains unsupported profile: ${unsupportedProfile}`,
164
- ),
165
- };
166
- }
167
- for (const name of COGNITIVE_ROUTING_PROFILE_NAMES) {
168
- if (!Object.hasOwn(value.profiles, name)) continue;
169
- const parsed = parseProfile(value.profiles[name], source, name);
170
- if (parsed.error) {
171
- return { present: true, valid: false, enabled, profiles: {}, sessionStart: {}, error: parsed.error };
172
- }
173
- profiles[name] = parsed.profile;
174
- }
175
- }
176
- return { present: true, valid: true, enabled, profiles, sessionStart };
177
- }
178
- export function resolveCognitiveRoutingConfig(repositoryConfig, personalConfig) {
179
- const repositoryValue = isRecord(repositoryConfig) ? repositoryConfig.cognitiveRouting : undefined;
180
- const personalValue = isRecord(personalConfig) ? personalConfig.cognitiveRouting : undefined;
181
- const repository = parseLayer(repositoryValue, "repository");
182
- const personal = parseLayer(personalValue, "personal");
183
- const configured = repository.present || personal.present;
184
- const profiles = {};
185
- const profileSources = {};
186
- for (const name of COGNITIVE_ROUTING_PROFILE_NAMES) {
187
- if (repository.profiles[name]) {
188
- profiles[name] = repository.profiles[name];
189
- profileSources[name] = "repository";
190
- }
191
- if (personal.profiles[name]) {
192
- profiles[name] = personal.profiles[name];
193
- profileSources[name] = "personal";
194
- }
195
- }
196
- const enabled = personal.enabled ?? repository.enabled ?? false;
197
- let enabledSource = "default";
198
- if (repository.enabled !== undefined) enabledSource = "repository";
199
- if (personal.enabled !== undefined) enabledSource = "personal";
200
- const sessionStartControl =
201
- personal.sessionStart.control ?? repository.sessionStart.control ?? DEFAULT_COGNITIVE_ROUTING_SESSION_START.control;
202
- const configuredSessionStartProfile =
203
- personal.sessionStart.profile ?? repository.sessionStart.profile ?? DEFAULT_COGNITIVE_ROUTING_SESSION_START.profile;
204
- const sessionStart = {
205
- control: sessionStartControl,
206
- profile: sessionStartControl === "automatic" ? "reasoning" : configuredSessionStartProfile,
207
- };
208
- let sessionStartControlSource = "default";
209
- if (repository.sessionStart.control !== undefined) sessionStartControlSource = "repository";
210
- if (personal.sessionStart.control !== undefined) sessionStartControlSource = "personal";
211
- let sessionStartProfileSource = "default";
212
- if (sessionStartControl === "manual") {
213
- if (repository.sessionStart.profile !== undefined) sessionStartProfileSource = "repository";
214
- if (personal.sessionStart.profile !== undefined) sessionStartProfileSource = "personal";
215
- }
216
- const sessionStartSources = {
217
- control: sessionStartControlSource,
218
- profile: sessionStartProfileSource,
219
- };
220
- const error = repository.error ?? personal.error;
221
- return {
222
- configured,
223
- valid: repository.valid && personal.valid,
224
- enabled,
225
- enabledSource,
226
- profiles,
227
- profileSources,
228
- sessionStart,
229
- sessionStartSources,
230
- ...(error ? { error } : {}),
231
- };
232
- }