@hassangameryt/freeflow 0.4.0 → 0.6.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 (285) 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 -1
  4. package/README.md +150 -155
  5. package/capabilities/cognitive-routing/SKILL.md +229 -0
  6. package/capabilities/context-virtualization/SKILL.md +103 -0
  7. package/capabilities/conversation-history/SKILL.md +53 -0
  8. package/command-surface.json +17 -13
  9. package/hooks/freeflow-runtime-context.mjs +393 -159
  10. package/hooks/hooks.json +26 -1
  11. package/hooks/tests/check-runtime-context-hook.sh +223 -54
  12. package/package.json +25 -16
  13. package/pi-extension/dist/cognitive-routing/commands.js +96 -0
  14. package/pi-extension/dist/cognitive-routing/config.js +236 -0
  15. package/pi-extension/dist/cognitive-routing/controller.js +862 -0
  16. package/pi-extension/dist/cognitive-routing/history.js +439 -0
  17. package/pi-extension/dist/cognitive-routing/host.js +126 -0
  18. package/pi-extension/dist/cognitive-routing/runtime.js +43 -0
  19. package/pi-extension/dist/cognitive-routing/tool.js +211 -0
  20. package/pi-extension/dist/cognitive-routing/types.js +6 -0
  21. package/pi-extension/dist/context-virtualization/commands.js +89 -0
  22. package/pi-extension/dist/context-virtualization/projector.js +42 -0
  23. package/pi-extension/dist/context-virtualization/runtime.js +356 -0
  24. package/pi-extension/dist/context-virtualization/state.js +57 -0
  25. package/pi-extension/dist/context-virtualization/types.js +10 -0
  26. package/pi-extension/dist/conversation-history/passages.js +66 -0
  27. package/pi-extension/dist/conversation-history/ranking.js +105 -0
  28. package/pi-extension/dist/conversation-history/runtime.js +226 -0
  29. package/pi-extension/dist/conversation-history/search.js +56 -0
  30. package/pi-extension/dist/conversation-history/types.js +1 -0
  31. package/pi-extension/dist/freeflow-context/resolver.js +120 -0
  32. package/pi-extension/dist/freeflow-context/runtime.js +80 -0
  33. package/pi-extension/dist/freeflow-context/source-projector.js +95 -0
  34. package/pi-extension/dist/freeflow-context/tool.js +308 -0
  35. package/pi-extension/dist/freeflow-context/types.js +12 -0
  36. package/pi-extension/dist/freeflow-context/visibility.js +28 -0
  37. package/pi-extension/dist/index.js +516 -98
  38. package/pi-extension/dist/runtime/runtime-context.js +318 -271
  39. package/pi-extension/dist/runtime/runtime-identity.js +5 -0
  40. package/pi-extension/dist/settings/settings-tui.js +78 -0
  41. package/pi-extension/dist/settings/settings-ui.js +593 -563
  42. package/pi-extension/dist/ui/text-component.js +57 -0
  43. package/pi-extension/src/cognitive-routing/commands.ts +119 -0
  44. package/pi-extension/src/cognitive-routing/config.ts +307 -0
  45. package/pi-extension/src/cognitive-routing/controller.ts +1118 -0
  46. package/pi-extension/src/cognitive-routing/history.ts +638 -0
  47. package/pi-extension/src/cognitive-routing/host.ts +172 -0
  48. package/pi-extension/src/cognitive-routing/runtime.ts +57 -0
  49. package/pi-extension/src/cognitive-routing/tool.ts +272 -0
  50. package/pi-extension/src/cognitive-routing/types.ts +89 -0
  51. package/pi-extension/src/context-virtualization/commands.ts +111 -0
  52. package/pi-extension/src/context-virtualization/projector.ts +62 -0
  53. package/pi-extension/src/context-virtualization/runtime.ts +406 -0
  54. package/pi-extension/src/context-virtualization/state.ts +79 -0
  55. package/pi-extension/src/context-virtualization/types.ts +92 -0
  56. package/pi-extension/src/conversation-history/passages.ts +81 -0
  57. package/pi-extension/src/conversation-history/ranking.ts +155 -0
  58. package/pi-extension/src/conversation-history/runtime.ts +250 -0
  59. package/pi-extension/src/conversation-history/search.ts +79 -0
  60. package/pi-extension/src/conversation-history/types.ts +31 -0
  61. package/pi-extension/src/freeflow-context/resolver.ts +139 -0
  62. package/pi-extension/src/freeflow-context/runtime.ts +100 -0
  63. package/pi-extension/src/freeflow-context/source-projector.ts +106 -0
  64. package/pi-extension/src/freeflow-context/tool.ts +360 -0
  65. package/pi-extension/src/freeflow-context/types.ts +70 -0
  66. package/pi-extension/src/freeflow-context/visibility.ts +53 -0
  67. package/pi-extension/src/index.ts +553 -101
  68. package/pi-extension/src/runtime/runtime-context.ts +339 -281
  69. package/pi-extension/src/runtime/runtime-identity.ts +8 -0
  70. package/pi-extension/src/settings/settings-tui.ts +93 -0
  71. package/pi-extension/src/settings/settings-ui.ts +700 -613
  72. package/pi-extension/src/ui/text-component.ts +66 -0
  73. package/pi-extension/tests/cognitive-routing/commands.test.js +134 -0
  74. package/pi-extension/tests/cognitive-routing/controller.test.js +1099 -0
  75. package/pi-extension/tests/cognitive-routing/extension-lifecycle.test.js +1071 -0
  76. package/pi-extension/tests/cognitive-routing/history.test.js +274 -0
  77. package/pi-extension/tests/cognitive-routing/host-fixture.js +4 -0
  78. package/pi-extension/tests/cognitive-routing/host-identity.test.js +63 -0
  79. package/pi-extension/tests/cognitive-routing/profile-resolution.test.js +236 -0
  80. package/pi-extension/tests/cognitive-routing/tool.test.js +230 -0
  81. package/pi-extension/tests/context-virtualization/extension.test.js +749 -0
  82. package/pi-extension/tests/context-virtualization/projector.test.js +110 -0
  83. package/pi-extension/tests/context-virtualization/runtime.test.js +216 -0
  84. package/pi-extension/tests/conversation-history/runtime.test.js +98 -0
  85. package/pi-extension/tests/conversation-history/search.test.js +97 -0
  86. package/pi-extension/tests/integration/pi-extension.test.js +928 -2047
  87. package/pi-extension/tests/integration/prompt-architecture.test.js +305 -0
  88. package/runtime/prompts/cognitive-routing.md +9 -0
  89. package/runtime/prompts/context-virtualization.md +3 -0
  90. package/runtime/prompts/conversation-history.md +3 -0
  91. package/runtime/prompts/core.md +13 -0
  92. package/runtime/prompts/interaction-contract.md +7 -0
  93. package/runtime/prompts/skills.md +65 -0
  94. package/skills/action-selection/SKILL.md +91 -0
  95. package/skills/bypass/SKILL.md +3 -2
  96. package/skills/commit-work/SKILL.md +1 -1
  97. package/skills/commit-work/references/staging-decisions.md +1 -1
  98. package/skills/decision-gate/SKILL.md +1 -1
  99. package/skills/design-for-depth/SKILL.md +14 -33
  100. package/skills/design-for-depth/references/design-pressure-signals.md +1 -1
  101. package/skills/design-for-depth/references/interface-design-loop.md +1 -1
  102. package/skills/design-for-depth/references/software-design-philosophy.md +1 -1
  103. package/skills/diagnose-failure/SKILL.md +20 -14
  104. package/skills/diagnose-failure/references/diagnostic-loop-catalog.md +1 -3
  105. package/skills/diagnose-failure/references/{flaky-and-performance.md → flaky-and-performance-diagnosis.md} +1 -1
  106. package/skills/discuss/SKILL.md +34 -22
  107. package/skills/discuss/references/discussion-continuity.md +71 -0
  108. package/skills/evaluate-skill/SKILL.md +5 -5
  109. package/skills/evaluate-skill/references/{definition-schema.md → evaluation-definition-schema.md} +42 -2
  110. package/skills/evaluate-skill/references/execution-and-evidence.md +8 -3
  111. package/skills/evaluate-skill/scripts/lib/definitions.mjs +114 -3
  112. package/skills/evaluate-skill/scripts/lib/grade-interaction.mjs +156 -1
  113. package/skills/evaluate-skill/scripts/lib/grade.mjs +9 -1
  114. package/skills/evaluate-skill/scripts/lib/pi.mjs +147 -32
  115. package/skills/evaluate-skill/scripts/lib/rpc.mjs +4 -4
  116. package/skills/evaluate-skill/scripts/lib/runner.mjs +36 -14
  117. package/skills/evaluate-skill/scripts/lib/sandbox.mjs +92 -0
  118. package/skills/evaluate-skill/scripts/pi-guard.mjs +1 -1
  119. package/skills/evaluate-skill/scripts/pi-observer.mjs +66 -0
  120. package/skills/evaluate-skill/scripts/skill-eval.mjs +6 -5
  121. package/skills/execute-work/SKILL.md +18 -15
  122. package/skills/execute-work/references/code-practices.md +1 -1
  123. package/skills/execute-work/references/execute-work-edges.md +42 -0
  124. package/skills/finish-branch/SKILL.md +2 -2
  125. package/skills/finish-branch/references/integration-options.md +1 -1
  126. package/skills/handoff/SKILL.md +3 -3
  127. package/skills/launch-work/SKILL.md +1 -1
  128. package/skills/launch-work/references/launch-readiness.md +2 -2
  129. package/skills/migration-work/SKILL.md +2 -2
  130. package/skills/migration-work/references/migration-lifecycle.md +1 -1
  131. package/skills/mode-contract/SKILL.md +32 -10
  132. package/skills/release-work/SKILL.md +1 -1
  133. package/skills/release-work/references/release-evidence.md +1 -1
  134. package/skills/review-artifact/SKILL.md +28 -26
  135. package/skills/review-work/SKILL.md +28 -26
  136. package/skills/review-work/references/{reviewer-prompt.md → independent-work-reviewer-contract.md} +1 -1
  137. package/skills/review-work/references/security-risk-lens.md +1 -1
  138. package/skills/setup-freeflow/SKILL.md +6 -10
  139. package/skills/setup-freeflow/references/activation-contract.md +5 -10
  140. package/skills/setup-freeflow/references/host-setup.md +3 -7
  141. package/skills/simplify-code/SKILL.md +1 -1
  142. package/skills/simplify-code/references/simplification-patterns.md +1 -1
  143. package/skills/tdd/SKILL.md +18 -38
  144. package/skills/tdd/references/test-design.md +2 -2
  145. package/skills/track-work/SKILL.md +362 -58
  146. package/skills/track-work/scripts/lib/codec.mjs +570 -0
  147. package/skills/track-work/scripts/lib/commands.mjs +568 -0
  148. package/skills/track-work/scripts/lib/contract.mjs +303 -0
  149. package/skills/track-work/scripts/lib/model.mjs +506 -0
  150. package/skills/track-work/scripts/lib/operations.mjs +965 -0
  151. package/skills/track-work/scripts/lib/record-store.mjs +264 -0
  152. package/skills/track-work/scripts/lib/result.mjs +37 -0
  153. package/skills/track-work/scripts/lib/rewrites.mjs +740 -0
  154. package/skills/track-work/scripts/lib/schema.mjs +277 -0
  155. package/skills/track-work/scripts/lib/source-inventory.mjs +162 -0
  156. package/skills/track-work/scripts/lib/views.mjs +443 -0
  157. package/skills/track-work/scripts/lib/workspace.mjs +134 -0
  158. package/skills/track-work/scripts/working-record.mjs +122 -0
  159. package/skills/verify-work/SKILL.md +14 -2
  160. package/skills/verify-work/references/browser-runtime-evidence.md +1 -1
  161. package/skills/verify-work/references/integration-evidence.md +1 -1
  162. package/skills/verify-work/references/performance-evidence.md +1 -1
  163. package/skills/workflow/SKILL.md +105 -53
  164. package/skills/workflow/references/domain-skill-composition.md +22 -42
  165. package/skills/write-plan/SKILL.md +1 -1
  166. package/skills/write-skill/SKILL.md +3 -2
  167. package/skills/write-skill/references/progressive-disclosure.md +17 -3
  168. package/pi-extension/dist/output-router/host-producer-identification.js +0 -232
  169. package/pi-extension/dist/output-router/native-safety-net.js +0 -216
  170. package/pi-extension/dist/output-router/observed-tool-routing.js +0 -122
  171. package/pi-extension/dist/output-router/renderers.js +0 -1023
  172. package/pi-extension/dist/output-router/router-tools.js +0 -554
  173. package/pi-extension/dist/output-router/schemas.js +0 -383
  174. package/pi-extension/dist/output-router/status.js +0 -744
  175. package/pi-extension/dist/output-router/utils.js +0 -502
  176. package/pi-extension/src/output-router/host-producer-identification.ts +0 -256
  177. package/pi-extension/src/output-router/native-safety-net.ts +0 -248
  178. package/pi-extension/src/output-router/observed-tool-routing.ts +0 -134
  179. package/pi-extension/src/output-router/renderers.ts +0 -1108
  180. package/pi-extension/src/output-router/router-tools.ts +0 -579
  181. package/pi-extension/src/output-router/schemas.ts +0 -387
  182. package/pi-extension/src/output-router/status.ts +0 -791
  183. package/pi-extension/src/output-router/utils.ts +0 -554
  184. package/pi-extension/tests/output-router/observed-producers.test.js +0 -132
  185. package/pi-extension/tests/output-router/search.test.js +0 -722
  186. package/router/dist/benchmarks/benchmark-harness.d.ts +0 -35
  187. package/router/dist/benchmarks/benchmark-harness.js +0 -92
  188. package/router/dist/benchmarks/benchmarks.d.ts +0 -109
  189. package/router/dist/benchmarks/benchmarks.js +0 -979
  190. package/router/dist/benchmarks/codex-qa-benchmarks.d.ts +0 -95
  191. package/router/dist/benchmarks/codex-qa-benchmarks.js +0 -500
  192. package/router/dist/benchmarks/command-benchmarks.d.ts +0 -143
  193. package/router/dist/benchmarks/command-benchmarks.js +0 -698
  194. package/router/dist/benchmarks/context-mode-normalized-benchmarks.d.ts +0 -82
  195. package/router/dist/benchmarks/context-mode-normalized-benchmarks.js +0 -773
  196. package/router/dist/benchmarks/context-mode-real-deep-benchmark.d.ts +0 -132
  197. package/router/dist/benchmarks/context-mode-real-deep-benchmark.js +0 -1380
  198. package/router/dist/benchmarks/context-saving-baseline.d.ts +0 -60
  199. package/router/dist/benchmarks/context-saving-baseline.js +0 -470
  200. package/router/dist/benchmarks/index-benchmarks.d.ts +0 -103
  201. package/router/dist/benchmarks/index-benchmarks.js +0 -862
  202. package/router/dist/benchmarks/storage-policy-benchmarks.d.ts +0 -101
  203. package/router/dist/benchmarks/storage-policy-benchmarks.js +0 -618
  204. package/router/dist/benchmarks/vault-index-benchmarks.d.ts +0 -56
  205. package/router/dist/benchmarks/vault-index-benchmarks.js +0 -322
  206. package/router/dist/config/config.d.ts +0 -103
  207. package/router/dist/config/config.js +0 -632
  208. package/router/dist/config/router-contract.d.ts +0 -10
  209. package/router/dist/config/router-contract.js +0 -54
  210. package/router/dist/config/schema.d.ts +0 -27
  211. package/router/dist/config/schema.js +0 -648
  212. package/router/dist/config/types.d.ts +0 -573
  213. package/router/dist/config/types.js +0 -41
  214. package/router/dist/evidence/bounded-evidence.d.ts +0 -40
  215. package/router/dist/evidence/bounded-evidence.js +0 -323
  216. package/router/dist/evidence/evidence-range-selector.d.ts +0 -24
  217. package/router/dist/evidence/evidence-range-selector.js +0 -232
  218. package/router/dist/evidence/evidence-search.d.ts +0 -27
  219. package/router/dist/evidence/evidence-search.js +0 -490
  220. package/router/dist/evidence/evidence.d.ts +0 -38
  221. package/router/dist/evidence/evidence.js +0 -200
  222. package/router/dist/evidence/failure-contracts.d.ts +0 -37
  223. package/router/dist/evidence/failure-contracts.js +0 -166
  224. package/router/dist/evidence/line-ranges.d.ts +0 -24
  225. package/router/dist/evidence/line-ranges.js +0 -22
  226. package/router/dist/experiments/local-index.d.ts +0 -64
  227. package/router/dist/experiments/local-index.js +0 -581
  228. package/router/dist/index.d.ts +0 -30
  229. package/router/dist/index.js +0 -32
  230. package/router/dist/local/local-traversal.d.ts +0 -18
  231. package/router/dist/local/local-traversal.js +0 -334
  232. package/router/dist/processing/engine.d.ts +0 -132
  233. package/router/dist/processing/engine.js +0 -533
  234. package/router/dist/processing/reducers.d.ts +0 -280
  235. package/router/dist/processing/reducers.js +0 -1673
  236. package/router/dist/processing/renderers.d.ts +0 -31
  237. package/router/dist/processing/renderers.js +0 -195
  238. package/router/dist/processing/scripts.d.ts +0 -91
  239. package/router/dist/processing/scripts.js +0 -386
  240. package/router/dist/repo/repo-traversal.d.ts +0 -18
  241. package/router/dist/repo/repo-traversal.js +0 -245
  242. package/router/dist/routing/observed-reducers.d.ts +0 -41
  243. package/router/dist/routing/observed-reducers.js +0 -661
  244. package/router/dist/routing/observed-routing.d.ts +0 -26
  245. package/router/dist/routing/observed-routing.js +0 -378
  246. package/router/dist/routing/parsers.d.ts +0 -16
  247. package/router/dist/routing/parsers.js +0 -521
  248. package/router/dist/routing/run-filters.d.ts +0 -60
  249. package/router/dist/routing/run-filters.js +0 -238
  250. package/router/dist/routing/run-reducers.d.ts +0 -49
  251. package/router/dist/routing/run-reducers.js +0 -122
  252. package/router/dist/sandbox/adapter-roots.d.ts +0 -46
  253. package/router/dist/sandbox/adapter-roots.js +0 -66
  254. package/router/dist/sandbox/eryx-python-adapter.d.ts +0 -13
  255. package/router/dist/sandbox/eryx-python-adapter.js +0 -868
  256. package/router/dist/sandbox/jq-wasm-adapter.d.ts +0 -9
  257. package/router/dist/sandbox/jq-wasm-adapter.js +0 -429
  258. package/router/dist/sandbox/quickjs-wasi-adapter.d.ts +0 -13
  259. package/router/dist/sandbox/quickjs-wasi-adapter.js +0 -384
  260. package/router/dist/sandbox/script-sandbox.d.ts +0 -134
  261. package/router/dist/sandbox/script-sandbox.js +0 -337
  262. package/router/dist/setup/script-transform-adapters.d.ts +0 -32
  263. package/router/dist/setup/script-transform-adapters.js +0 -278
  264. package/router/dist/tools/batch.d.ts +0 -33
  265. package/router/dist/tools/batch.js +0 -586
  266. package/router/dist/tools/run.d.ts +0 -62
  267. package/router/dist/tools/run.js +0 -1304
  268. package/router/dist/tools/search.d.ts +0 -66
  269. package/router/dist/tools/search.js +0 -1364
  270. package/router/dist/transform/engine.d.ts +0 -168
  271. package/router/dist/transform/engine.js +0 -2072
  272. package/router/dist/vault/vault-index.d.ts +0 -125
  273. package/router/dist/vault/vault-index.js +0 -416
  274. package/router/dist/vault/vault.d.ts +0 -138
  275. package/router/dist/vault/vault.js +0 -630
  276. package/runtime/interaction-contract.md +0 -16
  277. package/skills/discuss/references/checkpoints.md +0 -66
  278. package/skills/execute-work/references/execution-loop.md +0 -77
  279. package/skills/output-router/SKILL.md +0 -206
  280. package/skills/output-router/references/safety-policy.md +0 -40
  281. package/skills/setup-freeflow/references/output-router-setup.md +0 -110
  282. package/skills/track-work/references/working-record-schema.md +0 -378
  283. package/skills/workflow/references/workflow-loop.md +0 -92
  284. /package/skills/handoff/references/{templates.md → handoff-templates.md} +0 -0
  285. /package/skills/review-artifact/references/{reviewer-prompt.md → independent-artifact-reviewer-contract.md} +0 -0
@@ -1,18 +0,0 @@
1
- export interface RepoTextFileRef {
2
- path: string;
3
- absolutePath: string;
4
- sizeBytes: number;
5
- }
6
- export interface ResolvedRepoPath {
7
- root: string;
8
- absolutePath: string;
9
- relativePath: string;
10
- }
11
- export interface CollectRepoTextFileRefsOptions {
12
- root: string;
13
- requestedPath?: string;
14
- generatedPathGlobs?: readonly string[];
15
- }
16
- export declare function collectRepoTextFileRefs(options: CollectRepoTextFileRefsOptions): Promise<RepoTextFileRef[]>;
17
- export declare function resolveRepoPath(root: string, requestedPath?: string): Promise<ResolvedRepoPath>;
18
- export declare function matchesGeneratedPathGlob(path: string, pattern: string): boolean;
@@ -1,245 +0,0 @@
1
- import { readdir, realpath, stat } from "node:fs/promises";
2
- import { relative, resolve } from "node:path";
3
- const BROAD_SCAN_MAX_FILE_BYTES = 1024 * 1024;
4
- const SKIP_DIRS = new Set([
5
- ".git",
6
- "node_modules",
7
- "dist",
8
- "build",
9
- "out",
10
- ".next",
11
- ".nuxt",
12
- "coverage",
13
- "target",
14
- "graphify-out",
15
- ".cache",
16
- ".tmp",
17
- "tmp",
18
- "temp",
19
- "logs",
20
- "generated",
21
- ]);
22
- const BROAD_SKIP_FILE_EXTENSIONS = new Set([
23
- ".7z",
24
- ".avi",
25
- ".bin",
26
- ".bmp",
27
- ".br",
28
- ".class",
29
- ".db",
30
- ".dll",
31
- ".dylib",
32
- ".eot",
33
- ".exe",
34
- ".gif",
35
- ".gz",
36
- ".heic",
37
- ".icns",
38
- ".ico",
39
- ".jar",
40
- ".jpeg",
41
- ".jpg",
42
- ".mov",
43
- ".mp3",
44
- ".mp4",
45
- ".otf",
46
- ".parquet",
47
- ".pdf",
48
- ".png",
49
- ".pyc",
50
- ".rar",
51
- ".so",
52
- ".sqlite",
53
- ".sqlite3",
54
- ".tar",
55
- ".tgz",
56
- ".ttf",
57
- ".wasm",
58
- ".webm",
59
- ".webp",
60
- ".woff",
61
- ".woff2",
62
- ".zip",
63
- ".zst",
64
- ]);
65
- export async function collectRepoTextFileRefs(options) {
66
- const start = await resolveRepoPath(options.root, options.requestedPath);
67
- const fileRefs = [];
68
- const visitedDirectories = new Set();
69
- const broadTraversal = !isExplicitRequestedPath(start.relativePath);
70
- await collectTextFileRefs({
71
- root: start.root,
72
- currentPath: start.absolutePath,
73
- fileRefs,
74
- broadTraversal,
75
- visitedDirectories,
76
- generatedPathGlobs: options.generatedPathGlobs ?? [],
77
- });
78
- return fileRefs;
79
- }
80
- export async function resolveRepoPath(root, requestedPath) {
81
- const rootRealPath = await realpath(resolve(root));
82
- const requestedAbsolutePath = requestedPath ? resolve(rootRealPath, requestedPath) : rootRealPath;
83
- const requestedRealPath = await realpath(requestedAbsolutePath);
84
- if (!isPathInsideRoot(rootRealPath, requestedRealPath)) {
85
- throw new Error(`Repo path escapes root: ${requestedPath ?? "."}`);
86
- }
87
- return {
88
- root: rootRealPath,
89
- absolutePath: requestedRealPath,
90
- relativePath: normalizeRelativePath(relative(rootRealPath, requestedRealPath)),
91
- };
92
- }
93
- async function collectTextFileRefs(options) {
94
- let currentRealPath;
95
- try {
96
- currentRealPath = await realpath(options.currentPath);
97
- } catch {
98
- return;
99
- }
100
- if (!isPathInsideRoot(options.root, currentRealPath)) {
101
- return;
102
- }
103
- let currentStat;
104
- try {
105
- currentStat = await stat(currentRealPath);
106
- } catch {
107
- return;
108
- }
109
- const path = normalizeRelativePath(relative(options.root, currentRealPath));
110
- if (currentStat.isDirectory()) {
111
- if (options.visitedDirectories.has(currentRealPath)) {
112
- return;
113
- }
114
- options.visitedDirectories.add(currentRealPath);
115
- if (options.broadTraversal && path !== "" && shouldSkipBroadDirectory(path, options.generatedPathGlobs)) {
116
- return;
117
- }
118
- const entries = await readdir(currentRealPath, { withFileTypes: true });
119
- for (const entry of entries) {
120
- await collectTextFileRefs({
121
- ...options,
122
- currentPath: resolve(currentRealPath, entry.name),
123
- });
124
- }
125
- return;
126
- }
127
- if (!currentStat.isFile()) {
128
- return;
129
- }
130
- if (options.broadTraversal && shouldSkipBroadFile(path, currentStat.size, options.generatedPathGlobs)) {
131
- return;
132
- }
133
- options.fileRefs.push({ path, absolutePath: currentRealPath, sizeBytes: currentStat.size });
134
- }
135
- function isExplicitRequestedPath(requestedRelativePath) {
136
- return requestedRelativePath !== "" && requestedRelativePath !== ".";
137
- }
138
- function shouldSkipBroadDirectory(path, generatedPathGlobs) {
139
- const name = path.split("/").at(-1) ?? path;
140
- return SKIP_DIRS.has(name) || matchesGeneratedPathHint(path, generatedPathGlobs);
141
- }
142
- function shouldSkipBroadFile(path, size, generatedPathGlobs) {
143
- if (matchesGeneratedPathHint(path, generatedPathGlobs)) {
144
- return true;
145
- }
146
- const name = path.split("/").at(-1)?.toLowerCase() ?? path.toLowerCase();
147
- if (isLockfile(name)) {
148
- return false;
149
- }
150
- if (hasBroadSkippedFileExtension(name)) {
151
- return true;
152
- }
153
- if (size > BROAD_SCAN_MAX_FILE_BYTES) {
154
- return true;
155
- }
156
- if (name.endsWith(".min.js") || name.endsWith(".min.css") || name.endsWith(".map")) {
157
- return true;
158
- }
159
- if (name.includes(".bundle.") || name.endsWith(".log")) {
160
- return true;
161
- }
162
- if ((name.endsWith(".html") || name.endsWith(".json")) && size > 64_000) {
163
- return true;
164
- }
165
- return false;
166
- }
167
- function matchesGeneratedPathHint(path, hints) {
168
- if (hints.length === 0) {
169
- return false;
170
- }
171
- const normalizedPath = normalizeRelativePath(path);
172
- return hints.some((hint) => matchesGeneratedPathGlob(normalizedPath, hint));
173
- }
174
- export function matchesGeneratedPathGlob(path, pattern) {
175
- const normalizedPath = normalizeRelativePath(path).replace(/\/+$/, "");
176
- const normalizedPattern = normalizeRelativePath(pattern).replace(/\/+$/, "");
177
- if (!normalizedPath || !normalizedPattern || hasUnsupportedGlobSyntax(normalizedPattern)) {
178
- return false;
179
- }
180
- const patternSegments = normalizedPattern.split("/");
181
- const pathSegments = normalizedPath.split("/");
182
- if (patternSegments.some((segment) => segment.includes("**") && segment !== "**")) {
183
- return false;
184
- }
185
- return matchGlobSegments(patternSegments, pathSegments, 0, 0);
186
- }
187
- function matchGlobSegments(patternSegments, pathSegments, patternIndex, pathIndex) {
188
- if (patternIndex === patternSegments.length) {
189
- return pathIndex === pathSegments.length;
190
- }
191
- const patternSegment = patternSegments[patternIndex];
192
- if (patternSegment === "**") {
193
- if (patternIndex === patternSegments.length - 1) {
194
- return true;
195
- }
196
- for (let nextPathIndex = pathIndex; nextPathIndex <= pathSegments.length; nextPathIndex += 1) {
197
- if (matchGlobSegments(patternSegments, pathSegments, patternIndex + 1, nextPathIndex)) {
198
- return true;
199
- }
200
- }
201
- return false;
202
- }
203
- const pathSegment = pathSegments[pathIndex];
204
- if (pathSegment === undefined || patternSegment === undefined || !matchesGlobSegment(pathSegment, patternSegment)) {
205
- return false;
206
- }
207
- return matchGlobSegments(patternSegments, pathSegments, patternIndex + 1, pathIndex + 1);
208
- }
209
- function matchesGlobSegment(pathSegment, patternSegment) {
210
- const escaped = patternSegment
211
- .split("*")
212
- .map((part) => part.replace(/[.+^${}()|[\]\\]/g, "\\$&"))
213
- .join("[^/]*");
214
- return new RegExp(`^${escaped}$`).test(pathSegment);
215
- }
216
- function hasUnsupportedGlobSyntax(pattern) {
217
- return /[{}!?[\]\\]/.test(pattern);
218
- }
219
- function hasBroadSkippedFileExtension(name) {
220
- for (const extension of BROAD_SKIP_FILE_EXTENSIONS) {
221
- if (name.endsWith(extension)) {
222
- return true;
223
- }
224
- }
225
- return false;
226
- }
227
- function isLockfile(name) {
228
- return (
229
- name === "package-lock.json" ||
230
- name === "npm-shrinkwrap.json" ||
231
- name === "pnpm-lock.yaml" ||
232
- name === "yarn.lock" ||
233
- name === "bun.lockb"
234
- );
235
- }
236
- function isPathInsideRoot(root, absolutePath) {
237
- const relativePath = relative(root, absolutePath);
238
- return (
239
- relativePath === "" ||
240
- (!relativePath.startsWith("..") && !relativePath.startsWith("/") && !/^[A-Za-z]:/.test(relativePath))
241
- );
242
- }
243
- function normalizeRelativePath(path) {
244
- return path.split(/[\\/]+/).join("/");
245
- }
@@ -1,41 +0,0 @@
1
- import type {
2
- EvidencePacket,
3
- ObservedOutputNormalization,
4
- PreserveMode,
5
- ProducerDescriptor,
6
- RouterThresholds,
7
- } from "../config/types.js";
8
- export interface ObservedReducerInput {
9
- outputId: string;
10
- source: EvidencePacket["source"];
11
- preserve: PreserveMode;
12
- thresholds: RouterThresholds;
13
- text: string;
14
- rawValue?: unknown;
15
- normalized: ObservedOutputNormalization;
16
- producer?: ProducerDescriptor;
17
- }
18
- export interface ObservedReducerResult {
19
- reducer: string;
20
- routingStatus: "routed" | "partial";
21
- reason: string;
22
- summary: string;
23
- evidence: EvidencePacket[];
24
- }
25
- export interface ObservedReducer {
26
- name: string;
27
- supports(input: ObservedReducerInput): boolean;
28
- reduce(input: ObservedReducerInput): ObservedReducerResult;
29
- }
30
- export interface ObservedReducerRegistry {
31
- names(): string[];
32
- reduce(input: ObservedReducerInput): ObservedReducerResult;
33
- }
34
- export declare function createDefaultObservedReducerRegistry(): ObservedReducerRegistry;
35
- export declare function reduceObservedOutput(input: ObservedReducerInput): ObservedReducerResult;
36
- export declare function webSearchReducer(): ObservedReducer;
37
- export declare function fetchReducer(): ObservedReducer;
38
- export declare function codeSearchReducer(): ObservedReducer;
39
- export declare function mcpReducer(): ObservedReducer;
40
- export declare function genericTextReducer(): ObservedReducer;
41
- export declare function jsonReducer(): ObservedReducer;