@devflow-tools/sdk 0.17.7 → 0.18.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 (224) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +2 -2
  3. package/dist/action-lease.d.ts +17 -0
  4. package/dist/action-lease.d.ts.map +1 -1
  5. package/dist/action-lease.js +27 -1
  6. package/dist/action-lease.js.map +1 -1
  7. package/dist/auth.d.ts +1 -1
  8. package/dist/auth.d.ts.map +1 -1
  9. package/dist/auth.js +8 -9
  10. package/dist/auth.js.map +1 -1
  11. package/dist/capability-rollout.d.ts +9 -0
  12. package/dist/capability-rollout.d.ts.map +1 -1
  13. package/dist/capability-rollout.js +43 -1
  14. package/dist/capability-rollout.js.map +1 -1
  15. package/dist/embedding-provider-contract.d.ts +21 -0
  16. package/dist/embedding-provider-contract.d.ts.map +1 -1
  17. package/dist/embedding-provider-contract.js +30 -0
  18. package/dist/embedding-provider-contract.js.map +1 -1
  19. package/dist/evidence-stable-ref.d.ts +11 -0
  20. package/dist/evidence-stable-ref.d.ts.map +1 -0
  21. package/dist/evidence-stable-ref.js +39 -0
  22. package/dist/evidence-stable-ref.js.map +1 -0
  23. package/dist/index.d.ts +3 -5
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +3 -5
  26. package/dist/index.js.map +1 -1
  27. package/dist/interfaces/IKnowledgeEngine.d.ts +1 -1
  28. package/dist/interfaces/IKnowledgeEngine.d.ts.map +1 -1
  29. package/dist/interfaces/IMemoryEngine.d.ts +10 -9
  30. package/dist/interfaces/IMemoryEngine.d.ts.map +1 -1
  31. package/dist/mcp-health.d.ts.map +1 -1
  32. package/dist/mcp-health.js +2 -1
  33. package/dist/mcp-health.js.map +1 -1
  34. package/dist/paths.d.ts +10 -5
  35. package/dist/paths.d.ts.map +1 -1
  36. package/dist/paths.js +23 -12
  37. package/dist/paths.js.map +1 -1
  38. package/dist/plugin-runtime.d.ts.map +1 -1
  39. package/dist/plugin-runtime.js +2 -1
  40. package/dist/plugin-runtime.js.map +1 -1
  41. package/dist/project-identity.d.ts +7 -0
  42. package/dist/project-identity.d.ts.map +1 -0
  43. package/dist/project-identity.js +84 -0
  44. package/dist/project-identity.js.map +1 -0
  45. package/dist/retrieval-scope.d.ts +44 -0
  46. package/dist/retrieval-scope.d.ts.map +1 -0
  47. package/dist/retrieval-scope.js +55 -0
  48. package/dist/retrieval-scope.js.map +1 -0
  49. package/dist/runtime-endpoint.d.ts +11 -13
  50. package/dist/runtime-endpoint.d.ts.map +1 -1
  51. package/dist/runtime-endpoint.js +28 -33
  52. package/dist/runtime-endpoint.js.map +1 -1
  53. package/dist/semantic-resolution.d.ts +6 -72
  54. package/dist/semantic-resolution.d.ts.map +1 -1
  55. package/dist/semantic-resolution.js +33 -115
  56. package/dist/semantic-resolution.js.map +1 -1
  57. package/dist/task-runtime-reducer.js +1 -1
  58. package/dist/task-runtime-reducer.js.map +1 -1
  59. package/dist/task-runtime.d.ts +3 -2
  60. package/dist/task-runtime.d.ts.map +1 -1
  61. package/dist/task-runtime.js.map +1 -1
  62. package/dist/types/domain-action.d.ts +80 -0
  63. package/dist/types/domain-action.d.ts.map +1 -0
  64. package/dist/types/domain-action.js +2 -0
  65. package/dist/types/domain-action.js.map +1 -0
  66. package/dist/types/embedding-capability.d.ts +29 -0
  67. package/dist/types/embedding-capability.d.ts.map +1 -0
  68. package/dist/types/embedding-capability.js +2 -0
  69. package/dist/types/embedding-capability.js.map +1 -0
  70. package/dist/types/evaluation-bundle.d.ts +69 -0
  71. package/dist/types/evaluation-bundle.d.ts.map +1 -0
  72. package/dist/types/evaluation-bundle.js +130 -0
  73. package/dist/types/evaluation-bundle.js.map +1 -0
  74. package/dist/types/evidence.d.ts +133 -0
  75. package/dist/types/evidence.d.ts.map +1 -0
  76. package/dist/types/evidence.js +2 -0
  77. package/dist/types/evidence.js.map +1 -0
  78. package/dist/types/index.d.ts +13 -0
  79. package/dist/types/index.d.ts.map +1 -1
  80. package/dist/types/index.js +13 -0
  81. package/dist/types/index.js.map +1 -1
  82. package/dist/types/knowledge.d.ts +6 -5
  83. package/dist/types/knowledge.d.ts.map +1 -1
  84. package/dist/types/memory.d.ts +36 -20
  85. package/dist/types/memory.d.ts.map +1 -1
  86. package/dist/types/memory.js +1 -7
  87. package/dist/types/memory.js.map +1 -1
  88. package/dist/types/provider-execution.d.ts +20 -0
  89. package/dist/types/provider-execution.d.ts.map +1 -0
  90. package/dist/types/provider-execution.js +2 -0
  91. package/dist/types/provider-execution.js.map +1 -0
  92. package/dist/types/retrieval-coordinator.d.ts +103 -0
  93. package/dist/types/retrieval-coordinator.d.ts.map +1 -0
  94. package/dist/types/retrieval-coordinator.js +2 -0
  95. package/dist/types/retrieval-coordinator.js.map +1 -0
  96. package/dist/types/retrieval-query-proposal.d.ts +26 -0
  97. package/dist/types/retrieval-query-proposal.d.ts.map +1 -0
  98. package/dist/types/retrieval-query-proposal.js +2 -0
  99. package/dist/types/retrieval-query-proposal.js.map +1 -0
  100. package/dist/types/retrieval.d.ts +5 -3
  101. package/dist/types/retrieval.d.ts.map +1 -1
  102. package/dist/types/runtime-activation.d.ts +18 -0
  103. package/dist/types/runtime-activation.d.ts.map +1 -0
  104. package/dist/types/runtime-activation.js +20 -0
  105. package/dist/types/runtime-activation.js.map +1 -0
  106. package/dist/types/semantic-claims.d.ts +103 -0
  107. package/dist/types/semantic-claims.d.ts.map +1 -0
  108. package/dist/types/semantic-claims.js +2 -0
  109. package/dist/types/semantic-claims.js.map +1 -0
  110. package/dist/types/semantic-runtime.d.ts +48 -0
  111. package/dist/types/semantic-runtime.d.ts.map +1 -0
  112. package/dist/types/semantic-runtime.js +2 -0
  113. package/dist/types/semantic-runtime.js.map +1 -0
  114. package/dist/types/task-aggregate.d.ts +60 -0
  115. package/dist/types/task-aggregate.d.ts.map +1 -0
  116. package/dist/types/task-aggregate.js +2 -0
  117. package/dist/types/task-aggregate.js.map +1 -0
  118. package/dist/types/task-context-envelope.d.ts +58 -9
  119. package/dist/types/task-context-envelope.d.ts.map +1 -1
  120. package/dist/types/task-definition.d.ts +27 -0
  121. package/dist/types/task-definition.d.ts.map +1 -0
  122. package/dist/types/task-definition.js +2 -0
  123. package/dist/types/task-definition.js.map +1 -0
  124. package/dist/types/task-evidence.d.ts +11 -0
  125. package/dist/types/task-evidence.d.ts.map +1 -0
  126. package/dist/types/task-evidence.js +2 -0
  127. package/dist/types/task-evidence.js.map +1 -0
  128. package/dist/types/task-semantic-control.d.ts +34 -14
  129. package/dist/types/task-semantic-control.d.ts.map +1 -1
  130. package/dist/utils/config.d.ts +2 -0
  131. package/dist/utils/config.d.ts.map +1 -1
  132. package/dist/utils/config.js.map +1 -1
  133. package/dist/utils/paths.d.ts.map +1 -1
  134. package/dist/utils/paths.js +2 -2
  135. package/dist/utils/paths.js.map +1 -1
  136. package/package.json +10 -3
  137. package/dist/action-lease.test.d.ts +0 -2
  138. package/dist/action-lease.test.d.ts.map +0 -1
  139. package/dist/action-lease.test.js +0 -67
  140. package/dist/action-lease.test.js.map +0 -1
  141. package/dist/canonical-action-binding.test.d.ts +0 -2
  142. package/dist/canonical-action-binding.test.d.ts.map +0 -1
  143. package/dist/canonical-action-binding.test.js +0 -42
  144. package/dist/canonical-action-binding.test.js.map +0 -1
  145. package/dist/capability-rollout.test.d.ts +0 -2
  146. package/dist/capability-rollout.test.d.ts.map +0 -1
  147. package/dist/capability-rollout.test.js +0 -209
  148. package/dist/capability-rollout.test.js.map +0 -1
  149. package/dist/data/LocalDataProvider.d.ts +0 -68
  150. package/dist/data/LocalDataProvider.d.ts.map +0 -1
  151. package/dist/data/LocalDataProvider.js +0 -330
  152. package/dist/data/LocalDataProvider.js.map +0 -1
  153. package/dist/data/LocalDataProvider.test.d.ts +0 -2
  154. package/dist/data/LocalDataProvider.test.d.ts.map +0 -1
  155. package/dist/data/LocalDataProvider.test.js +0 -128
  156. package/dist/data/LocalDataProvider.test.js.map +0 -1
  157. package/dist/data/default-enforcer-rules.d.ts +0 -5
  158. package/dist/data/default-enforcer-rules.d.ts.map +0 -1
  159. package/dist/data/default-enforcer-rules.js +0 -167
  160. package/dist/data/default-enforcer-rules.js.map +0 -1
  161. package/dist/data/devflow-schema.d.ts +0 -3
  162. package/dist/data/devflow-schema.d.ts.map +0 -1
  163. package/dist/data/devflow-schema.js +0 -78
  164. package/dist/data/devflow-schema.js.map +0 -1
  165. package/dist/embedding-provider-contract.test.d.ts +0 -2
  166. package/dist/embedding-provider-contract.test.d.ts.map +0 -1
  167. package/dist/embedding-provider-contract.test.js +0 -11
  168. package/dist/embedding-provider-contract.test.js.map +0 -1
  169. package/dist/host-adapter.test.d.ts +0 -2
  170. package/dist/host-adapter.test.d.ts.map +0 -1
  171. package/dist/host-adapter.test.js +0 -367
  172. package/dist/host-adapter.test.js.map +0 -1
  173. package/dist/interfaces/IDataProvider.test.d.ts +0 -2
  174. package/dist/interfaces/IDataProvider.test.d.ts.map +0 -1
  175. package/dist/interfaces/IDataProvider.test.js +0 -20
  176. package/dist/interfaces/IDataProvider.test.js.map +0 -1
  177. package/dist/model-recommendation.test.d.ts +0 -2
  178. package/dist/model-recommendation.test.d.ts.map +0 -1
  179. package/dist/model-recommendation.test.js +0 -29
  180. package/dist/model-recommendation.test.js.map +0 -1
  181. package/dist/paths.test.d.ts +0 -2
  182. package/dist/paths.test.d.ts.map +0 -1
  183. package/dist/paths.test.js +0 -32
  184. package/dist/paths.test.js.map +0 -1
  185. package/dist/plugin-loader.test.d.ts +0 -2
  186. package/dist/plugin-loader.test.d.ts.map +0 -1
  187. package/dist/plugin-loader.test.js +0 -55
  188. package/dist/plugin-loader.test.js.map +0 -1
  189. package/dist/plugin-runtime.test.d.ts +0 -2
  190. package/dist/plugin-runtime.test.d.ts.map +0 -1
  191. package/dist/plugin-runtime.test.js +0 -47
  192. package/dist/plugin-runtime.test.js.map +0 -1
  193. package/dist/project-capability-profile.test.d.ts +0 -2
  194. package/dist/project-capability-profile.test.d.ts.map +0 -1
  195. package/dist/project-capability-profile.test.js +0 -80
  196. package/dist/project-capability-profile.test.js.map +0 -1
  197. package/dist/semantic-resolution.test.d.ts +0 -2
  198. package/dist/semantic-resolution.test.d.ts.map +0 -1
  199. package/dist/semantic-resolution.test.js +0 -106
  200. package/dist/semantic-resolution.test.js.map +0 -1
  201. package/dist/skill-overlay.d.ts +0 -41
  202. package/dist/skill-overlay.d.ts.map +0 -1
  203. package/dist/skill-overlay.js +0 -219
  204. package/dist/skill-overlay.js.map +0 -1
  205. package/dist/skill-overlay.test.d.ts +0 -2
  206. package/dist/skill-overlay.test.d.ts.map +0 -1
  207. package/dist/skill-overlay.test.js +0 -70
  208. package/dist/skill-overlay.test.js.map +0 -1
  209. package/dist/task-runtime-store.d.ts +0 -34
  210. package/dist/task-runtime-store.d.ts.map +0 -1
  211. package/dist/task-runtime-store.js +0 -126
  212. package/dist/task-runtime-store.js.map +0 -1
  213. package/dist/task-runtime.test.d.ts +0 -2
  214. package/dist/task-runtime.test.d.ts.map +0 -1
  215. package/dist/task-runtime.test.js +0 -60
  216. package/dist/task-runtime.test.js.map +0 -1
  217. package/dist/types/memory.test.d.ts +0 -2
  218. package/dist/types/memory.test.d.ts.map +0 -1
  219. package/dist/types/memory.test.js +0 -13
  220. package/dist/types/memory.test.js.map +0 -1
  221. package/dist/types/retrieval-session.test.d.ts +0 -2
  222. package/dist/types/retrieval-session.test.d.ts.map +0 -1
  223. package/dist/types/retrieval-session.test.js +0 -17
  224. package/dist/types/retrieval-session.test.js.map +0 -1
@@ -1,47 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import { resolvePluginCandidates, validatePluginToolClosure, } from "./plugin-runtime.js";
3
- describe("profile-aware plugin runtime", () => {
4
- it("filters only in on mode and preserves explicit selections", () => {
5
- const base = {
6
- projectRoot: process.cwd(),
7
- capabilityProfile: {
8
- projectRoot: process.cwd(),
9
- explicitPlugins: ["@devflow-tools/plugin-performance"],
10
- detectedStacks: ["react"],
11
- selectedPlugins: ["@devflow-tools/plugin-performance", "@devflow-tools/plugin-react"],
12
- confidence: "explicit",
13
- evidence: [],
14
- fallbackToFullRegistry: false,
15
- fingerprint: "profile",
16
- },
17
- };
18
- const full = resolvePluginCandidates({ ...base, rolloutMode: "shadow" });
19
- const selected = resolvePluginCandidates({ ...base, rolloutMode: "on" });
20
- expect(full.length).toBeGreaterThan(selected.length);
21
- expect(selected.map((candidate) => candidate.packageName)).toEqual([
22
- "@devflow-tools/plugin-performance",
23
- "@devflow-tools/plugin-react",
24
- ]);
25
- });
26
- it("falls back to full candidates for degraded profiles", () => {
27
- const candidates = resolvePluginCandidates({
28
- projectRoot: process.cwd(),
29
- rolloutMode: "on",
30
- capabilityProfile: {
31
- projectRoot: process.cwd(), explicitPlugins: [], detectedStacks: [], selectedPlugins: [],
32
- confidence: "degraded", evidence: [], fallbackToFullRegistry: true, fingerprint: "degraded",
33
- },
34
- });
35
- expect(candidates.length).toBeGreaterThan(10);
36
- });
37
- it("detects missing tools in the selected plugin closure", () => {
38
- const plugin = {
39
- meta: { name: "closure", version: "1.0.0", description: "", tags: [] },
40
- knowledge: { sources: [] },
41
- prompt: { requiredTools: ["missing_tool"] },
42
- };
43
- expect(validatePluginToolClosure([plugin], ["get_project_context"]))
44
- .toEqual(["closure requires unavailable tool missing_tool"]);
45
- });
46
- });
47
- //# sourceMappingURL=plugin-runtime.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"plugin-runtime.test.js","sourceRoot":"","sources":["../src/plugin-runtime.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAE1B,MAAM,qBAAqB,CAAC;AAG7B,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,IAAI,GAAyB;YACjC,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;YAC1B,iBAAiB,EAAE;gBACjB,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;gBAC1B,eAAe,EAAE,CAAC,mCAAmC,CAAC;gBACtD,cAAc,EAAE,CAAC,OAAO,CAAC;gBACzB,eAAe,EAAE,CAAC,mCAAmC,EAAE,6BAA6B,CAAC;gBACrF,UAAU,EAAE,UAAU;gBACtB,QAAQ,EAAE,EAAE;gBACZ,sBAAsB,EAAE,KAAK;gBAC7B,WAAW,EAAE,SAAS;aACvB;SACF,CAAC;QACF,MAAM,IAAI,GAAG,uBAAuB,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,uBAAuB,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;YACjE,mCAAmC;YACnC,6BAA6B;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,UAAU,GAAG,uBAAuB,CAAC;YACzC,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;YAC1B,WAAW,EAAE,IAAI;YACjB,iBAAiB,EAAE;gBACjB,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE;gBACxF,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU;aAC5F;SACF,CAAC,CAAC;QACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YACtE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC1B,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE;SACpB,CAAC;QAC1B,MAAM,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC;aACjE,OAAO,CAAC,CAAC,gDAAgD,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=project-capability-profile.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"project-capability-profile.test.d.ts","sourceRoot":"","sources":["../src/project-capability-profile.test.ts"],"names":[],"mappings":""}
@@ -1,80 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
2
- import { mkdirSync, rmSync, writeFileSync } from "node:fs";
3
- import { join } from "node:path";
4
- import { tmpdir } from "node:os";
5
- import { resolveProjectCapabilityProfile, } from "./project-capability-profile.js";
6
- const registry = {
7
- version: "1.0.0",
8
- plugins: [
9
- { name: "@devflow-tools/plugin-react", compatibleStacks: ["react"] },
10
- { name: "@devflow-tools/plugin-nextjs", compatibleStacks: ["nextjs"] },
11
- { name: "@devflow-tools/plugin-vue", compatibleStacks: ["vue"] },
12
- { name: "@devflow-tools/plugin-nest", compatibleStacks: ["nest"] },
13
- { name: "@devflow-tools/plugin-tailwind", compatibleStacks: ["tailwind"] },
14
- { name: "@devflow-tools/plugin-graphql", compatibleStacks: ["graphql"] },
15
- { name: "@devflow-tools/plugin-docker", compatibleStacks: ["docker"] },
16
- { name: "@devflow-tools/plugin-git", compatibleStacks: ["git"] },
17
- ],
18
- };
19
- describe("project capability profile", () => {
20
- let root;
21
- beforeEach(() => {
22
- root = join(tmpdir(), `devflow-profile-${process.pid}-${Date.now()}-${Math.random()}`);
23
- mkdirSync(root, { recursive: true });
24
- });
25
- afterEach(() => rmSync(root, { recursive: true, force: true }));
26
- it("selects exact registry plugins from dependencies and markers", () => {
27
- writeFileSync(join(root, "package.json"), JSON.stringify({
28
- dependencies: { react: "19", next: "15", tailwindcss: "4", graphql: "16" },
29
- devDependencies: { "@nestjs/core": "10" },
30
- }));
31
- writeFileSync(join(root, "Dockerfile"), "FROM node:22\n");
32
- const profile = resolveProjectCapabilityProfile(root, { registry });
33
- expect(profile.detectedStacks).toEqual(expect.arrayContaining([
34
- "react", "nextjs", "tailwind", "graphql", "nest", "docker",
35
- ]));
36
- expect(profile.selectedPlugins).toEqual(expect.arrayContaining([
37
- "@devflow-tools/plugin-react",
38
- "@devflow-tools/plugin-nextjs",
39
- "@devflow-tools/plugin-tailwind",
40
- "@devflow-tools/plugin-graphql",
41
- "@devflow-tools/plugin-nest",
42
- "@devflow-tools/plugin-docker",
43
- ]));
44
- expect(profile.selectedPlugins).not.toContain("@devflow-tools/plugin-git");
45
- expect(profile.confidence).toBe("high");
46
- });
47
- it("detects Vue and GraphQL source extensions", () => {
48
- mkdirSync(join(root, "src"), { recursive: true });
49
- writeFileSync(join(root, "src", "App.vue"), "<template />");
50
- writeFileSync(join(root, "src", "query.graphql"), "query Q { id }");
51
- const profile = resolveProjectCapabilityProfile(root, { registry });
52
- expect(profile.detectedStacks).toEqual(expect.arrayContaining(["vue", "graphql"]));
53
- });
54
- it("keeps explicit plugins authoritative", () => {
55
- mkdirSync(join(root, ".devflow"), { recursive: true });
56
- writeFileSync(join(root, ".devflow", "config.json"), JSON.stringify({ plugins: ["performance"] }));
57
- const profile = resolveProjectCapabilityProfile(root, { registry });
58
- expect(profile.explicitPlugins).toEqual(["@devflow-tools/plugin-performance"]);
59
- expect(profile.selectedPlugins).toEqual(["@devflow-tools/plugin-performance"]);
60
- expect(profile.confidence).toBe("explicit");
61
- });
62
- it("falls back to the full registry after malformed project evidence", () => {
63
- writeFileSync(join(root, "package.json"), "not-json");
64
- const malformedPackage = resolveProjectCapabilityProfile(root, { registry });
65
- expect(malformedPackage.fallbackToFullRegistry).toBe(true);
66
- expect(malformedPackage.confidence).toBe("degraded");
67
- const missingRegistry = resolveProjectCapabilityProfile(root, {
68
- registryPath: join(root, "missing-registry.json"),
69
- });
70
- expect(missingRegistry.fallbackToFullRegistry).toBe(true);
71
- });
72
- it("produces a deterministic fingerprint", () => {
73
- writeFileSync(join(root, "package.json"), JSON.stringify({ dependencies: { react: "19" } }));
74
- const first = resolveProjectCapabilityProfile(root, { registry });
75
- const second = resolveProjectCapabilityProfile(root, { registry });
76
- expect(second.fingerprint).toBe(first.fingerprint);
77
- expect(first.selectedPlugins).toEqual(["@devflow-tools/plugin-react"]);
78
- });
79
- });
80
- //# sourceMappingURL=project-capability-profile.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"project-capability-profile.test.js","sourceRoot":"","sources":["../src/project-capability-profile.test.ts"],"names":[],"mappings":"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"}
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=semantic-resolution.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"semantic-resolution.test.d.ts","sourceRoot":"","sources":["../src/semantic-resolution.test.ts"],"names":[],"mappings":""}
@@ -1,106 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { createTaskSemanticFrameV2, projectSemanticFrameToLegacyIntent, semanticEvidenceId, semanticTextHash, } from './semantic-resolution.js';
3
- describe('semantic resolution contracts', () => {
4
- it('accepts a valid resolved analysis frame', () => {
5
- const prompt = 'explain the cache design';
6
- const frame = createTaskSemanticFrameV2(frameInput(prompt), prompt);
7
- expect(frame.frameHash).toMatch(/^[a-f0-9]{64}$/u);
8
- expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
9
- intent: 'understand', action: 'analyze', mutating: false,
10
- });
11
- });
12
- it('rejects a forged source span', () => {
13
- const prompt = 'publish 0.18.0';
14
- const evidence = span(prompt, 'publish', 'action', 'release');
15
- evidence.textHash = semanticTextHash('forged');
16
- expect(() => createTaskSemanticFrameV2(frameInput(prompt, {
17
- primaryIntent: 'feature',
18
- primaryAction: 'release',
19
- mutationPermission: 'explicitly_authorized',
20
- evidence: [evidence],
21
- }), prompt)).toThrow('SEMANTIC_EVIDENCE_HASH_MISMATCH');
22
- });
23
- it('rejects model-only mutation with no action span', () => {
24
- const prompt = 'ship it';
25
- expect(() => createTaskSemanticFrameV2(frameInput(prompt, {
26
- primaryIntent: 'feature',
27
- primaryAction: 'release',
28
- mutationPermission: 'explicitly_authorized',
29
- }), prompt)).toThrow('SEMANTIC_ACTION_EVIDENCE_REQUIRED');
30
- });
31
- it('preserves conditional steps as non-authorized', () => {
32
- const prompt = 'if tests pass, publish';
33
- const condition = span(prompt, 'if tests pass', 'condition', 'tests_pass');
34
- const action = span(prompt, 'publish', 'action', 'release');
35
- const frame = createTaskSemanticFrameV2(frameInput(prompt, {
36
- primaryIntent: 'feature',
37
- primaryAction: 'release',
38
- mutationPermission: 'conditional',
39
- evidence: [condition, action],
40
- steps: [{
41
- order: 0,
42
- action: 'release',
43
- condition: 'tests_pass',
44
- mutationPermission: 'conditional',
45
- evidenceIds: [semanticEvidenceId(condition), semanticEvidenceId(action)],
46
- }],
47
- }), prompt);
48
- expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
49
- intent: 'feature', action: 'analyze', mutating: false,
50
- });
51
- });
52
- it('projects an abstained frame to non-mutating analyze', () => {
53
- const prompt = 'do it';
54
- const frame = createTaskSemanticFrameV2(frameInput(prompt, {
55
- state: 'abstained',
56
- primaryIntent: 'unknown',
57
- primaryAction: 'modify',
58
- mutationPermission: 'ambiguous',
59
- outOfScope: true,
60
- }), prompt);
61
- expect(projectSemanticFrameToLegacyIntent(frame)).toEqual({
62
- intent: 'unknown', action: 'analyze', mutating: false,
63
- });
64
- });
65
- });
66
- function frameInput(prompt, overrides = {}) {
67
- return {
68
- schemaVersion: 'task-semantic-frame.v2',
69
- sourceHash: semanticTextHash(prompt),
70
- state: 'resolved',
71
- primaryIntent: 'understand',
72
- primaryAction: 'analyze',
73
- mutationPermission: 'not_requested',
74
- intents: ['understand'],
75
- entities: [],
76
- targetAnchors: [],
77
- constraints: [],
78
- negations: [],
79
- steps: [],
80
- memoryDirective: 'none',
81
- knowledgeNeeds: [],
82
- outOfScope: false,
83
- confidence: { overall: 0.9, perField: { intent: 0.9 } },
84
- evidence: [],
85
- resolver: {
86
- generatedBy: 'deterministic',
87
- routeCatalogVersion: 'test-catalog.v1',
88
- thresholdVersion: 'test-threshold.v1',
89
- },
90
- createdAt: 1,
91
- ...overrides,
92
- };
93
- }
94
- function span(prompt, text, field, value) {
95
- const start = prompt.indexOf(text);
96
- return {
97
- field,
98
- source: 'lexical_feature',
99
- value,
100
- start,
101
- end: start + text.length,
102
- textHash: semanticTextHash(text),
103
- confidence: 1,
104
- };
105
- }
106
- //# sourceMappingURL=semantic-resolution.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"semantic-resolution.test.js","sourceRoot":"","sources":["../src/semantic-resolution.test.ts"],"names":[],"mappings":"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"}
@@ -1,41 +0,0 @@
1
- import { type DevFlowDatabase } from '@devflow-tools/database';
2
- import { type RolloutMode } from './capability-rollout.js';
3
- export interface PackageVersionEvidence {
4
- packageName: string;
5
- declaredRange?: string;
6
- resolvedVersion?: string;
7
- evidencePath?: string;
8
- confidence: 'high' | 'medium' | 'unknown';
9
- }
10
- export interface SkillRuntimeOverlay {
11
- skillName: string;
12
- projectRoot: string;
13
- packages: PackageVersionEvidence[];
14
- learned: LearnedSkillOverlayEntry[];
15
- shadowEligible: LearnedSkillOverlayEntry[];
16
- rolloutMode: RolloutMode;
17
- }
18
- export interface LearnedSkillOverlayEntry {
19
- candidateId: string;
20
- version: number;
21
- state: 'shadow' | 'active';
22
- instruction: string;
23
- trigger: Record<string, unknown>;
24
- confidence: number;
25
- evidenceReceipt: string;
26
- expiresAt?: number;
27
- }
28
- export interface SkillRuntimeOverlayOptions {
29
- prompt?: string;
30
- command?: string;
31
- files?: string[];
32
- now?: number;
33
- maxLearnedEntries?: number;
34
- learnedCharacterBudget?: number;
35
- database?: DevFlowDatabase;
36
- rolloutMode?: RolloutMode;
37
- }
38
- export declare function detectPackageVersion(projectRoot: string, packageName: string): PackageVersionEvidence;
39
- export declare function createSkillRuntimeOverlay(skillName: string, projectRoot: string, options?: SkillRuntimeOverlayOptions): SkillRuntimeOverlay;
40
- export declare function formatSkillRuntimeOverlay(overlay: SkillRuntimeOverlay): string;
41
- //# sourceMappingURL=skill-overlay.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-overlay.d.ts","sourceRoot":"","sources":["../src/skill-overlay.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,cAAc,EAAE,wBAAwB,EAAE,CAAC;IAC3C,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAaD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,sBAAsB,CA0BrG;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CA+CrB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAkB9E"}
@@ -1,219 +0,0 @@
1
- import { existsSync, readFileSync } from 'node:fs';
2
- import { join, relative } from 'node:path';
3
- import { openGlobalDevFlowDatabase, } from '@devflow-tools/database';
4
- import { resolveCapabilityRollout } from './capability-rollout.js';
5
- const SKILL_PACKAGES = {
6
- react: ['react', 'react-dom'],
7
- nextjs: ['next', 'react'],
8
- vue: ['vue'],
9
- nest: ['@nestjs/core'],
10
- tailwind: ['tailwindcss'],
11
- taro: ['@tarojs/taro'],
12
- electron: ['electron'],
13
- graphql: ['graphql'],
14
- };
15
- export function detectPackageVersion(projectRoot, packageName) {
16
- const packagePath = join(projectRoot, 'package.json');
17
- const packageJson = readJson(packagePath);
18
- const declaredRange = readDeclaredRange(packageJson, packageName);
19
- const packageLockPath = join(projectRoot, 'package-lock.json');
20
- const packageLock = readJson(packageLockPath);
21
- const resolvedVersion = readPackageLockVersion(packageLock, packageName);
22
- if (resolvedVersion) {
23
- return {
24
- packageName,
25
- ...(declaredRange ? { declaredRange } : {}),
26
- resolvedVersion,
27
- evidencePath: relative(projectRoot, packageLockPath) || 'package-lock.json',
28
- confidence: 'high',
29
- };
30
- }
31
- if (declaredRange) {
32
- return {
33
- packageName,
34
- declaredRange,
35
- evidencePath: relative(projectRoot, packagePath) || 'package.json',
36
- confidence: 'medium',
37
- };
38
- }
39
- return { packageName, confidence: 'unknown' };
40
- }
41
- export function createSkillRuntimeOverlay(skillName, projectRoot, options = {}) {
42
- const family = skillName.replace(/^devflow:/, '').split(':').pop() ?? skillName;
43
- const packages = (SKILL_PACKAGES[family] ?? []).map(packageName => detectPackageVersion(projectRoot, packageName));
44
- const rolloutMode = options.rolloutMode ?? resolveCapabilityRollout(projectRoot).config.learningOverlays;
45
- if (rolloutMode === 'off') {
46
- return { skillName, projectRoot, packages, learned: [], shadowEligible: [], rolloutMode };
47
- }
48
- const database = options.database ?? openGlobalDevFlowDatabase(undefined, { busyTimeoutMs: 50 });
49
- try {
50
- const candidates = database.listLearningCandidates({
51
- projectRoot,
52
- states: ['shadow', 'evaluated', 'active'],
53
- limit: 100,
54
- });
55
- const matched = candidates
56
- .filter(candidate => candidate.projectRoot === projectRoot || candidate.scope === 'global')
57
- .filter(candidate => !candidate.expiresAt || candidate.expiresAt > (options.now ?? Date.now()))
58
- .filter(candidate => matchesLearnedTrigger(candidate, skillName, options))
59
- .sort((left, right) => right.confidence - left.confidence || right.updatedAt - left.updatedAt);
60
- const eligible = boundLearnedEntries(matched.map(candidate => toLearnedEntry(candidate, candidate.state === 'active' ? 'active' : 'shadow')), options);
61
- const learned = rolloutMode === 'on'
62
- ? eligible.filter(entry => entry.state === 'active')
63
- : [];
64
- const shadowEligible = eligible.filter(entry => entry.state === 'shadow' || rolloutMode === 'shadow');
65
- try {
66
- database.insertEvent({
67
- kind: 'learning_overlay_match',
68
- timestamp: Date.now(),
69
- success: true,
70
- metadata: {
71
- projectRoot,
72
- skillName,
73
- rolloutMode,
74
- eligible: eligible.map(entry => `${entry.candidateId}@${entry.version}`),
75
- injected: learned.map(entry => `${entry.candidateId}@${entry.version}`),
76
- },
77
- });
78
- }
79
- catch { }
80
- return { skillName, projectRoot, packages, learned, shadowEligible, rolloutMode };
81
- }
82
- finally {
83
- if (!options.database)
84
- database.close();
85
- }
86
- }
87
- export function formatSkillRuntimeOverlay(overlay) {
88
- const sections = [];
89
- const evidence = overlay.packages.map(item => {
90
- const version = item.resolvedVersion ?? item.declaredRange ?? 'unknown';
91
- return `${item.packageName}=${version} (confidence=${item.confidence}${item.evidencePath ? `, source=${item.evidencePath}` : ''})`;
92
- }).join('; ');
93
- if (evidence) {
94
- sections.push(`DevFlow runtime project-version evidence for ${overlay.skillName}: ${evidence}. `
95
- + 'Treat target-project evidence as authoritative; do not apply a hardcoded framework version.');
96
- }
97
- if (overlay.learned.length > 0) {
98
- sections.push([
99
- `DevFlow governed project instructions for ${overlay.skillName}:`,
100
- ...overlay.learned.map(entry => `- ${entry.instruction}`),
101
- 'Apply only to this request and keep canonical Skill/MCP requirements unchanged.',
102
- ].join('\n'));
103
- }
104
- return sections.join('\n');
105
- }
106
- function toLearnedEntry(candidate, state) {
107
- return {
108
- candidateId: candidate.id,
109
- version: candidate.overlayVersion,
110
- state,
111
- instruction: candidate.instruction,
112
- trigger: candidate.trigger,
113
- confidence: candidate.confidence,
114
- evidenceReceipt: candidate.graderReceipt ?? `candidate:${candidate.id}:v${candidate.overlayVersion}`,
115
- expiresAt: candidate.expiresAt,
116
- };
117
- }
118
- function boundLearnedEntries(entries, options) {
119
- const maxEntries = Math.max(0, Math.min(options.maxLearnedEntries ?? 3, 3));
120
- const budget = Math.max(0, Math.min(options.learnedCharacterBudget ?? 1_600, 4_000));
121
- const selected = [];
122
- let used = 0;
123
- for (const entry of entries) {
124
- if (selected.length >= maxEntries)
125
- break;
126
- const cost = entry.instruction.length + 4;
127
- if (used + cost > budget)
128
- continue;
129
- selected.push(entry);
130
- used += cost;
131
- }
132
- return selected;
133
- }
134
- function matchesLearnedTrigger(candidate, skillName, options) {
135
- const trigger = candidate.trigger;
136
- const family = skillName.replace(/^devflow:/, '').split(':').pop() ?? skillName;
137
- const skills = stringArray(trigger.skills);
138
- if (skills.length > 0 && !skills.some(skill => skill === skillName || skill === family || skill.endsWith(`:${family}`))) {
139
- return false;
140
- }
141
- const prompt = (options.prompt ?? '').normalize('NFKC').toLocaleLowerCase('en-US');
142
- const command = (options.command ?? '').normalize('NFKC').toLocaleLowerCase('en-US');
143
- const files = [...(options.files ?? []), ...extractPromptFiles(options.prompt ?? '')]
144
- .map(file => file.replaceAll('\\', '/').toLocaleLowerCase('en-US'));
145
- const commands = stringArray(trigger.commands).map(normalizeTriggerValue);
146
- if (commands.length > 0 && !commands.some(value => command.includes(value) || prompt.includes(value)))
147
- return false;
148
- const entities = stringArray(trigger.entities).map(normalizeTriggerValue);
149
- if (entities.length > 0 && !entities.some(value => prompt.includes(value) || command.includes(value)))
150
- return false;
151
- const patterns = stringArray(trigger.files).map(value => value.replaceAll('\\', '/').toLocaleLowerCase('en-US'));
152
- if (patterns.length > 0 && !patterns.some(pattern => files.some(file => fileMatchesPattern(file, pattern))))
153
- return false;
154
- return true;
155
- }
156
- function extractPromptFiles(prompt) {
157
- return prompt.match(/(?:^|\s)((?:src|app|apps|packages|plugins|lib|test|tests)\/[A-Za-z0-9_./@-]+)/gu)
158
- ?.map(value => value.trim()) ?? [];
159
- }
160
- function fileMatchesPattern(file, pattern) {
161
- if (!pattern.includes('*'))
162
- return file === pattern || file.includes(pattern);
163
- const escaped = pattern.replace(/[.+?^${}()|[\]\\]/gu, '\\$&').replaceAll('*', '.*');
164
- return new RegExp(`^${escaped}$`, 'u').test(file);
165
- }
166
- function stringArray(value) {
167
- return Array.isArray(value)
168
- ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
169
- : [];
170
- }
171
- function normalizeTriggerValue(value) {
172
- return value.normalize('NFKC').trim().toLocaleLowerCase('en-US');
173
- }
174
- function readJson(path) {
175
- if (!existsSync(path))
176
- return null;
177
- try {
178
- const value = JSON.parse(readFileSync(path, 'utf8'));
179
- return value && typeof value === 'object' && !Array.isArray(value)
180
- ? value
181
- : null;
182
- }
183
- catch {
184
- return null;
185
- }
186
- }
187
- function readDeclaredRange(packageJson, packageName) {
188
- for (const field of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
189
- const collection = packageJson?.[field];
190
- if (!collection || typeof collection !== 'object' || Array.isArray(collection))
191
- continue;
192
- const value = collection[packageName];
193
- if (typeof value === 'string' && value.trim())
194
- return value.trim();
195
- }
196
- return undefined;
197
- }
198
- function readPackageLockVersion(packageLock, packageName) {
199
- const packages = packageLock?.packages;
200
- if (packages && typeof packages === 'object' && !Array.isArray(packages)) {
201
- const entry = packages[`node_modules/${packageName}`];
202
- if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
203
- const version = entry.version;
204
- if (typeof version === 'string' && version.trim())
205
- return version.trim();
206
- }
207
- }
208
- const dependencies = packageLock?.dependencies;
209
- if (dependencies && typeof dependencies === 'object' && !Array.isArray(dependencies)) {
210
- const entry = dependencies[packageName];
211
- if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
212
- const version = entry.version;
213
- if (typeof version === 'string' && version.trim())
214
- return version.trim();
215
- }
216
- }
217
- return undefined;
218
- }
219
- //# sourceMappingURL=skill-overlay.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-overlay.js","sourceRoot":"","sources":["../src/skill-overlay.ts"],"names":[],"mappings":"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"}
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=skill-overlay.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-overlay.test.d.ts","sourceRoot":"","sources":["../src/skill-overlay.test.ts"],"names":[],"mappings":""}
@@ -1,70 +0,0 @@
1
- import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
2
- import { tmpdir } from 'node:os';
3
- import { join } from 'node:path';
4
- import { afterEach, describe, expect, it } from 'vitest';
5
- import { createSkillRuntimeOverlay, formatSkillRuntimeOverlay } from './skill-overlay.js';
6
- import { DevFlowDatabase } from '@devflow-tools/database';
7
- describe('skill runtime overlay', () => {
8
- const roots = [];
9
- afterEach(() => {
10
- for (const root of roots.splice(0))
11
- rmSync(root, { recursive: true, force: true });
12
- });
13
- it('uses the resolved target-project React version as authoritative evidence', () => {
14
- const root = mkdtempSync(join(tmpdir(), 'devflow-skill-overlay-'));
15
- roots.push(root);
16
- writeFileSync(join(root, 'package.json'), JSON.stringify({ dependencies: { react: '^19.0.0', 'react-dom': '^19.0.0' } }));
17
- writeFileSync(join(root, 'package-lock.json'), JSON.stringify({
18
- lockfileVersion: 3,
19
- packages: {
20
- 'node_modules/react': { version: '19.1.0' },
21
- 'node_modules/react-dom': { version: '19.1.0' },
22
- },
23
- }));
24
- const overlay = createSkillRuntimeOverlay('devflow:react', root);
25
- expect(overlay.packages).toEqual([
26
- expect.objectContaining({ packageName: 'react', declaredRange: '^19.0.0', resolvedVersion: '19.1.0', confidence: 'high' }),
27
- expect.objectContaining({ packageName: 'react-dom', resolvedVersion: '19.1.0', confidence: 'high' }),
28
- ]);
29
- expect(formatSkillRuntimeOverlay(overlay)).toContain('react=19.1.0');
30
- expect(formatSkillRuntimeOverlay(overlay)).toContain('target-project evidence as authoritative');
31
- });
32
- it('reports unknown instead of guessing a missing framework version', () => {
33
- const root = mkdtempSync(join(tmpdir(), 'devflow-skill-overlay-unknown-'));
34
- roots.push(root);
35
- writeFileSync(join(root, 'package.json'), JSON.stringify({}));
36
- expect(formatSkillRuntimeOverlay(createSkillRuntimeOverlay('devflow:react', root)))
37
- .toContain('react=unknown');
38
- });
39
- it('injects only active project-matched learned entries', () => {
40
- const root = mkdtempSync(join(tmpdir(), 'devflow-skill-overlay-learned-'));
41
- roots.push(root);
42
- writeFileSync(join(root, 'package.json'), JSON.stringify({ dependencies: { react: '^19.0.0' } }));
43
- const database = new DevFlowDatabase(root);
44
- const id = 'candidate:overlay';
45
- database.upsertLearningCandidate({
46
- id, projectRoot: root, scope: 'project', kind: 'tool_preference',
47
- trigger: { skills: ['devflow:react'], entities: ['--legacy-peer-deps'] },
48
- instruction: 'Use --legacy-peer-deps for dependency installation.', confidence: 0.95,
49
- });
50
- for (let index = 1; index <= 3; index += 1) {
51
- database.addLearningCandidateEvidence({
52
- id: `e:${index}`, candidateId: id, projectRoot: root, sessionId: `s:${index}`,
53
- sourceType: 'tool_preference', polarity: 'supporting', outcome: 'positive', evidenceHash: `h:${index}`,
54
- });
55
- }
56
- database.transitionLearningCandidate(id, { target: 'shadow', reason: 'threshold' });
57
- database.transitionLearningCandidate(id, { target: 'evaluated', reason: 'graded', graderReceipt: 'grader:overlay:12345678' });
58
- database.transitionLearningCandidate(id, { target: 'active', reason: 'activate' });
59
- const overlay = createSkillRuntimeOverlay('devflow:react', root, {
60
- prompt: 'Install dependencies with --legacy-peer-deps', database, rolloutMode: 'on',
61
- });
62
- expect(overlay.learned).toHaveLength(1);
63
- expect(formatSkillRuntimeOverlay(overlay)).toContain('Use --legacy-peer-deps');
64
- expect(createSkillRuntimeOverlay('devflow:vue', root, {
65
- prompt: 'Install dependencies with --legacy-peer-deps', database, rolloutMode: 'on',
66
- }).learned).toHaveLength(0);
67
- database.close();
68
- });
69
- });
70
- //# sourceMappingURL=skill-overlay.test.js.map