minicode-ai 0.11.0 → 0.13.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 (221) hide show
  1. package/CHANGELOG.md +98 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -4
  4. package/cli/args.ts +46 -0
  5. package/cli/commands/acp.ts +163 -10
  6. package/cli/commands/config.ts +33 -18
  7. package/cli/commands/daemon.ts +515 -0
  8. package/cli/commands/exec.ts +145 -53
  9. package/cli/commands/openwork.ts +986 -0
  10. package/cli/commands/sessions.ts +4 -1
  11. package/cli/commands/stats.ts +34 -4
  12. package/cli/commands.ts +217 -2
  13. package/cli/index.ts +146 -14
  14. package/cli/recovery-warning.ts +115 -0
  15. package/cli/router.ts +32 -1
  16. package/cli/setup.ts +2332 -171
  17. package/cli/tui.ts +113 -7
  18. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +489 -0
  19. package/docs/OUTPUT_EVENT_MODEL.md +289 -0
  20. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +391 -0
  21. package/docs/OUTPUT_PROTOCOL_SPEC.md +285 -0
  22. package/docs/OUTPUT_RENDERING_SPEC.md +248 -0
  23. package/docs/OUTPUT_UX_RULES.md +449 -0
  24. package/docs/PLAN_UIUX_V6.md +2 -2
  25. package/docs/README.md +4 -3
  26. package/docs/TERMINAL_CONTRACT.md +278 -66
  27. package/docs/architecture.md +89 -7
  28. package/docs/changelog.md +1 -1
  29. package/docs/choosing-mode.md +2 -2
  30. package/docs/cli.md +9 -5
  31. package/docs/concepts.md +1 -1
  32. package/docs/contributing.md +9 -2
  33. package/docs/environment.md +6 -2
  34. package/docs/exec.md +46 -5
  35. package/docs/memory-sessions.md +2 -0
  36. package/docs/policy-sandbox.md +1 -1
  37. package/docs/pricing-budget.md +1 -1
  38. package/docs/quickstart.md +2 -2
  39. package/docs/repl.md +6 -2
  40. package/docs/security-model.md +1 -1
  41. package/docs/security.md +1 -1
  42. package/docs/skills.md +2 -2
  43. package/docs/terminal.md +9 -5
  44. package/docs/tools.md +1 -1
  45. package/package.json +35 -5
  46. package/src/app/session.ts +261 -15
  47. package/src/app/tool-layer.ts +94 -7
  48. package/src/daemon/approvals.ts +361 -0
  49. package/src/daemon/capability.ts +145 -0
  50. package/src/daemon/children.ts +142 -0
  51. package/src/daemon/client.ts +267 -0
  52. package/src/daemon/control.ts +350 -0
  53. package/src/daemon/discovery.ts +234 -0
  54. package/src/daemon/feed.ts +155 -0
  55. package/src/daemon/framing.ts +94 -0
  56. package/src/daemon/host.ts +316 -0
  57. package/src/daemon/protocol.ts +217 -0
  58. package/src/daemon/resource.ts +170 -0
  59. package/src/daemon/sanitize.ts +57 -0
  60. package/src/daemon/server.ts +627 -0
  61. package/src/daemon/store.ts +317 -0
  62. package/src/daemon/subscription.ts +270 -0
  63. package/src/daemon/telemetry.ts +81 -0
  64. package/src/hooks/run.ts +12 -1
  65. package/src/lib/atomic-write.ts +29 -3
  66. package/src/lib/db-path.ts +26 -0
  67. package/src/lib/keystore.ts +544 -42
  68. package/src/lib/net.ts +43 -1
  69. package/src/lib/safe-open.ts +116 -1
  70. package/src/lib/session-id.ts +15 -0
  71. package/src/lsp/client.ts +123 -5
  72. package/src/mcp/client.ts +139 -17
  73. package/src/mcp/server.ts +177 -50
  74. package/src/mcp/transport.ts +16 -19
  75. package/src/memory/vector.ts +770 -55
  76. package/src/policy/allowlist.ts +14 -2
  77. package/src/policy/bash-guard.ts +105 -10
  78. package/src/policy/compaction.ts +82 -5
  79. package/src/policy/consequence-engine.ts +220 -0
  80. package/src/policy/context.ts +132 -0
  81. package/src/policy/executor.ts +187 -121
  82. package/src/policy/no-progress.ts +559 -0
  83. package/src/policy/permission.ts +4 -8
  84. package/src/policy/pricing.ts +17 -3
  85. package/src/policy/scrub.ts +69 -2
  86. package/src/policy/tool-contract.ts +515 -0
  87. package/src/policy/usage.ts +310 -24
  88. package/src/policy/verifier.ts +6 -3
  89. package/src/policy/work-mode.ts +182 -0
  90. package/src/presentation/adapter.ts +533 -26
  91. package/src/presentation/events.ts +151 -0
  92. package/src/presentation/model.ts +180 -27
  93. package/src/presentation/projection.ts +858 -0
  94. package/src/presentation/reducer.ts +645 -310
  95. package/src/presentation/store.ts +12 -7
  96. package/src/providers/anthropic.ts +18 -10
  97. package/src/providers/responses.ts +17 -7
  98. package/src/runtime/capability.ts +409 -0
  99. package/src/runtime/child-execution.ts +274 -0
  100. package/src/runtime/composition.ts +958 -0
  101. package/src/runtime/dispatch.ts +591 -0
  102. package/src/runtime/execution-backend.ts +632 -0
  103. package/src/runtime/execution-events.ts +272 -0
  104. package/src/runtime/execution-id.ts +230 -0
  105. package/src/runtime/execution-journal.ts +926 -0
  106. package/src/runtime/execution-kernel.ts +456 -0
  107. package/src/runtime/execution-registry.ts +379 -0
  108. package/src/runtime/process-supervision.ts +276 -0
  109. package/src/runtime/production-execution.ts +551 -0
  110. package/src/runtime/production-runtime.ts +217 -0
  111. package/src/runtime/recovery-safety.ts +70 -0
  112. package/src/runtime/recovery.ts +477 -0
  113. package/src/runtime/runtime-capabilities.ts +179 -0
  114. package/src/runtime/runtime-diagnostics.ts +141 -0
  115. package/src/runtime/runtime-host.ts +365 -0
  116. package/src/runtime/runtime-status-facts.ts +222 -0
  117. package/src/runtime/runtime-status-provider.ts +74 -0
  118. package/src/runtime/runtime-status.ts +459 -0
  119. package/src/runtime/runtime-task-admission.ts +101 -0
  120. package/src/runtime/supervisor.ts +444 -0
  121. package/src/session/authority.ts +168 -0
  122. package/src/session/checkpoint.ts +88 -1
  123. package/src/session/context-adapter.ts +251 -0
  124. package/src/session/context-assembly.ts +242 -0
  125. package/src/session/context-identity.ts +389 -0
  126. package/src/session/context-projection.ts +248 -0
  127. package/src/session/context-selector.ts +500 -0
  128. package/src/session/cross-session-adoption.ts +249 -0
  129. package/src/session/full-history-fold.ts +171 -0
  130. package/src/session/identity.ts +192 -0
  131. package/src/session/journal.ts +805 -102
  132. package/src/session/open-work-intent.ts +732 -0
  133. package/src/session/open-work.ts +767 -0
  134. package/src/session/pending-tools.ts +94 -0
  135. package/src/session/persistence.ts +3569 -127
  136. package/src/session/runtime-header.ts +208 -0
  137. package/src/session/shadow-git.ts +13 -5
  138. package/src/session/verification.ts +1623 -0
  139. package/src/task/assignment.ts +136 -0
  140. package/src/task/autonomous-adapter.ts +168 -0
  141. package/src/task/autonomous-context.ts +630 -0
  142. package/src/task/autonomous-policy.ts +490 -0
  143. package/src/task/continuity.ts +179 -0
  144. package/src/task/execution-cancellation.ts +165 -0
  145. package/src/task/graph-validate.ts +379 -0
  146. package/src/task/graph.ts +305 -0
  147. package/src/task/identity.ts +230 -0
  148. package/src/task/model.ts +417 -0
  149. package/src/task/production-scheduler.ts +293 -0
  150. package/src/task/readiness.ts +229 -0
  151. package/src/task/scheduler-observability.ts +387 -0
  152. package/src/task/scheduler.ts +1197 -0
  153. package/src/task/scheduling-policy.ts +165 -0
  154. package/src/task/session-authority.ts +148 -0
  155. package/src/task/session-ownership.ts +211 -0
  156. package/src/task/store.ts +2887 -0
  157. package/src/task/sync.ts +343 -0
  158. package/src/task/trigger.ts +260 -0
  159. package/src/tools/bash.ts +377 -211
  160. package/src/tools/code_run.ts +1 -1
  161. package/src/tools/delete_file.ts +1 -1
  162. package/src/tools/edit.ts +33 -6
  163. package/src/tools/evidence.ts +30 -0
  164. package/src/tools/git.ts +4 -4
  165. package/src/tools/glob.ts +12 -3
  166. package/src/tools/grep.ts +1 -1
  167. package/src/tools/lsp.ts +4 -4
  168. package/src/tools/mcp_call.ts +11 -4
  169. package/src/tools/memory.ts +153 -18
  170. package/src/tools/move_file.ts +1 -1
  171. package/src/tools/patch.ts +1 -1
  172. package/src/tools/read_file.ts +1 -1
  173. package/src/tools/read_image.ts +1 -1
  174. package/src/tools/submit_result.ts +1 -1
  175. package/src/tools/task.ts +437 -41
  176. package/src/tools/todo.ts +662 -35
  177. package/src/tools/web_fetch.ts +4 -2
  178. package/src/tools/web_search.ts +9 -3
  179. package/src/tools/write_file.ts +1 -1
  180. package/src/ui/assistant/simple.ts +123 -50
  181. package/src/ui/assistant/turn-status.ts +17 -3
  182. package/src/ui/contract.ts +184 -0
  183. package/src/ui/footer.ts +54 -18
  184. package/src/ui/i18n/en.ts +62 -6
  185. package/src/ui/i18n/id.ts +62 -6
  186. package/src/ui/input/prompt-engine.ts +120 -25
  187. package/src/ui/render/errors.ts +39 -1
  188. package/src/ui/render/markdown-table.ts +455 -0
  189. package/src/ui/render/markdown.ts +22 -1
  190. package/src/ui/render/table-grid.ts +184 -0
  191. package/src/ui/render/table.ts +15 -76
  192. package/src/ui/runtime/screen.ts +7 -2
  193. package/src/ui/runtime/statusline.ts +25 -6
  194. package/src/ui/tui/app.ts +598 -133
  195. package/src/ui/tui/transcript.ts +531 -89
  196. package/vendor/minicore/VENDOR.md +1 -1
  197. package/vendor/minicore/src/core/budget.ts +25 -25
  198. package/vendor/minicore/src/core/compact.ts +75 -75
  199. package/vendor/minicore/src/core/errors.ts +59 -59
  200. package/vendor/minicore/src/core/events.ts +73 -73
  201. package/vendor/minicore/src/core/executor.ts +139 -139
  202. package/vendor/minicore/src/core/history.ts +31 -31
  203. package/vendor/minicore/src/core/index.ts +41 -41
  204. package/vendor/minicore/src/core/loop.ts +355 -355
  205. package/vendor/minicore/src/core/permission.ts +22 -22
  206. package/vendor/minicore/src/core/provider.ts +39 -39
  207. package/vendor/minicore/src/core/recovery.ts +35 -35
  208. package/vendor/minicore/src/core/session.ts +327 -327
  209. package/vendor/minicore/src/core/snapshot.ts +146 -146
  210. package/vendor/minicore/src/core/tokens.ts +107 -107
  211. package/vendor/minicore/src/core/tool.ts +115 -115
  212. package/vendor/minicore/src/core/types.ts +50 -50
  213. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
  214. package/AGENTS.md +0 -45
  215. package/PLAN.md +0 -491
  216. package/docs/ARCHITECTURE.html +0 -1248
  217. package/docs/CONTROL-PLANE-MAP.md +0 -139
  218. package/docs/HARNESS.md +0 -150
  219. package/docs/SUMMARY.md +0 -52
  220. package/docs/UI_RENDER_PIPELINE.md +0 -165
  221. package/docs/USAGE.md +0 -11
@@ -0,0 +1,732 @@
1
+ // P14.1/P14.2 — kontrak intent terstruktur + ekstraksi histori berprovenance.
2
+ //
3
+ // BATAS KERAS modul ini:
4
+ //
5
+ // 1. READ-ONLY. Tidak ada INSERT/UPDATE/DELETE, tidak ada lease, tidak ada
6
+ // scheduler. Ia membaca artefak durable yang SUDAH ada.
7
+ // 2. Intent HANYA berasal dari artefak terstruktur. Pesan bebas pengguna
8
+ // (`user.message`) TIDAK PERNAH dipindai untuk "janji" atau "komitmen".
9
+ // Roadmap P14 melarang menganggap brainstorming sebagai tugas; menebak
10
+ // komitmen dari prosa adalah pelanggaran batas itu, bukan fitur.
11
+ // 3. Kategori yang tidak bisa dibuktikan = UNKNOWN. Tidak ada kategori yang
12
+ // ditebak dari judul, kata kunci, atau kemiripan teks.
13
+ //
14
+ // Sumber intent yang diakui (semuanya eksplisit, semuanya durable):
15
+ //
16
+ // plan.updated langkah rencana yang masih pending/active/blocked
17
+ // approval.requested + approval.settled
18
+ // menunggu jawaban pengguna / ditolak pengguna
19
+ // delegation (sesi anak dengan parent_session_id)
20
+ // pekerjaan yang diserahkan ke sub-agent
21
+ // run INTERRUPTED eksekusi terputus tanpa hasil terminal
22
+ //
23
+ // Modul ini TIDAK menyentuh TaskStore sama sekali. Penggabungan dengan task
24
+ // kanonik dilakukan oleh proyeksi (`open-work.ts`), dan hanya sebagai
25
+ // penanda/provenance — tidak pernah sebagai perubahan status.
26
+
27
+ import type { DomainEvent } from "../presentation/events.ts"
28
+ import type { TaskStatus, TaskVerification } from "../task/model.ts"
29
+
30
+ /** Kategori intent yang dikontrak P14.1. */
31
+ export type OpenWorkState =
32
+ | "OPEN"
33
+ | "PARTIAL"
34
+ | "BLOCKED"
35
+ | "WAITING_FOR_USER"
36
+ | "DELEGATED"
37
+ | "FAILED_NEEDS_FOLLOWUP"
38
+ | "UNKNOWN"
39
+ | "COMPLETED"
40
+ | "CANCELLED"
41
+ | "DECLINED"
42
+
43
+ /** Jenis bukti yang boleh menghasilkan kandidat. */
44
+ export type CommitmentSource = "TASK" | "PLAN_STEP" | "APPROVAL" | "DELEGATION" | "RUN"
45
+
46
+ /**
47
+ * Satu kandidat intent dari histori.
48
+ *
49
+ * `taskId` hanya diisi bila artefak SENDIRI membawa id kanonik (mis. langkah
50
+ * `plan.updated` payloadVersion=2). Modul ini tidak pernah mencocokkan judul
51
+ * ke task — itu pekerjaan rekonsiliasi proyeksi, dan hasilnya tetap penanda.
52
+ */
53
+ export interface IntentCandidate {
54
+ readonly source: CommitmentSource
55
+ readonly state: OpenWorkState
56
+ readonly sessionId: string
57
+ readonly taskId: string | null
58
+ /** Ringkasan pendek yang aman tampil; bukan salinan seluruh riwayat. */
59
+ readonly summary: string
60
+ /** Bukti asal yang dapat ditelusuri. */
61
+ readonly provenance: IntentProvenance
62
+ /** Alasan state; selalu eksplisit, tidak pernah kosong. */
63
+ readonly reason: string
64
+ /** Status mentah artefak sumber (mis. "active", "deny") — provenance, bukan state. */
65
+ readonly artifactStatus: string | null
66
+ readonly observedAtIso: string
67
+ /** Apakah kandidat ini sudah tertutup secara terminal. */
68
+ readonly terminal: boolean
69
+ }
70
+
71
+ export interface IntentProvenance {
72
+ readonly sessionId: string
73
+ readonly eventSeq: number | null
74
+ readonly turnId: number | null
75
+ readonly planId: string | null
76
+ readonly stepId: string | null
77
+ readonly approvalId: string | null
78
+ readonly childSessionId: string | null
79
+ readonly runId: string | null
80
+ readonly taskId: string | null
81
+ }
82
+
83
+ /** Ringkasan inventaris sesi/artefak (P14.0). */
84
+ export interface WorkInventory {
85
+ readonly workspace: string
86
+ readonly sessions: {
87
+ readonly total: number
88
+ readonly inScope: number
89
+ readonly foreignWorkspace: number
90
+ readonly unboundWorkspace: number
91
+ readonly childSessions: number
92
+ }
93
+ readonly tasks: {
94
+ readonly total: number
95
+ readonly open: number
96
+ readonly terminal: number
97
+ }
98
+ readonly presentationEvents: {
99
+ readonly total: number
100
+ readonly byType: Readonly<Record<string, number>>
101
+ }
102
+ readonly runs: {
103
+ readonly total: number
104
+ readonly active: number
105
+ readonly interrupted: number
106
+ readonly terminal: number
107
+ }
108
+ readonly checkpoints: {
109
+ readonly sessionsWithManifest: number
110
+ readonly entries: number
111
+ readonly corrupt: number
112
+ }
113
+ readonly plans: {
114
+ readonly events: number
115
+ readonly openSteps: number
116
+ readonly closedSteps: number
117
+ }
118
+ readonly approvals: {
119
+ readonly requested: number
120
+ readonly settled: number
121
+ readonly pending: number
122
+ }
123
+ readonly subAgents: {
124
+ readonly childSessions: number
125
+ readonly resultsProduced: number
126
+ readonly failedTurns: number
127
+ }
128
+ readonly excludedSessions: readonly {
129
+ readonly sessionId: string
130
+ readonly reason: "FOREIGN_WORKSPACE" | "UNBOUND_WORKSPACE"
131
+ }[]
132
+ }
133
+
134
+ /** Baris sesi yang sudah dinormalisasi untuk inventaris. */
135
+ export interface WorkSessionRow {
136
+ readonly id: string
137
+ readonly createdAtMs: number
138
+ readonly updatedAtMs: number
139
+ readonly cwd: string | null
140
+ readonly parentSessionId: string | null
141
+ }
142
+
143
+ export interface ExtractIntentOptions {
144
+ readonly workspace: string
145
+ readonly sessions: readonly WorkSessionRow[]
146
+ readonly events: readonly DomainEvent[]
147
+ readonly runs: readonly WorkRunRow[]
148
+ /** Batas kandidat per sumber; mencegah portofolio tumbuh tanpa batas. */
149
+ readonly maxCandidates?: number
150
+ }
151
+
152
+ export interface WorkRunRow {
153
+ readonly runId: string
154
+ readonly sessionId: string
155
+ readonly status: "CREATED" | "RUNNING" | "COMPLETED" | "INTERRUPTED" | "FAILED"
156
+ readonly startedAtMs: number
157
+ readonly endedAtMs: number | null
158
+ readonly recoveryStatus: string | null
159
+ }
160
+
161
+ const DEFAULT_MAX_CANDIDATES = 500
162
+
163
+ /**
164
+ * Batas cakupan pencarian (P14.0).
165
+ *
166
+ * Sesi milik SATU workspace dibandingkan lewat `cwd` yang tersimpan di baris
167
+ * sesi. Sesi tanpa `cwd` (warisan pra-binding) TIDAK ditebak sebagai milik
168
+ * workspace ini — ia dilaporkan sebagai `UNBOUND_WORKSPACE` dan dikeluarkan,
169
+ * karena menganggapnya "milik sini" adalah klaim yang tidak bisa dibuktikan.
170
+ * Perbandingan path case-insensitive di Windows adalah kenyataan filesystem,
171
+ * bukan preferensi.
172
+ */
173
+ export type SessionScope = "IN_SCOPE" | "FOREIGN_WORKSPACE" | "UNBOUND_WORKSPACE"
174
+
175
+ export function scopeSession(
176
+ workspace: string,
177
+ sessionCwd: string | null | undefined,
178
+ ): SessionScope {
179
+ // Baris legacy boleh membawa NULL (bentuk lama pra-binding): itu bukan
180
+ // milik workspace ini dan tidak boleh melempar — UNBOUND, gagal-jujur.
181
+ if (sessionCwd === null || sessionCwd === undefined || sessionCwd.trim() === "")
182
+ return "UNBOUND_WORKSPACE"
183
+ const norm = (p: string): string => {
184
+ const stripped = p.replace(/[\\/]+$/, "").replace(/\\/g, "/")
185
+ return process.platform === "win32" ? stripped.toLowerCase() : stripped
186
+ }
187
+ return norm(sessionCwd) === norm(workspace) ? "IN_SCOPE" : "FOREIGN_WORKSPACE"
188
+ }
189
+
190
+ /**
191
+ * Klasifikasi cakupan SELURUH sesi, termasuk sesi anak sub-agent.
192
+ *
193
+ * `createChildSession` menulis baris anak TANPA binding cwd sendiri (cwd='');
194
+ * satu-satunya bukti workspace anak adalah lineage-nya. Maka: anak mewarisi
195
+ * klasifikasi leluhur TERMULAIKANNYA (yang punya binding). Tanpa aturan ini,
196
+ * seluruh hasil sub-agent — yang roadmap P14 eksplisit masukkan — tidak
197
+ * terlihat oleh inventaris/ekstraksi.
198
+ *
199
+ * Lineage korup (siklus) gagal-jujur: sesi dalam siklus diklasifikasikan
200
+ * dari bindingnya sendiri (biasanya UNBOUND), tidak pernah menggantung
201
+ * tak-terbatas.
202
+ */
203
+ export function classifySessionScopes(
204
+ workspace: string,
205
+ sessions: readonly WorkSessionRow[],
206
+ ): Map<string, SessionScope> {
207
+ const byId = new Map(sessions.map((s) => [s.id, s]))
208
+ const cache = new Map<string, SessionScope>()
209
+ const classify = (s: WorkSessionRow, seen: ReadonlySet<string>): SessionScope => {
210
+ const memo = cache.get(s.id)
211
+ if (memo !== undefined) return memo
212
+ if (s.parentSessionId !== null && !seen.has(s.id)) {
213
+ const parent = byId.get(s.parentSessionId)
214
+ const scope =
215
+ parent !== undefined
216
+ ? classify(parent, new Set([...seen, s.id]))
217
+ : scopeSession(workspace, s.cwd) // induk tak ada di inventaris: binding sendiri
218
+ cache.set(s.id, scope)
219
+ return scope
220
+ }
221
+ const scope = scopeSession(workspace, s.cwd)
222
+ cache.set(s.id, scope)
223
+ return scope
224
+ }
225
+ const out = new Map<string, SessionScope>()
226
+ for (const s of sessions) out.set(s.id, classify(s, new Set()))
227
+ return out
228
+ }
229
+
230
+ const TERMINAL_STATES: ReadonlySet<OpenWorkState> = new Set(["COMPLETED", "CANCELLED", "DECLINED"])
231
+
232
+ export function isTerminalIntentState(state: OpenWorkState): boolean {
233
+ return TERMINAL_STATES.has(state)
234
+ }
235
+
236
+ /** Potong ringkasan agar portofolio tidak menyimpan salinan riwayat. */
237
+ function clip(text: string, max = 120): string {
238
+ const oneLine = text.replace(/\s+/g, " ").trim()
239
+ return oneLine.length <= max ? oneLine : `${oneLine.slice(0, max - 1)}…`
240
+ }
241
+
242
+ function provenanceOf(
243
+ sessionId: string,
244
+ ev: DomainEvent | null,
245
+ extra: Partial<IntentProvenance> = {},
246
+ ): IntentProvenance {
247
+ return {
248
+ sessionId,
249
+ eventSeq: ev?.eventSeq ?? null,
250
+ turnId: ev?.turnId ?? null,
251
+ planId: null,
252
+ stepId: null,
253
+ approvalId: null,
254
+ childSessionId: null,
255
+ runId: null,
256
+ taskId: null,
257
+ ...extra,
258
+ }
259
+ }
260
+
261
+ /**
262
+ * Status langkah plan → state intent.
263
+ *
264
+ * `active` = PARTIAL (dikerjakan, belum tuntas), `pending` = OPEN,
265
+ * `blocked` = BLOCKED. `completed`/`cancelled` adalah terminal dan TIDAK
266
+ * dipromosikan kembali menjadi open (larangan P14).
267
+ */
268
+ export function planStepState(status: string): OpenWorkState {
269
+ switch (status) {
270
+ case "active":
271
+ return "PARTIAL"
272
+ case "pending":
273
+ return "OPEN"
274
+ case "blocked":
275
+ return "BLOCKED"
276
+ case "completed":
277
+ return "COMPLETED"
278
+ case "cancelled":
279
+ return "CANCELLED"
280
+ default:
281
+ // Status asing = tidak bisa dibuktikan. Jangan menebak.
282
+ return "UNKNOWN"
283
+ }
284
+ }
285
+
286
+ /** Pastikan kandidat tidak pernah melebihi batas tanpa terlihat. */
287
+ function push(candidates: IntentCandidate[], cand: IntentCandidate, max: number): boolean {
288
+ if (candidates.length >= max) return false
289
+ candidates.push(cand)
290
+ return true
291
+ }
292
+
293
+ function extractPlanSteps(
294
+ events: readonly DomainEvent[],
295
+ inScope: ReadonlySet<string>,
296
+ out: IntentCandidate[],
297
+ max: number,
298
+ ): void {
299
+ // `plan.updated` adalah SNAPSHOT, bukan delta: adaptor menerbitkannya setiap
300
+ // `todo_write` sukses dengan SELURUH daftar langkah sesi. Tanpa kolaps, satu
301
+ // langkah muncul sekali per snapshot — versi lama (pending/active) tetap
302
+ // tampil sebagai kandidat duplikat di samping status terbaru, dan portofolio
303
+ // menduplikasi riwayat.
304
+ //
305
+ // Kunci kolaps = SESI, bukan `planId`: `planId` memuat nomor turn
306
+ // (`plan:<session>:<turn>`), sementara daftar todo adalah milik SESI. Langkah
307
+ // pending yang sama akan muncul lagi di snapshot turn berikutnya, jadi
308
+ // mengunci per-planId tetap menduplikasi riwayat lintas turn. Snapshot
309
+ // TERAKHIR per sesi adalah kebenaran terkini: ia menggantikan snapshot
310
+ // sebelumnya, termasuk langkah yang sudah dihapus dari daftar.
311
+ const latest = new Map<string, DomainEvent & { type: "plan.updated" }>()
312
+ for (const ev of events) {
313
+ if (ev.type !== "plan.updated") continue
314
+ if (!inScope.has(ev.sessionId)) continue
315
+ const prev = latest.get(ev.sessionId)
316
+ // eventSeq adalah urutan append durable; `>=` membuat posisi baca terakhir
317
+ // menang bila seq sama (tidak ada urutan lain yang lebih kuat).
318
+ if (prev === undefined || ev.eventSeq >= prev.eventSeq) latest.set(ev.sessionId, ev)
319
+ }
320
+ for (const ev of latest.values()) {
321
+ for (const step of ev.steps) {
322
+ const state = planStepState(step.status)
323
+ const canonical = typeof step.taskId === "string" ? step.taskId : null
324
+ if (
325
+ !push(
326
+ out,
327
+ {
328
+ source: "PLAN_STEP",
329
+ state,
330
+ sessionId: ev.sessionId,
331
+ taskId: canonical,
332
+ summary: clip(step.title ?? step.stepId),
333
+ provenance: provenanceOf(ev.sessionId, ev, {
334
+ planId: ev.planId,
335
+ stepId: step.stepId,
336
+ taskId: canonical,
337
+ }),
338
+ reason: `plan step status=${step.status}`,
339
+ observedAtIso: new Date(ev.ts).toISOString(),
340
+ artifactStatus: step.status,
341
+ terminal: isTerminalIntentState(state),
342
+ },
343
+ max,
344
+ )
345
+ )
346
+ return
347
+ }
348
+ }
349
+ }
350
+
351
+ function extractApprovals(
352
+ events: readonly DomainEvent[],
353
+ inScope: ReadonlySet<string>,
354
+ out: IntentCandidate[],
355
+ max: number,
356
+ ): void {
357
+ // Permintaan persetujuan tanpa `settled` = WAITING_FOR_USER. `settled` dengan
358
+ // deny = DECLINED (terminal): penolakan pengguna TIDAK boleh hidup lagi
359
+ // sebagai open loop.
360
+ const settled = new Map<string, DomainEvent & { type: "approval.settled" }>()
361
+ for (const ev of events) {
362
+ if (ev.type === "approval.settled") settled.set(`${ev.sessionId}\u0000${ev.approvalId}`, ev)
363
+ }
364
+ for (const ev of events) {
365
+ if (ev.type !== "approval.requested") continue
366
+ if (!inScope.has(ev.sessionId)) continue
367
+ const answer = settled.get(`${ev.sessionId}\u0000${ev.approvalId}`)
368
+ // "allow" BUKAN bukti pekerjaan selesai — hanya bukti izin diberikan.
369
+ // Memalsukan COMPLETED di sini melanggar larangan "jangan diam-diam
370
+ // membuat status selesai". Approval yang di-allow TIDAK menghasilkan
371
+ // kandidat; loop-nya tertutup tanpa klaim penyelesaian.
372
+ if (answer !== undefined && answer.outcome.decision !== "deny") continue
373
+ const state: OpenWorkState = answer === undefined ? "WAITING_FOR_USER" : "DECLINED"
374
+ const reason =
375
+ answer === undefined
376
+ ? "approval requested, no settled outcome"
377
+ : `approval denied by ${answer.outcome.by}`
378
+ const summary = clip(`approval ${ev.identity.qualified}: ${ev.argsSummary.text}`)
379
+ if (
380
+ !push(
381
+ out,
382
+ {
383
+ source: "APPROVAL",
384
+ state,
385
+ sessionId: ev.sessionId,
386
+ taskId: null,
387
+ summary,
388
+ provenance: provenanceOf(ev.sessionId, ev, { approvalId: ev.approvalId }),
389
+ reason,
390
+ observedAtIso: new Date(ev.ts).toISOString(),
391
+ artifactStatus: answer === undefined ? "requested" : "deny",
392
+ terminal: isTerminalIntentState(state),
393
+ },
394
+ max,
395
+ )
396
+ )
397
+ return
398
+ }
399
+ }
400
+
401
+ function extractDelegations(
402
+ sessions: readonly WorkSessionRow[],
403
+ events: readonly DomainEvent[],
404
+ inScope: ReadonlySet<string>,
405
+ out: IntentCandidate[],
406
+ max: number,
407
+ ): void {
408
+ // Sesi anak = pekerjaan yang DISERAHKAN. Hasilnya dibaca dari artefak
409
+ // eksplisit: `result.produced` (terminal-ish) dan `turn.failed`. Sesi anak
410
+ // tanpa hasil terminal = DELEGATED (belum selesai), bukan sukses diam-diam.
411
+ const produced = new Map<string, DomainEvent>()
412
+ const failed = new Map<string, DomainEvent>()
413
+ for (const ev of events) {
414
+ if (ev.type === "result.produced") produced.set(ev.sessionId, ev)
415
+ if (ev.type === "turn.failed") failed.set(ev.sessionId, ev)
416
+ }
417
+ for (const s of sessions) {
418
+ if (s.parentSessionId === null) continue
419
+ if (!inScope.has(s.id)) continue
420
+ const result = produced.get(s.id)
421
+ const failure = failed.get(s.id)
422
+ let state: OpenWorkState
423
+ let reason: string
424
+ let ev: DomainEvent | null = null
425
+ if (result !== undefined && result.type === "result.produced") {
426
+ ev = result
427
+ state =
428
+ result.status === "completed"
429
+ ? "COMPLETED"
430
+ : result.status === "failed"
431
+ ? "FAILED_NEEDS_FOLLOWUP"
432
+ : "CANCELLED"
433
+ reason = `delegated result ${result.status}`
434
+ } else if (failure !== undefined && failure.type === "turn.failed") {
435
+ ev = failure
436
+ state = "FAILED_NEEDS_FOLLOWUP"
437
+ reason = `delegated turn failed (${failure.error.cause})`
438
+ } else {
439
+ state = "DELEGATED"
440
+ reason = "delegated child session has no terminal result"
441
+ }
442
+ if (
443
+ !push(
444
+ out,
445
+ {
446
+ source: "DELEGATION",
447
+ state,
448
+ sessionId: s.id,
449
+ taskId: null,
450
+ summary: clip(`delegated to ${s.id}`),
451
+ provenance: provenanceOf(s.id, ev, { childSessionId: s.id }),
452
+ reason,
453
+ observedAtIso: new Date(ev?.ts ?? s.updatedAtMs).toISOString(),
454
+ artifactStatus:
455
+ result !== undefined && result.type === "result.produced"
456
+ ? result.status
457
+ : failure !== undefined && failure.type === "turn.failed"
458
+ ? "turn.failed"
459
+ : "open",
460
+ terminal: isTerminalIntentState(state),
461
+ },
462
+ max,
463
+ )
464
+ )
465
+ return
466
+ }
467
+ }
468
+
469
+ function extractRuns(
470
+ runs: readonly WorkRunRow[],
471
+ inScope: ReadonlySet<string>,
472
+ out: IntentCandidate[],
473
+ max: number,
474
+ ): void {
475
+ // RUNNING tidak dilaporkan sebagai open loop: runtime hidup adalah keadaan
476
+ // normal, bukan pekerjaan yang terlupa. INTERRUPTED-lah yang meninggalkan
477
+ // pekerjaan setengah jadi, dan itu dilabel jujur (bukan UNKNOWN sukses).
478
+ for (const r of runs) {
479
+ if (!inScope.has(r.sessionId)) continue
480
+ if (r.status !== "INTERRUPTED") continue
481
+ if (
482
+ !push(
483
+ out,
484
+ {
485
+ source: "RUN",
486
+ state: "FAILED_NEEDS_FOLLOWUP",
487
+ sessionId: r.sessionId,
488
+ taskId: null,
489
+ summary: clip(`interrupted run ${r.runId}`),
490
+ provenance: provenanceOf(r.sessionId, null, { runId: r.runId }),
491
+ reason: `run interrupted (recovery=${r.recoveryStatus ?? "NONE"})`,
492
+ observedAtIso: new Date(r.endedAtMs ?? r.startedAtMs).toISOString(),
493
+ artifactStatus: r.status,
494
+ terminal: false,
495
+ },
496
+ max,
497
+ )
498
+ )
499
+ return
500
+ }
501
+ }
502
+
503
+ /**
504
+ * Kandidat intent dari seluruh artefak terstruktur, dalam urutan deterministik.
505
+ *
506
+ * Batas `maxCandidates` dipakai bersama oleh semua sumber supaya portofolio
507
+ * tidak bisa tumbuh tanpa batas dari sesi dengan ribuan event.
508
+ */
509
+ export function extractIntentCandidates(opts: ExtractIntentOptions): IntentCandidate[] {
510
+ const max = opts.maxCandidates ?? DEFAULT_MAX_CANDIDATES
511
+ const inScope = new Set(
512
+ [...classifySessionScopes(opts.workspace, opts.sessions)]
513
+ .filter(([, scope]) => scope === "IN_SCOPE")
514
+ .map(([id]) => id),
515
+ )
516
+
517
+ const out: IntentCandidate[] = []
518
+ extractPlanSteps(opts.events, inScope, out, max)
519
+ if (out.length < max) extractApprovals(opts.events, inScope, out, max)
520
+ if (out.length < max) extractDelegations(opts.sessions, opts.events, inScope, out, max)
521
+ if (out.length < max) extractRuns(opts.runs, inScope, out, max)
522
+ out.sort((a, b) => {
523
+ const at = Date.parse(a.observedAtIso)
524
+ const bt = Date.parse(b.observedAtIso)
525
+ if (at !== bt) return bt - at
526
+ const ak = `${a.sessionId}\u0000${a.provenance.eventSeq ?? -1}\u0000${a.summary}`
527
+ const bk = `${b.sessionId}\u0000${b.provenance.eventSeq ?? -1}\u0000${b.summary}`
528
+ return ak < bk ? -1 : ak > bk ? 1 : 0
529
+ })
530
+ return out
531
+ }
532
+
533
+ // ── P14.1/P14.4 — derivasi state, prioritas, dan next action (MURNI) ────────
534
+
535
+ /**
536
+ * State P14.1 untuk task kanonik. Pemetaan mekanis + dua override berbasis
537
+ * bukti eksplisit: verifikasi gagal dan dependensi tak tuntas. Tidak ada
538
+ * tebakan dari judul.
539
+ */
540
+ export function taskWorkState(
541
+ status: TaskStatus,
542
+ evidence: { verification?: TaskVerification | null; unresolvedDependency?: boolean } = {},
543
+ ): { state: OpenWorkState; reason: string } {
544
+ if (evidence.verification?.verdict === "failed") {
545
+ return { state: "FAILED_NEEDS_FOLLOWUP", reason: "verification failed" }
546
+ }
547
+ if (evidence.unresolvedDependency === true) {
548
+ return { state: "BLOCKED", reason: "depends on unfinished work" }
549
+ }
550
+ switch (status) {
551
+ case "PENDING":
552
+ return { state: "OPEN", reason: "task pending" }
553
+ case "IN_PROGRESS":
554
+ return { state: "PARTIAL", reason: "task in progress" }
555
+ case "VERIFYING":
556
+ return { state: "PARTIAL", reason: "task awaiting verification" }
557
+ case "BLOCKED":
558
+ return { state: "BLOCKED", reason: "task blocked" }
559
+ case "FAILED":
560
+ return { state: "FAILED_NEEDS_FOLLOWUP", reason: "task failed" }
561
+ case "RETRYING":
562
+ return { state: "FAILED_NEEDS_FOLLOWUP", reason: "task retrying after failure" }
563
+ default:
564
+ // Fail-closed: status terminal tidak punya state open. Menyimpulkan
565
+ // kategori open dari status tertutup adalah bug, bukan fitur.
566
+ throw new Error(`open-work-intent: terminal status has no open state: ${status}`)
567
+ }
568
+ }
569
+
570
+ /** Tingkat prioritas portofolio — heuristik presentasi, BUKAN otoritas. */
571
+ export type WorkPriorityLevel = "P0" | "P1" | "P2" | "P3"
572
+
573
+ const STATE_RANK: Readonly<Record<OpenWorkState, number>> = {
574
+ BLOCKED: 0,
575
+ FAILED_NEEDS_FOLLOWUP: 0,
576
+ WAITING_FOR_USER: 1,
577
+ DELEGATED: 1,
578
+ UNKNOWN: 1,
579
+ PARTIAL: 2,
580
+ OPEN: 3,
581
+ COMPLETED: 4,
582
+ CANCELLED: 4,
583
+ DECLINED: 4,
584
+ }
585
+
586
+ export function workPriority(
587
+ state: OpenWorkState,
588
+ stale: boolean,
589
+ ): { level: WorkPriorityLevel; reason: string } {
590
+ const rank = STATE_RANK[state]
591
+ // Item stale dinaikkan SATU tingkat: umur adalah sinyal, bukan bukti, dan
592
+ // tidak pernah melompati item yang gagal/terblokir.
593
+ const boosted = stale && rank > 0 ? rank - 1 : rank
594
+ const level = (
595
+ boosted === 0 ? "P0" : boosted === 1 ? "P1" : boosted === 2 ? "P2" : "P3"
596
+ ) as WorkPriorityLevel
597
+ const reason = stale && rank > 0 ? `${state} (stale, boosted)` : `${state}`
598
+ return { level, reason }
599
+ }
600
+
601
+ /**
602
+ * Next action eksplisit per state. Tidak ada yang otomatis: setiap nilai
603
+ * mengarah ke jalur otoritas yang sudah ada (lifecycle TaskStore, jawaban
604
+ * approval di sesi sumber, atau inspeksi operator).
605
+ */
606
+ export function nextActionFor(state: OpenWorkState, detail = ""): string {
607
+ const suffix = detail.trim().length > 0 ? ` — ${detail.trim()}` : ""
608
+ switch (state) {
609
+ case "OPEN":
610
+ return `start via existing lifecycle (TaskStore), or adopt into an active session${suffix}`
611
+ case "PARTIAL":
612
+ return `resume: rebuild context from provenance, then continue via TaskStore/Scheduler${suffix}`
613
+ case "BLOCKED":
614
+ return `resolve blocker first${suffix}`
615
+ case "FAILED_NEEDS_FOLLOWUP":
616
+ return `review failure evidence, then retry via existing lifecycle${suffix}`
617
+ case "WAITING_FOR_USER":
618
+ return `answer the pending approval/ask in the source session${suffix}`
619
+ case "DELEGATED":
620
+ return `check the sub-agent outcome in the child session${suffix}`
621
+ case "UNKNOWN":
622
+ return `inspect provenance manually — state cannot be proven from evidence${suffix}`
623
+ default:
624
+ return `terminal — no next action${suffix}`
625
+ }
626
+ }
627
+
628
+ // ── P14.0 — inventaris lintas sumber (agregasi MURNI atas baris) ─────────────
629
+
630
+ export interface InventoryInput {
631
+ readonly workspace: string
632
+ readonly sessions: readonly WorkSessionRow[]
633
+ readonly events: readonly DomainEvent[]
634
+ readonly runs: readonly WorkRunRow[]
635
+ readonly candidates: readonly IntentCandidate[]
636
+ readonly taskCounts: { total: number; open: number; terminal: number }
637
+ readonly checkpoints: { sessionsWithManifest: number; entries: number; corrupt: number }
638
+ }
639
+
640
+ export function buildWorkInventory(input: InventoryInput): WorkInventory {
641
+ // Lineage-aware: sesi anak mewarisi cakupan leluhur termulaiannya
642
+ // (lihat classifySessionScopes) — hasil sub-agent tetap terlihat.
643
+ const scopes = classifySessionScopes(input.workspace, input.sessions)
644
+ const inScopeIds = new Set(
645
+ [...scopes].filter(([, scope]) => scope === "IN_SCOPE").map(([id]) => id),
646
+ )
647
+ const excluded: { sessionId: string; reason: "FOREIGN_WORKSPACE" | "UNBOUND_WORKSPACE" }[] = []
648
+ let foreign = 0
649
+ let unbound = 0
650
+ let childSessions = 0
651
+ for (const s of input.sessions) {
652
+ const scope = scopes.get(s.id)
653
+ if (scope === "FOREIGN_WORKSPACE") {
654
+ foreign++
655
+ excluded.push({ sessionId: s.id, reason: "FOREIGN_WORKSPACE" })
656
+ } else if (scope === "UNBOUND_WORKSPACE") {
657
+ unbound++
658
+ excluded.push({ sessionId: s.id, reason: "UNBOUND_WORKSPACE" })
659
+ } else if (s.parentSessionId !== null) {
660
+ childSessions++
661
+ }
662
+ }
663
+ const byType: Record<string, number> = {}
664
+ let planEvents = 0
665
+ let requested = 0
666
+ let settled = 0
667
+ const resultsProduced = new Set<string>()
668
+ const failedTurns = new Set<string>()
669
+ for (const ev of input.events) {
670
+ if (!inScopeIds.has(ev.sessionId)) continue
671
+ byType[ev.type] = (byType[ev.type] ?? 0) + 1
672
+ if (ev.type === "plan.updated") planEvents++
673
+ if (ev.type === "approval.requested") requested++
674
+ if (ev.type === "approval.settled") settled++
675
+ }
676
+ for (const s of input.sessions) {
677
+ if (s.parentSessionId === null || !inScopeIds.has(s.id)) continue
678
+ for (const ev of input.events) {
679
+ if (ev.sessionId !== s.id) continue
680
+ if (ev.type === "result.produced") resultsProduced.add(s.id)
681
+ if (ev.type === "turn.failed") failedTurns.add(s.id)
682
+ }
683
+ }
684
+ let activeRuns = 0
685
+ let interruptedRuns = 0
686
+ let terminalRuns = 0
687
+ let totalRuns = 0
688
+ for (const r of input.runs) {
689
+ if (!inScopeIds.has(r.sessionId)) continue
690
+ totalRuns++
691
+ if (r.status === "RUNNING" || r.status === "CREATED") activeRuns++
692
+ else if (r.status === "INTERRUPTED") interruptedRuns++
693
+ else terminalRuns++
694
+ }
695
+ let openPlanSteps = 0
696
+ let closedPlanSteps = 0
697
+ let pendingApprovals = 0
698
+ for (const c of input.candidates) {
699
+ if (c.source === "PLAN_STEP") {
700
+ if (c.terminal) closedPlanSteps++
701
+ else openPlanSteps++
702
+ }
703
+ if (c.source === "APPROVAL" && c.state === "WAITING_FOR_USER") pendingApprovals++
704
+ }
705
+ return {
706
+ workspace: input.workspace,
707
+ sessions: {
708
+ total: input.sessions.length,
709
+ inScope: inScopeIds.size,
710
+ foreignWorkspace: foreign,
711
+ unboundWorkspace: unbound,
712
+ childSessions,
713
+ },
714
+ tasks: input.taskCounts,
715
+ presentationEvents: { total: Object.values(byType).reduce((a, b) => a + b, 0), byType },
716
+ runs: {
717
+ total: totalRuns,
718
+ active: activeRuns,
719
+ interrupted: interruptedRuns,
720
+ terminal: terminalRuns,
721
+ },
722
+ checkpoints: input.checkpoints,
723
+ plans: { events: planEvents, openSteps: openPlanSteps, closedSteps: closedPlanSteps },
724
+ approvals: { requested, settled, pending: pendingApprovals },
725
+ subAgents: {
726
+ childSessions,
727
+ resultsProduced: resultsProduced.size,
728
+ failedTurns: failedTurns.size,
729
+ },
730
+ excludedSessions: excluded,
731
+ }
732
+ }