minicode-ai 0.23.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +2 -2
  2. package/cli/tui.ts +28 -2
  3. package/docs/README.md +2 -2
  4. package/docs/SUMMARY.md +10 -19
  5. package/docs/TERMINAL_CONTRACT.md +82 -28
  6. package/docs/architecture.md +1 -1
  7. package/docs/autonomous-scheduler.md +283 -2
  8. package/docs/choosing-mode.md +4 -4
  9. package/docs/concepts.md +39 -3
  10. package/docs/config.md +90 -4
  11. package/docs/environment.md +3 -0
  12. package/docs/getting-started.md +58 -2
  13. package/docs/repl.md +1 -1
  14. package/docs/security.md +49 -2
  15. package/docs/tools.md +2 -1
  16. package/package.json +2 -36
  17. package/src/app/provider-layer.ts +1 -1
  18. package/src/config.ts +2 -0
  19. package/src/constants.ts +3 -0
  20. package/src/lib/safe-open.ts +21 -12
  21. package/src/memory/vector.ts +0 -31
  22. package/src/policy/context-window.ts +0 -33
  23. package/src/policy/no-progress.ts +1 -1
  24. package/src/policy/permission.ts +5 -0
  25. package/src/policy/scrub.ts +15 -2
  26. package/src/policy/tool-contract.ts +11 -9
  27. package/src/presentation/reducer.ts +1 -0
  28. package/src/providers/anthropic.ts +3 -3
  29. package/src/providers/detect.ts +27 -0
  30. package/src/providers/provision.ts +15 -1
  31. package/src/task/autonomous-policy.ts +7 -0
  32. package/src/task/graph-validate.ts +1 -1
  33. package/src/task/session-authority.ts +0 -5
  34. package/src/task/store.ts +0 -4
  35. package/src/tools/ask_user.ts +14 -1
  36. package/src/tools/bash.ts +57 -9
  37. package/src/tools/context.ts +10 -0
  38. package/src/tools/delete_file.ts +3 -2
  39. package/src/tools/edit.ts +5 -4
  40. package/src/tools/git.ts +70 -12
  41. package/src/tools/glob.ts +13 -5
  42. package/src/tools/grep.ts +26 -10
  43. package/src/tools/index.ts +3 -2
  44. package/src/tools/lsp.ts +15 -9
  45. package/src/tools/move_file.ts +4 -3
  46. package/src/tools/patch.ts +5 -4
  47. package/src/tools/read_file.ts +3 -2
  48. package/src/tools/read_image.ts +3 -2
  49. package/src/tools/task.ts +1 -0
  50. package/src/tools/todo.ts +4 -8
  51. package/src/tools/write_file.ts +4 -3
  52. package/src/ui/approval/prompt.ts +226 -77
  53. package/src/ui/footer.ts +41 -29
  54. package/src/ui/i18n/en.ts +4 -0
  55. package/src/ui/i18n/id.ts +4 -0
  56. package/src/ui/render/activity-group.ts +1 -0
  57. package/src/ui/render/ledger.ts +1 -9
  58. package/src/ui/render/logo.ts +0 -5
  59. package/src/ui/render/markdown-table.ts +0 -3
  60. package/src/ui/render/table-grid.ts +0 -3
  61. package/src/ui/render/theme.ts +31 -5
  62. package/src/ui/runtime/screen.ts +7 -1
  63. package/src/ui/screens/dialog.ts +45 -81
  64. package/src/ui/screens/form.ts +10 -10
  65. package/src/ui/screens/model-manager.ts +7 -10
  66. package/src/ui/screens/picker.ts +8 -11
  67. package/src/ui/screens/provider-manager.ts +9 -13
  68. package/src/ui/tui/app.ts +92 -9
  69. package/src/ui/tui/transcript.ts +4 -0
  70. package/docs/P14_OPEN_WORK.md +0 -290
  71. package/docs/config-providers.md +0 -87
  72. package/docs/glossary.md +0 -39
  73. package/docs/quickstart.md +0 -60
  74. package/docs/security-model.md +0 -96
  75. package/docs/terminal.md +0 -91
@@ -14,7 +14,7 @@ import { c, stripAnsi } from "../render/theme.ts"
14
14
  import { displayWidth, truncateToWidth } from "../render/width.ts"
15
15
  import { type AltScreen, openAltScreen } from "../runtime/screen.ts"
16
16
  import { beginInteractiveScreen } from "../runtime/statusline.ts"
17
- import { boxLeftPad, dialogBox } from "./dialog.ts"
17
+ import { boxLeftPad, dialogBox, popupBoxWidth } from "./dialog.ts"
18
18
  import { createIdleTimer } from "./lifecycle.ts"
19
19
 
20
20
  export interface PickerItem {
@@ -33,9 +33,6 @@ export interface PickerOptions {
33
33
 
34
34
  const dim = (s: string): string => c.dim(s)
35
35
 
36
- /** Lebar kotak popup picker TETAP (keputusan rasa: geometri stabil). */
37
- const PICKER_BOX_W = 64
38
-
39
36
  // Tandai substring query di label agar user tahu KENAPA item cocok.
40
37
  // Operasi pada teks plain (sebelum truncate) — SGR bold nol kolom.
41
38
  function highlightMatch(label: string, query: string): string {
@@ -72,6 +69,8 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
72
69
  let scroll = 0
73
70
  let filter = ""
74
71
  const isFilterable = opts.filterable ?? false
72
+ // Lebar dibekukan saat mount (AUD-006).
73
+ const boxWidth = popupBoxWidth(process.stdout.columns || 80)
75
74
 
76
75
  const filteredItems = (): PickerItem[] => {
77
76
  if (!isFilterable || !filter) return opts.items
@@ -95,11 +94,9 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
95
94
  const chrome = isFilterable ? 4 : 3
96
95
  return Math.max(1, Math.min(rows - chrome, 12))
97
96
  }
98
- // Lebar konten = lebar kotak TETAP (min=max, keputusan rasa: geometri
99
- // stabil, tak bernapas saat filter) dikurangi chrome dialog
97
+ // Lebar konten = lebar kotak (dibekukan saat mount) dikurangi chrome dialog
100
98
  // (border+padding = 4 kolom) agar dialogBox tak memotong ulang label.
101
- const width = () =>
102
- Math.max(8, Math.min((process.stdout.columns || 80) - 2 - 4, PICKER_BOX_W - 4))
99
+ const width = () => Math.max(8, boxWidth - 4)
103
100
 
104
101
  // Isi untuk dialog popup (tanpa judul; hint aksi satu baris di dasar).
105
102
  const bodyLines = (): string[] => {
@@ -152,13 +149,13 @@ export async function runPicker(opts: PickerOptions): Promise<void> {
152
149
  const render = () => {
153
150
  // Popup komposit: HANYA region kotak yang dilukis (tanpa clear) di atas
154
151
  // konten pemilik layar (transkrip App / alt-buffer wizard). Pemilik
155
- // me-repaint penuh saat popup tutup. Lebar TETAP 64 (min=max).
152
+ // Lebar beku (min=max): geometri tak bernapas saat filter berubah.
156
153
  const box = dialogBox(
157
154
  {
158
155
  title: "",
159
156
  body: bodyLines(),
160
- minWidth: PICKER_BOX_W,
161
- maxWidth: PICKER_BOX_W,
157
+ minWidth: boxWidth,
158
+ maxWidth: boxWidth,
162
159
  },
163
160
  screen.cols,
164
161
  screen.rows,
@@ -14,7 +14,7 @@ import { cleanUntrusted, sanitizeAnsiLine } from "../render/sanitize.ts"
14
14
  import { c, glyphs, stripAnsi } from "../render/theme.ts"
15
15
  import { truncateToWidth } from "../render/width.ts"
16
16
  import { type AltScreen, openAltScreen } from "../runtime/screen.ts"
17
- import { boxLeftPad, dialogBox } from "./dialog.ts"
17
+ import { boxLeftPad, dialogBox, popupBoxWidth } from "./dialog.ts"
18
18
  import { runForm, validateRequired, validateUrl } from "./form.ts"
19
19
  import { createIdleTimer } from "./lifecycle.ts"
20
20
  import { runPicker } from "./picker.ts"
@@ -23,10 +23,8 @@ import { withTimeout } from "./watchdog.ts"
23
23
  const dim = (s: string): string => c.dim(s)
24
24
 
25
25
  /** Lebar tetap popup provider setelah daftar diringkas ke nama provider. */
26
- /** Lebar kotak dialog /providers: TETAP 64 kolom — paritas picker/model/wizard
27
- * (audit B3: 52 terlalu sempit; nama provider/ID panjang + baris hint aksi
28
- * terpotong). Geometri tetap (min=max), tak pernah melompat mengikuti konten. */
29
- const PROVIDER_BOX_W = 64
26
+ /** Lebar kotak /providers: `popupBoxWidth` — paritas picker/model/form (AUD-006). */
27
+ const providerBoxWidth = (): number => popupBoxWidth(process.stdout.columns || 80)
30
28
 
31
29
  export interface ProviderRow {
32
30
  id: string
@@ -102,10 +100,9 @@ export async function runProviderManagerView(opts: ProviderManagerViewOptions):
102
100
  const fixed = 3 + (notice ? 1 : 0)
103
101
  return Math.max(1, Math.min(rows - fixed, 14))
104
102
  }
105
- // Lebar konten = lebar kotak TETAP (min=max, paritas picker/model) —
106
- // dikurangi chrome dialog (lihat picker.ts).
107
- const width = () =>
108
- Math.max(8, Math.min((process.stdout.columns || 80) - 2 - 4, PROVIDER_BOX_W - 4))
103
+ // Lebar konten = lebar kotak (dibekukan saat mount) dikurangi chrome
104
+ // dialog (lihat picker.ts).
105
+ const width = () => Math.max(8, providerBoxWidth() - 4)
109
106
 
110
107
  // Isi popup ringkas: nama provider dan hasil aksi sementara.
111
108
  const bodyLines = (): string[] => {
@@ -151,14 +148,13 @@ export async function runProviderManagerView(opts: ProviderManagerViewOptions):
151
148
 
152
149
  const render = () => {
153
150
  // Popup komposit: HANYA region kotak (tanpa clear) di atas konten
154
- // pemilik layar. Lebar TETAP 64 (min=max, paritas picker/model) —
155
- // tak pernah melompat mengikuti konten.
151
+ // Lebar beku (min=max, paritas picker/model).
156
152
  const box = dialogBox(
157
153
  {
158
154
  title: "",
159
155
  body: bodyLines(),
160
- minWidth: PROVIDER_BOX_W,
161
- maxWidth: PROVIDER_BOX_W,
156
+ minWidth: providerBoxWidth(),
157
+ maxWidth: providerBoxWidth(),
162
158
  },
163
159
  screen.cols,
164
160
  screen.rows,
package/src/ui/tui/app.ts CHANGED
@@ -26,7 +26,7 @@ import {
26
26
  import { appendWrapped, shaveWrapped } from "../render/composer-wrap.ts"
27
27
  import { formatError } from "../render/errors.ts"
28
28
  import { sanitizeAnsi, sanitizeAnsiLine, stripSgr } from "../render/sanitize.ts"
29
- import { c } from "../render/theme.ts"
29
+ import { c, scrimMode, scrimSgr } from "../render/theme.ts"
30
30
  import { chunkByWidth, displayWidth, escapeLength, truncateToWidth } from "../render/width.ts"
31
31
  import { motionReduced } from "../runtime/motion.ts"
32
32
  import { type AltScreen, forceRestoreScreenForSignal, openAltScreen } from "../runtime/screen.ts"
@@ -79,6 +79,8 @@ const PROMPT_FIRST = "minicode › "
79
79
  const PROMPT_CONT = " · "
80
80
  const TIMER_TEXT = "00.00.00"
81
81
  const DOT_INTERVAL_MS = 200
82
+ /** Badge job background berputar lebih pelan dari dots (tidak berkedip). */
83
+ const WAITING_INTERVAL_MS = 400
82
84
  const DOT_PHASES = ["...", "..", ".", ".."] as const
83
85
  const MOUSE_DRAG_ON = "\x1b[?1002h\x1b[?1006h"
84
86
  const MOUSE_WHEEL_ON = "\x1b[?1000h\x1b[?1006h"
@@ -241,6 +243,10 @@ export class TuiApp {
241
243
  private thinkingActive = false
242
244
  private turnStartedAt = 0
243
245
  private activityTimer: ReturnType<typeof setTimeout> | undefined
246
+ // Clock badge job background: TERPISAH dari activityTimer karena job hidup
247
+ // justru saat turn IDLE (activityTimer hanya jalan saat busy).
248
+ private waitingTimer: ReturnType<typeof setTimeout> | undefined
249
+ private waitingStartedAt = 0
244
250
  /** Timestamp abort terakhir (ms) — deteksi double-tap Esc = quit. */
245
251
  private lastAbortAt = 0
246
252
  /** Hint "tekan lagi untuk keluar" tampil sekali setelah abort pertama. */
@@ -527,6 +533,7 @@ export class TuiApp {
527
533
  this.repaintTimer = undefined
528
534
  }
529
535
  this.stopActivityClock()
536
+ this.stopWaitingClock()
530
537
  this.stopAutoScroll()
531
538
  for (const unsubscribe of this.busUnsubs.splice(0)) {
532
539
  try {
@@ -923,6 +930,7 @@ export class TuiApp {
923
930
  this.host.abort()
924
931
  } catch {}
925
932
  this.stopActivityClock()
933
+ this.stopWaitingClock()
926
934
  this.quitRequested = true
927
935
  this.finish?.()
928
936
  }
@@ -1028,18 +1036,22 @@ export class TuiApp {
1028
1036
  }
1029
1037
 
1030
1038
  /**
1031
- * Bungkus baris dengan mode redup (\x1b[2m) untuk backdrop popup.
1032
- * Reset (\x1b[0m atau \x1b[22m) dan bold (\x1b[1m) di dalam teks dinetralkan
1033
- * agar peredupan tidak bocor di tengah baris yang diwarnai.
1039
+ * Bungkus baris dengan scrim latar netral bila tersedia. Reset SGR dalam
1040
+ * konten dipulihkan ke keadaan scrim agar warna teks tak mematikan backdrop.
1034
1041
  */
1035
1042
  static applyBackdropDim(ln: string): string {
1036
1043
  if (!ln) return ""
1044
+ const mode = scrimMode()
1045
+ if (mode === "none") return ln
1037
1046
  const esc = String.fromCharCode(27)
1038
- let s = ln.replaceAll(`${esc}[1m`, "")
1039
- s = s.replaceAll(`${esc}[22m`, `${esc}[2m`)
1040
- s = s.replaceAll(`${esc}[0m`, `${esc}[0m${esc}[2m`)
1041
- s = s.replaceAll(`${esc}[m`, `${esc}[0m${esc}[2m`)
1042
- return `${esc}[2m${s}${esc}[22m${esc}[0m`
1047
+ const scrim = scrimSgr(mode)
1048
+ // Bold DIPETAKAN ke scrim (bukan dibuang) dan `[22m` memulihkan scrim,
1049
+ // bukan meninggalkan teks normal (AUD-003).
1050
+ let s = ln.replaceAll(`${esc}[1m`, scrim)
1051
+ s = s.replaceAll(`${esc}[22m`, `${esc}[22m${scrim}`)
1052
+ s = s.replaceAll(`${esc}[0m`, `${esc}[0m${scrim}`)
1053
+ s = s.replaceAll(`${esc}[m`, `${esc}[0m${scrim}`)
1054
+ return `${scrim}${s}${esc}[22m${esc}[0m`
1043
1055
  }
1044
1056
 
1045
1057
  /** Layar redup sebagai backdrop popup: frame normal dibungkus faint. */
@@ -1221,6 +1233,46 @@ export class TuiApp {
1221
1233
  }
1222
1234
  }
1223
1235
 
1236
+ // Clock badge job background: berjalan selama ada job hidup, termasuk saat
1237
+ // turn idle (justru saat itulah job biasanya selesai).
1238
+ private startWaitingClock(): void {
1239
+ if (this.waitingTimer !== undefined || this.quitRequested) return
1240
+ if (!this.waitingStartedAt) this.waitingStartedAt = Date.now()
1241
+ const tick = () => {
1242
+ this.waitingTimer = undefined
1243
+ if (this.quitRequested) return
1244
+ if (!this.hasBackgroundJobs()) {
1245
+ this.waitingStartedAt = 0
1246
+ return
1247
+ }
1248
+ if (this.suspended === 0 && !this.released) this.paintCurrent()
1249
+ if (this.quitRequested) return
1250
+ this.startWaitingClock()
1251
+ }
1252
+ this.waitingTimer = setTimeout(tick, WAITING_INTERVAL_MS)
1253
+ try {
1254
+ ;(this.waitingTimer as unknown as { unref?: () => void }).unref?.()
1255
+ } catch {}
1256
+ }
1257
+
1258
+ private stopWaitingClock(): void {
1259
+ if (this.waitingTimer !== undefined) {
1260
+ clearTimeout(this.waitingTimer)
1261
+ this.waitingTimer = undefined
1262
+ }
1263
+ this.waitingStartedAt = 0
1264
+ }
1265
+
1266
+ /** Jumlah job hidup dari snapshot host (0 bila host tak melaporkan). */
1267
+ private hasBackgroundJobs(): boolean {
1268
+ try {
1269
+ const jobs = this.host.getStatus().footer.backgroundJobs ?? 0
1270
+ return jobs >= 1
1271
+ } catch {
1272
+ return false
1273
+ }
1274
+ }
1275
+
1224
1276
  private activityStatus(snap: TuiStatusSnapshot): string {
1225
1277
  const activity = snap.pinnedActivity
1226
1278
  if (!activity) return ""
@@ -1299,6 +1351,27 @@ export class TuiApp {
1299
1351
  if (!this.quitRequested && this.suspended === 0) this.paintCurrent()
1300
1352
  }
1301
1353
 
1354
+ // Titik masuk popup komposit (approval/ask_user): lukis kotak di atas
1355
+ // transkrip yang sudah redup. Geometri milik currentScreen.
1356
+ paintRegion(lines: string[], topRow: number): void {
1357
+ if (!this.currentScreen || this.quitRequested) return
1358
+ try {
1359
+ this.currentScreen.paintRegion(lines, topRow)
1360
+ } catch (error) {
1361
+ this.stopAfterRuntimeError(error)
1362
+ }
1363
+ }
1364
+
1365
+ /** Hapus region popup (pasangan paintRegion); App akan repaint penuh saat resume. */
1366
+ clearRegion(): void {
1367
+ if (!this.currentScreen) return
1368
+ try {
1369
+ this.currentScreen.clearRegion()
1370
+ } catch (error) {
1371
+ this.stopAfterRuntimeError(error)
1372
+ }
1373
+ }
1374
+
1302
1375
  private viewportHeight(rows: number, cols: number): number {
1303
1376
  const busy = this.isBusy()
1304
1377
  const inputH = this.composerHeight(cols, busy)
@@ -1654,6 +1727,10 @@ export class TuiApp {
1654
1727
  this.thinkingActive = false
1655
1728
  this.turnStartedAt = 0
1656
1729
  }
1730
+ // Badge hidup saat busy DAN idle; clock-nya terpisah dari activity.
1731
+ const backgroundJobs = snap.footer.backgroundJobs ?? 0
1732
+ if (backgroundJobs >= 1) this.startWaitingClock()
1733
+ else this.stopWaitingClock()
1657
1734
  const newCount = this.scrollBack > 0 ? this.transcript.total() - this.scrollBase : 0
1658
1735
  // Baris indikator WAJIB dipotong ke lebar frame seperti baris lain: teks
1659
1736
  // locale id lebih panjang dari terminal sempit (51 kolom untuk abort hint),
@@ -1736,6 +1813,12 @@ export class TuiApp {
1736
1813
  timer,
1737
1814
  timerActive: busy,
1738
1815
  timerHighlight: timerHighlight(elapsed),
1816
+ // Frame badge dihitung dari clock badge sendiri (waitingStartedAt),
1817
+ // bukan dari turn: job background berputar juga saat idle.
1818
+ backgroundFrame:
1819
+ backgroundJobs >= 1 && !motionReduced()
1820
+ ? Math.floor((now - (this.waitingStartedAt || now)) / WAITING_INTERVAL_MS)
1821
+ : 0,
1739
1822
  },
1740
1823
  width,
1741
1824
  )[0] ?? ""
@@ -54,6 +54,10 @@ export interface ApprovalSink {
54
54
  repaint(): void
55
55
  suspend(): void
56
56
  resume(): void
57
+ /** Lukis kotak modal di atas transkrip (popup komposit). Opsional: sink warisan (mock/test) boleh tanpa. */
58
+ paintRegion?(lines: string[], topRow: number): void
59
+ /** Hapus kotak modal sebelum resume. Opsional. */
60
+ clearRegion?(): void
57
61
  }
58
62
 
59
63
  let approvalSink: ApprovalSink | null = null
@@ -1,290 +0,0 @@
1
- # Open Work — Pekerjaan Lintas Sesi
2
-
3
- Panduan operasi untuk pekerjaan belum selesai lintas sesi (P14). Semua yang
4
- dijelaskan di sini memakai mekanisme otoritas yang SUDAH ADA — TaskStore tetap
5
- satu-satunya otoritas status; tidak ada TaskStore/queue/scheduler kedua.
6
-
7
- Panduan ini menjelaskan surface Open Work yang tersedia. Batasannya meliputi
8
- ekstraksi intent dari prosa bebas, readout TUI `/openwork`, merge dengan
9
- lease/admission, dan merge lintas sesi tanpa adopsi eksplisit.
10
-
11
- ## Gambaran alur
12
-
13
- ```
14
- minicode openwork ① TEMUKAN (read-only, lintas sesi)
15
- minicode openwork inventory ①b AUDIT (inventaris P14.0 lintas sumber)
16
- minicode openwork context --session S --task tN
17
- ①c SUSUN KONTEKS (P14.5, tanpa eksekusi)
18
- minicode --session <target> \
19
- --adopt-task <source>/<taskId> "..." ② ADOPSI (eksplisit, otoritas ganda)
20
- /scheduler run ③ LANJUTKAN (manual, lewat gate continuity)
21
- (minimum satu turn) ④ KERJAKAN (claim = generasi BARU)
22
- minicode openwork --closed ⑤ TUTUP (feedback berprovenance)
23
- minicode openwork export --out FILE ⑤b EKSPOR (json/md, atomik)
24
- minicode openwork merge ... ⑥ DEDUP (eksplisit + evidence)
25
- ```
26
-
27
- ## ① Menemukan: `minicode openwork`
28
-
29
- Portofolio read-only seluruh task non-terminal di **workspace ini** (tasks.db
30
- memang per-workspace — sesi proyek lain memang tidak terlihat, itu batas yang
31
- benar, bukan bug), **ditambah** kandidat intent terstruktur dari histori
32
- (lihat "Kandidat intent" di bawah).
33
-
34
- ```
35
- Open Work — 1 item(s) · 1 intent · 1 stale · 0 unknown-provenance
36
- workspace: D:\proyek · stale after 7d · TaskStore remains the sole status authority
37
-
38
- p14ow-source/t1 · IN_PROGRESS · PARTIAL · P2 · 2d old
39
- title: Fix login bug
40
- flags: STALE · FROM:p14ow-source · SIMILAR×2(UNPROVEN)
41
- blockers: TASK_BLOCKED: API key rotated
42
- depends on: t2 (PENDING, unsatisfied)
43
- next: resume: rebuild context from provenance, then continue via TaskStore/Scheduler
44
- ```
45
-
46
- Arti bidang:
47
-
48
- | Bidang | Makna |
49
- |---|---|
50
- | `status` | status kanonik TaskStore — **satu-satunya otoritas** |
51
- | state (kolom ke-4) | state P14.1 berbasis bukti: `OPEN/PARTIAL/BLOCKED/WAITING_FOR_USER/DELEGATED/FAILED_NEEDS_FOLLOWUP/UNKNOWN`; verifikasi gagal → FAILED_NEEDS_FOLLOWUP, dependensi tak tuntas → BLOCKED |
52
- | `P0..P3` | prioritas presentasi: BLOCKED/FAILED=P0, WAITING/DELEGATED/UNKNOWN=P1, PARTIAL=P2, OPEN=P3; item STALE dinaikkan satu tingkat — umur sinyal, bukan bukti |
53
- | `blockers:` | blocker eksplisit (TASK_BLOCKED / DEPENDENCY / VERIFICATION); kosong = tidak ada yang diklaim |
54
- | `depends on:` | dependensi kanonik direkonsiliasi ke status saat baca; hanya COMPLETED yang *satisfied* |
55
- | `next:` | tindak lanjut eksplisit — selalu lewat jalur otoritas yang ada; openwork TIDAK PERNAH mengeksekusi |
56
-
57
- Arti penanda:
58
-
59
- | Penanda | Makna | Tindak lanjut |
60
- |---|---|---|
61
- | `STALE` | baris tak bergerak ≥ ambang (default 7 hari, `--stale-days <n>`) | prioritas, bukan keputusan otoritas |
62
- | `PROVENANCE-UNKNOWN` | tidak ada baris sesi di sessions.db — asal tak bisa ditelusuri | periksa manual; jangan dianggap rusak |
63
- | `FROM:<sesi>` | task ini DIPINDAHKAN dari sesi lain (ledger `task_transfers`) | provenance asal eksplisit |
64
- | `SIMILAR×N(UNPROVEN)` | N task berbagi judul ternormalisasi | **bukan bukti duplikat** — lihat ⑥ |
65
- | `DUP-GROUP×N(UNPROVEN)` | grup duplikat **lintas sesi** (task + intent) beranggota N | lihat seksi "Grup duplikat lintas sesi" |
66
-
67
- Filter: `--session <id>`, `--status <S>`, `--state <S>`, `--priority <P0..P3>`,
68
- `--min-age-days <n>`, `--blocked`, `--depends-on <taskId>`, `--closed`,
69
- `--json` (satu objek JSON mesin di stdout). Exit: `0` sukses (termasuk daftar
70
- kosong), `1` gagal runtime/lookup, `2` salah pakai (nilai enum tak dikenal
71
- termasuk).
72
-
73
- **Batas kejujuran:** `openwork` tidak pernah menulis apa pun — tidak
74
- mengakuisisi lease, tidak membuat sessions.db, tidak menulis backup manifest
75
- korup, tidak memicu scheduler. Ia indeks, bukan otoritas. (Dijaga guard
76
- arsitektur + tes nol-mutasi, kini termasuk jalur inventaris.)
77
-
78
- ## Kandidat intent: histori terstruktur, TANPA menebak prosa
79
-
80
- Portofolio juga menampilkan **kandidat intent open** dari histori yang
81
- terstruktur dan durable:
82
-
83
- | Sumber | Kapan jadi kandidat | State |
84
- |---|---|---|
85
- | `plan.updated` | langkah plan `pending`/`active`/`blocked` **tanpa** task kanonik (atau baris task-nya hilang) | OPEN / PARTIAL / BLOCKED |
86
- | `approval.requested` | belum ada `approval.settled` | WAITING_FOR_USER |
87
- | sesi anak sub-agent | belum ada hasil terminal | DELEGATED |
88
- | sesi anak + `turn.failed` | delegasi gagal | FAILED_NEEDS_FOLLOWUP |
89
- | run `INTERRUPTED` | eksekusi terputus (restart/kill) | FAILED_NEEDS_FOLLOWUP |
90
-
91
- Yang SENGAJA tidak dilakukan: memindai isi pesan bebas pengguna. Janji dari
92
- prosa ("nanti kita perbaiki login") TIDAK PERNAH menjadi tugas — roadmap P14
93
- melarang menganggap brainstorming sebagai task, dan menentukan kapan intent
94
- prosa jadi komitmen adalah keputusan produk yang belum diputuskan pemilik.
95
-
96
- Aturan kejujuran ekstraksi (dijaga tes):
97
-
98
- 1. Langkah plan yang menunjuk task kanonik yang masih OPEN **menempel sebagai
99
- bukti** di entri task (`plan evidence`), bukan item duplikat.
100
- 2. Langkah plan yang mengaku `active` atas task yang SUDAH terminal tidak
101
- dihidupkan kembali — masuk closure dengan alasan "canonical task
102
- <status> supersedes plan claim", konflik diungkap, bukan disembunyikan.
103
- 3. Approval yang di-**allow** bukan bukti pekerjaan selesai — tidak
104
- menghasilkan kandidat apa pun (hanya deny yang menghasilkan DECLINED).
105
- 4. Run `RUNNING` bukan open loop — runtime hidup adalah kondisi normal.
106
- 5. Cakupan pencarian dibatasi binding `cwd` baris sesi; **sesi anak mewarisi
107
- cakupan leluhur termulaiannya** (hasil sub-agent tetap terlihat); sesi
108
- tanpa binding dilabel UNBOUND dan dikeluarkan — tidak ada yang ditebak.
109
- 6. `plan.updated` adalah **snapshot**, bukan delta: adaptor menerbitkannya setiap
110
- `todo_write` sukses dengan SELURUH daftar langkah. Hanya snapshot TERAKHIR
111
- per **sesi** yang dibaca (bukan per `planId` — `planId` memuat nomor turn,
112
- sedangkan daftar todo milik sesi). Akibatnya: versi pending/active lama tidak
113
- muncul sebagai open loop kedua, langkah yang dihapus dari daftar tidak
114
- dihidupkan, dan langkah yang masih terbuka tidak berganda di setiap turn.
115
-
116
- ## Grup duplikat lintas sesi (P14.3 penuh)
117
-
118
- Kandidat dengan judul ternormalisasi sama **lintas sesi** (termasuk task vs
119
- langkah plan) dikelompokkan dan diungkapkan:
120
-
121
- ```
122
- Similar groups — 1 (UNPROVEN, never auto-merged)
123
- "fix login bug" ×2 across 2 session(s) · DIVERGENT states
124
- sessions: p14fs-a · p14fs-b
125
- ```
126
-
127
- Grup dengan state yang saling bertentangan ditandai `DIVERGENT` (jumlahnya
128
- juga di header + `counts.conflicts`). Grup **tidak pernah** menyatukkan apa
129
- pun: perpindahan otoritas tetap wajib adopsi eksplisit (②), merge tetap
130
- satu-sesi (⑥). Tugas berulang yang sengaja independen boleh berbagi grup —
131
- itu penanda untuk diperiksa, bukan vonis.
132
-
133
- ## ①b Inventaris: `minicode openwork inventory [--json]`
134
-
135
- Inventaris P14.0 lintas sumber, read-only: jumlah sesi (in-scope / foreign /
136
- unbound / anak), task (total/open/terminal), event presentasi per tipe, run,
137
- manifest checkpoint (termasuk yang **corrupt** — dilabel, tidak dibackup oleh
138
- proyeksi), langkah plan, approval, dan hasil sub-agent. Sesi yang dikeluarkan
139
- dicantumkan **dengan alasannya**. Event yang gagal didekode dilaporkan sebagai
140
- "unreadable", tidak disembunyikan.
141
-
142
- ## ①c Konteks: `minicode openwork context --session <id> --task <taskId>`
143
-
144
- Context pack P14.5 untuk satu task: field kanonik (status/revisi/verification/
145
- dependsOn/evidence), state + prioritas + blocker + next action, bukti langkah
146
- plan, ketersediaan checkpoint (termasuk corrupt), provenance transfer/merge,
147
- freshness, dan **checklist resume**. Pack ini murni baca — checklist menunjuk
148
- jalur yang MEMAKSAK otoritas saat resume (ceiling P12, gate continuity P13.3,
149
- claim generation TaskStore, budget/cancellation P12/P13); openwork sendiri
150
- tidak memeriksa apalagi mengeksekusi. Exit `1` bila task tak ditemukan,
151
- `2` bila id cacat.
152
-
153
- ## ② Mengadopsi: `--adopt-task <source>/<taskId>`
154
-
155
- Satu task per invokasi, HANYA saat startup sesi tujuan, sebelum turn pertama:
156
-
157
- ```
158
- minicode --session target --adopt-task p14ow-source/t1 "lanjutkan pekerjaan ini"
159
- ```
160
-
161
- Yang terjadi (satu transaksi TaskStore, dicek ulang di dalam transaksi):
162
- inkarnasi sumber+tujuan, revisi, **kedua lease** (token sumber dan tujuan),
163
- status non-terminal, konsistensi lineage, tabrakan id target, dan provenance
164
- relasi. Penulis sesi sumber yang **hidup** = `REFUSED_SOURCE_BUSY` (tidak ada
165
- takeover paksa). Lease sumber kedaluwarsa = takeover + **fence epoch** —
166
- proses lama tidak bisa lagi renew/release/menulis/menjadwalkan sesi sumber.
167
-
168
- Yang TIDAK terjadi: tidak menyalin task, tidak membuat generasi baru, tidak
169
- menandai selesai, tidak menyentuh jurnal runtime/child run/approval, dan
170
- **tidak memicu scheduler**. Task in-flight hasil adopsi tetap `IN_PROGRESS`
171
- dengan lineage asli — apakah boleh dilanjutkan adalah keputusan gate (③),
172
- bukan adopsi.
173
-
174
- Rantai relasi diadopsi **berurutan** (parent/dependency dulu, lalu anak);
175
- penolakan menamai id yang belum diadopsi. Id task tidak pernah direnumber.
176
-
177
- ## ③ Melanjutkan: `/scheduler run` (manual, tersupervisi)
178
-
179
- Adopsi tidak menyalakan scheduler. Lanjutan tetap lewat trigger manual yang
180
- sudah ada (`/scheduler run` di sesi TUJUAN; butuh `--enable-scheduler` saat
181
- memulai sesi CLI, sedangkan sesi daemon hosted mendapatkannya via
182
- `--runtime owned`). Reconcilasi menilai task in-flight hasil
183
- adopsi lewat **continuity gate P13.3** — kontraknya tidak berubah:
184
-
185
- - `SAFE_TO_RETRY` (bukti resume + admission + **seluruh** scope tool otonom
186
- read-only) → revert ke PENDING → **claim generasi BARU** → dispatch serial.
187
- - Selain itu → `HOLD` / `REQUIRES_VERIFIER`, baris tidak disentuh, nol
188
- dispatch. Tanpa gate = HOLD (fail-closed).
189
-
190
- **Tidak pernah ada replay instruksi tool jurnal lama** — work item hanya
191
- membawa `(taskId, title, instruction, sessionId)`; eksekusi baru lahir dari
192
- claim baru. Permission ceiling P12, budget, cancellation, dan stop criteria
193
- P13 tetap berlaku persis seperti sesi biasa.
194
-
195
- ## ④ Menutup: lifecycle biasa
196
-
197
- Selesaian lewat jalur kanonik yang sudah ada (verifier / `todo_write` /
198
- operator) — P14 tidak punya jalur penutupan sendiri dan tidak pernah
199
- menulis `COMPLETED` atas nama operator.
200
-
201
- ## ⑤ Feedback penutupan: `minicode openwork --closed`
202
-
203
- Closure feedback adalah **pembacaan ulang status kanonik + ledger**, bukan
204
- kesimpulan: task yang sudah terminal dan punya provenance P14 (transfer
205
- atau merge) muncul dengan `status`, `closed`, `FROM <sesi>`,
206
- `duplicate-of <task>`, dan evidence operator. Duplikat yang dibuka kembali
207
- operator otomatis muncul lagi di seksi open — status saat itulah kebenaran.
208
-
209
- Sejak pengiriman full-scope, closure juga mencakup **artefak intent terminal**
210
- (`kind INTENT`) dengan **label klaim** yang wajib dibaca:
211
-
212
- | `claim` | Arti |
213
- |---|---|
214
- | `verified` | task kanonik terminal dengan `verification.verdict = passed` |
215
- | `unverified` | klaim penyelesaian oleh artefak (mis. plan step `completed`) **tanpa** verifikasi — ditampilkan apa adanya, BUKAN disembunyikan, BUKAN dianggap terbukti |
216
- | `not-applicable` | DECLINED/CANCELLED — tidak ada klaim penyelesaian untuk diverifikasi |
217
-
218
- Termasuk: approval yang ditolak pengguna → `DECLINED` (terminal, tidak pernah
219
- hidup lagi sebagai open loop), dan langkah plan yang mengaku `active` atas task
220
- terminal → closure dengan alasan "canonical task `<status>` supersedes plan
221
- claim" — konflik klaim diungkap, tidak ditelan.
222
-
223
- ## ⑤b Ekspor: `minicode openwork export --out <path> [--format json|md] [--force]`
224
-
225
- - `json` (default) — objek portofolio lengkap (selalu menyertakan inventaris
226
- P14.0), indentasi 2 spasi.
227
- - `md` — laporan manusia tersanitasi (judul/evidence bebas sekuens ANSI).
228
- - Ditulis **atomik** (`atomicWriteText`); **menolak menimpa** berkas yang ada
229
- kecuali `--force`; kegagalan tulis = exit `1` tanpa berkas sampah `.tmp.*`.
230
-
231
- ## ⑥ Dedup eksplisit: `openwork merge`
232
-
233
- ```
234
- minicode openwork merge --session target --keep t1 --drop t2 \
235
- --evidence "satu unit kerja yang sama: sama-sama memperbaiki login bug"
236
- ```
237
-
238
- Aturan (dijaga tes + guard):
239
-
240
- 1. **Evidence WAJIB** dan direkam utuh di ledger append-only `task_merges`.
241
- Kemiripan judul TIDAK PERNAH menjadi bukti; `SIMILAR×N(UNPROVEN)` hanyalah
242
- penanda. Tidak ada merge otomatis dari proyeksi.
243
- 2. Duplikat ditutup **`CANCELLED`, bukan `COMPLETED`** — menyatakan "dikerjakan
244
- di task lain" tidak boleh meng-inferr penyelesaian.
245
- 3. Penulisan status lewat `patchTask` (lifecycle biasa: revisi maju, ownership
246
- in-flight dilepas) + INSERT ledger dalam **SATU transaksi** — gagal ledger =
247
- status ikut rollback.
248
- 4. Duplikat terminal ditolak (pekerjaan tertutup tidak dibuka untuk ditutup
249
- lagi). Survivor terminal BOLEH (kasus klasik: pending ternyata sudah
250
- dikerjakan task yang selesai — duplikat tetap CANCELLED).
251
- 5. **Antar-sesi ditolak**: merge hanya satu namespace. Duplikat lintas sesi
252
- harus diadopsi dulu (②), lalu merge di sesi tujuan.
253
- 6. Pembalikan = penulisan lifecycle biasa (patch status kembali). Ledger
254
- append-only tetap mencatat deklarasi — audit sejarah, status = kebenaran.
255
-
256
- ## Peta bukti
257
-
258
- | Klaim | Bukti |
259
- |---|---|
260
- | Proyeksi read-only (nol mutasi) | `test/p14-open-work.test.ts` (proyeksi nol-mutasi) |
261
- | Nol mutasi jalur PENUH (histori + inventaris ikut diuji; tanpa backup manifest korup) | `test/p14-full-scope.test.ts` (zero-mutasi proyeksi penuh) |
262
- | UNKNOWN/stale dilabel jujur | `test/p14-open-work.test.ts` (provenance UNKNOWN tanpa membuat sessions.db; STALE ambang disuntik) |
263
- | Kemiripan bukan identitas | idem (SIMILAR UNPROVEN, ambiguous tetap terpisah) |
264
- | Grup duplikat LINTAS SESI + konflik divergent, tanpa merge otomatis | `test/p14-full-scope.test.ts` (P14.3 grup lintas sesi) |
265
- | Kontrak P14.1: state/prioritas/next action murni + fail-closed | idem (P14.1 kontrak murni) |
266
- | Ekstraksi intent: approval allow ≠ COMPLETED; pesan bebas tak dipindai; cakupan lineage | idem (P14.2 extractIntentCandidates) |
267
- | Klaim plan atas task terminal: tak dihidupkan, konflik diungkap, label claim verified/unverified | idem (P14.2 proyeksi histori) |
268
- | Inventaris P14.0 lintas sumber + sesi dikeluarkan dengan alasan | idem (P14.0 inventaris) |
269
- | Matriks forensik: restart/terputus/pembatalan/stale | idem (P14.6 matriks forensik) |
270
- | Portofolio: blocker/dependensi/verifikasi/next action | idem (P14.4 bidang portofolio) |
271
- | CLI: filter baru, inventory, context, export atomik + sanitasi | idem (CLI full-scope; exit 0/1/2 sesuai I28) |
272
- | Merge aman/auditable/atomic | `test/p14-open-work.test.ts` (DECLARED/refusal/terminal/stale/atomic-rollback/pembalikan) |
273
- | Alur ①→⑤ utuh, generasi baru, tanpa replay | idem (P14.5 alur operator) |
274
- | Adopsi: otoritas ganda, fence, ledger transfer | `test/p14-cross-session-adoption.test.ts` (14 skenario) |
275
- | Guard "bukan TaskStore/scheduler kedua" + proyeksi murni | `test/p2-architecture-guards.test.ts` |
276
- | Kontrak penulis CLI (OAP-008) | `test/writer-inventory.test.ts` (deklarasi per writer) |
277
- | Snapshot `plan.updated` dikolaps per sesi (tanpa duplikasi riwayat) | `test/p14-full-scope.test.ts` (5 tes snapshot plan) |
278
-
279
- ## Batas scope yang TIDAK diklaim
280
-
281
- Dokumen ini sengaja tidak menjanjikan hal-hal berikut; semuanya eksklusi
282
- scope P14 yang disetujui pemilik 2026-10-26, bukan pekerjaan tertunda:
283
-
284
- | Tidak ada | Alasan |
285
- |---|---|
286
- | Ekstraksi intent dari prosa bebas | Dilarang eksplisit oleh roadmap ("jangan anggap setiap pesan brainstorming sebagai tugas") |
287
- | Readout TUI `/openwork` | Teks milestone hanya "tampilkan/ekspor"; permukaan TUI baru butuh kontrak terminal sendiri |
288
- | Merge dengan lease/admission | Di luar teks milestone; merge tetap satu transaksi + ledger audit |
289
- | Merge lintas sesi tanpa adopsi eksplisit | Model otoritas roadmap: portfolio = projection, perubahan task lewat jalur authority |
290
- | Klaim release-ready | Closure P14 hanya untuk kontrak bukti-terstruktur; limitasi P13 tetap berlaku dan tree masih uncommitted |