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.
- package/CHANGELOG.md +35 -0
- package/LICENSE +21 -21
- package/README.md +4 -0
- package/cli/args.ts +66 -5
- package/cli/commands/acp.ts +18 -3
- package/cli/commands/daemon.ts +114 -19
- package/cli/commands/exec.ts +104 -7
- package/cli/commands/mcp.ts +66 -5
- package/cli/commands/memory.ts +46 -14
- package/cli/commands.ts +5 -0
- package/cli/index.ts +51 -16
- package/cli/setup.ts +380 -32
- package/cli/tui.ts +115 -50
- package/docs/TERMINAL_CONTRACT.md +91 -24
- package/docs/agents.md +3 -3
- package/docs/choosing-mode.md +20 -13
- package/docs/cli.md +12 -11
- package/docs/environment.md +4 -3
- package/docs/memory-sessions.md +5 -0
- package/package.json +2 -1
- package/src/app/session.ts +159 -35
- package/src/app/tool-layer.ts +69 -62
- package/src/daemon/approvals.ts +25 -1
- package/src/daemon/client.ts +51 -1
- package/src/daemon/control.ts +8 -0
- package/src/daemon/protocol.ts +47 -1
- package/src/daemon/server.ts +45 -9
- package/src/daemon/subscription.ts +25 -1
- package/src/daemon/telemetry.ts +4 -0
- package/src/hooks/run.ts +5 -1
- package/src/mcp/client.ts +349 -90
- package/src/mcp/http-transport.ts +7 -0
- package/src/mcp/transport.ts +5 -0
- package/src/memory/files.ts +69 -3
- package/src/memory/vector.ts +556 -160
- package/src/policy/approval-binding.ts +199 -0
- package/src/policy/context.ts +20 -1
- package/src/policy/executor.ts +44 -5
- package/src/policy/permission.ts +317 -41
- package/src/policy/tool-contract.ts +94 -0
- package/src/policy/usage.ts +3 -1
- package/src/policy/work-mode.ts +99 -17
- package/src/presentation/adapter.ts +157 -7
- package/src/presentation/events.ts +173 -1
- package/src/presentation/model.ts +37 -0
- package/src/presentation/projection.ts +107 -18
- package/src/presentation/reducer.ts +134 -10
- package/src/sandbox/os.ts +18 -1
- package/src/session/persistence.ts +153 -11
- package/src/task/store.ts +43 -3
- package/src/tools/memory.ts +70 -10
- package/src/tools/task.ts +7 -1
- package/src/tools/todo.ts +14 -4
- package/src/ui/approval/prompt.ts +52 -7
- package/src/ui/assistant/simple.ts +160 -57
- package/src/ui/contract.ts +46 -0
- package/src/ui/footer.ts +31 -17
- package/src/ui/i18n/en.ts +12 -3
- package/src/ui/i18n/id.ts +12 -3
- package/src/ui/render/collapse.ts +24 -52
- package/src/ui/render/detail.ts +14 -9
- package/src/ui/render/errors.ts +8 -0
- package/src/ui/render/reasoning.ts +13 -8
- package/src/ui/session-state.ts +243 -0
- package/src/ui/tui/app.ts +13 -7
- package/src/ui/tui/transcript.ts +271 -30
- package/vendor/minicore/src/core/budget.ts +25 -25
- package/vendor/minicore/src/core/compact.ts +75 -75
- package/vendor/minicore/src/core/errors.ts +59 -59
- package/vendor/minicore/src/core/events.ts +73 -73
- package/vendor/minicore/src/core/executor.ts +139 -139
- package/vendor/minicore/src/core/history.ts +31 -31
- package/vendor/minicore/src/core/index.ts +41 -41
- package/vendor/minicore/src/core/loop.ts +355 -355
- package/vendor/minicore/src/core/permission.ts +22 -22
- package/vendor/minicore/src/core/provider.ts +39 -39
- package/vendor/minicore/src/core/recovery.ts +35 -35
- package/vendor/minicore/src/core/session.ts +327 -327
- package/vendor/minicore/src/core/snapshot.ts +146 -146
- package/vendor/minicore/src/core/tokens.ts +107 -107
- package/vendor/minicore/src/core/tool.ts +115 -115
- package/vendor/minicore/src/core/types.ts +50 -50
- package/vendor/minicore/src/providers/openai-compat.ts +417 -417
package/cli/tui.ts
CHANGED
|
@@ -24,27 +24,19 @@ 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
|
-
import { parseWorkModeValue } from "./args.ts"
|
|
39
|
+
import { displayWorkMode, parseWorkModeValue } from "./args.ts"
|
|
48
40
|
import {
|
|
49
41
|
BUILTIN_COMMANDS,
|
|
50
42
|
type CommandContext,
|
|
@@ -55,9 +47,20 @@ import {
|
|
|
55
47
|
} from "./commands.ts"
|
|
56
48
|
import type { CliSession } from "./setup.ts"
|
|
57
49
|
|
|
58
|
-
|
|
50
|
+
// [mode-architecture] Approval axis (PermissionMode) = AUTO/ASK; operating axis
|
|
51
|
+
// (WorkMode) = DISCUSS/PLAN/BUILD, dikelola terpisah via /work-mode. Nilai
|
|
52
|
+
// internal tetap lowercase (auto/ask) dan EXECUTE (identitas BUILD).
|
|
53
|
+
const PERMISSION_MODES = ["auto", "ask"] as const
|
|
54
|
+
const WORK_MODE_CYCLE = ["DISCUSS", "PLAN", "EXECUTE"] as const
|
|
59
55
|
// /expand [id]: tanpa arg = semua entry store; dengan id = satu tool.
|
|
60
|
-
const DRIVER_COMMANDS = [
|
|
56
|
+
const DRIVER_COMMANDS = [
|
|
57
|
+
"/compact",
|
|
58
|
+
"/thinking",
|
|
59
|
+
"/expand [id]",
|
|
60
|
+
"/minimize",
|
|
61
|
+
"/mode",
|
|
62
|
+
"/work-mode",
|
|
63
|
+
]
|
|
61
64
|
|
|
62
65
|
function fmtCtx(n: number): string | undefined {
|
|
63
66
|
if (!Number.isFinite(n) || n <= 0) return undefined
|
|
@@ -67,6 +70,32 @@ function fmtCtx(n: number): string | undefined {
|
|
|
67
70
|
return `${(n / 1000000).toFixed(1)}m`
|
|
68
71
|
}
|
|
69
72
|
|
|
73
|
+
/**
|
|
74
|
+
* F-CTX-1: metrik usage footer (biaya + window %) dari angka NYATA, tanpa
|
|
75
|
+
* perkiraan. Kosong = tak ada data relevan (belum belanja / flag window tak
|
|
76
|
+
* disetel) — footer tak pernah menampilkan persentase/biaya palsu.
|
|
77
|
+
*/
|
|
78
|
+
function fmtUsageMetrics(ctx: CliSession): string | undefined {
|
|
79
|
+
const cost: number | undefined = ctx.usage.getSession().cost
|
|
80
|
+
const windowTokens: number | undefined = ctx.contextWindowTokens
|
|
81
|
+
// P1.4: persentase footer = OCCUPANCY konteks saat ini, bukan total token
|
|
82
|
+
// yang sudah dibelanjakan sepanjang sesi. Memakai spend membuat footer
|
|
83
|
+
// mentok 100% setelah beberapa step meski konteks masih jauh di bawah window.
|
|
84
|
+
const used: number = ctx.session.contextTokens
|
|
85
|
+
const parts: string[] = []
|
|
86
|
+
if (cost !== undefined && Number.isFinite(cost) && cost > 0) parts.push(formatUsd(cost))
|
|
87
|
+
if (
|
|
88
|
+
windowTokens !== undefined &&
|
|
89
|
+
Number.isFinite(windowTokens) &&
|
|
90
|
+
windowTokens > 0 &&
|
|
91
|
+
Number.isFinite(used)
|
|
92
|
+
) {
|
|
93
|
+
const pct = Math.min(100, Math.round((used / windowTokens) * 100))
|
|
94
|
+
parts.push(`${pct}%`)
|
|
95
|
+
}
|
|
96
|
+
return parts.length ? parts.join(" ") : undefined
|
|
97
|
+
}
|
|
98
|
+
|
|
70
99
|
/**
|
|
71
100
|
* Tangkap console.log/error selama `fn` → baris teks (tanpa warna liar:
|
|
72
101
|
* caller yang mewarnai). Dipakai membungkus handleBuiltinCommand supaya
|
|
@@ -123,14 +152,17 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
123
152
|
schedulerObservability,
|
|
124
153
|
} = ctx
|
|
125
154
|
const { session } = ctx
|
|
155
|
+
// [Area A · PROMPT 06] State UI sesi. `runTui` juga dijalankan fixture tes
|
|
156
|
+
// dengan CliSession parsial — absen berarti pakai instance default.
|
|
157
|
+
const ui: UiSessionState = ctx.uiState ?? defaultUiState
|
|
126
158
|
const getPresentationSnapshot = () =>
|
|
127
159
|
typeof ctx.getPresentationSnapshot === "function"
|
|
128
160
|
? ctx.getPresentationSnapshot()
|
|
129
161
|
: { activities: [], turns: [] }
|
|
130
162
|
|
|
131
163
|
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)
|
|
164
|
+
if (process.env.MINICODE_COMPACT === undefined) ui.setCompactMode(true)
|
|
165
|
+
if (process.env.MINICODE_MINIMIZE_TOOL === undefined) ui.setSectionMinimized("tool", true)
|
|
134
166
|
let warned80 = false
|
|
135
167
|
let abort: AbortController | null = null
|
|
136
168
|
|
|
@@ -146,6 +178,8 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
146
178
|
const transcript = new Transcript(session.events as unknown as UiBus, {
|
|
147
179
|
getSnapshot: getPresentationSnapshot,
|
|
148
180
|
onPresentationEvent: ctx.onPresentationEvent,
|
|
181
|
+
// [Area A · PROMPT 06] State sesi yang sama dengan printer linier.
|
|
182
|
+
uiState: ui,
|
|
149
183
|
policy: {
|
|
150
184
|
describeActivity,
|
|
151
185
|
matchTurn: matchTurnBySummary,
|
|
@@ -184,6 +218,14 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
184
218
|
usage,
|
|
185
219
|
skills: allLoadedSkills,
|
|
186
220
|
toolsCount: sessionTools.length,
|
|
221
|
+
// P1.2: dua dimensi selalu terbaca live di /status — bukan snapshot boot.
|
|
222
|
+
// [mode-architecture] /status memakai nilai PRODUK (BUILD/AUTO/ASK).
|
|
223
|
+
get workMode() {
|
|
224
|
+
return displayWorkMode(workModeControl?.getWorkMode() ?? "EXECUTE")
|
|
225
|
+
},
|
|
226
|
+
get permissionMode() {
|
|
227
|
+
return (permissions?.getMode() ?? mode).toUpperCase()
|
|
228
|
+
},
|
|
187
229
|
providerHint: cfg.providers[0]?.providerHint,
|
|
188
230
|
setModelOverride: (m) => persistModelChoice(m, modelRef),
|
|
189
231
|
// Spawn anak stdio-inherit (/sessions <id>): keluar alt-screen + cooked
|
|
@@ -226,14 +268,24 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
226
268
|
return all.filter((t) => t.startsWith(line))
|
|
227
269
|
}
|
|
228
270
|
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
271
|
+
// Tab: cycle WorkMode (DISCUSS → PLAN → BUILD → DISCUSS). Hanya command ini
|
|
272
|
+
// (beserta /work-mode) yang menggeser operating mode — TIDAK permission mode.
|
|
273
|
+
const cycleWorkMode = (dir: 1 | -1): void => {
|
|
274
|
+
if (!workModeControl) return // policy terinjeksi = tanpa kontrol (fail-closed)
|
|
275
|
+
const current = workModeControl.getWorkMode() ?? "EXECUTE"
|
|
276
|
+
const idx = (WORK_MODE_CYCLE as readonly string[]).indexOf(current)
|
|
277
|
+
if (idx === -1) return
|
|
278
|
+
const next = WORK_MODE_CYCLE[(idx + dir + WORK_MODE_CYCLE.length) % WORK_MODE_CYCLE.length]!
|
|
279
|
+
workModeControl.setWorkMode(next)
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
// Shift+Tab: toggle PermissionMode (AUTO ↔ ASK). Tidak ada privilege change
|
|
283
|
+
// diam — hanya sumbu persetujuan.
|
|
284
|
+
const togglePermissionMode = (): void => {
|
|
285
|
+
if (!permissions) return
|
|
286
|
+
const next = permissions.getMode() === "ask" ? "auto" : "ask"
|
|
287
|
+
permissions.setMode(next)
|
|
234
288
|
mode = next
|
|
235
|
-
if (permissions) permissions.setMode(mode as (typeof MODES)[number])
|
|
236
|
-
else mode = permissionMode ?? mode
|
|
237
289
|
}
|
|
238
290
|
|
|
239
291
|
async function runBuiltin(
|
|
@@ -343,8 +395,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
343
395
|
function helpConcise(): void {
|
|
344
396
|
// Diturunkan dari registry (BUILTIN + driver) — perintah baru tak bisa
|
|
345
397
|
// hilang dari /help diam-diam (satu sumber, bukan daftar hardcode).
|
|
398
|
+
// Set menjaga urutan deklarasi sekaligus mencegah duplikasi saat perintah
|
|
399
|
+
// driver terdaftar di completion (DRIVER_COMMANDS) dan help (DRIVER_HELP_COMMANDS).
|
|
346
400
|
const builtin = BUILTIN_COMMANDS.map((b) => `/${b.name}`).join(" ")
|
|
347
|
-
const driver = [
|
|
401
|
+
const driver = [
|
|
402
|
+
...new Set([...DRIVER_COMMANDS, ...DRIVER_HELP_COMMANDS.map((b) => `/${b.name}`)]),
|
|
403
|
+
].join(" ")
|
|
348
404
|
transcript.pushInfo([
|
|
349
405
|
t("help.cHead"),
|
|
350
406
|
` ${builtin}`,
|
|
@@ -362,7 +418,10 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
362
418
|
}
|
|
363
419
|
|
|
364
420
|
async function copyLastTurn(count: number): Promise<void> {
|
|
365
|
-
|
|
421
|
+
// [Area A · PROMPT 06] Buffer /copy milik SESI ini (bukan singleton modul)
|
|
422
|
+
// — sesi lain di proses yang sama tak ikut tercampur.
|
|
423
|
+
const turns = ui
|
|
424
|
+
.getLastTurnTexts(count)
|
|
366
425
|
.map((turn) => turn.trim())
|
|
367
426
|
.filter(Boolean)
|
|
368
427
|
const txt = turns.join("\n\n").trim()
|
|
@@ -400,33 +459,35 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
400
459
|
app.clearView()
|
|
401
460
|
return
|
|
402
461
|
}
|
|
462
|
+
// [mode-architecture] /mode = PermissionMode (persetujuan AUTO/ASK) SAJA.
|
|
403
463
|
if (name === "mode") {
|
|
404
464
|
if (args) {
|
|
405
|
-
|
|
406
|
-
|
|
465
|
+
const norm = args.toLowerCase()
|
|
466
|
+
if (!(PERMISSION_MODES as readonly string[]).includes(norm)) {
|
|
467
|
+
transcript.pushInfo([c.muted(t("tui.unknownMode", { a: args, modes: "AUTO, ASK" }))])
|
|
407
468
|
return
|
|
408
469
|
}
|
|
409
|
-
mode =
|
|
410
|
-
permissions?.setMode(
|
|
470
|
+
mode = norm
|
|
471
|
+
permissions?.setMode(norm as (typeof PERMISSION_MODES)[number])
|
|
411
472
|
} else {
|
|
412
|
-
|
|
473
|
+
togglePermissionMode()
|
|
413
474
|
}
|
|
414
|
-
transcript.pushInfo([c.muted(t("tui.modeLine", { m: mode }))])
|
|
475
|
+
transcript.pushInfo([c.muted(t("tui.modeLine", { m: mode.toUpperCase() }))])
|
|
415
476
|
return
|
|
416
477
|
}
|
|
417
|
-
//
|
|
418
|
-
// Aksi operator EKSPLISIT
|
|
419
|
-
// Tab/Shift+Tab dan `/mode` tetap khusus permission mode.
|
|
478
|
+
// [mode-architecture] /work-mode = WorkMode (operating mode) SAJA.
|
|
479
|
+
// Aksi operator EKSPLISIT untuk operating mode; Tab/Shift+Tab = pintasan.
|
|
420
480
|
if (name === "work-mode") {
|
|
421
481
|
const current = workModeControl?.getWorkMode() ?? "EXECUTE"
|
|
482
|
+
const currentDisplay = displayWorkMode(current)
|
|
422
483
|
if (!args) {
|
|
423
|
-
transcript.pushInfo([c.muted(t("tui.workModeUsage", { m:
|
|
484
|
+
transcript.pushInfo([c.muted(t("tui.workModeUsage", { m: currentDisplay }))])
|
|
424
485
|
return
|
|
425
486
|
}
|
|
426
487
|
const next = parseWorkModeValue(args)
|
|
427
488
|
if (!next) {
|
|
428
489
|
transcript.pushInfo([
|
|
429
|
-
c.muted(t("tui.workModeUnknown", { a: args, modes: "DISCUSS, PLAN,
|
|
490
|
+
c.muted(t("tui.workModeUnknown", { a: args, modes: "DISCUSS, PLAN, BUILD" })),
|
|
430
491
|
])
|
|
431
492
|
return
|
|
432
493
|
}
|
|
@@ -437,7 +498,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
437
498
|
return
|
|
438
499
|
}
|
|
439
500
|
workModeControl.setWorkMode(next)
|
|
440
|
-
transcript.pushInfo([c.muted(t("tui.workModeLine", { m: next }))])
|
|
501
|
+
transcript.pushInfo([c.muted(t("tui.workModeLine", { m: displayWorkMode(next) }))])
|
|
441
502
|
return
|
|
442
503
|
}
|
|
443
504
|
if (name === "lang") {
|
|
@@ -462,20 +523,20 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
462
523
|
}
|
|
463
524
|
if (name === "compact") {
|
|
464
525
|
const next = args === "" ? undefined : args === "on" || args === "1"
|
|
465
|
-
const compact = setCompactMode(next)
|
|
526
|
+
const compact = ui.setCompactMode(next)
|
|
466
527
|
transcript.pushInfo([c.muted(t("tui.toolCall", { v: compact ? "compact" : "expanded" }))])
|
|
467
528
|
return
|
|
468
529
|
}
|
|
469
530
|
if (name === "thinking") {
|
|
470
531
|
const next = args === "" ? undefined : args === "on" || args === "1"
|
|
471
|
-
const vis = setReasoningVisible(next)
|
|
532
|
+
const vis = ui.setReasoningVisible(next)
|
|
472
533
|
transcript.pushInfo([c.muted(t("tui.thinkingSet", { v: vis ? "expanded" : "minimized" }))])
|
|
473
534
|
return
|
|
474
535
|
}
|
|
475
536
|
if (name === "expand") {
|
|
476
537
|
const sections = args ? ctx.expandContent(args) : ctx.expandAllContent()
|
|
477
|
-
const views = args ? [] : collapsedSectionsSnapshot()
|
|
478
|
-
if (!args) clearCollapsedSections()
|
|
538
|
+
const views = args ? [] : ui.collapsedSectionsSnapshot()
|
|
539
|
+
if (!args) ui.clearCollapsedSections()
|
|
479
540
|
if (!sections.length && !views.length) {
|
|
480
541
|
transcript.pushInfo([c.muted(t("tui.expandEmpty"))])
|
|
481
542
|
return
|
|
@@ -501,15 +562,15 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
501
562
|
if (name === "minimize") {
|
|
502
563
|
const arg = args.trim().toLowerCase()
|
|
503
564
|
let next: boolean | undefined
|
|
504
|
-
if (arg === "") next = !(sectionMinimized("tool") && sectionMinimized("answer"))
|
|
565
|
+
if (arg === "") next = !(ui.sectionMinimized("tool") && ui.sectionMinimized("answer"))
|
|
505
566
|
else if (arg === "on" || arg === "1") next = true
|
|
506
567
|
else if (arg === "off" || arg === "0") next = false
|
|
507
568
|
else {
|
|
508
569
|
transcript.pushInfo([c.muted(t("tui.minUse"))])
|
|
509
570
|
return
|
|
510
571
|
}
|
|
511
|
-
setSectionMinimized("tool", next)
|
|
512
|
-
setSectionMinimized("answer", next)
|
|
572
|
+
ui.setSectionMinimized("tool", next)
|
|
573
|
+
ui.setSectionMinimized("answer", next)
|
|
513
574
|
transcript.pushInfo([c.muted(t(next ? "tui.sectionsMin" : "tui.sectionsExp"))])
|
|
514
575
|
return
|
|
515
576
|
}
|
|
@@ -592,6 +653,7 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
592
653
|
model: modelRef.current ?? cfg.providers[0]?.models[0] ?? t("tui.noModel"),
|
|
593
654
|
cwd: cwd ?? process.cwd(),
|
|
594
655
|
context: fmtCtx(session.contextTokens),
|
|
656
|
+
metrics: fmtUsageMetrics(ctx),
|
|
595
657
|
},
|
|
596
658
|
busy: abort != null,
|
|
597
659
|
}
|
|
@@ -611,15 +673,18 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
611
673
|
abort: () => {
|
|
612
674
|
abort?.abort()
|
|
613
675
|
},
|
|
614
|
-
|
|
615
|
-
|
|
676
|
+
cycleWorkMode: (dir) => {
|
|
677
|
+
cycleWorkMode(dir)
|
|
678
|
+
},
|
|
679
|
+
togglePermissionMode: () => {
|
|
680
|
+
togglePermissionMode()
|
|
616
681
|
},
|
|
617
682
|
toggleCompact: () => {
|
|
618
|
-
const compact = setCompactMode()
|
|
683
|
+
const compact = ui.setCompactMode()
|
|
619
684
|
transcript.pushInfo([c.muted(t("tui.toolCall", { v: compact ? "compact" : "expanded" }))])
|
|
620
685
|
},
|
|
621
686
|
toggleReasoning: () => {
|
|
622
|
-
const vis = setReasoningVisible()
|
|
687
|
+
const vis = ui.setReasoningVisible()
|
|
623
688
|
transcript.pushInfo([c.muted(t("tui.thinkingSet", { v: vis ? "expanded" : "minimized" }))])
|
|
624
689
|
},
|
|
625
690
|
}
|
|
@@ -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` (
|
|
325
|
-
`
|
|
326
|
-
(
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
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
|
|
337
|
-
aktif, dan delegasi berikutnya mewarisi
|
|
338
|
-
WorkMode TIDAK bisa dinaikkan otomatis oleh
|
|
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
|
|
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 ×
|
|
461
|
-
|
|
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; `
|
|
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`
|
|
467
|
-
|
|
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 >
|
|
471
|
-
EXECUTE; nilai invalid → EXECUTE + peringatan;
|
|
472
|
-
`
|
|
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
|
@@ -5,16 +5,16 @@
|
|
|
5
5
|
|
|
6
6
|
Sub-agent = instans agent dengan **context terpisah** dari parent: memory, signal, dan budget sendiri. Pool concurrency 3 — maksimum 3 sub-agent hidup sekaligus — dan abort-aware (mewarisi AbortSignal parent; parent batal → anak berhenti).
|
|
7
7
|
|
|
8
|
-
Approval: `delegate_task` di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
|
|
8
|
+
Approval: `delegate_task` di-**ASK** di-gate — TTY meminta persetujuan sekali per delegasi; non-TTY menolak. Di **AUTO**, delegasi berjalan otonom bila authorized (anak tetap ter-ceiling WorkMode parent, dipaksa explore read-only bila parent non-BUILD). **Satu approval = delegasi ini saja**, tidak melebar ke delegasi lain.
|
|
9
9
|
|
|
10
10
|
## Mode anak: `explore` / `plan`
|
|
11
11
|
|
|
12
12
|
| Mode anak | Kemampuan |
|
|
13
13
|
|---|---|
|
|
14
14
|
| `explore` | Subset read-only (12 tool) — cari/pahami kode, kembalikan temuan |
|
|
15
|
-
| `plan` |
|
|
15
|
+
| `plan` | Selalu tanpa `todo_write`/mutasi memory/commit/nesting. **Jika parent ber-WorkMode ketat** (`PLAN`/`DISCUSS`): subset read-only 12 tool, sama seperti `explore`. **Jika parent `BUILD`×AUTO**: 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
|
|
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/choosing-mode.md
CHANGED
|
@@ -1,34 +1,41 @@
|
|
|
1
1
|
# Memilih Mode
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Tiga sumbu terpisah menentukan apa yang bisa/tidak bisa dilakukan agent:
|
|
4
|
+
|
|
5
|
+
1. **WorkMode** (operating mode) — *bagaimana* agent bekerja: `DISCUSS` (investigasi read-only), `PLAN` (analisis/plánning), `BUILD` (implementasi).
|
|
6
|
+
2. **PermissionMode** (persetujuan) — *apakah* butuh izin manusia: `AUTO` (otonom) atau `ASK` (diawasi).
|
|
7
|
+
3. **Tool Access Policy** — *apa* yang tersedia (read-only set, bash allowlist, delegasi, MCP, scope).
|
|
8
|
+
|
|
9
|
+
Hard security (path jail, sensitive-file, owned-state, bash-guard) selalu berlaku, di atas ketiganya.
|
|
4
10
|
|
|
5
11
|
## Kalau tujuan Anda X → gunakan Y
|
|
6
12
|
|
|
7
13
|
| Saya ingin… | Gunakan | Karena |
|
|
8
14
|
|---|---|---|
|
|
9
|
-
|Memahami repo tanpa mengubah apa pun |
|
|
10
|
-
| Minta agen membuat perubahan | `
|
|
11
|
-
| Menyetujui setiap perubahan |
|
|
12
|
-
| Menyusun rencana tanpa eksekusi | `
|
|
13
|
-
| Otomasi/CI tanpa manusia | One-shot/`exec` +
|
|
14
|
-
| Otonom penuh di mesin sendiri | `
|
|
15
|
+
| Memahami repo tanpa mengubah apa pun | `--work-mode DISCUSS` | Ceiling read-only lokal (16 tool baca); network read ditolak; tulis/bash/commit/delegasi ditolak di gerbang |
|
|
16
|
+
| Minta agen membuat perubahan | `BUILD` + `AUTO` (default) | Tulis terjail + bash + commit + delegasi + MCP authorized jalan otonom; hard-deny tetap berlaku |
|
|
17
|
+
| Menyetujui setiap perubahan | `--ask` (`BUILD` + `ASK`) | Tiap tool non-sepele menunggu jawaban; baca/bookkeeping tak ditanya |
|
|
18
|
+
| Menyusun rencana tanpa eksekusi | `--work-mode PLAN` | Baca + artefak rencana (`todo_write`) + delegasi read-only; tanpa mutasi file/git/commit |
|
|
19
|
+
| Otomasi/CI tanpa manusia | One-shot/`exec` + default | `AUTO` menolak `ask_user` deterministik (BLOCKED) di non-TTY; MCP tak-terkonfigurasi deny; tidak ada prompt yang bisa menggantung |
|
|
20
|
+
| Otonom penuh di mesin sendiri | `BUILD`+`AUTO` + `--sandbox docker` (atau OS) + `--budget` | Tanpa prompt, TETAPI jail path + bash-guard tetap aktif; sandbox memberi isolasi nyata |
|
|
15
21
|
|
|
16
22
|
## Rule of thumb
|
|
17
23
|
|
|
18
|
-
1. **Default `
|
|
19
|
-
2. **`
|
|
20
|
-
3. **`
|
|
21
|
-
4. **
|
|
22
|
-
5.
|
|
24
|
+
1. **Default `BUILD`+`AUTO` sudah benar untuk kerja harian.** Pindah mode hanya bila tujuan berubah, bukan karena takut umum.
|
|
25
|
+
2. **`DISCUSS` untuk baca, `PLAN` untuk berpikir.** Bedanya: `PLAN` boleh menulis artefak rencana (`todo_write`) dan menelusuri via delegasi read-only; keduanya tak menyentuh file/git/memori Anda.
|
|
26
|
+
3. **`ASK` untuk wilayah asing** — repo orang, perintah yang belum Anda pahami. Jawab `always` hanya untuk pasangan tool+args spesifik yang sudah Anda nilai.
|
|
27
|
+
4. **AUTO ≠ allow-all.** Kapabilitas yang tidak diotorisasi (mis. MCP tak-terkonfigurasi, `ask_user` di AUTO, code tanpa sandbox) di-*deny* dengan alasan, bukan di-prompt.
|
|
28
|
+
5. **Legacy `--allow-all`/`--allowlist`** dipetakan ke profil akses; path jail + bash-guard tetap menolak.
|
|
23
29
|
|
|
24
30
|
## Tradeoff yang jujur
|
|
25
31
|
|
|
26
32
|
- Semakin otonom → semakin cepat, semakin besar blast radius bila model salah paham. Tidak ada mode yang membuat model lebih bijak — mode hanya mengatur **apa yang boleh terjadi**.
|
|
27
33
|
- `allowlist` (otomatis saat tanpa sandbox OS) paling ketat untuk shell, tetapi model tetap bisa menulis file via tool terjail — pahami beda sumbunya: allowlist membatasi *perintah*, jail membatasi *file*.
|
|
28
|
-
- Ganti mode kapan pun: flag saat start,
|
|
34
|
+
- Ganti mode kapan pun: flag saat start, `Tab`/`Shift+Tab` atau `/mode`+`/work-mode` saat TUI berjalan.
|
|
29
35
|
|
|
30
36
|
## Lanjut
|
|
31
37
|
|
|
32
38
|
- [Security Model](security-model.md) — apa yang ditegakkan tiap mode.
|
|
33
39
|
- [Policy & Sandbox](policy-sandbox.md) — tabel semantik presisi + bukti guard.
|
|
34
40
|
- [Otomasi & CI](exec.md) — batasan headless.
|
|
41
|
+
- [CLI](cli.md) — referensi flag WorkMode/PermissionMode.
|