@granular-software/fractory 0.0.0-stage → 0.1.25

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/LICENSE +4 -0
  2. package/README.md +28 -2
  3. package/dist/activity-volume.d.ts +18 -0
  4. package/dist/activity-volume.js +94 -0
  5. package/dist/annotations.d.ts +122 -0
  6. package/dist/annotations.js +304 -0
  7. package/dist/benchmark-cli.d.ts +1 -0
  8. package/dist/benchmark-cli.js +95 -0
  9. package/dist/benchmark-worker.d.ts +2 -0
  10. package/dist/benchmark-worker.js +22 -0
  11. package/dist/benchmarks.d.ts +19 -0
  12. package/dist/benchmarks.js +414 -0
  13. package/dist/bin.d.ts +2 -0
  14. package/dist/bin.js +63 -0
  15. package/dist/block-cli.d.ts +1 -0
  16. package/dist/block-cli.js +88 -0
  17. package/dist/block-documents.d.ts +35 -0
  18. package/dist/block-documents.js +84 -0
  19. package/dist/change-impact.d.ts +55 -0
  20. package/dist/change-impact.js +223 -0
  21. package/dist/check-source.d.ts +2 -0
  22. package/dist/check-source.js +66 -0
  23. package/dist/checks-model.d.ts +64 -0
  24. package/dist/checks-model.js +36 -0
  25. package/dist/cli.d.ts +2 -0
  26. package/dist/cli.js +359 -0
  27. package/dist/code-model.d.ts +38 -0
  28. package/dist/code-model.js +94 -0
  29. package/dist/code-store.d.ts +9 -0
  30. package/dist/code-store.js +79 -0
  31. package/dist/compare-artifact.d.ts +6 -0
  32. package/dist/compare-artifact.js +277 -0
  33. package/dist/compare.d.ts +81 -0
  34. package/dist/compare.js +291 -0
  35. package/dist/compiler.d.ts +10 -0
  36. package/dist/compiler.js +1240 -0
  37. package/dist/compose.d.ts +9 -0
  38. package/dist/compose.js +72 -0
  39. package/dist/core.d.ts +87 -0
  40. package/dist/core.js +207 -0
  41. package/dist/coverage-cli.d.ts +1 -0
  42. package/dist/coverage-cli.js +42 -0
  43. package/dist/declaration-sources.d.ts +3 -0
  44. package/dist/declaration-sources.js +51 -0
  45. package/dist/declared-graph.d.ts +3 -0
  46. package/dist/declared-graph.js +67 -0
  47. package/dist/display-name.d.ts +2 -0
  48. package/dist/display-name.js +8 -0
  49. package/dist/error-heat.d.ts +58 -0
  50. package/dist/error-heat.js +96 -0
  51. package/dist/evidence.d.ts +3 -0
  52. package/dist/evidence.js +68 -0
  53. package/dist/factory-graph.d.ts +7 -0
  54. package/dist/factory-graph.js +389 -0
  55. package/dist/factory-model.d.ts +111 -0
  56. package/dist/factory-model.js +1 -0
  57. package/dist/git-code.d.ts +47 -0
  58. package/dist/git-code.js +352 -0
  59. package/dist/git-refs.d.ts +4 -0
  60. package/dist/git-refs.js +37 -0
  61. package/dist/history-activity.d.ts +4 -0
  62. package/dist/history-activity.js +129 -0
  63. package/dist/history-churn.d.ts +36 -0
  64. package/dist/history-churn.js +302 -0
  65. package/dist/history-git.d.ts +21 -0
  66. package/dist/history-git.js +125 -0
  67. package/dist/history-ledger.d.ts +43 -0
  68. package/dist/history-ledger.js +450 -0
  69. package/dist/history-ownership.d.ts +10 -0
  70. package/dist/history-ownership.js +75 -0
  71. package/dist/history-source.d.ts +13 -0
  72. package/dist/history-source.js +100 -0
  73. package/dist/integrations-cli.d.ts +2 -0
  74. package/dist/integrations-cli.js +159 -0
  75. package/dist/interface-map.d.ts +15 -0
  76. package/dist/interface-map.js +125 -0
  77. package/dist/issue-cache.d.ts +9 -0
  78. package/dist/issue-cache.js +68 -0
  79. package/dist/issue-cli.d.ts +1 -0
  80. package/dist/issue-cli.js +89 -0
  81. package/dist/issue-links.d.ts +15 -0
  82. package/dist/issue-links.js +125 -0
  83. package/dist/linear-issues.d.ts +19 -0
  84. package/dist/linear-issues.js +124 -0
  85. package/dist/local-runtime.d.ts +8 -0
  86. package/dist/local-runtime.js +59 -0
  87. package/dist/map-activity.d.ts +73 -0
  88. package/dist/map-activity.js +234 -0
  89. package/dist/map-model.d.ts +5 -0
  90. package/dist/map-model.js +166 -0
  91. package/dist/map-quality.d.ts +20 -0
  92. package/dist/map-quality.js +61 -0
  93. package/dist/mapping-coverage.d.ts +87 -0
  94. package/dist/mapping-coverage.js +404 -0
  95. package/dist/model.d.ts +186 -0
  96. package/dist/model.js +66 -0
  97. package/dist/operation-benchmark-worker.d.ts +2 -0
  98. package/dist/operation-benchmark-worker.js +60 -0
  99. package/dist/operation-benchmark.d.ts +29 -0
  100. package/dist/operation-benchmark.js +1 -0
  101. package/dist/otel-metrics.d.ts +21 -0
  102. package/dist/otel-metrics.js +146 -0
  103. package/dist/performance-model.d.ts +185 -0
  104. package/dist/performance-model.js +396 -0
  105. package/dist/product-map.d.ts +71 -0
  106. package/dist/product-map.js +197 -0
  107. package/dist/provider-access.cjs +207 -0
  108. package/dist/provider-access.d.cts +14 -0
  109. package/dist/public-boundaries.d.ts +13 -0
  110. package/dist/public-boundaries.js +115 -0
  111. package/dist/reports-cli.d.ts +1 -0
  112. package/dist/reports-cli.js +111 -0
  113. package/dist/reports-model.d.ts +27 -0
  114. package/dist/reports-model.js +39 -0
  115. package/dist/reports.d.ts +23 -0
  116. package/dist/reports.js +223 -0
  117. package/dist/repository-map.d.ts +22 -0
  118. package/dist/repository-map.js +153 -0
  119. package/dist/resource-cache.d.ts +17 -0
  120. package/dist/resource-cache.js +65 -0
  121. package/dist/review-cli.d.ts +19 -0
  122. package/dist/review-cli.js +224 -0
  123. package/dist/review.d.ts +48 -0
  124. package/dist/review.js +289 -0
  125. package/dist/runtime-metrics.d.ts +26 -0
  126. package/dist/runtime-metrics.js +290 -0
  127. package/dist/scope.d.ts +14 -0
  128. package/dist/scope.js +168 -0
  129. package/dist/sentry-activity.d.ts +39 -0
  130. package/dist/sentry-activity.js +174 -0
  131. package/dist/sentry.d.ts +130 -0
  132. package/dist/sentry.js +369 -0
  133. package/dist/service-release.d.ts +16 -0
  134. package/dist/service-release.js +14 -0
  135. package/dist/setup-cli.d.ts +2 -0
  136. package/dist/setup-cli.js +52 -0
  137. package/dist/setup-kit.cjs +163 -0
  138. package/dist/setup-kit.d.cts +32 -0
  139. package/dist/source-index.d.ts +37 -0
  140. package/dist/source-index.js +170 -0
  141. package/dist/source-review-git.d.ts +7 -0
  142. package/dist/source-review-git.js +105 -0
  143. package/dist/source-review.d.ts +18 -0
  144. package/dist/source-review.js +573 -0
  145. package/dist/telemetry.d.ts +17 -0
  146. package/dist/telemetry.js +51 -0
  147. package/dist/time-window.d.ts +9 -0
  148. package/dist/time-window.js +35 -0
  149. package/dist/trace-evidence.d.ts +23 -0
  150. package/dist/trace-evidence.js +55 -0
  151. package/dist/trace-model.d.ts +26 -0
  152. package/dist/trace-model.js +1 -0
  153. package/dist/tracing.d.ts +44 -0
  154. package/dist/tracing.js +123 -0
  155. package/dist/work-check.d.ts +18 -0
  156. package/dist/work-check.js +115 -0
  157. package/dist/work-cli.d.ts +1 -0
  158. package/dist/work-cli.js +176 -0
  159. package/dist/work-context.d.ts +59 -0
  160. package/dist/work-context.js +594 -0
  161. package/dist/work-intents.d.ts +6 -0
  162. package/dist/work-intents.js +140 -0
  163. package/dist/work-items.d.ts +58 -0
  164. package/dist/work-items.js +86 -0
  165. package/dist/work-lock-check.d.ts +12 -0
  166. package/dist/work-lock-check.js +339 -0
  167. package/dist/work-locks.d.ts +10 -0
  168. package/dist/work-locks.js +98 -0
  169. package/dist/work-model.d.ts +119 -0
  170. package/dist/work-model.js +310 -0
  171. package/dist/work-review-git.d.ts +8 -0
  172. package/dist/work-review-git.js +111 -0
  173. package/dist/work-review.d.ts +26 -0
  174. package/dist/work-review.js +426 -0
  175. package/dist/work-switcher-model.d.ts +43 -0
  176. package/dist/work-switcher-model.js +79 -0
  177. package/dist/work-switcher.d.ts +6 -0
  178. package/dist/work-switcher.js +171 -0
  179. package/dist/working-cli.d.ts +1 -0
  180. package/dist/working-cli.js +33 -0
  181. package/dist/working-code.d.ts +74 -0
  182. package/dist/working-code.js +421 -0
  183. package/dist/workspace-notes.d.ts +71 -0
  184. package/dist/workspace-notes.js +177 -0
  185. package/dist/workspace-tests.d.ts +21 -0
  186. package/dist/workspace-tests.js +573 -0
  187. package/package.json +547 -4
  188. package/src/activity-volume.ts +149 -0
  189. package/src/annotations.ts +485 -0
  190. package/src/benchmark-cli.ts +118 -0
  191. package/src/benchmark-worker.ts +22 -0
  192. package/src/benchmarks.ts +493 -0
  193. package/src/bin.ts +54 -0
  194. package/src/block-cli.ts +106 -0
  195. package/src/block-documents.ts +117 -0
  196. package/src/change-impact.ts +280 -0
  197. package/src/check-source.ts +82 -0
  198. package/src/checks-model.ts +108 -0
  199. package/src/cli.ts +440 -0
  200. package/src/code-model.ts +159 -0
  201. package/src/code-store.ts +98 -0
  202. package/src/compare-artifact.ts +314 -0
  203. package/src/compare.ts +440 -0
  204. package/src/compiler.ts +1512 -0
  205. package/src/compose.ts +94 -0
  206. package/src/core.ts +361 -0
  207. package/src/coverage-cli.ts +52 -0
  208. package/src/declaration-sources.ts +69 -0
  209. package/src/declared-graph.ts +75 -0
  210. package/src/display-name.ts +8 -0
  211. package/src/error-heat.ts +161 -0
  212. package/src/evidence.ts +94 -0
  213. package/src/factory-graph.ts +462 -0
  214. package/src/factory-model.ts +82 -0
  215. package/src/git-code.ts +461 -0
  216. package/src/git-refs.ts +43 -0
  217. package/src/history-activity.ts +146 -0
  218. package/src/history-churn.ts +416 -0
  219. package/src/history-git.ts +163 -0
  220. package/src/history-ledger.ts +636 -0
  221. package/src/history-ownership.ts +116 -0
  222. package/src/history-source.ts +117 -0
  223. package/src/integrations-cli.ts +187 -0
  224. package/src/interface-map.ts +166 -0
  225. package/src/issue-cache.ts +96 -0
  226. package/src/issue-cli.ts +137 -0
  227. package/src/issue-links.ts +153 -0
  228. package/src/linear-issues.ts +154 -0
  229. package/src/local-runtime.ts +70 -0
  230. package/src/map-activity.ts +309 -0
  231. package/src/map-model.ts +213 -0
  232. package/src/map-quality.ts +66 -0
  233. package/src/mapping-coverage.ts +570 -0
  234. package/src/model.ts +228 -0
  235. package/src/operation-benchmark-worker.ts +60 -0
  236. package/src/operation-benchmark.ts +28 -0
  237. package/src/otel-metrics.ts +176 -0
  238. package/src/performance-model.ts +575 -0
  239. package/src/product-map.ts +271 -0
  240. package/src/provider-access.cjs +207 -0
  241. package/src/provider-access.d.cts +14 -0
  242. package/src/public-boundaries.ts +143 -0
  243. package/src/reports-cli.ts +125 -0
  244. package/src/reports-model.ts +73 -0
  245. package/src/reports.ts +276 -0
  246. package/src/repository-map.ts +191 -0
  247. package/src/resource-cache.ts +76 -0
  248. package/src/review-cli.ts +256 -0
  249. package/src/review.ts +376 -0
  250. package/src/runtime-metrics.ts +386 -0
  251. package/src/scope.ts +192 -0
  252. package/src/sentry-activity.ts +234 -0
  253. package/src/sentry.ts +545 -0
  254. package/src/service-release.ts +18 -0
  255. package/src/setup-cli.ts +58 -0
  256. package/src/setup-kit.cjs +163 -0
  257. package/src/setup-kit.d.cts +32 -0
  258. package/src/source-index.ts +208 -0
  259. package/src/source-review-git.ts +131 -0
  260. package/src/source-review.ts +736 -0
  261. package/src/telemetry.ts +68 -0
  262. package/src/time-window.ts +51 -0
  263. package/src/trace-evidence.ts +80 -0
  264. package/src/trace-model.ts +26 -0
  265. package/src/tracing.ts +165 -0
  266. package/src/work-check.ts +149 -0
  267. package/src/work-cli.ts +229 -0
  268. package/src/work-context.ts +753 -0
  269. package/src/work-intents.ts +196 -0
  270. package/src/work-items.ts +151 -0
  271. package/src/work-lock-check.ts +549 -0
  272. package/src/work-locks.ts +108 -0
  273. package/src/work-model.ts +466 -0
  274. package/src/work-review-git.ts +130 -0
  275. package/src/work-review.ts +573 -0
  276. package/src/work-switcher-model.ts +121 -0
  277. package/src/work-switcher.ts +191 -0
  278. package/src/working-cli.ts +38 -0
  279. package/src/working-code.ts +582 -0
  280. package/src/workspace-notes.ts +203 -0
  281. package/src/workspace-tests.ts +654 -0
  282. package/toolkit/GUIDE.md +354 -0
  283. package/toolkit/SKILL.md +142 -0
  284. package/toolkit/bin/fractory +2 -0
  285. package/toolkit/build.json +1 -0
@@ -0,0 +1,161 @@
1
+ import type { DefinitionGraph } from "./model";
2
+
3
+ export interface ErrorObservation {
4
+ eventId: string;
5
+ project: string;
6
+ issueId?: string;
7
+ title: string;
8
+ issueUrl?: string;
9
+ commit?: string;
10
+ matchReason?: string;
11
+ at?: string;
12
+ elementId?: string;
13
+ basis: "source" | "component" | "unassigned";
14
+ }
15
+ export interface ErrorHeat {
16
+ counts?: ErrorCount[];
17
+ accounting?: {
18
+ total: number;
19
+ source: number;
20
+ related: number;
21
+ projects: { project: string; total: number | null }[];
22
+ samplePartial: boolean;
23
+ classificationPartial: boolean;
24
+ };
25
+ warnings?: import("./sentry").SentryProjectWarning[];
26
+ fetchedAt: string;
27
+ period: string;
28
+ window?: import("./time-window").TimeWindow;
29
+ partial: boolean;
30
+ events: ErrorObservation[];
31
+ cells: Record<string, { source: number; related: number; intensity: number }>;
32
+ unassigned: number;
33
+ }
34
+ /** Aggregate occurrences are not synthetic event IDs or extrapolated event samples. */
35
+ export interface ErrorCount {
36
+ project: string;
37
+ count: number;
38
+ elementId?: string;
39
+ basis: "source" | "component" | "unassigned";
40
+ reason?: string;
41
+ }
42
+ /** Each event contributes once to its owner and once to each ancestor, never to siblings. */
43
+ export function errorHeat(
44
+ graph: DefinitionGraph,
45
+ observations: ErrorObservation[],
46
+ partial = false,
47
+ counts?: ErrorCount[],
48
+ ): ErrorHeat {
49
+ const byId = new Map(graph.elements.map((node) => [node.id, node]));
50
+ const seen = new Set<string>(),
51
+ events: ErrorObservation[] = [],
52
+ cells: ErrorHeat["cells"] = {};
53
+ for (const event of observations) {
54
+ const key = `${event.project}:${event.eventId}`;
55
+ if (seen.has(key)) continue;
56
+ seen.add(key);
57
+ const owner =
58
+ event.elementId &&
59
+ byId.get(graph.aliases?.[event.elementId] || event.elementId);
60
+ const record = owner
61
+ ? { ...event, elementId: owner.id }
62
+ : { ...event, elementId: undefined, basis: "unassigned" as const };
63
+ events.push(record);
64
+ }
65
+ let unassigned = 0,
66
+ source = 0,
67
+ related = 0;
68
+ for (const row of counts || events.map((event) => ({ ...event, count: 1 }))) {
69
+ if (!Number.isSafeInteger(row.count) || row.count < 0)
70
+ throw Error("Invalid Sentry occurrence count");
71
+ const owner =
72
+ row.elementId &&
73
+ byId.get(graph.aliases?.[row.elementId] || row.elementId);
74
+ if (!owner || row.basis === "unassigned") {
75
+ unassigned += row.count;
76
+ continue;
77
+ }
78
+ if (row.basis === "source") source += row.count;
79
+ else related += row.count;
80
+ let current: DefinitionGraph["elements"][number] | undefined = owner;
81
+ const ancestors = new Set<string>();
82
+ while (current && !ancestors.has(current.id)) {
83
+ ancestors.add(current.id);
84
+ const cell = (cells[current.id] ||= {
85
+ source: 0,
86
+ related: 0,
87
+ intensity: 0,
88
+ });
89
+ if (row.basis === "source") cell.source += row.count;
90
+ else if (row.basis === "component") cell.related += row.count;
91
+ current = current.parent ? byId.get(current.parent) : undefined;
92
+ }
93
+ }
94
+ const maximum = Math.max(
95
+ 1,
96
+ ...Object.entries(cells)
97
+ .filter(([id]) => id !== graph.id)
98
+ .map(([, cell]) => cell.source + cell.related),
99
+ );
100
+ for (const cell of Object.values(cells))
101
+ cell.intensity = Math.min(1, (cell.source + cell.related) / maximum);
102
+ return {
103
+ fetchedAt: new Date().toISOString(),
104
+ period: "14d",
105
+ partial,
106
+ events,
107
+ cells,
108
+ unassigned,
109
+ ...(counts
110
+ ? {
111
+ counts,
112
+ accounting: {
113
+ total: source + related + unassigned,
114
+ source,
115
+ related,
116
+ projects: [],
117
+ samplePartial: false,
118
+ classificationPartial: false,
119
+ },
120
+ }
121
+ : {}),
122
+ };
123
+ }
124
+
125
+ /** Group only provider issue identities; unrelated ungrouped events remain separate. */
126
+ export function groupErrors(events: ErrorObservation[]) {
127
+ const groups = new Map<
128
+ string,
129
+ {
130
+ key: string;
131
+ title: string;
132
+ project: string;
133
+ issueId?: string;
134
+ issueUrl?: string;
135
+ events: ErrorObservation[];
136
+ }
137
+ >();
138
+ for (const event of events) {
139
+ const key = `${event.project}:${event.issueId || "event:" + event.eventId}`;
140
+ const group = groups.get(key) || {
141
+ key,
142
+ title: event.title,
143
+ project: event.project,
144
+ issueId: event.issueId,
145
+ issueUrl: event.issueUrl,
146
+ events: [],
147
+ };
148
+ group.events.push(event);
149
+ groups.set(key, group);
150
+ }
151
+ return [...groups.values()]
152
+ .map((group) => ({
153
+ ...group,
154
+ events: group.events.sort(
155
+ (a, b) => (Date.parse(b.at || "") || 0) - (Date.parse(a.at || "") || 0),
156
+ ),
157
+ }))
158
+ .sort(
159
+ (a, b) => b.events.length - a.events.length || a.key.localeCompare(b.key),
160
+ );
161
+ }
@@ -0,0 +1,94 @@
1
+ import type { DefinitionGraph, ExecutionEvidence } from "./model";
2
+
3
+ const record = (value: unknown): Record<string, unknown> =>
4
+ value !== null && typeof value === "object" && !Array.isArray(value)
5
+ ? (value as Record<string, unknown>)
6
+ : {};
7
+ /** Project a real materialized session document. Never infer a call path from a terminal status. */
8
+ export function inspectJob(
9
+ document: unknown,
10
+ jobId: string,
11
+ graph: DefinitionGraph,
12
+ ): ExecutionEvidence {
13
+ const doc = record(document),
14
+ jobs = record(record(doc.jobs).byId),
15
+ job = record(jobs[jobId]);
16
+ if (!Object.keys(job).length)
17
+ throw new Error(`Job not found in session document: ${jobId}`);
18
+ const metadata = record(job.metadata),
19
+ diagnostics = record(metadata.diagnostics),
20
+ intent = record(job.startIntent);
21
+ const failures = (
22
+ Array.isArray(diagnostics.failures) ? diagnostics.failures : []
23
+ ).map((value) => {
24
+ const f = record(value);
25
+ return {
26
+ code: String(f.code || "Unknown"),
27
+ origin: String(f.origin || "unknown"),
28
+ commit: String(f.commit || "unknown"),
29
+ };
30
+ });
31
+ const pending = record(metadata.pendingInvocations);
32
+ const unresolved = Object.entries(pending)
33
+ .filter(([, value]) => record(value).readOnly !== true)
34
+ .map(([id, value]) => ({
35
+ operationId: String(record(value).operationId || id),
36
+ commit: "unknown" as const,
37
+ reason:
38
+ "Outstanding mutation recorded in the session; its outcome is not established by job status.",
39
+ }));
40
+ const resolutions = new Set(
41
+ (Array.isArray(diagnostics.resolutions) ? diagnostics.resolutions : []).map(
42
+ (value) => record(value).operationId,
43
+ ),
44
+ );
45
+ for (const value of Array.isArray(diagnostics.failures)
46
+ ? diagnostics.failures
47
+ : []) {
48
+ const failure = record(value),
49
+ id = failure.operationId;
50
+ if (
51
+ failure.commit === "unknown" &&
52
+ typeof id === "string" &&
53
+ !resolutions.has(id) &&
54
+ !unresolved.some((item) => item.operationId === id)
55
+ )
56
+ unresolved.push({
57
+ operationId: id,
58
+ commit: "unknown",
59
+ reason: "Failure diagnostics record an unresolved commit outcome.",
60
+ });
61
+ }
62
+ const observations: ExecutionEvidence["observations"] = [];
63
+ const jobNode = graph.elements.find(
64
+ (n) => n.source?.symbol === "handleJobSubmitRpc",
65
+ );
66
+ if (jobNode)
67
+ observations.push({
68
+ elementId: jobNode.id,
69
+ label: `Persisted job record: ${String(job.status || "unknown")}. Submission call itself was not traced.`,
70
+ confidence: "recorded",
71
+ });
72
+ // Evidence records state, not fabricated traversal of all the nodes that could have run.
73
+ return {
74
+ schema: "fractal.evidence.v1",
75
+ jobId,
76
+ status: String(job.status || "unknown"),
77
+ runtime:
78
+ typeof metadata.jobRuntime === "string" ? metadata.jobRuntime : undefined,
79
+ startIntent:
80
+ typeof intent.state === "string"
81
+ ? {
82
+ state: intent.state,
83
+ attempt: typeof intent.attempt === "number" ? intent.attempt : 0,
84
+ }
85
+ : undefined,
86
+ unresolved,
87
+ failures,
88
+ observations,
89
+ definitionRevision:
90
+ typeof metadata.fractalDefinitionRevision === "string"
91
+ ? metadata.fractalDefinitionRevision
92
+ : undefined,
93
+ };
94
+ }