minicode-ai 0.13.1 → 0.14.1

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 +35 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -0
  4. package/cli/args.ts +66 -5
  5. package/cli/commands/acp.ts +18 -3
  6. package/cli/commands/daemon.ts +114 -19
  7. package/cli/commands/exec.ts +104 -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 +51 -16
  12. package/cli/setup.ts +380 -32
  13. package/cli/tui.ts +115 -50
  14. package/docs/TERMINAL_CONTRACT.md +91 -24
  15. package/docs/agents.md +3 -3
  16. package/docs/choosing-mode.md +20 -13
  17. package/docs/cli.md +12 -11
  18. package/docs/environment.md +4 -3
  19. package/docs/memory-sessions.md +5 -0
  20. package/package.json +2 -1
  21. package/src/app/session.ts +159 -35
  22. package/src/app/tool-layer.ts +69 -62
  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 +317 -41
  40. package/src/policy/tool-contract.ts +94 -0
  41. package/src/policy/usage.ts +3 -1
  42. package/src/policy/work-mode.ts +99 -17
  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 +31 -17
  58. package/src/ui/i18n/en.ts +12 -3
  59. package/src/ui/i18n/id.ts +12 -3
  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 +13 -7
  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/CHANGELOG.md CHANGED
@@ -1,5 +1,40 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.14.1] - 2026-11-05
4
+
5
+ ### Mode Architecture Migration — WorkMode / PermissionMode / Tool Access Policy
6
+
7
+ Pemisahan tiga tanggung jawab yang sebelumnya tercampur pada union `PermissionMode` enam nilai. Audit + laporan migrasi: `docs/audit/MODE_ARCHITECTURE_RECONCILIATION_AUDIT_2026-11-05.md` dan `docs/audit/MODE_ARCHITECTURE_MIGRATION_REPORT_2026-11-05.md`.
8
+
9
+ - **WorkMode** (`DISCUSS` / `PLAN` / `BUILD`): *bagaimana* agent bekerja. `BUILD` adalah nama produk untuk identitas internal `EXECUTE` (alias input + display; persistensi tetap `EXECUTE`). Ceiling kini dibaca langsung dari registry kontrak tool (`ceilingAllows`), bukan lagi dari handler `readonly`/`plan`.
10
+ - **PermissionMode** (`AUTO` / `ASK`): *apakah* butuh izin manusia. `AUTO` = otonomi penuh — capability yang authorized (termasuk `git_commit`, `delegate_task`, `mcp_*`) berjalan tanpa henti persetujuan rutin; `ask_user` ditolak deterministik. `ASK` = pengawasan manusia.
11
+ - **Tool Access Policy**: capability set (`READONLY_TOOL_NAMES`, `LOCAL_READONLY_TOOL_NAMES`, `PLAN_EXTRA_TOOL_NAMES`, bash allowlist, kelas gated) dikonsolidasi pada `src/policy/tool-contract.ts` tanpa registry kedua. `--allowlist`/`--allow-all` tetap sebagai profil akses warisan (deprecated).
12
+ - **Hard security tetap**: jail path, berkas sensitif, owned-state, bash-guard, approval-binding, dan injected `AutonomousPermissionHandler` (batas scheduler) tidak berubah.
13
+ - **TUI/footer/CLI**: `Tab` siklus WorkMode, `Shift+Tab` toggle PermissionMode; footer selalu `BUILD · AUTO`; `--plan` → `WorkMode PLAN` (dengan notice deprecation + **kini dipersist** di `work_mode`).
14
+
15
+ ### Keterbatasan
16
+
17
+ - `git_commit all:true` tetap bisa men-stage perubahan *tracked* lain di workspace dalam satu commit — presisi "perubahan milik task" dijaga oleh `paths` eksplisit + jail, bukan diff-scope tracker.
18
+ - Legacy `--allow-all`/`--allowlist` masih mengalir lewat string `permissionMode`; type `ToolAccessProfile` terpisah ditunda.
19
+ - Resume stderr masih mengeja identitas internal `EXECUTE` (footer/`/status`/help memakai `BUILD`).
20
+
21
+ ## [0.14.0] - 2026-11-05
22
+
23
+ ### WorkMode, observability, reliability & repository consolidation (P0–P2 + P2.3)
24
+
25
+ Integrasi tahap **P0–P2** dan penutupan **P2.3**, lalu **Final Integration & Repository Consolidation**. Detail stage-scoped per subfase ada di `docs/audit/` (P0_FOUNDATION…, P1_…, P2_OPERATIONAL_…, P2_3_OPERATIONAL_…, FINAL_INTEGRATION_…).
26
+
27
+ - **P0 — Kontrak WorkMode** (`DISCUSS`/`PLAN`/`EXECUTE`, lapis intent terpisah dari PermissionMode): registry/dispatch selaras agar tool yang terlihat = yang dapat dieksekusi; network read dilarang di `DISCUSS` dan butuh approval di `PLAN`; hooks/verify digerbangi WorkMode; persistensi & resume WorkMode; parity `daemon`/`ACP`/`exec`.
28
+ - **P1 — Correctness & operator UX**: validasi `supersedes_id` + tombstone dua-arah seluruh chunk memori (tanpa resurrection via reconcile); machine/task observability dengan identitas child-session/run; ACE/verification/denial visibility di TUI; context occupancy ≠ session spend; approval binding dua lapis + `always` hanya bila dapat dipersist; proyeksi error context-window dan peringatan flag setelah prompt.
29
+ - **P2 — State/type & performance**: decoder durable ber-versi `v:1` (fail-safe untuk versi masa depan/payload rusak); keputusan single-session; katalog ownership state; MCP schema-pin **persisten** + pagination + multi-session refcount; daemon `run.interrupt/cancel` nyata + replay backpressure resumable; cache proyeksi transkrip (25–140×) dan index `order` reducer (~30×).
30
+ - **P2.3 — Lifecycle closure**: MCP **bounded reconnect** (retry limit/backoff/jitter/single-flight; pin diverifikasi ulang, drift tetap fail-closed); status recovery daemon untuk run yatim (`INTERRUPTED`/`UNKNOWN`, tanpa auto-resume); producer transisi task **authoritative** (create/update/claim/merge-cancel); guard **single-session** di boundary run; quarantine (bukan fuzzy delete) untuk baris memori legacy yang ambigu.
31
+ - **Feature gates/bench**: audit harness, gate bash, benchmark smoke/render, dan PTY suite tetap hijau. **Keterbatasan terdokumentasi**: subscriptions/notifications MCP belum didukung; `FAILED`/`RETRYING` belum punya producer (keputusan produk); daemon tidak auto-resume; manual TUI UAT & gateway cache UNVERIFIED.
32
+ - **Budget ukuran paket** re-baseline **3.840 → 3.920 KiB** (ukuran aktual 3.902,6 KiB, 22/23 cek `gate:pack` lolos tanpa node_modules/test/secret ikut).
33
+
34
+ ### Konsolidasi repository
35
+
36
+ - Peta dokumen kanonik + status fase aktif di `AGENTS.md`; koreksi budget & semantik sub-agent agar dokumen = implementasi; hapus artefak generated/temp (128 path) tanpa menghapus file historis/user-owned.
37
+
3
38
  ## [0.13.1] - 2026-11-01
4
39
 
5
40
  ### Fixed — bin distribusi `minicode`
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 startupmini
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 startupmini
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -198,3 +198,7 @@ Catatan lingkungan:
198
198
  **MIT License.** Bebas pakai, modifikasi, distribusi — lihat [LICENSE](LICENSE). Copyright (c) 2026 startupmini.
199
199
 
200
200
  Lihat `docs/ARCHITECTURE.html` + `docs/HARNESS.md` + `ROADMAP.md` (roadmap arsitektur aktif) + `PLAN.md` (ledger legacy).
201
+
202
+ ## Status proyek
203
+
204
+ Fase aktif: **Final Integration & Repository Consolidation** — P0–P2 dan penutupan P2.3 berada pada **stage-scoped closure** (tidak ada fase produk P3). Ringkasan kesehatan repository, temuan integrasi, cleanup, dan limitasi: `docs/audit/FINAL_INTEGRATION_AND_REPOSITORY_CONSOLIDATION_REPORT_2026-11-05.md`. Aturan agent dan peta dokumen kanonik: `AGENTS.md` (keduanya di repository, tidak ikut paket npm).
package/cli/args.ts CHANGED
@@ -106,15 +106,28 @@ export type CliWorkMode = "DISCUSS" | "PLAN" | "EXECUTE"
106
106
 
107
107
  /**
108
108
  * P12 S2.2 — Parse nilai WorkMode dari argumen operator (command `/work-mode`).
109
- * Murni + diekspor untuk test. Hanya tiga nilai yang sah; nilai lain = tak
110
- * dikenal (undefined) agar pemanggil bisa menolak tanpa mengubah state.
109
+ * Murni + diekspor untuk test. Tiga nilai sah + alias produk `BUILD` (→ EXECUTE
110
+ * internal); nilai lain = tak dikenal (undefined) agar pemanggil bisa menolak
111
+ * tanpa mengubah state.
111
112
  */
112
113
  export function parseWorkModeValue(raw: string): CliWorkMode | undefined {
113
114
  const norm = raw.trim().toUpperCase()
115
+ // Alias produk: BUILD == identitas runtime/persistence EXECUTE (satu identitas,
116
+ // dua ejaan — bukan enum kedua).
117
+ if (norm === "BUILD") return "EXECUTE"
114
118
  if (norm === "DISCUSS" || norm === "PLAN" || norm === "EXECUTE") return norm
115
119
  return undefined
116
120
  }
117
121
 
122
+ /**
123
+ * Nama produk WorkMode untuk antarmuka pengguna: identitas internal `EXECUTE`
124
+ * ditampilkan sebagai `BUILD`. Dipakai footer, /status, help, dan i18n agar
125
+ * semua permukaan konsisten, tanpa mengubah identitas runtime/persistence.
126
+ */
127
+ export function displayWorkMode(workMode: CliWorkMode): "DISCUSS" | "PLAN" | "BUILD" {
128
+ return workMode === "EXECUTE" ? "BUILD" : workMode
129
+ }
130
+
118
131
  /**
119
132
  * P12 S2.2 — Resolusi WorkMode dari flag CLI + env, murni & diekspor untuk
120
133
  * test (pola repo). Flag `--work-mode` mengalahkan env `MINICODE_WORK_MODE`;
@@ -124,15 +137,21 @@ export function parseWorkModeValue(raw: string): CliWorkMode | undefined {
124
137
  */
125
138
  export function resolveWorkModeFlag(getArg: (n: string) => string | undefined): {
126
139
  workMode: CliWorkMode
140
+ /** Benar bila operator memberi sinyal WorkMode eksplisit (flag ATAU env),
141
+ * terlepas nilainya sah/tidak. Dipakai composition root untuk transparansi
142
+ * resume (D-2): WorkMode TIDAK dipersist, jadi resume tanpa sinyal eksplisit
143
+ * kembali ke EXECUTE dan diberi tahu satu baris. */
144
+ explicit: boolean
127
145
  warning?: string
128
146
  } {
129
147
  const raw = getArg("--work-mode") ?? process.env.MINICODE_WORK_MODE
130
- if (raw === undefined) return { workMode: "EXECUTE" }
148
+ if (raw === undefined) return { workMode: "EXECUTE", explicit: false }
131
149
  const parsed = parseWorkModeValue(raw)
132
- if (parsed) return { workMode: parsed }
150
+ if (parsed) return { workMode: parsed, explicit: true }
133
151
  return {
134
152
  workMode: "EXECUTE",
135
- warning: `--work-mode requires DISCUSS|PLAN|EXECUTE, ignoring "${raw}" (using EXECUTE)`,
153
+ explicit: true,
154
+ warning: `--work-mode requires DISCUSS|PLAN|BUILD, ignoring "${raw}" (using BUILD/EXECUTE)`,
136
155
  }
137
156
  }
138
157
 
@@ -213,6 +232,48 @@ export function promptFromArgs(argv: string[]): string {
213
232
  return out.join(" ")
214
233
  }
215
234
 
235
+ /**
236
+ * [Live Hardening 0.13.x §8.3/§7.1] Daftar flag YANG DIKENAL yang muncul SETELAH
237
+ * prompt boundary (kata prompt pertama, atau separator `--`). `promptFromArgs`
238
+ * sengaja menghentikan pemindaian flag pada boundary itu (pertahanan anti-injeksi),
239
+ * sehingga flag semacam itu menjadi bagian teks prompt — bukan flag yang diparse.
240
+ *
241
+ * Tanpa peringatan, operator yang mengetik `minicode "refactor" --work-mode PLAN`
242
+ * diam-diam menjalankan satu run tanpa work-mode yang diminta (kasus stage5: resume
243
+ * dibuang). Helper ini memurnikan deteksi agar CLI dapat memberi `[warn]` yang
244
+ * actionable. Nama flag di-dedupe menjaga urutan kemunculan; hanya flag dikenal
245
+ * yang dilaporkan (flag tak dikenal memang tak akan pernah dijalankan sebagai flag).
246
+ */
247
+ export function flagsAfterPromptBoundary(argv: string[]): string[] {
248
+ const found: string[] = []
249
+ let afterBoundary = false
250
+ for (let i = 0; i < argv.length; i++) {
251
+ const a = argv[i]
252
+ if (a === undefined) break
253
+ if (a === "--") {
254
+ // Separator eksplisit: semua token setelahnya adalah prompt (flag pun).
255
+ afterBoundary = true
256
+ continue
257
+ }
258
+ if (afterBoundary) {
259
+ const f = flagNameOf(a)
260
+ if (f && !found.includes(f)) found.push(f)
261
+ continue
262
+ }
263
+ const fname = flagNameOf(a)
264
+ if (fname === null) {
265
+ // Token prompt pertama (bukan flag dikenal) → boundary di titik ini;
266
+ // token ini sendiri adalah prompt, bukan flag.
267
+ afterBoundary = true
268
+ continue
269
+ }
270
+ // Flag dikenal SEBELUM boundary: lewati flag + nilainya (bila value flag
271
+ // bentuk terpisah) persis seperti promptFromArgs.
272
+ if (valueFlags.has(fname) && !a.includes("=")) i++
273
+ }
274
+ return found
275
+ }
276
+
216
277
  export function readPrompt(): Promise<string> {
217
278
  if (process.stdin.isTTY) return Promise.resolve("")
218
279
  return new Promise((resolve) => {
@@ -35,6 +35,7 @@ import { createCliSession } from "../setup.ts"
35
35
  // <- {"type":"turn.started|completed|failed|cancelled",...} ...
36
36
  // <- {"type":"file.changed|test.completed|diagnostic.raised|checkpoint.created",...} ...
37
37
  // <- {"type":"plan.updated|finding.detected|result.produced|context.compacted",...} ...
38
+ // <- {"type":"task.status","taskId":"t1","status":"COMPLETED","parentId":"t0",...} ...
38
39
  // <- {"id":2,"result":{"ok":true,"tokens":123,"steps":4,"turns":1,"text":"..."}}
39
40
  // -> {"id":3,"method":"cancel"} (menggugurkan run yang berjalan)
40
41
  // -> {"id":4,"method":"shutdown"} (keluar 0 setelah run selesai/dibatalkan)
@@ -119,9 +120,13 @@ export function parseRunParams(
119
120
  const mode =
120
121
  p.mode === undefined || p.mode === "auto" ? "auto" : p.mode === "plan" ? "plan" : null
121
122
  if (mode === null) return { ok: false, error: 'params.mode must be "auto" or "plan"' }
122
- // P12 S2.2 — WorkMode default EXECUTE; nilai invalid → error (bukan diam
123
- // melebar). Case-insensitive agar konsisten dengan flag CLI.
124
- const wmRaw = p.workMode === undefined ? "EXECUTE" : String(p.workMode).toUpperCase()
123
+ // P12 S2.2 + P0.2 (Q5) — WorkMode: params.workMode eksplisit mengalahkan env
124
+ // MINICODE_WORK_MODE; keduanya absen → EXECUTE. Nilai params.workMode yang
125
+ // invalid ditolak fail-closed (bukan diam melebar).
126
+ const envWmRaw = (process.env.MINICODE_WORK_MODE ?? "").trim().toUpperCase()
127
+ const envWorkMode =
128
+ envWmRaw === "DISCUSS" || envWmRaw === "PLAN" || envWmRaw === "EXECUTE" ? envWmRaw : "EXECUTE"
129
+ const wmRaw = p.workMode === undefined ? envWorkMode : String(p.workMode).toUpperCase()
125
130
  const workMode =
126
131
  wmRaw === "DISCUSS"
127
132
  ? "DISCUSS"
@@ -258,6 +263,15 @@ function projectAcpLifecycle(
258
263
  ...(event.parentToolCallId ? { parentToolCallId: event.parentToolCallId } : {}),
259
264
  ...(event.provenance ? { provenance: event.provenance } : {}),
260
265
  }
266
+ if (event.type === "task.status")
267
+ return {
268
+ ...base,
269
+ ...(event.taskId ? { taskId: event.taskId } : {}),
270
+ ...(event.taskStatus ? { status: event.taskStatus } : {}),
271
+ ...(event.parentId ? { parentId: event.parentId } : {}),
272
+ ...(event.dependsOn?.length ? { dependsOn: event.dependsOn } : {}),
273
+ ...(event.revision !== undefined ? { revision: event.revision } : {}),
274
+ }
261
275
  if (event.type === "diagnostic.raised")
262
276
  return {
263
277
  ...base,
@@ -457,6 +471,7 @@ export async function runAcpSession(
457
471
  ok: true,
458
472
  sessionId: ctx.sessionId,
459
473
  model: ctx.modelRef.current,
474
+ workMode: (ctx as { workMode?: string }).workMode ?? rp.workMode ?? "EXECUTE",
460
475
  tokens: ue.totalTokens,
461
476
  inputTokens: ue.inputTokens,
462
477
  outputTokens: ue.outputTokens,
@@ -18,12 +18,14 @@ import { createStoreFeed } from "../../src/daemon/feed.ts"
18
18
  import type { DaemonHost } from "../../src/daemon/host.ts"
19
19
  import { DAEMON_SCOPES, type DaemonScope } from "../../src/daemon/protocol.ts"
20
20
  import { sanitizeLabel } from "../../src/daemon/sanitize.ts"
21
+ import { VerifyWorkModeConflictError, type WorkMode } from "../../src/policy/work-mode.ts"
21
22
  import { DURABILITY } from "../../src/presentation/events.ts"
22
23
  import {
23
24
  type RuntimeProductionMode,
24
25
  resolveRuntimeMode,
25
26
  } from "../../src/runtime/production-execution.ts"
26
- import { flagNameOf, valueFlags } from "../args.ts"
27
+ import { listSessionRuns } from "../../src/session/persistence.ts"
28
+ import { flagNameOf, resolveWorkModeFlag, valueFlags } from "../args.ts"
27
29
  import type { CliSession, CliSessionOptions } from "../setup.ts"
28
30
 
29
31
  export async function handleDaemon(
@@ -88,7 +90,7 @@ export async function handleDaemon(
88
90
 
89
91
  const DAEMON_HELP = `minicode daemon <mulai|status|stop|issue|sessions|help>
90
92
 
91
- start [--port N] [--cwd D] [--prompt P] [--session S] [--runtime <mode>] [--json]
93
+ start [--port N] [--cwd D] [--prompt P] [--session S] [--runtime <mode>] [--work-mode <mode>] [--json]
92
94
  Jalankan host daemon (blocking). Tanpa --prompt hanya melayani
93
95
  konsumen; dengan --prompt sesi di-host di dalam proses daemon.
94
96
  --runtime constructed|owned menyalakan runtime ter-supervisi pada
@@ -198,6 +200,12 @@ export async function startDaemonHostedRuntime(opts: {
198
200
  * append sesungguhnya).
199
201
  */
200
202
  readonly presentationAppend?: CliSessionOptions["presentationAppend"]
203
+ /**
204
+ * P2.3: jalankan `--prompt` yang di-host. Default false agar tes komposisi
205
+ * yang tidak ingin turn tetap deterministik; `startDaemon` (produksi)
206
+ * menyalakannya.
207
+ */
208
+ readonly autoRunPrompt?: boolean
201
209
  }): Promise<DaemonHostedRuntime> {
202
210
  const { sub, getArg, cwd } = opts
203
211
  const portRaw = getArg("--port")
@@ -212,6 +220,9 @@ export async function startDaemonHostedRuntime(opts: {
212
220
  // [P13.3 Stage C] Scheduler mengikuti mode runtime, bukan flag terpisah:
213
221
  // daemon `owned` memang ingin kerja durable berlanjut; mode lain tetap inert.
214
222
  const schedulerEnabled = schedulerEnabledForDaemon(runtimeMode)
223
+ // P0.2 (Q5): parity WorkMode di daemon (`--work-mode` > `MINICODE_WORK_MODE`
224
+ // > default EXECUTE; invalid = EXECUTE + warning di startDaemon).
225
+ const workModeResolved = resolveWorkModeFlag(getArg)
215
226
 
216
227
  const { DaemonHost } = await import("../../src/daemon/host.ts")
217
228
  const feeds = new Map<string, SessionFeed>()
@@ -227,33 +238,51 @@ export async function startDaemonHostedRuntime(opts: {
227
238
  // lifecycle sesi selesai — termasuk pembersihan anak proses yang disupervisi.
228
239
  let sessionRef: CliSession | null = null
229
240
  let sessionClosed = false
241
+ // P2.3: satu controller untuk run yang sedang berjalan. Interrupt/cancel
242
+ // meng-abort run ini (bukan hanya mengembalikan status palsu).
243
+ let activeRunCtl: AbortController | null = null
230
244
  const closeHostedSession = async (): Promise<void> => {
231
245
  if (sessionClosed) return
232
246
  sessionClosed = true
247
+ try {
248
+ activeRunCtl?.abort(new Error("daemon shutdown"))
249
+ } catch {}
250
+ activeRunCtl = null
233
251
  const s = sessionRef
234
252
  sessionRef = null
235
253
  if (!s) return
236
254
  await s.close()
237
255
  }
238
256
 
257
+ // P2.3: abort run yang benar-benar berjalan. runId dari state kanonik; call
258
+ // dengan runId lain ditolak agar sinyal tidak salah arah ke sesi/run lain.
259
+ const abortHostedRun = (
260
+ sid: string,
261
+ runId: string | null,
262
+ reason: string,
263
+ ): { ok: true } | { ok: false; code: "RUN_TERMINAL" | "SESSION_MISMATCH"; message: string } => {
264
+ const s = sessionRef
265
+ if (!s || s.sessionId !== sid)
266
+ return { ok: false, code: "SESSION_MISMATCH", message: "sesi bukan milik daemon ini" }
267
+ const state = s.runState()
268
+ if (!state.runId || state.status !== "RUNNING")
269
+ return { ok: false, code: "RUN_TERMINAL", message: "tidak ada run aktif untuk dihentikan" }
270
+ if (runId !== null && runId !== state.runId)
271
+ return { ok: false, code: "RUN_TERMINAL", message: `run ${runId} bukan run aktif` }
272
+ if (!activeRunCtl || activeRunCtl.signal.aborted)
273
+ return { ok: false, code: "RUN_TERMINAL", message: "run tidak dapat diinterupsi" }
274
+ activeRunCtl.abort(new Error(reason))
275
+ return { ok: true }
276
+ }
277
+
239
278
  // Aksi kontrol dibangun dari state yang benar-benar diketahui proses ini.
240
279
  // Tanpa sesi yang di-host, operasi yang butuh aksi MENOLAK — bukan berpura-
241
280
  // pura berhasil (lihat control.ts).
242
281
  const actions: ControlActions = {
243
282
  listSessions: () => [...hosted.values()],
244
283
  sessionStatus: (sid) => hosted.get(sid) ?? null,
245
- interrupt: (sid) => {
246
- void sid
247
- return { ok: false, code: "RUN_TERMINAL", message: "tidak ada jalur interupsi pada sesi ini" }
248
- },
249
- cancel: (sid) => {
250
- void sid
251
- return {
252
- ok: false,
253
- code: "RUN_TERMINAL",
254
- message: "tidak ada jalur pembatalan pada sesi ini",
255
- }
256
- },
284
+ interrupt: (sid, runId) => abortHostedRun(sid, runId, "interrupted by daemon operator"),
285
+ cancel: (sid, runId) => abortHostedRun(sid, runId, "cancelled by daemon operator"),
257
286
  shutdown: (reason) => {
258
287
  const h = hostRef
259
288
  if (!h) return
@@ -306,7 +335,9 @@ export async function startDaemonHostedRuntime(opts: {
306
335
  }),
307
336
  plan: false,
308
337
  allowlist: false,
309
- verify: false,
338
+ verify: sub.includes("--verify"),
339
+ workMode: workModeResolved.workMode,
340
+ workModeExplicit: workModeResolved.explicit,
310
341
  // [P13.2] Mode runtime yang sama dengan CLI → komposisi yang di-host
311
342
  // punya jalur ownership proses + status kanonik yang sama.
312
343
  runtimeMode,
@@ -355,13 +386,62 @@ export async function startDaemonHostedRuntime(opts: {
355
386
  sid: session.sessionId,
356
387
  hosted: true,
357
388
  writerEpoch: session.writerEpoch,
358
- runId: null,
359
- runStatus: null,
389
+ // P2.3: status dibaca LIVE dari run kanonik sesi, bukan snapshot null.
390
+ get runId() {
391
+ return session.runState().runId
392
+ },
393
+ get runStatus() {
394
+ return session.runState().status
395
+ },
360
396
  presentationHead: durable.head(),
397
+ get workMode() {
398
+ return session.workMode
399
+ },
400
+ // P2.3: recovery run terakhir yang durable — setelah restart run mati
401
+ // tampil INTERRUPTED + recovery UNKNOWN, tidak pernah disamarkan LIVE.
402
+ get recoveryStatus() {
403
+ try {
404
+ const runs = listSessionRuns(session.sessionId, cwd)
405
+ const last = runs[runs.length - 1]
406
+ return last?.recovery_status ?? null
407
+ } catch {
408
+ return null
409
+ }
410
+ },
361
411
  })
412
+
413
+ if (opts.autoRunPrompt === true && prompt !== undefined && prompt.trim().length > 0) {
414
+ const ctl = new AbortController()
415
+ activeRunCtl = ctl
416
+ void session
417
+ .runPromptWithVerify(prompt, ctl.signal)
418
+ .catch((e) => {
419
+ if (!ctl.signal.aborted) {
420
+ process.stderr.write(`[daemon] hosted run failed: ${(e as Error).message}\n`)
421
+ }
422
+ })
423
+ .finally(() => {
424
+ if (activeRunCtl === ctl) activeRunCtl = null
425
+ })
426
+ }
427
+ } else if (sub.includes("--verify") && workModeResolved.workMode !== "EXECUTE") {
428
+ // P0.2 (Q4): fail-closed sekalipun daemon start dipanggil dengan --verify
429
+ // tanpa --prompt pada mode non-EXECUTE.
430
+ try {
431
+ await host.shutdown("verify-work-mode-conflict")
432
+ } catch {
433
+ /* abaikan error shutdown */
434
+ }
435
+ throw new VerifyWorkModeConflictError(workModeResolved.workMode)
362
436
  }
363
437
 
364
- return { host, session: ctx, closeHostedSession }
438
+ return {
439
+ host,
440
+ session: ctx,
441
+ closeHostedSession,
442
+ workMode: ctx?.workMode ?? workModeResolved.workMode,
443
+ ...(workModeResolved.warning ? { workModeWarning: workModeResolved.warning } : {}),
444
+ }
365
445
  }
366
446
 
367
447
  /**
@@ -377,6 +457,10 @@ export interface DaemonHostedRuntime {
377
457
  readonly session: CliSession | null
378
458
  /** Tutup sesi yang di-host (idempoten). Dipakai daemon saat shutdown. */
379
459
  readonly closeHostedSession: () => Promise<void>
460
+ /** P0.2 (Q5): WorkMode efektif daemon / sesi yang di-host. */
461
+ readonly workMode: WorkMode
462
+ /** P0.2 (Q5): Peringatan bila nilai `--work-mode` / env tidak valid. */
463
+ readonly workModeWarning?: string
380
464
  }
381
465
 
382
466
  async function startDaemon(
@@ -385,7 +469,16 @@ async function startDaemon(
385
469
  cwd: string | undefined,
386
470
  json: boolean,
387
471
  ): Promise<void> {
388
- const { host, session } = await startDaemonHostedRuntime({ sub, getArg, cwd })
472
+ let started: DaemonHostedRuntime
473
+ try {
474
+ started = await startDaemonHostedRuntime({ sub, getArg, cwd, autoRunPrompt: true })
475
+ } catch (e) {
476
+ if (e instanceof VerifyWorkModeConflictError) {
477
+ fail(json ? { ok: false, code: "USER_ERROR", reason: e.message } : null, e.message, 2)
478
+ }
479
+ throw e
480
+ }
481
+ const { host, session, workMode, workModeWarning } = started
389
482
 
390
483
  const lines = [
391
484
  `daemon: listening on ${host.port} (incarnation ${host.incarnation})`,
@@ -398,6 +491,8 @@ async function startDaemon(
398
491
  incarnation: host.incarnation,
399
492
  endpoint: host.endpointPath,
400
493
  hostedSessions: session ? [session.sessionId] : [],
494
+ workMode,
495
+ ...(workModeWarning ? { warning: workModeWarning } : {}),
401
496
  }
402
497
  emit(lines, json ? JSON.stringify(payload) : null)
403
498
 
@@ -1,9 +1,13 @@
1
1
  import { resolve as resolvePath } from "node:path"
2
2
  import { NoProviderError } from "../../src/app/provider-layer.ts"
3
+ // F3.2 parity: exec ikut menghormati MINICODE_COMPACT_KEEP_TURNS, sama seperti
4
+ // jalur one-shot (cli/index.ts) — sebelumnya env ini hanya berlaku di REPL.
5
+ import { parseCompactKeepTurns } from "../../src/policy/compaction.ts"
3
6
  import { createRateLimiter } from "../../src/policy/ratelimit.ts"
4
7
  import { resolveSandbox, sandboxRefusalReason } from "../../src/policy/sandbox-policy.ts"
5
8
  import { scrubSecrets } from "../../src/policy/scrub.ts"
6
9
  import { budgetStatus } from "../../src/policy/usage.ts"
10
+ import { VerifyWorkModeConflictError } from "../../src/policy/work-mode.ts"
7
11
  import {
8
12
  MACHINE_SCHEMA,
9
13
  machineError,
@@ -16,6 +20,7 @@ import { formatUsd } from "../../src/ui/render/money.ts"
16
20
  import { cleanUntrusted } from "../../src/ui/render/sanitize.ts"
17
21
  import {
18
22
  allowLocalConfig,
23
+ flagsAfterPromptBoundary,
19
24
  hasFlag,
20
25
  promptFromArgs,
21
26
  getArg as rawGetArg,
@@ -84,6 +89,15 @@ export async function handleExec(
84
89
  if (sandbox.mode === "none") delete process.env.MINICODE_SANDBOX
85
90
  else process.env.MINICODE_SANDBOX = sandbox.mode
86
91
  const allowlist = allowlistFlag || sandbox.fallbackPermission === "allowlist"
92
+ // [mode-architecture] Deprecation notice utk profil warisan (paritas jalur utama).
93
+ if (allowAll)
94
+ console.error(
95
+ `[deprecated] --allow-all is a privileged access profile (hard jail/guard still apply); treat it as an explicit override, not ordinary AUTO`,
96
+ )
97
+ if (allowlist)
98
+ console.error(
99
+ `[deprecated] --allowlist is a bash/tool access policy; persistent grants remain in ~/.minicode/allowlist.json`,
100
+ )
87
101
  // Audit #07 P0: local config repo tak dipercaya kecuali operator opt-in.
88
102
  const allowLocal = allowLocalConfig(subArgs)
89
103
  const budgetRaw = getArg("--budget")
@@ -108,6 +122,15 @@ export async function handleExec(
108
122
  const workModeResolved = resolveWorkModeFlag(getArg)
109
123
  const workMode = workModeResolved.workMode
110
124
  if (workModeResolved.warning) console.error(`[warn] ${workModeResolved.warning}`)
125
+ // P12 S2.2 (F-DISCUSS-4): exec non-JSON = linear manusia tanpa footer TUI.
126
+ // Mode non-EXECUTE ditulis SATU baris stderr human-facing agar ceiling
127
+ // read-only/rencana terlihat, bukan diam-diam. JSON memakai field terstruktur
128
+ // (summary.workMode) — bukan teks dekoratif. EXECUTE = default = tanpa baris.
129
+ if (!jsonMode && workMode !== "EXECUTE") {
130
+ process.stderr.write(
131
+ `[work-mode] ${workMode}${workMode === "PLAN" ? " (read-only planning)" : " (read-only)"}\n`,
132
+ )
133
+ }
111
134
  const ratelimitRaw = getArg("--ratelimit")
112
135
  let rateLimiter: ReturnType<typeof createRateLimiter> | undefined
113
136
  if (ratelimitRaw) {
@@ -121,10 +144,57 @@ export async function handleExec(
121
144
  }
122
145
  }
123
146
 
147
+ // Live Hardening 0.13.x — parity flag runtime dengan jalur one-shot
148
+ // (cli/index.ts): --max-steps, --context-window, --timeout, dan env
149
+ // MINICODE_COMPACT_KEEP_TURNS kini diteruskan ke sesi. Sebelumnya exec
150
+ // menyaring nilai flag ini dari prompt tetapi tidak pernah menerapkannya —
151
+ // operator mengira batas aktif padahal sesi berjalan dengan default kernel
152
+ // (silently ignored). Parsing + warn tiruan persis jalur one-shot.
153
+ const maxStepsRaw = getArg("--max-steps")
154
+ let maxSteps = maxStepsRaw ? Number(maxStepsRaw) : undefined
155
+ if (maxStepsRaw && (!Number.isFinite(maxSteps) || (maxSteps as number) <= 0)) {
156
+ process.stderr.write(
157
+ `[warn] --max-steps requires a positive number, ignoring "${maxStepsRaw}"\n`,
158
+ )
159
+ maxSteps = undefined
160
+ }
161
+ const ctxWindowRaw = getArg("--context-window")
162
+ let contextWindowTokens = ctxWindowRaw ? Number(ctxWindowRaw) : undefined
163
+ if (
164
+ ctxWindowRaw &&
165
+ (!Number.isFinite(contextWindowTokens) || (contextWindowTokens as number) <= 0)
166
+ ) {
167
+ process.stderr.write(
168
+ `[warn] --context-window requires a positive number, ignoring "${ctxWindowRaw}"\n`,
169
+ )
170
+ contextWindowTokens = undefined
171
+ }
172
+ const keepTurnsRaw = (process.env.MINICODE_COMPACT_KEEP_TURNS ?? "").trim()
173
+ const keepRecentTurns = parseCompactKeepTurns(keepTurnsRaw || undefined)
174
+ if (keepTurnsRaw && keepRecentTurns === undefined)
175
+ process.stderr.write(
176
+ `[warn] MINICODE_COMPACT_KEEP_TURNS requires an integer >= 1, ignoring "${keepTurnsRaw}"\n`,
177
+ )
178
+ const timeoutRaw = getArg("--timeout")
179
+ let timeoutMs = timeoutRaw ? Number(timeoutRaw) : undefined
180
+ if (timeoutRaw && (!Number.isFinite(timeoutMs) || (timeoutMs as number) < 0)) {
181
+ process.stderr.write(
182
+ `[warn] --timeout requires a non-negative number, ignoring "${timeoutRaw}"\n`,
183
+ )
184
+ timeoutMs = undefined
185
+ }
186
+
187
+ const ignoredFlags = flagsAfterPromptBoundary(subArgs)
188
+ if (ignoredFlags.length > 0) {
189
+ process.stderr.write(
190
+ `[warn] ignored flag(s) after the prompt: ${ignoredFlags.join(", ")} — put flags before the prompt (e.g. minicode exec ${ignoredFlags.join(" ")} "your prompt")\n`,
191
+ )
192
+ }
193
+
124
194
  const effectivePrompt = prompt.trim()
125
195
  if (!effectivePrompt) {
126
196
  console.error(
127
- 'usage: minicode exec "prompt" [--json] [--cwd <dir>] [--model <m>] [--sandbox docker|os]',
197
+ 'usage: minicode exec [--json] [--work-mode DISCUSS|PLAN|EXECUTE] [--cwd <dir>] [--model <m>] [--sandbox docker|os] "prompt"',
128
198
  )
129
199
  if (jsonMode)
130
200
  writeMachineLine(
@@ -158,19 +228,36 @@ export async function handleExec(
158
228
  budget,
159
229
  budgetStrict,
160
230
  toolScope,
231
+ // Live Hardening 0.13.x — parity runtime-limit one-shot (lihat blok parse
232
+ // di atas); undefined = default kernel, perilaku lama tak berubah.
233
+ ...(maxSteps ? { maxSteps } : {}),
234
+ ...(contextWindowTokens && contextWindowTokens > 0 ? { contextWindowTokens } : {}),
235
+ ...(keepRecentTurns ? { keepRecentTurns } : {}),
236
+ ...(timeoutMs !== undefined ? { timeoutMs } : {}),
161
237
  // P12 S2.2 — WorkMode efektif (sudah di-resolve, default EXECUTE).
162
238
  workMode,
239
+ workModeExplicit: workModeResolved.explicit,
163
240
  rateLimiter,
164
241
  // Notice hanya bila user eksplisit meminta mode (daemon mati / tak dikenal).
165
242
  sandboxNotice: requestedSandbox ? sandbox.notice : undefined,
166
243
  }).catch((e) => {
167
- // Setup gagal SEBELUM envelope JSON dipasang (tanpa provider): mode
168
- // mesin tetap pulang membawa satu baris summary agar pipeline CI tak
169
- // menerima stream kosong — stderr manusia + exit 1 tidak berubah.
170
- if (e instanceof NoProviderError) {
171
- if (jsonMode) writeMachineLine(JSON.stringify(machineFailure(effectivePrompt, e)))
244
+ // Setup gagal SEBELUM envelope JSON dipasang (tanpa provider / salah pakai):
245
+ // mode mesin tetap pulang membawa satu baris summary agar pipeline CI tak
246
+ // menerima stream kosong — stderr manusia + exit code jujur (2 usage, 1 runtime).
247
+ if (e instanceof NoProviderError || e instanceof VerifyWorkModeConflictError) {
248
+ if (jsonMode) {
249
+ const payload =
250
+ e instanceof VerifyWorkModeConflictError
251
+ ? machineSummary(false, {
252
+ prompt: effectivePrompt,
253
+ workMode,
254
+ error: { category: "USER_ERROR", message: e.message },
255
+ })
256
+ : machineFailure(effectivePrompt, e)
257
+ writeMachineLine(JSON.stringify(payload))
258
+ }
172
259
  console.error(e.message)
173
- process.exit(1)
260
+ process.exit(e instanceof VerifyWorkModeConflictError ? 2 : 1)
174
261
  }
175
262
  // Setup lain yang gagal (config rusak, dsb.): mesin tetap pulang membawa
176
263
  // envelope terminal agar stream tidak kosong, lalu error asli dilempar
@@ -243,7 +330,17 @@ export async function handleExec(
243
330
  steps: ctx.session.state.stepCount,
244
331
  turns: ctx.session.state.turnCount,
245
332
  usage: ue,
333
+ // P1.4: context occupancy/capacity adalah angka berbeda dari session
334
+ // spend (`usage`). Machine consumer harus bisa membedakannya.
335
+ contextTokens: ctx.session.contextTokens,
336
+ ...(ctx.contextWindowTokens ? { contextWindowTokens: ctx.contextWindowTokens } : {}),
337
+ // Cache hanya dilaporkan bila provider benar-benar mengirimnya; absen =
338
+ // UNKNOWN, bukan 0 yang menyiratkan "tidak ada cache".
339
+ ...(ue.cacheReadTokens ? { cacheReadTokens: ue.cacheReadTokens } : {}),
340
+ ...(ue.cacheWriteTokens ? { cacheWriteTokens: ue.cacheWriteTokens } : {}),
246
341
  eventCount: streamed,
342
+ // P12 S2.2 (F-DISCUSS-4) + P0.2: surface terstruktur WorkMode efektif di summary mesin
343
+ workMode: ctx.workMode,
247
344
  ...(submitted ? { submitted: submitted.result } : {}),
248
345
  ...(lastVerify
249
346
  ? {