nerviz-config

1// nerviz-config — a pane over `ArchHook.jar config`. Nothing here decides anything.
2//
3//   /nerviz-config   opens a pane with every setting the project owns in its own .claude/
4//                    (`config list`), in the nerviz identity: the brand blue marks only what
5//                    is off its default. A change is a button, then a dialog, then
6//                    `config set` or `config unset` — never a write of this mod's own.
7//
8// Why this is a mod (Form 9 of claude-code-architect-designer): axis 1 — a project owner did
9// not know the settings existed, and one edited a file by hand with a wrong key. The closest
10// rejected form was the `/project-config` skill alone: it spends a turn and a model to list
11// and change what one command already answers, and the pane spends neither. The guarantee
12// beneath is `config` itself — it validates every value before it writes, `guard` refuses a
13// direct write of a registered file, and `doctor` gates a malformed one; this mod does not
14// load in `claude -p`, VS Code, a cloud session or under `--safe-mode`, and every setting is
15// still reachable through the skill and the command. Tested against Claude Code 2.1.293 and 2.1.308.
16//
17// The one write a mod here makes is `config set|unset` through `$.process.run`: it is no file
18// write of the mod's (`$.fs.write` stays forbidden), it is the registry's own writer, and it
19// refuses before it touches anything. `mods.$comment_calls` names this exception.
20//
21// Design: .claude/decisions/0187-project-config-registry-skill-and-mod.md. No hook on a
22// `gating_events` event: the mod holds no refusal, so it needs no `.catch`.
23//
24// The engine reads `on(...)` and `$.noun.method(...)` from source, so they are spelled
25// literally, and helpers that take `$` are top-level functions in this file. The pure parts
26// — what to draw, in which words, in which blue — live beside it and never see `$`.
27
28import type { EngineInterface, Register } from 'claude-code'
29import { changed, effective, paneLines, parseList, plainText, show } from './model.ts'
30import type { Action, ConfigFile, Key, Line, Model, Seg, View } from './model.ts'
31import { brandOf } from './palettes.ts'
32import { langOf, wordsOf } from './words.ts'
33import type { Lang } from './words.ts'
34
35const JAR = '.claude/hooks/ArchHook.jar'
36const PANE = 'nerviz-config'
37const INPUT = 'nerviz-config-input'
38
39let model: Model = { status: 'failed', files: [], detail: '' }
40let view: View = { expanded: [], pages: {}, edit: null, refusal: [] }
41let theme: unknown = null
42let lang: Lang = 'en'
43
44export const register: Register = (on) => {
45  on('session.start', async ($, e, next) => {
46    const result = await next(e)
47    const root = await $.session.root()
48    // No project jar, no command: the mod stays silent where `config` does not exist.
49    if (await $.fs.exists(root + '/' + JAR)) {
50      try {
51        await $.command.register({
52          name: 'nerviz-config',
53          description: 'The project settings in a pane, without spending a turn',
54          immediate: true,
55        })
56      } catch {
57        // The name is taken; /project-config still lists and changes the same settings.
58      }
59    }
60    return result
61  })
62
63  on('command.run', { command: 'nerviz-config' }, async ($, e, next) => {
64    view = { expanded: [], pages: {}, edit: null, refusal: [] }
65    await load($)
66    if ((await $.session.surfaces()).length > 0) {
67      const opened = await $.ui.open({ id: PANE, title: 'nerviz config', focus: true, closeOnEscape: true })
68      if (opened.isPlaced) return {}
69    }
70    return { text: plainText(model) }
71  })
72
73  on('ui.render', { component: 'Pane' }, ($, e, next) => {
74    if (e.requestId !== PANE) return next(e)
75    const els = $.ui.resolve(e)
76    const { Box } = els
77    const lines = paneLines(wordsOf(lang), model, view)
78    return Box({
79      flexDirection: 'column',
80      paddingX: 1,
81      children: lines.map((line, i) => row($, els, line, i)),
82    })
83  })
84}
85
86// ---- What the pane draws ---------------------------------------------------
87
88function row($: EngineInterface, els: any, line: Line, index: number) {
89  const { Box, Text } = els
90  const children = line.length === 0 ? [Text({ children: ' ' })] : line.map((seg, j) => piece($, els, seg, index + '-' + j))
91  return Box({ key: 'l' + index, flexDirection: 'row', children })
92}
93
94function piece($: EngineInterface, els: any, seg: Seg, key: string) {
95  const { Text, Button, Input } = els
96  if (seg.input !== undefined) {
97    const at = seg.input
98    return Input({
99      key: INPUT,
100      value: at.value,
101      submitLabel: wordsOf(lang).save,
102      autoFocus: true,
103      onInput: (value: string) => typing(at.id, at.key, value),
104      onSubmit: (value: string) => submit($, at.id, at.key, value),
105    })
106  }
107  if (seg.act !== undefined) {
108    const act = seg.act
109    return Button({ key: 'b' + key, label: seg.t, plain: true, onPress: () => press($, act) })
110  }
111  return Text({ ...tone(seg), wrap: 'truncate-end', children: seg.t })
112}
113
114function tone(seg: Seg): Record<string, unknown> {
115  switch (seg.tone) {
116    case 'bold':
117      return { bold: true }
118    case 'dim':
119      return { dimColor: true }
120    case 'brand':
121      return { color: brandOf(theme) }
122    case 'error':
123      return { color: 'error' }
124    case 'warning':
125      return { color: 'warning' }
126    case 'inactive':
127      return { color: 'inactive' }
128    default:
129      return {}
130  }
131}
132
133// ---- What `config` says ----------------------------------------------------
134
135async function load($: EngineInterface) {
136  try {
137    const rows = await $.config.list()
138    theme = rows.find((r) => r.key === 'theme')?.value ?? null
139    lang = langOf(rows.find((r) => r.key === 'language')?.value, Intl.DateTimeFormat().resolvedOptions().locale)
140  } catch {
141    theme = null
142  }
143  await refresh($)
144}
145
146async function refresh($: EngineInterface) {
147  try {
148    const run = await $.process.run(['java', '-jar', JAR, 'config', 'list'], {
149      cwd: await $.session.root(),
150      timeoutMs: 20000,
151    })
152    const out = (run.stdout + run.stderr).trim()
153    const files = run.exitCode === 0 ? parseList(run.stdout) : null
154    if (files !== null) model = { status: 'ok', files, detail: '' }
155    else if (out.includes('Unknown mode')) model = { status: 'oldjar', files: [], detail: '' }
156    else model = { status: 'failed', files: [], detail: out.split('\n')[0] ?? '' }
157  } catch {
158    model = { status: 'failed', files: [], detail: 'java did not start' }
159  }
160  $.ui.invalidate('ui.render')
161}
162
163// ---- What a press does -----------------------------------------------------
164
165function find(id: string, key: string): { file: ConfigFile; key: Key } | null {
166  const file = model.files.find((f) => f.id === id)
167  const k = file?.keys.find((x) => x.key === key)
168  return file && k ? { file, key: k } : null
169}
170
171async function press($: EngineInterface, act: Action) {
172  const w = wordsOf(lang)
173  view.refusal = []
174  try {
175    if (act.kind === 'set') {
176      const at = find(act.id, act.key)
177      if (at === null) return
178      const question = w.askSet(at.file.path, at.key.key, show(effective(at.key)), act.value) + '\n' + at.key.effect
179      await change($, question, ['set', act.id, act.key, act.value], w.written(act.id, act.key, act.value))
180    } else if (act.kind === 'unset') {
181      const at = find(act.id, act.key)
182      if (at === null) return
183      const question = w.askUnset(act.key, show(at.key.default)) + '\n' + w.askUnsetHint
184      await change($, question, ['unset', act.id, act.key], w.restored(act.id, act.key))
185    } else if (act.kind === 'edit') {
186      const at = find(act.id, act.key)
187      view.edit = { id: act.id, key: act.key, text: at !== null && changed(at.key) ? show(at.key.value) : '' }
188    } else if (act.kind === 'expand') {
189      view.expanded = view.expanded.includes(act.id) ? view.expanded.filter((x) => x !== act.id) : [...view.expanded, act.id]
190      view.pages[act.id] = 0
191    } else if (act.kind === 'page') {
192      view.pages[act.id] = Math.max(0, (view.pages[act.id] ?? 0) + act.by)
193    } else if (act.kind === 'refresh') {
194      view.edit = null
195      await refresh($)
196    } else if (act.kind === 'doctor') {
197      await $.prompt.fill({ text: '/arch-doctor' })
198    } else if (act.kind === 'adopt') {
199      await $.prompt.fill({ text: '/arch-adopt' })
200    } else if (act.kind === 'close') {
201      await $.ui.close({ id: PANE })
202      return
203    }
204  } catch {
205    // A dialog the person dismissed, or a pane that is already gone: nothing was written.
206  }
207  $.ui.invalidate('ui.render')
208}
209
210function typing(id: string, key: string, text: string) {
211  view.edit = { id, key, text }
212}
213
214async function submit($: EngineInterface, id: string, key: string, raw: string) {
215  const w = wordsOf(lang)
216  const at = find(id, key)
217  if (at === null) return
218  const text = raw.trim()
219  view.refusal = []
220  try {
221    if (text === '') {
222      await change($, w.askUnset(key, show(at.key.default)) + '\n' + w.askUnsetHint, ['unset', id, key], w.restored(id, key))
223    } else {
224      await change($, w.askSet(at.file.path, key, show(effective(at.key)), text) + '\n' + at.key.effect, ['set', id, key, text], w.written(id, key, text))
225    }
226  } catch {
227    // Dismissed dialog.
228  }
229  $.ui.invalidate('ui.render')
230}
231
232// The dialog first, then the one writer. A refusal (exit 2) is shown as `config` printed it.
233async function change($: EngineInterface, question: string, args: string[], done: string) {
234  const w = wordsOf(lang)
235  const answer = await $.ui.ask(question, { header: 'config', options: [w.write, w.cancel] })
236  if (answer !== w.write) return
237  try {
238    const run = await $.process.run(['java', '-jar', JAR, 'config', ...args], {
239      cwd: await $.session.root(),
240      timeoutMs: 20000,
241    })
242    if (run.exitCode === 0) {
243      view.edit = null
244      await refresh($)
245      $.ui.toast(done)
246    } else {
247      view.refusal = (run.stdout + run.stderr).split('\n').filter((l) => l.trim() !== '')
248    }
249  } catch {
250    view.refusal = [w.failed]
251  }
252}
253

1// What `ArchHook.jar config list` prints, as lines the pane draws. Pure: no `$`, no rule. A
2// value is "off default" when the file holds it and it differs from the default `config list`
3// printed; whether a value is valid is `config set`'s answer, never this file's.
4
5import type { Words } from './words.ts'
6
7export type Key = {
8  key: string
9  type: string
10  values?: string[]
11  default: unknown
12  value: unknown
13  effect: string
14  fixed?: boolean
15}
16
17export type ConfigFile = {
18  id: string
19  path: string
20  exists: boolean
21  summary: string
22  doctor_label: string
23  available: boolean
24  in_force: string
25  problems: string[]
26  keys: Key[]
27}
28
29export type Action =
30  | { kind: 'set'; id: string; key: string; value: string }
31  | { kind: 'unset'; id: string; key: string }
32  | { kind: 'edit'; id: string; key: string }
33  | { kind: 'expand'; id: string }
34  | { kind: 'page'; id: string; by: number }
35  | { kind: 'refresh' }
36  | { kind: 'doctor' }
37  | { kind: 'adopt' }
38  | { kind: 'close' }
39
40export type Tone = 'plain' | 'bold' | 'dim' | 'brand' | 'error' | 'warning' | 'inactive'
41
42export type Seg = { t: string; tone?: Tone; act?: Action; input?: { id: string; key: string; value: string } }
43export type Line = Seg[]
44
45export type Status = 'ok' | 'oldjar' | 'failed'
46
47export type Model = { status: Status; files: ConfigFile[]; detail: string }
48
49export type View = {
50  expanded: string[]
51  pages: Record<string, number>
52  edit: { id: string; key: string; text: string } | null
53  refusal: string[]
54}
55
56export const PAGE = 8
57const COLLAPSE_OVER = 8
58
59export function parseList(stdout: string): ConfigFile[] | null {
60  try {
61    const data = JSON.parse(stdout)
62    return Array.isArray(data?.files) ? (data.files as ConfigFile[]) : null
63  } catch {
64    return null
65  }
66}
67
68export function changed(key: Key): boolean {
69  return key.value !== null && key.value !== undefined && key.value !== key.default
70}
71
72export function effective(key: Key): unknown {
73  return key.value === null || key.value === undefined ? key.default : key.value
74}
75
76const dim = (t: string): Seg => ({ t, tone: 'dim' })
77const brand = (t: string): Seg => ({ t, tone: 'brand' })
78const bold = (t: string): Seg => ({ t, tone: 'bold' })
79const plain = (t: string): Seg => ({ t })
80const button = (t: string, act: Action): Seg => ({ t, act })
81
82export function show(value: unknown): string {
83  if (value === null || value === undefined) return '—'
84  return typeof value === 'string' ? value : JSON.stringify(value)
85}
86
87function header(w: Words, sub: string): Line[] {
88  return [
89    [{ t: '█', tone: 'bold' }, brand('╲'), { t: '  █', tone: 'bold' }, bold('   nerviz config')],
90    [{ t: '█ ', tone: 'bold' }, brand('╲'), { t: ' █', tone: 'bold' }, dim('   ' + w.tagline)],
91    [{ t: '█  ', tone: 'bold' }, brand('╲'), { t: '█', tone: 'bold' }, dim('   ' + sub)],
92    [],
93  ]
94}
95
96function seal(w: Words, files: number | null, problems: number): Line[] {
97  return [
98    [],
99    [
100      { t: 'nerviz ', tone: 'bold' },
101      brand('▸ '),
102      bold('config'),
103      ...(files === null ? [] : [dim(' · ' + w.seal(files, problems))]),
104    ],
105    [
106      dim('/nerviz-config  '),
107      button(w.refresh, { kind: 'refresh' }),
108      dim(' · '),
109      button('doctor', { kind: 'doctor' }),
110      dim('   '),
111      button(w.close, { kind: 'close' }),
112    ],
113  ]
114}
115
116function enumRow(w: Words, f: ConfigFile, k: Key): Line[] {
117  const now = effective(k)
118  const options = (k.values ?? []).map((v): Seg[] => {
119    if (v === now) return [changed(k) ? brand('● ' + v) : plain('● ' + v)]
120    return [button('○ ' + v, { kind: 'set', id: f.id, key: k.key, value: v })]
121  })
122  const row: Line = [plain(k.key.padEnd(12))]
123  options.forEach((o, i) => row.push(...(i > 0 ? [plain('   ')] : []), ...o))
124  if (changed(k)) row.push(dim('  · '), button(w.reset, { kind: 'unset', id: f.id, key: k.key }))
125  return [row, [dim('            ' + k.effect)]]
126}
127
128function boolRow(w: Words, f: ConfigFile, k: Key): Line {
129  const on = effective(k) === true
130  const mark: Seg = changed(k) ? brand('● ') : dim('○ ')
131  const name = k.key.padEnd(24)
132  if (k.fixed) {
133    return [dim('○ '), { t: name, tone: 'inactive' }, { t: on ? w.on : w.unset, tone: 'inactive' }, { t: '  ' + w.fixed, tone: 'inactive' }]
134  }
135  const value = on ? w.on + ' ' : w.unset
136  const verb = changed(k)
137    ? button(w.reset, { kind: 'unset', id: f.id, key: k.key })
138    : button(on ? w.turnOff : w.turnOn, { kind: 'set', id: f.id, key: k.key, value: String(!on) })
139  const note = changed(k) ? w.classIs(String(k.default)) : w.defaultIs
140  return [mark, plain(name), changed(k) ? brand(value) : dim(value), dim('  ' + note.padEnd(11)), verb]
141}
142
143function numberRow(w: Words, f: ConfigFile, k: Key, view: View): Line[] {
144  const mark: Seg = changed(k) ? brand('● ') : dim('○ ')
145  const name = plain(k.key.padEnd(22))
146  if (view.edit && view.edit.id === f.id && view.edit.key === k.key) {
147    return [
148      [mark, name, { t: '', input: { id: f.id, key: k.key, value: view.edit.text } }],
149      [dim('   ' + ' '.repeat(22) + w.emptyHint)],
150    ]
151  }
152  const row: Line = [mark, name, changed(k) ? brand(show(k.value) + '  ') : dim('—  ')]
153  row.push(button(changed(k) ? w.edit : w.set, { kind: 'edit', id: f.id, key: k.key }))
154  if (changed(k)) row.push(dim(' · '), button(w.reset, { kind: 'unset', id: f.id, key: k.key }))
155  return [row]
156}
157
158function keyRows(w: Words, f: ConfigFile, k: Key, view: View): Line[] {
159  if (k.type === 'boolean') return [boolRow(w, f, k)]
160  if (k.type === 'positive_number_or_null') return numberRow(w, f, k, view)
161  if (k.values && k.values.length > 0) return enumRow(w, f, k)
162  return [[dim('○ '), plain(k.key.padEnd(24)), plain(show(effective(k)))]]
163}
164
165function section(w: Words, f: ConfigFile, view: View): { node: Seg; tail: Seg; lines: Line[] } {
166  const off = f.keys.filter(changed).length
167  if (!f.available) {
168    return {
169      node: { t: '○ ', tone: 'inactive' },
170      tail: { t: w.off, tone: 'inactive' },
171      lines: [[{ t: w.trailOff, tone: 'inactive' }], [dim(w.trailOffHint)]],
172    }
173  }
174  const lines: Line[] = []
175  const long = f.keys.length > COLLAPSE_OVER
176  const open = view.expanded.includes(f.id)
177  if (!long || !open) {
178    const shown = long ? f.keys.filter(changed) : f.keys
179    shown.forEach((k) => lines.push(...keyRows(w, f, k, view)))
180    if (long) lines.push([dim('  '), button(w.showAll(f.keys.length), { kind: 'expand', id: f.id })])
181  } else {
182    const page = Math.min(view.pages[f.id] ?? 0, Math.floor((f.keys.length - 1) / PAGE))
183    const slice = f.keys.slice(page * PAGE, page * PAGE + PAGE)
184    slice.forEach((k) => lines.push(...keyRows(w, f, k, view)))
185    const nav: Line = [dim('  ' + w.range(page * PAGE + 1, page * PAGE + slice.length, f.keys.length) + '  ')]
186    if (page > 0) nav.push(button('▲ ' + w.prev, { kind: 'page', id: f.id, by: -1 }), dim('  '))
187    if ((page + 1) * PAGE < f.keys.length) nav.push(button('▼ ' + w.next, { kind: 'page', id: f.id, by: 1 }), dim('  '))
188    nav.push(button(w.onlyChanged, { kind: 'expand', id: f.id }))
189    lines.push(nav)
190  }
191  const invalid = f.problems.length > 0
192  const node: Seg = invalid ? { t: '✗ ', tone: 'error' } : off > 0 ? brand('● ') : dim('○ ')
193  const tail: Seg = invalid
194    ? { t: w.invalid, tone: 'error' }
195    : off > 0
196      ? dim(w.offDefault(off))
197      : dim(f.exists ? w.asDefault : w.notWritten)
198  return { node, tail, lines }
199}
200
201export function paneLines(w: Words, model: Model, view: View): Line[] {
202  if (model.status === 'oldjar') {
203    return [
204      ...header(w, w.noFiles),
205      [{ t: w.oldJar, tone: 'warning' }],
206      [dim('  ' + w.oldJarHint)],
207      [plain('  '), button('/arch-adopt', { kind: 'adopt' })],
208      ...seal(w, null, 0),
209    ]
210  }
211  if (model.status === 'failed') {
212    return [
213      ...header(w, w.noFiles),
214      [{ t: w.failed, tone: 'warning' }],
215      ...(model.detail === '' ? [] : [[dim('  ' + model.detail)] as Line]),
216      ...seal(w, null, 0),
217    ]
218  }
219  const problems = model.files.reduce((n, f) => n + f.problems.length, 0)
220  const off = model.files.reduce((n, f) => n + f.keys.filter(changed).length, 0)
221  const out: Line[] = [...header(w, w.files(model.files.length, off))]
222  if (view.refusal.length > 0) {
223    out.push([{ t: w.refused, tone: 'error' }])
224    view.refusal.forEach((l) => out.push([{ t: '  ' + l, tone: 'error' }]))
225    out.push([])
226  }
227  model.files
228    .filter((f) => f.problems.length > 0)
229    .forEach((f) => {
230      out.push([{ t: w.problems(f.problems.length, f.doctor_label), tone: 'error' }])
231      f.problems.forEach((p) => out.push([{ t: '  ' + p, tone: 'error' }]))
232      out.push([])
233    })
234  model.files.forEach((f, i) => {
235    const last = i === model.files.length - 1
236    const first = i === 0
237    const lead = model.files.length === 1 ? '── ' : first ? '╭─ ' : last ? '╰─ ' : '├─ '
238    const s = section(w, f, view)
239    out.push([dim(lead), s.node, bold(f.doctor_label), dim(' · ' + f.path + ' · '), s.tail])
240    s.lines.forEach((l) => out.push([dim(last ? '   ' : '│  '), ...l]))
241    if (!last) out.push([dim('│')])
242  })
243  out.push(...seal(w, model.files.length, problems))
244  return out
245}
246
247/** The same listing as plain text, for a surface that draws nothing (`claude -p`). */
248export function plainText(model: Model): string {
249  if (model.status !== 'ok') {
250    return 'config list did not answer. ' + (model.status === 'oldjar' ? 'Run /arch-adopt to update this .claude/.' : model.detail)
251  }
252  const out: string[] = []
253  model.files.forEach((f) => {
254    if (!f.available) {
255      out.push(`${f.id}  ${f.path}  audit trail off`)
256      return
257    }
258    const set = f.keys.filter(changed)
259    out.push(`${f.id}  ${f.path}  ${f.exists ? (set.length === 0 ? 'default' : set.length + ' off default') : 'not written'}`)
260    set.forEach((k) => out.push(`  ${k.key} = ${show(k.value)} (default ${show(k.default)})`))
261    f.problems.forEach((p) => out.push('  ! ' + p))
262  })
263  out.push('Change: java -jar .claude/hooks/ArchHook.jar config set <id> <key> <value>')
264  return out.join('\n')
265}
266

1// The one place a hex value may live in this mod (decision 0187, option B of the style round).
2// Everything else the mod draws is a theme key. These are the blue of brand/nerviz-mark*.svg,
3// one per theme the mod knows; any other theme (`auto`, an ANSI or custom one) gets the
4// `suggestion` theme key, so the person's own palette decides.
5
6const DARK = '#8EA2FF'
7const LIGHT = '#2747D9'
8const FALLBACK = 'suggestion'
9
10const BY_THEME: Record<string, string> = {
11  dark: DARK,
12  'dark-daltonized': DARK,
13  light: LIGHT,
14  'light-daltonized': LIGHT,
15}
16
17/** The brand blue for the `theme` row of `$.config.list()`, or a theme key when it is unknown. */
18export function brandOf(theme: unknown): string {
19  return typeof theme === 'string' ? (BY_THEME[theme] ?? FALLBACK) : FALLBACK
20}
21

1// Every string the mod draws, in pt-BR and en. The language is the `/config` Language row when
2// it names one, else the locale of the process.
3
4export type Lang = 'pt' | 'en'
5
6const WORDS = {
7  pt: {
8    tagline: 'o que este projeto configura no próprio .claude/',
9    files: (n: number, off: number) => `${n} arquivos · ${off} fora do padrão`,
10    noFiles: 'config indisponível',
11    seal: (n: number, problems: number) => `${n} arquivos · ${problems} problemas`,
12    offDefault: (n: number) => `${n} fora do padrão`,
13    notWritten: 'não existe',
14    asDefault: 'no padrão',
15    off: 'desligada',
16    invalid: 'inválido',
17    on: 'on',
18    unset: 'off',
19    classIs: (v: string) => `classe: ${v}`,
20    defaultIs: 'padrão',
21    fixed: 'fixo',
22    set: 'definir',
23    edit: 'editar',
24    turnOn: 'ligar',
25    turnOff: 'desligar',
26    reset: 'restaurar',
27    save: 'gravar',
28    showAll: (n: number) => `mostrar as ${n}`,
29    onlyChanged: 'só os fora do padrão',
30    prev: 'anteriores',
31    next: 'próximos',
32    range: (from: number, to: number, n: number) => `${from}–${to} de ${n}`,
33    refresh: 'atualizar',
34    close: 'fechar',
35    trailOff: 'trilha de auditoria desligada',
36    trailOffHint: 'gravar aqui ligaria a trilha: nada a mudar',
37    emptyHint: 'tokens faturáveis da janela; vazio = sem projeção',
38    problems: (n: number, label: string) => `✗ ${n} problema${n > 1 ? 's' : ''} · doctor › ${label} falha o gate`,
39    refused: '✗ config recusou · nada foi gravado',
40    oldJar: '! O ArchHook.jar deste projeto não tem o modo config.',
41    oldJarHint: 'Ele é anterior à decisão 0187. Atualize o .claude/ do projeto:',
42    failed: '! config list não rodou.',
43    write: 'Gravar',
44    cancel: 'Cancelar',
45    askSet: (path: string, key: string, from: string, to: string) => `Gravar ${path}: ${key} ${from} → ${to}?`,
46    askUnset: (key: string, to: string) => `Restaurar ${key} ao padrão (${to})?`,
47    askUnsetHint: 'Remove a chave do arquivo; um arquivo que fica vazio é apagado.',
48    written: (id: string, key: string, to: string) => `${id} · ${key} = ${to} · gravado`,
49    restored: (id: string, key: string) => `${id} · ${key} restaurado`,
50    change: 'Mudar',
51    default: 'padrão',
52  },
53  en: {
54    tagline: 'what this project sets in its own .claude/',
55    files: (n: number, off: number) => `${n} files · ${off} off default`,
56    noFiles: 'config unavailable',
57    seal: (n: number, problems: number) => `${n} files · ${problems} problems`,
58    offDefault: (n: number) => `${n} off default`,
59    notWritten: 'not written',
60    asDefault: 'default',
61    off: 'off',
62    invalid: 'invalid',
63    on: 'on',
64    unset: 'off',
65    classIs: (v: string) => `class: ${v}`,
66    defaultIs: 'default',
67    fixed: 'fixed',
68    set: 'set',
69    edit: 'edit',
70    turnOn: 'turn on',
71    turnOff: 'turn off',
72    reset: 'reset',
73    save: 'save',
74    showAll: (n: number) => `show all ${n}`,
75    onlyChanged: 'only off default',
76    prev: 'previous',
77    next: 'next',
78    range: (from: number, to: number, n: number) => `${from}–${to} of ${n}`,
79    refresh: 'refresh',
80    close: 'close',
81    trailOff: 'audit trail off',
82    trailOffHint: 'a write here would switch the trail on: nothing to change',
83    emptyHint: 'billable tokens of the window; empty = no projection',
84    problems: (n: number, label: string) => `✗ ${n} problem${n > 1 ? 's' : ''} · doctor › ${label} fails the gate`,
85    refused: '✗ config refused · nothing written',
86    oldJar: "! This project's ArchHook.jar has no config mode.",
87    oldJarHint: "It predates decision 0187. Update the project's .claude/:",
88    failed: '! config list did not run.',
89    write: 'Write',
90    cancel: 'Cancel',
91    askSet: (path: string, key: string, from: string, to: string) => `Write ${path}: ${key} ${from} → ${to}?`,
92    askUnset: (key: string, to: string) => `Reset ${key} to its default (${to})?`,
93    askUnsetHint: 'Removes the key from the file; a file left empty is deleted.',
94    written: (id: string, key: string, to: string) => `${id} · ${key} = ${to} · written`,
95    restored: (id: string, key: string) => `${id} · ${key} reset`,
96    change: 'Change',
97    default: 'default',
98  },
99}
100
101export type Words = (typeof WORDS)['pt']
102
103export function wordsOf(lang: Lang): Words {
104  return WORDS[lang]
105}
106
107/** `language` is the `/config` Language row's value (or undefined), `locale` the process's. */
108export function langOf(language: unknown, locale: string): Lang {
109  const named = typeof language === 'string' ? language.toLowerCase() : ''
110  if (named.startsWith('portugu') || named.startsWith('pt')) return 'pt'
111  if (named !== '' && named !== 'default' && named !== 'auto') return 'en'
112  return locale.toLowerCase().startsWith('pt') ? 'pt' : 'en'
113}
114