forgeos 0.1.0-alpha.0 → 0.1.0-alpha.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 (283) hide show
  1. package/.npmignore +9 -1
  2. package/AGENTS.md +6 -1
  3. package/CHANGELOG.md +30 -0
  4. package/CONTRIBUTING.md +22 -1
  5. package/README.md +30 -3
  6. package/bin/forge.mjs +4 -3
  7. package/package.json +3 -1
  8. package/packages/eslint-plugin-forge/index.ts +15 -15
  9. package/packages/eslint-plugin-forge/package.json +10 -10
  10. package/packages/eslint-plugin-forge/src/check-source.ts +95 -95
  11. package/packages/eslint-plugin-forge/src/load-artifacts.ts +24 -24
  12. package/packages/eslint-plugin-forge/src/rule-no-forge-guard-violation.ts +93 -93
  13. package/src/forge/_generated/actionSubscriptions.json +2 -2
  14. package/src/forge/_generated/actionSubscriptions.ts +3 -3
  15. package/src/forge/_generated/agentAdapterManifest.json +2 -2
  16. package/src/forge/_generated/agentAdapterManifest.ts +3 -3
  17. package/src/forge/_generated/agentContract.json +2 -2
  18. package/src/forge/_generated/agentContract.ts +6786 -2
  19. package/src/forge/_generated/agentQuickstart.md +1 -1
  20. package/src/forge/_generated/aiContext.ts +1 -1
  21. package/src/forge/_generated/aiModels.json +1 -1
  22. package/src/forge/_generated/aiModels.ts +1 -1
  23. package/src/forge/_generated/aiProviders.json +1 -1
  24. package/src/forge/_generated/aiProviders.ts +1 -1
  25. package/src/forge/_generated/aiRegistry.json +2 -2
  26. package/src/forge/_generated/aiRegistry.ts +3 -3
  27. package/src/forge/_generated/api.json +2 -2
  28. package/src/forge/_generated/api.ts +1 -1
  29. package/src/forge/_generated/appGraph.json +2 -2
  30. package/src/forge/_generated/appGraph.ts +1297 -1141
  31. package/src/forge/_generated/appMap.md +1 -1
  32. package/src/forge/_generated/artifactManifest.json +2 -2
  33. package/src/forge/_generated/artifactManifest.ts +2 -2
  34. package/src/forge/_generated/authClaims.json +1 -1
  35. package/src/forge/_generated/authClaims.ts +1 -1
  36. package/src/forge/_generated/authConfig.json +1 -1
  37. package/src/forge/_generated/authConfig.ts +1 -1
  38. package/src/forge/_generated/authContext.ts +1 -1
  39. package/src/forge/_generated/authRegistry.json +1 -1
  40. package/src/forge/_generated/authRegistry.ts +1 -1
  41. package/src/forge/_generated/buildInfo.json +2 -2
  42. package/src/forge/_generated/buildInfo.ts +4 -4
  43. package/src/forge/_generated/capabilityMap.json +2 -2
  44. package/src/forge/_generated/capabilityMap.md +1 -1
  45. package/src/forge/_generated/capabilityMap.ts +2 -2
  46. package/src/forge/_generated/client.ts +1 -1
  47. package/src/forge/_generated/clientApi.ts +1 -1
  48. package/src/forge/_generated/clientManifest.json +2 -2
  49. package/src/forge/_generated/clientManifest.ts +3 -3
  50. package/src/forge/_generated/clientTypes.ts +1 -1
  51. package/src/forge/_generated/configRegistry.json +1 -1
  52. package/src/forge/_generated/configRegistry.ts +1 -1
  53. package/src/forge/_generated/dataGraph.json +2 -2
  54. package/src/forge/_generated/dataGraph.ts +3 -3
  55. package/src/forge/_generated/db.json +1 -1
  56. package/src/forge/_generated/db.ts +1 -1
  57. package/src/forge/_generated/dbSecurityManifest.json +1 -1
  58. package/src/forge/_generated/dbSecurityManifest.ts +1 -1
  59. package/src/forge/_generated/dbSessionContext.json +1 -1
  60. package/src/forge/_generated/dbSessionContext.ts +1 -1
  61. package/src/forge/_generated/deployManifest.json +2 -2
  62. package/src/forge/_generated/deployManifest.ts +7 -7
  63. package/src/forge/_generated/devManifest.json +2 -2
  64. package/src/forge/_generated/devManifest.ts +3 -3
  65. package/src/forge/_generated/envSchema.json +1 -1
  66. package/src/forge/_generated/envSchema.ts +1 -1
  67. package/src/forge/_generated/frontendGraph.json +1 -1
  68. package/src/forge/_generated/frontendGraph.ts +1 -1
  69. package/src/forge/_generated/importGuards.json +2 -2
  70. package/src/forge/_generated/importGuards.ts +35 -1
  71. package/src/forge/_generated/index.ts +1 -1
  72. package/src/forge/_generated/liveProductionManifest.json +1 -1
  73. package/src/forge/_generated/liveProductionManifest.ts +1 -1
  74. package/src/forge/_generated/liveProtocol.json +1 -1
  75. package/src/forge/_generated/liveProtocol.ts +1 -1
  76. package/src/forge/_generated/liveQueryRegistry.json +2 -2
  77. package/src/forge/_generated/liveQueryRegistry.ts +3 -3
  78. package/src/forge/_generated/liveTransportConfig.json +1 -1
  79. package/src/forge/_generated/liveTransportConfig.ts +1 -1
  80. package/src/forge/_generated/makeRegistry.json +2 -2
  81. package/src/forge/_generated/makeRegistry.ts +2 -2
  82. package/src/forge/_generated/makeTemplates.json +1 -1
  83. package/src/forge/_generated/makeTemplates.ts +1 -1
  84. package/src/forge/_generated/mockMap.json +1 -1
  85. package/src/forge/_generated/mockMap.ts +1 -1
  86. package/src/forge/_generated/operationPlaybooks.md +7 -5
  87. package/src/forge/_generated/packageGraph.json +2 -2
  88. package/src/forge/_generated/packageGraph.ts +90964 -14284
  89. package/src/forge/_generated/packageUpgradeRegistry.json +2 -2
  90. package/src/forge/_generated/packageUpgradeRegistry.ts +2 -2
  91. package/src/forge/_generated/permissionMatrix.json +2 -2
  92. package/src/forge/_generated/permissionMatrix.ts +3 -3
  93. package/src/forge/_generated/policyRegistry.json +2 -2
  94. package/src/forge/_generated/policyRegistry.ts +3 -3
  95. package/src/forge/_generated/queryRegistry.json +2 -2
  96. package/src/forge/_generated/queryRegistry.ts +3 -3
  97. package/src/forge/_generated/react.d.ts +1 -1
  98. package/src/forge/_generated/react.ts +1 -1
  99. package/src/forge/_generated/reactManifest.json +2 -2
  100. package/src/forge/_generated/reactManifest.ts +3 -3
  101. package/src/forge/_generated/releaseManifest.json +2 -2
  102. package/src/forge/_generated/releaseManifest.ts +3 -3
  103. package/src/forge/_generated/rlsPolicies.json +1 -1
  104. package/src/forge/_generated/rlsPolicies.sql +1 -1
  105. package/src/forge/_generated/rlsPolicies.ts +1 -1
  106. package/src/forge/_generated/runtimeGraph.json +2 -2
  107. package/src/forge/_generated/runtimeGraph.ts +3 -3
  108. package/src/forge/_generated/runtimeMatrix.json +2 -2
  109. package/src/forge/_generated/runtimeMatrix.ts +106177 -7917
  110. package/src/forge/_generated/runtimeRegistry.ts +1 -1
  111. package/src/forge/_generated/runtimeRules.md +1 -1
  112. package/src/forge/_generated/secretRegistry.json +1 -1
  113. package/src/forge/_generated/secretRegistry.ts +1 -1
  114. package/src/forge/_generated/secretsContext.ts +1 -1
  115. package/src/forge/_generated/serverApi.ts +1 -1
  116. package/src/forge/_generated/sourceMapManifest.json +2 -2
  117. package/src/forge/_generated/sourceMapManifest.ts +2 -2
  118. package/src/forge/_generated/sqlPlan.json +1 -1
  119. package/src/forge/_generated/sqlPlan.ts +1 -1
  120. package/src/forge/_generated/subscriptionManifest.json +2 -2
  121. package/src/forge/_generated/subscriptionManifest.ts +3 -3
  122. package/src/forge/_generated/symbolicationManifest.json +2 -2
  123. package/src/forge/_generated/symbolicationManifest.ts +2 -2
  124. package/src/forge/_generated/telemetryRegistry.json +2 -2
  125. package/src/forge/_generated/telemetryRegistry.ts +3 -3
  126. package/src/forge/_generated/telemetrySinks.json +2 -2
  127. package/src/forge/_generated/telemetrySinks.ts +2 -2
  128. package/src/forge/_generated/tenantScope.json +2 -2
  129. package/src/forge/_generated/tenantScope.ts +3 -3
  130. package/src/forge/_generated/testGraph.json +2 -2
  131. package/src/forge/_generated/testGraph.ts +129 -75
  132. package/src/forge/_generated/testPlanRegistry.json +2 -2
  133. package/src/forge/_generated/testPlanRegistry.ts +2 -2
  134. package/src/forge/_generated/uiRoutes.json +1 -1
  135. package/src/forge/_generated/uiRoutes.ts +1 -1
  136. package/src/forge/_generated/uiScenarios.json +1 -1
  137. package/src/forge/_generated/uiScenarios.ts +1 -1
  138. package/src/forge/_generated/uiTestManifest.json +2 -2
  139. package/src/forge/_generated/uiTestManifest.ts +2 -2
  140. package/src/forge/_generated/workflowRegistry.json +2 -2
  141. package/src/forge/_generated/workflowRegistry.ts +3 -3
  142. package/src/forge/_generated/workflowSubscriptions.json +2 -2
  143. package/src/forge/_generated/workflowSubscriptions.ts +3 -3
  144. package/src/forge/cli/commands.ts +861 -861
  145. package/src/forge/cli/deps.ts +178 -11
  146. package/src/forge/cli/dev.ts +32 -5
  147. package/src/forge/cli/index.ts +7 -7
  148. package/src/forge/cli/main.ts +54 -54
  149. package/src/forge/cli/new.ts +29 -1
  150. package/src/forge/cli/output.ts +97 -97
  151. package/src/forge/cli/parse.ts +679 -673
  152. package/src/forge/cli/version.ts +1 -1
  153. package/src/forge/compiler/agent-contract/build.ts +28 -0
  154. package/src/forge/compiler/agent-contract/types.ts +16 -0
  155. package/src/forge/compiler/app-graph/build.ts +112 -112
  156. package/src/forge/compiler/app-graph/classify.ts +10 -10
  157. package/src/forge/compiler/app-graph/dup-symbol.ts +29 -29
  158. package/src/forge/compiler/app-graph/extract.ts +123 -123
  159. package/src/forge/compiler/app-graph/forge-apis.ts +29 -29
  160. package/src/forge/compiler/app-graph/index.ts +11 -11
  161. package/src/forge/compiler/app-graph/module-graph.ts +316 -316
  162. package/src/forge/compiler/app-graph/parser.ts +119 -119
  163. package/src/forge/compiler/app-graph/symbols.ts +48 -48
  164. package/src/forge/compiler/app-graph/tsconfig-hash.ts +62 -62
  165. package/src/forge/compiler/app-graph/types.ts +43 -43
  166. package/src/forge/compiler/app-graph/versions.ts +14 -14
  167. package/src/forge/compiler/cache/index.ts +17 -17
  168. package/src/forge/compiler/cache/key.ts +46 -46
  169. package/src/forge/compiler/cache/scheduler.ts +72 -72
  170. package/src/forge/compiler/cache/store.ts +78 -78
  171. package/src/forge/compiler/classifier/capabilities.ts +78 -78
  172. package/src/forge/compiler/classifier/classify.ts +113 -113
  173. package/src/forge/compiler/classifier/contexts.ts +188 -188
  174. package/src/forge/compiler/classifier/index.ts +18 -18
  175. package/src/forge/compiler/classifier/runtime-matrix.ts +45 -45
  176. package/src/forge/compiler/classifier/secrets.ts +41 -41
  177. package/src/forge/compiler/classifier/signals.ts +129 -129
  178. package/src/forge/compiler/diagnostics/codes.ts +125 -120
  179. package/src/forge/compiler/diagnostics/create.ts +87 -87
  180. package/src/forge/compiler/diagnostics/index.ts +41 -41
  181. package/src/forge/compiler/emitter/artifact-kind.ts +14 -14
  182. package/src/forge/compiler/emitter/barrel.ts +38 -38
  183. package/src/forge/compiler/emitter/constants.ts +7 -7
  184. package/src/forge/compiler/emitter/emit.ts +234 -237
  185. package/src/forge/compiler/emitter/index.ts +24 -24
  186. package/src/forge/compiler/emitter/lock.ts +61 -61
  187. package/src/forge/compiler/emitter/render.ts +73 -73
  188. package/src/forge/compiler/guards/artifacts.ts +96 -96
  189. package/src/forge/compiler/guards/check-import-guards.ts +106 -106
  190. package/src/forge/compiler/guards/index.ts +11 -11
  191. package/src/forge/compiler/guards/propagate-contexts.ts +57 -57
  192. package/src/forge/compiler/index.ts +17 -17
  193. package/src/forge/compiler/integration/add.ts +493 -493
  194. package/src/forge/compiler/integration/index.ts +17 -17
  195. package/src/forge/compiler/integration/plan.ts +279 -279
  196. package/src/forge/compiler/integration/render.ts +189 -189
  197. package/src/forge/compiler/integration/snapshot.ts +52 -52
  198. package/src/forge/compiler/orchestrator/discover.ts +214 -214
  199. package/src/forge/compiler/orchestrator/guards.ts +5 -5
  200. package/src/forge/compiler/orchestrator/index.ts +27 -27
  201. package/src/forge/compiler/orchestrator/manifest.ts +69 -69
  202. package/src/forge/compiler/orchestrator/orphans.ts +51 -51
  203. package/src/forge/compiler/orchestrator/plan.ts +804 -804
  204. package/src/forge/compiler/orchestrator/run.ts +178 -178
  205. package/src/forge/compiler/orchestrator/serialize.ts +859 -859
  206. package/src/forge/compiler/orchestrator/types.ts +23 -23
  207. package/src/forge/compiler/orchestrator/verify.ts +35 -35
  208. package/src/forge/compiler/package-graph/capabilities-stub.ts +33 -33
  209. package/src/forge/compiler/package-graph/checksum.ts +107 -97
  210. package/src/forge/compiler/package-graph/compiler.ts +444 -363
  211. package/src/forge/compiler/package-graph/constants.ts +4 -4
  212. package/src/forge/compiler/package-graph/exports-discovery.ts +91 -84
  213. package/src/forge/compiler/package-graph/extract-dts.ts +32 -32
  214. package/src/forge/compiler/package-graph/index.ts +24 -24
  215. package/src/forge/compiler/package-graph/jsdoc.ts +50 -50
  216. package/src/forge/compiler/package-graph/oracle.ts +326 -0
  217. package/src/forge/compiler/package-graph/read-file.ts +21 -21
  218. package/src/forge/compiler/package-graph/resolve.ts +131 -127
  219. package/src/forge/compiler/package-manager/adapter.ts +232 -232
  220. package/src/forge/compiler/package-manager/commands.ts +47 -47
  221. package/src/forge/compiler/package-manager/detect.ts +65 -65
  222. package/src/forge/compiler/package-manager/executor.ts +29 -29
  223. package/src/forge/compiler/package-manager/index.ts +22 -22
  224. package/src/forge/compiler/package-manager/parse-spec.ts +16 -16
  225. package/src/forge/compiler/package-manager/version.ts +20 -20
  226. package/src/forge/compiler/primitives/compare.ts +26 -26
  227. package/src/forge/compiler/primitives/hash.ts +42 -33
  228. package/src/forge/compiler/primitives/header.ts +43 -43
  229. package/src/forge/compiler/primitives/index.ts +45 -45
  230. package/src/forge/compiler/primitives/paths.ts +24 -24
  231. package/src/forge/compiler/primitives/serialize.ts +66 -66
  232. package/src/forge/compiler/primitives/sort.ts +87 -87
  233. package/src/forge/compiler/recipes/definitions.ts +269 -269
  234. package/src/forge/compiler/recipes/helpers.ts +37 -37
  235. package/src/forge/compiler/recipes/index.ts +21 -21
  236. package/src/forge/compiler/recipes/registry.ts +87 -87
  237. package/src/forge/compiler/sandbox/artifact-sanitize.ts +26 -26
  238. package/src/forge/compiler/sandbox/backends/child.ts +123 -123
  239. package/src/forge/compiler/sandbox/backends/docker.ts +173 -173
  240. package/src/forge/compiler/sandbox/index.ts +51 -51
  241. package/src/forge/compiler/sandbox/inspect.ts +143 -143
  242. package/src/forge/compiler/sandbox/inspector-entry.ts +115 -115
  243. package/src/forge/compiler/sandbox/limits.ts +31 -31
  244. package/src/forge/compiler/sandbox/scrub-env.ts +60 -60
  245. package/src/forge/compiler/sandbox/secret-scan.ts +54 -54
  246. package/src/forge/compiler/sandbox/serialize.ts +106 -106
  247. package/src/forge/compiler/sandbox/types.ts +7 -7
  248. package/src/forge/compiler/types/app-graph.ts +71 -71
  249. package/src/forge/compiler/types/capability.ts +29 -29
  250. package/src/forge/compiler/types/classification.ts +9 -9
  251. package/src/forge/compiler/types/cli.ts +85 -85
  252. package/src/forge/compiler/types/diagnostic.ts +2 -2
  253. package/src/forge/compiler/types/emit.ts +25 -25
  254. package/src/forge/compiler/types/import-guards.ts +19 -19
  255. package/src/forge/compiler/types/index.ts +98 -98
  256. package/src/forge/compiler/types/integration.ts +25 -25
  257. package/src/forge/compiler/types/json.ts +3 -3
  258. package/src/forge/compiler/types/lock.ts +37 -37
  259. package/src/forge/compiler/types/package-graph.ts +122 -77
  260. package/src/forge/compiler/types/runtime-matrix.ts +16 -16
  261. package/src/forge/compiler/types/runtime.ts +30 -30
  262. package/src/forge/compiler/types/sandbox.ts +24 -24
  263. package/src/forge/dev/server.ts +16 -2
  264. package/src/forge/refactor/index.ts +10 -2
  265. package/src/forge/refactor/runtime-rename.ts +598 -0
  266. package/src/forge/runtime/executor.ts +3 -2
  267. package/src/forge/runtime/live/live-query-runner.ts +2 -1
  268. package/src/forge/runtime/outbox/process.ts +2 -1
  269. package/src/forge/runtime/query/run-query.ts +2 -1
  270. package/src/forge/runtime/runner/run-entry.ts +2 -1
  271. package/src/forge/runtime/telemetry/sinks/posthog.ts +4 -5
  272. package/src/forge/runtime/telemetry/sinks/sentry.ts +4 -5
  273. package/src/forge/runtime/workflows/resolve-step.ts +2 -1
  274. package/src/forge/version.ts +3 -0
  275. package/templates/b2b-support-web/src/actions/captureTicketCreated.ts +7 -2
  276. package/templates/b2b-support-web/src/commands/closeTicket.ts +6 -1
  277. package/templates/b2b-support-web/src/commands/createTicket.ts +8 -2
  278. package/templates/b2b-support-web/src/queries/getTicket.ts +8 -1
  279. package/templates/b2b-support-web/web/components/CreateTicketForm.tsx +1 -2
  280. package/templates/b2b-support-web/web/components/PolicyDeniedDemo.tsx +1 -2
  281. package/templates/b2b-support-web/web/components/TicketList.tsx +1 -2
  282. package/templates/b2b-support-web/web/components/TraceDetails.tsx +1 -1
  283. package/templates/b2b-support-web/web/lib/forge.ts +1 -0
@@ -1,26 +1,26 @@
1
- import type { AppGraph, SourceFile } from "../types/app-graph.ts";
2
- import type { Dependency } from "../types/package-graph.ts";
3
- import type { PackageManager } from "../types/runtime.ts";
4
- import type { SourceFileIndex } from "./workspace-index.ts";
5
-
6
- export const ORCHESTRATOR_MANIFEST_VERSION = "1";
7
-
8
- export interface DiscoverContext {
9
- workspaceRoot: string;
10
- cacheDir: string;
11
- generatedDir: string;
12
- packageManager: PackageManager;
13
- sources: SourceFile[];
14
- dependencies: Dependency[];
15
- tsconfigPath: string | null;
16
- packageJsonHash: string;
17
- lockfileHash: string;
18
- tsconfigHash: string;
19
- sourceFingerprint: string;
20
- inputFingerprint: string;
21
- sourceFileIndex: SourceFileIndex;
22
- }
23
-
1
+ import type { AppGraph, SourceFile } from "../types/app-graph.ts";
2
+ import type { Dependency } from "../types/package-graph.ts";
3
+ import type { PackageManager } from "../types/runtime.ts";
4
+ import type { SourceFileIndex } from "./workspace-index.ts";
5
+
6
+ export const ORCHESTRATOR_MANIFEST_VERSION = "1";
7
+
8
+ export interface DiscoverContext {
9
+ workspaceRoot: string;
10
+ cacheDir: string;
11
+ generatedDir: string;
12
+ packageManager: PackageManager;
13
+ sources: SourceFile[];
14
+ dependencies: Dependency[];
15
+ tsconfigPath: string | null;
16
+ packageJsonHash: string;
17
+ lockfileHash: string;
18
+ tsconfigHash: string;
19
+ sourceFingerprint: string;
20
+ inputFingerprint: string;
21
+ sourceFileIndex: SourceFileIndex;
22
+ }
23
+
24
24
  export interface OrchestratorManifest {
25
25
  schemaVersion: string;
26
26
  fileHashes: Record<string, string>;
@@ -1,38 +1,38 @@
1
1
  import { join } from "node:path";
2
2
  import { nodeFileSystem } from "../fs/index.ts";
3
3
  import type { Diagnostic } from "../types/diagnostic.ts";
4
- import type { ForgeLock } from "../types/lock.ts";
5
- import { createDiagnostic } from "../diagnostics/create.ts";
6
- import { normalizePath } from "../primitives/paths.ts";
7
-
8
- export function verifyLockIntegrity(
9
- workspaceRoot: string,
10
- lock: ForgeLock,
11
- ): Diagnostic[] {
12
- const diagnostics: Diagnostic[] = [];
13
- const seen = new Set<string>();
14
-
15
- for (const entry of lock.packages) {
16
- for (const file of entry.generatedFiles) {
17
- const normalized = normalizePath(file);
18
- if (seen.has(normalized)) {
19
- continue;
20
- }
21
- seen.add(normalized);
22
-
23
- const absolute = join(workspaceRoot, normalized);
24
- if (!nodeFileSystem.exists(absolute)) {
25
- diagnostics.push(
26
- createDiagnostic({
27
- severity: "error",
28
- code: "FORGE_LOCK_INTEGRITY",
29
- message: `forge.lock references missing generated file: ${normalized}`,
30
- file: normalized,
31
- }),
32
- );
33
- }
34
- }
35
- }
36
-
37
- return diagnostics;
38
- }
4
+ import type { ForgeLock } from "../types/lock.ts";
5
+ import { createDiagnostic } from "../diagnostics/create.ts";
6
+ import { normalizePath } from "../primitives/paths.ts";
7
+
8
+ export function verifyLockIntegrity(
9
+ workspaceRoot: string,
10
+ lock: ForgeLock,
11
+ ): Diagnostic[] {
12
+ const diagnostics: Diagnostic[] = [];
13
+ const seen = new Set<string>();
14
+
15
+ for (const entry of lock.packages) {
16
+ for (const file of entry.generatedFiles) {
17
+ const normalized = normalizePath(file);
18
+ if (seen.has(normalized)) {
19
+ continue;
20
+ }
21
+ seen.add(normalized);
22
+
23
+ const absolute = join(workspaceRoot, normalized);
24
+ if (!nodeFileSystem.exists(absolute)) {
25
+ diagnostics.push(
26
+ createDiagnostic({
27
+ severity: "error",
28
+ code: "FORGE_LOCK_INTEGRITY",
29
+ message: `forge.lock references missing generated file: ${normalized}`,
30
+ file: normalized,
31
+ }),
32
+ );
33
+ }
34
+ }
35
+ }
36
+
37
+ return diagnostics;
38
+ }
@@ -1,33 +1,33 @@
1
- import type { CapabilitySet } from "../types/capability.ts";
2
- import type { ExportClassification } from "../types/package-graph.ts";
3
-
4
- export function emptyCapabilitySet(): CapabilitySet {
5
- return {
6
- network: { status: "unknown", confidence: "static", evidence: [] },
7
- filesystem: { status: "unknown", confidence: "static", evidence: [] },
8
- process: { status: "unknown", confidence: "static", evidence: [] },
9
- nativeAddon: { status: "not-detected", confidence: "static", evidence: [] },
10
- lifecycleScripts: {
11
- status: "not-detected",
12
- confidence: "static",
13
- evidence: [],
14
- },
15
- secrets: [],
16
- };
17
- }
18
-
19
- export function stubExportClassification(
20
- packageName: string,
21
- entrypoint: string,
22
- exportName: string,
23
- ): ExportClassification {
24
- return {
25
- alias: packageName,
26
- packageName,
27
- entrypoint,
28
- exportName,
29
- compatible: [],
30
- incompatible: [],
31
- capabilities: emptyCapabilitySet(),
32
- };
33
- }
1
+ import type { CapabilitySet } from "../types/capability.ts";
2
+ import type { ExportClassification } from "../types/package-graph.ts";
3
+
4
+ export function emptyCapabilitySet(): CapabilitySet {
5
+ return {
6
+ network: { status: "unknown", confidence: "static", evidence: [] },
7
+ filesystem: { status: "unknown", confidence: "static", evidence: [] },
8
+ process: { status: "unknown", confidence: "static", evidence: [] },
9
+ nativeAddon: { status: "not-detected", confidence: "static", evidence: [] },
10
+ lifecycleScripts: {
11
+ status: "not-detected",
12
+ confidence: "static",
13
+ evidence: [],
14
+ },
15
+ secrets: [],
16
+ };
17
+ }
18
+
19
+ export function stubExportClassification(
20
+ packageName: string,
21
+ entrypoint: string,
22
+ exportName: string,
23
+ ): ExportClassification {
24
+ return {
25
+ alias: packageName,
26
+ packageName,
27
+ entrypoint,
28
+ exportName,
29
+ compatible: [],
30
+ incompatible: [],
31
+ capabilities: emptyCapabilitySet(),
32
+ };
33
+ }
@@ -1,97 +1,107 @@
1
- import { join, relative } from "node:path";
2
- import { nodeFileSystem } from "../fs/index.ts";
3
- import { hashStable } from "../primitives/hash.ts";
4
- import { canonicalJson } from "../primitives/serialize.ts";
5
- import type { PackageApi } from "../types/package-graph.ts";
6
- import { readTextFile } from "./read-file.ts";
7
-
8
- export function hashPackageJson(installPath: string): string {
9
- const packageJsonPath = join(installPath, "package.json");
10
- return hashStable(readTextFile(packageJsonPath));
11
- }
12
-
13
- /** Fast cache-key fingerprint: one stat per package.json instead of reading contents. */
14
- export function hashPackageJsonForCache(installPath: string): string {
15
- const packageJsonPath = join(installPath, "package.json");
16
- const stat = nodeFileSystem.stat(packageJsonPath);
17
- if (stat !== null) {
18
- return hashStable(`stat:${stat.size}:${stat.mtimeMs}`);
19
- }
20
- return hashPackageJson(installPath);
21
- }
22
-
23
- export function hashDtsFiles(installPath: string): string {
24
- const files = collectDtsFiles(installPath).sort((a, b) => a.localeCompare(b));
25
- const parts: string[] = [];
26
- for (const file of files) {
27
- const rel = relative(installPath, file).replace(/\\/g, "/");
28
- parts.push(rel);
29
- parts.push(hashStable(readTextFile(file)));
30
- }
31
- return hashStable(parts.join("\0"));
32
- }
33
-
34
- /** Fast cache-key fingerprint using file stat metadata instead of reading every .d.ts body. */
35
- export function hashDtsFilesForCache(installPath: string): string {
36
- const files = collectDtsFiles(installPath).sort((a, b) => a.localeCompare(b));
37
- const parts: string[] = [];
38
- for (const file of files) {
39
- const rel = relative(installPath, file).replace(/\\/g, "/");
40
- const stat = nodeFileSystem.stat(file);
41
- parts.push(rel);
42
- parts.push(`${stat?.size ?? 0}:${stat?.mtimeMs ?? 0}`);
43
- }
44
- return hashStable(parts.join("\0"));
45
- }
46
-
47
- function collectDtsFiles(dir: string): string[] {
48
- const files: string[] = [];
49
-
50
- for (const entry of nodeFileSystem.readDir(dir)) {
51
- const full = join(dir, entry.name);
52
- if (entry.isDirectory) {
53
- if (entry.name === "node_modules") {
54
- continue;
55
- }
56
- files.push(...collectDtsFiles(full));
57
- } else if (entry.name.endsWith(".d.ts")) {
58
- files.push(full);
59
- }
60
- }
61
-
62
- return files;
63
- }
64
-
65
- export function computeContentChecksum(
66
- packageJsonHash: string,
67
- dtsFilesHash: string,
68
- api: Pick<
69
- PackageApi,
70
- "entrypoints" | "resolutionMode" | "source" | "runtimeShape"
71
- >,
72
- ): string {
73
- const payload = {
74
- packageJsonHash,
75
- dtsFilesHash,
76
- resolutionMode: api.resolutionMode,
77
- source: api.source,
78
- runtimeShape: api.runtimeShape ?? null,
79
- entrypoints: api.entrypoints.map((ep) => ({
80
- subpath: ep.subpath,
81
- conditions: ep.conditions,
82
- patternBacked: ep.patternBacked,
83
- dtsPath: ep.dtsPath,
84
- exports: ep.exports.map((ex) => ({
85
- name: ex.name,
86
- kind: ex.kind,
87
- signature: ex.signature,
88
- overloads: ex.overloads,
89
- declarations: ex.declarations,
90
- jsdoc: ex.jsdoc,
91
- examples: ex.examples,
92
- })),
93
- })),
94
- };
95
-
96
- return hashStable(canonicalJson(payload));
97
- }
1
+ import { join, relative } from "node:path";
2
+ import { nodeFileSystem } from "../fs/index.ts";
3
+ import { hashStable } from "../primitives/hash.ts";
4
+ import { canonicalJson } from "../primitives/serialize.ts";
5
+ import type { PackageApi } from "../types/package-graph.ts";
6
+ import { readTextFile } from "./read-file.ts";
7
+
8
+ export function hashPackageJson(installPath: string): string {
9
+ const packageJsonPath = join(installPath, "package.json");
10
+ return hashStable(readTextFile(packageJsonPath));
11
+ }
12
+
13
+ /** Fast cache-key fingerprint: one stat per package.json instead of reading contents. */
14
+ export function hashPackageJsonForCache(installPath: string): string {
15
+ const packageJsonPath = join(installPath, "package.json");
16
+ const stat = nodeFileSystem.stat(packageJsonPath);
17
+ if (stat !== null) {
18
+ return hashStable(`stat:${stat.size}:${stat.mtimeMs}`);
19
+ }
20
+ return hashPackageJson(installPath);
21
+ }
22
+
23
+ export function hashDtsFiles(installPath: string): string {
24
+ const files = collectDtsFiles(installPath).sort((a, b) => a.localeCompare(b));
25
+ const parts: string[] = [];
26
+ for (const file of files) {
27
+ const rel = relative(installPath, file).replace(/\\/g, "/");
28
+ parts.push(rel);
29
+ parts.push(hashStable(readTextFile(file)));
30
+ }
31
+ return hashStable(parts.join("\0"));
32
+ }
33
+
34
+ /** Fast cache-key fingerprint using file stat metadata instead of reading every .d.ts body. */
35
+ export function hashDtsFilesForCache(installPath: string): string {
36
+ const files = collectDtsFiles(installPath).sort((a, b) => a.localeCompare(b));
37
+ const parts: string[] = [];
38
+ for (const file of files) {
39
+ const rel = relative(installPath, file).replace(/\\/g, "/");
40
+ const stat = nodeFileSystem.stat(file);
41
+ parts.push(rel);
42
+ parts.push(`${stat?.size ?? 0}:${stat?.mtimeMs ?? 0}`);
43
+ }
44
+ return hashStable(parts.join("\0"));
45
+ }
46
+
47
+ function collectDtsFiles(dir: string): string[] {
48
+ const files: string[] = [];
49
+
50
+ for (const entry of nodeFileSystem.readDir(dir)) {
51
+ const full = join(dir, entry.name);
52
+ if (entry.isDirectory) {
53
+ if (entry.name === "node_modules") {
54
+ continue;
55
+ }
56
+ files.push(...collectDtsFiles(full));
57
+ } else if (entry.name.endsWith(".d.ts")) {
58
+ files.push(full);
59
+ }
60
+ }
61
+
62
+ return files;
63
+ }
64
+
65
+ export function computeContentChecksum(
66
+ packageJsonHash: string,
67
+ dtsFilesHash: string,
68
+ api: Pick<
69
+ PackageApi,
70
+ | "entrypoints"
71
+ | "resolutionMode"
72
+ | "source"
73
+ | "runtimeShape"
74
+ | "runtimeTypeMismatches"
75
+ | "runtimeCompatibility"
76
+ | "metadata"
77
+ >,
78
+ ): string {
79
+ const payload = {
80
+ packageJsonHash,
81
+ dtsFilesHash,
82
+ resolutionMode: api.resolutionMode,
83
+ source: api.source,
84
+ runtimeShape: api.runtimeShape ?? null,
85
+ runtimeTypeMismatches: api.runtimeTypeMismatches,
86
+ runtimeCompatibility: api.runtimeCompatibility,
87
+ metadata: api.metadata,
88
+ entrypoints: api.entrypoints.map((ep) => ({
89
+ subpath: ep.subpath,
90
+ conditions: ep.conditions,
91
+ patternBacked: ep.patternBacked,
92
+ dtsPath: ep.dtsPath,
93
+ resolutionTrace: ep.resolutionTrace,
94
+ exports: ep.exports.map((ex) => ({
95
+ name: ex.name,
96
+ kind: ex.kind,
97
+ signature: ex.signature,
98
+ overloads: ex.overloads,
99
+ declarations: ex.declarations,
100
+ jsdoc: ex.jsdoc,
101
+ examples: ex.examples,
102
+ })),
103
+ })),
104
+ };
105
+
106
+ return hashStable(canonicalJson(payload));
107
+ }