minicode-ai 0.20.0 → 0.22.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.
- package/README.md +1 -1
- package/cli/auto-update.ts +24 -15
- package/cli/commands/exec.ts +44 -1
- package/cli/commands.ts +5 -2
- package/cli/index.ts +57 -18
- package/cli/setup.ts +88 -34
- package/cli/tui.ts +22 -2
- package/docs/TERMINAL_CONTRACT.md +50 -11
- package/docs/UI_RENDER_PIPELINE.md +6 -3
- package/docs/architecture.md +10 -6
- package/docs/concepts.md +1 -1
- package/docs/contributing.md +4 -3
- package/docs/environment.md +2 -0
- package/docs/policy-sandbox.md +6 -1
- package/docs/security.md +12 -4
- package/docs/skills.md +1 -1
- package/package.json +2 -2
- package/src/config.ts +8 -6
- package/src/daemon/discovery.ts +24 -0
- package/src/policy/bash-guard.ts +170 -6
- package/src/policy/compaction.ts +34 -7
- package/src/policy/jail.ts +10 -22
- package/src/policy/permission.ts +9 -6
- package/src/policy/update-check.ts +6 -4
- package/src/presentation/projection.ts +1 -1
- package/src/providers/anthropic.ts +14 -4
- package/src/providers/responses.ts +1 -1
- package/src/providers/sse-bounds.ts +16 -2
- package/src/ui/approval/prompt.ts +17 -6
- package/src/ui/assistant/simple.ts +14 -0
- package/src/ui/footer.ts +2 -2
- package/src/ui/i18n/en.ts +29 -1
- package/src/ui/i18n/id.ts +29 -1
- package/src/ui/input/prompt-engine.ts +6 -0
- package/src/ui/render/activity-group.ts +53 -0
- package/src/ui/render/activity-panel.ts +91 -0
- package/src/ui/render/cells.ts +33 -6
- package/src/ui/render/diff.ts +58 -2
- package/src/ui/render/highlight.ts +68 -37
- package/src/ui/render/markdown.ts +6 -1
- package/src/ui/render/sanitize.ts +5 -1
- package/src/ui/render/session-summary.ts +11 -4
- package/src/ui/render/table-grid.ts +123 -13
- package/src/ui/render/table.ts +4 -2
- package/src/ui/render/theme.ts +19 -3
- package/src/ui/render/width.ts +35 -6
- package/src/ui/render/wrap.ts +28 -6
- package/src/ui/runtime/loading-bar.ts +137 -0
- package/src/ui/screens/dialog.ts +23 -2
- package/src/ui/screens/form.ts +52 -10
- package/src/ui/screens/model-manager.ts +8 -2
- package/src/ui/screens/picker.ts +11 -3
- package/src/ui/screens/provider-manager.ts +11 -3
- package/src/ui/screens/wizard.ts +29 -1
- package/src/ui/session-state.ts +22 -0
- package/src/ui/tui/app.ts +57 -20
- package/src/ui/tui/transcript.ts +204 -27
- package/vendor/minicore/src/providers/openai-compat.ts +30 -1
package/cli/setup.ts
CHANGED
|
@@ -369,6 +369,12 @@ export interface CliSessionOptions {
|
|
|
369
369
|
* prefiks prompt. Dicetak di sini (setelah provider layer lolos) supaya
|
|
370
370
|
* invokasi yang mati sebelumnya tetap senyap. */
|
|
371
371
|
sandboxNotice?: string
|
|
372
|
+
/**
|
|
373
|
+
* Hook fase startup (bar loading). Dipanggil saat fase panjang mulai:
|
|
374
|
+
* "provider-layer", "rag-layer", "tool-layer", "kernel-session", "resume".
|
|
375
|
+
* Optional — absen = tanpa progres (perilaku lama).
|
|
376
|
+
*/
|
|
377
|
+
onPhase?: (phase: string) => void
|
|
372
378
|
}
|
|
373
379
|
|
|
374
380
|
export interface CliSession {
|
|
@@ -515,6 +521,12 @@ export interface CliSession {
|
|
|
515
521
|
* membaca ulang pesan stderr.
|
|
516
522
|
*/
|
|
517
523
|
adoption: AdoptionResult | null
|
|
524
|
+
/**
|
|
525
|
+
* Baris diagnostik startup yang didefer (hanya terisi saat enterRepl —
|
|
526
|
+
* bar loading menggantikan teks proses). Di-flush ke transcript TUI oleh
|
|
527
|
+
* cli/tui.ts. Absen/undefined = tidak ada deferral (perilaku lama).
|
|
528
|
+
*/
|
|
529
|
+
startupNotices?: string[]
|
|
518
530
|
}
|
|
519
531
|
|
|
520
532
|
function mapPresentationEvent(event: DomainEvent): UiPresentationEvent | null {
|
|
@@ -910,6 +922,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
910
922
|
timeoutMs,
|
|
911
923
|
rateLimiter,
|
|
912
924
|
sandboxNotice,
|
|
925
|
+
onPhase,
|
|
913
926
|
} = opts
|
|
914
927
|
// [Area A · PROMPT 06] State UI milik SESI ini. Dibuat SEKALI per sesi dan
|
|
915
928
|
// dipakai bersama oleh TUI (Transcript) + printer linier sesi yang sama.
|
|
@@ -917,6 +930,25 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
917
930
|
// sendiri sehingga tak saling menimpa collapse/compact/reasoning.
|
|
918
931
|
const uiState = new UiSessionState()
|
|
919
932
|
const modelRef = { current: modelOverride }
|
|
933
|
+
// Collector diagnostik startup. Saat REPL + stderr TTY, bar loading
|
|
934
|
+
// menggantikan teks proses verbose — baris diagnostik (resume/recovery/
|
|
935
|
+
// context/dll) DITUNDA dan di-flush ke transcript TUI setelah sesi siap
|
|
936
|
+
// (lihat cli/tui.ts). Non-interaktif ATAU non-TTY (pipe/CI) tetap
|
|
937
|
+
// mencetak langsung seperti sebelumnya — tidak ada diagnostik yang bisa
|
|
938
|
+
// hilang di jalur yang tak punya transcript.
|
|
939
|
+
const deferStartup = enterRepl && process.stderr.isTTY === true
|
|
940
|
+
const startupNotices: string[] = []
|
|
941
|
+
const startupWrite = (s: string): void => {
|
|
942
|
+
if (deferStartup) startupNotices.push(s)
|
|
943
|
+
else process.stderr.write(s)
|
|
944
|
+
}
|
|
945
|
+
// `console.error` dipertahankan pada jalur non-interaktif (spy test
|
|
946
|
+
// menangkap baris provenance resume lewat console.error), tapi didefer
|
|
947
|
+
// saat REPL agar bar loading tetap satu-baris.
|
|
948
|
+
const startupConsoleError = (s: string): void => {
|
|
949
|
+
if (deferStartup) startupNotices.push(s)
|
|
950
|
+
else console.error(s)
|
|
951
|
+
}
|
|
920
952
|
// P2.1 — SATU-SATUNYA keputusan identitas sesi. Sesudah baris ini,
|
|
921
953
|
// `sessionId` adalah identitas kanonik durable; id volatil hanya `bootId`
|
|
922
954
|
// (diagnostik). Tak ada jalur persistensi khusus alias: semua turunan
|
|
@@ -931,7 +963,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
931
963
|
})
|
|
932
964
|
const sessionId = identity.sid
|
|
933
965
|
const bootId = identity.bootId
|
|
934
|
-
|
|
966
|
+
startupWrite(`${c.dim(formatSessionIdentityLine(identity))}\n`)
|
|
935
967
|
|
|
936
968
|
// P2.2 — admission penulis tunggal. Lease = admission; pagar mutasi =
|
|
937
969
|
// writer_epoch (CAS di transaksi tulis). Komposisi ini MEMEGANG lease
|
|
@@ -948,12 +980,12 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
948
980
|
if (!writerStale) {
|
|
949
981
|
writerStale = true
|
|
950
982
|
writerStaleNote = note
|
|
951
|
-
|
|
983
|
+
startupWrite(
|
|
952
984
|
`${c.yellow(`[writer] STALE sid=${sessionId} boot=${bootId} epoch=${expectedEpoch}: ${note} — history NOT durable; resume/restart to re-acquire\n`)}`,
|
|
953
985
|
)
|
|
954
986
|
}
|
|
955
987
|
}
|
|
956
|
-
|
|
988
|
+
startupWrite(
|
|
957
989
|
`${c.dim(`[writer] admitted sid=${sessionId} boot=${bootId} epoch=${expectedEpoch}${admission.admission.tookOver ? " (takeover)" : ""}${admission.admission.fresh ? " (fresh)" : ""}\n`)}`,
|
|
958
990
|
)
|
|
959
991
|
// [P14] Adopsi eksplisit berjalan SETELAH admission target (token target
|
|
@@ -975,7 +1007,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
975
1007
|
throw new AdoptionRefusedError(adoption)
|
|
976
1008
|
}
|
|
977
1009
|
const moved = adoption.task
|
|
978
|
-
|
|
1010
|
+
startupWrite(
|
|
979
1011
|
`${c.dim(`[adopt] ADOPTED ${adoptTask.taskId} ${adoptTask.sourceSessionId} -> ${sessionId} revision=${moved?.revision ?? "?"} status=${moved?.status ?? "?"} exec=${adoption.transfer?.execGeneration ?? "?"}${adoption.fencedFormerOwner ? " (former owner fenced)" : ""}\n`)}`,
|
|
980
1012
|
)
|
|
981
1013
|
}
|
|
@@ -988,9 +1020,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
988
1020
|
const planAsWorkMode =
|
|
989
1021
|
plan && !workModeExplicit && workMode === "DISCUSS" ? ("PLAN" as const) : workMode
|
|
990
1022
|
if (plan && !workModeExplicit && workMode === "DISCUSS") {
|
|
991
|
-
|
|
992
|
-
`${c.dim("[deprecated] --plan is now WorkMode PLAN; use --work-mode PLAN\n")}`,
|
|
993
|
-
)
|
|
1023
|
+
startupWrite(`${c.dim("[deprecated] --plan is now WorkMode PLAN; use --work-mode PLAN\n")}`)
|
|
994
1024
|
}
|
|
995
1025
|
const effectiveWorkMode: "DISCUSS" | "PLAN" | "EXECUTE" =
|
|
996
1026
|
identity.resumed && !workModeExplicit && !plan
|
|
@@ -1013,7 +1043,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1013
1043
|
try {
|
|
1014
1044
|
const orphans = tombstoneOrphanChildRuns(sessionId, cwd, { expectedEpoch })
|
|
1015
1045
|
if (orphans.length > 0) {
|
|
1016
|
-
|
|
1046
|
+
startupWrite(
|
|
1017
1047
|
`${c.yellow(`[child] ${orphans.length} orphaned sub-agent run(s) tombstoned (INTERRUPTED/UNKNOWN)\n`)}`,
|
|
1018
1048
|
)
|
|
1019
1049
|
}
|
|
@@ -1028,7 +1058,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1028
1058
|
const out = renewSessionWriter(sessionId, writerToken, cwd)
|
|
1029
1059
|
if (out === "AUTHORITY_LOST" && !renewWarned) {
|
|
1030
1060
|
renewWarned = true
|
|
1031
|
-
|
|
1061
|
+
startupWrite(
|
|
1032
1062
|
`${c.yellow(`[writer] lease lost sid=${sessionId} boot=${bootId} — another writer took over; next mutation will be refused unless re-acquired\n`)}`,
|
|
1033
1063
|
)
|
|
1034
1064
|
try {
|
|
@@ -1052,7 +1082,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1052
1082
|
const re = acquireSessionWriter({ sessionId, cwd, bootId, token: writerToken })
|
|
1053
1083
|
if (re.ok) {
|
|
1054
1084
|
if (re.admission.epoch !== expectedEpoch) {
|
|
1055
|
-
|
|
1085
|
+
startupWrite(
|
|
1056
1086
|
`${c.dim(`[writer] re-acquired sid=${sessionId} boot=${bootId} epoch=${re.admission.epoch}\n`)}`,
|
|
1057
1087
|
)
|
|
1058
1088
|
}
|
|
@@ -1110,11 +1140,12 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1110
1140
|
// fase session-setup ke stderr (`[startup] rag 8432ms`). Tanpa env = diam.
|
|
1111
1141
|
const startupPhase = async <T>(name: string, fn: () => Promise<T>): Promise<T> => {
|
|
1112
1142
|
const s = Date.now()
|
|
1143
|
+
onPhase?.(name)
|
|
1113
1144
|
try {
|
|
1114
1145
|
return await fn()
|
|
1115
1146
|
} finally {
|
|
1116
1147
|
if (process.env.MINICODE_DEBUG_STARTUP === "1")
|
|
1117
|
-
|
|
1148
|
+
startupWrite(`[startup] ${name} ${Date.now() - s}ms\n`)
|
|
1118
1149
|
}
|
|
1119
1150
|
}
|
|
1120
1151
|
|
|
@@ -1125,12 +1156,10 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1125
1156
|
let effectiveTimeoutMs =
|
|
1126
1157
|
timeoutMs ?? (envTimeout != null && envTimeout !== "" ? Number(envTimeout) : 3_600_000)
|
|
1127
1158
|
if (!Number.isFinite(effectiveTimeoutMs) || effectiveTimeoutMs < 0) {
|
|
1128
|
-
|
|
1159
|
+
startupWrite(`[warn] invalid timeout ${effectiveTimeoutMs}, fallback to 3600000\n`)
|
|
1129
1160
|
effectiveTimeoutMs = 3_600_000
|
|
1130
1161
|
} else if (effectiveTimeoutMs > LIMITS.MAX_TIMER_DELAY_MS) {
|
|
1131
|
-
|
|
1132
|
-
`[warn] timeout exceeds runtime limit; capped at ${LIMITS.MAX_TIMER_DELAY_MS}ms\n`,
|
|
1133
|
-
)
|
|
1162
|
+
startupWrite(`[warn] timeout exceeds runtime limit; capped at ${LIMITS.MAX_TIMER_DELAY_MS}ms\n`)
|
|
1134
1163
|
effectiveTimeoutMs = LIMITS.MAX_TIMER_DELAY_MS
|
|
1135
1164
|
}
|
|
1136
1165
|
// `--timeout` adalah deadline satu pemanggilan prompt. Jangan menyalakan
|
|
@@ -1164,7 +1193,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1164
1193
|
const home = homeDir()
|
|
1165
1194
|
const cur = resolvePath(cwd ?? process.cwd())
|
|
1166
1195
|
if (resolvePath(home) === cur) {
|
|
1167
|
-
|
|
1196
|
+
startupWrite(
|
|
1168
1197
|
c.yellow(
|
|
1169
1198
|
`[warn] workspace is home directory — consider --cwd <project> to avoid scanning the entire home\n`,
|
|
1170
1199
|
),
|
|
@@ -1181,7 +1210,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1181
1210
|
)
|
|
1182
1211
|
const stale = checkStaleTurn(cwd, sessionId)
|
|
1183
1212
|
if (stale) {
|
|
1184
|
-
|
|
1213
|
+
startupWrite(`${c.yellow(formatStaleNotice(stale))}\n`)
|
|
1185
1214
|
clearStaleTurn(cwd, sessionId)
|
|
1186
1215
|
}
|
|
1187
1216
|
} catch {}
|
|
@@ -1202,9 +1231,9 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1202
1231
|
// ada, jadi tak ada noise pada alur normal.
|
|
1203
1232
|
try {
|
|
1204
1233
|
const notice = localConfigNotice(cwd ?? process.cwd(), allowLocalConfig === true)
|
|
1205
|
-
if (notice)
|
|
1234
|
+
if (notice) startupWrite(`${c.dim(notice)}\n`)
|
|
1206
1235
|
} catch {}
|
|
1207
|
-
if (sandboxNotice && !plan)
|
|
1236
|
+
if (sandboxNotice && !plan) startupWrite(`${sandboxNotice}\n`)
|
|
1208
1237
|
// Default model = terakhir dipakai (global), bila tanpa --model dan masih
|
|
1209
1238
|
// ada di config. Flag selalu menang; tak ada simpanan = provider pertama.
|
|
1210
1239
|
if (!modelRef.current) {
|
|
@@ -1229,7 +1258,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1229
1258
|
: (resolved.model ?? "default")
|
|
1230
1259
|
if (!warnedContextModels.has(key)) {
|
|
1231
1260
|
warnedContextModels.add(key)
|
|
1232
|
-
|
|
1261
|
+
startupWrite(
|
|
1233
1262
|
`${c.yellow(`[context] no configured window for ${sanitizeAnsi(key)}; using fallback ${resolved.tokens} tokens. Set provider.contextWindows or --context-window for the exact limit.\n`)}`,
|
|
1234
1263
|
)
|
|
1235
1264
|
}
|
|
@@ -1242,7 +1271,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1242
1271
|
: (resolved.model ?? "default")
|
|
1243
1272
|
if (!warnedCatalogDrift.has(key)) {
|
|
1244
1273
|
warnedCatalogDrift.add(key)
|
|
1245
|
-
|
|
1274
|
+
startupWrite(
|
|
1246
1275
|
`${c.yellow(`[context] catalog window ${resolved.drift.catalogTokens} for ${sanitizeAnsi(key)} differs >2x from models.dev (${resolved.drift.overlayTokens}); catalog may be stale — run \`minicode pricing sync\` or set provider.contextWindows.\n`)}`,
|
|
1247
1276
|
)
|
|
1248
1277
|
}
|
|
@@ -1319,7 +1348,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1319
1348
|
: persistedWorkMode !== undefined && persistedWorkMode !== effectiveWorkMode
|
|
1320
1349
|
? `[resume] WorkMode ${effectiveWorkMode === "EXECUTE" ? "BUILD" : effectiveWorkMode} (overriding saved ${persistedWorkMode === "EXECUTE" ? "BUILD" : persistedWorkMode})\n`
|
|
1321
1350
|
: ""
|
|
1322
|
-
if (resumeNotice)
|
|
1351
|
+
if (resumeNotice) startupWrite(resumeNotice)
|
|
1323
1352
|
// P2.4: aktivasi default Thread SEBELUM seed kernel — backfill aditif
|
|
1324
1353
|
// berpagar (konten/seq tak tersentuh). Basi di sini = gagal loud
|
|
1325
1354
|
// (dunia bergerak pasca-admission); warn-swallow di bawah tak berlaku.
|
|
@@ -1327,7 +1356,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1327
1356
|
// idempoten) agar SEMUA baris durable beridentitas stabil.
|
|
1328
1357
|
const defaultThread = ensureDefaultThread(sessionId, cwd, { expectedEpoch })
|
|
1329
1358
|
const backfilled = backfillHistoryEventIds(sessionId, cwd, { expectedEpoch })
|
|
1330
|
-
|
|
1359
|
+
startupWrite(
|
|
1331
1360
|
`${c.dim(`[thread sid=${sessionId} tid=${defaultThread.thread_id} head=${defaultThread.head_seq}${backfilled > 0 ? ` backfilled=${backfilled}` : ""}]\n`)}`,
|
|
1332
1361
|
)
|
|
1333
1362
|
try {
|
|
@@ -1426,7 +1455,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1426
1455
|
contextCanonicalBaseline = prev.messages
|
|
1427
1456
|
}
|
|
1428
1457
|
resumeTurnCount = prev.turnCount
|
|
1429
|
-
|
|
1458
|
+
startupConsoleError(
|
|
1430
1459
|
c.dim(
|
|
1431
1460
|
// "(N messages)" dipertahankan VERBATIM (kontrak diagnostik yang
|
|
1432
1461
|
// sudah dipakai test/CLI).
|
|
@@ -1434,7 +1463,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1434
1463
|
),
|
|
1435
1464
|
)
|
|
1436
1465
|
// P3.3 — jejak provenance seleksi (baca-saja; tak mengubah perilaku).
|
|
1437
|
-
|
|
1466
|
+
startupConsoleError(
|
|
1438
1467
|
c.dim(
|
|
1439
1468
|
`[select sid=${sessionId} basis=${selection.selectionBasis} freshness=${selection.freshness} head=${selection.frontier?.headSeq ?? "-"}]\n`,
|
|
1440
1469
|
),
|
|
@@ -1444,7 +1473,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1444
1473
|
// /undo tersedia bila perlu kembali. Best-effort, tak menggagalkan resume.
|
|
1445
1474
|
const div = await validateResumeWorkspace(cwd ?? ".", sessionId).catch(() => null)
|
|
1446
1475
|
if (div && div.diverged > 0) {
|
|
1447
|
-
|
|
1476
|
+
startupConsoleError(
|
|
1448
1477
|
c.yellow(
|
|
1449
1478
|
`[resume] workspace berubah sejak checkpoint terakhir (${div.diverged} file) — /undo tersedia bila perlu kembali\n`,
|
|
1450
1479
|
),
|
|
@@ -1452,13 +1481,13 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1452
1481
|
}
|
|
1453
1482
|
} else {
|
|
1454
1483
|
// Defensif (tak terjangkau normal: resolver menjamin baris ada).
|
|
1455
|
-
|
|
1484
|
+
startupConsoleError(c.yellow(`[resume] session ${sessionId} has no messages yet\n`))
|
|
1456
1485
|
}
|
|
1457
1486
|
} catch (e) {
|
|
1458
1487
|
// P2.2/P2.4: pagar basi TIDAK boleh jadi warning — lempar ulang agar
|
|
1459
1488
|
// startup gagal loud (dunia bergerak pasca-admission).
|
|
1460
1489
|
if (e instanceof StaleWriterError || e instanceof ThreadArchivedError) throw e
|
|
1461
|
-
|
|
1490
|
+
startupWrite(`[warn] resume failed: ${(e as Error).message}\n`)
|
|
1462
1491
|
}
|
|
1463
1492
|
}
|
|
1464
1493
|
|
|
@@ -1469,22 +1498,22 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1469
1498
|
try {
|
|
1470
1499
|
const persistedTurns = listPersistedTurns(sessionId, cwd)
|
|
1471
1500
|
const rec = await planRecoveryForSession(sessionId, cwd, { persistedTurns })
|
|
1472
|
-
for (const w of rec.warnings)
|
|
1501
|
+
for (const w of rec.warnings) startupWrite(c.yellow(`[recovery] ${w}\n`))
|
|
1473
1502
|
if (rec.directive) {
|
|
1474
|
-
|
|
1503
|
+
startupWrite(
|
|
1475
1504
|
c.yellow(`[recovery] unfinished mutations need verification — see system note\n`),
|
|
1476
1505
|
)
|
|
1477
1506
|
recoveryAppendix = `\n\n# Recovery note (interrupted session — verify before re-executing)\n${rec.directive}`
|
|
1478
1507
|
}
|
|
1479
1508
|
} catch (e) {
|
|
1480
|
-
|
|
1509
|
+
startupWrite(`[warn] recovery plan failed: ${(e as Error).message}\n`)
|
|
1481
1510
|
}
|
|
1482
1511
|
|
|
1483
1512
|
let durablePresentationEvents: DomainEvent[] = []
|
|
1484
1513
|
try {
|
|
1485
1514
|
durablePresentationEvents = loadPresentationEvents(sessionId, cwd)
|
|
1486
1515
|
} catch (e) {
|
|
1487
|
-
|
|
1516
|
+
startupWrite(`[warn] presentation replay load failed: ${(e as Error).message}\n`)
|
|
1488
1517
|
}
|
|
1489
1518
|
let rebuiltPresentation: ReturnType<typeof rebuildFromDurable> | null = null
|
|
1490
1519
|
try {
|
|
@@ -1494,7 +1523,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1494
1523
|
sessionId,
|
|
1495
1524
|
)
|
|
1496
1525
|
} catch (e) {
|
|
1497
|
-
|
|
1526
|
+
startupWrite(`[warn] presentation replay failed: ${(e as Error).message}\n`)
|
|
1498
1527
|
}
|
|
1499
1528
|
// P2.11 — replay watershed: state.seq sesaat setelah rebuild. Baris snapshot
|
|
1500
1529
|
// pada/di bawah ini = replay/reconstructed; di atasnya = live (provenance
|
|
@@ -1515,7 +1544,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
1515
1544
|
try {
|
|
1516
1545
|
await reconcileUndoRedoPointer(sessionId, cwd)
|
|
1517
1546
|
} catch (e) {
|
|
1518
|
-
|
|
1547
|
+
startupWrite(`[warn] checkpoint reconcile failed: ${(e as Error).message}\n`)
|
|
1519
1548
|
}
|
|
1520
1549
|
|
|
1521
1550
|
// Kontrak control-plane (Phase 6, E5): usage kompaksi LLM dikirim ke bus
|
|
@@ -2366,6 +2395,30 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
2366
2395
|
})
|
|
2367
2396
|
} catch {}
|
|
2368
2397
|
})
|
|
2398
|
+
// ── Phase C: soft-cap warning (host-side) ──
|
|
2399
|
+
// Peringatkan SEKALI per turn saat langkah mendekati cap (~85%) supaya operator
|
|
2400
|
+
// tahu batas akan tercapai dan bisa memecah/mendelegasikan sebelum tabrakan
|
|
2401
|
+
// keras di "Batas langkah tool tercapai". Operator-facing (stderr); menembus
|
|
2402
|
+
// ke MODEL butuh seam system-prompt terpisah (di luar scope fase ini).
|
|
2403
|
+
let softStepWarned = false
|
|
2404
|
+
session.events.on("turn:started", () => {
|
|
2405
|
+
softStepWarned = false
|
|
2406
|
+
})
|
|
2407
|
+
session.events.on("step:completed", (e) => {
|
|
2408
|
+
try {
|
|
2409
|
+
if (softStepWarned) return
|
|
2410
|
+
const cap = maxSteps ?? LIMITS.DEFAULT_MAX_STEPS
|
|
2411
|
+
const idx = (e.step as { index?: unknown })?.index
|
|
2412
|
+
if (typeof idx !== "number") return
|
|
2413
|
+
const threshold = Math.max(1, Math.floor(cap * 0.85))
|
|
2414
|
+
if (idx >= threshold && idx < cap) {
|
|
2415
|
+
softStepWarned = true
|
|
2416
|
+
warnLine(
|
|
2417
|
+
`mendekati batas langkah (step ${idx}/${cap}) — bungkus hasil, delegasikan, atau siapkan /resume`,
|
|
2418
|
+
)
|
|
2419
|
+
}
|
|
2420
|
+
} catch {}
|
|
2421
|
+
})
|
|
2369
2422
|
// ── P2.11 observasi verifikasi (observation-only) ──
|
|
2370
2423
|
// Bukti kanonik hidup di jurnal mutasi; presentasi hanya mengamatinya.
|
|
2371
2424
|
// Setiap tool selesai (dan setiap turn selesai untuk verifikasi susulan),
|
|
@@ -3684,6 +3737,7 @@ export async function createCliSession(opts: CliSessionOptions): Promise<CliSess
|
|
|
3684
3737
|
productionScheduler,
|
|
3685
3738
|
schedulerObservability,
|
|
3686
3739
|
adoption,
|
|
3740
|
+
startupNotices: deferStartup ? startupNotices : undefined,
|
|
3687
3741
|
// [P1 M14] Same rule as the Scheduler handle above: one session owns one
|
|
3688
3742
|
// runtime, reachable only through the session, never through a registry.
|
|
3689
3743
|
productionRuntime,
|
package/cli/tui.ts
CHANGED
|
@@ -171,6 +171,13 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
171
171
|
? ctx.getPresentationSnapshot()
|
|
172
172
|
: { activities: [], turns: [] }
|
|
173
173
|
|
|
174
|
+
// [Fase 2] Panel aktivitas default ON di TUI (thinking + grup tool).
|
|
175
|
+
// Env MINICODE_ACTIVITY_PANEL=0 (opt-out eksplisit) / /fold mematikannya.
|
|
176
|
+
// Guard `ctx.uiState`: produksi SELALU mengoper state sesi (cli/setup.ts);
|
|
177
|
+
// fixture tes tanpa uiState memakai singleton `defaultUiState` — jangan
|
|
178
|
+
// dimutasi dari sini (bocor antar berkas tes).
|
|
179
|
+
if (ctx.uiState && process.env.MINICODE_ACTIVITY_PANEL !== "0") ui.setActivityPanel(true)
|
|
180
|
+
|
|
174
181
|
let mode: string = permissions?.getMode() ?? permissionMode ?? "auto"
|
|
175
182
|
// Mode permission sebelum /unrestric diaktifkan — dipakai untuk memulihkan
|
|
176
183
|
// saat operator menonaktifkannya kembali (toggle, per-sesi).
|
|
@@ -264,6 +271,12 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
264
271
|
// <id>` reuse tanpa `--resume` tak boleh menampilkan riwayat lama. Sesi baru
|
|
265
272
|
// (tanpa event) = no-op. Tak double-render: replay memproses event LAMA,
|
|
266
273
|
// turn live baru menyusul dengan event baru.
|
|
274
|
+
// Baris diagnostik startup yang didefer (resume/recovery/context/dll)
|
|
275
|
+
// di-flush ke transcript SEBELUM replay agar urutan kronologisnya benar
|
|
276
|
+
// (diagnostik dulu, lalu riwayat sesi).
|
|
277
|
+
if (ctx.startupNotices?.length) {
|
|
278
|
+
transcript.pushInfo(ctx.startupNotices)
|
|
279
|
+
}
|
|
267
280
|
try {
|
|
268
281
|
const turnCount = (session.state as { turnCount?: number } | undefined)?.turnCount ?? 0
|
|
269
282
|
if (turnCount > 0) {
|
|
@@ -663,8 +676,11 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
663
676
|
return
|
|
664
677
|
}
|
|
665
678
|
if (name === "fold") {
|
|
679
|
+
// [Fase 2] /fold = toggle PANEL AKTIVITAS (thinking + grup tool).
|
|
680
|
+
// Perilaku lama (minimizeActivity) tetap hidup saat panel off; `/fold`
|
|
681
|
+
// sekarang mengontrol panel. i18n key sama (folded/expanded).
|
|
666
682
|
const next = args === "" ? undefined : args === "on" || args === "1"
|
|
667
|
-
const on = ui.
|
|
683
|
+
const on = ui.setActivityPanel(next)
|
|
668
684
|
transcript.pushInfo([c.muted(t("tui.activityFold", { v: on ? "folded" : "expanded" }))])
|
|
669
685
|
return
|
|
670
686
|
}
|
|
@@ -848,7 +864,11 @@ export async function runTui(ctx: CliSession): Promise<void> {
|
|
|
848
864
|
if (!res.started) {
|
|
849
865
|
// Kegagalan startup adalah diagnostik, bukan keluaran program. App
|
|
850
866
|
// sudah menolak membuka layar dan tidak ada fallback linear yang sah.
|
|
851
|
-
|
|
867
|
+
// Notices startup yang sempat didefer WAJIB tetap terlihat di jalur
|
|
868
|
+
// gagal ini (transcript tak pernah hidup) — digabung ke SATU write
|
|
869
|
+
// dengan pesan noTty agar inventaris writer tidak bertambah.
|
|
870
|
+
const deferred = ctx.startupNotices?.length ? ctx.startupNotices.join("") : ""
|
|
871
|
+
process.stderr.write(`${deferred}${t("tui.noTty")}\n`)
|
|
852
872
|
process.exitCode = 1
|
|
853
873
|
return
|
|
854
874
|
}
|
|
@@ -187,14 +187,21 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
187
187
|
hilang, id selamat).
|
|
188
188
|
- Form dalam popup (`form.ts`): field text/secret(mask `•`)/select/confirm,
|
|
189
189
|
Tab/↑↓ pindah, ←/→ pilih atau geser kursor, Enter validasi+submit, Esc
|
|
190
|
-
dua-tahap (tekan-1
|
|
191
|
-
hilang sekali tekan); error
|
|
192
|
-
diparkir di field aktif
|
|
193
|
-
|
|
190
|
+
dua-tahap (tekan-1 KEMBALIKAN nilai bawaan field aktif — text/secret/select/
|
|
191
|
+
confirm, tekan-2 batal — isi tidak pernah hilang sekali tekan); error
|
|
192
|
+
validasi merah dalam box; kursor terminal diparkir di field aktif dan field
|
|
193
|
+
aktif SELALU terlihat (jendela body digeser via `focusRow` bila kotak
|
|
194
|
+
terpotong). Add/edit provider, delete confirm, dan wizard input WAJIB lewat
|
|
195
|
+
ini (bukan askLine liar di luar kotak).
|
|
196
|
+
- Picker ber-filter: Esc-1 mengosongkan filter (= kembali ke nilai bawaan
|
|
197
|
+
pencarian, analogen revert-to-default I21), Esc-2 menutup. Ctrl+U juga
|
|
198
|
+
mengosongkan filter. Tidak ada draft yang hilang tanpa undo.
|
|
194
199
|
- Dropdown `/` tetap inline menempel prompt (harus mengikuti kursor ketik):
|
|
195
200
|
berbingkai, terhapus di SEMUA jalur keluar.
|
|
196
201
|
- **Kursor diparkir di SEMUA permukaan** (picker/manager/form/App): baris
|
|
197
|
-
item/field aktif — bukan ditinggal di posisi paint terakhir.
|
|
202
|
+
item/field aktif — bukan ditinggal di posisi paint terakhir. Kursor idle App
|
|
203
|
+
berada tepat setelah prompt `minicode ›` (prompt tidak lagi disembunyikan
|
|
204
|
+
setelah Esc/Enter kosong — I13).
|
|
198
205
|
- **i18n dwibahasa** (`src/ui/i18n/`): kamus statis `en.ts`/`id.ts` (id WAJIB
|
|
199
206
|
kunci = en — tsc mengawal), `t(key, params)` interpolasi `{nama}`, fallback
|
|
200
207
|
kunci hilang → en. Prioritas: `/lang` (sesi) > `MINICODE_LANG` >
|
|
@@ -342,7 +349,11 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
342
349
|
berikutnya = auto-batal (cancel), total semantik 90 dtk lama; SATU
|
|
343
350
|
ketikan apa pun me-reset kedua timer.
|
|
344
351
|
22. Thinking terlihat SECARA DEFAULT (expanded): composer memakai dots clock;
|
|
345
|
-
|
|
352
|
+
dengan panel aktivitas ON (default TUI; `/fold`), transkrip menampilkan
|
|
353
|
+
AREA thinking = blok live maks 10 baris visual terakhir (header
|
|
354
|
+
`+ thinking`, penanda `… N baris lagi`), lalu saat fase berakhir diringkas
|
|
355
|
+
SATU baris (`+ thinking · N baris`) dengan detail penuh tetap tersedia di
|
|
356
|
+
`/expand`; dengan panel OFF, perilaku legacy = alir thinking ber-warna terbaca (`c.thinking`,
|
|
346
357
|
abu-kebiruan) dan ber-indentasi 2 kolom, dipisah SATU baris kosong dari
|
|
347
358
|
jawaban/ledger — bukan `dim`; minimized (`/thinking`, `MINICODE_SHOW_THINKING=0`)
|
|
348
359
|
= bersih tanpa marker (`… thinking`); isi tetap tersedia di `/expand`;
|
|
@@ -379,14 +390,22 @@ Non-TTY (pipe/redirect/CI/file): **0 cursor control, 0 alternate screen,
|
|
|
379
390
|
dan `approval.*` terstruktur plus teks delta. Exit code, pipe safety, dan
|
|
380
391
|
determinisme non-TTY tetap sama.
|
|
381
392
|
|
|
382
|
-
27. Painter transient stderr (spinner setup/cek-update,
|
|
383
|
-
DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
|
|
393
|
+
27. Painter transient stderr (spinner setup/cek-update, bar loading startup,
|
|
394
|
+
garis status turn) DITAHAN selama layar interaktif memegang terminal: `beginInteractiveScreen`
|
|
384
395
|
(`src/ui/runtime/statusline.ts`) membisukan `paintWrite` (nol byte + baris
|
|
385
396
|
painter dibersihkan sekali saat layar mengambil alih), nested dihitung,
|
|
386
397
|
release idempoten. Pemegang: `askLine`/`askSecret`/`runPicker` (raw-mode)
|
|
387
398
|
dan `openAltScreen` (alt-screen, release di `close()`). Tanpa ini tick
|
|
388
399
|
`\r\x1b[2K` spinner menghapus baris prompt wizard (laporan "macet di
|
|
389
|
-
Menyiapkan sesi…").
|
|
400
|
+
Menyiapkan sesi…"). Bar loading (`src/ui/runtime/loading-bar.ts`) adalah
|
|
401
|
+
painter transient jenis kedua: single-line blok `▓░` + persen + label,
|
|
402
|
+
digambar ulang HANYA saat `update(label, percent)` dipanggil (bukan
|
|
403
|
+
interval), TTY-only (non-TTY = no-op nol byte), label disanitasi, kursor
|
|
404
|
+
direstore di `exit`. Fase startup (update check/install/restart, provider,
|
|
405
|
+
RAG, tool, kernel, resume) memanggil `update`; diagnostik startup
|
|
406
|
+
(resume/recovery/context/dll) DITUNDA saat REPL dan di-flush ke transcript
|
|
407
|
+
TUI (`ctx.startupNotices`), sedangkan non-interaktif tetap mencetak langsung.
|
|
408
|
+
Output npm saat auto-update disembunyikan (`stdio: pipe` dibuang).
|
|
390
409
|
28. Kontrak exit code: **0** sukses/help, **1** gagal runtime/lookup, **2**
|
|
391
410
|
salah pakai (argumen hilang/malformed, subcommand asing). Flag sebagai
|
|
392
411
|
positional id = salah pakai (exit 2). `exec --json` yang gagal di fase
|
|
@@ -551,7 +570,9 @@ panjang).
|
|
|
551
570
|
> [Gap proteksi](#peta-proteksi-dan-gap-tersisa) di bawah — jangan
|
|
552
571
|
> dipoles dengan mengganti kata-kata.
|
|
553
572
|
|
|
554
|
-
- `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (
|
|
573
|
+
- `test/tui-app.test.ts` — I1/I13/I14/I17-I20 (baris indikator dipotong ke
|
|
574
|
+
lebar frame walau locale id 51 kolom; prompt idle bertahan setelah Esc;
|
|
575
|
+
`repaint()` tak melukis saat suspended; boot/exit pairing, transcript
|
|
555
576
|
viewport, mouse-wheel/drag-selection/PgUp/PgDn scroll + indikator, prompt
|
|
556
577
|
editing, dots/timer, status bar, Esc-only abort, quit, suspend/resume,
|
|
557
578
|
busy-freeze, live repaint; I14: Home/End jump + Shift+PgUp/PgDn + hint abort
|
|
@@ -566,6 +587,7 @@ panjang).
|
|
|
566
587
|
- `test/tui-transcript.test.ts` — projection source-mapped: wrap, CJK/ANSI, user prefix, tabel TSV, selection text, cap buffer live, dan render markdown inline jawaban model (heading/bold/code; delimiter fence disembunyikan, isi fence dan gema user tetap literal).
|
|
567
588
|
- `test/screen-buffer.test.ts` — parser frame harness (unit).
|
|
568
589
|
- `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).
|
|
590
|
+
- `test/thinking-area.test.ts` — I22 area thinking: blok live maks 10 baris (header/`… N baris lagi`), ringkasan 1 baris + detail `/expand` saat turn selesai, tanpa duplikasi, dan fallback legacy saat panel OFF.
|
|
569
591
|
- `test/presentation-projections.test.ts` — I12/I17/I32 (projection
|
|
570
592
|
snapshot, running/elapsed, status terminal, retry/child grouping, summary,
|
|
571
593
|
marker evict + `total()` monotonik, dan parity flag OFF) + F-AGENT-1
|
|
@@ -606,7 +628,21 @@ panjang).
|
|
|
606
628
|
- `test/tui-popup.test.ts` — I16 (komposit di atas transkrip, anti-bocor,
|
|
607
629
|
anti-hantu).
|
|
608
630
|
- `test/form.test.ts` — I21 (field, validasi, secret, select, confirm, batal;
|
|
609
|
-
Esc-1 kembalikan prefill
|
|
631
|
+
Esc-1 kembalikan prefill untuk text/secret DAN pilihan bawaan untuk
|
|
632
|
+
select/confirm, Esc-2 batal; Tab+teks dalam satu chunk tidak menulis ke field
|
|
633
|
+
lama; field aktif di luar tinggi kotak tetap terlihat).
|
|
634
|
+
- `test/render-audit-2026-11.test.ts` — audit renderer 2026-11-12 (proyeksi
|
|
635
|
+
pending dimemo per baris → tidak O(n²); SGR majemuk diproses berurutan di
|
|
636
|
+
`truncateToWidth`; indentasi `wordWrap`; SGR opak di highlight; cap input &
|
|
637
|
+
guard LCS diff; lebar tabel untuk grapheme 2 kolom; kop sesi lewat i18n;
|
|
638
|
+
`dialogBox` menggeser jendela ke `focusRow`) **plus penutupan kebocoran**:
|
|
639
|
+
`U+2028/U+2029` jadi spasi di jalur satu-baris, dan paste composer tidak
|
|
640
|
+
bisa menyelundupkan CSI C1 (`U+009B`) — buffer composer dilukis apa adanya,
|
|
641
|
+
jadi gate-nya ada di `prompt-engine` sebelum buffer terbentuk. Jalur pesan
|
|
642
|
+
error layar (`picker`, `model-manager`/`provider-manager` fail-open) dan
|
|
643
|
+
hasil probe jaringan `cli/commands.ts` (`/sync`) memakai `cleanUntrusted` /
|
|
644
|
+
`sanitizeAnsiLine`; hook `?25h` loading-bar didaftarkan lazy agar modul yang
|
|
645
|
+
sekadar di-import tidak menulis byte ke alt-screen.
|
|
610
646
|
- `test/approval-tui.test.ts` — I23 (blok + keputusan tercatat, deny;
|
|
611
647
|
stdout-pipe tanpa sink = deny).
|
|
612
648
|
- `test/footer-render.test.ts` — I13 (label title case, Work Mode kiri dan Permission Mode cyan rata kanan dekat konteks, posisi kolom stabil, fallback terminal sempit, ikon gembok 🔒 terang/redup).
|
|
@@ -653,6 +689,9 @@ panjang).
|
|
|
653
689
|
final, sementara sink linear memberi marker dan usage tetap tercatat.
|
|
654
690
|
- `test/transient-arbitration.test.ts` — I3/I9/I27 (hold layar interaktif:
|
|
655
691
|
picker/askLine, nesting, delayMs).
|
|
692
|
+
- `test/loading-bar.test.ts` — I27/I6 (bar loading: non-TTY no-op nol byte,
|
|
693
|
+
delay pertama, progres blok+persen+label, sanitasi label, stop idempoten,
|
|
694
|
+
restore kursor, mutual exclusion transient, ditahan layar interaktif).
|
|
656
695
|
- `test/statusline-bun-guard.test.ts` — I4 (painter Bun/Windows: painter
|
|
657
696
|
dinonaktifkan sendiri, write asli dipulihkan).
|
|
658
697
|
- `test/turn-status.test.ts` — garis status turn lifecycle deterministik
|
|
@@ -82,7 +82,10 @@ Tahap H — primitif render `src/ui/render/`: `sanitize.ts` (hanya SGR lolos),
|
|
|
82
82
|
per baris → aman resize), `theme.ts` (getter warna/glyph, jangan di-`const`),
|
|
83
83
|
`errors.ts` (pesan actionable + redact), `collapse.ts` (buffer `/expand`
|
|
84
84
|
200KB/entry, 500KB total), `markdown-table.ts`/`table-grid.ts` (pipe-table
|
|
85
|
-
model), `diff.ts`/`table.ts`/`money.ts`/`format.ts
|
|
85
|
+
model), `diff.ts`/`table.ts`/`money.ts`/`format.ts`,
|
|
86
|
+
`activity-group.ts`/`activity-panel.ts` (panel aktivitas: klasifikasi tool →
|
|
87
|
+
keluarga `explore|edit|execute|feed|other` + satu baris ringkas per keluarga,
|
|
88
|
+
maks 10 baris; murni, dipakai TUI + linear).
|
|
86
89
|
|
|
87
90
|
Tahap H2 — tabel Markdown model: `src/ui/render/markdown-table.ts` memvalidasi
|
|
88
91
|
header/delimiter, escaped pipe, code span, alignment, dan fence; stream block
|
|
@@ -104,8 +107,8 @@ I = bisa diinterupsi, L = bisa tiba setelah completion.
|
|
|
104
107
|
|---|---|---|---|---|---|---|---|
|
|
105
108
|
| assistant text | provider stream | stdout wrap + fence 2-spasi; pipe-table-aligned di TTY, source sanitized di non-TTY | ya | tidak (E1) | tidak | ya (abort) | tidak (detach flush 1x, E6) |
|
|
106
109
|
| tool call | model → kernel | `› nama target` muted (compact: diam) | tidak | tidak | tidak | ya | tidak |
|
|
107
|
-
| tool result | tool → executor | ledger hijau/merah; minimize → `+ label` + buffer | tidak | tidak | tidak | ya | tidak |
|
|
108
|
-
| reasoning | provider extension | TUI composer: dots clock
|
|
110
|
+
| tool result | tool → executor | ledger hijau/merah; minimize → `+ label` + buffer; panel aktivitas ON → baris grup per keluarga tool (`+ explore · N tools · N ok`) | tidak | tidak | tidak | ya | tidak |
|
|
111
|
+
| reasoning | provider extension | TUI composer: dots clock; panel aktivitas ON → AREA thinking live maks 10 baris (`+ thinking`, ringkas 1 baris saat turn selesai, detail di `/expand`); panel OFF → alir per baris; minimized → buffer `/expand` | ya | tidak | tidak | ya | tidak |
|
|
109
112
|
| thinking effort | picker `/model` | badge + level per model | tidak | tidak | tidak | tidak | tidak |
|
|
110
113
|
| usage | provider extension | verbose saja; masuk budget watcher | ya | tidak | ya (tail pasca-finish) | ya | ya (diabaikan aman) |
|
|
111
114
|
| compaction | kernel loop | `── compacted: <reason>` kuning, reason verbatim | tidak | tidak | tidak | tidak | tidak |
|
package/docs/architecture.md
CHANGED
|
@@ -9,15 +9,19 @@ Roadmap fase pemilik tidak tersedia di checkout ini; jangan simpulkan status fas
|
|
|
9
9
|
```
|
|
10
10
|
L1 cli/ + src/ui/ → controller tipis + presentation mandiri
|
|
11
11
|
L2 src/ non-ui → agen: tools, agents, hooks, policy, providers, mcp, lsp, session, skills
|
|
12
|
-
L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (
|
|
12
|
+
L3 vendor/minicore → kernel STATE/MODEL/ACTION/LOOP (vendored, host-editable, zero-dep, via #minicore)
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
15
|
+
Kernel di-vendor dan **dapat diedit di host** sejak v0.16.0 (lihat
|
|
16
|
+
[catatan vendor MiniCore](https://github.com/minilabs-id/minicode/blob/main/vendor/minicore/VENDOR.md));
|
|
17
|
+
commit sumber `0d33571` hanya referensi historis provenance, bukan invarian
|
|
18
|
+
keras. Impor kernel aplikasi hanya melalui `#minicore`.
|
|
17
19
|
|
|
18
20
|
Patch host yang diperlukan runtime tersimpan di `scripts/vendor-overlays/` dan
|
|
19
|
-
diterapkan saat sinkronisasi vendor
|
|
20
|
-
|
|
21
|
+
diterapkan saat sinkronisasi vendor. `bun run vendor:check` masih bisa dipakai
|
|
22
|
+
sebagai alat diagnosa provenance, tetapi bukan gate: hash yang tercatat di
|
|
23
|
+
`VENDOR.md` adalah checkpoint historis dan tidak ikut berubah saat kernel
|
|
24
|
+
diedit di host.
|
|
21
25
|
|
|
22
26
|
- `cli/` boleh impor `src/ui/` + `src/`; `src/` non-ui dilarang impor `src/ui/`; `src/ui/` dilarang impor `cli/`, `src/` non-ui, `#minicore`. Dijaga `test/ui-boundary.test.ts`.
|
|
23
27
|
- Satu-satunya jendela UI↔luar: `src/ui/contract.ts` (`UiEvent/UiBus/UiStep/UiExecution`).
|
|
@@ -120,7 +124,7 @@ Sesi interaktif (`minicode` di TTY mampu) SELALU membuka TUI **fullscreen altern
|
|
|
120
124
|
| stderr | Progress/diagnostik: ledger tool (`› …` hijau/merah), reasoning (verbose), warning, error. Boleh transient bila TTY |
|
|
121
125
|
| Keduanya | Warna hanya bila TTY (`stdout.isTTY`); `NO_COLOR` menang; `TERM`/`COLORTERM` tidak menyalakan warna di pipe |
|
|
122
126
|
|
|
123
|
-
Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
|
|
127
|
+
Satu-satunya arbitrator transient: `src/ui/runtime/statusline.ts` (`acquireTransientPaint` + `paintWrite`). Painter aktif (garis status turn vs spinner wizard vs bar loading) mutually exclusive; overlap = signal `[transient-paint]`, bukan crash. Foreign stderr writer (non-UI) boleh mentah — arbitrator mengkomitnya sebagai baris permanen bersih. `beginInteractiveScreen` menahan semua painter itu selama layar interaktif memegang terminal; tulis asing saat alt-screen hidup juga menandai terminal "kotor" (`consumeScreenDrift`) agar layar memaksa repaint penuh pada paint berikutnya. Bar loading startup (`src/ui/runtime/loading-bar.ts`) adalah painter transient jenis kedua: single-line blok `▓░` + persen + label, digambar ulang hanya saat `update(label, percent)` dipanggil, TTY-only (non-TTY = no-op nol byte), label disanitasi. Diagnostik fase startup (identity/writer/resume/recovery/context) didefer saat REPL ke `ctx.startupNotices` dan di-flush ke transcript TUI; non-interaktif tetap mencetak langsung. 35 invariant (I1–I35) + peta test (`tui-app`, `screen-buffer`, `tui-popup`, `transient-arbitration`, `loading-bar`, `input-resize`, `exit-codes`, `acp`, `ui-boundary`) ada di `TERMINAL_CONTRACT.md`. Kontrak itu juga memuat **peta gap proteksi** — klaim yang implementasinya benar tetapi belum punya assertion penjaga; itu daftar pekerjaan, bukan daftargreens.
|
|
124
128
|
|
|
125
129
|
Enam primitif tampilan (semuanya di dalam TUI fullscreen saat interaktif): transkrip `minicode ›` tampil saat boot/idle dan kembali otomatis setelah turn selesai + jawaban model + ledger ` › name target` hijau / ` › name: …` merah; status bar satu baris (`✦ 00.00.00 Work Mode: Discuss model cwd … context Permission Mode: Auto`) dengan sesi baru `DISCUSS`+`AUTO`, pilihan Work Mode hanya Discuss/Plan/Build dan Permission Mode hanya Auto/Ask; Work Mode di kiri dan Permission Mode cyan rata kanan dekat konteks (label dipadatkan pada terminal sempit; timer redup idle, saat aktif hanya detik putih, menit ikut terang setelah 60 dtk, jam setelah 1 jam; sparkle proses; tanpa bullet separator; `src/ui/tui/app.ts` merender composer dots dan satu spacer di atas footer per frame); popup komposit satu kotak (`/model`, `/provider`, `/sessions`, form, approval) via `openAltScreen`/`paintRegion`; thinking redup tanpa marker transcript (composer dots; isi via `/expand`); error `pesan actionable` berwarna merah sekali per kegagalan (`takePendingError`). Status/konfirmasi perintah (sync, auth, config, spinner) memakai warna saja tanpa icon.
|
|
126
130
|
|
package/docs/concepts.md
CHANGED
|
@@ -6,7 +6,7 @@ Minicode itu apa, kenapa dibangun begitu, dan kenapa beberapa hal sengaja tidak
|
|
|
6
6
|
|
|
7
7
|
| Nama | Apa |
|
|
8
8
|
|---|---|
|
|
9
|
-
| **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP`.
|
|
9
|
+
| **MiniCore** | Kernel runtime `STATE / MODEL / ACTION / LOOP`. Zero-dependency, di-vendor ke `vendor/minicore`; dapat diedit di host sejak v0.16.0 (angka provenance historis dicatat di `vendor/minicore/VENDOR.md`). Bukan dependency — di-resolve lewat subpath imports `#minicore` |
|
|
10
10
|
| **Minicode** | Layer agencode di atasnya: tools, sub-agents, skills, hooks, policy/sandbox, providers, MCP/LSP, memory, sessions, repo-map, verifier, dan CLI dengan TUI interaktif serta jalur non-interaktif shell-first |
|
|
11
11
|
|
|
12
12
|
|
package/docs/contributing.md
CHANGED
|
@@ -45,14 +45,15 @@ Gerbang lambat/stokastik (docker sandbox) tinggal di `slow.yml` — kegagalannya
|
|
|
45
45
|
|
|
46
46
|
### Budget ukuran paket (3.968 KiB)
|
|
47
47
|
|
|
48
|
-
`bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi
|
|
48
|
+
`bun run gate:pack` mengukur ukuran tarball (`npm pack --dry-run`, KiB) dan menolak bila **melebihi 4.096 KiB (4,0 MiB)**. Angka tunggalnya ada di `scripts/pack-budget.ts` — satu sumber untuk gate dan tes, jadi keduanya tak bisa menyimpang. Batas ini **alarm regresi** (menangkap `node_modules`/`test` ikut terbawa), bukan target ukuran yang perlu dikejar.
|
|
49
49
|
|
|
50
|
-
Batas
|
|
50
|
+
Batas 4.096 KiB disetujui pemilik pada 2026-11-11 untuk rilis v0.21.0. Jangan menaikkan anggaran tanpa bukti baru dan persetujuan pemilik; ukur dulu runtime serta berkas non-runtime yang dapat dipangkas.
|
|
51
51
|
|
|
52
52
|
Gerbang lain:
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
|
-
bun run gate:bash #
|
|
55
|
+
bun run gate:bash # korpus pola serangan + perintah sah (auto & allowlist) → 0 bypass / 0 over-block
|
|
56
|
+
# hitungan tercetak oleh probe itu sendiri; jangan disalin ke dokumen
|
|
56
57
|
bun run bench:smoke # fake, CI-safe
|
|
57
58
|
bun run vendor:check # provenance MiniCore (soft; vendor host-editable sejak v0.16.0)
|
|
58
59
|
```
|
package/docs/environment.md
CHANGED
|
@@ -69,6 +69,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
|
|
|
69
69
|
|---|---|
|
|
70
70
|
| `MINICODE_BUDGET_STRICT` | `1` → penegasan eksplisit fail-closed (cost tak dikenal + pemakaian = over; kini juga default `--budget`) |
|
|
71
71
|
| `MINICODE_MAX_TURNS` | Batas keras maksimum jumlah turn per sesi (termasuk carry-forward lintas `--resume`; bilangan ≥1) |
|
|
72
|
+
| `MINICODE_AUTO_CONTINUE` | `1` → pada `exec`, saat turn berakhir `max_steps_exceeded`, lanjutkan turn pada sesi yang sama (progres parsial sudah durable) alih-alih gagal; dibatasi `--max-turns` (default 3) |
|
|
72
73
|
| `MINICODE_ALLOW_LOCAL_CONFIG` | `1` → percayai config lokal workspace (default: diabaikan) |
|
|
73
74
|
|
|
74
75
|
## Terminal & aksesibilitas
|
|
@@ -86,6 +87,7 @@ Variabel yang paling menentukan perilaku (sisanya referensi di bawah):
|
|
|
86
87
|
| `MINICODE_A11Y` | `1` → live-region approval untuk screen reader (baris polos tanpa ANSI) |
|
|
87
88
|
| `MINICODE_SHOW_THINKING` | reasoning model terlihat SECARA DEFAULT; `0` → minimized (hanya penanda), `1` → paksa terlihat |
|
|
88
89
|
| `MINICODE_MINIMIZE_ACTIVITY` | ON secara default di TUI; `0` → transparan (baris per-tool). Lipat aktivitas tool per turn jadi satu ringkasan (detail via `/expand`) |
|
|
90
|
+
| `MINICODE_ACTIVITY_PANEL` | `0` → matikan panel aktivitas (default AKTIF di TUI; `/fold` toggle); `1` → paksa aktif juga di jalur linear/one-shot |
|
|
89
91
|
| `MINICORE_THINKING` | `off` → kirim `enable_thinking:false` ke OpenAI-compat (DeepSeek). Alias lama `MINICODE_THINKING` masih dihormati |
|
|
90
92
|
| `NO_COLOR` | Set apa pun selain `0` → matikan seluruh warna |
|
|
91
93
|
|