@opencorelabs/lucidity 0.7.0 → 0.8.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 (219) hide show
  1. package/README.md +9 -2
  2. package/dist/assets/speech/lucidity-speech +0 -0
  3. package/dist/automations/agent.d.ts.map +1 -1
  4. package/dist/automations/agent.js +2 -0
  5. package/dist/automations/designer.d.ts +1 -1
  6. package/dist/chat/server.d.ts +1 -0
  7. package/dist/chat/server.d.ts.map +1 -1
  8. package/dist/chat/server.js +6 -1
  9. package/dist/coding/conduct.d.ts +1 -22
  10. package/dist/coding/conduct.d.ts.map +1 -1
  11. package/dist/coding/conduct.js +9 -94
  12. package/dist/coding/runCodeTurn.d.ts +3 -16
  13. package/dist/coding/runCodeTurn.d.ts.map +1 -1
  14. package/dist/coding/runCodeTurn.js +157 -165
  15. package/dist/coding/workspaceRegistry.d.ts +24 -0
  16. package/dist/coding/workspaceRegistry.d.ts.map +1 -0
  17. package/dist/coding/workspaceRegistry.js +230 -0
  18. package/dist/coding/worktree.d.ts +11 -14
  19. package/dist/coding/worktree.d.ts.map +1 -1
  20. package/dist/coding/worktree.js +41 -21
  21. package/dist/config.d.ts +2 -0
  22. package/dist/config.d.ts.map +1 -1
  23. package/dist/daemonLease.d.ts +12 -0
  24. package/dist/daemonLease.d.ts.map +1 -0
  25. package/dist/daemonLease.js +32 -0
  26. package/dist/goals/assessment.d.ts +115 -0
  27. package/dist/goals/assessment.d.ts.map +1 -0
  28. package/dist/goals/assessment.js +67 -0
  29. package/dist/goals/notes.d.ts +18 -0
  30. package/dist/goals/notes.d.ts.map +1 -0
  31. package/dist/goals/notes.js +72 -0
  32. package/dist/index.js +57 -15
  33. package/dist/jobs/goals.d.ts +15 -0
  34. package/dist/jobs/goals.d.ts.map +1 -0
  35. package/dist/jobs/goals.js +286 -0
  36. package/dist/jobs/weeklyReview.d.ts.map +1 -1
  37. package/dist/jobs/weeklyReview.js +3 -2
  38. package/dist/queue.d.ts +1 -0
  39. package/dist/queue.d.ts.map +1 -1
  40. package/dist/queue.js +4 -0
  41. package/dist/room/client.d.ts +5 -0
  42. package/dist/room/client.d.ts.map +1 -1
  43. package/dist/room/client.js +116 -101
  44. package/dist/room/computer.d.ts.map +1 -1
  45. package/dist/room/computer.js +1 -0
  46. package/dist/room/durablePublish.d.ts +6 -0
  47. package/dist/room/durablePublish.d.ts.map +1 -0
  48. package/dist/room/durablePublish.js +19 -0
  49. package/dist/room/incidents.d.ts +1 -1
  50. package/dist/room/incidents.d.ts.map +1 -1
  51. package/dist/room/incidents.js +14 -7
  52. package/dist/room/turnQueue.d.ts.map +1 -1
  53. package/dist/room/turnQueue.js +27 -24
  54. package/dist/runtimeStore.d.ts +44 -0
  55. package/dist/runtimeStore.d.ts.map +1 -0
  56. package/dist/runtimeStore.js +188 -0
  57. package/dist/setup/server.js +1 -1
  58. package/dist/turnLog.d.ts +10 -40
  59. package/dist/turnLog.d.ts.map +1 -1
  60. package/dist/turnLog.js +33 -56
  61. package/package.json +4 -4
  62. package/src/automations/agent.ts +2 -0
  63. package/src/chat/server.ts +7 -1
  64. package/src/coding/conduct.ts +10 -147
  65. package/src/coding/runCodeTurn.ts +42 -61
  66. package/src/coding/workspaceRegistry.ts +210 -0
  67. package/src/coding/worktree.ts +44 -20
  68. package/src/config.ts +2 -0
  69. package/src/daemonLease.ts +33 -0
  70. package/src/goals/assessment.ts +106 -0
  71. package/src/goals/notes.ts +88 -0
  72. package/src/index.ts +57 -18
  73. package/src/jobs/goals.ts +384 -0
  74. package/src/jobs/weeklyReview.ts +4 -3
  75. package/src/queue.ts +4 -0
  76. package/src/room/client.ts +77 -74
  77. package/src/room/computer.ts +1 -0
  78. package/src/room/durablePublish.ts +25 -0
  79. package/src/room/incidents.ts +16 -8
  80. package/src/room/turnQueue.ts +26 -27
  81. package/src/runtimeStore.ts +190 -0
  82. package/src/setup/server.ts +1 -1
  83. package/src/turnLog.ts +32 -75
  84. package/vendor/mcp-server/dist/index.js +2 -0
  85. package/vendor/mcp-server/dist/tools/goals.d.ts +4 -0
  86. package/vendor/mcp-server/dist/tools/goals.d.ts.map +1 -0
  87. package/vendor/mcp-server/dist/tools/goals.js +38 -0
  88. package/vendor/mcp-server/package.json +1 -1
  89. package/vendor/mcp-server/src/index.ts +2 -0
  90. package/vendor/mcp-server/src/tools/goals.ts +62 -0
  91. package/vendor/runtime/README.md +2 -2
  92. package/vendor/runtime/dist/executor/asyncQueue.d.ts +1 -0
  93. package/vendor/runtime/dist/executor/asyncQueue.d.ts.map +1 -1
  94. package/vendor/runtime/dist/executor/asyncQueue.js +3 -0
  95. package/vendor/runtime/dist/executor/claudeAgent.d.ts +1 -1
  96. package/vendor/runtime/dist/executor/claudeAgent.d.ts.map +1 -1
  97. package/vendor/runtime/dist/executor/claudeAgent.js +20 -9
  98. package/vendor/runtime/dist/executor/codex.d.ts +1 -0
  99. package/vendor/runtime/dist/executor/codex.d.ts.map +1 -1
  100. package/vendor/runtime/dist/executor/codex.js +68 -36
  101. package/vendor/runtime/dist/executor/codexProtocol/FunctionCallOutputContentItem.d.ts +4 -1
  102. package/vendor/runtime/dist/executor/codexProtocol/FunctionCallOutputContentItem.d.ts.map +1 -1
  103. package/vendor/runtime/dist/executor/codexProtocol/Personality.d.ts +3 -0
  104. package/vendor/runtime/dist/executor/codexProtocol/Personality.d.ts.map +1 -1
  105. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts +1 -1
  106. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts.map +1 -1
  107. package/vendor/runtime/dist/executor/codexProtocol/v2/CyberAccessProgram.d.ts +6 -0
  108. package/vendor/runtime/dist/executor/codexProtocol/v2/CyberAccessProgram.d.ts.map +1 -0
  109. package/vendor/runtime/dist/executor/codexProtocol/v2/CyberAccessProgram.js +2 -0
  110. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts +5 -0
  111. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts.map +1 -1
  112. package/vendor/runtime/dist/executor/codexProtocol/v2/Model.d.ts +8 -0
  113. package/vendor/runtime/dist/executor/codexProtocol/v2/Model.d.ts.map +1 -1
  114. package/vendor/runtime/dist/executor/codexProtocol/v2/ModelAccessPrograms.d.ts +11 -0
  115. package/vendor/runtime/dist/executor/codexProtocol/v2/ModelAccessPrograms.d.ts.map +1 -0
  116. package/vendor/runtime/dist/executor/codexProtocol/v2/ModelAccessPrograms.js +2 -0
  117. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts +4 -0
  118. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts.map +1 -1
  119. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts +2 -0
  120. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts.map +1 -1
  121. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadResumeParams.d.ts +4 -1
  122. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadResumeParams.d.ts.map +1 -1
  123. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadStartParams.d.ts +3 -1
  124. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadStartParams.d.ts.map +1 -1
  125. package/vendor/runtime/dist/executor/codexProtocol/v2/TurnStartParams.d.ts +7 -2
  126. package/vendor/runtime/dist/executor/codexProtocol/v2/TurnStartParams.d.ts.map +1 -1
  127. package/vendor/runtime/dist/executor/codexProtocol/v2/UserInput.d.ts +3 -0
  128. package/vendor/runtime/dist/executor/codexProtocol/v2/UserInput.d.ts.map +1 -1
  129. package/vendor/runtime/dist/executor/codexRpc.d.ts +10 -3
  130. package/vendor/runtime/dist/executor/codexRpc.d.ts.map +1 -1
  131. package/vendor/runtime/dist/executor/codexRpc.js +18 -3
  132. package/vendor/runtime/dist/executor/codexSessions.d.ts +30 -0
  133. package/vendor/runtime/dist/executor/codexSessions.d.ts.map +1 -0
  134. package/vendor/runtime/dist/executor/codexSessions.js +88 -0
  135. package/vendor/runtime/dist/executor/health.d.ts +2 -1
  136. package/vendor/runtime/dist/executor/health.d.ts.map +1 -1
  137. package/vendor/runtime/dist/executor/health.js +17 -5
  138. package/vendor/runtime/dist/executor/liveTurns.d.ts +2 -1
  139. package/vendor/runtime/dist/executor/liveTurns.d.ts.map +1 -1
  140. package/vendor/runtime/dist/executor/liveTurns.js +12 -5
  141. package/vendor/runtime/dist/executor/ownership.d.ts +35 -0
  142. package/vendor/runtime/dist/executor/ownership.d.ts.map +1 -0
  143. package/vendor/runtime/dist/executor/ownership.js +99 -0
  144. package/vendor/runtime/dist/executor/providerRouter.d.ts +1 -0
  145. package/vendor/runtime/dist/executor/providerRouter.d.ts.map +1 -1
  146. package/vendor/runtime/dist/executor/providerRouter.js +5 -0
  147. package/vendor/runtime/dist/executor/types.d.ts +2 -0
  148. package/vendor/runtime/dist/executor/types.d.ts.map +1 -1
  149. package/vendor/runtime/dist/index.d.ts +1 -0
  150. package/vendor/runtime/dist/index.d.ts.map +1 -1
  151. package/vendor/runtime/dist/index.js +1 -0
  152. package/vendor/runtime/src/executor/asyncQueue.ts +3 -0
  153. package/vendor/runtime/src/executor/claudeAgent.ts +16 -9
  154. package/vendor/runtime/src/executor/codex.ts +75 -44
  155. package/vendor/runtime/src/executor/codexProtocol/FunctionCallOutputContentItem.ts +1 -1
  156. package/vendor/runtime/src/executor/codexProtocol/Personality.ts +3 -0
  157. package/vendor/runtime/src/executor/codexProtocol/PlanType.ts +1 -1
  158. package/vendor/runtime/src/executor/codexProtocol/README.md +2 -2
  159. package/vendor/runtime/src/executor/codexProtocol/v2/CyberAccessProgram.ts +9 -0
  160. package/vendor/runtime/src/executor/codexProtocol/v2/GetAccountRateLimitsResponse.ts +5 -0
  161. package/vendor/runtime/src/executor/codexProtocol/v2/Model.ts +11 -2
  162. package/vendor/runtime/src/executor/codexProtocol/v2/ModelAccessPrograms.ts +13 -0
  163. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitSnapshot.ts +5 -1
  164. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewStartParams.ts +2 -0
  165. package/vendor/runtime/src/executor/codexProtocol/v2/ThreadResumeParams.ts +5 -1
  166. package/vendor/runtime/src/executor/codexProtocol/v2/ThreadStartParams.ts +4 -1
  167. package/vendor/runtime/src/executor/codexProtocol/v2/TurnStartParams.ts +7 -2
  168. package/vendor/runtime/src/executor/codexProtocol/v2/UserInput.ts +1 -1
  169. package/vendor/runtime/src/executor/codexRpc.ts +22 -4
  170. package/vendor/runtime/src/executor/codexSessions.ts +108 -0
  171. package/vendor/runtime/src/executor/health.ts +16 -6
  172. package/vendor/runtime/src/executor/liveTurns.ts +12 -5
  173. package/vendor/runtime/src/executor/ownership.ts +76 -0
  174. package/vendor/runtime/src/executor/providerRouter.ts +6 -0
  175. package/vendor/runtime/src/executor/types.ts +2 -0
  176. package/vendor/runtime/src/index.ts +1 -0
  177. package/vendor/shared/dist/agentCommands.d.ts +1 -0
  178. package/vendor/shared/dist/agentCommands.d.ts.map +1 -1
  179. package/vendor/shared/dist/cardStudio.d.ts +41 -0
  180. package/vendor/shared/dist/cardStudio.d.ts.map +1 -1
  181. package/vendor/shared/dist/cardStudio.js +13 -3
  182. package/vendor/shared/dist/computer.d.ts +7 -1
  183. package/vendor/shared/dist/computer.d.ts.map +1 -1
  184. package/vendor/shared/dist/computer.js +12 -2
  185. package/vendor/shared/dist/constants.d.ts +3 -3
  186. package/vendor/shared/dist/constants.d.ts.map +1 -1
  187. package/vendor/shared/dist/constants.js +5 -4
  188. package/vendor/shared/dist/goalNotes.d.ts +4 -0
  189. package/vendor/shared/dist/goalNotes.d.ts.map +1 -0
  190. package/vendor/shared/dist/goalNotes.js +23 -0
  191. package/vendor/shared/dist/goals.d.ts +835 -0
  192. package/vendor/shared/dist/goals.d.ts.map +1 -0
  193. package/vendor/shared/dist/goals.js +198 -0
  194. package/vendor/shared/dist/index.d.ts +3 -0
  195. package/vendor/shared/dist/index.d.ts.map +1 -1
  196. package/vendor/shared/dist/index.js +3 -0
  197. package/vendor/shared/dist/schemas/harness.d.ts +101 -0
  198. package/vendor/shared/dist/schemas/harness.d.ts.map +1 -1
  199. package/vendor/shared/dist/schemas/harness.js +6 -0
  200. package/vendor/shared/dist/workspaces.d.ts +138 -0
  201. package/vendor/shared/dist/workspaces.d.ts.map +1 -0
  202. package/vendor/shared/dist/workspaces.js +40 -0
  203. package/vendor/shared/src/agentCommands.ts +1 -0
  204. package/vendor/shared/src/cardStudio.ts +13 -3
  205. package/vendor/shared/src/computer.ts +16 -2
  206. package/vendor/shared/src/constants.ts +5 -4
  207. package/vendor/shared/src/goalNotes.ts +23 -0
  208. package/vendor/shared/src/goals.ts +237 -0
  209. package/vendor/shared/src/index.ts +4 -0
  210. package/vendor/shared/src/schemas/harness.ts +6 -0
  211. package/vendor/shared/src/workspaces.ts +48 -0
  212. package/dist/coding/fleetIntegrate.d.ts +0 -37
  213. package/dist/coding/fleetIntegrate.d.ts.map +0 -1
  214. package/dist/coding/fleetIntegrate.js +0 -64
  215. package/dist/coding/openFleetPr.d.ts +0 -41
  216. package/dist/coding/openFleetPr.d.ts.map +0 -1
  217. package/dist/coding/openFleetPr.js +0 -121
  218. package/src/coding/fleetIntegrate.ts +0 -95
  219. package/src/coding/openFleetPr.ts +0 -148
@@ -29,6 +29,12 @@ export declare function sessionBranch(repoId: string, workerId?: string): string
29
29
  export declare function sessionWorktreePath(repoId: string, baseDir?: string, workerId?: string): string;
30
30
  /** The branch checked out in `repoRoot`, or `HEAD` when detached. */
31
31
  export declare function currentBranch(repoRoot: string): Promise<string>;
32
+ export declare function workspaceBranchExists(repoRoot: string, repoId: string, workerId?: string): Promise<boolean>;
33
+ /** Resolve the fetched remote base without changing the existing checkout. */
34
+ export declare function workspaceBase(repoRoot: string, configured?: string): Promise<{
35
+ ref: string;
36
+ sha: string;
37
+ }>;
32
38
  /**
33
39
  * How many commits this worktree's HEAD carries that `base` doesn't.
34
40
  *
@@ -62,23 +68,12 @@ export declare function githubWebUrlFromRemote(raw: string): string | undefined;
62
68
  * `git remote` rather than `gh` so it needs no auth and works even when `gh` is absent — the phone
63
69
  * appends `/pulls`, `/issues`, `/projects` to jump straight there. */
64
70
  export declare function repoWebUrl(repoRoot: string): Promise<string | undefined>;
65
- /**
66
- * Prepare the workspace for a coding turn.
67
- *
68
- * `worktree` (default): ensure the persistent worktree for this repo's session exists
69
- * on its `lucid/<repoId>` branch, at a STABLE path so Claude Code's `--resume` resolves
70
- * across turns. `fresh: true` (a new session — no resume) resets the branch and worktree
71
- * to HEAD, discarding any prior session's state. Otherwise the existing worktree is
72
- * reused as-is so prior turns' commits (files) carry forward; if it's missing (first
73
- * turn, or pruned), it's created off HEAD.
74
- *
75
- * `in-place` (#121): the user's own checkout, on its live branch, uncommitted work and
76
- * all — the point of the mode is that Lucid continues from where the user left off, so
77
- * `fresh` resets NOTHING here. It would mean discarding their work.
78
- */
71
+ /** Resolve a persistent workspace. Provider session changes never reset its files. */
79
72
  export declare function ensureWorkspace(repoRoot: string, repoId: string, opts?: {
80
73
  mode?: WorkspaceMode;
74
+ /** Legacy callers may pass this; conversation resets never reset a workspace. */
81
75
  fresh?: boolean;
76
+ startPoint?: string;
82
77
  baseDir?: string;
83
78
  /** Conductor worker id (the fleet subtask's id). Present → an isolated per-worker
84
79
  * worktree/branch so N workers run in parallel on one repo. Absent → the classic
@@ -146,4 +141,6 @@ export declare function commitWorkspace(ws: Workspace, message: string, paths: s
146
141
  export declare function removeWorktree(repoRoot: string, ws: Workspace, opts?: {
147
142
  keepBranch?: boolean;
148
143
  }): Promise<void>;
144
+ /** A review can inspect tracked changes without staging or reading unrelated untracked files. */
145
+ export declare function reviewDiff(ws: Workspace): Promise<string>;
149
146
  //# sourceMappingURL=worktree.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/coding/worktree.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAStD;;kEAEkE;AAClE,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB;AAYD;;;;;;;;;;uCAUuC;AACvC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;;;yFAIyF;AACzF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAsB,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAIR;AAED,qEAAqE;AACrE,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQtF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU1F;AAED;;;;;qEAKqE;AACrE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUtE;AAED;;;uEAGuE;AACvE,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACJ,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;qCAEiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,OAAO,CAAC,SAAS,CAAC,CAkBpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CASjE;AAED;;;oDAGoD;AACpD,wBAAsB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAO3H;AAED;wEACwE;AACxE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW7H;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAWvG;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,SAAS,EACb,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAgBf"}
1
+ {"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/coding/worktree.ts"],"names":[],"mappings":"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"}
@@ -46,6 +46,31 @@ export function sessionWorktreePath(repoId, baseDir = WORKTREE_BASE, workerId) {
46
46
  export async function currentBranch(repoRoot) {
47
47
  return (await git(repoRoot, ['rev-parse', '--abbrev-ref', 'HEAD'])).trim();
48
48
  }
49
+ export async function workspaceBranchExists(repoRoot, repoId, workerId) {
50
+ return git(repoRoot, ['show-ref', '--verify', `refs/heads/${sessionBranch(repoId, workerId)}`]).then(() => true, () => false);
51
+ }
52
+ /** Resolve the fetched remote base without changing the existing checkout. */
53
+ export async function workspaceBase(repoRoot, configured) {
54
+ const remotes = (await git(repoRoot, ['remote'])).trim().split('\n');
55
+ if (!remotes.includes('origin')) {
56
+ if (configured)
57
+ throw new Error('The configured workspace base requires an origin remote.');
58
+ return { ref: 'HEAD', sha: (await git(repoRoot, ['rev-parse', 'HEAD'])).trim() };
59
+ }
60
+ await git(repoRoot, ['fetch', 'origin']);
61
+ let ref = configured;
62
+ if (!ref) {
63
+ const remoteHead = await git(repoRoot, ['ls-remote', '--symref', 'origin', 'HEAD']);
64
+ const branch = /^ref: refs\/heads\/(.+)\s+HEAD$/m.exec(remoteHead)?.[1];
65
+ if (!branch)
66
+ throw new Error('Could not resolve the remote default branch. Set this repository\'s baseRef.');
67
+ ref = `origin/${branch}`;
68
+ }
69
+ if (!ref.startsWith('origin/'))
70
+ ref = `origin/${ref}`;
71
+ const sha = (await git(repoRoot, ['rev-parse', '--verify', '--end-of-options', `${ref}^{commit}`])).trim();
72
+ return { ref, sha };
73
+ }
49
74
  /**
50
75
  * How many commits this worktree's HEAD carries that `base` doesn't.
51
76
  *
@@ -113,20 +138,7 @@ export async function repoWebUrl(repoRoot) {
113
138
  const raw = await git(repoRoot, ['remote', 'get-url', 'origin']).catch(() => '');
114
139
  return githubWebUrlFromRemote(raw);
115
140
  }
116
- /**
117
- * Prepare the workspace for a coding turn.
118
- *
119
- * `worktree` (default): ensure the persistent worktree for this repo's session exists
120
- * on its `lucid/<repoId>` branch, at a STABLE path so Claude Code's `--resume` resolves
121
- * across turns. `fresh: true` (a new session — no resume) resets the branch and worktree
122
- * to HEAD, discarding any prior session's state. Otherwise the existing worktree is
123
- * reused as-is so prior turns' commits (files) carry forward; if it's missing (first
124
- * turn, or pruned), it's created off HEAD.
125
- *
126
- * `in-place` (#121): the user's own checkout, on its live branch, uncommitted work and
127
- * all — the point of the mode is that Lucid continues from where the user left off, so
128
- * `fresh` resets NOTHING here. It would mean discarding their work.
129
- */
141
+ /** Resolve a persistent workspace. Provider session changes never reset its files. */
130
142
  export async function ensureWorkspace(repoRoot, repoId, opts = {}) {
131
143
  const mode = opts.mode ?? 'worktree';
132
144
  if (mode === 'in-place') {
@@ -136,13 +148,15 @@ export async function ensureWorkspace(repoRoot, repoId, opts = {}) {
136
148
  const branch = sessionBranch(repoId, opts.workerId);
137
149
  const path = sessionWorktreePath(repoId, baseDir, opts.workerId);
138
150
  mkdirSync(baseDir, { recursive: true });
139
- const present = existsSync(path);
140
- if (present && !opts.fresh)
141
- return { path, branch, mode }; // reuse (resume) — files carry forward
142
- if (present)
143
- await removeWorktree(repoRoot, { path, branch, mode }, { keepBranch: false }); // fresh: wipe old session
144
- // (Re)create the branch + worktree at the stable path off HEAD.
145
- await git(repoRoot, ['worktree', 'add', '-B', branch, path, 'HEAD']);
151
+ if (existsSync(path)) {
152
+ return { path, branch: await currentBranch(path), mode };
153
+ }
154
+ // Recover branches left behind by the old automatic delivery path.
155
+ const existing = await git(repoRoot, ['show-ref', '--verify', `refs/heads/${branch}`])
156
+ .then(() => true, () => false);
157
+ await git(repoRoot, existing
158
+ ? ['worktree', 'add', path, branch]
159
+ : ['worktree', 'add', '-b', branch, path, opts.startPoint ?? 'HEAD']);
146
160
  return { path, branch, mode };
147
161
  }
148
162
  /**
@@ -262,3 +276,9 @@ export async function removeWorktree(repoRoot, ws, opts = {}) {
262
276
  }
263
277
  }
264
278
  }
279
+ /** A review can inspect tracked changes without staging or reading unrelated untracked files. */
280
+ export async function reviewDiff(ws) {
281
+ const diff = await git(ws.path, ['diff', '--no-ext-diff', '--no-textconv', 'HEAD', '--']);
282
+ const limit = 80_000;
283
+ return diff.length > limit ? diff.slice(0, limit) + '\n[Diff truncated. Read the relevant files for the rest.]' : diff;
284
+ }
package/dist/config.d.ts CHANGED
@@ -20,6 +20,8 @@ export declare const INCIDENTS_DIR: string;
20
20
  export declare const VOICE_DIAG_DIR: string;
21
21
  /** An allowlisted repo Lucid may code in (M7). The phone sends the `id`, never a path. */
22
22
  export interface RepoEntry {
23
+ /** Remote base for new workers, e.g. origin/main; defaults to origin's HEAD. */
24
+ baseRef?: string;
23
25
  /** Short name the phone selects, e.g. `"lucidity"`. */
24
26
  id: string;
25
27
  /** Absolute path to the repo on this machine. `~` expands. */
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /** The OS releases this lock on exit, including a crash. Never unlink its database. */
2
+ export declare class DaemonLease {
3
+ readonly owner: {
4
+ epoch: `${string}-${string}-${string}-${string}-${string}`;
5
+ pid: number;
6
+ startedAt: string;
7
+ };
8
+ private db;
9
+ constructor(directory: string);
10
+ close(): void;
11
+ }
12
+ //# sourceMappingURL=daemonLease.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemonLease.d.ts","sourceRoot":"","sources":["../src/daemonLease.ts"],"names":[],"mappings":"AAMA,uFAAuF;AACvF,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK;;;;MAAkF;IAChG,OAAO,CAAC,EAAE,CAAM;gBAEJ,SAAS,EAAE,MAAM;IAgB7B,KAAK,IAAI,IAAI;CAKd"}
@@ -0,0 +1,32 @@
1
+ // @ts-expect-error Node 22 runtime API; the repository's Node type baseline is 20.
2
+ import { DatabaseSync } from 'node:sqlite';
3
+ import { chmodSync, mkdirSync } from 'node:fs';
4
+ import { join } from 'node:path';
5
+ import { randomUUID } from 'node:crypto';
6
+ /** The OS releases this lock on exit, including a crash. Never unlink its database. */
7
+ export class DaemonLease {
8
+ owner = { epoch: randomUUID(), pid: process.pid, startedAt: new Date().toISOString() };
9
+ db;
10
+ constructor(directory) {
11
+ mkdirSync(directory, { recursive: true, mode: 0o700 });
12
+ const path = join(directory, 'daemon-owner.sqlite');
13
+ const db = new DatabaseSync(path);
14
+ try {
15
+ chmodSync(path, 0o600);
16
+ db.exec('PRAGMA busy_timeout=0; BEGIN EXCLUSIVE;');
17
+ this.db = db;
18
+ }
19
+ catch (error) {
20
+ db.close();
21
+ if (error.errcode === 5)
22
+ throw new Error('Lucidity is already running for this configuration. Stop that daemon before starting another.');
23
+ throw error;
24
+ }
25
+ }
26
+ close() {
27
+ if (!this.db)
28
+ return;
29
+ this.db.close();
30
+ this.db = undefined;
31
+ }
32
+ }
@@ -0,0 +1,115 @@
1
+ import { type GoalCandidate, type GoalCheck, type GoalDetail, type GoalEvidence } from '@lucidity/shared';
2
+ /** Keep stored evidence intact; send a bounded, explicitly partial view to the model. */
3
+ export declare function goalAssessmentInput(input: {
4
+ detail: GoalDetail;
5
+ period: Pick<GoalCheck, 'cadence' | 'key' | 'start' | 'end'>;
6
+ sources: GoalCandidate[];
7
+ evidence: GoalEvidence[];
8
+ complete: boolean;
9
+ }): {
10
+ goal: {
11
+ title: string;
12
+ timeframe: {
13
+ start: string;
14
+ end: string;
15
+ precision: "custom" | "year" | "month" | "quarter";
16
+ timeZone: string;
17
+ };
18
+ status: "completed" | "archived" | "paused" | "active";
19
+ tracking: boolean;
20
+ reviews: ("weekly" | "monthly" | "yearly")[];
21
+ id: string;
22
+ revision: number;
23
+ createdAt: string;
24
+ updatedAt: string;
25
+ };
26
+ period: Pick<{
27
+ key: string;
28
+ cadence: "daily" | "weekly" | "monthly" | "yearly";
29
+ start: string;
30
+ end: string;
31
+ checkedAt: string;
32
+ signal: "unknown" | "moving" | "quiet";
33
+ summary: string;
34
+ evidence: {
35
+ key: string;
36
+ reference: {
37
+ kind: "project" | "task" | "habit" | "note";
38
+ id: string;
39
+ };
40
+ at: string;
41
+ kind: "task_completed" | "task_started" | "task_reopened" | "task_changed" | "habit_check_in" | "note_changed";
42
+ title: string | null;
43
+ available: boolean;
44
+ }[];
45
+ references: {
46
+ kind: "project" | "task" | "habit" | "note";
47
+ id: string;
48
+ }[];
49
+ timeframe: {
50
+ start: string;
51
+ end: string;
52
+ precision: "custom" | "year" | "month" | "quarter";
53
+ timeZone: string;
54
+ };
55
+ }, "end" | "start" | "key" | "cadence">;
56
+ sources: {
57
+ title: string;
58
+ description: string | null;
59
+ kind: "project" | "task" | "habit" | "note";
60
+ id: string;
61
+ updatedAt: string | null;
62
+ status: string | null;
63
+ projectId: string | null;
64
+ }[];
65
+ notes: {
66
+ kind: "project" | "task" | "habit" | "note";
67
+ id: string;
68
+ }[];
69
+ evidence: {
70
+ title: string | null;
71
+ key: string;
72
+ reference: {
73
+ kind: "project" | "task" | "habit" | "note";
74
+ id: string;
75
+ };
76
+ at: string;
77
+ kind: "task_completed" | "task_started" | "task_reopened" | "task_changed" | "habit_check_in" | "note_changed";
78
+ available: boolean;
79
+ }[];
80
+ priorChecks: {
81
+ key: string;
82
+ cadence: "daily" | "weekly" | "monthly" | "yearly";
83
+ start: string;
84
+ end: string;
85
+ signal: "unknown" | "moving" | "quiet";
86
+ summary: string;
87
+ timeframe: {
88
+ start: string;
89
+ end: string;
90
+ precision: "custom" | "year" | "month" | "quarter";
91
+ timeZone: string;
92
+ };
93
+ }[];
94
+ complete: boolean;
95
+ coverage: {
96
+ sources: {
97
+ provided: number;
98
+ total: number;
99
+ };
100
+ evidence: {
101
+ provided: number;
102
+ total: number;
103
+ };
104
+ priorChecks: {
105
+ provided: number;
106
+ total: number;
107
+ };
108
+ notes: {
109
+ provided: number;
110
+ total: number;
111
+ };
112
+ descriptionsAreExcerpts: boolean;
113
+ };
114
+ };
115
+ //# sourceMappingURL=assessment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assessment.d.ts","sourceRoot":"","sources":["../../src/goals/assessment.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAc1B,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;IAC7D,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8EA"}
@@ -0,0 +1,67 @@
1
+ import { goalReferenceKey, } from '@lucidity/shared';
2
+ function bounded(items, characters, count) {
3
+ const result = [];
4
+ let used = 2;
5
+ for (const item of items) {
6
+ const size = JSON.stringify(item).length + 1;
7
+ if (result.length >= count || used + size > characters)
8
+ break;
9
+ result.push(item);
10
+ used += size;
11
+ }
12
+ return result;
13
+ }
14
+ /** Keep stored evidence intact; send a bounded, explicitly partial view to the model. */
15
+ export function goalAssessmentInput(input) {
16
+ const { detail, period, complete } = input;
17
+ const direct = new Set(detail.links
18
+ .filter((link) => link.state === 'active')
19
+ .map(goalReferenceKey));
20
+ const dated = new Set(input.evidence.map((item) => goalReferenceKey(item.reference)));
21
+ const priority = (source) => direct.has(goalReferenceKey(source))
22
+ ? 0
23
+ : dated.has(goalReferenceKey(source))
24
+ ? 1
25
+ : 2;
26
+ const sources = bounded([...input.sources]
27
+ .sort((a, b) => priority(a) - priority(b) ||
28
+ (b.updatedAt ?? '').localeCompare(a.updatedAt ?? ''))
29
+ .map((source) => ({
30
+ ...source,
31
+ title: source.title.slice(0, 240),
32
+ description: source.description?.slice(0, 600) ?? null,
33
+ })), 30_000, 100);
34
+ const evidence = bounded([...input.evidence]
35
+ .sort((a, b) => b.at.localeCompare(a.at))
36
+ .map((item) => ({ ...item, title: item.title?.slice(0, 240) ?? null })), 15_000, 100);
37
+ const priorChecks = bounded(detail.checks.slice(0, 14).map((check) => ({
38
+ key: check.key,
39
+ cadence: check.cadence,
40
+ start: check.start,
41
+ end: check.end,
42
+ signal: check.signal,
43
+ summary: check.summary.slice(0, 400),
44
+ timeframe: check.timeframe,
45
+ })), 6_000, 14);
46
+ const allNotes = detail.links.filter((link) => link.kind === 'note' && link.state === 'active');
47
+ const notes = bounded(allNotes.map(({ kind, id }) => ({ kind, id })), 3_000, 40);
48
+ return {
49
+ goal: detail.goal,
50
+ period,
51
+ sources,
52
+ notes,
53
+ evidence,
54
+ priorChecks,
55
+ complete,
56
+ coverage: {
57
+ sources: { provided: sources.length, total: input.sources.length },
58
+ evidence: { provided: evidence.length, total: input.evidence.length },
59
+ priorChecks: {
60
+ provided: priorChecks.length,
61
+ total: detail.checks.length,
62
+ },
63
+ notes: { provided: notes.length, total: allNotes.length },
64
+ descriptionsAreExcerpts: true,
65
+ },
66
+ };
67
+ }
@@ -0,0 +1,18 @@
1
+ import { type GoalCandidate } from '@lucidity/shared';
2
+ export interface GoalNote extends GoalCandidate {
3
+ kind: 'note';
4
+ path: string;
5
+ content: string;
6
+ }
7
+ export interface GoalNotes {
8
+ list(): {
9
+ notes: GoalNote[];
10
+ complete: boolean;
11
+ };
12
+ link(note: GoalNote): void;
13
+ read(id: string): GoalNote;
14
+ saveDraft(id: string, markdown: string): void;
15
+ }
16
+ /** Paths and note text never leave this computer for the hosted Goals API. */
17
+ export declare function createGoalNotes(root: string | undefined): GoalNotes | undefined;
18
+ //# sourceMappingURL=notes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../src/goals/notes.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,SAAS,GAAG,SAAS,CAgEvB"}
@@ -0,0 +1,72 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { listNotes, readNote, editNote, writeNote } from '@lucidity/notes';
3
+ import { goalNoteId, withGoalNoteId, } from '@lucidity/shared';
4
+ /** Paths and note text never leave this computer for the hosted Goals API. */
5
+ export function createGoalNotes(root) {
6
+ if (!root)
7
+ return undefined;
8
+ function scan() {
9
+ const summaries = listNotes(root, { limit: 2001 });
10
+ const notes = [];
11
+ let complete = summaries.length <= 2000;
12
+ for (const summary of summaries.slice(0, 2000)) {
13
+ try {
14
+ const note = readNote(root, summary.path);
15
+ notes.push({
16
+ kind: 'note',
17
+ id: goalNoteId(note.content) ?? randomUUID(),
18
+ path: note.path,
19
+ content: note.content,
20
+ title: note.title,
21
+ description: note.body.slice(0, 2000),
22
+ updatedAt: note.mtime,
23
+ status: null,
24
+ projectId: null,
25
+ });
26
+ }
27
+ catch {
28
+ complete = false;
29
+ }
30
+ }
31
+ const counts = new Map();
32
+ notes.forEach((note) => counts.set(note.id, (counts.get(note.id) ?? 0) + 1));
33
+ if ([...counts.values()].some((count) => count > 1))
34
+ complete = false;
35
+ return {
36
+ notes: notes.filter((note) => counts.get(note.id) === 1),
37
+ complete,
38
+ };
39
+ }
40
+ return {
41
+ list: scan,
42
+ link(note) {
43
+ const current = readNote(root, note.path);
44
+ if (current.content !== note.content)
45
+ throw new Error('The note changed during linking. Try again.');
46
+ const next = withGoalNoteId(current.content, note.id);
47
+ if (next !== current.content) {
48
+ if (!current.content)
49
+ throw new Error('Write something in this note before linking it.');
50
+ editNote(root, note.path, current.content, next);
51
+ }
52
+ },
53
+ read(id) {
54
+ const note = scan().notes.find((item) => goalNoteId(item.content) === id);
55
+ if (!note)
56
+ throw new Error('The linked note is not available in this vault.');
57
+ return note;
58
+ },
59
+ saveDraft(id, markdown) {
60
+ const content = withGoalNoteId(markdown, id);
61
+ const path = `Goals/Draft-${id}.md`;
62
+ try {
63
+ writeNote(root, path, content, 'create');
64
+ }
65
+ catch (error) {
66
+ // Idempotent retry of our own exact output; never overwrite a user's edits.
67
+ if (readNote(root, path).content !== content)
68
+ throw error;
69
+ }
70
+ },
71
+ };
72
+ }