minicode-ai 0.13.0 → 0.14.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 (83) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -0
  4. package/cli/args.ts +50 -2
  5. package/cli/commands/acp.ts +18 -3
  6. package/cli/commands/daemon.ts +114 -19
  7. package/cli/commands/exec.ts +95 -7
  8. package/cli/commands/mcp.ts +66 -5
  9. package/cli/commands/memory.ts +46 -14
  10. package/cli/commands.ts +5 -0
  11. package/cli/index.ts +30 -5
  12. package/cli/minicode.js +6 -0
  13. package/cli/setup.ts +365 -24
  14. package/cli/tui.ts +72 -27
  15. package/docs/TERMINAL_CONTRACT.md +91 -24
  16. package/docs/agents.md +2 -2
  17. package/docs/cli.md +1 -0
  18. package/docs/environment.md +1 -0
  19. package/docs/memory-sessions.md +5 -0
  20. package/package.json +3 -2
  21. package/src/app/session.ts +153 -35
  22. package/src/app/tool-layer.ts +67 -61
  23. package/src/daemon/approvals.ts +25 -1
  24. package/src/daemon/client.ts +51 -1
  25. package/src/daemon/control.ts +8 -0
  26. package/src/daemon/protocol.ts +47 -1
  27. package/src/daemon/server.ts +45 -9
  28. package/src/daemon/subscription.ts +25 -1
  29. package/src/daemon/telemetry.ts +4 -0
  30. package/src/hooks/run.ts +5 -1
  31. package/src/mcp/client.ts +349 -90
  32. package/src/mcp/http-transport.ts +7 -0
  33. package/src/mcp/transport.ts +5 -0
  34. package/src/memory/files.ts +69 -3
  35. package/src/memory/vector.ts +556 -160
  36. package/src/policy/approval-binding.ts +199 -0
  37. package/src/policy/context.ts +20 -1
  38. package/src/policy/executor.ts +44 -5
  39. package/src/policy/permission.ts +243 -26
  40. package/src/policy/tool-contract.ts +77 -0
  41. package/src/policy/usage.ts +3 -1
  42. package/src/policy/work-mode.ts +49 -1
  43. package/src/presentation/adapter.ts +157 -7
  44. package/src/presentation/events.ts +173 -1
  45. package/src/presentation/model.ts +37 -0
  46. package/src/presentation/projection.ts +107 -18
  47. package/src/presentation/reducer.ts +134 -10
  48. package/src/sandbox/os.ts +18 -1
  49. package/src/session/persistence.ts +153 -11
  50. package/src/task/store.ts +43 -3
  51. package/src/tools/memory.ts +70 -10
  52. package/src/tools/task.ts +7 -1
  53. package/src/tools/todo.ts +14 -4
  54. package/src/ui/approval/prompt.ts +52 -7
  55. package/src/ui/assistant/simple.ts +160 -57
  56. package/src/ui/contract.ts +46 -0
  57. package/src/ui/footer.ts +14 -5
  58. package/src/ui/i18n/en.ts +9 -0
  59. package/src/ui/i18n/id.ts +9 -0
  60. package/src/ui/render/collapse.ts +24 -52
  61. package/src/ui/render/detail.ts +14 -9
  62. package/src/ui/render/errors.ts +8 -0
  63. package/src/ui/render/reasoning.ts +13 -8
  64. package/src/ui/session-state.ts +243 -0
  65. package/src/ui/tui/app.ts +7 -3
  66. package/src/ui/tui/transcript.ts +271 -30
  67. package/vendor/minicore/src/core/budget.ts +25 -25
  68. package/vendor/minicore/src/core/compact.ts +75 -75
  69. package/vendor/minicore/src/core/errors.ts +59 -59
  70. package/vendor/minicore/src/core/events.ts +73 -73
  71. package/vendor/minicore/src/core/executor.ts +139 -139
  72. package/vendor/minicore/src/core/history.ts +31 -31
  73. package/vendor/minicore/src/core/index.ts +41 -41
  74. package/vendor/minicore/src/core/loop.ts +355 -355
  75. package/vendor/minicore/src/core/permission.ts +22 -22
  76. package/vendor/minicore/src/core/provider.ts +39 -39
  77. package/vendor/minicore/src/core/recovery.ts +35 -35
  78. package/vendor/minicore/src/core/session.ts +327 -327
  79. package/vendor/minicore/src/core/snapshot.ts +146 -146
  80. package/vendor/minicore/src/core/tokens.ts +107 -107
  81. package/vendor/minicore/src/core/tool.ts +115 -115
  82. package/vendor/minicore/src/core/types.ts +50 -50
  83. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
@@ -104,6 +104,25 @@ export type ServerMessage =
104
104
  * yang tak pernah bisa ia deteksi sendiri.
105
105
  */
106
106
  snapshotRejected: number
107
+ /**
108
+ * [Area C · PROMPT 06] Fase stream SAAT INI di langganan ini.
109
+ *
110
+ * "replay" = server masih akan mengirim event durable lama (event
111
+ * setelah pesan ini masih bisa Ber-provenance "REPLAY"); "live" = tak
112
+ * ada replay yang menunggu, stream ini live sejak awal.
113
+ *
114
+ * Kenapa Wajib di sini: tanpa field ini konsumen harus MENEBAK apakah
115
+ * replay akan datang (dari `fromSeq` vs head yang tak dikirim), dan
116
+ * tebakan yang salah membuat UI menampilkan "live" untuk data yang
117
+ * sebenarnya basi — atau sebaliknya, menampilkan "replay" untuk stream
118
+ * yang sudah live. `tail_marker` tetap menjadi penanda TRANSISI
119
+ * (phase "live"), jadi kedua titik itu konsisten.
120
+ *
121
+ * Field TAMBAHAN (additive): konsumen lama yang mengabaikan field
122
+ * tak dikenal tetap bekerja; ia hanya tak bisa menampilkan badge fase
123
+ * awal sampai `tail_marker` tiba.
124
+ */
125
+ phase: DaemonStreamPhase
107
126
  }
108
127
  | { t: "frontiers"; sid: string; frontiers: SessionFrontiers }
109
128
  | { t: "snapshot"; sid: string; consumer: string; snapshot: SessionSnapshot }
@@ -116,7 +135,19 @@ export type ServerMessage =
116
135
  event: unknown
117
136
  }
118
137
  | { t: "replay_done"; sid: string; consumer: string; upToSeq: number }
119
- | { t: "tail_marker"; sid: string; consumer: string; atSeq: number }
138
+ | {
139
+ t: "tail_marker"
140
+ sid: string
141
+ consumer: string
142
+ atSeq: number
143
+ /**
144
+ * F-DAEMON-1: fase stream pada titik ini — selalu "live" (tail_marker
145
+ * ADALAH transisi REPLAY→LIVE). Bila tidak ada replay (subscribe "tail"
146
+ * dari head), fase tetap "live" dan event yang ditandai LIVE sudah tiba
147
+ * sejak awal; konsumen tak perlu menebak dari urutan pesan.
148
+ */
149
+ phase: DaemonStreamPhase
150
+ }
120
151
  | { t: "ack_ok"; sid: string; consumer: string; seq: number }
121
152
  | { t: "approval"; consumer: string; approval: ApprovalView }
122
153
  | { t: "control_result"; idem: string; ok: boolean; result?: unknown; refusal?: RefusalBody }
@@ -135,9 +166,24 @@ export interface RefusalBody {
135
166
  * Provenance sebuah event di mata konsumen. LIVE = dari penulis sesi sekarang;
136
167
  * REPLAY = dibaca dari durable store; RECONSTRUCTED = hasil rebuild presentasi;
137
168
  * UNKNOWN = tak dapat dipastikan. Tak boleh pernah diratakan ke satu nilai.
169
+ *
170
+ * INI KOSAKATA WIRE (UPPERCASE). Beda dari kosakata provenance TAMPILAN
171
+ * (lowercase `live|replay|reconstructed|unknown` di `src/presentation/projection.ts`
172
+ * / `src/ui/contract.ts:UiProvenance`). Dua kosakata itu disengaja terpisah:
173
+ * yang satu menjelaskan (di mata konsumen daemon) DARI MANA sebuah event dibaca
174
+ * dari toko; yang lain menjelaskan (di mata renderer) status rebuild/`incomplete`
175
+ * baris transcript terhadap watershed rebuild. Jangan pernah membandingkan
176
+ * keduanya secara langsung tanpa mapping eksplisit.
138
177
  */
139
178
  export type Provenance = "LIVE" | "REPLAY" | "RECONSTRUCTED" | "UNKNOWN"
140
179
 
180
+ /**
181
+ * F-DAEMON-1: fase stream per-konsumen. `replay` = masih melayani event durable
182
+ * yang sudah ada (SEBELUM `tail_marker`); `live` = sudah melewati `tail_marker`,
183
+ * setiap event berikutnya adalah LIVE (mungkin belum durable).
184
+ */
185
+ export type DaemonStreamPhase = "replay" | "live"
186
+
141
187
  /** Frontier = batas pengetahuan terakhir per toko (bukan kepemilikan). */
142
188
  export interface SessionFrontiers {
143
189
  writerEpoch: number
@@ -96,6 +96,8 @@ interface Conn {
96
96
  subs: Map<string, Subscription>
97
97
  paused: boolean
98
98
  closed: boolean
99
+ /** P2.3: replay yang berhenti karena socket backpressure; dilanjutkan saat drain. */
100
+ pendingReplay?: { sid: string; consumer: string; fromSeq: number; head: number }
99
101
  }
100
102
 
101
103
  let connSeq = 0
@@ -178,6 +180,13 @@ export class DaemonServer {
178
180
  })
179
181
  socket.on("drain", () => {
180
182
  conn.paused = false
183
+ const pending = conn.pendingReplay
184
+ if (pending) {
185
+ conn.pendingReplay = undefined
186
+ this.#deps.telemetry.inc("replay.resumed")
187
+ if (!this.#replayRange(conn, pending.sid, pending.consumer, pending.fromSeq, pending.head))
188
+ return
189
+ }
181
190
  this.#pump(conn)
182
191
  })
183
192
  const teardown = () => this.#teardown(conn)
@@ -414,9 +423,29 @@ export class DaemonServer {
414
423
  fromSeq,
415
424
  cursor: sub.cursor,
416
425
  snapshotRejected: rejected,
426
+ // [Area C · PROMPT 06] Fase Awal stream, dibaca dari latch per-subscription
427
+ // (bukan dihitung ulang di sini): `SubscriptionRegistry.attach` sudah
428
+ // menetapkan "replay" bila fromSeq <= head. Sumber tunggal = latch.
429
+ phase: sub.phase,
417
430
  })
418
431
 
419
- // 4) replay — hanya bila memang ada yang harus dikirim.
432
+ // 4-6) replay → replay_done → tail_marker → pump. Helper mengembalikan
433
+ // false bila socket backpressure memaksa replay berhenti; drain melanjutkan
434
+ // dari cursor yang tersimpan (bukan mengulang dari awal atau membuang sisa).
435
+ if (!this.#replayRange(conn, sid, consumer, fromSeq, head)) return
436
+ this.#pump(conn)
437
+ }
438
+
439
+ /**
440
+ * P2.3: replay yang resumable. `#send` menandai `conn.paused` saat
441
+ * `socket.write()` mengembalikan false; loop berhenti SEBELUM buffer tumbuh
442
+ * tanpa batas, lalu `drain` memanggil helper ini lagi dengan cursor lanjut.
443
+ */
444
+ #replayRange(conn: Conn, sid: string, consumer: string, fromSeq: number, head: number): boolean {
445
+ const sub = conn.subs.get(sid)
446
+ if (!sub) return true
447
+ const feed = this.#deps.feeds.get(sid)
448
+ if (!feed) return true
420
449
  let replayTo = sub.cursor
421
450
  if (fromSeq <= head) {
422
451
  let cursor = fromSeq - 1
@@ -426,13 +455,15 @@ export class DaemonServer {
426
455
  for (const ev of page.events) {
427
456
  const seq = numberOr(ev.eventSeq, -1)
428
457
  if (seq < fromSeq) continue
429
- if (
430
- !this.#send(conn, { t: "event", sid, consumer, seq, provenance: "REPLAY", event: ev })
431
- )
432
- return
458
+ this.#send(conn, { t: "event", sid, consumer, seq, provenance: "REPLAY", event: ev })
433
459
  cursor = seq
434
460
  sub.cursor = seq
435
461
  this.#deps.telemetry.inc("events.replayed")
462
+ if (conn.paused) {
463
+ conn.pendingReplay = { sid, consumer, fromSeq: cursor + 1, head }
464
+ this.#deps.telemetry.inc("replay.paused")
465
+ return false
466
+ }
436
467
  }
437
468
  if (page.events.length < REPLAY_PAGE_LIMIT) break
438
469
  }
@@ -441,10 +472,15 @@ export class DaemonServer {
441
472
  this.#send(conn, { t: "replay_done", sid, consumer, upToSeq: replayTo })
442
473
  // 5) penanda live-tail: segala sesuatu SETELAH pesan ini adalah LIVE dan
443
474
  // boleh saja belum durable — konsumen harus memperlakukannya beda.
444
- this.#send(conn, { t: "tail_marker", sid, consumer, atSeq: replayTo })
445
- // 6) kosongkan antrean live yang terkumpul selama replay (yang seq-nya
446
- // sudah terkirim otomatis terbuang di #pump).
447
- this.#pump(conn)
475
+ // F-DAEMON-1: badge transisi REPLAY→LIVE dibawa eksplisit di pesan ini
476
+ // (`phase: "live"`), dan latch per-subscription diputar ke live.
477
+ // [Area C · PROMPT 06] Latch diputar SEBELUM pesan dikirim, dan nilai
478
+ // di wire diambil DARI latch — jadi `Subscription.phase` bukan lagi
479
+ // state mati: ia adalah sumber tunggal fase yang terlihat konsumen.
480
+ sub.markLive()
481
+ this.#send(conn, { t: "tail_marker", sid, consumer, atSeq: replayTo, phase: sub.phase })
482
+ conn.pendingReplay = undefined
483
+ return true
448
484
  }
449
485
 
450
486
  #onAck(conn: Conn, raw: Record<string, unknown>): void {
@@ -7,7 +7,7 @@
7
7
  // tak bisa dipegang. Batas + overflow eksplisit menjadikannya penolakan yang
8
8
  // terlihat (QUEUE_OVERFLOW) alih-alih memori yang meledak.
9
9
 
10
- import { MAX_QUEUE_PER_CONN } from "./protocol.ts"
10
+ import { type DaemonStreamPhase, MAX_QUEUE_PER_CONN } from "./protocol.ts"
11
11
  import { readConsumerOffset, resetConsumerOffset, writeConsumerOffset } from "./store.ts"
12
12
 
13
13
  export interface PendingEvent {
@@ -71,6 +71,12 @@ export interface SubscriptionInit {
71
71
  /** Seq pertama yang AKAN dikirim. Lebih besar dari head = tak ada yang dikirim. */
72
72
  fromSeq: number
73
73
  maxQueue?: number
74
+ /**
75
+ * F-DAEMON-1: fase awal stream. `replay` bila masih ada event durable yang
76
+ * akan dibaca (fromSeq <= head); `live` bila tak ada replay. Server memanggil
77
+ * `markLive()` saat mengirim `tail_marker`. Absen = "live" (default aman).
78
+ */
79
+ phase?: DaemonStreamPhase
74
80
  /**
75
81
  * Workspace pemilik offset. TANPA ini ack jatuh ke `process.cwd()` daemon —
76
82
  * padahal offset adalah milik SATU workspace; menulisnya ke tempat lain
@@ -97,6 +103,13 @@ export class Subscription {
97
103
  /** true saat antrean pernah penuh — konsumen wajib reconnect + mulai ulang. */
98
104
  overflowed = false
99
105
  closed = false
106
+ /**
107
+ * F-DAEMON-1: fase stream per-konsumen (bukan global). `replay` sampai
108
+ * `tail_marker` dikirim, lalu `markLive()` memutarnya ke `live`. Memakai
109
+ * field per-`Subscription`, bukan flag global daemon, supaya dua konsumen
110
+ * yang mulai pada titik berbeda tak saling menimpa fase.
111
+ */
112
+ phase: DaemonStreamPhase
100
113
  readonly queue: BoundedQueue<PendingEvent>
101
114
  readonly cwd: string | undefined
102
115
 
@@ -106,11 +119,20 @@ export class Subscription {
106
119
  this.sid = init.sid
107
120
  this.startSeq = init.fromSeq
108
121
  this.cwd = init.cwd
122
+ this.phase = init.phase ?? "live"
109
123
  // Cursor awal = satu sebelum seq pertama yang akan dikirim.
110
124
  this.cursor = init.fromSeq - 1
111
125
  this.queue = new BoundedQueue<PendingEvent>(init.maxQueue ?? MAX_QUEUE_PER_CONN)
112
126
  }
113
127
 
128
+ /**
129
+ * F-DAEMON-1: tandai transisi REPLAY→LIVE. Dipanggil server tepat setelah
130
+ * `tail_marker`; idempoten (memanggil dua kali = tetap live).
131
+ */
132
+ markLive(): void {
133
+ this.phase = "live"
134
+ }
135
+
114
136
  /** Antre event. false = overflow (pemanggil mengirim halte + memutus). */
115
137
  enqueue(p: PendingEvent): boolean {
116
138
  if (this.closed) return false
@@ -217,6 +239,8 @@ export class SubscriptionRegistry {
217
239
  ...(init.offsetConsumerId !== undefined ? { offsetConsumerId: init.offsetConsumerId } : {}),
218
240
  sid: init.sid,
219
241
  fromSeq,
242
+ // F-DAEMON-1: fase awal — replay hanya bila ada event durable untuk dibaca.
243
+ phase: fromSeq <= init.head ? "replay" : "live",
220
244
  ...(init.maxQueue !== undefined ? { maxQueue: init.maxQueue } : {}),
221
245
  ...(init.cwd !== undefined ? { cwd: init.cwd } : {}),
222
246
  })
@@ -14,6 +14,8 @@ export type CounterName =
14
14
  | "events.delivered"
15
15
  | "events.replayed"
16
16
  | "events.dropped.overflow"
17
+ | "replay.paused"
18
+ | "replay.resumed"
17
19
  | "ack.accepted"
18
20
  | "ack.rejected"
19
21
  | "control.executed"
@@ -35,6 +37,8 @@ const COUNTERS: readonly CounterName[] = [
35
37
  "events.delivered",
36
38
  "events.replayed",
37
39
  "events.dropped.overflow",
40
+ "replay.paused",
41
+ "replay.resumed",
38
42
  "ack.accepted",
39
43
  "ack.rejected",
40
44
  "control.executed",
package/src/hooks/run.ts CHANGED
@@ -28,7 +28,11 @@ export function shouldRunHooks(
28
28
  permissionMode: string,
29
29
  workMode?: "DISCUSS" | "PLAN" | "EXECUTE",
30
30
  ): boolean {
31
- if (workMode === "DISCUSS") return false
31
+ // P0.2 (Q3): hooks berjalan di luar permission system dengan akses penuh
32
+ // Node.js/filesystem/jaringan, sehingga DILARANG di DISCUSS maupun PLAN
33
+ // untuk seluruh PermissionMode. Hanya WorkMode EXECUTE (atau pemanggil
34
+ // legacy tanpa argumen workMode) yang boleh menjalankan hooks.
35
+ if (workMode !== undefined && workMode !== "EXECUTE") return false
32
36
  return permissionMode !== "plan" && permissionMode !== "readonly"
33
37
  }
34
38