minicode-ai 0.9.26

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 (162) hide show
  1. package/CHANGELOG.md +935 -0
  2. package/LICENSE +21 -0
  3. package/README.md +200 -0
  4. package/cli/args.ts +195 -0
  5. package/cli/auto-update.ts +108 -0
  6. package/cli/commands/auth.ts +166 -0
  7. package/cli/commands/config.ts +382 -0
  8. package/cli/commands/doctor.ts +128 -0
  9. package/cli/commands/exec.ts +179 -0
  10. package/cli/commands/mcp.ts +35 -0
  11. package/cli/commands/memory.ts +107 -0
  12. package/cli/commands/pricing.ts +100 -0
  13. package/cli/commands/providers.ts +162 -0
  14. package/cli/commands/sessions.ts +128 -0
  15. package/cli/commands/skills.ts +61 -0
  16. package/cli/commands/stats.ts +82 -0
  17. package/cli/commands.ts +317 -0
  18. package/cli/index.ts +539 -0
  19. package/cli/model-manager.ts +112 -0
  20. package/cli/provider-manager.ts +111 -0
  21. package/cli/repl.ts +734 -0
  22. package/cli/router.ts +124 -0
  23. package/cli/setup.ts +780 -0
  24. package/cli/wizard.ts +21 -0
  25. package/docs/ARCHITECTURE.html +1222 -0
  26. package/docs/README.md +109 -0
  27. package/docs/architecture.md +44 -0
  28. package/docs/changelog.md +3 -0
  29. package/package.json +91 -0
  30. package/src/agents/pool.ts +43 -0
  31. package/src/app/mentions.ts +50 -0
  32. package/src/app/provider-layer.ts +118 -0
  33. package/src/app/rag-layer.ts +105 -0
  34. package/src/app/session.ts +154 -0
  35. package/src/app/tool-layer.ts +56 -0
  36. package/src/config.ts +372 -0
  37. package/src/constants.ts +119 -0
  38. package/src/hooks/run.ts +89 -0
  39. package/src/lib/atomic-write.ts +88 -0
  40. package/src/lib/db-path.ts +36 -0
  41. package/src/lib/git-hardening.ts +91 -0
  42. package/src/lib/ignore.ts +58 -0
  43. package/src/lib/keystore.ts +202 -0
  44. package/src/lib/net.ts +70 -0
  45. package/src/lib/safe-open.ts +138 -0
  46. package/src/lib/session-id.ts +23 -0
  47. package/src/lib/trash.ts +38 -0
  48. package/src/lib/trusted-exec.ts +81 -0
  49. package/src/lsp/client.ts +395 -0
  50. package/src/mcp/client.ts +400 -0
  51. package/src/mcp/http-transport.ts +344 -0
  52. package/src/mcp/server.ts +538 -0
  53. package/src/mcp/transport.ts +150 -0
  54. package/src/memory/files.ts +159 -0
  55. package/src/memory/vector.ts +775 -0
  56. package/src/policy/allowlist.ts +67 -0
  57. package/src/policy/bash-guard.ts +465 -0
  58. package/src/policy/compaction.ts +271 -0
  59. package/src/policy/context.ts +161 -0
  60. package/src/policy/executor.ts +199 -0
  61. package/src/policy/jail.ts +127 -0
  62. package/src/policy/permission.ts +517 -0
  63. package/src/policy/pricing.ts +336 -0
  64. package/src/policy/ratelimit.ts +54 -0
  65. package/src/policy/sandbox-policy.ts +157 -0
  66. package/src/policy/scrub.ts +138 -0
  67. package/src/policy/update-check.ts +200 -0
  68. package/src/policy/usage.ts +292 -0
  69. package/src/policy/verifier.ts +181 -0
  70. package/src/providers/anthropic.ts +401 -0
  71. package/src/providers/auth-store.ts +139 -0
  72. package/src/providers/build.ts +136 -0
  73. package/src/providers/detect.ts +126 -0
  74. package/src/providers/effort.ts +165 -0
  75. package/src/providers/guards.ts +107 -0
  76. package/src/providers/oauth.ts +326 -0
  77. package/src/providers/presets.ts +122 -0
  78. package/src/providers/provision.ts +298 -0
  79. package/src/providers/responses.ts +371 -0
  80. package/src/providers/router.ts +247 -0
  81. package/src/repo/repomap.ts +470 -0
  82. package/src/sandbox/docker.ts +129 -0
  83. package/src/sandbox/os.ts +193 -0
  84. package/src/session/checkpoint.ts +543 -0
  85. package/src/session/journal.ts +1347 -0
  86. package/src/session/persistence.ts +446 -0
  87. package/src/session/shadow-git.ts +351 -0
  88. package/src/session/turn-marker.ts +118 -0
  89. package/src/skills/loader.ts +117 -0
  90. package/src/telemetry/trace.ts +283 -0
  91. package/src/tools/ask_user.ts +54 -0
  92. package/src/tools/bash.ts +400 -0
  93. package/src/tools/code_run.ts +96 -0
  94. package/src/tools/delete_file.ts +31 -0
  95. package/src/tools/edit.ts +204 -0
  96. package/src/tools/git.ts +301 -0
  97. package/src/tools/glob.ts +90 -0
  98. package/src/tools/grep.ts +281 -0
  99. package/src/tools/hashline.ts +66 -0
  100. package/src/tools/index.ts +103 -0
  101. package/src/tools/lsp.ts +346 -0
  102. package/src/tools/mcp_call.ts +163 -0
  103. package/src/tools/memory.ts +144 -0
  104. package/src/tools/move_file.ts +47 -0
  105. package/src/tools/patch.ts +86 -0
  106. package/src/tools/read_file.ts +130 -0
  107. package/src/tools/read_image.ts +80 -0
  108. package/src/tools/submit_result.ts +49 -0
  109. package/src/tools/task.ts +346 -0
  110. package/src/tools/todo.ts +201 -0
  111. package/src/tools/web_fetch.ts +161 -0
  112. package/src/tools/web_search.ts +156 -0
  113. package/src/tools/write_file.ts +42 -0
  114. package/src/ui/approval/prompt.ts +76 -0
  115. package/src/ui/assistant/simple.ts +568 -0
  116. package/src/ui/assistant/turn-status.ts +303 -0
  117. package/src/ui/contract.ts +55 -0
  118. package/src/ui/footer.ts +105 -0
  119. package/src/ui/input/input.ts +805 -0
  120. package/src/ui/input/prompt-engine.ts +606 -0
  121. package/src/ui/render/collapse.ts +84 -0
  122. package/src/ui/render/detail.ts +24 -0
  123. package/src/ui/render/diff.ts +181 -0
  124. package/src/ui/render/errors.ts +239 -0
  125. package/src/ui/render/format.ts +54 -0
  126. package/src/ui/render/highlight.ts +294 -0
  127. package/src/ui/render/markdown.ts +120 -0
  128. package/src/ui/render/money.ts +12 -0
  129. package/src/ui/render/reasoning.ts +20 -0
  130. package/src/ui/render/sanitize.ts +80 -0
  131. package/src/ui/render/table.ts +88 -0
  132. package/src/ui/render/theme.ts +339 -0
  133. package/src/ui/render/width.ts +256 -0
  134. package/src/ui/render/wrap.ts +120 -0
  135. package/src/ui/runtime/bus-debug.ts +83 -0
  136. package/src/ui/runtime/chrome.ts +301 -0
  137. package/src/ui/runtime/spinner.ts +77 -0
  138. package/src/ui/runtime/statusline.ts +227 -0
  139. package/src/ui/screens/model-manager.ts +434 -0
  140. package/src/ui/screens/overlay.ts +61 -0
  141. package/src/ui/screens/picker.ts +307 -0
  142. package/src/ui/screens/provider-manager.ts +450 -0
  143. package/src/ui/screens/wizard.ts +132 -0
  144. package/vendor/minicore/VENDOR.md +29 -0
  145. package/vendor/minicore/package.json +21 -0
  146. package/vendor/minicore/src/core/budget.ts +26 -0
  147. package/vendor/minicore/src/core/compact.ts +76 -0
  148. package/vendor/minicore/src/core/errors.ts +60 -0
  149. package/vendor/minicore/src/core/events.ts +74 -0
  150. package/vendor/minicore/src/core/executor.ts +139 -0
  151. package/vendor/minicore/src/core/history.ts +32 -0
  152. package/vendor/minicore/src/core/index.ts +42 -0
  153. package/vendor/minicore/src/core/loop.ts +344 -0
  154. package/vendor/minicore/src/core/permission.ts +24 -0
  155. package/vendor/minicore/src/core/provider.ts +39 -0
  156. package/vendor/minicore/src/core/recovery.ts +34 -0
  157. package/vendor/minicore/src/core/session.ts +327 -0
  158. package/vendor/minicore/src/core/snapshot.ts +142 -0
  159. package/vendor/minicore/src/core/tokens.ts +111 -0
  160. package/vendor/minicore/src/core/tool.ts +118 -0
  161. package/vendor/minicore/src/core/types.ts +50 -0
  162. package/vendor/minicore/src/providers/openai-compat.ts +366 -0
@@ -0,0 +1,1222 @@
1
+ <!DOCTYPE html>
2
+ <html lang="id" data-theme="light">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <meta name="color-scheme" content="light dark">
7
+ <title>Minicode — Peta Struktur untuk Developer</title>
8
+ <!-- Ikon: Material Symbols via CDN Google. Hanya untuk dok statis ini (bukan runtime CLI, jadi tidak melanggar postur zero-dep);
9
+ bila offline, JS menyembunyikan ikon agar tidak tampil teks ligatur mentah. -->
10
+ <link rel="preconnect" href="https://fonts.googleapis.com">
11
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
12
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200">
13
+ <!-- Tipografi: Inter untuk teks (fallback stack sistem bila offline); mono sistem untuk kode/pembeda. -->
14
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap">
15
+ <style>
16
+ /* ── Token ala GitBook: terang lembut + gelap pekat, satu file tanpa dependensi ── */
17
+ :root {
18
+ --bg: #ffffff;
19
+ --bg-subtle: #f7f7f5;
20
+ --sidebar-bg: #fbfbfa;
21
+ --code-bg: #0d1117;
22
+ --code-fg: #e6edf3;
23
+ --ink: #1d1d1f;
24
+ --mut: #5f6368;
25
+ --faint: #8a8f98;
26
+ --line: #e8e8e6;
27
+ --line-soft: #f0f0ee;
28
+ --acc: #346ddb;
29
+ --acc-ink: #2549a8;
30
+ --acc-soft: #edf2fd;
31
+ --ok: #1a7f4b;
32
+ --ok-soft: #e9f6ee;
33
+ --warn: #9a5b00;
34
+ --warn-soft: #fdf3e3;
35
+ --err: #c0362c;
36
+ --err-soft: #fdecea;
37
+ --pur: #6a4fd0;
38
+ --pur-soft: #efecfc;
39
+ --card-shadow: none;
40
+ --radius: 8px;
41
+ --mono: ui-monospace, "SF Mono", "Cascadia Code", Consolas, "JetBrains Mono", monospace;
42
+ --sans: "Inter", ui-sans-serif, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
43
+ --topbar-h: 60px;
44
+ --side-w: 284px;
45
+ --toc-w: 232px;
46
+ }
47
+ html[data-theme="dark"] {
48
+ --bg: #1b1b1d;
49
+ --bg-subtle: #131315;
50
+ --sidebar-bg: #161618;
51
+ --code-bg: #0d1117;
52
+ --code-fg: #e6edf3;
53
+ --ink: #ececee;
54
+ --mut: #a7abb3;
55
+ --faint: #7c818a;
56
+ --line: #2b2b2e;
57
+ --line-soft: #232326;
58
+ --acc: #6b9bff;
59
+ --acc-ink: #a9c4ff;
60
+ --acc-soft: #22304f;
61
+ --ok: #4cc38a;
62
+ --ok-soft: #16382a;
63
+ --warn: #e8a13d;
64
+ --warn-soft: #3d2c14;
65
+ --err: #f26d5f;
66
+ --err-soft: #42201c;
67
+ --pur: #a893ff;
68
+ --pur-soft: #2c2650;
69
+ --card-shadow: none;
70
+ }
71
+ * { box-sizing: border-box; margin: 0; padding: 0; }
72
+ html { scroll-behavior: smooth; }
73
+ body {
74
+ background: var(--bg); color: var(--ink);
75
+ font: 15px/1.7 var(--sans);
76
+ -webkit-font-smoothing: antialiased;
77
+ }
78
+ ::selection { background: rgba(52, 109, 219, 0.22); }
79
+ code, .mono { font-family: var(--mono); }
80
+ code {
81
+ background: var(--bg-subtle); color: var(--ink);
82
+ padding: 0.08em 0.34em; border-radius: 6px; font-size: 0.83em; overflow-wrap: anywhere;
83
+ }
84
+ pre code { background: none; border: 0; padding: 0; color: inherit; }
85
+ a { color: var(--acc); text-decoration: none; }
86
+ a:hover { text-decoration: underline; text-underline-offset: 2px; }
87
+ :focus-visible { outline: 2px solid var(--acc); outline-offset: 2px; border-radius: 4px; }
88
+ .skip {
89
+ position: absolute; left: -9999px; top: 0; z-index: 200;
90
+ background: var(--acc); color: #fff; padding: 8px 14px; border-radius: 0 0 8px 0;
91
+ }
92
+ .skip:focus { left: 0; color: #fff; }
93
+
94
+ /* ── Ikon Material Symbols: ligatur font, bukan emoji (konsisten di semua OS) ── */
95
+ .mi {
96
+ font-family: "Material Symbols Outlined";
97
+ font-weight: normal; font-style: normal; line-height: 1;
98
+ letter-spacing: normal; text-transform: none; white-space: nowrap;
99
+ direction: ltr; -webkit-font-smoothing: antialiased;
100
+ display: inline-block; font-size: 18px; vertical-align: -3px; user-select: none;
101
+ font-variation-settings: "FILL" 0, "wght" 400, "GRAD" 0, "opsz" 24;
102
+ }
103
+ /* Sembunyikan ikon bila font gagal dimuat (offline) — semuanya dekoratif. */
104
+ body.no-mi .mi { display: none; }
105
+ .mark .mi { font-size: 19px; vertical-align: 0; }
106
+ .hint .ico .mi { font-size: 20px; }
107
+ .search-pill .mi, .side-search .mag .mi { font-size: 17px; vertical-align: 0; }
108
+ .snav .mi { font-size: 15px; }
109
+ .codehead button { display: inline-flex; align-items: center; gap: 6px; }
110
+ .codehead .mi { font-size: 14px; vertical-align: 0; }
111
+
112
+ /* ── Scrollbar minimalis: tipis, tanpa trek, hanya jempol samar ── */
113
+ * { scrollbar-width: thin; scrollbar-color: var(--line) transparent; }
114
+ *::-webkit-scrollbar { width: 8px; height: 8px; }
115
+ *::-webkit-scrollbar-track { background: transparent; }
116
+ *::-webkit-scrollbar-thumb { background: var(--line); border-radius: 8px; }
117
+ *::-webkit-scrollbar-thumb:hover { background: var(--faint); }
118
+
119
+ /* ══ Topbar ala GitBook ══ */
120
+ .topbar {
121
+ position: sticky; top: 0; z-index: 100;
122
+ height: var(--topbar-h);
123
+ display: flex; align-items: center; gap: 12px;
124
+ padding: 0 20px;
125
+ background: var(--bg);
126
+ }
127
+ .burger {
128
+ display: none; background: var(--bg-subtle);
129
+ color: var(--mut); border-radius: 8px; padding: 6px 10px; cursor: pointer; font-size: 15px;
130
+ }
131
+ .brand { display: flex; align-items: center; gap: 10px; min-width: 0; }
132
+ .mark {
133
+ width: 30px; height: 30px; border-radius: 8px; flex: 0 0 auto;
134
+ background: var(--ink);
135
+ color: var(--bg); font-weight: 800; font-size: 17px;
136
+ display: flex; align-items: center; justify-content: center;
137
+ }
138
+ .brand .name { font-size: 15px; font-weight: 750; letter-spacing: -0.2px; white-space: nowrap; }
139
+ .brand .name b { color: var(--acc); font-weight: 800; }
140
+ .tag-docs { font-size: 11px; font-weight: 600; color: var(--faint); white-space: nowrap; }
141
+ .search-pill {
142
+ flex: 1; max-width: 460px; margin: 0 auto;
143
+ display: flex; align-items: center; gap: 8px;
144
+ border-radius: 9px;
145
+ background: var(--bg-subtle); color: var(--faint);
146
+ padding: 7px 12px; font-size: 13px; cursor: text;
147
+ }
148
+ .search-pill:hover { background: var(--line-soft); }
149
+ .search-pill kbd { margin-left: auto; font-family: var(--mono); font-size: 11px; color: var(--faint); }
150
+ .top-actions { display: flex; align-items: center; gap: 8px; margin-left: auto; }
151
+ .vpill { font-size: 11.5px; font-family: var(--mono); color: var(--faint); white-space: nowrap; }
152
+ .iconbtn {
153
+ background: var(--bg-subtle); color: var(--mut);
154
+ border-radius: 8px; padding: 6px 10px; cursor: pointer; font-size: 14px; line-height: 1;
155
+ }
156
+ .iconbtn:hover { color: var(--acc); }
157
+
158
+ /* ══ Kerangka 3 kolom ══ */
159
+ .shell {
160
+ display: grid;
161
+ grid-template-columns: var(--side-w) minmax(0, 1fr) var(--toc-w);
162
+ align-items: start;
163
+ max-width: 1480px; margin: 0 auto;
164
+ }
165
+
166
+ /* ── Sidebar kiri ── */
167
+ .sidebar {
168
+ position: sticky; top: var(--topbar-h);
169
+ height: calc(100vh - var(--topbar-h));
170
+ overflow-y: auto; overscroll-behavior: contain;
171
+ background: var(--sidebar-bg);
172
+ padding: 18px 14px 60px;
173
+ }
174
+ .side-search { position: relative; margin: 2px 2px 12px; }
175
+ .side-search input {
176
+ width: 100%; border-radius: 8px;
177
+ background: var(--bg); color: var(--ink);
178
+ padding: 8px 12px 8px 32px; font-size: 13px; font-family: var(--sans);
179
+ }
180
+ .side-search input::placeholder { color: var(--faint); }
181
+ .side-search input:focus { outline: 2px solid var(--acc); outline-offset: -1px; }
182
+ .side-search .mag { position: absolute; left: 11px; top: 8px; color: var(--faint); font-size: 14px; }
183
+ .side-group { margin-bottom: 6px; }
184
+ .side-group > summary {
185
+ list-style: none; cursor: pointer; user-select: none;
186
+ font-size: 11px; font-weight: 750; letter-spacing: 0.9px; text-transform: uppercase;
187
+ color: var(--faint); padding: 14px 10px 6px;
188
+ display: flex; align-items: center; gap: 6px;
189
+ }
190
+ .side-group > summary::-webkit-details-marker { display: none; }
191
+ .side-group > summary::after { content: ""; width: 6px; height: 6px; margin-left: auto; border-right: 1.5px solid var(--faint); border-bottom: 1.5px solid var(--faint); transform: rotate(45deg); flex: 0 0 auto; align-self: center; }
192
+ .side-group:not([open]) > summary::after { transform: rotate(-45deg); }
193
+ .snav { display: block; padding: 5px 10px; margin: 1px 0; font-size: 13.5px; color: var(--mut); border-radius: 7px; }
194
+ .snav:hover { background: var(--line-soft); color: var(--ink); text-decoration: none; }
195
+ .snav.active { background: var(--acc-soft); color: var(--acc-ink); font-weight: 650; }
196
+ html[data-theme="light"] .snav.active { color: var(--acc); }
197
+ .snav.sub { padding-left: 28px; font-size: 12.5px; position: relative; }
198
+ .snav.sub::before { content: "·"; position: absolute; left: 16px; color: var(--acc); font-weight: 700; }
199
+ .snav .cnt { float: right; font-size: 10.5px; font-family: var(--mono); color: var(--faint); }
200
+ .snav.frozen { color: var(--pur); }
201
+ .snav[hidden] { display: none; }
202
+ .side-foot { margin: 16px 10px 0; font-size: 12px; color: var(--faint); }
203
+ .side-foot b { color: var(--mut); }
204
+
205
+ /* ── Konten tengah ── */
206
+ .content { padding: 40px 48px 80px; min-width: 0; }
207
+ .content-inner { max-width: 800px; margin: 0 auto; }
208
+ .crumb { font-size: 12.5px; color: var(--faint); margin-bottom: 10px; display: flex; align-items: center; gap: 8px; }
209
+ .crumb b { color: var(--ink); font-weight: 650; }
210
+ .crumb .sep { opacity: 0.5; }
211
+ h1 { font-size: 30px; line-height: 1.2; font-weight: 700; letter-spacing: -0.02em; text-wrap: balance; margin: 2px 0 10px; }
212
+ .lede { color: var(--mut); margin: 8px 0 18px; font-size: 15.5px; }
213
+ section { margin-bottom: 12px; scroll-margin-top: calc(var(--topbar-h) + 18px); }
214
+ h2.sec {
215
+ font-size: 21px; font-weight: 700; letter-spacing: -0.01em;
216
+ display: flex; align-items: baseline; gap: 10px;
217
+ margin: 54px 0 8px;
218
+ }
219
+ h2.sec .hn { font-size: 11.5px; font-weight: 700; color: var(--faint); letter-spacing: 1.2px; font-family: var(--mono); }
220
+ h2.sec .anchor { opacity: 0; font-size: 15px; margin-left: 2px; }
221
+ h2.sec:hover .anchor { opacity: 1; }
222
+ h3.hsub { font-size: 16px; font-weight: 700; margin: 28px 0 8px; scroll-margin-top: calc(var(--topbar-h) + 18px); }
223
+ .meta { display: flex; flex-wrap: wrap; gap: 8px; margin: 4px 0 22px; }
224
+ .pill {
225
+ font-size: 12px; color: var(--mut);
226
+ display: inline-flex; align-items: center; gap: 6px;
227
+ }
228
+ .meta .pill + .pill::before { content: "·"; color: var(--faint); }
229
+ .pill.blue, .pill.green { color: var(--mut); }
230
+ .pill .dot { width: 6px; height: 6px; border-radius: 50%; background: var(--faint); }
231
+
232
+ /* ── Hint/callout ala GitBook ── */
233
+ .hint {
234
+ display: flex; gap: 12px; padding: 12px 16px; margin: 14px 0;
235
+ border-radius: var(--radius);
236
+ background: var(--bg-subtle); font-size: 13.5px; color: var(--mut);
237
+ }
238
+ .hint .ico { flex: 0 0 auto; font-size: 16px; line-height: 1.5; }
239
+ .hint b, .hint strong { color: var(--ink); }
240
+ .hint .ico { color: var(--faint); }
241
+ .hint-info { background: var(--acc-soft); }
242
+ .hint-warn { background: var(--warn-soft); }
243
+ .hint-danger { background: var(--err-soft); }
244
+ .hint-ok { background: var(--ok-soft); }
245
+ .hint-purple { background: var(--pur-soft); }
246
+ .hint .body { min-width: 0; }
247
+ .hint .title { display: block; font-weight: 700; color: var(--ink); font-size: 13.5px; margin-bottom: 2px; }
248
+
249
+ /* ── Kartu lapisan ── */
250
+ .card-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 12px; margin: 16px 0 8px; }
251
+ .card {
252
+ border-radius: var(--radius);
253
+ background: var(--bg-subtle); padding: 16px;
254
+ }
255
+ .card .k { font-size: 11px; font-weight: 800; font-family: var(--mono); letter-spacing: 0.6px; }
256
+ .card h3 { font-size: 15px; margin: 4px 0; }
257
+ .card p { font-size: 13px; color: var(--mut); }
258
+ .card code { font-size: 11.5px; }
259
+ .k1, .k2, .k3 { color: var(--faint); }
260
+ .layer-stack { margin: 14px 0; display: grid; gap: 10px; }
261
+ .layer { display: grid; grid-template-columns: 52px 1fr; gap: 2px 16px; padding: 18px 20px; background: var(--bg-subtle); border-radius: var(--radius); }
262
+ .layer .lnum { font-size: 20px; font-weight: 800; color: var(--faint); font-variant-numeric: tabular-nums; }
263
+ .layer .ltitle { font-weight: 700; font-size: 15px; display: flex; gap: 10px; align-items: center; flex-wrap: wrap; }
264
+ .layer .lpath { font-size: 12px; color: var(--faint); font-family: var(--mono); }
265
+ .layer .ldesc { grid-column: 2; font-size: 13.5px; color: var(--mut); }
266
+ .chip { font-size: 10.5px; font-weight: 700; font-family: var(--mono); color: var(--faint); }
267
+ .chip.c1, .chip.c2, .chip.c3, .chip.cx { color: var(--faint); }
268
+ .flow-note { text-align: center; font-size: 11.5px; color: var(--faint); padding: 2px; }
269
+
270
+ /* ── Tabel ala GitBook ── */
271
+ .tscroll { overflow-x: auto; margin: 12px 0; }
272
+ table { width: 100%; border-collapse: separate; border-spacing: 0; font-size: 13.5px; }
273
+ .tscroll table { min-width: 640px; }
274
+ th, td { text-align: left; padding: 9px 14px; vertical-align: top; }
275
+ thead th, tr:first-child th {
276
+ background: none; color: var(--ink);
277
+ font-weight: 650; font-size: 13px;
278
+ white-space: nowrap;
279
+ }
280
+ /* Zebra flat + hover tint sebagai pengganti garis sel */
281
+ tbody tr:nth-child(even) td { background: var(--bg-subtle); }
282
+ tbody tr:nth-child(even) td:first-child { border-radius: 8px 0 0 8px; }
283
+ tbody tr:nth-child(even) td:last-child { border-radius: 0 8px 8px 0; }
284
+ tbody tr:hover td { background: var(--acc-soft); }
285
+ tbody tr:hover td:first-child { border-radius: 8px 0 0 8px; }
286
+ tbody tr:hover td:last-child { border-radius: 0 8px 8px 0; }
287
+ table.matrix td { text-align: center; }
288
+ table.matrix td:first-child, table.matrix th:first-child { text-align: left; }
289
+ .ok { color: var(--ok); font-weight: 650; }
290
+ .no { color: var(--err); font-weight: 650; }
291
+ .na { color: var(--faint); }
292
+ td small { color: var(--faint); display: block; }
293
+
294
+ /* ── Kerapian teks: cegah baris yatim, angka tabel rata kolom ── */
295
+ .lede, .step .what, .mod .fdesc, .uxcard p, ul.plain li, .hint .body { text-wrap: pretty; }
296
+ h3.hsub { text-wrap: balance; }
297
+ table { font-variant-numeric: tabular-nums; }
298
+ ul.plain { list-style: none; margin: 10px 0; }
299
+ ul.plain li { position: relative; padding: 0 0 10px 22px; font-size: 13.5px; color: var(--mut); }
300
+ ul.plain li::before { content: "›"; position: absolute; left: 6px; color: var(--acc); font-weight: 800; }
301
+ ul.plain li b { color: var(--ink); }
302
+
303
+ /* ── Steps ── */
304
+ .steps { margin: 14px 0; display: grid; gap: 10px; }
305
+ .step { display: flex; gap: 14px; padding: 16px 18px; background: var(--bg-subtle); border-radius: var(--radius); }
306
+ .step .dot {
307
+ flex: 0 0 28px; color: var(--faint); font-size: 13px; font-weight: 700;
308
+ display: flex; align-items: flex-start; justify-content: center; padding-top: 2px;
309
+ }
310
+ .step .card-b b { font-size: 14.5px; }
311
+ .step .where { font-size: 12px; color: var(--faint); font-family: var(--mono); display: block; margin-top: 2px; overflow-wrap: anywhere; }
312
+ .step .what { font-size: 13.5px; color: var(--mut); margin-top: 3px; }
313
+
314
+ /* ── Kelompok modul ── */
315
+ .toolbar { display: flex; gap: 8px; margin: 16px 0; }
316
+ .toolbar button {
317
+ background: var(--bg-subtle); color: var(--mut); border-radius: 8px;
318
+ padding: 7px 14px; font-size: 12.5px; font-weight: 600; cursor: pointer;
319
+ }
320
+ .toolbar button:hover { color: var(--acc); }
321
+ details.group {
322
+ margin: 0 0 10px; border-radius: var(--radius);
323
+ background: var(--bg-subtle);
324
+ scroll-margin-top: calc(var(--topbar-h) + 18px); overflow: hidden;
325
+ }
326
+ details.group.flash { background: var(--acc-soft); }
327
+ details.group[hidden] { display: none; }
328
+ details.group summary {
329
+ cursor: pointer; list-style: none; padding: 14px 16px; user-select: none;
330
+ display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap;
331
+ font-size: 14.5px; font-weight: 700;
332
+ }
333
+ details.group summary::-webkit-details-marker { display: none; }
334
+ details.group summary::after { content: ""; width: 7px; height: 7px; margin-left: auto; border-right: 1.5px solid var(--faint); border-bottom: 1.5px solid var(--faint); transform: rotate(45deg); flex: 0 0 auto; align-self: center; }
335
+ details.group[open] summary::after { transform: rotate(225deg); }
336
+ details.group summary .role { color: var(--faint); font-size: 12px; font-weight: 400; }
337
+ details.group summary .cnt { font-size: 11px; font-family: var(--mono); color: var(--faint); }
338
+ .mods { padding: 4px 18px 10px; }
339
+ .mod { padding: 16px 0; }
340
+ .mod + .mod { margin-top: 4px; }
341
+ .mod[hidden] { display: none; }
342
+ .mod .fname { font-size: 13px; font-weight: 700; font-family: var(--mono); color: var(--ink); overflow-wrap: anywhere; }
343
+ .mod .fdesc { font-size: 13.5px; color: var(--mut); margin-top: 3px; }
344
+ .mod .exports { font-size: 12px; color: var(--mut); margin-top: 6px; font-family: var(--mono); overflow-wrap: anywhere; }
345
+ .mod .exports::before { content: "⇢ "; font-weight: 700; }
346
+
347
+ /* ── Resep ── */
348
+ .recipes { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin: 14px 0; }
349
+ .recipe { border-radius: var(--radius); padding: 18px; background: var(--bg-subtle); }
350
+ .recipe h3 { font-size: 14.5px; margin-bottom: 8px; display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
351
+ .recipe ol { margin: 0 0 0 20px; font-size: 13.5px; color: var(--mut); }
352
+ .recipe ol li { margin-bottom: 5px; }
353
+ .recipe .guard { margin-top: 10px; font-size: 12.5px; color: var(--mut); background: var(--warn-soft); border-radius: 7px; padding: 8px 12px; }
354
+
355
+ /* ── Blok kode ala GitBook ── */
356
+ .codeblock { margin: 12px 0; border-radius: var(--radius); overflow: hidden; }
357
+ .codehead {
358
+ display: flex; align-items: center; gap: 8px;
359
+ background: var(--code-bg); color: #8b949e; font-size: 11.5px; font-family: var(--mono);
360
+ padding: 12px 16px 0;
361
+ }
362
+ .codehead .fname { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
363
+ .codehead button {
364
+ margin-left: auto; background: none; border: 0; color: var(--faint);
365
+ border-radius: 6px; font-size: 11px; padding: 3px 6px; cursor: pointer; font-family: var(--mono);
366
+ }
367
+ .codehead button:hover { color: var(--acc); }
368
+ pre.kod {
369
+ background: var(--code-bg); color: var(--code-fg);
370
+ padding: 16px; overflow-x: auto; font-family: var(--mono);
371
+ font-size: 12.5px; line-height: 1.7; margin: 0;
372
+ }
373
+ pre.kod .cm { color: #7d8590; }
374
+
375
+ /* ── Rantai keamanan ── */
376
+ .chain { display: grid; grid-template-columns: repeat(5, 1fr); gap: 10px; margin: 14px 0; }
377
+ .chain .link { border-radius: var(--radius); padding: 14px; background: var(--bg-subtle); font-size: 12.5px; color: var(--mut); }
378
+ .chain .link b { display: block; font-size: 13.5px; color: var(--ink); margin-bottom: 4px; }
379
+ .chain .link .mono { display: block; margin-top: 8px; font-size: 11px; color: var(--faint); font-family: var(--mono); overflow-wrap: anywhere; }
380
+ .chain .link .gnum {
381
+ display: block; color: var(--faint); font-weight: 700; font-size: 11px; font-family: var(--mono);
382
+ margin-bottom: 6px;
383
+ }
384
+
385
+ /* ── §09 ── */
386
+ .uxgrid { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 12px; margin: 12px 0; }
387
+ .uxcard { border-radius: var(--radius); padding: 14px 16px; background: var(--bg-subtle); }
388
+ .uxcard h4 { font-size: 11px; font-weight: 800; text-transform: uppercase; letter-spacing: 0.8px; color: var(--faint); margin-bottom: 6px; }
389
+ .uxcard p { margin: 0; font-size: 13px; color: var(--mut); }
390
+ .uxcard code { font-size: 11.5px; }
391
+
392
+ /* ── TOC kanan ── */
393
+ .toc { position: sticky; top: var(--topbar-h); height: calc(100vh - var(--topbar-h)); overflow-y: auto; padding: 28px 20px 60px 8px; font-size: 12.5px; }
394
+ .toc .tlabel { font-size: 11px; font-weight: 800; letter-spacing: 0.9px; text-transform: uppercase; color: var(--faint); margin-bottom: 8px; }
395
+ .toc a { display: block; padding: 4px 10px; color: var(--mut); border-radius: 6px; }
396
+ .toc a:hover { color: var(--ink); text-decoration: none; background: var(--bg-subtle); }
397
+ .toc a.active { color: var(--acc-ink); background: var(--acc-soft); font-weight: 650; }
398
+ html[data-theme="light"] .toc a.active { color: var(--acc); }
399
+ .toc a.sub { padding-left: 24px; font-size: 12px; }
400
+
401
+ /* ── Navigasi bawah ala GitBook ── */
402
+ .pagenav { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 48px; }
403
+ .pagenav a { border-radius: var(--radius); padding: 14px 16px; background: var(--bg-subtle); color: var(--mut); }
404
+ .pagenav a:hover { text-decoration: none; }
405
+ .pagenav a:hover b { color: var(--acc); }
406
+ .pagenav a span { display: block; font-size: 11px; text-transform: uppercase; letter-spacing: 0.7px; color: var(--faint); font-weight: 700; }
407
+ .pagenav a b { color: var(--ink); font-size: 14px; }
408
+ .pagenav a.next { text-align: right; }
409
+ footer.site { margin-top: 32px; padding-top: 16px; color: var(--faint); font-size: 12.5px; display: flex; gap: 12px; flex-wrap: wrap; align-items: center; }
410
+ footer.site .spacer { flex: 1; }
411
+
412
+ .backdrop { display: none; }
413
+ .empty-note { display: none; border-radius: var(--radius); background: var(--bg-subtle); padding: 18px; color: var(--faint); font-size: 13px; margin: 12px 0; text-align: center; }
414
+ .empty-note.show { display: block; }
415
+
416
+ /* ── Responsif ── */
417
+ @media (max-width: 1220px) {
418
+ .shell { grid-template-columns: var(--side-w) minmax(0, 1fr); }
419
+ .toc { display: none; }
420
+ .chain { grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); }
421
+ }
422
+ @media (max-width: 900px) {
423
+ .shell { grid-template-columns: minmax(0, 1fr); }
424
+ .burger { display: inline-block; }
425
+ .search-pill { display: none; }
426
+ .sidebar {
427
+ position: fixed; top: var(--topbar-h); bottom: 0; left: 0; width: min(320px, 88vw);
428
+ height: calc(100vh - var(--topbar-h)); z-index: 120;
429
+ transform: translateX(-105%); transition: transform 0.2s ease;
430
+ box-shadow: 8px 0 24px rgba(0, 0, 0, 0.12);
431
+ }
432
+ body.nav-open .sidebar { transform: none; }
433
+ body.nav-open .backdrop { display: block; position: fixed; inset: var(--topbar-h) 0 0 0; background: rgba(0, 0, 0, 0.35); z-index: 110; }
434
+ .content { padding: 26px 20px 70px; }
435
+ h1 { font-size: 26px; }
436
+ .card-grid, .recipes, .pagenav { grid-template-columns: 1fr; }
437
+ .layer { grid-template-columns: 1fr; }
438
+ .layer .lnum { display: none; }
439
+ .layer .ldesc { grid-column: 1; }
440
+ .vpill.hide-m { display: none; }
441
+ }
442
+ @media print {
443
+ .topbar, .sidebar, .toc, .toolbar, .skip, .backdrop, .pagenav, .search-pill { display: none !important; }
444
+ .shell { display: block; }
445
+ .content { padding: 0; }
446
+ body { color: #111; }
447
+ pre.kod { background: #f4f4f5; color: #111; }
448
+ details.group { break-inside: avoid; }
449
+ }
450
+ </style>
451
+ </head>
452
+ <body>
453
+ <a class="skip" href="#sekilas">Langsung ke konten</a>
454
+
455
+ <!-- ══ Topbar ══ -->
456
+ <header class="topbar">
457
+ <button class="burger" id="burger" aria-label="Buka navigasi"><span class="mi">menu</span></button>
458
+ <div class="brand">
459
+ <span class="mark"><span class="mi">terminal</span></span>
460
+ <span class="name">mini<b>code</b></span>
461
+ <span class="tag-docs">docs</span>
462
+ </div>
463
+ <div class="search-pill" id="searchPill" role="button" tabindex="0" aria-label="Cari di halaman ini">
464
+ <span class="mi">search</span><span>Cari modul, simbol, env…</span><kbd>Ctrl K</kbd>
465
+ </div>
466
+ <div class="top-actions">
467
+ <span class="vpill hide-m">v0.9.24 · Bun-only · 0 deps</span>
468
+ <button class="iconbtn" id="themeBtn" aria-label="Ganti tema terang/gelap" title="Ganti tema"><span class="mi">dark_mode</span></button>
469
+ </div>
470
+ </header>
471
+
472
+ <div class="shell">
473
+ <!-- ══════════ SIDEBAR KIRI ══════════ -->
474
+ <aside class="sidebar" id="sidebar" aria-label="Navigasi dokumen">
475
+ <div class="side-search">
476
+ <span class="mag"><span class="mi">search</span></span>
477
+ <input id="filter" type="search" placeholder="Saring modul / simbol…" aria-label="Saring modul dan navigasi">
478
+ </div>
479
+
480
+ <details class="side-group" open>
481
+ <summary>Memulai</summary>
482
+ <a class="snav" href="#sekilas">Sekilas — satu diagram</a>
483
+ <a class="snav" href="#batas">Lapisan &amp; batas impor</a>
484
+ <a class="snav" href="#alur">Alur satu prompt</a>
485
+ </details>
486
+
487
+ <details class="side-group" open>
488
+ <summary>Referensi modul</summary>
489
+ <a class="snav" href="#pohon">Modul &amp; ekspor kunci</a>
490
+ <a class="snav sub" href="#g-cli">cli/ <span class="cnt">L1</span></a>
491
+ <a class="snav sub" href="#g-app">src/app/</a>
492
+ <a class="snav sub" href="#g-policy">src/policy/</a>
493
+ <a class="snav sub" href="#g-tools">src/tools/ <span class="cnt">37</span></a>
494
+ <a class="snav sub" href="#g-providers">src/providers/</a>
495
+ <a class="snav sub" href="#g-session">src/session/</a>
496
+ <a class="snav sub" href="#g-ui">src/ui/ <span class="cnt">L1</span></a>
497
+ <a class="snav sub" href="#g-lain">src/ lainnya</a>
498
+ <a class="snav sub" href="#g-kernel">vendor/minicore/ <span class="cnt">L3</span></a>
499
+ <a class="snav sub" href="#g-quality">test · scripts · bench</a>
500
+ </details>
501
+
502
+ <details class="side-group" open>
503
+ <summary>Panduan</summary>
504
+ <a class="snav" href="#resep">Resep ekstensi</a>
505
+ <a class="snav" href="#keamanan">Rantai keamanan</a>
506
+ <a class="snav" href="#env">Env &amp; perintah</a>
507
+ <a class="snav" href="#persistensi">Data persisten</a>
508
+ <a class="snav" href="#invarian">Invarian struktural</a>
509
+ <a class="snav" href="#ux">UI/UX — kontrak terminal</a>
510
+ </details>
511
+
512
+ <details class="side-group" open>
513
+ <summary>Dokumentasi</summary>
514
+ <a class="snav frozen" href="TERMINAL_CONTRACT.md">TERMINAL_CONTRACT — frozen <span class="mi">ac_unit</span></a>
515
+ <a class="snav" href="USAGE.md">USAGE — panduan pengguna</a>
516
+ <a class="snav" href="HARNESS.md">HARNESS — jaminan kualitas</a>
517
+ <a class="snav" href="../CHANGELOG.md">CHANGELOG — riwayat</a>
518
+ <a class="snav" href="../PLAN.md">PLAN — rencana aktif</a>
519
+ </details>
520
+
521
+ <div class="side-foot">
522
+ <b>Aturan repo:</b> setiap perubahan struktur wajib memperbarui file ini
523
+ (lihat AGENTS.md). Jangan biarkan peta ini usang.
524
+ </div>
525
+ </aside>
526
+ <div class="backdrop" id="backdrop"></div>
527
+
528
+ <!-- ══════════ KONTEN ══════════ -->
529
+ <main class="content">
530
+ <div class="content-inner">
531
+
532
+ <!-- ── 0 · SEKILAS ── -->
533
+ <section id="sekilas">
534
+ <p class="crumb">minicode <span class="sep">/</span> architecture <span class="sep">/</span> <b>peta struktur</b></p>
535
+ <h1>Satu diagram untuk memahami seluruh minicode</h1>
536
+ <p class="lede">
537
+ Jalur utama mengalir atas → bawah: prompt masuk, melewati tiga lapisan, loop
538
+ model ↔ tool berputar, hasil keluar sebagai tampilan + data tersimpan. Jalur
539
+ samping menunjukkan jalan keluar/masuk alternatif: subcommand admin dan mode
540
+ MCP server. Detailnya bisa dilompat langsung: ekspor per modul (§3), resep
541
+ menambah kode (§4), env &amp; perintah (§6).
542
+ </p>
543
+ <div class="meta">
544
+ <span class="pill blue"><span class="dot"></span>entry: cli/index.ts</span>
545
+ <span class="pill green"><span class="dot"></span>37 tool bawaan</span>
546
+ <span class="pill">kernel 05fc595a · lihat vendor/minicore/VENDOR.md</span>
547
+ </div>
548
+
549
+ <div class="card-grid">
550
+ <div class="card"><div class="k k1">L1 · ANTARMUKA</div><h3>CLI &amp; UI</h3><p>Terminal, REPL, picker, wizard, tema, rendering.</p><p><code>cli/ · src/ui/</code></p></div>
551
+ <div class="card"><div class="k k2">L2 · LOGIKA AGEN</div><h3>Agen Minicode</h3><p>Sesi, izin, tool, provider, MCP/LSP, memory.</p><p><code>src/ (non-ui)</code></p></div>
552
+ <div class="card"><div class="k k3">L3 · KERNEL BEKU</div><h3>MiniCore</h3><p>Loop agen inti. Hanya seam aditif.</p><p><code>vendor/minicore/</code></p></div>
553
+ </div>
554
+
555
+ <div class="hint hint-info"><span class="ico"><span class="mi">info</span></span><div class="body"><span class="title">Cara membaca halaman ini</span>Mulai dari <a href="#batas">§1 lapisan</a> untuk batas impor, lalu <a href="#alur">§2 alur prompt</a> untuk file per tahap. Butuh simbol spesifik? Ketik di pencarian atas (Ctrl+K) — filter mencari sampai ke nama ekspor.</div></div>
556
+ </section>
557
+
558
+ <!-- ── 1 · LAPISAN & BATAS IMPOR ── -->
559
+ <section id="batas">
560
+ <h2 class="sec"><span class="hn">01</span> Lapisan &amp; batas impor <a class="anchor" href="#batas">#</a></h2>
561
+ <p class="lede">Tiga lapisan logis, satu matriks ketergantungan. Semua sel “DILARANG” dijaga otomatis oleh <code>test/ui-boundary.test.ts</code> yang jalan di <code>bun test</code> — melanggar = CI merah, bukan sekadar gaya.</p>
562
+
563
+ <div class="layer-stack">
564
+ <div class="layer">
565
+ <div class="lnum">1</div>
566
+ <div><div class="ltitle">CLI &amp; UI <span class="chip c1">L1</span></div>
567
+ <div class="lpath">cli/ · src/ui/</div></div>
568
+ <div class="ldesc">Semua yang menyentuh terminal: argv, REPL, picker, wizard, tema, rendering. Layar interaktif = view murni (props data + callback) di <code>src/ui/screens/</code>, controller tipis di <code>cli/</code>.</div>
569
+ </div>
570
+ <div class="flow-note">▼ memakai</div>
571
+ <div class="layer">
572
+ <div class="lnum">2</div>
573
+ <div><div class="ltitle">Agen Minicode <span class="chip c2">L2</span></div>
574
+ <div class="lpath">src/ (non-ui)</div></div>
575
+ <div class="ldesc">Perakit sesi (app/), keamanan &amp; izin (policy/), 37 tool, provider, MCP/LSP, hooks, memory, skills, persistensi sesi.</div>
576
+ </div>
577
+ <div class="flow-note">▼ lewat <code>#minicore</code></div>
578
+ <div class="layer">
579
+ <div class="lnum">3</div>
580
+ <div><div class="ltitle">Kernel MiniCore <span class="chip c3">L3</span></div>
581
+ <div class="lpath">vendor/minicore/ · pin 05fc595a</div></div>
582
+ <div class="ldesc">Loop agen inti. Beku: hanya seam aditif yang boleh diubah (<code>compactAsync</code>, <code>initialMessages</code>, <code>cwd</code>); sinkron via <code>bun run vendor:minicore</code>, cek via <code>bun run vendor:check</code>.</div>
583
+ </div>
584
+ </div>
585
+
586
+ <div class="tscroll">
587
+ <table class="matrix">
588
+ <tr><th>pengimpor ↓ · mengimpor →</th><th><code>cli/</code></th><th><code>src/</code> non-ui</th><th><code>src/ui/</code></th><th><code>#minicore</code></th></tr>
589
+ <tr><td><b><code>cli/</code></b> <span class="chip c1">L1</span></td><td class="na">—</td><td class="ok">boleh</td><td class="ok">boleh</td><td class="ok">hanya tipe<small>cli/setup.ts</small></td></tr>
590
+ <tr><td><b><code>src/</code> non-ui</b> <span class="chip c2">L2</span></td><td class="no">DILARANG</td><td class="ok">boleh</td><td class="no">DILARANG</td><td class="ok">boleh</td></tr>
591
+ <tr><td><b><code>src/ui/</code></b> <span class="chip c1">L1</span></td><td class="no">DILARANG</td><td class="no">DILARANG</td><td class="ok">internal</td><td class="no">DILARANG</td></tr>
592
+ <tr><td><b><code>vendor/minicore/</code></b> <span class="chip c3">L3</span></td><td class="no">DILARANG</td><td class="no">DILARANG</td><td class="no">DILARANG</td><td class="ok">internal</td></tr>
593
+ </table>
594
+ </div>
595
+
596
+ <div class="hint hint-info"><span class="ico"><span class="mi">layers</span></span><div class="body"><span class="title">Lapisan logis ≠ struktur direktori</span><code>src/ui/</code> secara fisik ada di <code>src/</code> tetapi bermain di <span class="chip c1">L1</span> — lapisan ditentukan peran, bukan lokasi folder.</div></div>
597
+ <div class="hint hint-purple"><span class="ico"><span class="mi">cable</span></span><div class="body"><span class="title">Satu-satunya jembatan UI ↔ agen</span>Data masuk UI lewat kontrak tipe struktural di <code>src/ui/contract.ts</code> (<code>UiEvent</code>, <code>UiBus</code>, <code>UiStep</code>, <code>UiExecution</code>, <code>UiToolCallRef</code>). Kemampuan agen masuk UI lewat <b>callback yang di-inject</b> dari composition root <code>cli/setup.ts</code> (<code>ask</code>, <code>setupWhenEmpty</code>). UI tidak pernah menyentuh config, disk, atau kernel.</div></div>
598
+ <div class="hint hint-ok"><span class="ico"><span class="mi">link</span></span><div class="body"><span class="title">Pola DI yang sama berlaku di luar UI</span><code>setSubAgentSessionFactory</code> (cli/index.ts → delegate_task), <code>ask</code> (approval), <code>setupWhenEmpty</code> (wizard). Tanpa injeksi, perilaku default selalu aman: deny / tolak jalan. Subpath <code>#minicore</code> (package.json <code>imports</code>) adalah satu-satunya pintu kode ke L3.</div></div>
599
+ <div class="hint hint-warn"><span class="ico"><span class="mi">warning</span></span><div class="body"><span class="title">Mengapa tiga lapisan?</span>Kernel dapat disinkron/diganti tanpa menyentuh aplikasi; kebijakan keamanan berdiri di L2 sehingga otomatis berlaku untuk semua tool (bawaan maupun MCP); UI bebas berubah tanpa memengaruhi logika — dan sebaliknya.</div></div>
600
+ </section>
601
+
602
+ <!-- ── 2 · ALUR ── -->
603
+ <section id="alur">
604
+ <h2 class="sec"><span class="hn">02</span> Alur eksekusi satu prompt <a class="anchor" href="#alur">#</a></h2>
605
+ <p class="lede">Tujuh tahap jalur utama, lengkap dengan file tempat tiap tahap hidup. Subcommand admin dan mode MCP server tidak lewat alur ini.</p>
606
+ <div class="steps">
607
+ <div class="step"><div class="dot">1</div><div class="card-b"><b>Entry &amp; parsing</b>
608
+ <span class="where">cli/index.ts → cli/args.ts → cli/router.ts</span>
609
+ <span class="what">argv dipisah jadi flag &amp; prompt; dispatch ke subcommand (auth/config/exec/mcp/pricing/providers/sessions/skills/stats) atau REPL. Flag tak dikenal tidak error — ia jadi kata prompt (§8).</span>
610
+ </div></div>
611
+ <div class="step"><div class="dot">2</div><div class="card-b"><b>Perakitan sesi</b>
612
+ <span class="where">cli/setup.ts → src/app/session.ts → src/app/{provider,tool,rag}-layer.ts</span>
613
+ <span class="what">Config dimuat; session kernel dibuat; provider + tools + permission dirakit; checkpoint &amp; callback UI (ask, wizard) di-inject — titik komposisi seluruh aplikasi.</span>
614
+ </div></div>
615
+ <div class="step"><div class="dot">3</div><div class="card-b"><b>Loop agen</b>
616
+ <span class="where">vendor/minicore/src/core/{session,loop}.ts</span>
617
+ <span class="what">session.run menjalankan executeTurn berulang (maxSteps default 50) di atas salinan ContextStore transaksional per turn — bisa di-rollback oleh checkpoint.</span>
618
+ </div></div>
619
+ <div class="step"><div class="dot">4</div><div class="card-b"><b>Streaming provider</b>
620
+ <span class="where">src/providers/router.ts → anthropic.ts · vendor openai-compat.ts</span>
621
+ <span class="what">Model dipilih, request dikirim, token di-stream sebagai event bus kernel → diterima presentation sebagai UiEvent.</span>
622
+ </div></div>
623
+ <div class="step"><div class="dot">5</div><div class="card-b"><b>Eksekusi tool</b>
624
+ <span class="where">vendor core/executor.ts → src/policy/executor.ts → src/tools/*</span>
625
+ <span class="what">Rantai gerbang §5: jail → permission → bash-guard → validateArgs → execute → truncation. Tool MCP eksternal dirutekan lewat src/mcp/client.ts (“serverid.toolname”).</span>
626
+ </div></div>
627
+ <div class="step"><div class="dot">6</div><div class="card-b"><b>Rendering output</b>
628
+ <span class="where">src/ui/render/{sanitize,markdown,highlight,wrap,width}.ts → src/ui/assistant/simple.ts</span>
629
+ <span class="what">Teks tak terpercaya disanitasi, didekorasi markdown, diukur dalam kolom, lalu mengalir append-only ke scrollback. Assistant hanya mengonsumsi event UiBus.</span>
630
+ </div></div>
631
+ <div class="step"><div class="dot">7</div><div class="card-b"><b>Persistensi</b>
632
+ <span class="where">src/session/{persistence,shadow-git,checkpoint}.ts · src/telemetry/trace.ts</span>
633
+ <span class="what">Pesan disimpan inkremental ke sqlite (WAL, TTL 30 hari); tree per turn dicatat shadow-git di refs/minicode/*; trace jsonl untuk diagnostik &amp; biaya.</span>
634
+ </div></div>
635
+ </div>
636
+ </section>
637
+
638
+ <!-- ── 3 · POHON MODUL ── -->
639
+ <section id="pohon">
640
+ <h2 class="sec"><span class="hn">03</span> Modul &amp; ekspor kunci <a class="anchor" href="#pohon">#</a></h2>
641
+ <p class="lede">Satu kartu = satu berkas/dir: peran, lalu baris <span class="ok">⇢</span> berisi simbol ekspor yang aman dikonsumsi dari lapisan yang boleh. Saring dengan kata kunci, lompat lewat sidebar.</p>
642
+
643
+ <div class="toolbar">
644
+ <button id="openAll" type="button">Buka semua</button>
645
+ <button id="closeAll" type="button">Tutup semua</button>
646
+ </div>
647
+ <div class="empty-note" id="emptyNote">Tidak ada modul yang cocok. Kosongkan saringan untuk melihat semua.</div>
648
+
649
+ <details class="group" id="g-cli" open>
650
+ <summary><span class="chip c1">L1</span> cli/ <span class="role">— entry point, subcommand, penggerak REPL, controller layar</span> <span class="cnt">8 modul</span></summary>
651
+ <div class="mods">
652
+ <div class="mod"><div class="fname">index.ts</div><div class="fdesc">Entry utama (bin package.json): parsing argv, HELP/versi, rute subcommand vs REPL; wiring DI factory sub-agen (setSubAgentSessionFactory) sebelum dispatch.</div><div class="exports">titik masuk — dieksekusi, tidak diimpor</div></div>
653
+ <div class="mod"><div class="fname">args.ts</div><div class="fdesc">Parsing argumen murni: whitelist flag, bentuk <code>--f v</code> &amp; <code>--f=v</code>, baca stdin.</div><div class="exports">getArg · promptFromArgs · readPrompt</div></div>
654
+ <div class="mod"><div class="fname">setup.ts</div><div class="fdesc">Composition root: rakit config + kernel session + tools + permission; inject wizard (setupWhenEmpty) dan approval (ask) ke lapisan logika; pemutus budget mid-turn (watchBudgetLimit menggugurkan turn via abort begitu pagu lewat).</div><div class="exports">createCliSession · CliSession</div></div>
655
+ <div class="mod"><div class="fname">router.ts</div><div class="fdesc">Dispatch prompt ke provider dengan retry/backoff sisi CLI.</div><div class="exports">dispatch</div></div>
656
+ <div class="mod"><div class="fname">commands.ts</div><div class="fdesc">Registry slash builtin + eksekusinya. DRIVER_HELP_COMMANDS = perintah driver yang tampil di /help tapi TIDAK di dropdown (mode/undo/redo/clear/copy/history). /thinking = toggle tampilan reasoning (expand/minimize); effort via picker Enter di /model.</div><div class="exports">handleBuiltinCommand · BUILTIN_COMMANDS · DRIVER_HELP_COMMANDS · /help /provider /model /sync /status /sessions /init /exit /compact</div></div>
657
+ <div class="mod"><div class="fname">repl.ts</div><div class="fdesc">Driver REPL linier: loop askLine + dispatch slash/skill/prompt langsung ke scrollback; raw mode saat busy untuk tombol + / - / Ctrl+T (section collapse live), interupsi Ctrl+C saat busy (SIGINT + byte \x03; pipe/CI tanpa tombol live), budget di driver; /expand membuka buffer section, /minimize mengecilkan; Tab kosong toggle plan/build; did-you-mean untuk typo slash.</div><div class="exports">runRepl · suggestSimilar · applyBusyKey</div></div>
658
+ <div class="mod"><div class="fname">commands/ — 11 berkas, satu per subcommand</div><div class="fdesc">auth.ts · config.ts · exec.ts · mcp.ts · pricing.ts · providers.ts · sessions.ts · skills.ts · stats.ts · memory.ts (status RAG: rows/size/hit-rate) · doctor.ts (diagnosis lokal)</div><div class="exports">handleAuth · handleConfig · handleExec · handleMcp · handlePricing · handleProviders · handleSessions · handleSkills · handleStats · handleMemory · handleDoctor</div></div>
659
+ <div class="mod"><div class="fname">wizard.ts · model-manager.ts · provider-manager.ts · auto-update.ts</div><div class="fdesc">Controller tipis: pegang CRUD config, panggil view murni di src/ui/screens/. /model Enter = pilih + picker thinking effort (Esc = batal total) via onSelect + onSetEffort; mutasi ditulis ke file scope asal provider; badge effort non-default di baris. auto-update.ts = cek/update mandiri (maybeAutoUpdate).</div></div>
660
+ </div>
661
+ </details>
662
+
663
+ <details class="group" id="g-app" open>
664
+ <summary><span class="chip c2">L2</span> src/app/ <span class="role">— perakitan agen (termasuk session.ts)</span> <span class="cnt">5 modul</span></summary>
665
+ <div class="mods">
666
+ <div class="mod"><div class="fname">app/session.ts</div><div class="fdesc">Sambungkan kernel session dengan permission handler, recovery, event.</div><div class="exports">createMinicodeSession · PermissionControl</div></div>
667
+ <div class="mod"><div class="fname">app/provider-layer.ts</div><div class="fdesc">Rakit provider dari config ke bentuk kernel; first-run via callback setupWhenEmpty; simpan currentRouter + reloadProviders agar /provider dan /model langsung routing tanpa restart.</div><div class="exports">createProviderLayer · reloadProviders</div></div>
668
+ <div class="mod"><div class="fname">app/tool-layer.ts</div><div class="fdesc">Rakit daftar tool bawaan + MCP.</div></div>
669
+ <div class="mod"><div class="fname">app/rag-layer.ts</div><div class="fdesc">Lapisan RAG/memory untuk konteks; lapor memoryHits (jumlah hit ter-inject) untuk trace.</div></div>
670
+ <div class="mod"><div class="fname">app/mentions.ts</div><div class="fdesc">Ekspansi @mention berkas dalam prompt (lewat cek jail path sensitif).</div><div class="exports">parseMentions · resolveMentionContent · expandMentions</div></div>
671
+ </div>
672
+ </details>
673
+
674
+ <details class="group" id="g-policy" open>
675
+ <summary><span class="chip c2">L2</span> src/policy/ <span class="role">— semua kebijakan izin &amp; keamanan agen</span> <span class="cnt">10 modul</span></summary>
676
+ <div class="mods">
677
+ <div class="mod"><div class="fname">permission.ts</div><div class="fdesc">Handler 6 mode: auto/ask/readonly/plan/allowlist/allow-all; kunci per tool. Allowlist lokal hanya dibaca bila opt-in <code>--allow-local-config</code>; grant "always" sesi ini disimpan in-memory.</div><div class="exports">createPermissionHandler · PermissionMode · PermissionAsk</div></div>
678
+ <div class="mod"><div class="fname">allowlist.ts</div><div class="fdesc">Allowlist tool (global + proyek, merge dedup); pola wildcard <code>tool:args</code> — dipakai mode allowlist &amp; jawaban “always” di mode ask.</div><div class="exports">loadAllowlist · saveAllowlist · matchAllowlist · Allowlist</div></div>
679
+ <div class="mod"><div class="fname">jail.ts</div><div class="fdesc">Kebijakan path MURNI (tanpa IO async): predikat logis + SENSITIVE_RE. Pemilik definisi “sensitif/luar”; resolusi async milik lib/safe-open.ts. OWNED_STATE_RE: tool tulis dilarang menyentuh state minicode di bawah .minicode/ (DB, todos, plans, checkpoints, jurnal, traces, allowlist, config) — baca tetap boleh.</div><div class="exports">isRealPathOutsideRoot · isPathOutsideRoot · isCwdOutsideRoot · isSensitive · isOwnedState · SENSITIVE_RE</div></div>
680
+ <div class="mod"><div class="fname">bash-guard.ts</div><div class="fdesc">Normalisasi perintah dulu, periksa statik kemudian (lihat urutan di §5).</div><div class="exports">inspectBashCommand · normalizeCommand · stripQuotes · inlineSimpleVars · stripCommandWrappers · BashVerdict</div></div>
681
+ <div class="mod"><div class="fname">executor.ts</div><div class="fdesc">runCall: permission → validateArgs → execute → truncation hasil.</div><div class="exports">parallelExecutor</div></div>
682
+ <div class="mod"><div class="fname">compaction.ts · context.ts</div><div class="fdesc">Kebijakan pemadatan konteks; manajemen jendela konteks. Ringkasan LLM di-pin verbatim (anti-drift), mendarat di DB cwd, prompt dipagar anti-injeksi; system prompt menandai data tak-terpercaya.</div></div>
683
+ <div class="mod"><div class="fname">pricing.ts · usage.ts</div><div class="fdesc">Tabel harga model; kolektor token &amp; biaya.</div></div>
684
+ <div class="mod"><div class="fname">ratelimit.ts · sandbox-policy.ts</div><div class="fdesc">Batas laju permintaan; kebijakan fallback sandbox.</div></div>
685
+ <div class="mod"><div class="fname">scrub.ts · verifier.ts</div><div class="fdesc">Pembersihan data sensitif; verifikasi hasil (mode --verify).</div></div>
686
+ <div class="mod"><div class="fname">executor.ts — urutan gerbang</div><div class="fdesc">Urutan tetap: jail → permission → bash-guard → validateArgs → execute → truncation. Jangan sisipkan gerbang baru tanpa test di test/.</div></div>
687
+ </div>
688
+ </details>
689
+
690
+ <details class="group" id="g-tools">
691
+ <summary><span class="chip c2">L2</span> src/tools/ <span class="role">— 37 tool bawaan agen (registry: allTools)</span> <span class="cnt">13 kelompok</span></summary>
692
+ <div class="mods">
693
+ <div class="mod"><div class="fname">index.ts</div><div class="fdesc">Registry tool bawaan; tool MCP di-append runtime dengan dedup nama.</div><div class="exports">allTools: Tool[] (37) · withMcpTools</div></div>
694
+ <div class="mod"><div class="fname">bash.ts — 3 tool</div><div class="fdesc">bash (eksekusi, integrasi bash-guard), bashOutput, bashKill.</div><div class="exports">bashTool · bashOutputTool · bashKillTool</div></div>
695
+ <div class="mod"><div class="fname">read_file.ts · write_file.ts · edit.ts · patch.ts — 4 tool</div><div class="fdesc">Baca/tulis/edit/patch; edit pakai flexibleMatch bertingkat.</div><div class="exports">readFileTool · writeFileTool · editTool · applyPatchTool</div></div>
696
+ <div class="mod"><div class="fname">move_file.ts · delete_file.ts · read_image.ts · code_run.ts — 4 tool</div><div class="fdesc">Pindah/rename atomik + hapus soft ke .trash/ (jail simetris di permission); baca gambar ke konteks; snippet python/node via sandbox runner (docker/OS, network-isolated, fail-closed tanpa backend).</div><div class="exports">moveFileTool · deleteFileTool · readImageTool · codeRunTool · shSingleQuote</div></div>
697
+ <div class="mod"><div class="fname">glob.ts · grep.ts — 2 tool</div><div class="fdesc">Pencarian berkas &amp; isi (grep: ripgrep bila ada, engine js via env).</div><div class="exports">globTool · grepTool</div></div>
698
+ <div class="mod"><div class="fname">git.ts — 4 tool · lib/git-hardening.ts · lib/trusted-exec.ts</div><div class="fdesc">Read-only status/diff/log + commit eksplisit. Audit #10: semua pemanggilan git memakai netralisasi hooks/fsmonitor/pager/driver repo (GIT_SAFE_BASE) dan executable absolut dari PATH terpercaya (Windows cwd-first rentan hijack <code>git.bat</code> repo).</div><div class="exports">gitStatusTool · gitDiffTool · gitLogTool · gitCommitTool · GIT_SAFE_BASE · GIT_NO_DIFF_DRIVERS · gitFilterNeutralizers · resolveTrustedExecutable</div></div>
699
+ <div class="mod"><div class="fname">hashline.ts — helper, BUKAN tool</div><div class="fdesc">Pemetaan baris-hash untuk edit/patch; tidak terdaftar di allTools.</div></div>
700
+ <div class="mod"><div class="fname">lsp.ts — 6 tool</div><div class="fdesc">Diagnostics, definition, references, hover, symbols, workspaceSymbols.</div><div class="exports">lspDiagnosticsTool · lspDefinitionTool · lspReferencesTool · lspHoverTool · lspSymbolsTool · lspWorkspaceSymbolsTool</div></div>
701
+ <div class="mod"><div class="fname">web_fetch.ts · web_search.ts — 2 tool</div><div class="fdesc">Fetch/search web dengan proteksi SSRF (DNS pinning).</div><div class="exports">webFetchTool · webSearchTool</div></div>
702
+ <div class="mod"><div class="fname">memory.ts — 3 tool</div><div class="fdesc">Memori lintas sesi (RAG).</div><div class="exports">readMemoryTool · writeMemoryTool · forgetMemoryTool</div></div>
703
+ <div class="mod"><div class="fname">task.ts · todo.ts · submit_result.ts · ask_user.ts — 5 tool</div><div class="fdesc">delegateTask (sub-agen via agents/pool; session factory di-inject dari cli/index.ts — tool tidak mengimpor lapisan app); anak selalu mode auto tanpa ask (tanpa MCP/commit/memory-tulis/todo-tulis/job/nesting; parent plan/readonly dipaksa explore); anak mewarisi model parent + limiter bersama + default provider (setSubAgentParentRouting dari cli/setup.ts); event forward ditandai agar jurnal parent tak ganda; todo state per sesi + plan artifact .minicode/plans/&lt;id&gt;.md; submit_result (output terstruktur); ask_user (gated, view di-inject dari cli/setup.ts).</div><div class="exports">delegateTaskTool · setSubAgentSessionFactory · setSubAgentParentRouting · SubAgentSessionFactory · SubAgentParentRouting · getSubAgentProvider · todoWriteTool · todoReadTool · todoSession · renderPlan · savePlanSnapshot · loadPlan · submitResultTool · askUserTool · setAskTextFn</div></div>
704
+ <div class="mod"><div class="fname">mcp_call.ts — 4 tool</div><div class="fdesc">Klien tool MCP eksternal dari dalam loop agen.</div><div class="exports">mcpListTool · mcpCallTool · mcpReadTool · mcpPromptTool</div></div>
705
+ <div class="mod"><div class="fname">web_search.ts — catatan provider</div><div class="fdesc">Search web agregat; hasilnya tetap lewat sanitizeAnsi sebelum render.</div><div class="exports">webSearchTool</div></div>
706
+ </div>
707
+ </details>
708
+
709
+ <details class="group" id="g-providers">
710
+ <summary><span class="chip c2">L2</span> src/providers/ <span class="role">— koneksi model</span> <span class="cnt">6 modul</span></summary>
711
+ <div class="mods">
712
+ <div class="mod"><div class="fname">router.ts</div><div class="fdesc">Pilih provider untuk satu request (byId per-stream + updateProviders agar provider baru langsung dikenali; fallback berantai; 429 + retry-after ditunggu — cap 30 dtk — lalu fallback, atau coba-ulang-di-tempat bila provider tunggal). Menyelipkan system prompt sebagai pesan user pertama untuk adapter tanpa dukungan system native (openai-compat; Anthropic/Responses diurus di adapter).</div><div class="exports">createRouterProvider · updateProviders</div></div>
713
+ <div class="mod"><div class="fname">anthropic.ts</div><div class="fdesc">Adapter Anthropic native (stream SSE).</div></div>
714
+ <div class="mod"><div class="fname">responses.ts</div><div class="fdesc">Adapter Responses API (/v1/responses, store:false, chaining previous_response_id per model). System via <code>instructions</code>, riwayat tool via function_call/output items (linkage utuh), 400-konteks → compact-and-retry.</div><div class="exports">createResponsesProvider · clearResponsesChain · toResponsesInput</div></div>
715
+ <div class="mod"><div class="fname">build.ts · detect.ts · presets.ts</div><div class="fdesc">Bangun adapter (termasuk Responses API + peta reasoningEffort); deteksi tipe dari probe (path /responses → responses), bukan substring URL; preset provider populer.</div></div>
716
+ <div class="mod"><div class="fname">provision.ts</div><div class="fdesc">Provisioning provider: deteksi model + simpan/hapus/sinkron entri config. Dipisah dari config.ts agar config murni IO — arah satu arah: providers → config.</div><div class="exports">saveProvider · detectAndSave · deriveProviderId · removeProvider · refreshProviderModels</div></div>
717
+ <div class="mod"><div class="fname">oauth.ts · auth-store.ts</div><div class="fdesc">Alur OAuth dan penyimpanan kredensial.</div></div>
718
+ </div>
719
+ </details>
720
+
721
+ <details class="group" id="g-session">
722
+ <summary><span class="chip c2">L2</span> src/session/ <span class="role">— persistensi, checkpoint &amp; jurnal recovery</span> <span class="cnt">4 modul</span></summary>
723
+ <div class="mods">
724
+ <div class="mod"><div class="fname">persistence.ts</div><div class="fdesc">sqlite WAL: simpan pesan inkremental, daftar sesi, purge TTL, fork sesi (branch).</div><div class="exports">saveSession · loadSession · listSessions · deleteSession · branchSession · purgeExpired · getSessionTtlDays</div></div>
725
+ <div class="mod"><div class="fname">shadow-git.ts</div><div class="fdesc">SHA tree git per turn di refs/minicode/* — tanpa menyentuh HEAD/index user.</div><div class="exports">ShadowSnapshot · ShadowChange · RestoreResult</div></div>
726
+ <div class="mod"><div class="fname">checkpoint.ts</div><div class="fdesc">Manifes checkpoint di .minicode/checkpoints/ (maks 20) + undo per turn + validasi resume (divergensi workspace vs checkpoint terakhir, .minicode/ dikecualikan). Protokol undo/redo uniform: apply → marker jurnal (newIndex) → save pointer; crash di antaranya dipulihkan <code>reconcileUndoRedoPointer</code> dari marker (metadata-only, tanpa re-eksekusi).</div><div class="exports">Checkpoint · CheckpointManifest · FileSnapshot · validateResumeWorkspace · reconcileUndoRedoPointer</div></div>
727
+ <div class="mod"><div class="fname">journal.ts</div><div class="fdesc">Mutation intent journal: status komitmen per mutasi (pending/committed/failed/finalized) via event execution:started/completed — menjawab "sudah/belum/ambigu" saat resume. File dibuat eager saat attach (empty ≠ absent); turn namespace per-sesi (anak tak cross-match parent); delegasi ter-cover transitif. Terminal bukti dedup (<code>dedup: true</code>, mis. MCP request id+hash) selamat dari sweep agar retry id-sama pasca-restart tetap terdeteksi. BUKAN transaksi: pending = ambigu (verify dulu), committed ≠ turn durable, MCP = external-acknowledged.</div><div class="exports">appendMutationIntent · appendMutationTerminal · decideRecovery · attachMutationJournal · planRecoveryForSession · classifyTool · findOrphanJournals</div></div>
728
+ </div>
729
+ </details>
730
+
731
+ <details class="group" id="g-ui">
732
+ <summary><span class="chip c1">L1</span> src/ui/ <span class="role">— presentation mandiri · DILARANG impor cli/ · src/ non-ui · #minicore</span> <span class="cnt">19 modul</span></summary>
733
+ <div class="mods">
734
+ <div class="mod"><div class="fname">contract.ts</div><div class="fdesc">Satu-satunya bentuk data yang mengalir ke UI; EventBus kernel kompatibel struktural.</div><div class="exports">UiBus · UiEvent · UiEventType · UiStep · UiExecution · UiToolCallRef</div></div>
735
+ <div class="mod"><div class="fname">render/theme.ts</div><div class="fdesc">Warna &amp; glyph sebagai GETTER runtime (UTF-8, NO_COLOR) — jangan bekukan ke const. Palet tunggal; auto-detect: NO_COLOR &gt; stdout TTY &gt; truecolor &gt; 256 &gt; 16 &gt; mono. Warna MATI saat stdout bukan TTY. Fitur tema (--theme, /theme, preset) dihapus.</div></div>
736
+ <div class="mod"><div class="fname">render/sanitize.ts</div><div class="fdesc">sanitizeAnsi — hanya loloskan SGR; wajib untuk teks tak terpercaya.</div><div class="exports">sanitizeAnsi</div></div>
737
+ <div class="mod"><div class="fname">render/width.ts · wrap.ts</div><div class="fdesc">Ukur teks dalam KOLOM (CJK/emoji = 2); pembungkus + justify.</div><div class="exports">displayWidth · truncateToWidth · padToWidth</div></div>
738
+ <div class="mod"><div class="fname">render/markdown.ts · highlight.ts</div><div class="fdesc">Dekorasi markdown ke ANSI; syntax highlight kode.</div></div>
739
+ <div class="mod"><div class="fname">render/format.ts · diff.ts · table.ts · money.ts · reasoning.ts · collapse.ts</div><div class="fdesc">Format event (tipe lokal), render diff, tabel, biaya, toggle reasoning, section collapse (+ / - dengan buffer untuk /expand).</div><div class="exports">reasoning (visible) · sectionMinimized · setSectionMinimized · bufferSection · getBufferedSections</div></div>
740
+ <div class="mod"><div class="fname">render/errors.ts</div><div class="fdesc">Format error provider jadi bahasa ramah user.</div><div class="exports">friendlyError · formatFriendly</div></div>
741
+ <div class="mod"><div class="fname">render/detail.ts</div><div class="fdesc">Mode compact/expanded global (MINICODE_COMPACT, /compact, Ctrl+O).</div><div class="exports">detail · setCompactMode</div></div>
742
+ <div class="mod"><div class="fname">runtime/statusline.ts</div><div class="fdesc">ARBITRASE SATU-SATUNYA untuk semua transient stderr: <code>acquireTransientPaint(kind)</code> (turn-painter vs wizard-spinner, overlap = signal <code>[transient-paint]</code>) + <code>paintWrite</code>; tulis asing non-UI saat painter aktif dikomit sebagai baris permanen; koordinasi suspend/resume baris status vs printer linier.</div><div class="exports">acquireTransientPaint · paintWrite · isTransientPainting · registerStatusLine · runWithoutStatus</div></div>
743
+ <div class="mod"><div class="fname">runtime/bus-debug.ts</div><div class="fdesc">Dump diagnosis event bus (MINICODE_DEBUG_BUS=1): sekali per sesi agar event yatim pun terlihat; tanpa env = tanpa subscribe (zero-cost).</div><div class="exports">attachBusDebug</div></div>
744
+ <div class="mod"><div class="fname">runtime/spinner.ts</div><div class="fdesc">Spinner wizard (glyphs.spinnerFrames); TTY-only — tanpa byte kontrol pada non-TTY; ikut arbitrase transient statusline.</div><div class="exports">createSpinner</div></div>
745
+ <div class="mod"><div class="fname">footer.ts</div><div class="fdesc">Render footer status REPL (murni, tanpa IO): 1 baris status <code>✦ mode • model • cwd … 14.2k</code> (+ 1 baris kosong reserve saat lengket; tanpa garis separator). Mode pad-9 anti-geser (per kolom via padToWidth), satu-satunya berwarna; spark pulse saat busy / redup saat idle; konteks rata kanan; <code>sanitizeAnsi</code> + potong per kolom. Non-TTY diputuskan mekanisme, bukan di sini.</div><div class="exports">renderFooter · shortModel · paintFooterMode · FooterStatus</div></div>
746
+ <div class="mod"><div class="fname">runtime/chrome.ts</div><div class="fdesc">Footer status LENGKET (satu-satunya chrome permanen): DECSTBM scroll-region 2 baris dasar (blank + status), output turn hanya di area atas — footer tak ikut scroll. Gaya <code>MINICODE_FOOTER=off|print|sticky|auto</code> (auto = lengket bila terminal mampu, cetak bila tidak; pipa non-TTY nol byte). <code>setBusy()</code> menggerakkan pulse spark redup→pulse; <code>Esc</code> lone-50ms saat turn = abort tanpa teks. Reset region dijamin di semua jalur keluar; fail-closed, tak pernah melempar (pola statusline).</div><div class="exports">createFooterChrome · footerReserveRows · FooterChrome · FooterMode</div></div>
747
+ <div class="mod"><div class="fname">input/prompt-engine.ts · input.ts</div><div class="fdesc">Engine input murni &amp; teruji: grapheme (Intl.Segmenter), state, dekode CSI/UTF-8 streaming, render spec; history (JSON per baris), askLine (+ onKey, multiline Ctrl+J, reverse-i-search Ctrl+R), askSecret; deletePrevUnit Thai/Lao-aware.</div><div class="exports">createState · applyKey · buildRenderSpec · decodeKeys · decodeKeysStream · toGraphemes · deletePrevUnit · MAX_VISIBLE · loadHistory · appendHistory · detectAnsi · askLine · askSecret</div></div>
748
+ <div class="mod"><div class="fname">assistant/simple.ts · turn-status.ts</div><div class="fdesc">Printer linier (satu-satunya renderer, one-shot &amp; REPL): output append-only di scrollback; stdout = teks model/receipt, stderr = ledger tool &amp; diagnostik. Tool compact = satu baris <code>› nama target</code> (REPL default; env eksplisit menang; /compact / Ctrl+O membalik). Section besar (thinking/bash/edit/content) default minimize: satu baris <code>+ label</code>, isi di-buffer untuk /expand. Ledger SELALU ber-newline. Garis status turn lifecycle deterministik.</div><div class="exports">attachSimpleLogger · formatError · getLastTurnText · writeClipboardOsc52 · attachTurnStatus</div></div>
749
+ <div class="mod"><div class="fname">approval/prompt.ts</div><div class="fdesc">View persetujuan tool call [y/a/n]; di-inject ke permission handler oleh cli/setup.ts; live-region screen reader saat MINICODE_A11Y=1.</div><div class="exports">promptAsk · ApprovalRequest</div></div>
750
+ <div class="mod"><div class="fname">screens/overlay.ts</div><div class="fdesc">Primitive overlay transient bersama: redraw + clear delete-line yang konsisten untuk semua layar interaktif (tetap shell-like, tanpa panel permanen).</div><div class="exports">renderTransientOverlay · clearTransientOverlay</div></div>
751
+ <div class="mod"><div class="fname">screens/picker.ts</div><div class="fdesc">Picker generik — dipakai manager &amp; wizard; transient, membersihkan diri sendiri; highlight substring query dengan bold.</div><div class="exports">runPicker</div></div>
752
+ <div class="mod"><div class="fname">screens/wizard.ts · model-manager.ts · provider-manager.ts</div><div class="fdesc">View murni layar interaktif: hanya props data + callback async; tanpa akses config/disk. Model manager mengikuti pola overlay transient yang sama.</div><div class="exports">runSetupWizardView · runModelManagerView · runProviderManagerView</div></div>
753
+ </div>
754
+ </details>
755
+
756
+ <details class="group" id="g-lain">
757
+ <summary><span class="chip c2">L2</span> src/ lainnya <span class="role">— MCP, LSP, hooks, memory, skills, sandbox</span> <span class="cnt">12 modul</span></summary>
758
+ <div class="mods">
759
+ <div class="mod"><div class="fname">mcp/ (client · server · transport · http-transport)</div><div class="fdesc">Klien &amp; server MCP; transport klien stdio/HTTP (SSRF-protected). server.ts = minicode jadi MCP server (stdio-only): validateArgs kernel + permission/jail + jurnal mutasi + idempotency per request-id + cancel per-request; tanpa turn/session kernel.</div><div class="exports">mcpInventory · extractMcpText · getMcpServerIds · McpServerConfig · serveMcp · selectTools</div></div>
760
+ <div class="mod"><div class="fname">lsp/client.ts</div><div class="fdesc">Klien LSP: diagnostics, posisi symbol, server per ekstensi.</div><div class="exports">LspConnection · configureServers · lspDiagnostics · languageIdFor</div></div>
761
+ <div class="mod"><div class="fname">hooks/run.ts</div><div class="fdesc">Eksekusi hook eksternal opt-in (MINICODE_HOOKS=1). Env tersanitasi tanpa secret; dilewati bila sesi aborted. Allowlist pindah ke policy/allowlist.ts.</div><div class="exports">findRunHooks · runRunHooks</div></div>
762
+ <div class="mod"><div class="fname">memory/files.ts · memory/vector.ts</div><div class="fdesc">Memori berbasis file &amp; pencarian vektor: FTS5 + idx lower(text), ranking MMR λ=0.7 + dedup cosine 0.92, chunk 2000/overlap 200 (kolom parent), TTL hierarkis fact/decision 180 + summary 90 + snippet 14 hari + cap 5000 baris, kolom model/dim/category/tags/access_count, SSRF strict. forget menghapus scope lokal + global (keduanya ikut di-search).</div><div class="exports">addMemory · searchHybrid · deleteMemoryByQuery · clearAllMemory · getMemoryStats · splitMemoryChunks · MemoryHit · MemoryStats</div></div>
763
+ <div class="mod"><div class="fname">skills/loader.ts</div><div class="fdesc">Muat &amp; render skill — slash /nama-skill.</div></div>
764
+ <div class="mod"><div class="fname">repo/repomap.ts</div><div class="fdesc">Peta ringkas struktur repo untuk konteks (LSP atau regex).</div></div>
765
+ <div class="mod"><div class="fname">sandbox/docker.ts · sandbox/os.ts</div><div class="fdesc">Eksekusi terisolasi Docker/OS di bawah kebijakan sandbox-policy.</div></div>
766
+ <div class="mod"><div class="fname">agents/pool.ts</div><div class="fdesc">Pool sub-agen untuk tool task.</div></div>
767
+ <div class="mod"><div class="fname">telemetry/trace.ts</div><div class="fdesc">Trace jsonl per request provider — bahan /stats &amp; gate telemetry; step-traces.jsonl per tool/step + klasifikasi deny + mode sandbox; catat memoryHits untuk hit-rate RAG (<code>memory status</code>).</div><div class="exports">RunTrace · StepTrace</div></div>
768
+ <div class="mod"><div class="fname">config.ts · constants.ts</div><div class="fdesc">IO config murni: muat/simpan (global selalu; lokal hanya bila opt-in <code>--allow-local-config</code>, default fail-closed — lokal adalah input repo tak terpercaya) + CRUD MCP/LSP; LIMITS konstan pemotongan. Provisioning dipisah ke providers/provision.ts — arah satu arah: providers → config.</div><div class="exports">loadConfig · normalizeConfig · writeConfigAtomic · withConfigLock · localConfigPath · localConfigNotice · GLOBAL · LOCAL · saveMcpServer · removeMcpServer · saveLspServer · removeLspServer · MinicodeConfig · ProviderEntry · McpServerEntry · LspServerEntry · LIMITS</div></div>
769
+ <div class="mod"><div class="fname">lib/atomic-write.ts · lib/db-path.ts · lib/net.ts · lib/trash.ts</div><div class="fdesc">Tulis atomik (tmp+rename); resolusi path database; penjaga SSRF bersama (host privat + DNS pinning) — dipakai web_fetch, web_search, dan transport MCP HTTP; soft-delete bersama ke .minicode/.trash (cap 100).</div><div class="exports">atomicWriteText · isPrivateHost · isPrivateHostWithDns · trashFile · trashDir</div></div>
770
+ <div class="mod"><div class="fname">lib/safe-open.ts</div><div class="fdesc">Pemilik verifikasi path async, terbagi per kebutuhan: <code>resolveSafePath(p, root)</code> untuk tool PENULIS (butuh path real sebagai target tulis, toleran ENOENT untuk file baru); <code>safeOpenRead</code> (O_NOFOLLOW + cek jail &amp; sensitif pada titik open) untuk pembaca. Alur satu arah: tools → safe-open → jail; tanpa state global.</div><div class="exports">resolveSafePath · safeOpenRead · safeReadFile · safeStat · assertSafeWriteTarget</div></div>
771
+ </div>
772
+ </details>
773
+
774
+ <details class="group" id="g-kernel">
775
+ <summary><span class="chip c3">L3</span> vendor/minicore/ <span class="role">— kernel beku (jangan dimodifikasi, hanya seam aditif)</span> <span class="cnt">7 modul</span></summary>
776
+ <div class="mods">
777
+ <div class="mod"><div class="fname">src/core/session.ts · loop.ts</div><div class="fdesc">Sesi &amp; loop executeTurn (while, maxSteps).</div></div>
778
+ <div class="mod"><div class="fname">src/core/executor.ts · tool.ts · permission.ts</div><div class="fdesc">Eksekutor tool kernel: permission → validate → execute → truncate.</div></div>
779
+ <div class="mod"><div class="fname">src/core/provider.ts · recovery.ts</div><div class="fdesc">Antarmuka provider; pemulihan error/retry.</div></div>
780
+ <div class="mod"><div class="fname">src/core/compact.ts · tokens.ts · budget.ts</div><div class="fdesc">Pemadatan konteks, estimasi token, anggaran.</div></div>
781
+ <div class="mod"><div class="fname">src/core/events.ts · history.ts · snapshot.ts</div><div class="fdesc">Bus event, riwayat pesan, snapshot konteks.</div></div>
782
+ <div class="mod"><div class="fname">src/core/index.ts</div><div class="fdesc">Semua tipe publik yang diimpor aplikasi via #minicore.</div><div class="exports">Tool · ToolSchema · ToolContext · ToolRegistry · ArgsResult · ToolExecutor · ExecutorDeps · PermissionHandler · Decision · ModelProvider · StreamRequest · ProviderEvent · FinishReason · Message · ToolCall · ToolResult · AgentEvent · EventBus · Session · SessionConfig · TurnResult · Step · Execution · CompactionStrategy · TokenEstimator · BudgetPolicy · PressureLevel · RecoveryPolicy</div></div>
783
+ <div class="mod"><div class="fname">src/providers/openai-compat.ts</div><div class="fdesc">Adapter OpenAI-compatible bawaan kernel.</div></div>
784
+ </div>
785
+ </details>
786
+
787
+ <details class="group" id="g-quality">
788
+ <summary><span class="chip cx">QA</span> test/ · scripts/ · bench/ · experiments/ <span class="role">— kualitas &amp; verifikasi</span> <span class="cnt">3 modul</span></summary>
789
+ <div class="mods">
790
+ <div class="mod"><div class="fname">test/</div><div class="fdesc">Suite bun:test — termasuk penjaga invarian: ui-boundary, no-frozen-runtime-value, import-convention.</div></div>
791
+ <div class="mod"><div class="fname">scripts/</div><div class="fdesc">coverage-gate (min lines 84 · funcs 80), pack-check, vendor-minicore, telemetry-gate, test-live.</div></div>
792
+ <div class="mod"><div class="fname">bench/ · experiments/</div><div class="fdesc">Runner benchmark (--model/--provider/--max-steps/--timeout untuk run berbiaya; --memory on|off diferensial); eval-gate (<code>bun run gate:eval</code>: kunci min resolve-rate + max median token); probe adversarial bash-bypass, shadow-git, MCP. <code>bench/harness-audit.ts</code> (<code>bun run audit:harness</code>): 60 cek harness deterministik tanpa API key — safety 6-mode, guard bypass-rate, budget, fake-detector.</div></div>
793
+ </div>
794
+ </details>
795
+ </section>
796
+
797
+ <!-- ── 4 · RESEP EKSTENSI ── -->
798
+ <section id="resep">
799
+ <h2 class="sec"><span class="hn">04</span> Resep ekstensi <a class="anchor" href="#resep">#</a></h2>
800
+ <p class="lede">Enam perubahan paling umum, tiap resep dengan titik sentuh file dan penjaga yang menjatuhkan CI bila dilewati.</p>
801
+ <div class="recipes">
802
+
803
+ <div class="recipe">
804
+ <h3>Menambah tool bawaan <span class="chip c2">L2</span></h3>
805
+ <ol>
806
+ <li><b>Buat</b> <code>src/tools/nama.ts</code> — ekspor objek <code>Tool</code> (type-only import dari <code>#minicore</code>).</li>
807
+ <li><b>Daftarkan</b> di array <code>allTools</code> pada <code>src/tools/index.ts</code> (impor + entri).</li>
808
+ <li><b>Tambah test</b> di <code>test/</code>; nama tool jadi kunci permission mode per-tool.</li>
809
+ </ol>
810
+ <div class="codeblock"><div class="codehead"><span class="fname">src/tools/kalkulator.ts</span><button type="button" data-copy="kod-tool"><span class="mi">content_copy</span><span class="lbl">Salin</span></button></div>
811
+ <pre class="kod" id="kod-tool"><span class="cm">// src/tools/kalkulator.ts</span>
812
+ import type { Tool } from "#minicore"
813
+ export const kalkulatorTool: Tool = {
814
+ name: "kalkulator",
815
+ description: "Hitung ekspresi aritmetika.",
816
+ parameters: { type: "object",
817
+ properties: { expr: { type: "string" } },
818
+ required: ["expr"] },
819
+ async execute(args, ctx) {
820
+ ctx.signal.throwIfAborted()
821
+ return String(hitung(args.expr))
822
+ },
823
+ }</pre></div>
824
+ <div class="guard">guard: hasil execute otomatis dipotong sesuai LIMITS; jangan mengimpor src/ui; operasi file wajib lewat cek jail.</div>
825
+ </div>
826
+
827
+ <div class="recipe">
828
+ <h3>Menambah subcommand admin <span class="chip c1">L1</span></h3>
829
+ <ol>
830
+ <li><b>Buat</b> <code>cli/commands/nama.ts</code> dengan <code>handleNama(args, …)</code>.</li>
831
+ <li><b>Daftarkan</b> rute di <code>cli/router.ts</code> (dispatch).</li>
832
+ <li><b>Update</b> blok HELP + daftar flag di <code>cli/index.ts</code>.</li>
833
+ </ol>
834
+ <div class="guard">guard: subcommand tidak masuk loop agen; akses config hanya lewat API src/config.ts &amp; src/providers/provision.ts, bukan baca file mentah.</div>
835
+ </div>
836
+
837
+ <div class="recipe">
838
+ <h3>Menambah slash command REPL <span class="chip c1">L1</span></h3>
839
+ <ol>
840
+ <li><b>Registry</b> builtin di <code>cli/commands.ts</code> — tambah entri + handler.</li>
841
+ <li>Butuh data agen? Ambil lewat callback/session yang sudah di-inject, bukan impor kernel di UI.</li>
842
+ <li>Skill eksternal? Cukup letakkan berkas skill — dimuat <code>src/skills/loader.ts</code> tanpa ubah kode.</li>
843
+ </ol>
844
+ <div class="guard">guard: output slash tetap harus lewat sanitizeAnsi + width.ts seperti teks model.</div>
845
+ </div>
846
+
847
+ <div class="recipe">
848
+ <h3>Menambah provider / endpoint <span class="chip c2">L2</span></h3>
849
+ <ol>
850
+ <li><b>Endpoint OpenAI-compatible:</b> tidak perlu kode — simpan via wizard atau <code>saveProvider()</code>; deteksi tipe otomatis di <code>src/providers/detect.ts</code>; preset di <code>presets.ts</code>.</li>
851
+ <li><b>Dialek baru:</b> adapter di <code>src/providers/</code> yang memenuhi <code>ModelProvider</code> kernel.</li>
852
+ <li>Uji urutan fallback via <code>MINICODE_PROVIDER_ORDER</code> tanpa edit config.</li>
853
+ </ol>
854
+ <div class="guard">guard: kredensial lewat auth-store/oauth, jangan hardcode; refresh model via refreshProviderModels.</div>
855
+ </div>
856
+
857
+ <div class="recipe">
858
+ <h3>Menambah layar interaktif <span class="chip c1">L1</span></h3>
859
+ <ol>
860
+ <li><b>View murni</b> di <code>src/ui/screens/nama.ts</code>: terima <code>{ data, callbacks }</code>, kembalikan hasil pilihan — zero akses config/disk/kernel.</li>
861
+ <li><b>Controller tipis</b> di <code>cli/</code>: pegang state, lakukan CRUD config, render view berulang.</li>
862
+ <li>Event stream? Berlangganan <code>UiBus</code> (kontrak tipe di contract.ts).</li>
863
+ </ol>
864
+ <div class="guard">guard: test/ui-boundary.test.ts gagal bila src/ui mengimpor cli/ · src/ non-ui · #minicore; teks dinamis wajib lewat sanitizeAnsi.</div>
865
+ </div>
866
+
867
+ <div class="recipe">
868
+ <h3>Menyinkronkan kernel <span class="chip c3">L3</span></h3>
869
+ <ol>
870
+ <li><code>bun run vendor:minicore</code> — tarik upstream ke vendor/.</li>
871
+ <li><code>bun run vendor:check</code> — pastikan vendor == pin di dokumentasi.</li>
872
+ <li>Hanya seam aditif yang boleh ditambal (<code>compactAsync</code>, <code>initialMessages</code>, <code>cwd</code>); sisanya upstream.</li>
873
+ </ol>
874
+ <div class="guard">guard: perubahan kernel wajib lolos seluruh gate (§6) + bench smoke supaya loop tidak regresi.</div>
875
+ </div>
876
+
877
+ </div>
878
+ </section>
879
+
880
+ <!-- ── 5 · KEAMANAN ── -->
881
+ <section id="keamanan">
882
+ <h2 class="sec"><span class="hn">05</span> Rantai pemeriksaan tool call <a class="anchor" href="#keamanan">#</a></h2>
883
+ <p class="lede">Setiap tool call melewati gerbang berurutan; gagal di satu gerbang = ditolak, tidak lanjut.</p>
884
+ <div class="chain">
885
+ <div class="link"><span class="gnum">1</span><b>Jail universal</b>Realpath di luar root &amp; path sensitif ditolak sebelum dispatch mode. Selalu aktif di semua mode.<span class="mono">src/policy/jail.ts</span></div>
886
+ <div class="link"><span class="gnum">2</span><b>Mode izin</b>auto / ask / readonly / plan / allowlist / allow-all.<span class="mono">src/policy/permission.ts</span></div>
887
+ <div class="link"><span class="gnum">3</span><b>Bash-guard</b>Normalisasi &amp; pemeriksaan statik perintah bash.<span class="mono">src/policy/bash-guard.ts</span></div>
888
+ <div class="link"><span class="gnum">4</span><b>validateArgs</b>Validasi argumen per skema tool.<span class="mono">vendor core/executor.ts</span></div>
889
+ <div class="link"><span class="gnum">5</span><b>Execute &amp; truncate</b>Hasil dipotong sesuai LIMITS sebelum kembali ke konteks.<span class="mono">src/policy/executor.ts</span></div>
890
+ </div>
891
+ <div class="hint hint-info"><span class="ico"><span class="mi">format_list_numbered</span></span><div class="body"><span class="title">Urutan normalisasi bash-guard</span><code>stripQuotes</code> → <code>inlineSimpleVars</code> → <code>stripCommandWrappers</code> → <code>inspectBashCommand</code>. Perintah dinormalisasi <b>terlebih dahulu</b> supaya bypass lewat quoting/variabel/wrapper ketahuan; jangan memanggil <code>inspectBashCommand</code> pada string mentah.</div></div>
892
+ <div class="hint hint-warn"><span class="ico"><span class="mi">shield</span></span><div class="body"><span class="title">allow-all tidak melewati guard bash</span>Mode <code>allow-all</code> menonaktifkan prompt dan sandbox, tetapi <b>gerbang 3 (bash-guard) tetap enforced penuh</b> (<code>permission.ts:check</code> menolak bash berbahaya di semua mode) dan gerbang 1 (jail universal) berlaku untuk semua tool filesystem. Regresinya dijaga <code>bun run gate:bash</code>.</div></div>
893
+ </section>
894
+
895
+ <!-- ── 6 · ENV & PERINTAH ── -->
896
+ <section id="env">
897
+ <h2 class="sec"><span class="hn">06</span> Referensi env var &amp; perintah <a class="anchor" href="#env">#</a></h2>
898
+ <p class="lede">24 variabel <code>MINICODE_*</code> + <code>NO_COLOR</code> yang benar-benar dibaca kode, dengan titik bacanya. Nilai contoh bersifat ilustratif; sumber kebenaran tetap file yang tercantum.</p>
899
+ <div class="tscroll">
900
+ <table>
901
+ <tr><th>Variabel</th><th>Fungsi</th><th>Dibaca di</th></tr>
902
+ <tr><td><code>MINICODE_TIMEOUT_MS</code></td><td>timeout turn: <small>--timeout &gt; env &gt; 15 menit; 0 = tanpa batas</small></td><td><code>cli/setup.ts</code></td></tr>
903
+ <tr><td><code>MINICODE_VERIFY_CMD</code></td><td>perintah verifikasi <code>--verify</code>: <small>env &gt; config &gt; deteksi otomatis</small></td><td><code>cli/setup.ts</code></td></tr>
904
+ <tr><td><code>MINICODE_PLAN</code></td><td><code>1</code> ≡ flag <code>--plan</code></td><td><code>cli/index.ts</code></td></tr>
905
+ <tr><td><code>MINICODE_PERMISSION</code></td><td><code>allowlist</code> → mode izin allowlist</td><td><code>cli/index.ts</code></td></tr>
906
+ <tr><td><code>MINICODE_BASH_ALLOWLIST</code></td><td>daftar allow bash dari env (git/bun/npm aman)</td><td><code>src/policy/permission.ts</code></td></tr>
907
+ <tr><td><code>MINICODE_SANDBOX</code></td><td>mode sandbox: <code>docker</code> / <code>os</code> / <code>none</code></td><td><code>cli/index.ts · cli/commands/exec.ts</code></td></tr>
908
+ <tr><td><code>MINICODE_SANDBOX_IMAGE</code></td><td>image docker (default <code>node:22-alpine</code>)</td><td><code>src/sandbox/docker.ts</code></td></tr>
909
+ <tr><td><code>MINICODE_SANDBOX_MEMORY</code></td><td>batas memori container (default <code>512m</code>)</td><td><code>src/sandbox/docker.ts</code></td></tr>
910
+ <tr><td><code>MINICODE_SANDBOX_STRICT</code></td><td><code>1</code> → tak pernah fallback host (request eksplisit sudah fail-closed secara default)</td><td><code>src/policy/sandbox-policy.ts · src/tools/bash.ts</code></td></tr>
911
+ <tr><td><code>MINICODE_SANDBOX_ALLOW_FALLBACK</code></td><td><code>1</code> → izinkan fallback host secara eksplisit bila backend tak tersedia</td><td><code>src/policy/sandbox-policy.ts · src/tools/bash.ts</code></td></tr>
912
+ <tr><td><code>MINICODE_BUDGET_STRICT</code></td><td><code>1</code> → penegasan eksplisit fail-closed cost-tak-dikenal (kini juga default <code>--budget</code>)</td><td><code>cli/index.ts · cli/repl.ts · cli/commands/exec.ts</code></td></tr>
913
+ <tr><td><code>MINICODE_PROVIDER_ORDER</code></td><td>reorder provider, mis. <code>openai,anthropic,deepseek</code>, tanpa edit config</td><td><code>src/app/provider-layer.ts</code></td></tr>
914
+ <tr><td><code>MINICODE_EMBED_MODEL</code></td><td>model embedding (default <code>text-embedding-3-small</code>)</td><td><code>src/memory/vector.ts</code></td></tr>
915
+ <tr><td><code>MINICODE_GREP_ENGINE</code></td><td><code>js</code> → paksa engine JS, lewati ripgrep</td><td><code>src/tools/grep.ts</code></td></tr>
916
+ <tr><td><code>MINICODE_REPOMAP</code></td><td><code>regex</code> → skip LSP, repo-map pakai regex (lebih cepat)</td><td><code>src/repo/repomap.ts</code></td></tr>
917
+ <tr><td><code>MINICODE_SESSION_TTL_DAYS</code></td><td>retensi sesi (default 30; <code>0</code> = simpan selamanya)</td><td><code>src/session/persistence.ts</code></td></tr>
918
+ <tr><td><code>MINICODE_TELEMETRY</code></td><td><code>0</code>/<code>false</code>/<code>off</code> → tidak menulis trace sama sekali</td><td><code>src/telemetry/trace.ts</code></td></tr>
919
+ <tr><td><code>MINICODE_ASCII</code></td><td><code>1</code> → glyph ASCII, paksa tanpa UTF-8</td><td><code>src/ui/render/theme.ts</code></td></tr>
920
+ <tr><td><code>NO_COLOR</code></td><td>ada &amp; ≠ <code>0</code> → tanpa warna (dihormati lazy)</td><td><code>src/ui/render/theme.ts</code></td></tr>
921
+ <tr><td><code>MINICODE_COMPACT</code></td><td><code>1</code> → tool call satu baris ringkas (default REPL: compact; one-shot/exec/CI: expanded; juga ditulis ulang oleh /compact &amp; Ctrl+O)</td><td><code>src/ui/render/detail.ts</code></td></tr>
922
+ <tr><td><code>MINICODE_JUSTIFY</code></td><td><code>0</code> → matikan perataan dua sisi teks</td><td><code>src/ui/render/wrap.ts</code></td></tr>
923
+ <tr><td><code>MINICODE_SHOW_THINKING</code></td><td><code>1</code> → tampilkan reasoning (via --verbose, env, /thinking, atau Ctrl+T)</td><td><code>src/ui/render/reasoning.ts</code></td></tr>
924
+ <tr><td><code>MINICODE_MINIMIZE_TOOL</code></td><td><code>1</code> → section tool dikecilkan jadi satu baris <code>+ label</code> (default REPL: minimize; tombol + / - saat turn, /expand membuka buffer, /minimize mengecilkan)</td><td><code>src/ui/render/collapse.ts</code></td></tr>
925
+ <tr><td><code>MINICODE_THINKING</code></td><td><code>off</code> → kirim <code>enable_thinking:false</code> ke model OpenAI-compat</td><td><code>vendor/minicore/src/providers/openai-compat.ts</code></td></tr>
926
+ <tr><td><code>MINICODE_HOOKS</code></td><td><code>1</code> → opt-in jalankan hook eksternal</td><td><code>src/hooks/run.ts</code></td></tr>
927
+ <tr><td><code>MINICODE_LIVE</code></td><td><code>1</code> → izinkan test live ber-secrets (di-set oleh <code>bun run test:live</code>)</td><td><code>test/extreme-live.test.ts</code></td></tr>
928
+ </table>
929
+ </div>
930
+ <div class="hint hint-info"><span class="ico"><span class="mi">info</span></span><div class="body">Variabel internal (di-set aplikasi, bukan untuk dikonfigurasikan): <code>MINICODE_HOOK_CTX</code> — payload JSON ke skrip hook (src/hooks/run.ts); <code>MINICODE_RESUME_NEW</code> — tanda sesi resume hasil spawn (cli/commands.ts).</div></div>
931
+
932
+ <h3 class="hsub" id="perintah">Perintah developer</h3>
933
+ <div class="codeblock"><div class="codehead"><span class="fname">terminal — gate &amp; perintah</span><button type="button" data-copy="kod-gate"><span class="mi">content_copy</span><span class="lbl">Salin</span></button></div>
934
+ <pre class="kod" id="kod-gate">bun run dev # jalankan dari sumber (bun cli/index.ts) — tanpa build step
935
+ bun x tsc --noEmit # typecheck
936
+ bun run lint # biome check src cli test bench scripts
937
+ bun test # seluruh suite (termasuk penjaga batas lapisan)
938
+ bun run gate:coverage # ambang: lines 84% · funcs 80% (scripts/coverage-gate.ts)
939
+ bun run gate:pack # verifikasi isi paket npm
940
+ bun run gate:bash # probe bypass bash-guard (mode normal + allowlist)
941
+ bun run vendor:check # vendor/minicore masih sesuai pin?
942
+ bun run test:live # test live (butuh secrets, set MINICODE_LIVE=1)
943
+ bun run bench # benchmark loop agen</pre></div>
944
+ <div class="hint hint-ok"><span class="ico"><span class="mi">check_circle</span></span><div class="body"><span class="title">Gate sebelum menyatakan selesai</span>(satu baris, dari AGENTS.md): <code>bun x tsc --noEmit &amp;&amp; bun run lint &amp;&amp; bun test &amp;&amp; bun run gate:coverage &amp;&amp; bun run gate:pack</code></div></div>
945
+ </section>
946
+
947
+ <!-- ── 7 · PERSISTENSI ── -->
948
+ <section id="persistensi">
949
+ <h2 class="sec"><span class="hn">07</span> Lokasi data persisten <a class="anchor" href="#persistensi">#</a></h2>
950
+ <p class="lede">Semua state di luar repo user; path proyek selalu relatif terhadap cwd.</p>
951
+ <div class="tscroll">
952
+ <table>
953
+ <tr><th>Data</th><th>Lokasi</th><th>Format</th></tr>
954
+ <tr><td>Konfigurasi global</td><td><code>~/.minicode/config.json</code></td><td>JSON (providers, MCP, LSP)</td></tr>
955
+ <tr><td>Konfigurasi proyek</td><td><code>.minicode/config.json</code></td><td>JSON — merge per-key dengan global</td></tr>
956
+ <tr><td>Sesi</td><td><code>~/.minicode/sessions.sqlite</code></td><td>sqlite WAL, append inkremental, TTL 30 hari</td></tr>
957
+ <tr><td>Checkpoint</td><td><code>.minicode/checkpoints/</code> + <code>refs/minicode/*</code></td><td>Manifes JSON (maks 20) + SHA tree shadow-git</td></tr>
958
+ <tr><td>Todo per sesi</td><td><code>.minicode/todos/&lt;sessionId&gt;.json</code></td><td>JSON (src/tools/todo.ts)</td></tr>
959
+ <tr><td>Trace provider</td><td><code>~/.minicode/traces/</code></td><td>JSONL per request</td></tr>
960
+ <tr><td>History input</td><td><code>~/.minicode/history</code></td><td>Teks</td></tr>
961
+ <tr><td>Allowlist hook</td><td><code>~/.minicode/allowlist.json</code> (global) + <code>.minicode/allowlist.json</code> (proyek)</td><td>JSON — lokal melengkapi global</td></tr>
962
+ </table>
963
+ </div>
964
+ </section>
965
+
966
+ <!-- ── 8 · INVARIAN ── -->
967
+ <section id="invarian">
968
+ <h2 class="sec"><span class="hn">08</span> Invarian struktural <a class="anchor" href="#invarian">#</a></h2>
969
+ <p class="lede">Aturan tak tertulis yang kalau dilanggar menghasilkan bug yang sudah pernah terjadi di repo ini.</p>
970
+ <ul class="plain">
971
+ <li><b>Bun-only, zero runtime deps.</b> <code>bin</code> menunjuk langsung <code>cli/index.ts</code>; tidak ada build step. <code>dependencies</code> package.json kosong dan harus tetap kosong.</li>
972
+ <li><b>Kernel beku.</b> <code>vendor/minicore</code> hanya berubah lewat seam aditif + <code>bun run vendor:minicore</code>; aplikasi tidak pernah menulis ke dalam vendor.</li>
973
+ <li><b>Batas lapisan itu kode, bukan harapan.</b> Matriks §1 dieksekusi sebagai test (<code>test/ui-boundary.test.ts</code>) — tambah modul baru berarti periksa ulang arahnya.</li>
974
+ <li><b>Teks tak terpercaya → sanitizeAnsi.</b> Output model, hasil tool, dan isi berkas wajib disanitasi sebelum render; tanpa itu model bisa membersihkan layar atau keluar alternate screen.</li>
975
+ <li><b>Lebar diukur dalam kolom.</b> Pakai <code>displayWidth</code>/<code>truncateToWidth</code>/<code>padToWidth</code> (<code>src/ui/render/width.ts</code>), bukan <code>.length</code>/<code>.slice()</code> — CJK &amp; emoji 2 kolom.</li>
976
+ <li><b><code>c</code> &amp; <code>glyphs</code> adalah getter</b> di <code>src/ui/render/theme.ts</code> yang membaca state runtime (dukungan UTF-8, NO_COLOR; palet tunggal sejak fitur tema dihapus). Menyimpannya ke const module scope membekukan nilai saat import — jebakan yang sudah tiga kali terulang.</li>
977
+ <li><b>Flag tak dikenal = kata prompt.</b> <code>cli/args.ts</code> hanya mengenali whitelist flag; <code>--typo</code> tidak error tetapi ikut masuk teks prompt (args.ts:62). Tambah flag baru = daftarkan di whitelist.</li>
978
+ <li><b>Jail mendahului segala mode.</b> Tidak ada jalur eksekusi tool yang boleh mem-bypass <code>src/policy/jail.ts</code>, termasuk allow-all dan tool MCP.</li>
979
+ <li><b>Tool tidak mengimpor lapisan app/sesi.</b> Kebutuhan lintas-lapisan (mis. sesi sub-agen untuk <code>delegate_task</code>) disuntikkan dari composition root via setter DI; tanpa injeksi tool fail-closed. Arah <code>providers → config</code> juga satu arah sejak provisioning dipisah ke <code>providers/provision.ts</code>.</li>
980
+ <li><b>Output shell-first.</b> Tidak ada alternate screen (?1049h), tidak ada redraw penuh, tidak ada modal overlay: output mengalir append-only ke scrollback dan scrollback adalah satu-satunya transcript. Tool call compact di REPL (satu baris <code>› nama target</code>); section besar default minimize (<code>+ label</code>, dibuka via + / - atau /expand); expanded tersedia via env/<code>/compact</code>/verbose. UI ekran (manager/wizard/picker) transient — menghapus diri sendiri, tidak menyentuh scrollback.</li>
981
+ <li><b>Kontrak terminal FROZEN.</b> <code>docs/TERMINAL_CONTRACT.md</code> membekukan klasifikasi writer, contract stdout/stderr, dan 14 invariant terminal (§9) — wajib dibaca sebelum menyentuh output/rendering; setiap perubahan perilaku wajib update dokumen + test peta proteksinya.</li>
982
+ <li><b>Satu arbitrase transient.</b> Semua painter stderr (garis turn, wizard spinner) lewat <code>acquireTransientPaint</code>/<code>paintWrite</code> di <code>src/ui/runtime/statusline.ts</code>; tulis asing non-UI saat painter aktif dikomit sebagai baris permanen — tidak hilang, tidak merusak transient.</li>
983
+ <li><b>Non-TTY = polos.</b> Pipe/redirect/CI tidak boleh mengandung cursor control, animasi, atau warna (warna digate <code>stdout.isTTY</code>; NO_COLOR menang).</li>
984
+ <li><b>Peta ini harus hidup.</b> Setiap perubahan struktur (tambah/hapus/pindah modul atau lapisan) WAJIB memperbarui <code>docs/ARCHITECTURE.html</code> dalam perubahan yang sama — lihat AGENTS.md.</li>
985
+ </ul>
986
+ </section>
987
+
988
+ <!-- ── 9 · UI/UX UNTUK DEVELOPER ── -->
989
+ <section id="ux">
990
+ <h2 class="sec"><span class="hn">09</span> UI/UX untuk developer — rendering terminal <a class="anchor" href="#ux">#</a></h2>
991
+ <p class="lede">Ringkasan kontrak output yang menjaga MiniCode tetap shell-native: lima primitif tampilan, dua stream dengan peran tetap, satu arbitrase transient. Versi lengkap + residual risk yang disengaja ada di <code>docs/TERMINAL_CONTRACT.md</code> (FROZEN); panduan pengguna di <code>docs/USAGE.md</code>.</p>
992
+
993
+ <div class="uxgrid">
994
+ <div class="uxcard"><h4>1 · Prompt</h4><p><code>minicode &lt;mode&gt; ›</code> — baris input interaktif + dropdown slash; satu-satunya elemen “hidup” saat idle.</p></div>
995
+ <div class="uxcard"><h4>2 · Pesan model</h4><p>Streaming ke <b>stdout</b>, di-sanitasi, dibungkus per baris mengikuti kolom terminal; fence markdown indent 2 spasi.</p></div>
996
+ <div class="uxcard"><h4>3 · Aktivitas</h4><p>Garis transient di <b>stderr</b> (TTY saja): <code>✦···</code> kelip putih↔abu saat thinking, atau <code>frame label···</code> selama tool berjalan. Hilang saat teks mengalir.</p></div>
997
+ <div class="uxcard"><h4>4 · Hasil tool</h4><p>Ledger stderr, compact: <code>› nama target</code> satu baris (hijau; tanpa bocor isi file); error <code>› nama: pesan</code> (merah). Section besar default minimize (<code>+ label</code>); expanded/verbose menampilkan isi.</p></div>
998
+ <div class="uxcard"><h4>5 · Error</h4><p><code>✗ pesan actionable</code> — sekali per kegagalan via <code>takePendingError()</code>; tidak pernah dump JSON/stack ke user.</p></div>
999
+ <div class="uxcard"><h4>Stream contract</h4><p>stdout = output program (teks model, receipt). stderr = progress/diagnostik. Non-TTY: 0 ANSI, 0 spinner, 0 cursor control.</p></div>
1000
+ </div>
1001
+
1002
+ <p class="lede" style="margin-top:22px">Transient rendering memiliki <b>satu ownership mechanism</b> (<code>src/ui/runtime/statusline.ts</code>):</p>
1003
+ <div class="uxgrid">
1004
+ <div class="uxcard"><h4>Ownership</h4><p>Painter garis turn (<code>turn</code>) dan wizard spinner (<code>spinner</code>) klaim via <code>acquireTransientPaint(kind)</code>; semua tulis painter lewat <code>paintWrite</code>.</p></div>
1005
+ <div class="uxcard"><h4>Foreign writers</h4><p>Diagnostik non-UI (router/providers/tool warnings) boleh menulis mentah ke stderr — arbitrator mengkomitnya sebagai baris permanen saat painter aktif.</p></div>
1006
+ <div class="uxcard"><h4>Lifecycle tertutup</h4><p>Garis tidak pernah stale: <code>endTurn()</code> dipanggil driver setelah setiap <code>session.run</code> settle (kernel hanya emit <code>turn:completed</code> di jalur sukses).</p></div>
1007
+ <div class="uxcard"><h4>Mutual exclusion</h4><p>Painter vs spinner secara desain disjoint; overlap memicu signal <code>[transient-paint] …</code> sekali per pasangan (bukan crash).</p></div>
1008
+ </div>
1009
+
1010
+ <div class="tscroll" style="margin-top:16px">
1011
+ <table>
1012
+ <tr><th>#</th><th>Invariant (ringkas)</th><th>Dijaga oleh test</th></tr>
1013
+ <tr><td>1</td><td>Shell-native CLI — bukan TUI (tanpa alternate screen/panel)</td><td><code>ui-boundary</code></td></tr>
1014
+ <tr><td>2</td><td>Contract stdout/stderr jelas (TTY &amp; non-TTY deterministic)</td><td><code>tui-format</code>, <code>terminal-contract</code></td></tr>
1015
+ <tr><td>3</td><td>Transient rendering satu ownership mechanism</td><td><code>terminal-contract</code>, <code>transient-arbitration</code></td></tr>
1016
+ <tr><td>4</td><td>Scrollback permanen tidak bergantung pada transient painter</td><td><code>transient-arbitration</code></td></tr>
1017
+ <tr><td>5</td><td>Tanpa transient stale: success/failure/cancel/SIGINT/retry/detach/session-end</td><td><code>turn-status</code>, <code>terminal-contract</code>, <code>repl-linear</code></td></tr>
1018
+ <tr><td>6</td><td>Non-TTY: 0 cursor control / animasi / ANSI tak diperlukan</td><td><code>transient-arbitration</code>, <code>theme</code></td></tr>
1019
+ <tr><td>7</td><td>Tool activity default compact, tanpa bocor isi ke ledger</td><td><code>tui-format</code>, <code>terminal-contract</code></td></tr>
1020
+ <tr><td>8</td><td>Streaming tanpa duplicate/overlap/stale spinner-status</td><td><code>tui-format</code>, <code>terminal-contract</code></td></tr>
1021
+ <tr><td>9</td><td>Foreign stderr writers aman oleh arbitrator terminal</td><td><code>transient-arbitration</code>, <code>terminal-contract</code></td></tr>
1022
+ <tr><td>10</td><td>Painter &amp; spinner mutually exclusive (signal overlap)</td><td><code>transient-arbitration</code>, <code>terminal-contract</code></td></tr>
1023
+ <tr><td>11</td><td>Resize memakai lebar saat paint (bukan lebar lama)</td><td><code>turn-status</code></td></tr>
1024
+ <tr><td>12</td><td>Long session tetap readable (ledger satu baris per tool)</td><td><code>terminal-contract</code></td></tr>
1025
+ <tr><td>13</td><td>Footer lengket satu-satunya chrome permanen (sticky 2 baris, reset region di semua jalur keluar, non-TTY nol byte)</td><td><code>footer-render</code>, <code>footer-chrome</code></td></tr>
1026
+ <tr><td>14</td><td>Idle binding: Esc/Ctrl+C/Ctrl+D resolve null; Ctrl+C 1x = copy, 2x = keluar; abort turn via lone Esc/Ctrl+C</td><td><code>repl-linear</code>, <code>terminal-contract</code></td></tr>
1027
+ </table>
1028
+ </div>
1029
+
1030
+ <div class="hint hint-warn"><span class="ico"><span class="mi">warning</span></span><div class="body"><span class="title">Residual risk yang disengaja</span>Jangan “perbaiki” tanpa keputusan — detail di TERMINAL_CONTRACT.md: foreign partial write tanpa newline tidak dipaksa line-oriented; overlap painter/spinner adalah signal yang harus tetap observable; flake TTY-harness lama dicatat terpisah dari regresi.</div></div>
1031
+ </section>
1032
+
1033
+ <!-- ── Navigasi bawah ── -->
1034
+ <nav class="pagenav" aria-label="Navigasi halaman">
1035
+ <a href="#sekilas"><span>← Sebelumnya</span><b>Sekilas — satu diagram</b></a>
1036
+ <a class="next" href="TERMINAL_CONTRACT.md"><span>Berikutnya →</span><b>TERMINAL_CONTRACT (frozen)</b></a>
1037
+ </nav>
1038
+
1039
+ <footer class="site">
1040
+ <span>Minicode · Peta struktur hidup — terminal contract FROZEN (<a href="TERMINAL_CONTRACT.md">docs/TERMINAL_CONTRACT.md</a>)</span>
1041
+ <span class="spacer"></span>
1042
+ <span>v0.9.24 · diperbarui 2026-09-17</span>
1043
+ </footer>
1044
+
1045
+ </div>
1046
+ </main>
1047
+
1048
+ <!-- ══════════ TOC KANAN ══════════ -->
1049
+ <aside class="toc" aria-label="Pada halaman ini">
1050
+ <div class="tlabel">Pada halaman ini</div>
1051
+ <a href="#sekilas">Sekilas</a>
1052
+ <a href="#batas">01 · Lapisan &amp; batas</a>
1053
+ <a href="#alur">02 · Alur prompt</a>
1054
+ <a href="#pohon">03 · Modul &amp; ekspor</a>
1055
+ <a class="sub" href="#g-cli">cli/</a>
1056
+ <a class="sub" href="#g-app">src/app/</a>
1057
+ <a class="sub" href="#g-policy">src/policy/</a>
1058
+ <a class="sub" href="#g-tools">src/tools/</a>
1059
+ <a class="sub" href="#g-providers">src/providers/</a>
1060
+ <a class="sub" href="#g-session">src/session/</a>
1061
+ <a class="sub" href="#g-ui">src/ui/</a>
1062
+ <a class="sub" href="#g-lain">src/ lainnya</a>
1063
+ <a class="sub" href="#g-kernel">vendor/minicore/</a>
1064
+ <a class="sub" href="#g-quality">test · scripts · bench</a>
1065
+ <a href="#resep">04 · Resep ekstensi</a>
1066
+ <a href="#keamanan">05 · Rantai keamanan</a>
1067
+ <a href="#env">06 · Env &amp; perintah</a>
1068
+ <a href="#persistensi">07 · Data persisten</a>
1069
+ <a href="#invarian">08 · Invarian</a>
1070
+ <a href="#ux">09 · UI/UX terminal</a>
1071
+ </aside>
1072
+ </div>
1073
+
1074
+ <script>
1075
+ // Tema: hormati pilihan tersimpan, fallback ke preferensi OS.
1076
+ (function initTheme() {
1077
+ try {
1078
+ var saved = localStorage.getItem("minicode-theme");
1079
+ if (saved === "light" || saved === "dark") {
1080
+ document.documentElement.dataset.theme = saved;
1081
+ } else if (window.matchMedia && window.matchMedia("(prefers-color-scheme: dark)").matches) {
1082
+ document.documentElement.dataset.theme = "dark";
1083
+ }
1084
+ } catch (e) { /* storage tak tersedia — pakai default terang */ }
1085
+ })();
1086
+ var themeBtn = document.getElementById("themeBtn");
1087
+ function paintThemeIcon() {
1088
+ var ico = themeBtn.querySelector(".mi");
1089
+ if (ico) ico.textContent = document.documentElement.dataset.theme === "dark" ? "light_mode" : "dark_mode";
1090
+ }
1091
+ paintThemeIcon();
1092
+ themeBtn.addEventListener("click", function () {
1093
+ var root = document.documentElement;
1094
+ root.dataset.theme = root.dataset.theme === "dark" ? "light" : "dark";
1095
+ try { localStorage.setItem("minicode-theme", root.dataset.theme); } catch (e) {}
1096
+ paintThemeIcon();
1097
+ });
1098
+
1099
+ // Bila font ikon gagal dimuat (offline/CDN diblokir), sembunyikan ikon — semuanya dekoratif.
1100
+ (function guardIcons() {
1101
+ function noMi() { document.body.classList.add("no-mi"); }
1102
+ try {
1103
+ if (!document.fonts || !document.fonts.load) return;
1104
+ var timer = setTimeout(noMi, 3000);
1105
+ document.fonts.load('16px "Material Symbols Outlined"', "search").then(function () {
1106
+ clearTimeout(timer);
1107
+ if (!document.fonts.check('16px "Material Symbols Outlined"', "search")) noMi();
1108
+ }, function () { clearTimeout(timer); noMi(); });
1109
+ } catch (e) {}
1110
+ })();
1111
+
1112
+ // Drawer mobile.
1113
+ var burger = document.getElementById("burger");
1114
+ burger.addEventListener("click", function () { document.body.classList.toggle("nav-open"); });
1115
+ document.getElementById("backdrop").addEventListener("click", function () { document.body.classList.remove("nav-open"); });
1116
+ document.querySelectorAll(".sidebar .snav").forEach(function (a) {
1117
+ a.addEventListener("click", function () { document.body.classList.remove("nav-open"); });
1118
+ });
1119
+
1120
+ // Pencarian: satu input menyaring nav + kartu modul (sampai nama simbol).
1121
+ var filter = document.getElementById("filter");
1122
+ var groups = Array.prototype.slice.call(document.querySelectorAll("details.group"));
1123
+ var emptyNote = document.getElementById("emptyNote");
1124
+ function focusSearch() { filter.focus(); filter.select(); }
1125
+ document.getElementById("searchPill").addEventListener("click", focusSearch);
1126
+ document.getElementById("searchPill").addEventListener("keydown", function (e) {
1127
+ if (e.key === "Enter" || e.key === " ") { e.preventDefault(); focusSearch(); }
1128
+ });
1129
+ document.addEventListener("keydown", function (e) {
1130
+ var mod = e.ctrlKey || e.metaKey;
1131
+ if ((mod && e.key.toLowerCase() === "k") || (e.key === "/" && document.activeElement !== filter && !/INPUT|TEXTAREA/.test(document.activeElement.tagName))) {
1132
+ e.preventDefault(); focusSearch();
1133
+ }
1134
+ if (e.key === "Escape" && document.activeElement === filter) { filter.value = ""; applyFilter(""); filter.blur(); }
1135
+ });
1136
+ function applyFilter(raw) {
1137
+ var q = raw.trim().toLowerCase();
1138
+ var anyGroup = false;
1139
+ groups.forEach(function (g) {
1140
+ var any = false;
1141
+ g.querySelectorAll(".mod").forEach(function (m) {
1142
+ var hit = !q || m.textContent.toLowerCase().indexOf(q) !== -1;
1143
+ m.hidden = !hit;
1144
+ if (hit) any = true;
1145
+ });
1146
+ var selfHit = !q || (g.querySelector("summary") && g.querySelector("summary").textContent.toLowerCase().indexOf(q) !== -1);
1147
+ var show = !q || any || selfHit;
1148
+ g.hidden = !show;
1149
+ if (show) anyGroup = true;
1150
+ if (q && any) g.open = true;
1151
+ });
1152
+ // Saring juga link sidebar agar tetap relevan.
1153
+ document.querySelectorAll(".sidebar .snav, .toc a").forEach(function (a) {
1154
+ if (!q) { a.hidden = false; return; }
1155
+ var target = a.hash ? document.querySelector(a.hash) : null;
1156
+ var hay = (a.textContent + " " + (target ? target.textContent : "")).toLowerCase();
1157
+ a.hidden = hay.indexOf(q) === -1;
1158
+ });
1159
+ emptyNote.classList.toggle("show", q !== "" && !anyGroup);
1160
+ }
1161
+ filter.addEventListener("input", function () { applyFilter(filter.value); });
1162
+
1163
+ // Buka/tutup semua kelompok modul.
1164
+ document.getElementById("openAll").addEventListener("click", function () { groups.forEach(function (g) { g.hidden = false; g.open = true; }); });
1165
+ document.getElementById("closeAll").addEventListener("click", function () { groups.forEach(function (g) { g.open = false; }); });
1166
+
1167
+ // Scrollspy: sorot nav kiri + TOC kanan mengikuti section terlihat.
1168
+ var navLinks = Array.prototype.slice.call(document.querySelectorAll(".sidebar .snav[href^='#'], .toc a[href^='#']"));
1169
+ var spyTargets = ["sekilas", "batas", "alur", "pohon", "resep", "keamanan", "env", "persistensi", "invarian", "ux"]
1170
+ .map(function (id) { return document.getElementById(id); })
1171
+ .filter(Boolean);
1172
+ var spy = new IntersectionObserver(function (entries) {
1173
+ entries.forEach(function (e) {
1174
+ if (!e.isIntersecting) return;
1175
+ navLinks.forEach(function (a) { a.classList.toggle("active", a.hash === "#" + e.target.id); });
1176
+ });
1177
+ }, { rootMargin: "-15% 0px -65% 0px" });
1178
+ spyTargets.forEach(function (s) { spy.observe(s); });
1179
+
1180
+ // Link pohon di sidebar: buka kelompok target lalu kedipkan.
1181
+ document.querySelectorAll(".sidebar .snav.sub").forEach(function (a) {
1182
+ a.addEventListener("click", function () {
1183
+ var t = document.querySelector(a.hash);
1184
+ if (!t) return;
1185
+ t.open = true; t.hidden = false;
1186
+ t.classList.add("flash");
1187
+ setTimeout(function () { t.classList.remove("flash"); }, 900);
1188
+ });
1189
+ });
1190
+
1191
+ // Tombol salin pada blok kode (pakai execCommand fallback agar file:// tetap jalan).
1192
+ document.querySelectorAll("[data-copy]").forEach(function (btn) {
1193
+ btn.addEventListener("click", function () {
1194
+ var pre = document.getElementById(btn.getAttribute("data-copy"));
1195
+ if (!pre) return;
1196
+ var lbl = btn.querySelector(".lbl");
1197
+ var ico = btn.querySelector(".mi");
1198
+ var done = function () {
1199
+ if (lbl) lbl.textContent = "Disalin";
1200
+ if (ico) ico.textContent = "check";
1201
+ setTimeout(function () {
1202
+ if (lbl) lbl.textContent = "Salin";
1203
+ if (ico) ico.textContent = "content_copy";
1204
+ }, 1200);
1205
+ };
1206
+ if (navigator.clipboard && navigator.clipboard.writeText) {
1207
+ navigator.clipboard.writeText(pre.innerText).then(done, function () { fallback(); });
1208
+ } else { fallback(); }
1209
+ function fallback() {
1210
+ var r = document.createRange(); r.selectNodeContents(pre);
1211
+ var s = window.getSelection(); s.removeAllRanges(); s.addRange(r);
1212
+ try { document.execCommand("copy"); done(); } catch (e) {}
1213
+ s.removeAllRanges();
1214
+ }
1215
+ });
1216
+ });
1217
+
1218
+ // Cetak: buka semua kelompok agar isi lengkap ikut tercetak.
1219
+ window.addEventListener("beforeprint", function () { groups.forEach(function (g) { g.hidden = false; g.open = true; }); });
1220
+ </script>
1221
+ </body>
1222
+ </html>