@hassangameryt/freeflow 0.7.1 → 0.7.3

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 (147) 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/README.md +153 -128
  6. package/capabilities/cognitive-routing/SKILL.md +126 -274
  7. package/command-surface.json +7 -1
  8. package/gemini-extension.json +1 -1
  9. package/package.json +4 -4
  10. package/pi-extension/dist/cognitive-routing-v2/budget.js +42 -0
  11. package/pi-extension/dist/cognitive-routing-v2/config.js +136 -0
  12. package/pi-extension/dist/cognitive-routing-v2/projection.js +330 -0
  13. package/pi-extension/dist/cognitive-routing-v2/render.js +252 -0
  14. package/pi-extension/dist/cognitive-routing-v2/runtime.js +2181 -0
  15. package/pi-extension/dist/cognitive-routing-v2/schemas.js +173 -0
  16. package/pi-extension/dist/cognitive-routing-v2/state.js +828 -0
  17. package/pi-extension/dist/cognitive-routing-v2/tools.js +60 -0
  18. package/pi-extension/dist/cognitive-routing-v2/types.js +48 -0
  19. package/pi-extension/dist/context-virtualization/runtime.js +29 -7
  20. package/pi-extension/dist/freeflow-context/tool.js +12 -6
  21. package/pi-extension/dist/index.js +302 -626
  22. package/pi-extension/dist/provider-support/astra/adapter.js +110 -0
  23. package/pi-extension/dist/provider-support/astra/history.js +125 -0
  24. package/pi-extension/dist/provider-support/astra/index.js +11 -0
  25. package/pi-extension/dist/provider-support/astra/session-state.js +114 -0
  26. package/pi-extension/dist/provider-support/index.js +4 -0
  27. package/pi-extension/dist/runtime/request-history.js +216 -0
  28. package/pi-extension/dist/runtime/runtime-context.js +85 -16
  29. package/pi-extension/dist/session-sources/events.js +217 -0
  30. package/pi-extension/dist/session-sources/provenance.js +32 -0
  31. package/pi-extension/dist/session-sources/read-only-session.js +148 -0
  32. package/pi-extension/dist/session-sources/sources.js +277 -0
  33. package/pi-extension/dist/settings/settings-ui.js +274 -147
  34. package/pi-extension/src/cognitive-routing-v2/budget.ts +42 -0
  35. package/pi-extension/src/cognitive-routing-v2/config.ts +173 -0
  36. package/pi-extension/src/cognitive-routing-v2/projection.ts +375 -0
  37. package/pi-extension/src/cognitive-routing-v2/render.ts +277 -0
  38. package/pi-extension/src/cognitive-routing-v2/runtime.ts +2241 -0
  39. package/pi-extension/src/cognitive-routing-v2/schemas.ts +180 -0
  40. package/pi-extension/src/cognitive-routing-v2/state.ts +839 -0
  41. package/pi-extension/src/cognitive-routing-v2/tools.ts +62 -0
  42. package/pi-extension/src/cognitive-routing-v2/types.ts +254 -0
  43. package/pi-extension/src/context-virtualization/runtime.ts +30 -8
  44. package/pi-extension/src/freeflow-context/tool.ts +12 -6
  45. package/pi-extension/src/index.ts +308 -675
  46. package/pi-extension/src/provider-support/astra/adapter.ts +108 -0
  47. package/pi-extension/src/provider-support/astra/history.ts +145 -0
  48. package/pi-extension/src/provider-support/astra/index.ts +12 -0
  49. package/pi-extension/src/provider-support/astra/session-state.ts +113 -0
  50. package/pi-extension/src/provider-support/index.ts +5 -0
  51. package/pi-extension/src/runtime/request-history.ts +243 -0
  52. package/pi-extension/src/runtime/runtime-context.ts +100 -17
  53. package/pi-extension/src/session-sources/events.ts +230 -0
  54. package/pi-extension/src/session-sources/provenance.ts +39 -0
  55. package/pi-extension/src/session-sources/read-only-session.ts +170 -0
  56. package/pi-extension/src/session-sources/sources.ts +334 -0
  57. package/pi-extension/src/settings/settings-ui.ts +311 -158
  58. package/pi-extension/tests/cache-reuse/history.test.js +117 -0
  59. package/pi-extension/tests/cache-reuse/native.test.js +91 -0
  60. package/pi-extension/tests/cache-reuse/settings.test.js +211 -0
  61. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +577 -0
  62. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +183 -0
  63. package/pi-extension/tests/cognitive-routing-v2/delegation.test.js +557 -0
  64. package/pi-extension/tests/cognitive-routing-v2/native.test.js +474 -0
  65. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +87 -0
  66. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +300 -0
  67. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +241 -0
  68. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +1034 -0
  69. package/pi-extension/tests/cognitive-routing-v2/render.test.js +244 -0
  70. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +423 -0
  71. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +521 -0
  72. package/pi-extension/tests/cognitive-routing-v2/state.test.js +586 -0
  73. package/pi-extension/tests/context-virtualization/extension.test.js +33 -7
  74. package/pi-extension/tests/context-virtualization/runtime.test.js +17 -3
  75. package/pi-extension/tests/fixtures/routing-native.js +191 -0
  76. package/pi-extension/tests/integration/mode-free-core.test.js +6 -4
  77. package/pi-extension/tests/integration/pi-extension.test.js +655 -59
  78. package/pi-extension/tests/integration/prompt-architecture.test.js +127 -30
  79. package/pi-extension/tests/integration/unaffected-regressions.test.js +78 -11
  80. package/pi-extension/tests/provider-support/astra-boundaries.test.js +75 -0
  81. package/pi-extension/tests/provider-support/astra.test.js +306 -0
  82. package/pi-extension/tests/provider-support/cli.test.js +92 -0
  83. package/pi-extension/tests/provider-support/native.test.js +183 -0
  84. package/plugin.json +1 -1
  85. package/runtime/prompts/cognitive-routing.md +4 -5
  86. package/runtime/prompts/core.md +51 -45
  87. package/runtime/prompts/interaction-contract.md +5 -5
  88. package/skills/action-selection/SKILL.md +57 -97
  89. package/skills/design-for-depth/SKILL.md +58 -193
  90. package/skills/design-for-depth/references/implementation-decisions.md +76 -0
  91. package/skills/diagnose-failure/SKILL.md +64 -196
  92. package/skills/discuss/SKILL.md +64 -123
  93. package/skills/discuss/references/discussion-continuity.md +7 -3
  94. package/skills/execute-work/SKILL.md +69 -88
  95. package/skills/execute-work/references/execute-work-edges.md +9 -3
  96. package/skills/handoff/SKILL.md +44 -54
  97. package/skills/handoff/references/handoff-templates.md +15 -6
  98. package/skills/review-artifact/SKILL.md +80 -127
  99. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
  100. package/skills/review-work/SKILL.md +65 -115
  101. package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
  102. package/skills/simplify-code/SKILL.md +47 -100
  103. package/skills/track-work/SKILL.md +128 -119
  104. package/skills/track-work/references/working-record-format.md +14 -2
  105. package/skills/verify-work/SKILL.md +58 -62
  106. package/skills/verify-work/references/integration-evidence.md +4 -2
  107. package/skills/verify-work/references/test-design.md +89 -0
  108. package/skills/workflow/SKILL.md +73 -119
  109. package/skills/write-plan/SKILL.md +46 -77
  110. package/skills/write-plan/references/plan-shapes.md +5 -5
  111. package/skills/write-spec/SKILL.md +51 -63
  112. package/skills/write-spec/references/artifact-standards.md +2 -2
  113. package/skills/write-spec/references/decision-records.md +3 -2
  114. package/skills/write-spec/references/spec-shapes.md +15 -0
  115. package/pi-extension/dist/cognitive-routing/commands.js +0 -96
  116. package/pi-extension/dist/cognitive-routing/config.js +0 -232
  117. package/pi-extension/dist/cognitive-routing/controller.js +0 -1292
  118. package/pi-extension/dist/cognitive-routing/history.js +0 -451
  119. package/pi-extension/dist/cognitive-routing/host.js +0 -188
  120. package/pi-extension/dist/cognitive-routing/pi-routing-session.js +0 -414
  121. package/pi-extension/dist/cognitive-routing/pi-session-control.js +0 -320
  122. package/pi-extension/dist/cognitive-routing/runtime.js +0 -43
  123. package/pi-extension/dist/cognitive-routing/tool.js +0 -212
  124. package/pi-extension/dist/cognitive-routing/types.js +0 -6
  125. package/pi-extension/src/cognitive-routing/commands.ts +0 -129
  126. package/pi-extension/src/cognitive-routing/config.ts +0 -303
  127. package/pi-extension/src/cognitive-routing/controller.ts +0 -1628
  128. package/pi-extension/src/cognitive-routing/history.ts +0 -650
  129. package/pi-extension/src/cognitive-routing/host.ts +0 -266
  130. package/pi-extension/src/cognitive-routing/pi-routing-session.ts +0 -538
  131. package/pi-extension/src/cognitive-routing/pi-session-control.ts +0 -444
  132. package/pi-extension/src/cognitive-routing/runtime.ts +0 -57
  133. package/pi-extension/src/cognitive-routing/tool.ts +0 -273
  134. package/pi-extension/src/cognitive-routing/types.ts +0 -89
  135. package/pi-extension/tests/cognitive-routing/commands.test.js +0 -134
  136. package/pi-extension/tests/cognitive-routing/controller.test.js +0 -1128
  137. package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +0 -1142
  138. package/pi-extension/tests/cognitive-routing/history.test.js +0 -274
  139. package/pi-extension/tests/cognitive-routing/host-identity.test.js +0 -63
  140. package/pi-extension/tests/cognitive-routing/pi-normal-lifecycle.test.js +0 -434
  141. package/pi-extension/tests/cognitive-routing/pi-session-control.test.js +0 -174
  142. package/pi-extension/tests/cognitive-routing/pi-session-history.test.js +0 -91
  143. package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +0 -279
  144. package/pi-extension/tests/cognitive-routing/tool.test.js +0 -230
  145. package/skills/tdd/SKILL.md +0 -143
  146. package/skills/tdd/references/test-design.md +0 -96
  147. /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
- }