pi-crew 0.1.46 → 0.1.49

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 (253) hide show
  1. package/CHANGELOG.md +97 -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/next-upgrade-roadmap.md +117 -42
  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/AGENT-EXECUTION-ARCHITECTURE.md +261 -0
  18. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +111 -0
  19. package/docs/research/AUDIT_OH_MY_PI.md +261 -0
  20. package/docs/research/AUDIT_PI_CREW.md +457 -0
  21. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +281 -0
  22. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +264 -0
  23. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +343 -0
  24. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +480 -0
  25. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +354 -0
  26. package/docs/research/IMPLEMENTATION_PLAN.md +385 -0
  27. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +502 -0
  28. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +266 -0
  29. package/docs/research/REMAINING-GAPS-PLAN.md +363 -0
  30. package/docs/research/SESSION-SUMMARY-2026-05-08.md +146 -0
  31. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +173 -0
  32. package/docs/research-awesome-agent-skills-distillation.md +100 -100
  33. package/docs/research-extension-examples.md +297 -297
  34. package/docs/research-extension-system.md +324 -324
  35. package/docs/research-oh-my-pi-distillation.md +56 -9
  36. package/docs/research-optimization-plan.md +548 -548
  37. package/docs/research-phase10-distillation.md +198 -198
  38. package/docs/research-phase11-distillation.md +201 -201
  39. package/docs/research-pi-coding-agent.md +357 -357
  40. package/docs/research-source-pi-crew-reference.md +174 -174
  41. package/docs/runtime-flow.md +148 -148
  42. package/docs/source-runtime-refactor-map.md +107 -107
  43. package/index.ts +6 -6
  44. package/package.json +99 -98
  45. package/schema.json +8 -0
  46. package/skills/async-worker-recovery/SKILL.md +42 -42
  47. package/skills/context-artifact-hygiene/SKILL.md +52 -52
  48. package/skills/delegation-patterns/SKILL.md +54 -54
  49. package/skills/mailbox-interactive/SKILL.md +40 -40
  50. package/skills/model-routing-context/SKILL.md +39 -39
  51. package/skills/multi-perspective-review/SKILL.md +58 -58
  52. package/skills/observability-reliability/SKILL.md +41 -41
  53. package/skills/orchestration/SKILL.md +157 -0
  54. package/skills/ownership-session-security/SKILL.md +41 -41
  55. package/skills/pi-extension-lifecycle/SKILL.md +39 -39
  56. package/skills/requirements-to-task-packet/SKILL.md +63 -63
  57. package/skills/resource-discovery-config/SKILL.md +41 -41
  58. package/skills/runtime-state-reader/SKILL.md +44 -44
  59. package/skills/secure-agent-orchestration-review/SKILL.md +45 -45
  60. package/skills/state-mutation-locking/SKILL.md +42 -42
  61. package/skills/systematic-debugging/SKILL.md +67 -67
  62. package/skills/ui-render-performance/SKILL.md +39 -39
  63. package/skills/verification-before-done/SKILL.md +57 -57
  64. package/skills/worktree-isolation/SKILL.md +39 -39
  65. package/src/agents/agent-config.ts +6 -0
  66. package/src/agents/agent-search.ts +98 -0
  67. package/src/agents/agent-serializer.ts +4 -0
  68. package/src/agents/discover-agents.ts +17 -4
  69. package/src/config/config.ts +24 -0
  70. package/src/config/defaults.ts +11 -0
  71. package/src/extension/autonomous-policy.ts +26 -33
  72. package/src/extension/cross-extension-rpc.ts +82 -82
  73. package/src/extension/help.ts +1 -0
  74. package/src/extension/management.ts +5 -0
  75. package/src/extension/register.ts +58 -13
  76. package/src/extension/registration/commands.ts +33 -1
  77. package/src/extension/registration/compaction-guard.ts +125 -125
  78. package/src/extension/registration/team-tool.ts +6 -4
  79. package/src/extension/run-bundle-schema.ts +89 -89
  80. package/src/extension/run-index.ts +24 -18
  81. package/src/extension/run-maintenance.ts +68 -62
  82. package/src/extension/team-tool/api.ts +23 -2
  83. package/src/extension/team-tool/cancel.ts +86 -11
  84. package/src/extension/team-tool/context.ts +3 -0
  85. package/src/extension/team-tool/handle-settings.ts +188 -188
  86. package/src/extension/team-tool/inspect.ts +41 -41
  87. package/src/extension/team-tool/intent-policy.ts +42 -0
  88. package/src/extension/team-tool/lifecycle-actions.ts +47 -18
  89. package/src/extension/team-tool/parallel-dispatch.ts +156 -0
  90. package/src/extension/team-tool/plan.ts +19 -19
  91. package/src/extension/team-tool/respond.ts +10 -2
  92. package/src/extension/team-tool/run.ts +3 -2
  93. package/src/extension/team-tool/status.ts +1 -1
  94. package/src/extension/team-tool-types.ts +1 -0
  95. package/src/extension/team-tool.ts +13 -3
  96. package/src/hooks/registry.ts +61 -0
  97. package/src/hooks/types.ts +41 -0
  98. package/src/i18n.ts +184 -184
  99. package/src/observability/exporters/otlp-exporter.ts +77 -77
  100. package/src/prompt/prompt-runtime.ts +72 -72
  101. package/src/runtime/agent-control.ts +108 -2
  102. package/src/runtime/agent-memory.ts +72 -72
  103. package/src/runtime/agent-observability.ts +114 -114
  104. package/src/runtime/async-marker.ts +26 -26
  105. package/src/runtime/async-runner.ts +3 -1
  106. package/src/runtime/attention-events.ts +28 -28
  107. package/src/runtime/background-runner.ts +19 -0
  108. package/src/runtime/cancellation-token.ts +89 -0
  109. package/src/runtime/cancellation.ts +61 -51
  110. package/src/runtime/capability-inventory.ts +116 -0
  111. package/src/runtime/child-pi.ts +2 -1
  112. package/src/runtime/code-summary.ts +247 -0
  113. package/src/runtime/completion-guard.ts +190 -190
  114. package/src/runtime/crash-recovery.ts +181 -0
  115. package/src/runtime/crew-agent-records.ts +35 -7
  116. package/src/runtime/crew-agent-runtime.ts +1 -0
  117. package/src/runtime/custom-tools/irc-tool.ts +201 -0
  118. package/src/runtime/custom-tools/submit-result-tool.ts +90 -0
  119. package/src/runtime/delivery-coordinator.ts +3 -1
  120. package/src/runtime/direct-run.ts +35 -35
  121. package/src/runtime/effectiveness.ts +81 -76
  122. package/src/runtime/event-stream-bridge.ts +90 -0
  123. package/src/runtime/foreground-control.ts +82 -82
  124. package/src/runtime/green-contract.ts +46 -46
  125. package/src/runtime/group-join.ts +106 -106
  126. package/src/runtime/heartbeat-gradient.ts +28 -28
  127. package/src/runtime/heartbeat-watcher.ts +124 -124
  128. package/src/runtime/live-agent-control.ts +88 -88
  129. package/src/runtime/live-agent-manager.ts +78 -2
  130. package/src/runtime/live-control-realtime.ts +36 -36
  131. package/src/runtime/live-extension-bridge.ts +150 -0
  132. package/src/runtime/live-irc.ts +92 -0
  133. package/src/runtime/live-session-health.ts +100 -0
  134. package/src/runtime/live-session-runtime.ts +297 -7
  135. package/src/runtime/mcp-proxy.ts +113 -0
  136. package/src/runtime/notebook-helpers.ts +90 -0
  137. package/src/runtime/orphan-sentinel.ts +7 -0
  138. package/src/runtime/output-validator.ts +187 -0
  139. package/src/runtime/parallel-research.ts +44 -44
  140. package/src/runtime/parallel-utils.ts +57 -0
  141. package/src/runtime/parent-guard.ts +80 -0
  142. package/src/runtime/pi-json-output.ts +111 -111
  143. package/src/runtime/policy-engine.ts +79 -79
  144. package/src/runtime/progress-event-coalescer.ts +43 -43
  145. package/src/runtime/prose-compressor.ts +164 -0
  146. package/src/runtime/recovery-recipes.ts +74 -74
  147. package/src/runtime/result-extractor.ts +121 -0
  148. package/src/runtime/role-permission.ts +39 -39
  149. package/src/runtime/runtime-resolver.ts +1 -4
  150. package/src/runtime/semaphore.ts +131 -0
  151. package/src/runtime/sensitive-paths.ts +92 -0
  152. package/src/runtime/session-resources.ts +25 -25
  153. package/src/runtime/session-snapshot.ts +59 -59
  154. package/src/runtime/session-usage.ts +79 -79
  155. package/src/runtime/sidechain-output.ts +29 -29
  156. package/src/runtime/stream-preview.ts +177 -0
  157. package/src/runtime/subagent-manager.ts +3 -2
  158. package/src/runtime/subprocess-tool-registry.ts +67 -0
  159. package/src/runtime/supervisor-contact.ts +59 -59
  160. package/src/runtime/task-display.ts +38 -38
  161. package/src/runtime/task-output-context.ts +59 -9
  162. package/src/runtime/task-runner/capabilities.ts +78 -78
  163. package/src/runtime/task-runner/live-executor.ts +2 -0
  164. package/src/runtime/task-runner/progress.ts +119 -119
  165. package/src/runtime/task-runner/prompt-builder.ts +70 -8
  166. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  167. package/src/runtime/task-runner/result-utils.ts +14 -14
  168. package/src/runtime/task-runner/run-projection.ts +104 -0
  169. package/src/runtime/task-runner/state-helpers.ts +22 -22
  170. package/src/runtime/task-runner.ts +75 -4
  171. package/src/runtime/team-runner.ts +60 -8
  172. package/src/runtime/worker-heartbeat.ts +21 -21
  173. package/src/runtime/worker-startup.ts +57 -57
  174. package/src/runtime/workspace-tree.ts +298 -0
  175. package/src/runtime/yield-handler.ts +189 -0
  176. package/src/schema/config-schema.ts +6 -0
  177. package/src/schema/team-tool-schema.ts +11 -1
  178. package/src/skills/discover-skills.ts +67 -0
  179. package/src/state/active-run-registry.ts +4 -2
  180. package/src/state/artifact-store.ts +4 -1
  181. package/src/state/atomic-write.ts +50 -1
  182. package/src/state/blob-store.ts +117 -0
  183. package/src/state/contracts.ts +1 -0
  184. package/src/state/event-log-rotation.ts +158 -0
  185. package/src/state/event-log.ts +52 -2
  186. package/src/state/mailbox.ts +87 -7
  187. package/src/state/state-store.ts +24 -4
  188. package/src/state/task-claims.ts +44 -44
  189. package/src/state/types.ts +20 -0
  190. package/src/state/usage.ts +29 -29
  191. package/src/subagents/async-entry.ts +1 -1
  192. package/src/subagents/index.ts +3 -3
  193. package/src/subagents/live/control.ts +1 -1
  194. package/src/subagents/live/manager.ts +1 -1
  195. package/src/subagents/live/realtime.ts +1 -1
  196. package/src/subagents/live/session-runtime.ts +1 -1
  197. package/src/subagents/manager.ts +1 -1
  198. package/src/subagents/spawn.ts +1 -1
  199. package/src/teams/team-serializer.ts +38 -38
  200. package/src/types/diff.d.ts +18 -18
  201. package/src/ui/agent-management-overlay.ts +144 -0
  202. package/src/ui/crew-footer.ts +101 -101
  203. package/src/ui/crew-select-list.ts +111 -111
  204. package/src/ui/crew-widget.ts +11 -2
  205. package/src/ui/dashboard-panes/cancellation-pane.ts +43 -0
  206. package/src/ui/dashboard-panes/capability-pane.ts +60 -0
  207. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -11
  208. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  209. package/src/ui/dynamic-border.ts +25 -25
  210. package/src/ui/layout-primitives.ts +106 -106
  211. package/src/ui/live-run-sidebar.ts +4 -0
  212. package/src/ui/loaders.ts +158 -158
  213. package/src/ui/powerbar-publisher.ts +77 -15
  214. package/src/ui/render-coalescer.ts +51 -0
  215. package/src/ui/render-diff.ts +119 -119
  216. package/src/ui/render-scheduler.ts +143 -143
  217. package/src/ui/run-dashboard.ts +4 -0
  218. package/src/ui/run-event-bus.ts +209 -0
  219. package/src/ui/run-snapshot-cache.ts +68 -16
  220. package/src/ui/snapshot-types.ts +8 -0
  221. package/src/ui/spinner.ts +17 -17
  222. package/src/ui/status-colors.ts +58 -58
  223. package/src/ui/syntax-highlight.ts +116 -116
  224. package/src/ui/transcript-entries.ts +258 -0
  225. package/src/utils/atomic-write.ts +33 -33
  226. package/src/utils/completion-dedupe.ts +63 -63
  227. package/src/utils/frontmatter.ts +68 -68
  228. package/src/utils/git.ts +262 -262
  229. package/src/utils/ids.ts +17 -12
  230. package/src/utils/incremental-reader.ts +104 -0
  231. package/src/utils/names.ts +27 -27
  232. package/src/utils/redaction.ts +44 -44
  233. package/src/utils/safe-paths.ts +47 -47
  234. package/src/utils/scan-cache.ts +137 -0
  235. package/src/utils/sleep.ts +32 -32
  236. package/src/utils/sse-parser.ts +134 -0
  237. package/src/utils/task-name-generator.ts +337 -0
  238. package/src/utils/visual.ts +33 -2
  239. package/src/workflows/validate-workflow.ts +40 -40
  240. package/src/worktree/branch-freshness.ts +45 -45
  241. package/src/worktree/cleanup.ts +2 -1
  242. package/teams/default.team.md +12 -12
  243. package/teams/fast-fix.team.md +11 -11
  244. package/teams/implementation.team.md +18 -18
  245. package/teams/parallel-research.team.md +14 -14
  246. package/teams/research.team.md +11 -11
  247. package/teams/review.team.md +12 -12
  248. package/workflows/default.workflow.md +29 -29
  249. package/workflows/fast-fix.workflow.md +22 -22
  250. package/workflows/implementation.workflow.md +38 -38
  251. package/workflows/parallel-research.workflow.md +46 -46
  252. package/workflows/research.workflow.md +22 -22
  253. package/workflows/review.workflow.md +30 -30
@@ -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
+ }
package/src/utils/git.ts CHANGED
@@ -1,262 +1,262 @@
1
- import { createRequire } from "node:module";
2
-
3
- type HostedGitInfoResult = {
4
- repo?: unknown;
5
- domain?: string;
6
- project?: string;
7
- user?: string;
8
- committish?: string;
9
- };
10
-
11
- type HostedGitInfoModule = {
12
- fromUrl: (url: string) => HostedGitInfoResult | null;
13
- };
14
-
15
- /**
16
- * Parsed git source information.
17
- */
18
- export type GitSource = {
19
- /**
20
- * Always "git" for git sources.
21
- */
22
- type: "git";
23
- /**
24
- * Clone URL.
25
- */
26
- repo: string;
27
- /**
28
- * Git host domain (for example, "github.com").
29
- */
30
- host: string;
31
- /**
32
- * Repository path (for example, "org/repo").
33
- */
34
- path: string;
35
- /**
36
- * Git ref (branch, tag, or commit) if specified.
37
- */
38
- ref?: string;
39
- /**
40
- * Whether the source includes a pinned ref.
41
- */
42
- pinned: boolean;
43
- };
44
-
45
- function getHostedGitInfo(): HostedGitInfoModule | null {
46
- const require = createRequire(import.meta.url);
47
- try {
48
- return require("hosted-git-info") as HostedGitInfoModule;
49
- } catch {
50
- return null;
51
- }
52
- }
53
-
54
- const hostedGitInfo = getHostedGitInfo();
55
-
56
- function splitRef(url: string): { repo: string; ref?: string } {
57
- const scpLikeMatch = url.match(/^git@([^:]+):(.+)$/);
58
- if (scpLikeMatch) {
59
- const pathWithMaybeRef = scpLikeMatch[2] ?? "";
60
- const atRefIndex = pathWithMaybeRef.indexOf("@");
61
- const hashRefIndex = pathWithMaybeRef.indexOf("#");
62
- let refSeparator = -1;
63
- if (atRefIndex >= 0 && hashRefIndex >= 0) {
64
- refSeparator = Math.min(atRefIndex, hashRefIndex);
65
- } else {
66
- refSeparator = atRefIndex >= 0 ? atRefIndex : hashRefIndex;
67
- }
68
- if (refSeparator < 0) {
69
- return { repo: url };
70
- }
71
-
72
- const repoPath = pathWithMaybeRef.slice(0, refSeparator);
73
- const ref = pathWithMaybeRef.slice(refSeparator + 1);
74
- if (!repoPath || !ref) {
75
- return { repo: url };
76
- }
77
-
78
- return {
79
- repo: `git@${scpLikeMatch[1] ?? ""}:${repoPath}`,
80
- ref,
81
- };
82
- }
83
-
84
- if (url.includes("://")) {
85
- try {
86
- const parsed = new URL(url);
87
- const fragmentRef = parsed.hash.startsWith("#") ? parsed.hash.slice(1) : "";
88
- parsed.hash = "";
89
- const pathWithMaybeRef = parsed.pathname.replace(/^\/+/, "");
90
- const atRefIndex = pathWithMaybeRef.indexOf("@");
91
- if (atRefIndex >= 0) {
92
- const repoPath = pathWithMaybeRef.slice(0, atRefIndex);
93
- const ref = pathWithMaybeRef.slice(atRefIndex + 1);
94
- if (!repoPath || !ref) {
95
- return { repo: parsed.toString().replace(/\/$/, "") };
96
- }
97
- parsed.pathname = `/${repoPath}`;
98
- return {
99
- repo: parsed.toString().replace(/\/$/, ""),
100
- ref,
101
- };
102
- }
103
-
104
- if (fragmentRef) {
105
- return {
106
- repo: parsed.toString().replace(/\/$/, ""),
107
- ref: fragmentRef,
108
- };
109
- }
110
-
111
- return { repo: parsed.toString().replace(/\/$/, "") };
112
- } catch {
113
- return { repo: url };
114
- }
115
- }
116
-
117
- const slashIndex = url.indexOf("/");
118
- if (slashIndex < 0) {
119
- return { repo: url };
120
- }
121
-
122
- const pathWithMaybeRef = url.slice(slashIndex + 1);
123
- const atRefIndex = pathWithMaybeRef.indexOf("@");
124
- const hashRefIndex = pathWithMaybeRef.indexOf("#");
125
- let refSeparator = -1;
126
- if (atRefIndex >= 0 && hashRefIndex >= 0) {
127
- refSeparator = Math.min(atRefIndex, hashRefIndex);
128
- } else {
129
- refSeparator = atRefIndex >= 0 ? atRefIndex : hashRefIndex;
130
- }
131
- if (refSeparator < 0) {
132
- return { repo: url };
133
- }
134
-
135
- const repoPath = pathWithMaybeRef.slice(0, refSeparator);
136
- const ref = pathWithMaybeRef.slice(refSeparator + 1);
137
- if (!repoPath || !ref) {
138
- return { repo: url };
139
- }
140
-
141
- return {
142
- repo: `${url.slice(0, slashIndex)}/${repoPath}`,
143
- ref,
144
- };
145
- }
146
-
147
- function parseGenericGitUrl(url: string): GitSource | null {
148
- const { repo: repoWithoutRef, ref } = splitRef(url);
149
- let repo = repoWithoutRef;
150
- let host = "";
151
- let path = "";
152
-
153
- const scpLikeMatch = repoWithoutRef.match(/^git@([^:]+):(.+)$/);
154
- if (scpLikeMatch) {
155
- host = scpLikeMatch[1] ?? "";
156
- path = scpLikeMatch[2] ?? "";
157
- } else if (
158
- repoWithoutRef.startsWith("https://") ||
159
- repoWithoutRef.startsWith("http://") ||
160
- repoWithoutRef.startsWith("ssh://") ||
161
- repoWithoutRef.startsWith("git://")
162
- ) {
163
- try {
164
- const parsed = new URL(repoWithoutRef);
165
- host = parsed.hostname;
166
- path = parsed.pathname.replace(/^\/+/, "");
167
- } catch {
168
- return null;
169
- }
170
- } else {
171
- const slashIndex = repoWithoutRef.indexOf("/");
172
- if (slashIndex < 0) {
173
- return null;
174
- }
175
-
176
- host = repoWithoutRef.slice(0, slashIndex);
177
- path = repoWithoutRef.slice(slashIndex + 1);
178
- if (!host.includes(".") && host !== "localhost") {
179
- return null;
180
- }
181
-
182
- repo = `https://${repoWithoutRef}`;
183
- }
184
-
185
- const normalizedPath = path.replace(/\.git$/, "").replace(/^\/+/, "");
186
- if (!host || !normalizedPath || normalizedPath.split("/").length < 2) {
187
- return null;
188
- }
189
-
190
- return {
191
- type: "git",
192
- repo,
193
- host,
194
- path: normalizedPath,
195
- ref,
196
- pinned: Boolean(ref),
197
- };
198
- }
199
-
200
- /**
201
- * Parse git source into normalized source information.
202
- */
203
- export function parseGitUrl(source: string): GitSource | null {
204
- const trimmed = source.trim();
205
- const hasGitPrefix = trimmed.startsWith("git:");
206
- const normalizedSource = hasGitPrefix ? trimmed.slice(4).trim() : trimmed.replace(/^git\+/i, "");
207
- const url = normalizedSource;
208
-
209
- if (
210
- !hasGitPrefix &&
211
- !/^(https?|ssh|git):\/\//i.test(url) &&
212
- !/^git@[^:]+:/.test(url)
213
- ) {
214
- return null;
215
- }
216
-
217
- const split = splitRef(url);
218
-
219
- const parseCandidate = (candidate: string): GitSource | null => {
220
- if (!hostedGitInfo) {
221
- return null;
222
- }
223
- const info = hostedGitInfo.fromUrl(candidate) as HostedGitInfoResult | null;
224
- if (!info) return null;
225
- if (split.ref && info.project?.includes("@")) {
226
- return null;
227
- }
228
- return {
229
- type: "git",
230
- repo: split.repo.startsWith("http://") || split.repo.startsWith("https://") || split.repo.startsWith("ssh://") || split.repo.startsWith("git://") || split.repo.startsWith("git@")
231
- ? split.repo
232
- : `https://${split.repo}`,
233
- host: info.domain ?? "",
234
- path: `${info.user ?? ""}/${info.project ?? ""}`.replace(/\.git$/, ""),
235
- ref: info.committish || split.ref || undefined,
236
- pinned: Boolean(info.committish || split.ref),
237
- };
238
- };
239
-
240
- const hostedCandidates = [split.ref ? `${split.repo}#${split.ref}` : undefined, url].filter((value): value is string =>
241
- Boolean(value),
242
- );
243
- for (const candidate of hostedCandidates) {
244
- const info = parseCandidate(candidate);
245
- if (info) {
246
- return info;
247
- }
248
- }
249
-
250
- const httpsCandidates = [
251
- split.ref ? `https://${split.repo}#${split.ref}` : undefined,
252
- `https://${url}`,
253
- ].filter((value): value is string => Boolean(value));
254
- for (const candidate of httpsCandidates) {
255
- const info = parseCandidate(candidate);
256
- if (info) {
257
- return info;
258
- }
259
- }
260
-
261
- return parseGenericGitUrl(url);
262
- }
1
+ import { createRequire } from "node:module";
2
+
3
+ type HostedGitInfoResult = {
4
+ repo?: unknown;
5
+ domain?: string;
6
+ project?: string;
7
+ user?: string;
8
+ committish?: string;
9
+ };
10
+
11
+ type HostedGitInfoModule = {
12
+ fromUrl: (url: string) => HostedGitInfoResult | null;
13
+ };
14
+
15
+ /**
16
+ * Parsed git source information.
17
+ */
18
+ export type GitSource = {
19
+ /**
20
+ * Always "git" for git sources.
21
+ */
22
+ type: "git";
23
+ /**
24
+ * Clone URL.
25
+ */
26
+ repo: string;
27
+ /**
28
+ * Git host domain (for example, "github.com").
29
+ */
30
+ host: string;
31
+ /**
32
+ * Repository path (for example, "org/repo").
33
+ */
34
+ path: string;
35
+ /**
36
+ * Git ref (branch, tag, or commit) if specified.
37
+ */
38
+ ref?: string;
39
+ /**
40
+ * Whether the source includes a pinned ref.
41
+ */
42
+ pinned: boolean;
43
+ };
44
+
45
+ function getHostedGitInfo(): HostedGitInfoModule | null {
46
+ const require = createRequire(import.meta.url);
47
+ try {
48
+ return require("hosted-git-info") as HostedGitInfoModule;
49
+ } catch {
50
+ return null;
51
+ }
52
+ }
53
+
54
+ const hostedGitInfo = getHostedGitInfo();
55
+
56
+ function splitRef(url: string): { repo: string; ref?: string } {
57
+ const scpLikeMatch = url.match(/^git@([^:]+):(.+)$/);
58
+ if (scpLikeMatch) {
59
+ const pathWithMaybeRef = scpLikeMatch[2] ?? "";
60
+ const atRefIndex = pathWithMaybeRef.indexOf("@");
61
+ const hashRefIndex = pathWithMaybeRef.indexOf("#");
62
+ let refSeparator = -1;
63
+ if (atRefIndex >= 0 && hashRefIndex >= 0) {
64
+ refSeparator = Math.min(atRefIndex, hashRefIndex);
65
+ } else {
66
+ refSeparator = atRefIndex >= 0 ? atRefIndex : hashRefIndex;
67
+ }
68
+ if (refSeparator < 0) {
69
+ return { repo: url };
70
+ }
71
+
72
+ const repoPath = pathWithMaybeRef.slice(0, refSeparator);
73
+ const ref = pathWithMaybeRef.slice(refSeparator + 1);
74
+ if (!repoPath || !ref) {
75
+ return { repo: url };
76
+ }
77
+
78
+ return {
79
+ repo: `git@${scpLikeMatch[1] ?? ""}:${repoPath}`,
80
+ ref,
81
+ };
82
+ }
83
+
84
+ if (url.includes("://")) {
85
+ try {
86
+ const parsed = new URL(url);
87
+ const fragmentRef = parsed.hash.startsWith("#") ? parsed.hash.slice(1) : "";
88
+ parsed.hash = "";
89
+ const pathWithMaybeRef = parsed.pathname.replace(/^\/+/, "");
90
+ const atRefIndex = pathWithMaybeRef.indexOf("@");
91
+ if (atRefIndex >= 0) {
92
+ const repoPath = pathWithMaybeRef.slice(0, atRefIndex);
93
+ const ref = pathWithMaybeRef.slice(atRefIndex + 1);
94
+ if (!repoPath || !ref) {
95
+ return { repo: parsed.toString().replace(/\/$/, "") };
96
+ }
97
+ parsed.pathname = `/${repoPath}`;
98
+ return {
99
+ repo: parsed.toString().replace(/\/$/, ""),
100
+ ref,
101
+ };
102
+ }
103
+
104
+ if (fragmentRef) {
105
+ return {
106
+ repo: parsed.toString().replace(/\/$/, ""),
107
+ ref: fragmentRef,
108
+ };
109
+ }
110
+
111
+ return { repo: parsed.toString().replace(/\/$/, "") };
112
+ } catch {
113
+ return { repo: url };
114
+ }
115
+ }
116
+
117
+ const slashIndex = url.indexOf("/");
118
+ if (slashIndex < 0) {
119
+ return { repo: url };
120
+ }
121
+
122
+ const pathWithMaybeRef = url.slice(slashIndex + 1);
123
+ const atRefIndex = pathWithMaybeRef.indexOf("@");
124
+ const hashRefIndex = pathWithMaybeRef.indexOf("#");
125
+ let refSeparator = -1;
126
+ if (atRefIndex >= 0 && hashRefIndex >= 0) {
127
+ refSeparator = Math.min(atRefIndex, hashRefIndex);
128
+ } else {
129
+ refSeparator = atRefIndex >= 0 ? atRefIndex : hashRefIndex;
130
+ }
131
+ if (refSeparator < 0) {
132
+ return { repo: url };
133
+ }
134
+
135
+ const repoPath = pathWithMaybeRef.slice(0, refSeparator);
136
+ const ref = pathWithMaybeRef.slice(refSeparator + 1);
137
+ if (!repoPath || !ref) {
138
+ return { repo: url };
139
+ }
140
+
141
+ return {
142
+ repo: `${url.slice(0, slashIndex)}/${repoPath}`,
143
+ ref,
144
+ };
145
+ }
146
+
147
+ function parseGenericGitUrl(url: string): GitSource | null {
148
+ const { repo: repoWithoutRef, ref } = splitRef(url);
149
+ let repo = repoWithoutRef;
150
+ let host = "";
151
+ let path = "";
152
+
153
+ const scpLikeMatch = repoWithoutRef.match(/^git@([^:]+):(.+)$/);
154
+ if (scpLikeMatch) {
155
+ host = scpLikeMatch[1] ?? "";
156
+ path = scpLikeMatch[2] ?? "";
157
+ } else if (
158
+ repoWithoutRef.startsWith("https://") ||
159
+ repoWithoutRef.startsWith("http://") ||
160
+ repoWithoutRef.startsWith("ssh://") ||
161
+ repoWithoutRef.startsWith("git://")
162
+ ) {
163
+ try {
164
+ const parsed = new URL(repoWithoutRef);
165
+ host = parsed.hostname;
166
+ path = parsed.pathname.replace(/^\/+/, "");
167
+ } catch {
168
+ return null;
169
+ }
170
+ } else {
171
+ const slashIndex = repoWithoutRef.indexOf("/");
172
+ if (slashIndex < 0) {
173
+ return null;
174
+ }
175
+
176
+ host = repoWithoutRef.slice(0, slashIndex);
177
+ path = repoWithoutRef.slice(slashIndex + 1);
178
+ if (!host.includes(".") && host !== "localhost") {
179
+ return null;
180
+ }
181
+
182
+ repo = `https://${repoWithoutRef}`;
183
+ }
184
+
185
+ const normalizedPath = path.replace(/\.git$/, "").replace(/^\/+/, "");
186
+ if (!host || !normalizedPath || normalizedPath.split("/").length < 2) {
187
+ return null;
188
+ }
189
+
190
+ return {
191
+ type: "git",
192
+ repo,
193
+ host,
194
+ path: normalizedPath,
195
+ ref,
196
+ pinned: Boolean(ref),
197
+ };
198
+ }
199
+
200
+ /**
201
+ * Parse git source into normalized source information.
202
+ */
203
+ export function parseGitUrl(source: string): GitSource | null {
204
+ const trimmed = source.trim();
205
+ const hasGitPrefix = trimmed.startsWith("git:");
206
+ const normalizedSource = hasGitPrefix ? trimmed.slice(4).trim() : trimmed.replace(/^git\+/i, "");
207
+ const url = normalizedSource;
208
+
209
+ if (
210
+ !hasGitPrefix &&
211
+ !/^(https?|ssh|git):\/\//i.test(url) &&
212
+ !/^git@[^:]+:/.test(url)
213
+ ) {
214
+ return null;
215
+ }
216
+
217
+ const split = splitRef(url);
218
+
219
+ const parseCandidate = (candidate: string): GitSource | null => {
220
+ if (!hostedGitInfo) {
221
+ return null;
222
+ }
223
+ const info = hostedGitInfo.fromUrl(candidate) as HostedGitInfoResult | null;
224
+ if (!info) return null;
225
+ if (split.ref && info.project?.includes("@")) {
226
+ return null;
227
+ }
228
+ return {
229
+ type: "git",
230
+ repo: split.repo.startsWith("http://") || split.repo.startsWith("https://") || split.repo.startsWith("ssh://") || split.repo.startsWith("git://") || split.repo.startsWith("git@")
231
+ ? split.repo
232
+ : `https://${split.repo}`,
233
+ host: info.domain ?? "",
234
+ path: `${info.user ?? ""}/${info.project ?? ""}`.replace(/\.git$/, ""),
235
+ ref: info.committish || split.ref || undefined,
236
+ pinned: Boolean(info.committish || split.ref),
237
+ };
238
+ };
239
+
240
+ const hostedCandidates = [split.ref ? `${split.repo}#${split.ref}` : undefined, url].filter((value): value is string =>
241
+ Boolean(value),
242
+ );
243
+ for (const candidate of hostedCandidates) {
244
+ const info = parseCandidate(candidate);
245
+ if (info) {
246
+ return info;
247
+ }
248
+ }
249
+
250
+ const httpsCandidates = [
251
+ split.ref ? `https://${split.repo}#${split.ref}` : undefined,
252
+ `https://${url}`,
253
+ ].filter((value): value is string => Boolean(value));
254
+ for (const candidate of httpsCandidates) {
255
+ const info = parseCandidate(candidate);
256
+ if (info) {
257
+ return info;
258
+ }
259
+ }
260
+
261
+ return parseGenericGitUrl(url);
262
+ }