@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,191 @@
1
+ /** Work-switcher metadata. No checkout, compiler, diff or network calls. */
2
+ import { createHash } from "node:crypto";
3
+ import { basename, dirname, join } from "node:path";
4
+ import { statSync } from "node:fs";
5
+ import type { DefinitionGraph } from "./model";
6
+ import { readGit } from "./git-refs";
7
+ import { fileBlocks } from "./map-activity";
8
+ import { listWorkContexts, workDirectory } from "./work-context";
9
+ import { workingOverview } from "./working-code";
10
+ import type { WorkChoice, WorkChoices } from "./work-switcher-model";
11
+ const catalogs = new Map<string, { at: number; value: WorkChoices }>();
12
+ const details = new Map<string, { at: number; value: Promise<WorkChoices> }>();
13
+ function topBlocks(graph: DefinitionGraph, ids: Iterable<string>) {
14
+ const scope = [...ids];
15
+ if (!scope.length) return [];
16
+ const nodes = new Map(graph.elements.map((n) => [n.id, n])),
17
+ result = new Map<string, { id: string; label: string }>();
18
+ for (const id of scope) {
19
+ let node = nodes.get(id),
20
+ seen = new Set<string>();
21
+ while (node?.parent && node.parent !== graph.id && !seen.has(node.id)) {
22
+ seen.add(node.id);
23
+ node = nodes.get(node.parent);
24
+ }
25
+ if (node && node.id !== graph.id)
26
+ result.set(node.id, { id: node.id, label: node.label });
27
+ }
28
+ return [...result.values()];
29
+ }
30
+ export function workChoiceCatalog(
31
+ root: string,
32
+ graph: DefinitionGraph,
33
+ fresh = false,
34
+ ): WorkChoices {
35
+ const common = workDirectory(root);
36
+ const stamp = (path: string) => {
37
+ try {
38
+ return statSync(path).mtimeMs;
39
+ } catch {
40
+ return 0;
41
+ }
42
+ };
43
+ const key = `${common}:${graph.revision}:${stamp(common)}:${stamp(join(dirname(dirname(common)), "worktrees"))}`,
44
+ cached = catalogs.get(key);
45
+ if (!fresh && cached && Date.now() - cached.at < 30000) return cached.value;
46
+ const targets = listWorkContexts(root);
47
+ const heads = [
48
+ ...new Set(
49
+ targets
50
+ .map((t) => t.head)
51
+ .filter((h) => /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(h)),
52
+ ),
53
+ ];
54
+ const commits = new Map<string, WorkChoice["commit"]>();
55
+ if (heads.length) {
56
+ // One bounded metadata read for all heads, including branches without a checkout.
57
+ for (let at = 0; at < heads.length; at += 500) {
58
+ const rows = readGit(root, [
59
+ "show",
60
+ "--no-patch",
61
+ "--no-walk",
62
+ "--format=%H%x00%s%x00%cI%x00%an",
63
+ ...heads.slice(at, at + 500),
64
+ "--",
65
+ ])
66
+ .trim()
67
+ .split("\n");
68
+ for (const row of rows) {
69
+ const [head, subject, date, author] = row.split("\0");
70
+ if (head && subject && Number.isFinite(Date.parse(date)))
71
+ commits.set(head, {
72
+ subject: subject.slice(0, 300),
73
+ at: date,
74
+ author: author?.slice(0, 120) || "",
75
+ });
76
+ }
77
+ }
78
+ }
79
+ const value: WorkChoices = {
80
+ repository: createHash("sha256").update(common).digest("hex").slice(0, 20),
81
+ checkedAt: new Date().toISOString(),
82
+ detailed: false,
83
+ targets: targets.map((t) => ({
84
+ ...t,
85
+ detached: t.branch === "Detached checkout",
86
+ checkout: t.path
87
+ ? `${basename(dirname(t.path))}/${basename(t.path)}`
88
+ : undefined,
89
+ commit: commits.get(t.head),
90
+ blocks: topBlocks(graph, t.scope || []),
91
+ blockBasis: "plan",
92
+ })),
93
+ };
94
+ catalogs.set(key, { at: Date.now(), value });
95
+ while (catalogs.size > 12) catalogs.delete(catalogs.keys().next().value!);
96
+ return value;
97
+ }
98
+ /** Reuse the live-work adapter and its read budgets. Each checkout is independent; unknown is never clean. */
99
+ export async function workChoiceDetails(
100
+ root: string,
101
+ graph: DefinitionGraph,
102
+ fresh = false,
103
+ ): Promise<WorkChoices> {
104
+ const catalog = workChoiceCatalog(root, graph, fresh),
105
+ key = JSON.stringify([
106
+ catalog.repository,
107
+ graph.revision,
108
+ catalog.targets.map((t) => [t.id, t.head, t.scope, t.title]),
109
+ ]);
110
+ const saved = details.get(key);
111
+ if (!fresh && saved && Date.now() - saved.at < 30000) return saved.value;
112
+ const value = (async () => {
113
+ const targets = catalog.targets.map((t) => ({ ...t })),
114
+ local = targets.filter((t) => t.path);
115
+ const initial = await workingOverview(root, { fresh });
116
+ const byPath = new Map(initial.worktrees.map((t) => [t.path, t.id]));
117
+ let next = 0;
118
+ await Promise.all(
119
+ Array.from({ length: Math.min(4, local.length) }, async () => {
120
+ while (next < local.length) {
121
+ const target = local[next++];
122
+ try {
123
+ const id = byPath.get(target.path!);
124
+ if (!id) throw Error("Checkout is outside the status read budget");
125
+ const overview =
126
+ id === initial.selected
127
+ ? initial
128
+ : await workingOverview(root, {
129
+ worktree: id,
130
+ refreshSelected: fresh,
131
+ });
132
+ const tree = overview.worktrees.find(
133
+ (t) => t.id === overview.selected,
134
+ )!;
135
+ const edited = overview.paths
136
+ .filter((p) => p.kind === "file")
137
+ .map((p) => p.modifiedAt)
138
+ .filter((at): at is string => !!at)
139
+ .sort()
140
+ .at(-1);
141
+ target.status = {
142
+ changed: tree.changed,
143
+ conflicts: tree.conflicts,
144
+ checkedAt: tree.checkedAt,
145
+ editedAt: edited,
146
+ unavailable: tree.unavailable,
147
+ partial: overview.truncated,
148
+ };
149
+ if (!target.managed) {
150
+ target.blocks = topBlocks(
151
+ graph,
152
+ new Set(
153
+ overview.paths.flatMap((p) => [...fileBlocks(graph, p.path)]),
154
+ ),
155
+ );
156
+ target.blockBasis = "files";
157
+ }
158
+ } catch (error) {
159
+ target.status = {
160
+ changed: null,
161
+ conflicts: null,
162
+ checkedAt: null,
163
+ unavailable:
164
+ error instanceof Error ? error.message : "Status unavailable",
165
+ partial: false,
166
+ };
167
+ }
168
+ }
169
+ }),
170
+ );
171
+ return {
172
+ ...catalog,
173
+ targets,
174
+ detailed: true,
175
+ checkedAt: new Date().toISOString(),
176
+ };
177
+ })();
178
+ details.set(key, { at: Date.now(), value });
179
+ while (details.size > 12) details.delete(details.keys().next().value!);
180
+ void value.catch(() => details.delete(key));
181
+ return value;
182
+ }
183
+
184
+ export function invalidateWorkChoices(root: string) {
185
+ const common = workDirectory(root),
186
+ repository = createHash("sha256").update(common).digest("hex").slice(0, 20);
187
+ for (const key of catalogs.keys())
188
+ if (key.startsWith(common + ":")) catalogs.delete(key);
189
+ for (const key of details.keys())
190
+ if (JSON.parse(key)[0] === repository) details.delete(key);
191
+ }
@@ -0,0 +1,38 @@
1
+ import { resolve } from "node:path";
2
+ export async function runWorking(args: string[]): Promise<string> {
3
+ const option = (name: string) => {
4
+ const i = args.indexOf(name);
5
+ if (i < 0) return undefined;
6
+ const value = args[i + 1];
7
+ if (!value || value.startsWith("--")) throw Error(name + " needs a value");
8
+ return value;
9
+ };
10
+ const { workingOverview, workingDetail } = await import("./working-code");
11
+ const root = resolve(option("--root") || process.cwd()),
12
+ worktree = option("--worktree"),
13
+ file = option("--file");
14
+ if (file && !worktree)
15
+ throw Error("--file requires a worktree ID from fractal working --json");
16
+ if (file)
17
+ return JSON.stringify(await workingDetail(root, worktree!, file), null, 2);
18
+ const value = await workingOverview(root, { worktree, fresh: true });
19
+ if (args.includes("--json")) return JSON.stringify(value, null, 2);
20
+ const selected = value.worktrees.find((t) => t.id === value.selected)!;
21
+ return [
22
+ "Uncommitted work · " + value.checkedAt,
23
+ "Worktree attribution only; Git does not identify the editing agent.",
24
+ ...value.worktrees.map(
25
+ (t) =>
26
+ `${t.current ? "*" : " "} ${t.id} ${t.branch || "detached"} · ${t.unavailable ? "unavailable" : t.changed === null ? "status not loaded" : `${t.changed} changed paths`}`,
27
+ ),
28
+ "",
29
+ selected.path,
30
+ ...value.paths.map(
31
+ (p) =>
32
+ `${p.conflict ? "UU" : p.untracked ? "??" : p.index + p.working} ${p.path}`,
33
+ ),
34
+ ...(value.truncated
35
+ ? ["Showing first 500 paths; untracked folders are collapsed."]
36
+ : []),
37
+ ].join("\n");
38
+ }