pi-crew 0.1.45 → 0.1.46

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 (198) hide show
  1. package/README.md +5 -5
  2. package/agents/analyst.md +1 -1
  3. package/agents/critic.md +1 -1
  4. package/agents/executor.md +1 -1
  5. package/agents/explorer.md +1 -1
  6. package/agents/planner.md +1 -1
  7. package/agents/reviewer.md +1 -1
  8. package/agents/security-reviewer.md +1 -1
  9. package/agents/test-engineer.md +1 -1
  10. package/agents/verifier.md +1 -1
  11. package/agents/writer.md +1 -1
  12. package/docs/next-upgrade-roadmap.md +733 -0
  13. package/docs/refactor-tasks-phase3.md +394 -394
  14. package/docs/refactor-tasks-phase4.md +564 -564
  15. package/docs/refactor-tasks-phase5.md +402 -402
  16. package/docs/refactor-tasks-phase6.md +662 -662
  17. package/docs/research-awesome-agent-skills-distillation.md +100 -0
  18. package/docs/research-extension-examples.md +297 -297
  19. package/docs/research-extension-system.md +324 -324
  20. package/docs/research-oh-my-pi-distillation.md +322 -0
  21. package/docs/research-optimization-plan.md +548 -548
  22. package/docs/research-phase10-distillation.md +198 -198
  23. package/docs/research-phase11-distillation.md +201 -201
  24. package/docs/research-pi-coding-agent.md +357 -357
  25. package/docs/research-source-pi-crew-reference.md +174 -174
  26. package/docs/runtime-flow.md +148 -148
  27. package/docs/source-runtime-refactor-map.md +107 -83
  28. package/docs/usage.md +3 -3
  29. package/index.ts +6 -6
  30. package/install.mjs +52 -8
  31. package/package.json +1 -1
  32. package/schema.json +2 -1
  33. package/skills/async-worker-recovery/SKILL.md +42 -0
  34. package/skills/context-artifact-hygiene/SKILL.md +52 -0
  35. package/skills/delegation-patterns/SKILL.md +54 -0
  36. package/skills/mailbox-interactive/SKILL.md +40 -0
  37. package/skills/model-routing-context/SKILL.md +39 -0
  38. package/skills/multi-perspective-review/SKILL.md +58 -0
  39. package/skills/observability-reliability/SKILL.md +41 -0
  40. package/skills/ownership-session-security/SKILL.md +41 -0
  41. package/skills/pi-extension-lifecycle/SKILL.md +39 -0
  42. package/skills/requirements-to-task-packet/SKILL.md +63 -0
  43. package/skills/resource-discovery-config/SKILL.md +41 -0
  44. package/skills/runtime-state-reader/SKILL.md +44 -0
  45. package/skills/secure-agent-orchestration-review/SKILL.md +45 -0
  46. package/skills/state-mutation-locking/SKILL.md +42 -0
  47. package/skills/systematic-debugging/SKILL.md +67 -0
  48. package/skills/ui-render-performance/SKILL.md +39 -0
  49. package/skills/verification-before-done/SKILL.md +57 -0
  50. package/skills/worktree-isolation/SKILL.md +39 -0
  51. package/src/agents/agent-serializer.ts +34 -34
  52. package/src/agents/discover-agents.ts +12 -11
  53. package/src/config/config.ts +48 -24
  54. package/src/config/defaults.ts +14 -0
  55. package/src/extension/cross-extension-rpc.ts +82 -82
  56. package/src/extension/project-init.ts +62 -2
  57. package/src/extension/register.ts +11 -9
  58. package/src/extension/registration/commands.ts +32 -25
  59. package/src/extension/registration/compaction-guard.ts +125 -125
  60. package/src/extension/registration/subagent-helpers.ts +8 -0
  61. package/src/extension/registration/subagent-tools.ts +149 -148
  62. package/src/extension/registration/team-tool.ts +8 -6
  63. package/src/extension/run-bundle-schema.ts +89 -89
  64. package/src/extension/run-index.ts +13 -5
  65. package/src/extension/run-maintenance.ts +62 -43
  66. package/src/extension/team-tool/api.ts +25 -8
  67. package/src/extension/team-tool/cancel.ts +33 -4
  68. package/src/extension/team-tool/context.ts +5 -0
  69. package/src/extension/team-tool/handle-settings.ts +188 -188
  70. package/src/extension/team-tool/inspect.ts +41 -41
  71. package/src/extension/team-tool/lifecycle-actions.ts +91 -79
  72. package/src/extension/team-tool/plan.ts +19 -19
  73. package/src/extension/team-tool/respond.ts +37 -17
  74. package/src/extension/team-tool/run.ts +52 -10
  75. package/src/extension/team-tool/status.ts +12 -1
  76. package/src/extension/team-tool-types.ts +2 -0
  77. package/src/extension/team-tool.ts +32 -11
  78. package/src/i18n.ts +184 -184
  79. package/src/observability/event-to-metric.ts +8 -1
  80. package/src/observability/exporters/otlp-exporter.ts +77 -77
  81. package/src/prompt/prompt-runtime.ts +72 -72
  82. package/src/runtime/agent-control.ts +63 -63
  83. package/src/runtime/agent-memory.ts +72 -72
  84. package/src/runtime/agent-observability.ts +114 -114
  85. package/src/runtime/async-marker.ts +26 -26
  86. package/src/runtime/attention-events.ts +28 -28
  87. package/src/runtime/background-runner.ts +59 -53
  88. package/src/runtime/cancellation.ts +51 -0
  89. package/src/runtime/child-pi.ts +457 -444
  90. package/src/runtime/completion-guard.ts +190 -190
  91. package/src/runtime/crash-recovery.ts +1 -0
  92. package/src/runtime/crew-agent-records.ts +38 -6
  93. package/src/runtime/deadletter.ts +1 -0
  94. package/src/runtime/delivery-coordinator.ts +46 -25
  95. package/src/runtime/direct-run.ts +35 -35
  96. package/src/runtime/effectiveness.ts +76 -0
  97. package/src/runtime/foreground-control.ts +82 -82
  98. package/src/runtime/green-contract.ts +46 -46
  99. package/src/runtime/group-join.ts +106 -106
  100. package/src/runtime/heartbeat-gradient.ts +28 -28
  101. package/src/runtime/heartbeat-watcher.ts +124 -124
  102. package/src/runtime/live-agent-control.ts +88 -87
  103. package/src/runtime/live-agent-manager.ts +103 -85
  104. package/src/runtime/live-control-realtime.ts +36 -36
  105. package/src/runtime/live-session-runtime.ts +309 -305
  106. package/src/runtime/manifest-cache.ts +17 -2
  107. package/src/runtime/model-fallback.ts +6 -4
  108. package/src/runtime/parallel-research.ts +44 -44
  109. package/src/runtime/pi-args.ts +18 -3
  110. package/src/runtime/pi-json-output.ts +111 -111
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/process-status.ts +5 -1
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/recovery-recipes.ts +74 -74
  115. package/src/runtime/retry-executor.ts +81 -64
  116. package/src/runtime/role-permission.ts +39 -39
  117. package/src/runtime/runtime-resolver.ts +22 -6
  118. package/src/runtime/session-resources.ts +25 -25
  119. package/src/runtime/session-snapshot.ts +59 -59
  120. package/src/runtime/session-usage.ts +79 -79
  121. package/src/runtime/sidechain-output.ts +29 -29
  122. package/src/runtime/skill-instructions.ts +222 -0
  123. package/src/runtime/stale-reconciler.ts +4 -14
  124. package/src/runtime/subagent-manager.ts +3 -0
  125. package/src/runtime/supervisor-contact.ts +59 -59
  126. package/src/runtime/task-display.ts +38 -38
  127. package/src/runtime/task-output-context.ts +127 -127
  128. package/src/runtime/task-runner/capabilities.ts +78 -0
  129. package/src/runtime/task-runner/live-executor.ts +105 -101
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-builder.ts +3 -1
  132. package/src/runtime/task-runner/prompt-pipeline.ts +64 -0
  133. package/src/runtime/task-runner/result-utils.ts +14 -14
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/task-runner.ts +44 -5
  136. package/src/runtime/team-runner.ts +78 -15
  137. package/src/runtime/worker-heartbeat.ts +21 -21
  138. package/src/runtime/worker-startup.ts +57 -57
  139. package/src/schema/config-schema.ts +1 -0
  140. package/src/schema/team-tool-schema.ts +3 -3
  141. package/src/state/active-run-registry.ts +165 -0
  142. package/src/state/contracts.ts +1 -1
  143. package/src/state/mailbox.ts +44 -4
  144. package/src/state/state-store.ts +8 -1
  145. package/src/state/task-claims.ts +44 -44
  146. package/src/state/types.ts +44 -2
  147. package/src/state/usage.ts +29 -29
  148. package/src/subagents/async-entry.ts +1 -1
  149. package/src/subagents/index.ts +3 -3
  150. package/src/subagents/live/control.ts +1 -1
  151. package/src/subagents/live/manager.ts +1 -1
  152. package/src/subagents/live/realtime.ts +1 -1
  153. package/src/subagents/live/session-runtime.ts +1 -1
  154. package/src/subagents/manager.ts +1 -1
  155. package/src/subagents/spawn.ts +1 -1
  156. package/src/teams/team-config.ts +1 -0
  157. package/src/teams/team-serializer.ts +38 -38
  158. package/src/types/diff.d.ts +18 -18
  159. package/src/ui/crew-footer.ts +101 -101
  160. package/src/ui/crew-select-list.ts +111 -111
  161. package/src/ui/crew-widget.ts +4 -3
  162. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  163. package/src/ui/dashboard-panes/progress-pane.ts +2 -0
  164. package/src/ui/dynamic-border.ts +25 -25
  165. package/src/ui/layout-primitives.ts +106 -106
  166. package/src/ui/loaders.ts +158 -158
  167. package/src/ui/render-diff.ts +119 -119
  168. package/src/ui/render-scheduler.ts +143 -143
  169. package/src/ui/run-snapshot-cache.ts +10 -2
  170. package/src/ui/snapshot-types.ts +2 -0
  171. package/src/ui/spinner.ts +17 -17
  172. package/src/ui/status-colors.ts +58 -58
  173. package/src/ui/syntax-highlight.ts +116 -116
  174. package/src/utils/atomic-write.ts +33 -33
  175. package/src/utils/completion-dedupe.ts +63 -63
  176. package/src/utils/frontmatter.ts +68 -68
  177. package/src/utils/git.ts +262 -262
  178. package/src/utils/ids.ts +12 -12
  179. package/src/utils/names.ts +27 -27
  180. package/src/utils/paths.ts +4 -2
  181. package/src/utils/redaction.ts +44 -44
  182. package/src/utils/safe-paths.ts +47 -47
  183. package/src/utils/sleep.ts +32 -32
  184. package/src/workflows/validate-workflow.ts +40 -40
  185. package/src/workflows/workflow-config.ts +1 -0
  186. package/src/worktree/branch-freshness.ts +45 -45
  187. package/teams/default.team.md +12 -12
  188. package/teams/fast-fix.team.md +11 -11
  189. package/teams/implementation.team.md +18 -18
  190. package/teams/parallel-research.team.md +14 -14
  191. package/teams/research.team.md +11 -11
  192. package/teams/review.team.md +12 -12
  193. package/workflows/default.workflow.md +29 -29
  194. package/workflows/fast-fix.workflow.md +22 -22
  195. package/workflows/implementation.workflow.md +38 -38
  196. package/workflows/parallel-research.workflow.md +46 -46
  197. package/workflows/research.workflow.md +22 -22
  198. package/workflows/review.workflow.md +30 -30
@@ -1,58 +1,58 @@
1
- import type { CrewTheme, CrewThemeColor } from "./theme-adapter.ts";
2
-
3
- export type RunStatus = "queued" | "running" | "completed" | "failed" | "cancelled" | "stopped" | "blocked" | (string & {});
4
-
5
- export function colorForStatus(status: RunStatus): CrewThemeColor {
6
- switch (status) {
7
- case "running":
8
- return "accent";
9
- case "waiting":
10
- return "muted";
11
- case "completed":
12
- return "success";
13
- case "failed":
14
- case "stale":
15
- return "error";
16
- case "cancelled":
17
- case "blocked":
18
- case "stopped":
19
- return "warning";
20
- case "queued":
21
- default:
22
- return "dim";
23
- }
24
- }
25
-
26
- export function iconForStatus(status: RunStatus, options?: { runningGlyph?: string }): string {
27
- const glyph = options?.runningGlyph ?? "▶";
28
- switch (status) {
29
- case "completed":
30
- return "✓";
31
- case "failed":
32
- case "stale":
33
- return "✗";
34
- case "cancelled":
35
- case "stopped":
36
- return "■";
37
- case "running":
38
- return glyph;
39
- case "waiting":
40
- return "⏳";
41
- case "queued":
42
- return "◦";
43
- case "blocked":
44
- return "⏸";
45
- default:
46
- return "·";
47
- }
48
- }
49
-
50
- export function colorForActivity(activityState: string | undefined): CrewThemeColor {
51
- if (activityState === "needs_attention") return "warning";
52
- if (activityState === "stale") return "error";
53
- return "dim";
54
- }
55
-
56
- export function applyStatusColor(theme: CrewTheme, status: RunStatus, text: string): string {
57
- return theme.fg(colorForStatus(status), text);
58
- }
1
+ import type { CrewTheme, CrewThemeColor } from "./theme-adapter.ts";
2
+
3
+ export type RunStatus = "queued" | "running" | "completed" | "failed" | "cancelled" | "stopped" | "blocked" | (string & {});
4
+
5
+ export function colorForStatus(status: RunStatus): CrewThemeColor {
6
+ switch (status) {
7
+ case "running":
8
+ return "accent";
9
+ case "waiting":
10
+ return "muted";
11
+ case "completed":
12
+ return "success";
13
+ case "failed":
14
+ case "stale":
15
+ return "error";
16
+ case "cancelled":
17
+ case "blocked":
18
+ case "stopped":
19
+ return "warning";
20
+ case "queued":
21
+ default:
22
+ return "dim";
23
+ }
24
+ }
25
+
26
+ export function iconForStatus(status: RunStatus, options?: { runningGlyph?: string }): string {
27
+ const glyph = options?.runningGlyph ?? "▶";
28
+ switch (status) {
29
+ case "completed":
30
+ return "✓";
31
+ case "failed":
32
+ case "stale":
33
+ return "✗";
34
+ case "cancelled":
35
+ case "stopped":
36
+ return "■";
37
+ case "running":
38
+ return glyph;
39
+ case "waiting":
40
+ return "⏳";
41
+ case "queued":
42
+ return "◦";
43
+ case "blocked":
44
+ return "⏸";
45
+ default:
46
+ return "·";
47
+ }
48
+ }
49
+
50
+ export function colorForActivity(activityState: string | undefined): CrewThemeColor {
51
+ if (activityState === "needs_attention") return "warning";
52
+ if (activityState === "stale") return "error";
53
+ return "dim";
54
+ }
55
+
56
+ export function applyStatusColor(theme: CrewTheme, status: RunStatus, text: string): string {
57
+ return theme.fg(colorForStatus(status), text);
58
+ }
@@ -1,116 +1,116 @@
1
- import { supportsLanguage, highlight } from "cli-highlight";
2
- import type { CrewTheme } from "./theme-adapter.ts";
3
- import { asCrewTheme } from "./theme-adapter.ts";
4
-
5
- function buildCliTheme(theme: CrewTheme): Record<string, (text: string) => string> {
6
- return {
7
- keyword: (text) => theme.fg("syntaxKeyword", text),
8
- built_in: (text) => theme.fg("syntaxType", text),
9
- literal: (text) => theme.fg("syntaxNumber", text),
10
- number: (text) => theme.fg("syntaxNumber", text),
11
- string: (text) => theme.fg("syntaxString", text),
12
- comment: (text) => theme.fg("syntaxComment", text),
13
- function: (text) => theme.fg("syntaxFunction", text),
14
- title: (text) => theme.fg("syntaxFunction", text),
15
- class: (text) => theme.fg("syntaxType", text),
16
- type: (text) => theme.fg("syntaxType", text),
17
- attr: (text) => theme.fg("syntaxVariable", text),
18
- variable: (text) => theme.fg("syntaxVariable", text),
19
- params: (text) => theme.fg("syntaxVariable", text),
20
- operator: (text) => theme.fg("syntaxOperator", text),
21
- punctuation: (text) => theme.fg("syntaxPunctuation", text),
22
- };
23
- }
24
-
25
- export function detectLanguageFromPath(filePath: string): string | undefined {
26
- const ext = filePath.split(".").pop()?.toLowerCase();
27
- if (!ext) return undefined;
28
- return languageMap[ext];
29
- }
30
-
31
- export const languageMap: Record<string, string> = {
32
- ts: "typescript",
33
- tsx: "typescript",
34
- js: "javascript",
35
- jsx: "javascript",
36
- mjs: "javascript",
37
- cjs: "javascript",
38
- py: "python",
39
- md: "markdown",
40
- markdown: "markdown",
41
- json: "json",
42
- yml: "yaml",
43
- yaml: "yaml",
44
- toml: "yaml",
45
- html: "html",
46
- htm: "html",
47
- css: "css",
48
- scss: "scss",
49
- sass: "sass",
50
- bash: "bash",
51
- sh: "bash",
52
- zsh: "bash",
53
- fish: "bash",
54
- ps1: "powershell",
55
- sql: "sql",
56
- rust: "rust",
57
- rb: "ruby",
58
- go: "go",
59
- java: "java",
60
- kt: "kotlin",
61
- cpp: "cpp",
62
- cc: "cpp",
63
- cxx: "cpp",
64
- hpp: "cpp",
65
- c: "c",
66
- h: "c",
67
- cs: "csharp",
68
- php: "php",
69
- };
70
-
71
- export function highlightCode(code: string, language: string | undefined, themeLike: unknown = undefined): string {
72
- const theme = asCrewTheme(themeLike);
73
- const validLanguage = language && supportsLanguage(language) ? language : undefined;
74
- if (!validLanguage) {
75
- return code
76
- .split("\n")
77
- .map((line) => theme.fg("mdCodeBlock", line))
78
- .join("\n");
79
- }
80
- try {
81
- return highlight(code, {
82
- language: validLanguage,
83
- ignoreIllegals: true,
84
- theme: buildCliTheme(theme),
85
- }).trimEnd();
86
- } catch {
87
- return code
88
- .split("\n")
89
- .map((line) => theme.fg("mdCodeBlock", line))
90
- .join("\n");
91
- }
92
- }
93
-
94
- export function highlightJson(payload: string, themeLike: unknown = undefined): string {
95
- const theme = asCrewTheme(themeLike);
96
- try {
97
- return highlight(payload, {
98
- language: "json",
99
- ignoreIllegals: true,
100
- theme: buildCliTheme(theme),
101
- }).trimEnd();
102
- } catch {
103
- try {
104
- const parsed = JSON.parse(payload);
105
- return JSON.stringify(parsed, null, 2)
106
- .split("\n")
107
- .map((line) => theme.fg("mdCodeBlock", line))
108
- .join("\n");
109
- } catch {
110
- return payload
111
- .split("\n")
112
- .map((line) => theme.fg("mdCodeBlock", line))
113
- .join("\n");
114
- }
115
- }
116
- }
1
+ import { supportsLanguage, highlight } from "cli-highlight";
2
+ import type { CrewTheme } from "./theme-adapter.ts";
3
+ import { asCrewTheme } from "./theme-adapter.ts";
4
+
5
+ function buildCliTheme(theme: CrewTheme): Record<string, (text: string) => string> {
6
+ return {
7
+ keyword: (text) => theme.fg("syntaxKeyword", text),
8
+ built_in: (text) => theme.fg("syntaxType", text),
9
+ literal: (text) => theme.fg("syntaxNumber", text),
10
+ number: (text) => theme.fg("syntaxNumber", text),
11
+ string: (text) => theme.fg("syntaxString", text),
12
+ comment: (text) => theme.fg("syntaxComment", text),
13
+ function: (text) => theme.fg("syntaxFunction", text),
14
+ title: (text) => theme.fg("syntaxFunction", text),
15
+ class: (text) => theme.fg("syntaxType", text),
16
+ type: (text) => theme.fg("syntaxType", text),
17
+ attr: (text) => theme.fg("syntaxVariable", text),
18
+ variable: (text) => theme.fg("syntaxVariable", text),
19
+ params: (text) => theme.fg("syntaxVariable", text),
20
+ operator: (text) => theme.fg("syntaxOperator", text),
21
+ punctuation: (text) => theme.fg("syntaxPunctuation", text),
22
+ };
23
+ }
24
+
25
+ export function detectLanguageFromPath(filePath: string): string | undefined {
26
+ const ext = filePath.split(".").pop()?.toLowerCase();
27
+ if (!ext) return undefined;
28
+ return languageMap[ext];
29
+ }
30
+
31
+ export const languageMap: Record<string, string> = {
32
+ ts: "typescript",
33
+ tsx: "typescript",
34
+ js: "javascript",
35
+ jsx: "javascript",
36
+ mjs: "javascript",
37
+ cjs: "javascript",
38
+ py: "python",
39
+ md: "markdown",
40
+ markdown: "markdown",
41
+ json: "json",
42
+ yml: "yaml",
43
+ yaml: "yaml",
44
+ toml: "yaml",
45
+ html: "html",
46
+ htm: "html",
47
+ css: "css",
48
+ scss: "scss",
49
+ sass: "sass",
50
+ bash: "bash",
51
+ sh: "bash",
52
+ zsh: "bash",
53
+ fish: "bash",
54
+ ps1: "powershell",
55
+ sql: "sql",
56
+ rust: "rust",
57
+ rb: "ruby",
58
+ go: "go",
59
+ java: "java",
60
+ kt: "kotlin",
61
+ cpp: "cpp",
62
+ cc: "cpp",
63
+ cxx: "cpp",
64
+ hpp: "cpp",
65
+ c: "c",
66
+ h: "c",
67
+ cs: "csharp",
68
+ php: "php",
69
+ };
70
+
71
+ export function highlightCode(code: string, language: string | undefined, themeLike: unknown = undefined): string {
72
+ const theme = asCrewTheme(themeLike);
73
+ const validLanguage = language && supportsLanguage(language) ? language : undefined;
74
+ if (!validLanguage) {
75
+ return code
76
+ .split("\n")
77
+ .map((line) => theme.fg("mdCodeBlock", line))
78
+ .join("\n");
79
+ }
80
+ try {
81
+ return highlight(code, {
82
+ language: validLanguage,
83
+ ignoreIllegals: true,
84
+ theme: buildCliTheme(theme),
85
+ }).trimEnd();
86
+ } catch {
87
+ return code
88
+ .split("\n")
89
+ .map((line) => theme.fg("mdCodeBlock", line))
90
+ .join("\n");
91
+ }
92
+ }
93
+
94
+ export function highlightJson(payload: string, themeLike: unknown = undefined): string {
95
+ const theme = asCrewTheme(themeLike);
96
+ try {
97
+ return highlight(payload, {
98
+ language: "json",
99
+ ignoreIllegals: true,
100
+ theme: buildCliTheme(theme),
101
+ }).trimEnd();
102
+ } catch {
103
+ try {
104
+ const parsed = JSON.parse(payload);
105
+ return JSON.stringify(parsed, null, 2)
106
+ .split("\n")
107
+ .map((line) => theme.fg("mdCodeBlock", line))
108
+ .join("\n");
109
+ } catch {
110
+ return payload
111
+ .split("\n")
112
+ .map((line) => theme.fg("mdCodeBlock", line))
113
+ .join("\n");
114
+ }
115
+ }
116
+ }
@@ -1,33 +1,33 @@
1
- import * as fs from "node:fs";
2
- import * as path from "node:path";
3
-
4
- /**
5
- * Write JSON data to a file atomically.
6
- * Uses write-to-temp + rename to avoid torn writes on crash.
7
- */
8
- export function writeAtomicJson(filePath: string, data: unknown, pretty = false): void {
9
- const dir = path.dirname(filePath);
10
- const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
11
- const tmpPath = filePath + ".tmp";
12
- fs.writeFileSync(tmpPath, content, "utf-8");
13
- fs.renameSync(tmpPath, filePath);
14
- }
15
-
16
- /**
17
- * Read and parse JSON from a file. Returns undefined on any error.
18
- */
19
- export function readJsonFile<T = unknown>(filePath: string): T | undefined {
20
- try {
21
- return JSON.parse(fs.readFileSync(filePath, "utf-8")) as T;
22
- } catch {
23
- return undefined;
24
- }
25
- }
26
-
27
- /**
28
- * Append a JSON line to a JSONL file atomically per line.
29
- */
30
- export function appendJsonlLine(filePath: string, data: unknown): void {
31
- const line = JSON.stringify(data) + "\n";
32
- fs.appendFileSync(filePath, line, "utf-8");
33
- }
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+
4
+ /**
5
+ * Write JSON data to a file atomically.
6
+ * Uses write-to-temp + rename to avoid torn writes on crash.
7
+ */
8
+ export function writeAtomicJson(filePath: string, data: unknown, pretty = false): void {
9
+ const dir = path.dirname(filePath);
10
+ const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
11
+ const tmpPath = filePath + ".tmp";
12
+ fs.writeFileSync(tmpPath, content, "utf-8");
13
+ fs.renameSync(tmpPath, filePath);
14
+ }
15
+
16
+ /**
17
+ * Read and parse JSON from a file. Returns undefined on any error.
18
+ */
19
+ export function readJsonFile<T = unknown>(filePath: string): T | undefined {
20
+ try {
21
+ return JSON.parse(fs.readFileSync(filePath, "utf-8")) as T;
22
+ } catch {
23
+ return undefined;
24
+ }
25
+ }
26
+
27
+ /**
28
+ * Append a JSON line to a JSONL file atomically per line.
29
+ */
30
+ export function appendJsonlLine(filePath: string, data: unknown): void {
31
+ const line = JSON.stringify(data) + "\n";
32
+ fs.appendFileSync(filePath, line, "utf-8");
33
+ }
@@ -1,63 +1,63 @@
1
- interface CompletionDataLike {
2
- id?: unknown;
3
- agent?: unknown;
4
- timestamp?: unknown;
5
- sessionId?: unknown;
6
- taskIndex?: unknown;
7
- totalTasks?: unknown;
8
- success?: unknown;
9
- }
10
-
11
- function asNonEmptyString(value: unknown): string | undefined {
12
- if (typeof value !== "string") return undefined;
13
- const trimmed = value.trim();
14
- return trimmed.length > 0 ? trimmed : undefined;
15
- }
16
-
17
- function asFiniteNumber(value: unknown): number | undefined {
18
- if (typeof value !== "number") return undefined;
19
- return Number.isFinite(value) ? value : undefined;
20
- }
21
-
22
- export function buildCompletionKey(data: CompletionDataLike, fallback: string): string {
23
- const id = asNonEmptyString(data.id);
24
- if (id) return `id:${id}`;
25
- const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
26
- const agent = asNonEmptyString(data.agent) ?? "unknown";
27
- const timestamp = asFiniteNumber(data.timestamp);
28
- const taskIndex = asFiniteNumber(data.taskIndex);
29
- const totalTasks = asFiniteNumber(data.totalTasks);
30
- const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
31
- return [
32
- "meta",
33
- sessionId,
34
- agent,
35
- timestamp !== undefined ? String(timestamp) : "no-ts",
36
- taskIndex !== undefined ? String(taskIndex) : "-",
37
- totalTasks !== undefined ? String(totalTasks) : "-",
38
- success,
39
- fallback,
40
- ].join(":");
41
- }
42
-
43
- export function pruneSeenMap(seen: Map<string, number>, now: number, ttlMs: number): void {
44
- for (const [key, ts] of seen.entries()) {
45
- if (now - ts > ttlMs) seen.delete(key);
46
- }
47
- }
48
-
49
- export function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean {
50
- pruneSeenMap(seen, now, ttlMs);
51
- if (seen.has(key)) return true;
52
- seen.set(key, now);
53
- return false;
54
- }
55
-
56
- export function getGlobalSeenMap(storeKey: string): Map<string, number> {
57
- const globalStore = globalThis as Record<string, unknown>;
58
- const existing = globalStore[storeKey];
59
- if (existing instanceof Map) return existing as Map<string, number>;
60
- const map = new Map<string, number>();
61
- globalStore[storeKey] = map;
62
- return map;
63
- }
1
+ interface CompletionDataLike {
2
+ id?: unknown;
3
+ agent?: unknown;
4
+ timestamp?: unknown;
5
+ sessionId?: unknown;
6
+ taskIndex?: unknown;
7
+ totalTasks?: unknown;
8
+ success?: unknown;
9
+ }
10
+
11
+ function asNonEmptyString(value: unknown): string | undefined {
12
+ if (typeof value !== "string") return undefined;
13
+ const trimmed = value.trim();
14
+ return trimmed.length > 0 ? trimmed : undefined;
15
+ }
16
+
17
+ function asFiniteNumber(value: unknown): number | undefined {
18
+ if (typeof value !== "number") return undefined;
19
+ return Number.isFinite(value) ? value : undefined;
20
+ }
21
+
22
+ export function buildCompletionKey(data: CompletionDataLike, fallback: string): string {
23
+ const id = asNonEmptyString(data.id);
24
+ if (id) return `id:${id}`;
25
+ const sessionId = asNonEmptyString(data.sessionId) ?? "no-session";
26
+ const agent = asNonEmptyString(data.agent) ?? "unknown";
27
+ const timestamp = asFiniteNumber(data.timestamp);
28
+ const taskIndex = asFiniteNumber(data.taskIndex);
29
+ const totalTasks = asFiniteNumber(data.totalTasks);
30
+ const success = typeof data.success === "boolean" ? (data.success ? "1" : "0") : "?";
31
+ return [
32
+ "meta",
33
+ sessionId,
34
+ agent,
35
+ timestamp !== undefined ? String(timestamp) : "no-ts",
36
+ taskIndex !== undefined ? String(taskIndex) : "-",
37
+ totalTasks !== undefined ? String(totalTasks) : "-",
38
+ success,
39
+ fallback,
40
+ ].join(":");
41
+ }
42
+
43
+ export function pruneSeenMap(seen: Map<string, number>, now: number, ttlMs: number): void {
44
+ for (const [key, ts] of seen.entries()) {
45
+ if (now - ts > ttlMs) seen.delete(key);
46
+ }
47
+ }
48
+
49
+ export function markSeenWithTtl(seen: Map<string, number>, key: string, now: number, ttlMs: number): boolean {
50
+ pruneSeenMap(seen, now, ttlMs);
51
+ if (seen.has(key)) return true;
52
+ seen.set(key, now);
53
+ return false;
54
+ }
55
+
56
+ export function getGlobalSeenMap(storeKey: string): Map<string, number> {
57
+ const globalStore = globalThis as Record<string, unknown>;
58
+ const existing = globalStore[storeKey];
59
+ if (existing instanceof Map) return existing as Map<string, number>;
60
+ const map = new Map<string, number>();
61
+ globalStore[storeKey] = map;
62
+ return map;
63
+ }