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
package/cli/tui.ts CHANGED
@@ -24,24 +24,16 @@ import {
24
24
  } from "../src/presentation/projection.ts"
25
25
  import { redoLastCheckpoint, undoLastCheckpoint } from "../src/session/checkpoint.ts"
26
26
  import { renderSkill } from "../src/skills/loader.ts"
27
- import {
28
- getLastTurnTexts,
29
- MAX_COPY_TURNS,
30
- writeClipboardOsc52,
31
- } from "../src/ui/assistant/simple.ts"
27
+ import { MAX_COPY_TURNS, writeClipboardOsc52 } from "../src/ui/assistant/simple.ts"
32
28
  import type { UiBus } from "../src/ui/contract.ts"
33
29
  import { t } from "../src/ui/i18n/locale.ts"
34
30
  import { loadHistory } from "../src/ui/input/input.ts"
35
- import {
36
- clearCollapsedSections,
37
- collapsedSectionsSnapshot,
38
- sectionMinimized,
39
- setSectionMinimized,
40
- } from "../src/ui/render/collapse.ts"
41
- import { setCompactMode } from "../src/ui/render/detail.ts"
42
31
  import { formatUsd } from "../src/ui/render/money.ts"
43
- import { setReasoningVisible } from "../src/ui/render/reasoning.ts"
44
32
  import { c } from "../src/ui/render/theme.ts"
33
+ // [Area A · PROMPT 06] State UI milik SESI ini. TUI + printer linier sesi yang
34
+ // sama berbagi state (satu instance), sesi lain di proses yang sama tak
35
+ // tersentuh. Absen = instance default (fixture tes partial).
36
+ import { defaultUiState, type UiSessionState } from "../src/ui/session-state.ts"
45
37
  import { TuiApp, type TuiHost } from "../src/ui/tui/app.ts"
46
38
  import { Transcript } from "../src/ui/tui/transcript.ts"
47
39
  import { parseWorkModeValue } from "./args.ts"
@@ -57,7 +49,14 @@ import type { CliSession } from "./setup.ts"
57
49
 
58
50
  const MODES = ["auto", "ask", "plan", "allowlist", "allow-all"] as const
59
51
  // /expand [id]: tanpa arg = semua entry store; dengan id = satu tool.
60
- const DRIVER_COMMANDS = ["/compact", "/thinking", "/expand [id]", "/minimize"]
52
+ const DRIVER_COMMANDS = [
53
+ "/compact",
54
+ "/thinking",
55
+ "/expand [id]",
56
+ "/minimize",
57
+ "/mode",
58
+ "/work-mode",
59
+ ]
61
60
 
62
61
  function fmtCtx(n: number): string | undefined {
63
62
  if (!Number.isFinite(n) || n <= 0) return undefined
@@ -67,6 +66,32 @@ function fmtCtx(n: number): string | undefined {
67
66
  return `${(n / 1000000).toFixed(1)}m`
68
67
  }
69
68
 
69
+ /**
70
+ * F-CTX-1: metrik usage footer (biaya + window %) dari angka NYATA, tanpa
71
+ * perkiraan. Kosong = tak ada data relevan (belum belanja / flag window tak
72
+ * disetel) — footer tak pernah menampilkan persentase/biaya palsu.
73
+ */
74
+ function fmtUsageMetrics(ctx: CliSession): string | undefined {
75
+ const cost: number | undefined = ctx.usage.getSession().cost
76
+ const windowTokens: number | undefined = ctx.contextWindowTokens
77
+ // P1.4: persentase footer = OCCUPANCY konteks saat ini, bukan total token
78
+ // yang sudah dibelanjakan sepanjang sesi. Memakai spend membuat footer
79
+ // mentok 100% setelah beberapa step meski konteks masih jauh di bawah window.
80
+ const used: number = ctx.session.contextTokens
81
+ const parts: string[] = []
82
+ if (cost !== undefined && Number.isFinite(cost) && cost > 0) parts.push(formatUsd(cost))
83
+ if (
84
+ windowTokens !== undefined &&
85
+ Number.isFinite(windowTokens) &&
86
+ windowTokens > 0 &&
87
+ Number.isFinite(used)
88
+ ) {
89
+ const pct = Math.min(100, Math.round((used / windowTokens) * 100))
90
+ parts.push(`${pct}%`)
91
+ }
92
+ return parts.length ? parts.join(" ") : undefined
93
+ }
94
+
70
95
  /**
71
96
  * Tangkap console.log/error selama `fn` → baris teks (tanpa warna liar:
72
97
  * caller yang mewarnai). Dipakai membungkus handleBuiltinCommand supaya
@@ -123,14 +148,17 @@ export async function runTui(ctx: CliSession): Promise<void> {
123
148
  schedulerObservability,
124
149
  } = ctx
125
150
  const { session } = ctx
151
+ // [Area A · PROMPT 06] State UI sesi. `runTui` juga dijalankan fixture tes
152
+ // dengan CliSession parsial — absen berarti pakai instance default.
153
+ const ui: UiSessionState = ctx.uiState ?? defaultUiState
126
154
  const getPresentationSnapshot = () =>
127
155
  typeof ctx.getPresentationSnapshot === "function"
128
156
  ? ctx.getPresentationSnapshot()
129
157
  : { activities: [], turns: [] }
130
158
 
131
159
  let mode: string = permissions?.getMode() ?? permissionMode ?? "auto"
132
- if (process.env.MINICODE_COMPACT === undefined) setCompactMode(true)
133
- if (process.env.MINICODE_MINIMIZE_TOOL === undefined) setSectionMinimized("tool", true)
160
+ if (process.env.MINICODE_COMPACT === undefined) ui.setCompactMode(true)
161
+ if (process.env.MINICODE_MINIMIZE_TOOL === undefined) ui.setSectionMinimized("tool", true)
134
162
  let warned80 = false
135
163
  let abort: AbortController | null = null
136
164
 
@@ -146,6 +174,8 @@ export async function runTui(ctx: CliSession): Promise<void> {
146
174
  const transcript = new Transcript(session.events as unknown as UiBus, {
147
175
  getSnapshot: getPresentationSnapshot,
148
176
  onPresentationEvent: ctx.onPresentationEvent,
177
+ // [Area A · PROMPT 06] State sesi yang sama dengan printer linier.
178
+ uiState: ui,
149
179
  policy: {
150
180
  describeActivity,
151
181
  matchTurn: matchTurnBySummary,
@@ -184,6 +214,13 @@ export async function runTui(ctx: CliSession): Promise<void> {
184
214
  usage,
185
215
  skills: allLoadedSkills,
186
216
  toolsCount: sessionTools.length,
217
+ // P1.2: dua dimensi selalu terbaca live di /status — bukan snapshot boot.
218
+ get workMode() {
219
+ return workModeControl?.getWorkMode() ?? "EXECUTE"
220
+ },
221
+ get permissionMode() {
222
+ return permissions?.getMode() ?? mode
223
+ },
187
224
  providerHint: cfg.providers[0]?.providerHint,
188
225
  setModelOverride: (m) => persistModelChoice(m, modelRef),
189
226
  // Spawn anak stdio-inherit (/sessions <id>): keluar alt-screen + cooked
@@ -343,8 +380,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
343
380
  function helpConcise(): void {
344
381
  // Diturunkan dari registry (BUILTIN + driver) — perintah baru tak bisa
345
382
  // hilang dari /help diam-diam (satu sumber, bukan daftar hardcode).
383
+ // Set menjaga urutan deklarasi sekaligus mencegah duplikasi saat perintah
384
+ // driver terdaftar di completion (DRIVER_COMMANDS) dan help (DRIVER_HELP_COMMANDS).
346
385
  const builtin = BUILTIN_COMMANDS.map((b) => `/${b.name}`).join(" ")
347
- const driver = [...DRIVER_COMMANDS, ...DRIVER_HELP_COMMANDS.map((b) => `/${b.name}`)].join(" ")
386
+ const driver = [
387
+ ...new Set([...DRIVER_COMMANDS, ...DRIVER_HELP_COMMANDS.map((b) => `/${b.name}`)]),
388
+ ].join(" ")
348
389
  transcript.pushInfo([
349
390
  t("help.cHead"),
350
391
  ` ${builtin}`,
@@ -362,7 +403,10 @@ export async function runTui(ctx: CliSession): Promise<void> {
362
403
  }
363
404
 
364
405
  async function copyLastTurn(count: number): Promise<void> {
365
- const turns = getLastTurnTexts(count)
406
+ // [Area A · PROMPT 06] Buffer /copy milik SESI ini (bukan singleton modul)
407
+ // — sesi lain di proses yang sama tak ikut tercampur.
408
+ const turns = ui
409
+ .getLastTurnTexts(count)
366
410
  .map((turn) => turn.trim())
367
411
  .filter(Boolean)
368
412
  const txt = turns.join("\n\n").trim()
@@ -462,20 +506,20 @@ export async function runTui(ctx: CliSession): Promise<void> {
462
506
  }
463
507
  if (name === "compact") {
464
508
  const next = args === "" ? undefined : args === "on" || args === "1"
465
- const compact = setCompactMode(next)
509
+ const compact = ui.setCompactMode(next)
466
510
  transcript.pushInfo([c.muted(t("tui.toolCall", { v: compact ? "compact" : "expanded" }))])
467
511
  return
468
512
  }
469
513
  if (name === "thinking") {
470
514
  const next = args === "" ? undefined : args === "on" || args === "1"
471
- const vis = setReasoningVisible(next)
515
+ const vis = ui.setReasoningVisible(next)
472
516
  transcript.pushInfo([c.muted(t("tui.thinkingSet", { v: vis ? "expanded" : "minimized" }))])
473
517
  return
474
518
  }
475
519
  if (name === "expand") {
476
520
  const sections = args ? ctx.expandContent(args) : ctx.expandAllContent()
477
- const views = args ? [] : collapsedSectionsSnapshot()
478
- if (!args) clearCollapsedSections()
521
+ const views = args ? [] : ui.collapsedSectionsSnapshot()
522
+ if (!args) ui.clearCollapsedSections()
479
523
  if (!sections.length && !views.length) {
480
524
  transcript.pushInfo([c.muted(t("tui.expandEmpty"))])
481
525
  return
@@ -501,15 +545,15 @@ export async function runTui(ctx: CliSession): Promise<void> {
501
545
  if (name === "minimize") {
502
546
  const arg = args.trim().toLowerCase()
503
547
  let next: boolean | undefined
504
- if (arg === "") next = !(sectionMinimized("tool") && sectionMinimized("answer"))
548
+ if (arg === "") next = !(ui.sectionMinimized("tool") && ui.sectionMinimized("answer"))
505
549
  else if (arg === "on" || arg === "1") next = true
506
550
  else if (arg === "off" || arg === "0") next = false
507
551
  else {
508
552
  transcript.pushInfo([c.muted(t("tui.minUse"))])
509
553
  return
510
554
  }
511
- setSectionMinimized("tool", next)
512
- setSectionMinimized("answer", next)
555
+ ui.setSectionMinimized("tool", next)
556
+ ui.setSectionMinimized("answer", next)
513
557
  transcript.pushInfo([c.muted(t(next ? "tui.sectionsMin" : "tui.sectionsExp"))])
514
558
  return
515
559
  }
@@ -592,6 +636,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
592
636
  model: modelRef.current ?? cfg.providers[0]?.models[0] ?? t("tui.noModel"),
593
637
  cwd: cwd ?? process.cwd(),
594
638
  context: fmtCtx(session.contextTokens),
639
+ metrics: fmtUsageMetrics(ctx),
595
640
  },
596
641
  busy: abort != null,
597
642
  }
@@ -615,11 +660,11 @@ export async function runTui(ctx: CliSession): Promise<void> {
615
660
  cycleMode(dir)
616
661
  },
617
662
  toggleCompact: () => {
618
- const compact = setCompactMode()
663
+ const compact = ui.setCompactMode()
619
664
  transcript.pushInfo([c.muted(t("tui.toolCall", { v: compact ? "compact" : "expanded" }))])
620
665
  },
621
666
  toggleReasoning: () => {
622
- const vis = setReasoningVisible()
667
+ const vis = ui.setReasoningVisible()
623
668
  transcript.pushInfo([c.muted(t("tui.thinkingSet", { v: vis ? "expanded" : "minimized" }))])
624
669
  },
625
670
  }
@@ -227,6 +227,15 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
227
227
  tetap pada ledger tool, status tool final memakai glyph + kata
228
228
  (`completed`/`failed`/`denied`/`cancelled`/`interrupted`), retry dan grup
229
229
  anak mengikuti model, serta ringkasan turn masuk sebagai system entry.
230
+ **Grup anak (F-AGENT-1):** tool anak yang punya identitas run
231
+ (`childSessionId`/`runId` — dari `ChildSessionLink`) tampil sebagai baris
232
+ run sendiri, diindented `↳ <marker> <tool> <target> <status>` dengan
233
+ marker `run_<8>`/`sub_<8>`; anak paralel tak lagi(dir) satukan jadi satu
234
+ hitungan. Tool anak yang HANYA punya `parentToolCallId` (grouping legacy,
235
+ tanpa identitas run) tetap ditelan sebagai hitungan induk `n child tools`
236
+ — `parentToolCallId` = taut ke pemanggil, bukan identitas run, jadi dua
237
+ makna itu tak boleh disamakan. Baris running anak memakai aturan yang
238
+ sama (marker per run).
230
239
 
231
240
  18. Prompt multiline (Ctrl+J newline), histori memori-sesi (tak persist ke
232
241
  berkas histori lama). `/copy [n]` menyalin 1–10 turn terakhir (default 1,
@@ -319,24 +328,48 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
319
328
  — subcommand lain menerima args mentah. Invarian ini tidak mengubah
320
329
  semantik, aksi, atau exit code masing-masing aksi; yang berubah hanya
321
330
  invokasi flag-mendahului yang dulu salah rute menjadi rute benar.
322
- 35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2)** — dua
331
+ 35. **WorkMode = lapis intent di ATAS permission mode (P12 S2.2 + P0.2)** — dua
323
332
  dimensi yang BERJALAN BERSAMA, bukan pengganti:
324
- **Nilai:** `DISCUSS` (read-only penuh) · `PLAN` (ceiling rencana) ·
325
- `EXECUTE` (tanpa ceiling tambahan). Default `EXECUTE` = perilaku lama
326
- (kompatibel: sesi tanpa WorkMode yang eksplisit tetap EXECUTE).
327
- **Gerbang penolakan:** permission handler tetap satu-satunya yang menentukan
328
- keamanan eksekusi. WorkMode hanya MEMASANG CEILING di atasnya; ia tidak
329
- pernah memperluas kewenangan permission mode dasar (INV-WM1).
333
+ **Nilai:** `DISCUSS` (investigasi baca-saja lokal: tepat 16 tool `PURE_READ`
334
+ lokal, network read `web_fetch`/`web_search` ditolak penuh) · `PLAN`
335
+ (ceiling rencana: 16 tool baca lokal + `web_fetch`/`web_search` wajib lewat
336
+ approval prompt + ekstra rencana bila diizinkan PM) · `EXECUTE` (tanpa
337
+ ceiling tambahan). Default `EXECUTE` = perilaku lama (kompatibel: sesi baru
338
+ tanpa WorkMode eksplisit tetap EXECUTE).
339
+ **Gerbang penolakan & side-effect ceiling:** permission handler tetap
340
+ satu-satunya yang menentukan keamanan eksekusi. WorkMode hanya MEMASANG
341
+ CEILING di atasnya; ia tidak pernah memperluas kewenangan permission mode
342
+ dasar (INV-WM1), `visible === callable` terjaga lintas transisi runtime,
343
+ hooks diblokir pada `DISCUSS` maupun `PLAN` untuk semua PM, dan `--verify`
344
+ ditolak fail-closed saat startup bila digabung `DISCUSS`/`PLAN` (exit 2)
345
+ serta dilewati otomatis saat mode turun ke `DISCUSS`/`PLAN` di TUI.
330
346
  **Command `/work-mode <DISCUSS|PLAN|EXECUTE>`:** aksi operator EKSPLISIT.
331
347
  Tanpa argumen → tampilkan mode aktif + usage; nilai invalid → pesan
332
348
  kesalahan dan mode AKTIF TIDAK berubah; sesi tanpa kontrol WorkMode
333
349
  (handler izin terinjeksi = policy, bukan mode) → ditolak, bukan
334
350
  diam-diam tampak berubah. Transisi berlaku pada SESI YANG SEDANG
335
351
  BERJALAN: ceiling permission dievaluasi per pemanggilan tool, daftar tool
336
- yang dilihat model ikut turun/naik, hooks dievaluasi terhadap WorkMode
337
- aktif, dan delegasi berikutnya mewarisi WorkMode parent yang aktif.
338
- WorkMode TIDAK bisa dinaikkan otomatis oleh model, anak, atau argumen
339
- delegasi.
352
+ dan instruksi system prompt yang dilihat model ikut turun/naik, hooks/verify
353
+ dievaluasi terhadap WorkMode aktif, dan delegasi berikutnya mewarisi
354
+ WorkMode parent yang aktif. WorkMode TIDAK bisa dinaikkan otomatis oleh
355
+ model, anak, atau argumen delegasi.
356
+ **Resume (P0.2 Q5 — menggantikan D-2):** WorkMode DIPERSIST di metadata sesi
357
+ (`sessions.work_mode`) lintas `--resume`. Saat resume tanpa sinyal eksplisit
358
+ (`--work-mode` / `MINICODE_WORK_MODE`), WorkMode dipulihkan dari metadata
359
+ sesi (baris legacy tanpa `work_mode` kembali ke default `EXECUTE`) dan
360
+ composition root menulis SATU baris stderr human-facing
361
+ (`[resume] WorkMode <MODE> restored from session...` atau notice override/
362
+ legacy) agar otoritas sesi hasil resume selalu terlihat eksplisit. Baris itu
363
+ keluar lewat stderr, BUKAN proyeksi mesin/JSON/ACP — kanal machine tetap
364
+ terstruktur (`summary.workMode` / `result.workMode`), tanpa teks dekoratif.
365
+ **Surfacing lintas-surface (F-DISCUSS-4):** WorkMode terlihat di TUI lewat
366
+ footer (`<WorkMode>·<permission mode>`), di one-shot/exec linear lewat SATU
367
+ baris stderr human-facing `[work-mode] <MODE> …` hanya saat WorkMode ≠
368
+ EXECUTE (EXECUTE = default, tanpa baris), dan di `exec --json` lewat field
369
+ terstruktur `summary.workMode` (selalu hadir, termasuk EXECUTE) — bukan teks
370
+ dekoratif. ACP memakai `params.workMode` (terstruktur) dan tak menambah baris
371
+ dekoratif. WorkMode selalu dibedakan tegas dari PermissionMode (`[work-mode]`
372
+ vs `/mode`/`--plan`) dan dari status sesi.
340
373
  **Pemisahan dari permission mode:** Tab/Shift+Tab dan `/mode` TETAP
341
374
  khusus permission mode — WorkMode tak masuk siklus Tab. Permission mode
342
375
  yang memutuskan allow/deny per tool; WorkMode memilih postur
@@ -369,7 +402,9 @@ belakang + kotak terpusat (form di dalam) + Esc tutup · approval tercatat ·
369
402
  `/status`, `/history`, `/help` ringkas & `/expand` mengalir ke transkrip ·
370
403
  `/mode` = permission mode · `/work-mode` = WorkMode (intent layer) ·
371
404
  Projection V2: `› name target … running`, ledger status ber-glyph/kata,
372
- retry/grup anak, ringkasan turn, dan marker evict sesuai flag ·
405
+ retry/grup anak (anak ber-identitas run = baris `↳ run_<8>` sendiri; tanpa
406
+ identitas run = hitungan `n child tools`), ringkasan turn, dan marker evict
407
+ sesuai flag ·
373
408
 
374
409
  `Esc` saat turn = abort (+ hint sekali); busy = input beku total ·
375
410
  Mouse wheel = scroll transkrip, PgUp/PgDn = scroll, Shift+PgUp/PgDn = setengah
@@ -430,17 +465,40 @@ panjang).
430
465
  - `test/tui-transcript.test.ts` — I7/I12/I17/I22 (ledger satu baris per tool, cap 5000 + marker evict, `total()` monotonik kebal evict, viewport, thinking minimized/expanded).
431
466
  - `test/presentation-projections.test.ts` — I12/I17/I32 (projection
432
467
  snapshot, running/elapsed, status terminal, retry/child grouping, summary,
433
- marker evict + `total()` monotonik, dan parity flag OFF).
468
+ marker evict + `total()` monotonik, dan parity flag OFF) + F-AGENT-1
469
+ (baris per-run `↳ run_<8>`/`sub_<8>` untuk anak ber-identitas run; tiga anak
470
+ paralel = tiga baris; anak tanpa identitas run tetap satu baris ledger induk
471
+ `n child tools`) + F-TASK-1 (baris ledger `t<n> <status> parent=… dependsOn=[…]
472
+ r<rev>`; jalur **linear** merender baris sama + proyeksi `normal`
473
+ mempertahankan notice task — PROMPT 06 Area D).
434
474
  - `test/presentation-linear-acp.test.ts` — I33 (linear projection
435
- status/duration/receipt dan lifecycle ACP terstruktur; parity policy-vs-legacy).
475
+ status/duration/receipt dan lifecycle ACP terstruktur; parity policy-vs-legacy)
476
+ + PROMPT 06 Area D (`task.status` → baris ledger linear **dan** envelope ACP
477
+ berfield `taskId`/`status`/`parentId`/`dependsOn`/`revision`).
436
478
  - `test/presentation-policy.test.ts` — I32/I33 (seleksi node per mode, envelope
437
- machine, digest divergensi; purity tanpa clock/IO).
479
+ machine, digest divergensi; purity tanpa clock/IO) + PROMPT 06 Area D
480
+ (notice `task.status` **ikut mode `normal`** dengan field terstruktur utuh).
438
481
  - `test/writer-inventory.test.ts` — OAP-008 (setiap writer langsung terdaftar
439
482
  dengan owner; jumlah tak boleh naik diam-diam).
440
483
  - `test/exec-json-envelope.test.ts` + `test/cli-session.test.ts` (envelope
441
484
  machine) — I28/I33/I34 (summary berversi, tanpa ANSI/secret, tanpa raw
442
485
  kernel; P11.2 scoping prompt: flag-mendahului vs `exec`-dahulu identik,
443
486
  kata `exec` milik user tetap utuh).
487
+ - PROMPT 06 Area A — `test/ui-instance-isolation.test.ts`: state renderer
488
+ per-instans (dua sesi nyata; env = bootstrap saja).
489
+ - PROMPT 06 Area B — `test/approval-integrity.test.ts`: binding args-hash +
490
+ fingerprint target difoto sebelum prompt dan diverifikasi di barrier efek
491
+ (deny `"stale"` bila berubah), termasuk jalur kernel nyata.
492
+ - PROMPT 06 Area C — `test/daemon-stream-phase.test.ts`: `subscribed.phase` +
493
+ `tail_marker.phase` dari latch per-langganan; badge `" [replay]"`.
494
+ - PROMPT 06 Area E — `test/memory-consistency.test.ts`: degradasi vector
495
+ terlihat di hasil tool, revoke provenance AND (fail-closed), reconcile
496
+ mengadopsi (bukan menghapus) vector-only, fakta panjang utuh, supersession
497
+ menarik baris lama, lupa menghapus entri multi-chunk utuh, cap per-entri,
498
+ validasi respons embedding.
499
+ - PROMPT 06 Area F — `test/ci-glob-expansion.test.ts`: `ci-windows` memakai
500
+ `shell: bash` (pwsh tak mengekspansi glob → suite p15..p24 lolos diam-diam),
501
+ pola mati dihapus, subset p15..p24 hadir di kedua job.
444
502
 
445
503
  - `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
446
504
  anti-hantu).
@@ -457,19 +515,22 @@ panjang).
457
515
  termasuk nilai invalid; `/mode` + Shift+Tab tak menyentuh WorkMode; label
458
516
  footer `PLAN·auto`/`DISCUSS·auto`).
459
517
  - `test/work-mode-contract.test.ts` — I35 (ceiling handler WorkMode di atas
460
- handler PM: 18 sel matriks, gerbang approval `PLAN × auto/ask`, `describeDenial`
461
- per pemilik keputusan, `always`/K-1 tetap utuh, `__setMode` tak mencabut
462
- ceiling).
518
+ handler PM: 18 sel matriks, gerbang approval `PLAN × PM` termasuk `web_fetch`/
519
+ `web_search`, `DISCUSS` memblokir network read, `describeDenial` per pemilik
520
+ keputusan, `always`/K-1 tetap utuh, `__setMode` tak mencabut ceiling).
463
521
  - `test/work-mode-tool-visibility.test.ts` — I35 (visibilitas tool = irisan
464
- permission mode ∧ WorkMode; `PLAN × readonly` tak memperluas readonly;
522
+ permission mode ∧ WorkMode; `DISCUSS` tepat 16 tool baca lokal tanpa network
523
+ read; `PLAN × readonly/allowlist` tak memperluas di luar 18 `READONLY_TOOL_NAMES`;
465
524
  tool MCP ikut dibatasi).
466
- - `test/work-mode-hooks.test.ts` — I35 (hooks: `DISCUSS` menahan, `PLAN`/
467
- `EXECUTE` mengikuti permission mode; pemanggil lama tanpa WorkMode kompatibel).
525
+ - `test/work-mode-hooks.test.ts` — I35 (hooks: `DISCUSS` dan `PLAN` menahan
526
+ semua `.minicode/hooks/*` di seluruh `PermissionMode`; hanya `EXECUTE` yang
527
+ mengikuti permission mode; pemanggil lama tanpa WorkMode kompatibel).
468
528
  - `test/work-mode-subagent.test.ts` — I35 (child mewarisi WorkMode parent;
469
529
  tak ada eskalasi lewat mode child; default tanpa WorkMode = perilaku lama).
470
- - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > default
471
- EXECUTE; nilai invalid → EXECUTE + peringatan; ACP `workMode` terpisah dari
472
- `mode`).
530
+ - `test/work-mode-cli.test.ts` — I35 (`--work-mode`/env: flag > env > persisted
531
+ resume > default EXECUTE; nilai invalid → EXECUTE + peringatan; `--verify`
532
+ ditolak fail-closed pada DISCUSS/PLAN; ACP `workMode` + fallback env; daemon
533
+ `workMode` parity).
473
534
  - `test/tui-app.test.ts`, `test/tui-popup.test.ts` — I13/I17 (composer
474
535
  editing/busy, dots clock, timer, cursor, resize, popup). *Klausul "satu baris
475
536
  kosong memisahkan composer dari footer" TIDAK punya assertion — lihat
@@ -556,6 +617,11 @@ panjang).
556
617
  sebagai proses biasa tanpa PTY (lihat komentar di berkasnya) — jadi ia
557
618
  bukan bukti byte stream; bukti envelope ada di `test/exec-json-envelope.test.ts`.*
558
619
  Platform tak mampu (ConPTY rusak) = SKIP beralasan, bukan hijau palsu.
620
+ Verifikasi **exit code** (I28) hanya dijalankan di POSIX: Windows ConPTY
621
+ terbukti kadang melaporkan `exitCode: undefined` untuk anak yang keluar via
622
+ PTY interaktif (satu probe sukses TIDAK menjamin run berikutnya), sehingga
623
+ test di-SKIP beralasan di Windows — bukan diluluskan dan bukan dianggap
624
+ "berhasil".
559
625
  Jalur mouse SGR punya capability gate (`ptySgrMouseDelivered()`): transport
560
626
  yang TAK mengantarkan byte SGR → SKIP beralasan; probe tak konklusif → SKIP
561
627
  dengan alasan "tak konklusif" (BUKAN bukti SGR tak didukung); di CI Linux
@@ -577,3 +643,4 @@ kata-kata di sini TIDAK menutup gap.
577
643
  | I5 — tak ada popup yatim / input bocor setelah success/failure/cancel/SIGINT/session end | Tak terverifikasi | `test/turn-status.test.ts` dan `test/statusline-bun-guard.test.ts` tidak meng-assert apa pun soal popup yatim atau kebocoran input. |
578
644
  | I26 pada jalur presentasi | i18n ada dan dijaga terpisah | `test/presentation-projections.test.ts` mengunci locale `en` di setiap test dan tak pernah menguji locale `id`; klaim i18n dijaga `test/i18n.test.ts` + `test/i18n-hardcode.test.ts`. |
579
645
  | I2/I6/I28 pada proyeksi linear/ACP | Alur linear/ACP ada | `test/presentation-linear-acp.test.ts` tak meng-assert split stdout/stderr, absence cursor-control, maupun exit code secara langsung. |
646
+ | I3 — tak ada byte stdout bocor selama alternate-screen | Terimplementasi (TUI menulis UI ke stderr; stdout khusus pipe/envelope) | Belum ada test PTY yang meng-assert "stream stdout kosong selama alt-screen aktif" (hanya fake-TTY). Juga: job `ci-windows` TIDAK pernah menjalankan `pty*.test.ts` — suite PTY hanya tercapai lewat glob `test/p*.test.ts` di job ubuntu. |
package/docs/agents.md CHANGED
@@ -12,9 +12,9 @@ Approval: `delegate_task` di-gate — TTY meminta persetujuan sekali per delegas
12
12
  | Mode anak | Kemampuan |
13
13
  |---|---|
14
14
  | `explore` | Subset read-only (12 tool) — cari/pahami kode, kembalikan temuan |
15
- | `plan` | Read-only + `todo_read` (baca rencana parent), tetap tanpa mutasi dan tanpa `todo_write` |
15
+ | `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode/PM ketat** (`PLAN`/`DISCUSS`/`readonly`/`plan`/`ask`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `EXECUTE`×auto/allow-all**: tool dasar parent (read + file-write + `bash`/`code_run`), minus MCP runtime, `git_commit`, memory-tulis, todo-tulis, dan job background |
16
16
 
17
- Restriksi anak (selalu, tanpa kecuali): **tanpa** MCP, `git_commit`, memory-tulis, todo-tulis, job background, nesting (anak tidak bisa mendelegasi lagi). Plan-parent dipaksa explore saat mendelegasi.
17
+ Restriksi anak yang **selalu** berlaku: anak **tidak** bisa bersarang (`delegate_task` dibuang), tidak bisa `git_commit`, tidak menulis memory/todo, tidak memakai `bash_output`/`bash_kill` (job milik parent). Tool MCP runtime (`server.tool`) hanya muncul pada anak `plan` di bawah parent `EXECUTE`; pada `explore` maupun parent non-`EXECUTE`, daftar anak dibatasi ke `EXPLORE_TOOL_NAMES`. Plan-parent dipaksa explore saat mendelegasi.
18
18
 
19
19
  ## Kenapa dibatasi
20
20
 
package/docs/cli.md CHANGED
@@ -24,6 +24,7 @@ Semua cara menjalankan Minicode: interaktif, sekali jalan, pipe, dan otomasi CI
24
24
  | `minicode skills list` | Daftar skill terpasang |
25
25
  | `minicode sessions list` | Riwayat sesi |
26
26
  | `minicode memory status [--json]` | Statistik vector RAG (rows, size, hit-rate) |
27
+ | `minicode memory reconcile [--json] [--cwd PATH]` | Samakan `vector.db` ↔ `.minicode/MEMORY.md` (adopsi entri vector-only, tambah baris file-only; tidak menghapus) |
27
28
  | `minicode doctor [--json]` | Diagnosis lokal |
28
29
  | `minicode mcp serve` | Ekspos minicode sebagai MCP server |
29
30
 
@@ -29,6 +29,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
29
29
  | Variabel | Fungsi |
30
30
  |---|---|
31
31
  | `MINICODE_LANG` | `en`/`id` → bahasa UI (prioritas lengkap di kontrak terminal §i18n: `/lang` > env ini > state.json > locale OS > en) |
32
+ | `MINICODE_DEBUG_BUS` | `1` → cetak satu baris diagnosis event bus per turn ke stderr (`src/ui/runtime/bus-debug.ts`; diagnostik saja, bukan perilaku) |
32
33
  | `MINICODE_DEBUG_STARTUP` | `1` → cetak durasi tiap tahap setup sesi ke stderr (diagnosis startup lambat; diagnostik saja, bukan perilaku) |
33
34
  | `MINICODE_MINIMIZE_ANSWER` | set (nilai apa pun) → JANGAN auto-minimize section jawaban model (nilai unset = minimize default) |
34
35
  | `MINICODE_KEYSTORE_DISABLE` | `1` → matikan keystore OS seluruhnya (jatuh ke penyimpanan file; untuk CI/headless yang tak punya keychain/DPAPI) |
@@ -13,8 +13,13 @@ Retensi hierarkis per kategori: `fact`/`decision`/`preference` 180 hari, `summar
13
13
 
14
14
  ```bash
15
15
  minicode memory status [--json] # rows, bytes DB/WAL/SHM, sebaran model/dim, hit-rate RAG
16
+ minicode memory reconcile [--json] [--cwd PATH] # samakan vector.db <-> MEMORY.md
16
17
  ```
17
18
 
19
+ `reconcile` mengadopsi entri vector-only ke `MEMORY.md` dan menambah baris file-only
20
+ ke index (tidak menghapus fakta); jalankan bila `write_memory` melaporkan
21
+ "vector index unavailable".
22
+
18
23
  Auto-simpan: summary persist + snippet verify sukses. Opt-out `MINICODE_AUTO_MEMORY=0`.
19
24
 
20
25
  Embedding: default `text-embedding-3-small` (`MINICODE_EMBED_MODEL`). Dim-mismatch → warn sekali + fallback keyword-only. FTS5 (`porter unicode61`) + trigger sync; fallback LIKE bila MATCH gagal.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "minicode-ai",
3
- "version": "0.13.0",
3
+ "version": "0.14.0",
4
4
  "description": "Coding agent CLI built on the frozen MiniCore runtime — tools, MCP, LSP, sandbox, shadow-git checkpoints",
5
5
  "type": "module",
6
6
  "private": false,
@@ -33,7 +33,7 @@
33
33
  "url": "https://github.com/startupmini/minicode/issues"
34
34
  },
35
35
  "bin": {
36
- "minicode": "./cli/index.ts"
36
+ "minicode": "cli/minicode.js"
37
37
  },
38
38
  "imports": {
39
39
  "#minicore": "./vendor/minicore/src/core/index.ts",
@@ -109,6 +109,7 @@
109
109
  "dev": "bun cli/index.ts",
110
110
  "bench": "bun bench/runner.ts",
111
111
  "bench:smoke": "bun bench/runner.ts --fake",
112
+ "bench:render": "bun scripts/bench-render.ts",
112
113
  "gate:eval": "bun bench/eval-gate.ts",
113
114
  "audit:harness": "bun bench/harness-audit.ts",
114
115
  "bench:runs": "bun bench/runner.ts --runs 2",