@polyweave/preston 0.0.0-stage → 1.1.0

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 (271) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +119 -2
  3. package/assets/logo.png +0 -0
  4. package/assets/logo.webp +0 -0
  5. package/dist/agents/migration.js +29 -0
  6. package/dist/agents/migration.js.map +1 -0
  7. package/dist/agents/updater.js +385 -0
  8. package/dist/agents/updater.js.map +1 -0
  9. package/dist/channels/chat.js +236 -0
  10. package/dist/channels/chat.js.map +1 -0
  11. package/dist/channels/discord/index.js +491 -0
  12. package/dist/channels/discord/index.js.map +1 -0
  13. package/dist/channels/discord/transport.js +130 -0
  14. package/dist/channels/discord/transport.js.map +1 -0
  15. package/dist/channels/fake/index.js +104 -0
  16. package/dist/channels/fake/index.js.map +1 -0
  17. package/dist/channels/hub.js +153 -0
  18. package/dist/channels/hub.js.map +1 -0
  19. package/dist/channels/outbox.js +219 -0
  20. package/dist/channels/outbox.js.map +1 -0
  21. package/dist/channels/registry.js +67 -0
  22. package/dist/channels/registry.js.map +1 -0
  23. package/dist/channels/router.js +50 -0
  24. package/dist/channels/router.js.map +1 -0
  25. package/dist/channels/shared/delivery.js +74 -0
  26. package/dist/channels/shared/delivery.js.map +1 -0
  27. package/dist/channels/shared/files.js +87 -0
  28. package/dist/channels/shared/files.js.map +1 -0
  29. package/dist/channels/shared/pairing.js +99 -0
  30. package/dist/channels/shared/pairing.js.map +1 -0
  31. package/dist/channels/shared/secrets.js +75 -0
  32. package/dist/channels/shared/secrets.js.map +1 -0
  33. package/dist/channels/shared/text.js +68 -0
  34. package/dist/channels/shared/text.js.map +1 -0
  35. package/dist/channels/shared/typing.js +59 -0
  36. package/dist/channels/shared/typing.js.map +1 -0
  37. package/dist/channels/slack/index.js +560 -0
  38. package/dist/channels/slack/index.js.map +1 -0
  39. package/dist/channels/slack/transport.js +184 -0
  40. package/dist/channels/slack/transport.js.map +1 -0
  41. package/dist/channels/terminal.js +67 -0
  42. package/dist/channels/terminal.js.map +1 -0
  43. package/dist/channels/types.js +6 -0
  44. package/dist/channels/types.js.map +1 -0
  45. package/dist/cli-args.js +92 -0
  46. package/dist/cli-args.js.map +1 -0
  47. package/dist/cli.js +120 -0
  48. package/dist/cli.js.map +1 -0
  49. package/dist/clock.js +76 -0
  50. package/dist/clock.js.map +1 -0
  51. package/dist/config/config.js +184 -0
  52. package/dist/config/config.js.map +1 -0
  53. package/dist/config/schema.js +209 -0
  54. package/dist/config/schema.js.map +1 -0
  55. package/dist/coordinator/coordinator.js +494 -0
  56. package/dist/coordinator/coordinator.js.map +1 -0
  57. package/dist/coordinator/inbox.js +64 -0
  58. package/dist/coordinator/inbox.js.map +1 -0
  59. package/dist/coordinator/input.js +75 -0
  60. package/dist/coordinator/input.js.map +1 -0
  61. package/dist/daemon/daemon.js +228 -0
  62. package/dist/daemon/daemon.js.map +1 -0
  63. package/dist/daemon/ensure.js +87 -0
  64. package/dist/daemon/ensure.js.map +1 -0
  65. package/dist/daemon/lock.js +54 -0
  66. package/dist/daemon/lock.js.map +1 -0
  67. package/dist/daemon/start-at-login.js +20 -0
  68. package/dist/daemon/start-at-login.js.map +1 -0
  69. package/dist/daemon/stop.js +51 -0
  70. package/dist/daemon/stop.js.map +1 -0
  71. package/dist/goals/agents.js +36 -0
  72. package/dist/goals/agents.js.map +1 -0
  73. package/dist/goals/brief.js +51 -0
  74. package/dist/goals/brief.js.map +1 -0
  75. package/dist/goals/checks.js +75 -0
  76. package/dist/goals/checks.js.map +1 -0
  77. package/dist/goals/engine.js +1253 -0
  78. package/dist/goals/engine.js.map +1 -0
  79. package/dist/goals/messages.js +110 -0
  80. package/dist/goals/messages.js.map +1 -0
  81. package/dist/goals/status.js +118 -0
  82. package/dist/goals/status.js.map +1 -0
  83. package/dist/goals/store.js +285 -0
  84. package/dist/goals/store.js.map +1 -0
  85. package/dist/home.js +52 -0
  86. package/dist/home.js.map +1 -0
  87. package/dist/i18n/index.js +37 -0
  88. package/dist/i18n/index.js.map +1 -0
  89. package/dist/ipc/client.js +82 -0
  90. package/dist/ipc/client.js.map +1 -0
  91. package/dist/ipc/private-dir.js +23 -0
  92. package/dist/ipc/private-dir.js.map +1 -0
  93. package/dist/ipc/protocol.js +50 -0
  94. package/dist/ipc/protocol.js.map +1 -0
  95. package/dist/ipc/server.js +110 -0
  96. package/dist/ipc/server.js.map +1 -0
  97. package/dist/landing/exec.js +38 -0
  98. package/dist/landing/exec.js.map +1 -0
  99. package/dist/landing/git.js +93 -0
  100. package/dist/landing/git.js.map +1 -0
  101. package/dist/landing/github.js +154 -0
  102. package/dist/landing/github.js.map +1 -0
  103. package/dist/landing/hooks.js +2 -0
  104. package/dist/landing/hooks.js.map +1 -0
  105. package/dist/landing/landing.js +777 -0
  106. package/dist/landing/landing.js.map +1 -0
  107. package/dist/landing/messages.js +157 -0
  108. package/dist/landing/messages.js.map +1 -0
  109. package/dist/landing/migration.js +50 -0
  110. package/dist/landing/migration.js.map +1 -0
  111. package/dist/landing/paths.js +54 -0
  112. package/dist/landing/paths.js.map +1 -0
  113. package/dist/landing/project.js +95 -0
  114. package/dist/landing/project.js.map +1 -0
  115. package/dist/landing/publishing.js +208 -0
  116. package/dist/landing/publishing.js.map +1 -0
  117. package/dist/landing/stage.js +129 -0
  118. package/dist/landing/stage.js.map +1 -0
  119. package/dist/landing/store.js +160 -0
  120. package/dist/landing/store.js.map +1 -0
  121. package/dist/landing/tools.js +38 -0
  122. package/dist/landing/tools.js.map +1 -0
  123. package/dist/landing/workspace.js +349 -0
  124. package/dist/landing/workspace.js.map +1 -0
  125. package/dist/log.js +77 -0
  126. package/dist/log.js.map +1 -0
  127. package/dist/mcp/coordinator-tools.js +500 -0
  128. package/dist/mcp/coordinator-tools.js.map +1 -0
  129. package/dist/mcp/names.js +8 -0
  130. package/dist/mcp/names.js.map +1 -0
  131. package/dist/mcp/owner-turn.js +15 -0
  132. package/dist/mcp/owner-turn.js.map +1 -0
  133. package/dist/mcp/setup-tools.js +243 -0
  134. package/dist/mcp/setup-tools.js.map +1 -0
  135. package/dist/mcp/stdio.js +74 -0
  136. package/dist/mcp/stdio.js.map +1 -0
  137. package/dist/mcp/tools.js +76 -0
  138. package/dist/mcp/tools.js.map +1 -0
  139. package/dist/mcp/worker-tools.js +53 -0
  140. package/dist/mcp/worker-tools.js.map +1 -0
  141. package/dist/memory/files.js +183 -0
  142. package/dist/memory/files.js.map +1 -0
  143. package/dist/memory/index.js +174 -0
  144. package/dist/memory/index.js.map +1 -0
  145. package/dist/memory/service.js +319 -0
  146. package/dist/memory/service.js.map +1 -0
  147. package/dist/memory/tools.js +82 -0
  148. package/dist/memory/tools.js.map +1 -0
  149. package/dist/notify/index.js +122 -0
  150. package/dist/notify/index.js.map +1 -0
  151. package/dist/prompts/coordinator.js +76 -0
  152. package/dist/prompts/coordinator.js.map +1 -0
  153. package/dist/prompts/grilling.js +8 -0
  154. package/dist/prompts/grilling.js.map +1 -0
  155. package/dist/prompts/teaching.js +17 -0
  156. package/dist/prompts/teaching.js.map +1 -0
  157. package/dist/prompts/worker.js +50 -0
  158. package/dist/prompts/worker.js.map +1 -0
  159. package/dist/questions/questions.js +209 -0
  160. package/dist/questions/questions.js.map +1 -0
  161. package/dist/quota/monitor.js +399 -0
  162. package/dist/quota/monitor.js.map +1 -0
  163. package/dist/quota/schedule.js +38 -0
  164. package/dist/quota/schedule.js.map +1 -0
  165. package/dist/quota/store.js +94 -0
  166. package/dist/quota/store.js.map +1 -0
  167. package/dist/quota/time.js +41 -0
  168. package/dist/quota/time.js.map +1 -0
  169. package/dist/review/digest.js +202 -0
  170. package/dist/review/digest.js.map +1 -0
  171. package/dist/review/reviewer.js +113 -0
  172. package/dist/review/reviewer.js.map +1 -0
  173. package/dist/runtime.js +456 -0
  174. package/dist/runtime.js.map +1 -0
  175. package/dist/schedule/cron.js +354 -0
  176. package/dist/schedule/cron.js.map +1 -0
  177. package/dist/schedule/service.js +425 -0
  178. package/dist/schedule/service.js.map +1 -0
  179. package/dist/schedule/store.js +210 -0
  180. package/dist/schedule/store.js.map +1 -0
  181. package/dist/schedule/tools.js +246 -0
  182. package/dist/schedule/tools.js.map +1 -0
  183. package/dist/selfupdate/npm.js +114 -0
  184. package/dist/selfupdate/npm.js.map +1 -0
  185. package/dist/selfupdate/start.js +113 -0
  186. package/dist/selfupdate/start.js.map +1 -0
  187. package/dist/selfupdate/state.js +22 -0
  188. package/dist/selfupdate/state.js.map +1 -0
  189. package/dist/selfupdate/updater.js +120 -0
  190. package/dist/selfupdate/updater.js.map +1 -0
  191. package/dist/service/host.js +46 -0
  192. package/dist/service/host.js.map +1 -0
  193. package/dist/service/index.js +142 -0
  194. package/dist/service/index.js.map +1 -0
  195. package/dist/service/launchd.js +88 -0
  196. package/dist/service/launchd.js.map +1 -0
  197. package/dist/service/spec.js +9 -0
  198. package/dist/service/spec.js.map +1 -0
  199. package/dist/service/systemd.js +90 -0
  200. package/dist/service/systemd.js.map +1 -0
  201. package/dist/service/windows.js +122 -0
  202. package/dist/service/windows.js.map +1 -0
  203. package/dist/setup/pairing.js +143 -0
  204. package/dist/setup/pairing.js.map +1 -0
  205. package/dist/setup/setup.js +76 -0
  206. package/dist/setup/setup.js.map +1 -0
  207. package/dist/standing/defaults.js +80 -0
  208. package/dist/standing/defaults.js.map +1 -0
  209. package/dist/standing/model.js +72 -0
  210. package/dist/standing/model.js.map +1 -0
  211. package/dist/standing/service.js +228 -0
  212. package/dist/standing/service.js.map +1 -0
  213. package/dist/standing/tools.js +184 -0
  214. package/dist/standing/tools.js.map +1 -0
  215. package/dist/store/db.js +67 -0
  216. package/dist/store/db.js.map +1 -0
  217. package/dist/store/migrations.js +280 -0
  218. package/dist/store/migrations.js.map +1 -0
  219. package/dist/supervisor/processes.js +128 -0
  220. package/dist/supervisor/processes.js.map +1 -0
  221. package/dist/supervisor/stalls.js +103 -0
  222. package/dist/supervisor/stalls.js.map +1 -0
  223. package/dist/terminal/activity.js +97 -0
  224. package/dist/terminal/activity.js.map +1 -0
  225. package/dist/terminal/conversation.js +231 -0
  226. package/dist/terminal/conversation.js.map +1 -0
  227. package/dist/util/async-queue.js +41 -0
  228. package/dist/util/async-queue.js.map +1 -0
  229. package/dist/util/command.js +29 -0
  230. package/dist/util/command.js.map +1 -0
  231. package/dist/util/ids.js +9 -0
  232. package/dist/util/ids.js.map +1 -0
  233. package/dist/util/process-tree.js +62 -0
  234. package/dist/util/process-tree.js.map +1 -0
  235. package/dist/util/secrets.js +31 -0
  236. package/dist/util/secrets.js.map +1 -0
  237. package/dist/version.js +5 -0
  238. package/dist/version.js.map +1 -0
  239. package/dist/workers/claude/classify.js +172 -0
  240. package/dist/workers/claude/classify.js.map +1 -0
  241. package/dist/workers/claude/index.js +440 -0
  242. package/dist/workers/claude/index.js.map +1 -0
  243. package/dist/workers/claude/process.js +135 -0
  244. package/dist/workers/claude/process.js.map +1 -0
  245. package/dist/workers/claude/quota.js +37 -0
  246. package/dist/workers/claude/quota.js.map +1 -0
  247. package/dist/workers/claude/stream.js +286 -0
  248. package/dist/workers/claude/stream.js.map +1 -0
  249. package/dist/workers/codex/index.js +181 -0
  250. package/dist/workers/codex/index.js.map +1 -0
  251. package/dist/workers/codex/mapping.js +166 -0
  252. package/dist/workers/codex/mapping.js.map +1 -0
  253. package/dist/workers/codex/process.js +124 -0
  254. package/dist/workers/codex/process.js.map +1 -0
  255. package/dist/workers/codex/protocol.js +7 -0
  256. package/dist/workers/codex/protocol.js.map +1 -0
  257. package/dist/workers/codex/rpc.js +145 -0
  258. package/dist/workers/codex/rpc.js.map +1 -0
  259. package/dist/workers/codex/run.js +556 -0
  260. package/dist/workers/codex/run.js.map +1 -0
  261. package/dist/workers/env.js +49 -0
  262. package/dist/workers/env.js.map +1 -0
  263. package/dist/workers/fake/index.js +283 -0
  264. package/dist/workers/fake/index.js.map +1 -0
  265. package/dist/workers/models.js +171 -0
  266. package/dist/workers/models.js.map +1 -0
  267. package/dist/workers/registry.js +63 -0
  268. package/dist/workers/registry.js.map +1 -0
  269. package/dist/workers/types.js +6 -0
  270. package/dist/workers/types.js.map +1 -0
  271. package/package.json +66 -4
@@ -0,0 +1,349 @@
1
+ import { existsSync, mkdirSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { isoNow } from "../clock.js";
4
+ import { gitProblem } from "./git.js";
5
+ import { canonicalPath, isInside, projectSlug, slugify } from "./paths.js";
6
+ import { inspectProject } from "./project.js";
7
+ import { stageWork } from "./stage.js";
8
+ /** Windows rejects paths past 260 characters; leave room for files inside the worktree. */
9
+ const MAX_WINDOWS_PATH = 200;
10
+ /**
11
+ * Gives each coding Goal its own Git worktree and branch, reuses it after a restart, and falls
12
+ * back to working in place only when the Brief allows. Never touches the user's own checkout.
13
+ */
14
+ export class Workspaces {
15
+ deps;
16
+ chains = new Map();
17
+ constructor(deps) {
18
+ this.deps = deps;
19
+ }
20
+ prepare(goal) {
21
+ const existing = this.deps.store.workspace(goal.id);
22
+ if (existing?.mode === "in_place")
23
+ return this.inPlace(goal, existing.workdir, existing.reason);
24
+ if (existing)
25
+ return this.reuse(goal, existing);
26
+ // Most folders are not repositories: decide that without starting a process, so a turn for
27
+ // them starts as promptly as it always did.
28
+ if (!mayBeRepository(goal.projectPath))
29
+ return this.inPlace(goal, goal.projectPath, null);
30
+ return this.prepareRepository(goal);
31
+ }
32
+ async prepareRepository(goal) {
33
+ const info = await inspectProject(this.deps.git, goal.projectPath, isoNow(this.deps.clock));
34
+ this.deps.saveProject(goal, info);
35
+ const repo = info.repo;
36
+ if (info.kind === "folder" || !repo) {
37
+ return this.inPlace(goal, goal.projectPath, null);
38
+ }
39
+ // One worktree is created at a time per repository: git locks its own metadata.
40
+ return this.serialised(repo.root, () => this.create(goal, info));
41
+ }
42
+ async create(goal, info) {
43
+ const { git, store } = this.deps;
44
+ const repo = info.repo;
45
+ if (!repo)
46
+ return this.inPlace(goal, goal.projectPath, null);
47
+ // A concurrent preparation may have finished while this one waited.
48
+ const raced = store.workspace(goal.id);
49
+ if (raced)
50
+ return this.reuse(goal, raced);
51
+ const problem = await this.check(goal, info);
52
+ if (problem)
53
+ return this.fallback(goal, problem);
54
+ const startFrom = goal.brief.workspace?.startFrom ?? "default";
55
+ const baseBranch = (startFrom === "current" ? repo.currentBranch : repo.defaultBranch) ?? "";
56
+ const baseSha = (await git.rev(repo.root, `refs/heads/${baseBranch}`)) ?? "";
57
+ const branch = `preston/${goal.id}${slugify(goal.brief.objective, 28) ? `-${slugify(goal.brief.objective, 28)}` : ""}`;
58
+ const path = join(this.deps.worktreesDir, projectSlug(repo.root), goal.id);
59
+ mkdirSync(join(this.deps.worktreesDir, projectSlug(repo.root)), { recursive: true });
60
+ const added = await git.run(repo.root, [
61
+ "-c",
62
+ "core.longpaths=true",
63
+ "worktree",
64
+ "add",
65
+ "-b",
66
+ branch,
67
+ path,
68
+ baseSha,
69
+ ]);
70
+ if (added.code !== 0) {
71
+ this.deps.log.warn("worktree creation failed", {
72
+ goalId: goal.id,
73
+ problem: gitProblem(added),
74
+ });
75
+ return this.fallback(goal, {
76
+ because: `Git would not create a separate working copy (${gitProblem(added) || "no reason given"})`,
77
+ });
78
+ }
79
+ if (repo.hasSubmodules) {
80
+ const submodules = await git.run(path, ["submodule", "update", "--init", "--recursive"], {
81
+ timeoutMs: 600_000,
82
+ });
83
+ if (submodules.code !== 0) {
84
+ await this.discard(repo.root, path, branch);
85
+ return this.fallback(goal, {
86
+ because: "the project uses Git submodules, and I couldn't set them up in a separate working copy",
87
+ });
88
+ }
89
+ }
90
+ const workspace = {
91
+ goalId: goal.id,
92
+ mode: "worktree",
93
+ repoRoot: repo.root,
94
+ worktreePath: canonicalPath(path),
95
+ workdir: repo.prefix
96
+ ? join(canonicalPath(path), ...repo.prefix.split("/"))
97
+ : canonicalPath(path),
98
+ branch,
99
+ baseBranch,
100
+ baseSha,
101
+ reason: null,
102
+ state: "active",
103
+ };
104
+ store.saveWorkspace(workspace);
105
+ this.deps.log.info("worktree created", { goalId: goal.id, path, branch, base: baseBranch });
106
+ return this.ready(workspace);
107
+ }
108
+ /** Things that stop a separate working copy from being made, before trying. */
109
+ async check(goal, info) {
110
+ const repo = info.repo;
111
+ if (!repo)
112
+ return undefined;
113
+ if (repo.bare) {
114
+ return {
115
+ because: "this folder is a bare Git repository (it holds history only, with no files to work on). Point me at a normal checkout of it instead",
116
+ noFallback: true,
117
+ };
118
+ }
119
+ if (repo.unborn) {
120
+ return {
121
+ because: "this Git project has no saved commits yet, so there is nothing for a separate working copy to start from",
122
+ };
123
+ }
124
+ const startFrom = goal.brief.workspace?.startFrom ?? "default";
125
+ if (startFrom === "current") {
126
+ if (!repo.currentBranch) {
127
+ return {
128
+ because: "the project is sitting on a past commit rather than on a branch, so I can't tell which branch to build on",
129
+ };
130
+ }
131
+ }
132
+ else if (!repo.defaultBranch) {
133
+ return {
134
+ because: "I can't tell which branch is the project's main one (it has no main or master branch)",
135
+ };
136
+ }
137
+ if (process.platform === "win32") {
138
+ const length = join(this.deps.worktreesDir, projectSlug(repo.root), goal.id).length;
139
+ if (length > MAX_WINDOWS_PATH) {
140
+ return {
141
+ because: "Preston's data folder path is too long for Windows to hold a separate working copy",
142
+ };
143
+ }
144
+ }
145
+ return undefined;
146
+ }
147
+ /** Works in place if the Brief allows it, otherwise explains why the Goal cannot start. */
148
+ fallback(goal, problem) {
149
+ if (!problem.noFallback && goal.brief.workspace?.allowInPlace) {
150
+ this.deps.log.info("working in place", { goalId: goal.id, because: problem.because });
151
+ return this.inPlace(goal, goal.projectPath, problem.because);
152
+ }
153
+ const options = problem.noFallback
154
+ ? ""
155
+ : " If you're happy for me to change files in your project folder directly instead, tell me and I'll start again that way.";
156
+ return {
157
+ ok: false,
158
+ reason: `I can't make a separate working copy of this project because ${problem.because}. I haven't changed anything.${options}`,
159
+ };
160
+ }
161
+ inPlace(goal, workdir, reason) {
162
+ this.deps.store.saveWorkspace({
163
+ goalId: goal.id,
164
+ mode: "in_place",
165
+ repoRoot: null,
166
+ worktreePath: null,
167
+ workdir,
168
+ branch: null,
169
+ baseBranch: null,
170
+ baseSha: null,
171
+ reason,
172
+ });
173
+ return {
174
+ ok: true,
175
+ workdir,
176
+ ...(reason
177
+ ? {
178
+ guidance: "This Goal works directly in the user's own project folder, so keep to the Brief's scope and do not discard or overwrite changes you did not make.",
179
+ }
180
+ : {}),
181
+ };
182
+ }
183
+ /** The Worker's guidance for a worktree. */
184
+ ready(w) {
185
+ return {
186
+ ok: true,
187
+ workdir: w.workdir,
188
+ guidance: `Your working folder is a dedicated Git worktree on branch ${w.branch}, separate from the user's own checkout, so work freely here. Stay on this branch and do not switch branches, push, or touch other worktrees. You do not need to commit: Preston commits your work, checks it again, and merges it itself.`,
189
+ };
190
+ }
191
+ /** Reuses an existing working copy after a restart, re-attaching it if it went missing. */
192
+ async reuse(goal, w) {
193
+ if (w.mode === "in_place")
194
+ return this.inPlace(goal, w.workdir, w.reason);
195
+ const { git, store } = this.deps;
196
+ const path = w.worktreePath ?? "";
197
+ const root = w.repoRoot ?? "";
198
+ const branch = w.branch ?? "";
199
+ if (!existsSync(path)) {
200
+ await git.run(root, ["worktree", "prune"]);
201
+ const attach = (await git.branchExists(root, branch))
202
+ ? await git.run(root, ["-c", "core.longpaths=true", "worktree", "add", path, branch])
203
+ : await git.run(root, [
204
+ "-c",
205
+ "core.longpaths=true",
206
+ "worktree",
207
+ "add",
208
+ "-b",
209
+ branch,
210
+ path,
211
+ w.baseSha ?? "HEAD",
212
+ ]);
213
+ if (attach.code !== 0) {
214
+ return {
215
+ ok: false,
216
+ reason: `I couldn't restore the separate working copy for this Goal (${gitProblem(attach)}). Its work is safe on branch ${branch}.`,
217
+ };
218
+ }
219
+ store.setWorkspaceState(goal.id, "active");
220
+ this.deps.log.info("worktree restored", { goalId: goal.id, path });
221
+ }
222
+ else if ((await git.currentBranch(path)) !== branch) {
223
+ const switched = await git.run(path, ["checkout", branch]);
224
+ if (switched.code !== 0) {
225
+ return {
226
+ ok: false,
227
+ reason: `The working copy for this Goal is not on its branch any more and I couldn't put it back (${gitProblem(switched)}). Its work is on branch ${branch}.`,
228
+ };
229
+ }
230
+ }
231
+ return this.ready(w);
232
+ }
233
+ /**
234
+ * Tidies the working copy of a Goal that has ended, never losing work. Nothing to lose (no
235
+ * unsaved changes, every commit already on the main branch): folder and branch are removed.
236
+ * Otherwise it is left alone until `retentionMs` after the Goal ended; then unsaved changes
237
+ * are saved as a commit on the Goal's branch, the folder is removed and the branch is kept.
238
+ * Only Preston's own branches and folders are ever touched.
239
+ */
240
+ async tidyEnded(w, input) {
241
+ const { git, log } = this.deps;
242
+ const { repoRoot: root, worktreePath: path, branch, baseBranch: base } = w;
243
+ if (w.mode !== "worktree" || w.state !== "active" || !root || !path || !branch || !base) {
244
+ return "kept";
245
+ }
246
+ if (!branch.startsWith("preston/") || !isInside(this.deps.worktreesDir, path))
247
+ return "kept";
248
+ const unmerged = async () => (await git.branchExists(root, branch))
249
+ ? Number((await git.out(root, [
250
+ "rev-list",
251
+ "--count",
252
+ `refs/heads/${base}..refs/heads/${branch}`,
253
+ ])) ?? 1)
254
+ : 0;
255
+ const folder = existsSync(path);
256
+ const dirty = folder && (await git.dirty(path));
257
+ if (!dirty && (await unmerged()) === 0) {
258
+ await this.cleanup(w, { deleteBranch: true });
259
+ return "removed";
260
+ }
261
+ const expired = input.endedAt !== null &&
262
+ this.deps.clock.now() - Date.parse(input.endedAt) >= input.retentionMs;
263
+ if (!expired)
264
+ return "kept";
265
+ if (dirty && !(await this.snapshot(path))) {
266
+ log.warn("could not save a finished Goal's unsaved work, so its folder stays", {
267
+ goalId: w.goalId,
268
+ });
269
+ return "kept";
270
+ }
271
+ const keep = (await unmerged()) > 0;
272
+ await this.cleanup(w, { deleteBranch: !keep });
273
+ return keep ? "archived" : "removed";
274
+ }
275
+ /** Saves unsaved changes as a commit on the worktree's branch (hooks are not run). */
276
+ async snapshot(path) {
277
+ const { git } = this.deps;
278
+ const staged = await stageWork(git, path);
279
+ if (staged.problem)
280
+ return false;
281
+ if (await git.ok(path, ["diff", "--cached", "--quiet"]))
282
+ return true;
283
+ const committed = await git.run(path, [
284
+ ...(await git.identityArgs(path)),
285
+ "commit",
286
+ "--no-verify",
287
+ "-m",
288
+ "Unfinished work saved by Preston",
289
+ ]);
290
+ return committed.code === 0;
291
+ }
292
+ /**
293
+ * Removes a Goal's worktree folder. With `deleteBranch` the branch goes too (the caller has
294
+ * landed everything); without, the branch stays and the working copy is recorded as archived.
295
+ */
296
+ async cleanup(w, options) {
297
+ if (w.mode !== "worktree" || !w.repoRoot || !w.worktreePath || !w.branch)
298
+ return;
299
+ const { git, store, log } = this.deps;
300
+ await this.serialised(w.repoRoot, async () => {
301
+ if (existsSync(w.worktreePath ?? "")) {
302
+ const removed = await git.run(w.repoRoot ?? "", [
303
+ "worktree",
304
+ "remove",
305
+ "--force",
306
+ w.worktreePath ?? "",
307
+ ]);
308
+ if (removed.code !== 0) {
309
+ log.warn("could not remove worktree", {
310
+ path: w.worktreePath,
311
+ problem: gitProblem(removed),
312
+ });
313
+ return;
314
+ }
315
+ }
316
+ await git.run(w.repoRoot ?? "", ["worktree", "prune"]);
317
+ if (options.deleteBranch) {
318
+ const deleted = await git.run(w.repoRoot ?? "", ["branch", "-D", w.branch ?? ""]);
319
+ if (deleted.code !== 0) {
320
+ log.warn("could not delete branch", { branch: w.branch, problem: gitProblem(deleted) });
321
+ }
322
+ }
323
+ store.setWorkspaceState(w.goalId, options.deleteBranch ? "removed" : "archived");
324
+ });
325
+ }
326
+ async discard(root, path, branch) {
327
+ await this.deps.git.run(root, ["worktree", "remove", "--force", path]);
328
+ await this.deps.git.run(root, ["branch", "-D", branch]);
329
+ }
330
+ /** Runs `fn` after everything queued before it for the same repository. */
331
+ serialised(key, fn) {
332
+ const previous = this.chains.get(key) ?? Promise.resolve();
333
+ const next = previous.then(fn, fn);
334
+ this.chains.set(key, next.catch(() => undefined));
335
+ return next;
336
+ }
337
+ }
338
+ /** A cheap look for a `.git` entry here or in a parent folder (or a bare repository's files). */
339
+ function mayBeRepository(path) {
340
+ if (existsSync(join(path, "HEAD")) && existsSync(join(path, "objects")))
341
+ return true;
342
+ for (let dir = path;; dir = dirname(dir)) {
343
+ if (existsSync(join(dir, ".git")))
344
+ return true;
345
+ if (dirname(dir) === dir)
346
+ return false;
347
+ }
348
+ }
349
+ //# sourceMappingURL=workspace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/landing/workspace.ts"],"names":[],"mappings":"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"}
package/dist/log.js ADDED
@@ -0,0 +1,77 @@
1
+ import { appendFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { isoNow } from "./clock.js";
4
+ // Provider token shapes worth masking even when Preston was never told about them.
5
+ const TOKEN_PATTERNS = [
6
+ /\bxox[abposr]-[A-Za-z0-9-]{10,}/g, // Slack
7
+ /\bxapp-[A-Za-z0-9-]{10,}/g, // Slack app-level
8
+ /\b[A-Za-z0-9_-]{23,28}\.[A-Za-z0-9_-]{6,7}\.[A-Za-z0-9_-]{27,}/g, // Discord bot
9
+ /\b(?:sk|pk|rk)-[A-Za-z0-9_-]{16,}/g, // API keys
10
+ ];
11
+ // More generic shapes: right for a log, too eager for text the user is meant to read.
12
+ const GENERIC_PATTERNS = [
13
+ /\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/gi,
14
+ /\b[a-f0-9]{48,}\b/gi, // long hex secrets (IPC and MCP tokens)
15
+ ];
16
+ const MASK = "[redacted]";
17
+ /** Masks known secrets and common token shapes. Every log line passes through it. */
18
+ export class Redactor {
19
+ secrets = new Set();
20
+ add(secret) {
21
+ if (secret && secret.length >= 8)
22
+ this.secrets.add(secret);
23
+ }
24
+ /** For logs: known secrets and every token shape. */
25
+ redact(text) {
26
+ return this.mask(text, [...TOKEN_PATTERNS, ...GENERIC_PATTERNS]);
27
+ }
28
+ /** For messages to the user: known secrets and provider tokens, but not hashes or Bearer text. */
29
+ redactOutgoing(text) {
30
+ return this.mask(text, TOKEN_PATTERNS);
31
+ }
32
+ mask(text, patterns) {
33
+ let out = text;
34
+ for (const secret of this.secrets)
35
+ out = out.split(secret).join(MASK);
36
+ for (const pattern of patterns)
37
+ out = out.replace(pattern, MASK);
38
+ return out;
39
+ }
40
+ }
41
+ /** Structured JSON-lines logger writing to `<dir>/preston.log`. */
42
+ export function createLogger(options, component = "preston") {
43
+ const file = join(options.dir, "preston.log");
44
+ const write = (level, message, data) => {
45
+ const entry = { at: isoNow(options.clock), level, component, message };
46
+ if (data !== undefined)
47
+ entry.data = toLoggable(data);
48
+ const line = `${options.redactor.redact(JSON.stringify(entry))}\n`;
49
+ try {
50
+ appendFileSync(file, line, { mode: 0o600 });
51
+ }
52
+ catch {
53
+ // Logging must never take Preston down.
54
+ }
55
+ if (options.mirror)
56
+ process.stderr.write(line);
57
+ };
58
+ return {
59
+ debug: (m, d) => write("debug", m, d),
60
+ info: (m, d) => write("info", m, d),
61
+ warn: (m, d) => write("warn", m, d),
62
+ error: (m, d) => write("error", m, d),
63
+ child: (name) => createLogger(options, `${component}.${name}`),
64
+ };
65
+ }
66
+ function toLoggable(data) {
67
+ if (data instanceof Error)
68
+ return { error: data.message, stack: data.stack };
69
+ if (data && typeof data === "object" && "error" in data && data.error instanceof Error) {
70
+ return { ...data, error: data.error.message };
71
+ }
72
+ return data;
73
+ }
74
+ export function errorMessage(err) {
75
+ return err instanceof Error ? err.message : String(err);
76
+ }
77
+ //# sourceMappingURL=log.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"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"}