@granular-software/fractory 0.0.0-stage → 0.1.24

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 (273) 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 +118 -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 +1083 -0
  37. package/dist/compose.d.ts +9 -0
  38. package/dist/compose.js +72 -0
  39. package/dist/core.d.ts +86 -0
  40. package/dist/core.js +206 -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 +66 -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 +4 -0
  54. package/dist/factory-graph.js +318 -0
  55. package/dist/factory-model.d.ts +97 -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/issue-cache.d.ts +9 -0
  76. package/dist/issue-cache.js +68 -0
  77. package/dist/issue-cli.d.ts +1 -0
  78. package/dist/issue-cli.js +89 -0
  79. package/dist/issue-links.d.ts +15 -0
  80. package/dist/issue-links.js +125 -0
  81. package/dist/linear-issues.d.ts +19 -0
  82. package/dist/linear-issues.js +124 -0
  83. package/dist/local-runtime.d.ts +8 -0
  84. package/dist/local-runtime.js +59 -0
  85. package/dist/map-activity.d.ts +73 -0
  86. package/dist/map-activity.js +234 -0
  87. package/dist/map-model.d.ts +5 -0
  88. package/dist/map-model.js +166 -0
  89. package/dist/map-quality.d.ts +14 -0
  90. package/dist/map-quality.js +56 -0
  91. package/dist/mapping-coverage.d.ts +87 -0
  92. package/dist/mapping-coverage.js +404 -0
  93. package/dist/model.d.ts +182 -0
  94. package/dist/model.js +66 -0
  95. package/dist/operation-benchmark-worker.d.ts +2 -0
  96. package/dist/operation-benchmark-worker.js +60 -0
  97. package/dist/operation-benchmark.d.ts +29 -0
  98. package/dist/operation-benchmark.js +1 -0
  99. package/dist/otel-metrics.d.ts +21 -0
  100. package/dist/otel-metrics.js +146 -0
  101. package/dist/performance-model.d.ts +185 -0
  102. package/dist/performance-model.js +396 -0
  103. package/dist/product-map.d.ts +69 -0
  104. package/dist/product-map.js +168 -0
  105. package/dist/provider-access.cjs +207 -0
  106. package/dist/provider-access.d.cts +14 -0
  107. package/dist/reports-cli.d.ts +1 -0
  108. package/dist/reports-cli.js +111 -0
  109. package/dist/reports-model.d.ts +27 -0
  110. package/dist/reports-model.js +39 -0
  111. package/dist/reports.d.ts +23 -0
  112. package/dist/reports.js +223 -0
  113. package/dist/repository-map.d.ts +22 -0
  114. package/dist/repository-map.js +151 -0
  115. package/dist/resource-cache.d.ts +17 -0
  116. package/dist/resource-cache.js +65 -0
  117. package/dist/review-cli.d.ts +19 -0
  118. package/dist/review-cli.js +224 -0
  119. package/dist/review.d.ts +48 -0
  120. package/dist/review.js +289 -0
  121. package/dist/runtime-metrics.d.ts +26 -0
  122. package/dist/runtime-metrics.js +290 -0
  123. package/dist/scope.d.ts +12 -0
  124. package/dist/scope.js +94 -0
  125. package/dist/sentry-activity.d.ts +39 -0
  126. package/dist/sentry-activity.js +174 -0
  127. package/dist/sentry.d.ts +130 -0
  128. package/dist/sentry.js +369 -0
  129. package/dist/service-release.d.ts +16 -0
  130. package/dist/service-release.js +14 -0
  131. package/dist/setup-cli.d.ts +2 -0
  132. package/dist/setup-cli.js +52 -0
  133. package/dist/setup-kit.cjs +163 -0
  134. package/dist/setup-kit.d.cts +32 -0
  135. package/dist/source-index.d.ts +37 -0
  136. package/dist/source-index.js +166 -0
  137. package/dist/source-review-git.d.ts +7 -0
  138. package/dist/source-review-git.js +103 -0
  139. package/dist/source-review.d.ts +16 -0
  140. package/dist/source-review.js +493 -0
  141. package/dist/telemetry.d.ts +17 -0
  142. package/dist/telemetry.js +51 -0
  143. package/dist/time-window.d.ts +9 -0
  144. package/dist/time-window.js +35 -0
  145. package/dist/trace-evidence.d.ts +23 -0
  146. package/dist/trace-evidence.js +55 -0
  147. package/dist/trace-model.d.ts +26 -0
  148. package/dist/trace-model.js +1 -0
  149. package/dist/tracing.d.ts +44 -0
  150. package/dist/tracing.js +123 -0
  151. package/dist/work-check.d.ts +17 -0
  152. package/dist/work-check.js +110 -0
  153. package/dist/work-cli.d.ts +1 -0
  154. package/dist/work-cli.js +148 -0
  155. package/dist/work-context.d.ts +57 -0
  156. package/dist/work-context.js +568 -0
  157. package/dist/work-intents.d.ts +6 -0
  158. package/dist/work-intents.js +140 -0
  159. package/dist/work-items.d.ts +58 -0
  160. package/dist/work-items.js +86 -0
  161. package/dist/work-model.d.ts +110 -0
  162. package/dist/work-model.js +261 -0
  163. package/dist/work-review-git.d.ts +8 -0
  164. package/dist/work-review-git.js +111 -0
  165. package/dist/work-review.d.ts +26 -0
  166. package/dist/work-review.js +426 -0
  167. package/dist/work-switcher-model.d.ts +43 -0
  168. package/dist/work-switcher-model.js +79 -0
  169. package/dist/work-switcher.d.ts +6 -0
  170. package/dist/work-switcher.js +171 -0
  171. package/dist/working-cli.d.ts +1 -0
  172. package/dist/working-cli.js +33 -0
  173. package/dist/working-code.d.ts +74 -0
  174. package/dist/working-code.js +421 -0
  175. package/dist/workspace-notes.d.ts +71 -0
  176. package/dist/workspace-notes.js +177 -0
  177. package/dist/workspace-tests.d.ts +21 -0
  178. package/dist/workspace-tests.js +573 -0
  179. package/package.json +547 -4
  180. package/src/activity-volume.ts +149 -0
  181. package/src/annotations.ts +481 -0
  182. package/src/benchmark-cli.ts +118 -0
  183. package/src/benchmark-worker.ts +22 -0
  184. package/src/benchmarks.ts +493 -0
  185. package/src/bin.ts +54 -0
  186. package/src/block-cli.ts +106 -0
  187. package/src/block-documents.ts +117 -0
  188. package/src/change-impact.ts +280 -0
  189. package/src/check-source.ts +82 -0
  190. package/src/checks-model.ts +108 -0
  191. package/src/cli.ts +440 -0
  192. package/src/code-model.ts +159 -0
  193. package/src/code-store.ts +98 -0
  194. package/src/compare-artifact.ts +314 -0
  195. package/src/compare.ts +440 -0
  196. package/src/compiler.ts +1326 -0
  197. package/src/compose.ts +94 -0
  198. package/src/core.ts +357 -0
  199. package/src/coverage-cli.ts +52 -0
  200. package/src/declaration-sources.ts +69 -0
  201. package/src/declared-graph.ts +74 -0
  202. package/src/display-name.ts +8 -0
  203. package/src/error-heat.ts +161 -0
  204. package/src/evidence.ts +94 -0
  205. package/src/factory-graph.ts +378 -0
  206. package/src/factory-model.ts +73 -0
  207. package/src/git-code.ts +461 -0
  208. package/src/git-refs.ts +43 -0
  209. package/src/history-activity.ts +146 -0
  210. package/src/history-churn.ts +416 -0
  211. package/src/history-git.ts +163 -0
  212. package/src/history-ledger.ts +636 -0
  213. package/src/history-ownership.ts +116 -0
  214. package/src/history-source.ts +117 -0
  215. package/src/integrations-cli.ts +187 -0
  216. package/src/issue-cache.ts +96 -0
  217. package/src/issue-cli.ts +137 -0
  218. package/src/issue-links.ts +153 -0
  219. package/src/linear-issues.ts +154 -0
  220. package/src/local-runtime.ts +70 -0
  221. package/src/map-activity.ts +309 -0
  222. package/src/map-model.ts +213 -0
  223. package/src/map-quality.ts +61 -0
  224. package/src/mapping-coverage.ts +570 -0
  225. package/src/model.ts +221 -0
  226. package/src/operation-benchmark-worker.ts +60 -0
  227. package/src/operation-benchmark.ts +28 -0
  228. package/src/otel-metrics.ts +176 -0
  229. package/src/performance-model.ts +575 -0
  230. package/src/product-map.ts +236 -0
  231. package/src/provider-access.cjs +207 -0
  232. package/src/provider-access.d.cts +14 -0
  233. package/src/reports-cli.ts +125 -0
  234. package/src/reports-model.ts +73 -0
  235. package/src/reports.ts +276 -0
  236. package/src/repository-map.ts +189 -0
  237. package/src/resource-cache.ts +76 -0
  238. package/src/review-cli.ts +256 -0
  239. package/src/review.ts +376 -0
  240. package/src/runtime-metrics.ts +386 -0
  241. package/src/scope.ts +103 -0
  242. package/src/sentry-activity.ts +234 -0
  243. package/src/sentry.ts +545 -0
  244. package/src/service-release.ts +18 -0
  245. package/src/setup-cli.ts +58 -0
  246. package/src/setup-kit.cjs +163 -0
  247. package/src/setup-kit.d.cts +32 -0
  248. package/src/source-index.ts +205 -0
  249. package/src/source-review-git.ts +129 -0
  250. package/src/source-review.ts +637 -0
  251. package/src/telemetry.ts +68 -0
  252. package/src/time-window.ts +51 -0
  253. package/src/trace-evidence.ts +80 -0
  254. package/src/trace-model.ts +26 -0
  255. package/src/tracing.ts +165 -0
  256. package/src/work-check.ts +143 -0
  257. package/src/work-cli.ts +195 -0
  258. package/src/work-context.ts +713 -0
  259. package/src/work-intents.ts +196 -0
  260. package/src/work-items.ts +151 -0
  261. package/src/work-model.ts +400 -0
  262. package/src/work-review-git.ts +130 -0
  263. package/src/work-review.ts +573 -0
  264. package/src/work-switcher-model.ts +121 -0
  265. package/src/work-switcher.ts +191 -0
  266. package/src/working-cli.ts +38 -0
  267. package/src/working-code.ts +582 -0
  268. package/src/workspace-notes.ts +203 -0
  269. package/src/workspace-tests.ts +654 -0
  270. package/toolkit/GUIDE.md +305 -0
  271. package/toolkit/SKILL.md +131 -0
  272. package/toolkit/bin/fractory +2 -0
  273. package/toolkit/build.json +1 -0
@@ -0,0 +1,213 @@
1
+ import type {
2
+ Connection,
3
+ DefinitionGraph,
4
+ Element,
5
+ FlowArtifact,
6
+ LogicalKind,
7
+ ResourceAttachment,
8
+ } from "./model";
9
+
10
+ const kinds: Record<Element["kind"], LogicalKind> = {
11
+ factory: "block",
12
+ system: "block",
13
+ deployment: "block",
14
+ operation: "method",
15
+ block: "block",
16
+ interface: "interface",
17
+ method: "method",
18
+ process: "process",
19
+ resource: "block",
20
+ artifact: "block",
21
+ };
22
+ /** A view projection, not a new source revision. Runtime identities and contracts stay unchanged. */
23
+ export function logicalMap(definition: DefinitionGraph): DefinitionGraph {
24
+ const graph = structuredClone(definition);
25
+ const byId = new Map(graph.elements.map((node) => [node.id, node]));
26
+ const detached = new Set(
27
+ graph.elements
28
+ .filter((node) => node.kind === "resource" || node.kind === "artifact")
29
+ .map((node) => node.id),
30
+ );
31
+ const owner = (id: string): string => {
32
+ const seen = new Set<string>();
33
+ let node = byId.get(id);
34
+ while (node && !seen.has(node.id)) {
35
+ seen.add(node.id);
36
+ if (
37
+ !detached.has(node.id) &&
38
+ ["block", "process"].includes(kinds[node.kind])
39
+ )
40
+ return node.id;
41
+ node = byId.get(node.parent || "");
42
+ }
43
+ return graph.id;
44
+ };
45
+ const aliases = { ...graph.aliases };
46
+ for (const id of detached)
47
+ aliases[id] = owner(byId.get(id)?.parent || graph.id);
48
+ const target = (id: string) => aliases[id] || id;
49
+ for (const node of graph.elements)
50
+ if (node.kind === "resource") {
51
+ const connections = graph.connections.filter(
52
+ (edge) => edge.source === node.id || edge.target === node.id,
53
+ );
54
+ const attachment: ResourceAttachment = {
55
+ id: node.id,
56
+ label: node.label,
57
+ description: node.description,
58
+ source: node.source,
59
+ sources: node.sources,
60
+ provenance: node.provenance,
61
+ connections,
62
+ };
63
+ const owners = new Set([
64
+ aliases[node.id],
65
+ ...connections.map((edge) =>
66
+ owner(edge.source === node.id ? edge.target : edge.source),
67
+ ),
68
+ ]);
69
+ for (const id of owners) {
70
+ const block = byId.get(id);
71
+ if (block) block.resources = [...(block.resources || []), attachment];
72
+ }
73
+ }
74
+ const artifacts = new Map(
75
+ graph.elements
76
+ .filter((node) => node.kind === "artifact")
77
+ .map((node) => [
78
+ node.id,
79
+ {
80
+ id: node.id,
81
+ label: node.label,
82
+ description: node.description,
83
+ source: node.source,
84
+ sources: node.sources,
85
+ provenance: node.provenance,
86
+ } satisfies FlowArtifact,
87
+ ]),
88
+ );
89
+ for (const [id, artifact] of artifacts) {
90
+ const block = byId.get(aliases[id]);
91
+ if (block) block.outputs = [...(block.outputs || []), artifact];
92
+ }
93
+ const connections: Connection[] = [];
94
+ const outgoing = new Map<string, Connection[]>();
95
+ for (const edge of graph.connections)
96
+ outgoing.set(edge.source, [...(outgoing.get(edge.source) || []), edge]);
97
+ const evidence = (edge: Connection) =>
98
+ edge.sources || (edge.sourceRef ? [edge.sourceRef] : []);
99
+ const follow = (
100
+ first: Connection,
101
+ edge: Connection,
102
+ path: Connection[],
103
+ materials: FlowArtifact[],
104
+ visited: Set<string>,
105
+ ) => {
106
+ if (byId.get(edge.target)?.kind === "resource") return;
107
+ const material = artifacts.get(edge.target);
108
+ if (material) {
109
+ if (visited.has(material.id)) return;
110
+ const seen = new Set([...visited, material.id]);
111
+ const next = outgoing.get(material.id) || [];
112
+ for (const transfer of next)
113
+ follow(
114
+ first,
115
+ transfer,
116
+ [...path, transfer],
117
+ [...materials, material],
118
+ seen,
119
+ );
120
+ if (!next.length) {
121
+ const block = byId.get(owner(first.source));
122
+ if (block) block.outputs = [...(block.outputs || []), material];
123
+ }
124
+ return;
125
+ }
126
+ const source = target(first.source),
127
+ destination = target(edge.target);
128
+ if (source === destination) return;
129
+ connections.push({
130
+ ...edge,
131
+ source,
132
+ target: destination,
133
+ ...(materials.length
134
+ ? {
135
+ id: path.map((item) => item.id).join("::"),
136
+ artifacts: [...materials, ...(edge.artifacts || [])],
137
+ sources: path.flatMap(evidence),
138
+ provenance: path.some((item) => item.provenance === "inferred")
139
+ ? "inferred"
140
+ : edge.provenance,
141
+ }
142
+ : {}),
143
+ });
144
+ };
145
+ for (const edge of graph.connections) {
146
+ if (byId.get(edge.source)?.kind === "resource") continue;
147
+ const material = artifacts.get(edge.source);
148
+ if (
149
+ material &&
150
+ graph.connections.some((input) => input.target === edge.source)
151
+ )
152
+ continue;
153
+ follow(
154
+ edge,
155
+ edge,
156
+ [edge],
157
+ material ? [material] : [],
158
+ new Set(material ? [material.id] : []),
159
+ );
160
+ }
161
+ graph.elements = graph.elements
162
+ .filter((node) => !detached.has(node.id))
163
+ .map((node) => ({
164
+ ...node,
165
+ kind: kinds[node.kind],
166
+ parent: node.parent ? target(node.parent) : undefined,
167
+ hosting:
168
+ node.hosting || (node.kind === "deployment" ? node.label : undefined),
169
+ resources: node.resources?.filter(
170
+ (resource, i, all) =>
171
+ all.findIndex((item) => item.id === resource.id) === i,
172
+ ),
173
+ outputs: node.outputs?.filter(
174
+ (artifact, i, all) =>
175
+ all.findIndex((item) => item.id === artifact.id) === i,
176
+ ),
177
+ }));
178
+ graph.connections = connections;
179
+ graph.tests = graph.tests.map((test) => ({
180
+ ...test,
181
+ targets: [...new Set(test.targets.map(target))],
182
+ }));
183
+ graph.failures = graph.failures.map((failure) => ({
184
+ ...failure,
185
+ operationId: target(failure.operationId),
186
+ }));
187
+ graph.aliases = aliases;
188
+ return graph;
189
+ }
190
+
191
+ /** Collapsed black boxes retain the unique dependencies of their contents. */
192
+ export function blockResources(
193
+ graph: DefinitionGraph,
194
+ id: string,
195
+ ): ResourceAttachment[] {
196
+ const ids = new Set([id]);
197
+ for (let changed = true; changed; ) {
198
+ changed = false;
199
+ for (const node of graph.elements)
200
+ if (node.parent && ids.has(node.parent) && !ids.has(node.id)) {
201
+ ids.add(node.id);
202
+ changed = true;
203
+ }
204
+ }
205
+ return [
206
+ ...new Map(
207
+ graph.elements
208
+ .filter((node) => ids.has(node.id))
209
+ .flatMap((node) => node.resources || [])
210
+ .map((resource) => [resource.id, resource]),
211
+ ).values(),
212
+ ];
213
+ }
@@ -0,0 +1,61 @@
1
+ import type { DefinitionGraph } from "./model";
2
+
3
+ /** Evidence gaps, not claims that disconnected code is unused. Ownership follows
4
+ * parent identities, never string prefixes or physical file locations. */
5
+ export function mapQuality(graph: DefinitionGraph) {
6
+ const byId = new Map(graph.elements.map((node) => [node.id, node]));
7
+ const involved = new Set<string>();
8
+ const problems: string[] = [];
9
+ for (const node of graph.elements) {
10
+ if (node.parent && !byId.has(node.parent))
11
+ problems.push(`Missing parent: ${node.id}`);
12
+ const seen = new Set([node.id]);
13
+ let parent = node.parent;
14
+ while (parent) {
15
+ if (seen.has(parent)) {
16
+ problems.push(`Ownership cycle: ${node.id}`);
17
+ break;
18
+ }
19
+ seen.add(parent);
20
+ parent = byId.get(parent)?.parent;
21
+ }
22
+ }
23
+ for (const edge of graph.connections) {
24
+ for (const endpoint of [edge.source, edge.target]) {
25
+ if (!byId.has(endpoint))
26
+ problems.push(`Missing endpoint: ${edge.id}: ${endpoint}`);
27
+ let node = byId.get(endpoint);
28
+ const seen = new Set<string>();
29
+ while (node && !seen.has(node.id)) {
30
+ seen.add(node.id);
31
+ involved.add(node.id);
32
+ node = byId.get(node.parent || "");
33
+ }
34
+ }
35
+ }
36
+ if (byId.size !== graph.elements.length)
37
+ problems.push("Duplicate block identities");
38
+ return {
39
+ problems,
40
+ areas: graph.elements
41
+ .filter((node) => node.parent === graph.id)
42
+ .map((node) => ({
43
+ id: node.id,
44
+ label: node.label,
45
+ parts: graph.elements.filter((child) => child.parent === node.id)
46
+ .length,
47
+ connected: involved.has(node.id),
48
+ })),
49
+ missingPurpose: graph.elements
50
+ .filter(
51
+ (node) =>
52
+ node.id !== graph.id &&
53
+ !node.description &&
54
+ !node.attachments?.description,
55
+ )
56
+ .map((node) => node.id),
57
+ noMappedInteractions: graph.elements
58
+ .filter((node) => node.id !== graph.id && !involved.has(node.id))
59
+ .map((node) => node.id),
60
+ };
61
+ }