@hassangameryt/freeflow 0.7.1 → 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 (122) 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 +28 -23
  6. package/capabilities/cognitive-routing/SKILL.md +94 -311
  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 +120 -0
  12. package/pi-extension/dist/cognitive-routing-v2/projection.js +321 -0
  13. package/pi-extension/dist/cognitive-routing-v2/render.js +231 -0
  14. package/pi-extension/dist/cognitive-routing-v2/runtime.js +1585 -0
  15. package/pi-extension/dist/cognitive-routing-v2/schemas.js +107 -0
  16. package/pi-extension/dist/cognitive-routing-v2/state.js +612 -0
  17. package/pi-extension/dist/cognitive-routing-v2/tools.js +91 -0
  18. package/pi-extension/dist/cognitive-routing-v2/types.js +44 -0
  19. package/pi-extension/dist/freeflow-context/tool.js +5 -0
  20. package/pi-extension/dist/index.js +279 -624
  21. package/pi-extension/dist/runtime/runtime-context.js +63 -13
  22. package/pi-extension/dist/session-sources/events.js +195 -0
  23. package/pi-extension/dist/session-sources/read-only-session.js +148 -0
  24. package/pi-extension/dist/session-sources/sources.js +233 -0
  25. package/pi-extension/dist/settings/settings-ui.js +44 -117
  26. package/pi-extension/src/cognitive-routing-v2/budget.ts +42 -0
  27. package/pi-extension/src/cognitive-routing-v2/config.ts +143 -0
  28. package/pi-extension/src/cognitive-routing-v2/projection.ts +365 -0
  29. package/pi-extension/src/cognitive-routing-v2/render.ts +256 -0
  30. package/pi-extension/src/cognitive-routing-v2/runtime.ts +1634 -0
  31. package/pi-extension/src/cognitive-routing-v2/schemas.ts +109 -0
  32. package/pi-extension/src/cognitive-routing-v2/state.ts +622 -0
  33. package/pi-extension/src/cognitive-routing-v2/tools.ts +93 -0
  34. package/pi-extension/src/cognitive-routing-v2/types.ts +222 -0
  35. package/pi-extension/src/freeflow-context/tool.ts +5 -0
  36. package/pi-extension/src/index.ts +285 -674
  37. package/pi-extension/src/runtime/runtime-context.ts +75 -14
  38. package/pi-extension/src/session-sources/events.ts +208 -0
  39. package/pi-extension/src/session-sources/read-only-session.ts +170 -0
  40. package/pi-extension/src/session-sources/sources.ts +263 -0
  41. package/pi-extension/src/settings/settings-ui.ts +54 -131
  42. package/pi-extension/tests/cognitive-routing-v2/communication.test.js +484 -0
  43. package/pi-extension/tests/cognitive-routing-v2/compaction-input.test.js +183 -0
  44. package/pi-extension/tests/cognitive-routing-v2/native.test.js +441 -0
  45. package/pi-extension/tests/cognitive-routing-v2/performance.test.js +87 -0
  46. package/pi-extension/tests/cognitive-routing-v2/persistence.test.js +245 -0
  47. package/pi-extension/tests/cognitive-routing-v2/projection.test.js +241 -0
  48. package/pi-extension/tests/cognitive-routing-v2/recovery.test.js +236 -0
  49. package/pi-extension/tests/cognitive-routing-v2/render.test.js +230 -0
  50. package/pi-extension/tests/cognitive-routing-v2/runtime.test.js +153 -0
  51. package/pi-extension/tests/cognitive-routing-v2/stabilization.test.js +521 -0
  52. package/pi-extension/tests/cognitive-routing-v2/state.test.js +275 -0
  53. package/pi-extension/tests/context-virtualization/extension.test.js +16 -0
  54. package/pi-extension/tests/fixtures/routing-native.js +188 -0
  55. package/pi-extension/tests/integration/mode-free-core.test.js +3 -2
  56. package/pi-extension/tests/integration/pi-extension.test.js +154 -37
  57. package/pi-extension/tests/integration/prompt-architecture.test.js +87 -6
  58. package/pi-extension/tests/integration/unaffected-regressions.test.js +77 -10
  59. package/plugin.json +1 -1
  60. package/runtime/prompts/cognitive-routing.md +4 -5
  61. package/runtime/prompts/core.md +51 -45
  62. package/runtime/prompts/interaction-contract.md +5 -5
  63. package/skills/action-selection/SKILL.md +57 -97
  64. package/skills/design-for-depth/SKILL.md +58 -193
  65. package/skills/design-for-depth/references/implementation-decisions.md +76 -0
  66. package/skills/diagnose-failure/SKILL.md +64 -196
  67. package/skills/discuss/SKILL.md +64 -123
  68. package/skills/discuss/references/discussion-continuity.md +7 -3
  69. package/skills/execute-work/SKILL.md +69 -88
  70. package/skills/execute-work/references/execute-work-edges.md +9 -3
  71. package/skills/handoff/SKILL.md +44 -54
  72. package/skills/handoff/references/handoff-templates.md +15 -6
  73. package/skills/review-artifact/SKILL.md +80 -127
  74. package/skills/review-artifact/references/independent-artifact-reviewer-contract.md +1 -1
  75. package/skills/review-work/SKILL.md +65 -115
  76. package/skills/review-work/references/independent-work-reviewer-contract.md +1 -1
  77. package/skills/simplify-code/SKILL.md +47 -100
  78. package/skills/track-work/SKILL.md +128 -119
  79. package/skills/track-work/references/working-record-format.md +14 -2
  80. package/skills/verify-work/SKILL.md +58 -62
  81. package/skills/verify-work/references/integration-evidence.md +4 -2
  82. package/skills/verify-work/references/test-design.md +89 -0
  83. package/skills/workflow/SKILL.md +73 -119
  84. package/skills/write-plan/SKILL.md +46 -77
  85. package/skills/write-plan/references/plan-shapes.md +5 -5
  86. package/skills/write-spec/SKILL.md +51 -63
  87. package/skills/write-spec/references/artifact-standards.md +2 -2
  88. package/skills/write-spec/references/decision-records.md +3 -2
  89. package/skills/write-spec/references/spec-shapes.md +15 -0
  90. package/pi-extension/dist/cognitive-routing/commands.js +0 -96
  91. package/pi-extension/dist/cognitive-routing/config.js +0 -232
  92. package/pi-extension/dist/cognitive-routing/controller.js +0 -1292
  93. package/pi-extension/dist/cognitive-routing/history.js +0 -451
  94. package/pi-extension/dist/cognitive-routing/host.js +0 -188
  95. package/pi-extension/dist/cognitive-routing/pi-routing-session.js +0 -414
  96. package/pi-extension/dist/cognitive-routing/pi-session-control.js +0 -320
  97. package/pi-extension/dist/cognitive-routing/runtime.js +0 -43
  98. package/pi-extension/dist/cognitive-routing/tool.js +0 -212
  99. package/pi-extension/dist/cognitive-routing/types.js +0 -6
  100. package/pi-extension/src/cognitive-routing/commands.ts +0 -129
  101. package/pi-extension/src/cognitive-routing/config.ts +0 -303
  102. package/pi-extension/src/cognitive-routing/controller.ts +0 -1628
  103. package/pi-extension/src/cognitive-routing/history.ts +0 -650
  104. package/pi-extension/src/cognitive-routing/host.ts +0 -266
  105. package/pi-extension/src/cognitive-routing/pi-routing-session.ts +0 -538
  106. package/pi-extension/src/cognitive-routing/pi-session-control.ts +0 -444
  107. package/pi-extension/src/cognitive-routing/runtime.ts +0 -57
  108. package/pi-extension/src/cognitive-routing/tool.ts +0 -273
  109. package/pi-extension/src/cognitive-routing/types.ts +0 -89
  110. package/pi-extension/tests/cognitive-routing/commands.test.js +0 -134
  111. package/pi-extension/tests/cognitive-routing/controller.test.js +0 -1128
  112. package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +0 -1142
  113. package/pi-extension/tests/cognitive-routing/history.test.js +0 -274
  114. package/pi-extension/tests/cognitive-routing/host-identity.test.js +0 -63
  115. package/pi-extension/tests/cognitive-routing/pi-normal-lifecycle.test.js +0 -434
  116. package/pi-extension/tests/cognitive-routing/pi-session-control.test.js +0 -174
  117. package/pi-extension/tests/cognitive-routing/pi-session-history.test.js +0 -91
  118. package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +0 -279
  119. package/pi-extension/tests/cognitive-routing/tool.test.js +0 -230
  120. package/skills/tdd/SKILL.md +0 -143
  121. package/skills/tdd/references/test-design.md +0 -96
  122. /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
- }