pantheon-opencode 2.0.0-beta.1 → 2.0.0-beta.2

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.
@@ -5,124 +5,329 @@
5
5
  /**
6
6
  * pantheon-settings.tsx — the /pantheon-settings window.
7
7
  *
8
- * Three pages (Gates / Overrides+About), keyboard-first: `up`/`down` select,
9
- * `enter`/`space` toggles the selected behavior (writes the GLOBAL overrides
10
- * file — the same one the installer and doctor consume), `tab` flips pages,
11
- * `escape`/`q` closes. The gated-layer pattern mirrors the dispatch panel and
12
- * whats-new windows. Every failure path is silent (fail-open).
8
+ * One section per page, keyboard-first: `tab` cycles sections, `up`/`down`
9
+ * select, `enter`/`space` dispatches the selected row (the Gates section
10
+ * writes the GLOBAL overrides file — the same one the installer and doctor
11
+ * consume; Updates runs a registry check). `escape`/`q` closes. The
12
+ * gated-layer pattern mirrors the dispatch panel and whats-new windows.
13
+ * Every failure path is silent (fail-open).
13
14
  */
14
- import { readFileSync, writeFileSync } from 'node:fs'
15
- import { homedir, join } from 'node:path'
15
+ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
16
+ import { join } from 'node:path'
16
17
  import type { Context } from '@opencode/plugin/tui/context'
17
18
  import { createSignal, For, Show } from 'solid-js'
18
19
  import {
20
+ buildDecisionSection,
21
+ readDecisionRouterConfig,
22
+ setDecisionEnabled,
23
+ writeDecisionRouterConfig,
24
+ } from './decision-router-state.ts'
25
+ import { buildDoctorSection } from './doctor-state.ts'
26
+ import { buildJ1Section } from './j1-gate-status.ts'
27
+ import {
28
+ buildAboutSection,
29
+ buildGatesSection,
30
+ canWriteOverrides,
19
31
  type EffectiveOverrides,
32
+ firstSelectableId,
33
+ flatSelectableRows,
20
34
  isBehaviorDisabled,
21
- SETTINGS_BEHAVIORS,
35
+ mergedOverrides,
36
+ type OverridesLoad,
22
37
  type SettingsRow,
38
+ type SettingsSection,
23
39
  serializeOverrides,
24
40
  toggledOverrides,
25
41
  } from './pantheon-settings-state.ts'
42
+ import {
43
+ buildPresetSection,
44
+ clearActivePreset,
45
+ globalActivePresetPath,
46
+ projectActivePresetPath,
47
+ readActivePresetMarker,
48
+ writeActivePreset,
49
+ } from './preset-state.ts'
50
+ import { nextCheckState, type UpdateCheckState } from './update-notice.ts'
51
+ import {
52
+ buildUpdatesSection,
53
+ registryUrlForChannel,
54
+ type UpdatesSectionInput,
55
+ updateChannelFor,
56
+ } from './update-status.ts'
26
57
 
27
58
  function globalOverridesPath(): string {
28
59
  const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(process.env.HOME ?? '', '.config')
29
60
  return join(xdgConfig, 'opencode', 'pantheon-overrides.json')
30
61
  }
31
62
 
32
- function readOverridesFromDisk(): EffectiveOverrides {
63
+ function projectOverridesPath(): string {
64
+ return join(process.cwd(), '.pantheon', 'overrides.json')
65
+ }
66
+
67
+ /** Read one overrides file; a missing file is empty, an unreadable one is corrupt. */
68
+ function readOneOverrides(path: string): { value: EffectiveOverrides; corrupt: boolean } {
69
+ try {
70
+ const parsed: unknown = JSON.parse(readFileSync(path, 'utf8'))
71
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
72
+ return { value: {}, corrupt: true }
73
+ }
74
+ return { value: parsed as EffectiveOverrides, corrupt: false }
75
+ } catch (error) {
76
+ return { value: {}, corrupt: (error as NodeJS.ErrnoException)?.code !== 'ENOENT' }
77
+ }
78
+ }
79
+
80
+ function readOverridesLoad(): OverridesLoad {
81
+ const globalRead = readOneOverrides(globalOverridesPath())
82
+ const projectRead = readOneOverrides(projectOverridesPath())
83
+ return {
84
+ global: globalRead.value,
85
+ project: projectRead.value,
86
+ corruptGlobal: globalRead.corrupt,
87
+ }
88
+ }
89
+
90
+ function writeOverridesToDisk(load: OverridesLoad): void {
91
+ writeFileSync(globalOverridesPath(), serializeOverrides(load.global), 'utf8')
92
+ }
93
+
94
+ function updateCheckStatePath(): string {
95
+ const stateDir = process.env.XDG_STATE_HOME ?? join(process.env.HOME ?? '', '.local', 'state')
96
+ return join(stateDir, 'pantheon', 'update-check.json')
97
+ }
98
+
99
+ function readUpdateCheckState(): UpdateCheckState {
33
100
  try {
34
- return JSON.parse(readFileSync(globalOverridesPath(), 'utf8')) as EffectiveOverrides
101
+ return JSON.parse(readFileSync(updateCheckStatePath(), 'utf8')) as UpdateCheckState
35
102
  } catch {
36
103
  return {}
37
104
  }
38
105
  }
39
106
 
40
- function writeOverridesToDisk(effective: EffectiveOverrides): void {
41
- writeFileSync(globalOverridesPath(), serializeOverrides(effective), 'utf8')
107
+ /**
108
+ * Registry check for the RUNNING version's channel (beta installs ask the
109
+ * beta dist-tag). Resolves with the latest version seen, or null offline.
110
+ */
111
+ async function fetchLatestForChannel(currentVersion: string): Promise<string | null> {
112
+ try {
113
+ const response = await fetch(registryUrlForChannel(updateChannelFor(currentVersion)), {
114
+ signal: AbortSignal.timeout(5000),
115
+ })
116
+ const latest = String(((await response.json()) as { version?: unknown })?.version ?? '')
117
+ return latest || null
118
+ } catch {
119
+ return null
120
+ }
42
121
  }
43
122
 
44
- /** Rows shown on the Gates page: behavior state from the overrides file. */
45
- export function buildSettingsRows(effective: EffectiveOverrides): SettingsRow[] {
46
- return SETTINGS_BEHAVIORS.map((behavior) => ({
47
- id: behavior.id,
48
- title: behavior.title,
49
- description: behavior.description,
50
- disabled: isBehaviorDisabled(effective, behavior.id),
51
- }))
123
+ function persistUpdateCheckState(previous: UpdateCheckState, latest: string | null): void {
124
+ try {
125
+ const path = updateCheckStatePath()
126
+ mkdirSync(join(path, '..'), { recursive: true })
127
+ writeFileSync(
128
+ path,
129
+ `${JSON.stringify(nextCheckState(previous, latest ? { version: latest, message: '' } : null, Date.now()), null, 2)}\n`,
130
+ )
131
+ } catch {
132
+ /* state is a cache — never block on it */
133
+ }
134
+ }
135
+
136
+ function resolveRunningVersion(): string {
137
+ try {
138
+ const manifest = JSON.parse(
139
+ readFileSync(new URL('../../package.json', import.meta.url), 'utf8'),
140
+ ) as { version?: string }
141
+ return manifest.version ?? 'unknown'
142
+ } catch {
143
+ return 'unknown'
144
+ }
52
145
  }
53
146
 
54
147
  export function SettingsContent(props: {
55
- rows: () => SettingsRow[]
56
- selected: () => number
148
+ sections: () => SettingsSection[]
57
149
  page: () => number
58
- version: () => string
59
- about: () => string[]
150
+ selectedId: () => string | undefined
60
151
  fg?: any
61
152
  muted?: any
62
153
  }) {
63
- const marker = (row: SettingsRow) => (row.disabled ? '[x]' : '[ ]')
154
+ const section = () =>
155
+ props.sections()[props.page()] ?? {
156
+ id: 'empty',
157
+ title: '',
158
+ rows: [],
159
+ }
64
160
  return (
65
161
  <box flexDirection="column" paddingLeft={1} paddingRight={1} paddingTop={1}>
66
- <Show
67
- when={props.page() === 0}
68
- fallback={
69
- <box flexDirection="column">
70
- <text attributes={1} fg={props.fg}>
71
- About
72
- </text>
73
- <text fg={props.muted}>{'─'.repeat(38)}</text>
74
- <For each={props.about()}>{(line: string) => <text fg={props.muted}>{line}</text>}</For>
75
- </box>
76
- }
77
- >
78
- <text attributes={1} fg={props.fg}>
79
- Gates &amp; Overrides
80
- </text>
81
- <text fg={props.muted}>{'─'.repeat(38)}</text>
82
- <For each={props.rows()}>
83
- {(row: SettingsRow, index: () => number) => (
162
+ <text attributes={1} fg={props.fg}>
163
+ {section().title}
164
+ </text>
165
+ <text fg={props.muted}>{'─'.repeat(38)}</text>
166
+ <For each={section().rows}>
167
+ {(row: SettingsRow) => {
168
+ const isSelected = () => row.selectable !== false && row.id === props.selectedId()
169
+ const marker = () => row.marker ?? (row.disabled ? '[x]' : '[ ]')
170
+ return (
84
171
  <box flexDirection="column">
85
172
  <text
86
- fg={props.selected() === index() ? props.fg : props.muted}
87
- attributes={props.selected() === index() ? 1 : undefined}
173
+ fg={isSelected() ? props.fg : props.muted}
174
+ {...(isSelected() ? { attributes: 1 } : {})}
88
175
  >
89
- {`${marker(row)} ${row.title}${props.selected() === index() ? ' <-' : ''}`}
176
+ {`${marker()} ${row.title}${isSelected() ? ' <-' : ''}`}
90
177
  </text>
91
- <text fg={props.muted}>{` ${row.description}`}</text>
178
+ <Show when={row.description !== ''}>
179
+ <text fg={props.muted}>{` ${row.description}`}</text>
180
+ </Show>
92
181
  </box>
93
- )}
94
- </For>
95
- <box height={1} />
96
- <text fg={props.muted}>
97
- {'enter: disable/enable · writes pantheon-overrides.json (global)'}
98
- </text>
99
- </Show>
182
+ )
183
+ }}
184
+ </For>
100
185
  <box height={1} />
186
+ <Show when={section().hint !== undefined}>
187
+ <text fg={props.muted}>{section().hint}</text>
188
+ </Show>
101
189
  <text fg={props.muted}>
102
- {`${props.page() + 1}/2 · `}tab: page · up/down: select · enter: toggle · esc/q: close
190
+ {`${props.page() + 1}/${props.sections().length} · `}tab: section · up/down: select · enter:
191
+ apply · esc/q: close
103
192
  </text>
104
193
  </box>
105
194
  )
106
195
  }
107
196
 
108
197
  /**
109
- * Entry glue: read the overrides state, then show the window through the host
110
- * dialog stack once. The gated keymap layer is inert while the window is
111
- * closed. Never throws.
198
+ * Entry glue: read both overrides files, then show the window through the
199
+ * host dialog stack once. The gated keymap layer is inert while the window
200
+ * is closed. Never throws.
112
201
  */
113
202
  export async function maybeShowPantheonSettings(context: Context): Promise<void> {
114
203
  try {
115
204
  const [open, setOpen] = createSignal(false)
116
205
  const [page, setPage] = createSignal(0)
117
- const [selected, setSelected] = createSignal(0)
118
- const [effective, setEffective] = createSignal<EffectiveOverrides>(readOverridesFromDisk())
119
-
120
- const rows = () => buildSettingsRows(effective())
121
- const about = () => [
122
- `Pantheon v${resolveRunningVersion()}`,
123
- `${SETTINGS_BEHAVIORS.length} togglable behaviors · OpenCode 2.x only`,
124
- 'Docs: docs/design/2.0-settings-and-install.md',
206
+ const [load, setLoad] = createSignal<OverridesLoad>(readOverridesLoad())
207
+ const [lastChecked, setLastChecked] = createSignal<string | undefined>(undefined)
208
+ const [checking, setChecking] = createSignal(false)
209
+ const [decision, setDecision] = createSignal(readDecisionRouterConfig())
210
+ const [presetTick, setPresetTick] = createSignal(0)
211
+
212
+ const currentVersion = resolveRunningVersion()
213
+
214
+ const updatesInput = (): UpdatesSectionInput => {
215
+ const input: UpdatesSectionInput = {
216
+ currentVersion,
217
+ state: readUpdateCheckState(),
218
+ checking: checking(),
219
+ nowMs: Date.now(),
220
+ }
221
+ const seen = lastChecked()
222
+ if (seen !== undefined) input.lastCheckedVersion = seen
223
+ return input
224
+ }
225
+
226
+ const presetInput = () => {
227
+ void presetTick()
228
+ return {
229
+ globalName: readActivePresetMarker(globalActivePresetPath())?.name ?? null,
230
+ projectName: readActivePresetMarker(projectActivePresetPath())?.name ?? null,
231
+ }
232
+ }
233
+
234
+ const sections = (): SettingsSection[] => [
235
+ buildGatesSection(load()),
236
+ buildDecisionSection(decision()),
237
+ buildPresetSection(presetInput()),
238
+ buildJ1Section(process.env, isBehaviorDisabled(mergedOverrides(load()), 'gate-j1-risk-gate')),
239
+ buildUpdatesSection(updatesInput()),
240
+ buildDoctorSection({
241
+ runningVersion: currentVersion,
242
+ nodeVersion: process.versions.node,
243
+ load: load(),
244
+ }),
245
+ buildAboutSection(currentVersion),
125
246
  ]
247
+ const [selectedId, setSelectedId] = createSignal<string | undefined>(
248
+ firstSelectableId(sections()),
249
+ )
250
+
251
+ const move = (delta: number) => {
252
+ const list = flatSelectableRows(sections())
253
+ if (list.length === 0) return
254
+ const current = list.findIndex((row) => row.id === selectedId())
255
+ const nextIndex = current === -1 ? 0 : Math.min(Math.max(current + delta, 0), list.length - 1)
256
+ setSelectedId(list[nextIndex]?.id)
257
+ }
258
+
259
+ const flipSection = () => {
260
+ const count = sections().length
261
+ const next = (page() + 1) % count
262
+ setPage(next)
263
+ const target = sections()[next]
264
+ if (target === undefined) return
265
+ const within = flatSelectableRows([target])[0]
266
+ if (within) setSelectedId(within.id)
267
+ }
268
+
269
+ const toggleSelectedGate = () => {
270
+ const id = selectedId()
271
+ if (id === undefined || !id.startsWith('gate.')) return false
272
+ if (!canWriteOverrides(load())) return undefined // corrupt file — writes refused
273
+ const behaviorId = id.slice('gate.'.length)
274
+ const next: OverridesLoad = {
275
+ ...load(),
276
+ global: toggledOverrides(load().global, behaviorId),
277
+ }
278
+ try {
279
+ writeOverridesToDisk(next)
280
+ setLoad(next)
281
+ } catch {
282
+ /* disk write failed — keep the in-memory state, stay open */
283
+ }
284
+ return undefined
285
+ }
286
+
287
+ const checkUpdatesNow = () => {
288
+ if (checking()) return undefined
289
+ setChecking(true)
290
+ void fetchLatestForChannel(currentVersion)
291
+ .then((latest) => {
292
+ if (latest) setLastChecked(latest)
293
+ persistUpdateCheckState(readUpdateCheckState(), latest)
294
+ })
295
+ .catch(() => {
296
+ /* offline — the row keeps the last known state */
297
+ })
298
+ .finally(() => setChecking(false))
299
+ return undefined
300
+ }
301
+
302
+ const toggleDecisionEnabled = () => {
303
+ const current = decision()
304
+ if (current.corrupt) return undefined // invalid file — writes refused
305
+ const next = setDecisionEnabled(current.config, !current.config.enabled)
306
+ if (!next.ok) return undefined // guard refused (egress consent missing)
307
+ try {
308
+ writeDecisionRouterConfig(next.config)
309
+ setDecision({ config: next.config, corrupt: false })
310
+ } catch {
311
+ /* disk write failed — keep the in-memory state */
312
+ }
313
+ return undefined
314
+ }
315
+
316
+ const applySelectedPreset = () => {
317
+ const id = selectedId()
318
+ if (id === undefined) return undefined
319
+ const name = id.startsWith('preset.') ? id.slice('preset.'.length) : null
320
+ if (name === null || name === 'project') return undefined
321
+ const path = globalActivePresetPath()
322
+ try {
323
+ if (name === 'none') clearActivePreset(path)
324
+ else writeActivePreset(path, name)
325
+ setPresetTick((tick) => tick + 1)
326
+ } catch {
327
+ /* disk write failed — the section keeps showing the last read state */
328
+ }
329
+ return undefined
330
+ }
126
331
 
127
332
  let dismiss: () => void = () => {}
128
333
  try {
@@ -146,7 +351,7 @@ export async function maybeShowPantheonSettings(context: Context): Promise<void>
146
351
  bind: 'down,j',
147
352
  run: () => {
148
353
  if (!open()) return false
149
- setSelected((current) => Math.min(current + 1, rows().length - 1))
354
+ move(1)
150
355
  return undefined
151
356
  },
152
357
  },
@@ -156,30 +361,31 @@ export async function maybeShowPantheonSettings(context: Context): Promise<void>
156
361
  bind: 'up,k',
157
362
  run: () => {
158
363
  if (!open()) return false
159
- setSelected((current) => Math.max(current - 1, 0))
364
+ move(-1)
160
365
  return undefined
161
366
  },
162
367
  },
163
368
  {
164
369
  id: 'pantheon.settings.toggle',
165
- title: 'Disable/enable the selected behavior',
370
+ title: 'Apply the selected row',
166
371
  bind: 'enter,space',
167
372
  run: () => {
168
373
  if (!open()) return false
169
- const row = rows()[selected()]
170
- if (row === undefined) return false
171
- setEffective(toggledOverrides(effective(), row.id))
172
- writeOverridesToDisk(effective())
374
+ const id = selectedId()
375
+ if (id?.startsWith('gate.')) return toggleSelectedGate()
376
+ if (id === 'decision.enabled') return toggleDecisionEnabled()
377
+ if (id?.startsWith('preset.')) return applySelectedPreset()
378
+ if (id === 'update.check') return checkUpdatesNow()
173
379
  return undefined
174
380
  },
175
381
  },
176
382
  {
177
- id: 'pantheon.settings.page',
178
- title: 'Flip page',
383
+ id: 'pantheon.settings.section',
384
+ title: 'Next section',
179
385
  bind: 'tab',
180
386
  run: () => {
181
387
  if (!open()) return false
182
- setPage((current) => (current === 0 ? 1 : 0))
388
+ flipSection()
183
389
  return undefined
184
390
  },
185
391
  },
@@ -189,15 +395,21 @@ export async function maybeShowPantheonSettings(context: Context): Promise<void>
189
395
  /* keymap API unavailable — the host dialog chrome still dismisses (ESC) */
190
396
  }
191
397
 
398
+ // The host may dismiss the dialog on its own and call this callback from
399
+ // inside its dismissal; mutating the dialog stack there re-enters the host
400
+ // mid-close and the swallowed failure leaves the window unclosable (the
401
+ // whats-new split: clear() lives only in dismiss, never in close).
192
402
  const close = () => {
193
403
  setOpen(false)
404
+ }
405
+ dismiss = () => {
194
406
  try {
195
407
  context.ui.dialog.clear()
196
408
  } catch {
197
409
  /* already closed */
198
410
  }
411
+ close()
199
412
  }
200
- dismiss = close
201
413
  setOpen(true)
202
414
  setPage(0)
203
415
  try {
@@ -205,17 +417,22 @@ export async function maybeShowPantheonSettings(context: Context): Promise<void>
205
417
  context.ui.dialog.show(
206
418
  () => (
207
419
  <SettingsContent
208
- rows={rows}
209
- selected={selected}
420
+ sections={sections}
210
421
  page={page}
211
- version={resolveRunningVersion}
212
- about={about}
422
+ selectedId={selectedId}
213
423
  fg={theme.base}
214
424
  muted={theme.muted}
215
425
  />
216
426
  ),
217
427
  close,
218
428
  )
429
+ // Roomier chrome for the sectioned window; older hosts without `set`
430
+ // keep the default size (fail-open).
431
+ try {
432
+ context.ui.dialog.set?.({ size: 'xlarge' })
433
+ } catch {
434
+ /* size control unavailable */
435
+ }
219
436
  } catch {
220
437
  /* dialog stack unavailable — fail-open */
221
438
  }
@@ -223,14 +440,3 @@ export async function maybeShowPantheonSettings(context: Context): Promise<void>
223
440
  /* fail-open — the window must never block or break TUI startup */
224
441
  }
225
442
  }
226
-
227
- function resolveRunningVersion(): string {
228
- try {
229
- const manifest = JSON.parse(
230
- readFileSync(new URL('../../package.json', import.meta.url), 'utf8'),
231
- ) as { version?: string }
232
- return manifest.version ?? 'unknown'
233
- } catch {
234
- return 'unknown'
235
- }
236
- }
@@ -0,0 +1,143 @@
1
+ /**
2
+ * preset-state.ts — the Model Preset section of the settings window.
3
+ *
4
+ * TUI-local replica (the bundle must stay self-contained). The preset NAMES
5
+ * mirror routing.yml's `presets:` and are drift-pinned by
6
+ * tests/tui-preset-state.test.mjs against `loadPresetDefs()`. The marker file
7
+ * shape mirrors scripts/install/model-picker.mjs's `buildActivePresetFile`
8
+ * (version 1), and the readers (`resolveActivePreset`, vision.ts candidates)
9
+ * only consult `.preset`, so the window writes `source: 'tui-settings'`.
10
+ *
11
+ * Scope note: the window writes the GLOBAL marker only
12
+ * (`<config-dir>/opencode/.pantheon/active-preset.json`). A project marker
13
+ * wins (it precedes the global path in every runtime candidate list), so it
14
+ * is displayed read-only. `none` DELETES the marker with a .bak backup — the
15
+ * same contract as the CLI's `set-tier none`.
16
+ */
17
+ import {
18
+ copyFileSync,
19
+ existsSync,
20
+ mkdirSync,
21
+ readFileSync,
22
+ renameSync,
23
+ rmSync,
24
+ writeFileSync,
25
+ } from 'node:fs'
26
+ import { dirname, join } from 'node:path'
27
+ import type { SettingsRow, SettingsSection } from './pantheon-settings-state.ts'
28
+
29
+ /** Mirrors routing.yml `presets:` — drift-pinned against loadPresetDefs(). */
30
+ export const PRESET_NAMES: readonly string[] = Object.freeze([
31
+ 'go-free',
32
+ 'go-fast',
33
+ 'go-premium',
34
+ 'go-hybrid',
35
+ 'anthropic',
36
+ 'openai',
37
+ ])
38
+
39
+ export interface ActivePresetMarker {
40
+ version: number
41
+ preset: string
42
+ source: string
43
+ updated_at: string
44
+ }
45
+
46
+ export function globalActivePresetPath(env: Record<string, string | undefined> = process.env) {
47
+ const xdg = env.XDG_CONFIG_HOME
48
+ const home = env.HOME ?? ''
49
+ const root = xdg ?? join(home, '.config')
50
+ return join(root, 'opencode', '.pantheon', 'active-preset.json')
51
+ }
52
+
53
+ export function projectActivePresetPath() {
54
+ return join(process.cwd(), '.pantheon', 'active-preset.json')
55
+ }
56
+
57
+ /** Fail-open read: missing/corrupt marker = no active preset. */
58
+ export function readActivePresetMarker(path: string): { name: string; updatedAt: string } | null {
59
+ try {
60
+ const raw = JSON.parse(readFileSync(path, 'utf8')) as { preset?: unknown; updated_at?: unknown }
61
+ if (typeof raw?.preset !== 'string' || raw.preset === '' || raw.preset === 'none') return null
62
+ return {
63
+ name: raw.preset,
64
+ updatedAt: typeof raw.updated_at === 'string' ? raw.updated_at : '',
65
+ }
66
+ } catch {
67
+ return null
68
+ }
69
+ }
70
+
71
+ function writeMarkerAtomically(path: string, content: string): void {
72
+ mkdirSync(dirname(path), { recursive: true })
73
+ const temp = `${path}.tui.tmp`
74
+ writeFileSync(temp, content)
75
+ renameSync(temp, path)
76
+ }
77
+
78
+ /** Select a preset globally: .bak backup, atomic write, version-1 marker. */
79
+ export function writeActivePreset(
80
+ path: string,
81
+ name: string,
82
+ nowIso = new Date().toISOString(),
83
+ ): void {
84
+ if (!PRESET_NAMES.includes(name)) {
85
+ throw new TypeError(`Refusing to persist unknown preset "${name}"`)
86
+ }
87
+ backupMarker(path)
88
+ const marker: ActivePresetMarker = {
89
+ version: 1,
90
+ preset: name,
91
+ source: 'tui-settings',
92
+ updated_at: nowIso,
93
+ }
94
+ writeMarkerAtomically(path, `${JSON.stringify(marker, null, 2)}\n`)
95
+ }
96
+
97
+ /** Clear the global marker (the `none` contract): .bak backup, then remove. */
98
+ export function clearActivePreset(path: string): void {
99
+ backupMarker(path)
100
+ rmSync(path, { force: true })
101
+ }
102
+
103
+ function backupMarker(path: string): void {
104
+ if (!existsSync(path)) return
105
+ mkdirSync(dirname(path), { recursive: true })
106
+ copyFileSync(path, `${path}.bak`)
107
+ }
108
+
109
+ export interface PresetSectionInput {
110
+ globalName: string | null
111
+ projectName: string | null
112
+ }
113
+
114
+ export function buildPresetSection(input: PresetSectionInput): SettingsSection {
115
+ const rows: SettingsRow[] = PRESET_NAMES.map((name) => ({
116
+ id: `preset.${name}`,
117
+ title: name,
118
+ description: input.globalName === name ? 'active (global)' : 'enter: activate globally',
119
+ disabled: input.globalName === name,
120
+ }))
121
+ rows.push({
122
+ id: 'preset.none',
123
+ title: 'none',
124
+ description: 'clear the global marker — opencode defaults',
125
+ disabled: input.globalName === null,
126
+ marker: input.globalName === null ? '[x]' : '[ ]',
127
+ })
128
+ if (input.projectName !== null) {
129
+ rows.push({
130
+ id: 'preset.project',
131
+ title: `${input.projectName} (project)`,
132
+ description: `${projectActivePresetPath()} wins over the global marker`,
133
+ marker: '[!]',
134
+ selectable: false,
135
+ })
136
+ }
137
+ return {
138
+ id: 'preset',
139
+ title: 'Model Preset',
140
+ rows,
141
+ hint: 'enter: activate globally · writes <config>/opencode/.pantheon/active-preset.json',
142
+ }
143
+ }