pi-crew 0.1.43 → 0.1.45

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 (158) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/agents/analyst.md +11 -11
  3. package/agents/critic.md +11 -11
  4. package/agents/executor.md +11 -11
  5. package/agents/explorer.md +11 -11
  6. package/agents/planner.md +11 -11
  7. package/agents/reviewer.md +11 -11
  8. package/agents/security-reviewer.md +11 -11
  9. package/agents/test-engineer.md +11 -11
  10. package/agents/verifier.md +11 -11
  11. package/agents/writer.md +11 -11
  12. package/docs/refactor-tasks-phase3.md +394 -394
  13. package/docs/refactor-tasks-phase4.md +564 -564
  14. package/docs/refactor-tasks-phase5.md +402 -402
  15. package/docs/refactor-tasks-phase6.md +662 -662
  16. package/docs/research-extension-examples.md +297 -297
  17. package/docs/research-extension-system.md +324 -324
  18. package/docs/research-optimization-plan.md +548 -548
  19. package/docs/research-phase10-distillation.md +199 -0
  20. package/docs/research-phase11-distillation.md +201 -0
  21. package/docs/research-pi-coding-agent.md +357 -357
  22. package/docs/research-source-pi-crew-reference.md +174 -174
  23. package/docs/runtime-flow.md +148 -148
  24. package/docs/source-runtime-refactor-map.md +83 -83
  25. package/index.ts +6 -6
  26. package/package.json +1 -1
  27. package/src/agents/agent-serializer.ts +34 -34
  28. package/src/agents/discover-agents.ts +1 -0
  29. package/src/config/config.ts +19 -0
  30. package/src/extension/cross-extension-rpc.ts +82 -82
  31. package/src/extension/register.ts +134 -8
  32. package/src/extension/registration/commands.ts +18 -2
  33. package/src/extension/registration/compaction-guard.ts +125 -125
  34. package/src/extension/registration/subagent-tools.ts +148 -148
  35. package/src/extension/registration/team-tool.ts +27 -8
  36. package/src/extension/run-bundle-schema.ts +89 -89
  37. package/src/extension/run-index.ts +19 -0
  38. package/src/extension/run-maintenance.ts +43 -43
  39. package/src/extension/team-tool/api.ts +1 -1
  40. package/src/extension/team-tool/cancel.ts +79 -4
  41. package/src/extension/team-tool/context.ts +2 -0
  42. package/src/extension/team-tool/handle-settings.ts +188 -188
  43. package/src/extension/team-tool/inspect.ts +41 -41
  44. package/src/extension/team-tool/lifecycle-actions.ts +79 -79
  45. package/src/extension/team-tool/plan.ts +19 -19
  46. package/src/extension/team-tool/respond.ts +84 -0
  47. package/src/extension/team-tool/run.ts +3 -2
  48. package/src/extension/team-tool/status.ts +7 -1
  49. package/src/extension/team-tool-types.ts +4 -0
  50. package/src/extension/team-tool.ts +2 -0
  51. package/src/i18n.ts +184 -184
  52. package/src/observability/event-to-metric.ts +6 -0
  53. package/src/observability/exporters/otlp-exporter.ts +77 -77
  54. package/src/prompt/prompt-runtime.ts +72 -72
  55. package/src/runtime/agent-control.ts +63 -63
  56. package/src/runtime/agent-memory.ts +72 -72
  57. package/src/runtime/agent-observability.ts +114 -114
  58. package/src/runtime/async-marker.ts +26 -26
  59. package/src/runtime/attention-events.ts +28 -28
  60. package/src/runtime/background-runner.ts +53 -53
  61. package/src/runtime/child-pi.ts +444 -444
  62. package/src/runtime/completion-guard.ts +87 -0
  63. package/src/runtime/crash-recovery.ts +30 -0
  64. package/src/runtime/crew-agent-records.ts +8 -0
  65. package/src/runtime/crew-agent-runtime.ts +2 -1
  66. package/src/runtime/delivery-coordinator.ts +154 -0
  67. package/src/runtime/direct-run.ts +35 -35
  68. package/src/runtime/foreground-control.ts +82 -82
  69. package/src/runtime/green-contract.ts +46 -46
  70. package/src/runtime/group-join.ts +106 -106
  71. package/src/runtime/heartbeat-gradient.ts +28 -28
  72. package/src/runtime/heartbeat-watcher.ts +124 -124
  73. package/src/runtime/live-agent-control.ts +87 -87
  74. package/src/runtime/live-agent-manager.ts +85 -85
  75. package/src/runtime/live-control-realtime.ts +36 -36
  76. package/src/runtime/live-session-runtime.ts +305 -305
  77. package/src/runtime/model-fallback.ts +5 -2
  78. package/src/runtime/overflow-recovery.ts +176 -0
  79. package/src/runtime/parallel-research.ts +44 -44
  80. package/src/runtime/pi-json-output.ts +111 -111
  81. package/src/runtime/policy-engine.ts +79 -79
  82. package/src/runtime/process-status.ts +1 -1
  83. package/src/runtime/progress-event-coalescer.ts +43 -43
  84. package/src/runtime/recovery-recipes.ts +74 -74
  85. package/src/runtime/retry-executor.ts +64 -64
  86. package/src/runtime/role-permission.ts +39 -39
  87. package/src/runtime/session-resources.ts +25 -0
  88. package/src/runtime/session-snapshot.ts +59 -0
  89. package/src/runtime/session-usage.ts +79 -79
  90. package/src/runtime/sidechain-output.ts +29 -29
  91. package/src/runtime/stale-reconciler.ts +199 -0
  92. package/src/runtime/supervisor-contact.ts +59 -0
  93. package/src/runtime/task-display.ts +38 -38
  94. package/src/runtime/task-output-context.ts +127 -127
  95. package/src/runtime/task-runner/live-executor.ts +101 -101
  96. package/src/runtime/task-runner/progress.ts +119 -119
  97. package/src/runtime/task-runner/result-utils.ts +14 -14
  98. package/src/runtime/task-runner/state-helpers.ts +22 -22
  99. package/src/runtime/task-runner.ts +14 -0
  100. package/src/runtime/team-runner.ts +19 -8
  101. package/src/runtime/worker-heartbeat.ts +21 -21
  102. package/src/runtime/worker-startup.ts +57 -57
  103. package/src/schema/config-schema.ts +1 -0
  104. package/src/schema/team-tool-schema.ts +6 -1
  105. package/src/state/contracts.ts +6 -2
  106. package/src/state/state-store.ts +43 -0
  107. package/src/state/task-claims.ts +44 -44
  108. package/src/state/types.ts +2 -0
  109. package/src/state/usage.ts +29 -29
  110. package/src/subagents/async-entry.ts +1 -1
  111. package/src/subagents/index.ts +3 -3
  112. package/src/subagents/live/control.ts +1 -1
  113. package/src/subagents/live/manager.ts +1 -1
  114. package/src/subagents/live/realtime.ts +1 -1
  115. package/src/subagents/live/session-runtime.ts +1 -1
  116. package/src/subagents/manager.ts +1 -1
  117. package/src/subagents/spawn.ts +1 -1
  118. package/src/teams/team-serializer.ts +38 -38
  119. package/src/types/diff.d.ts +18 -18
  120. package/src/ui/crew-footer.ts +101 -101
  121. package/src/ui/crew-select-list.ts +111 -111
  122. package/src/ui/crew-widget.ts +10 -5
  123. package/src/ui/dashboard-panes/mailbox-pane.ts +2 -1
  124. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  125. package/src/ui/dynamic-border.ts +25 -25
  126. package/src/ui/layout-primitives.ts +106 -106
  127. package/src/ui/loaders.ts +158 -158
  128. package/src/ui/powerbar-publisher.ts +4 -4
  129. package/src/ui/render-diff.ts +119 -119
  130. package/src/ui/render-scheduler.ts +143 -143
  131. package/src/ui/run-snapshot-cache.ts +310 -17
  132. package/src/ui/snapshot-types.ts +5 -0
  133. package/src/ui/spinner.ts +17 -17
  134. package/src/ui/status-colors.ts +58 -54
  135. package/src/ui/syntax-highlight.ts +116 -116
  136. package/src/utils/atomic-write.ts +33 -0
  137. package/src/utils/completion-dedupe.ts +63 -63
  138. package/src/utils/frontmatter.ts +68 -68
  139. package/src/utils/git.ts +262 -262
  140. package/src/utils/ids.ts +12 -12
  141. package/src/utils/names.ts +27 -27
  142. package/src/utils/redaction.ts +44 -44
  143. package/src/utils/safe-paths.ts +47 -47
  144. package/src/utils/sleep.ts +32 -32
  145. package/src/workflows/validate-workflow.ts +40 -40
  146. package/src/worktree/branch-freshness.ts +45 -45
  147. package/teams/default.team.md +12 -12
  148. package/teams/fast-fix.team.md +11 -11
  149. package/teams/implementation.team.md +18 -18
  150. package/teams/parallel-research.team.md +14 -14
  151. package/teams/research.team.md +11 -11
  152. package/teams/review.team.md +12 -12
  153. package/workflows/default.workflow.md +29 -29
  154. package/workflows/fast-fix.workflow.md +22 -22
  155. package/workflows/implementation.workflow.md +38 -38
  156. package/workflows/parallel-research.workflow.md +46 -46
  157. package/workflows/research.workflow.md +22 -22
  158. package/workflows/review.workflow.md +30 -30
@@ -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
+ }
@@ -0,0 +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,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
+ }
@@ -1,68 +1,68 @@
1
- export interface ParsedFrontmatter {
2
- frontmatter: Record<string, string>;
3
- body: string;
4
- }
5
-
6
- export function parseFrontmatter(content: string): ParsedFrontmatter {
7
- if (!content.startsWith("---\n") && !content.startsWith("---\r\n")) {
8
- return { frontmatter: {}, body: content };
9
- }
10
-
11
- const normalized = content.replaceAll("\r\n", "\n");
12
- const end = normalized.indexOf("\n---\n", 4);
13
- if (end === -1) {
14
- // Support frontmatter that ends at EOF without trailing newline after ---.
15
- const altEnd = normalized.indexOf("\n---", 4);
16
- if (altEnd !== -1 && altEnd + 4 === normalized.length) {
17
- const raw = normalized.slice(4, altEnd);
18
- const frontmatter = parseLines(raw);
19
- return { frontmatter, body: "" };
20
- }
21
- return { frontmatter: {}, body: content };
22
- }
23
-
24
- const raw = normalized.slice(4, end);
25
- const body = normalized.slice(end + "\n---\n".length);
26
- const frontmatter = parseLines(raw);
27
- return { frontmatter, body };
28
- }
29
-
30
- function parseLines(raw: string): Record<string, string> {
31
- const frontmatter: Record<string, string> = {};
32
- for (const line of raw.split("\n")) {
33
- const trimmed = line.trim();
34
- if (!trimmed || trimmed.startsWith("#")) continue;
35
- const separator = trimmed.indexOf(":");
36
- if (separator === -1) continue;
37
- const key = trimmed.slice(0, separator).trim();
38
- const value = trimmed.slice(separator + 1).trim();
39
- if (key) frontmatter[key] = value;
40
- }
41
- return frontmatter;
42
- }
43
-
44
- export function parseCsv(value: string | undefined): string[] | undefined {
45
- if (value === undefined) return undefined;
46
- // Handle quoted values with commas inside.
47
- const values = splitCsv(value).map((item) => item.trim()).filter(Boolean);
48
- return values.length > 0 ? [...new Set(values)] : undefined;
49
- }
50
-
51
- function splitCsv(input: string): string[] {
52
- const result: string[] = [];
53
- let current = "";
54
- let inQuotes = false;
55
- for (let i = 0; i < input.length; i++) {
56
- const char = input[i];
57
- if (char === '"') {
58
- inQuotes = !inQuotes;
59
- } else if (char === "," && !inQuotes) {
60
- result.push(current);
61
- current = "";
62
- } else {
63
- current += char;
64
- }
65
- }
66
- result.push(current);
67
- return result;
68
- }
1
+ export interface ParsedFrontmatter {
2
+ frontmatter: Record<string, string>;
3
+ body: string;
4
+ }
5
+
6
+ export function parseFrontmatter(content: string): ParsedFrontmatter {
7
+ if (!content.startsWith("---\n") && !content.startsWith("---\r\n")) {
8
+ return { frontmatter: {}, body: content };
9
+ }
10
+
11
+ const normalized = content.replaceAll("\r\n", "\n");
12
+ const end = normalized.indexOf("\n---\n", 4);
13
+ if (end === -1) {
14
+ // Support frontmatter that ends at EOF without trailing newline after ---.
15
+ const altEnd = normalized.indexOf("\n---", 4);
16
+ if (altEnd !== -1 && altEnd + 4 === normalized.length) {
17
+ const raw = normalized.slice(4, altEnd);
18
+ const frontmatter = parseLines(raw);
19
+ return { frontmatter, body: "" };
20
+ }
21
+ return { frontmatter: {}, body: content };
22
+ }
23
+
24
+ const raw = normalized.slice(4, end);
25
+ const body = normalized.slice(end + "\n---\n".length);
26
+ const frontmatter = parseLines(raw);
27
+ return { frontmatter, body };
28
+ }
29
+
30
+ function parseLines(raw: string): Record<string, string> {
31
+ const frontmatter: Record<string, string> = {};
32
+ for (const line of raw.split("\n")) {
33
+ const trimmed = line.trim();
34
+ if (!trimmed || trimmed.startsWith("#")) continue;
35
+ const separator = trimmed.indexOf(":");
36
+ if (separator === -1) continue;
37
+ const key = trimmed.slice(0, separator).trim();
38
+ const value = trimmed.slice(separator + 1).trim();
39
+ if (key) frontmatter[key] = value;
40
+ }
41
+ return frontmatter;
42
+ }
43
+
44
+ export function parseCsv(value: string | undefined): string[] | undefined {
45
+ if (value === undefined) return undefined;
46
+ // Handle quoted values with commas inside.
47
+ const values = splitCsv(value).map((item) => item.trim()).filter(Boolean);
48
+ return values.length > 0 ? [...new Set(values)] : undefined;
49
+ }
50
+
51
+ function splitCsv(input: string): string[] {
52
+ const result: string[] = [];
53
+ let current = "";
54
+ let inQuotes = false;
55
+ for (let i = 0; i < input.length; i++) {
56
+ const char = input[i];
57
+ if (char === '"') {
58
+ inQuotes = !inQuotes;
59
+ } else if (char === "," && !inQuotes) {
60
+ result.push(current);
61
+ current = "";
62
+ } else {
63
+ current += char;
64
+ }
65
+ }
66
+ result.push(current);
67
+ return result;
68
+ }