pgserve 2.1.3 → 2.2.1

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 (235) hide show
  1. package/CHANGELOG.md +96 -0
  2. package/README.md +105 -1
  3. package/bin/autopg-wrapper.cjs +16 -0
  4. package/bin/pgserve-wrapper.cjs +32 -6
  5. package/bin/postgres-server.js +56 -0
  6. package/console/README.md +131 -0
  7. package/console/api.js +173 -0
  8. package/console/app.jsx +483 -0
  9. package/console/colors_and_type.css +227 -0
  10. package/console/components.jsx +167 -0
  11. package/console/console.css +1666 -0
  12. package/console/data.jsx +350 -0
  13. package/console/index.html +31 -0
  14. package/console/screens/databases.jsx +5 -0
  15. package/console/screens/health.jsx +5 -0
  16. package/console/screens/ingress.jsx +5 -0
  17. package/console/screens/optimizer.jsx +5 -0
  18. package/console/screens/rlm-sim.jsx +5 -0
  19. package/console/screens/rlm-trace.jsx +5 -0
  20. package/console/screens/security.jsx +5 -0
  21. package/console/screens/settings.jsx +611 -0
  22. package/console/screens/sql.jsx +5 -0
  23. package/console/screens/sync.jsx +5 -0
  24. package/console/screens/tables.jsx +5 -0
  25. package/console/tweaks-panel.jsx +425 -0
  26. package/package.json +14 -2
  27. package/scripts/postinstall.cjs +60 -0
  28. package/src/cli-config.cjs +310 -0
  29. package/src/cli-install.cjs +112 -11
  30. package/src/cli-restart.cjs +228 -0
  31. package/src/cli-ui.cjs +580 -0
  32. package/src/cluster.js +43 -38
  33. package/src/postgres.js +141 -19
  34. package/src/settings-loader.cjs +235 -0
  35. package/src/settings-migrate.cjs +212 -0
  36. package/src/settings-pg-args.cjs +146 -0
  37. package/src/settings-schema.cjs +422 -0
  38. package/src/settings-validator.cjs +416 -0
  39. package/src/settings-writer.cjs +288 -0
  40. package/src/upgrade/index.js +65 -0
  41. package/src/upgrade/runner.js +23 -0
  42. package/src/upgrade/steps/binary-cache-flush.js +67 -0
  43. package/src/upgrade/steps/consumer-signal.js +40 -0
  44. package/src/upgrade/steps/env-refresh.js +89 -0
  45. package/src/upgrade/steps/health-validate.js +53 -0
  46. package/src/upgrade/steps/plpgsql-resolve.js +66 -0
  47. package/src/upgrade/steps/port-reconcile.js +52 -0
  48. package/.claude/context/windows-debug.md +0 -119
  49. package/.genie/AGENTS.md +0 -15
  50. package/.genie/agents/README.md +0 -110
  51. package/.genie/agents/analyze.md +0 -176
  52. package/.genie/agents/forge.md +0 -290
  53. package/.genie/agents/garbage-cleaner.md +0 -324
  54. package/.genie/agents/garbage-collector.md +0 -596
  55. package/.genie/agents/github-issue-gc.md +0 -618
  56. package/.genie/agents/review.md +0 -380
  57. package/.genie/agents/semantic-analyzer/find-duplicates.md +0 -90
  58. package/.genie/agents/semantic-analyzer/find-orphans.md +0 -99
  59. package/.genie/agents/semantic-analyzer.md +0 -101
  60. package/.genie/agents/update.md +0 -182
  61. package/.genie/agents/wish.md +0 -357
  62. package/.genie/brainstorms/pgserve-v2/DESIGN.md +0 -174
  63. package/.genie/code/AGENTS.md +0 -694
  64. package/.genie/code/agents/audit/risk.md +0 -173
  65. package/.genie/code/agents/audit/security.md +0 -189
  66. package/.genie/code/agents/audit.md +0 -145
  67. package/.genie/code/agents/challenge.md +0 -230
  68. package/.genie/code/agents/change-reviewer.md +0 -295
  69. package/.genie/code/agents/code-garbage-collector.md +0 -425
  70. package/.genie/code/agents/code-quality.md +0 -410
  71. package/.genie/code/agents/commit-suggester.md +0 -255
  72. package/.genie/code/agents/commit.md +0 -124
  73. package/.genie/code/agents/consensus.md +0 -204
  74. package/.genie/code/agents/daily-standup.md +0 -722
  75. package/.genie/code/agents/docgen.md +0 -48
  76. package/.genie/code/agents/explore.md +0 -79
  77. package/.genie/code/agents/fix.md +0 -100
  78. package/.genie/code/agents/git/commit-advisory.md +0 -219
  79. package/.genie/code/agents/git/workflows/issue.md +0 -244
  80. package/.genie/code/agents/git/workflows/pr.md +0 -179
  81. package/.genie/code/agents/git/workflows/release.md +0 -460
  82. package/.genie/code/agents/git/workflows/report.md +0 -342
  83. package/.genie/code/agents/git.md +0 -432
  84. package/.genie/code/agents/implementor.md +0 -161
  85. package/.genie/code/agents/install.md +0 -515
  86. package/.genie/code/agents/issue-creator.md +0 -344
  87. package/.genie/code/agents/polish.md +0 -116
  88. package/.genie/code/agents/qa.md +0 -653
  89. package/.genie/code/agents/refactor.md +0 -294
  90. package/.genie/code/agents/release.md +0 -1129
  91. package/.genie/code/agents/roadmap.md +0 -885
  92. package/.genie/code/agents/tests.md +0 -557
  93. package/.genie/code/agents/tracer.md +0 -50
  94. package/.genie/code/agents/update/upstream-update.md +0 -85
  95. package/.genie/code/agents/update/versions/generic-update.md +0 -305
  96. package/.genie/code/agents/vibe.md +0 -1317
  97. package/.genie/code/spells/agent-configuration.md +0 -58
  98. package/.genie/code/spells/automated-rc-publishing.md +0 -106
  99. package/.genie/code/spells/branch-tracker-guidance.md +0 -28
  100. package/.genie/code/spells/debug.md +0 -320
  101. package/.genie/code/spells/emoji-naming-convention.md +0 -303
  102. package/.genie/code/spells/evidence-storage.md +0 -26
  103. package/.genie/code/spells/file-naming-rules.md +0 -35
  104. package/.genie/code/spells/forge-code-blueprints.md +0 -195
  105. package/.genie/code/spells/genie-integration.md +0 -153
  106. package/.genie/code/spells/publishing-protocol.md +0 -61
  107. package/.genie/code/spells/team-consultation-protocol.md +0 -284
  108. package/.genie/code/spells/tool-requirements.md +0 -20
  109. package/.genie/code/spells/triad-maintenance-protocol.md +0 -154
  110. package/.genie/code/teams/tech-council/council.md +0 -328
  111. package/.genie/code/teams/tech-council/jt.md +0 -352
  112. package/.genie/code/teams/tech-council/nayr.md +0 -305
  113. package/.genie/code/teams/tech-council/oettam.md +0 -375
  114. package/.genie/neurons/README.md +0 -193
  115. package/.genie/neurons/forge.md +0 -106
  116. package/.genie/neurons/genie.md +0 -63
  117. package/.genie/neurons/review.md +0 -106
  118. package/.genie/neurons/wish.md +0 -104
  119. package/.genie/product/README.md +0 -20
  120. package/.genie/product/cli-automation.md +0 -359
  121. package/.genie/product/environment.md +0 -60
  122. package/.genie/product/mission.md +0 -60
  123. package/.genie/product/roadmap.md +0 -44
  124. package/.genie/product/tech-stack.md +0 -34
  125. package/.genie/product/templates/context-template.md +0 -218
  126. package/.genie/product/templates/qa-done-report-template.md +0 -68
  127. package/.genie/product/templates/review-report-template.md +0 -89
  128. package/.genie/product/templates/wish-template.md +0 -120
  129. package/.genie/scripts/helpers/analyze-commit.js +0 -195
  130. package/.genie/scripts/helpers/bullet-counter.js +0 -194
  131. package/.genie/scripts/helpers/bullet-find.js +0 -289
  132. package/.genie/scripts/helpers/bullet-id.js +0 -244
  133. package/.genie/scripts/helpers/check-secrets.js +0 -237
  134. package/.genie/scripts/helpers/count-tokens.js +0 -200
  135. package/.genie/scripts/helpers/create-frontmatter.js +0 -456
  136. package/.genie/scripts/helpers/detect-markers.js +0 -293
  137. package/.genie/scripts/helpers/detect-todos.js +0 -267
  138. package/.genie/scripts/helpers/detect-unlabeled-blocks.js +0 -135
  139. package/.genie/scripts/helpers/embeddings.js +0 -344
  140. package/.genie/scripts/helpers/find-empty-sections.js +0 -158
  141. package/.genie/scripts/helpers/index.js +0 -319
  142. package/.genie/scripts/helpers/validate-frontmatter.js +0 -578
  143. package/.genie/scripts/helpers/validate-links.js +0 -207
  144. package/.genie/scripts/helpers/validate-paths.js +0 -373
  145. package/.genie/spells/README.md +0 -9
  146. package/.genie/spells/ace-protocol.md +0 -118
  147. package/.genie/spells/ask-one-at-a-time.md +0 -175
  148. package/.genie/spells/backup-analyzer.md +0 -542
  149. package/.genie/spells/blocker.md +0 -12
  150. package/.genie/spells/break-things-move-fast.md +0 -56
  151. package/.genie/spells/context-candidates.md +0 -72
  152. package/.genie/spells/context-critic.md +0 -51
  153. package/.genie/spells/defer-to-expertise.md +0 -278
  154. package/.genie/spells/delegate-dont-do.md +0 -292
  155. package/.genie/spells/error-investigation-protocol.md +0 -328
  156. package/.genie/spells/evidence-based-completion.md +0 -273
  157. package/.genie/spells/experiment.md +0 -65
  158. package/.genie/spells/file-creation-protocol.md +0 -229
  159. package/.genie/spells/forge-integration.md +0 -281
  160. package/.genie/spells/forge-orchestration.md +0 -514
  161. package/.genie/spells/gather-context.md +0 -18
  162. package/.genie/spells/global-health-check.md +0 -34
  163. package/.genie/spells/global-noop-roundtrip.md +0 -25
  164. package/.genie/spells/install-genie.md +0 -1232
  165. package/.genie/spells/install.md +0 -82
  166. package/.genie/spells/investigate-before-commit.md +0 -112
  167. package/.genie/spells/know-yourself.md +0 -288
  168. package/.genie/spells/learn.md +0 -828
  169. package/.genie/spells/mcp-diagnostic-protocol.md +0 -246
  170. package/.genie/spells/mcp-first.md +0 -124
  171. package/.genie/spells/multi-step-execution.md +0 -67
  172. package/.genie/spells/orchestration-boundary-protocol.md +0 -256
  173. package/.genie/spells/orchestrator-not-implementor.md +0 -189
  174. package/.genie/spells/prompt.md +0 -746
  175. package/.genie/spells/reflect.md +0 -404
  176. package/.genie/spells/routing-decision-matrix.md +0 -368
  177. package/.genie/spells/run-in-parallel.md +0 -12
  178. package/.genie/spells/session-state-updater-example.md +0 -196
  179. package/.genie/spells/session-state-updater.md +0 -220
  180. package/.genie/spells/track-long-running-tasks.md +0 -133
  181. package/.genie/spells/troubleshoot-infrastructure.md +0 -176
  182. package/.genie/spells/upgrade-genie.md +0 -415
  183. package/.genie/spells/url-presentation-protocol.md +0 -301
  184. package/.genie/spells/wish-initiation.md +0 -158
  185. package/.genie/spells/wish-issue-linkage.md +0 -410
  186. package/.genie/spells/wish-lifecycle.md +0 -100
  187. package/.genie/state/provider-status.json +0 -3
  188. package/.genie/state/version.json +0 -16
  189. package/.genie/wishes/canonical-pgserve-pm2-supervision/WISH.md +0 -290
  190. package/.genie/wishes/pgserve-v2/BRIEF-from-genie-pgserve.md +0 -99
  191. package/.genie/wishes/pgserve-v2/WISH.md +0 -442
  192. package/.genie/wishes/release-system-genie-pattern/WISH.md +0 -268
  193. package/.genie/wishes/release-system-genie-pattern/validation.md +0 -205
  194. package/.gitguardian.yaml +0 -29
  195. package/.gitguardianignore +0 -16
  196. package/.github/workflows/ci.yml +0 -122
  197. package/.github/workflows/release.yml +0 -289
  198. package/.github/workflows/version.yml +0 -228
  199. package/.husky/pre-commit +0 -2
  200. package/AGENTS.md +0 -433
  201. package/CLAUDE.md +0 -1
  202. package/Makefile +0 -285
  203. package/assets/icon.ico +0 -0
  204. package/bun.lock +0 -435
  205. package/bunfig.toml +0 -28
  206. package/ecosystem.config.cjs +0 -23
  207. package/eslint.config.js +0 -63
  208. package/examples/multi-tenant-demo.js +0 -104
  209. package/install.sh +0 -123
  210. package/knip.json +0 -9
  211. package/tests/audit.test.js +0 -189
  212. package/tests/backpressure.test.js +0 -167
  213. package/tests/benchmarks/runner.js +0 -1197
  214. package/tests/benchmarks/vector-generator.js +0 -368
  215. package/tests/cli-install.test.js +0 -322
  216. package/tests/control-db.test.js +0 -285
  217. package/tests/daemon-args.test.js +0 -86
  218. package/tests/daemon-control.test.js +0 -171
  219. package/tests/daemon-fingerprint-integration.test.js +0 -111
  220. package/tests/daemon-pr24-regression.test.js +0 -198
  221. package/tests/fingerprint.test.js +0 -263
  222. package/tests/fixtures/240-orphan-seed.sql +0 -30
  223. package/tests/multi-tenant.test.js +0 -374
  224. package/tests/orphan-cleanup.test.js +0 -390
  225. package/tests/pg-version-regex.test.js +0 -129
  226. package/tests/quick-bench.js +0 -135
  227. package/tests/router-handshake-retry.test.js +0 -119
  228. package/tests/router-handshake-watchdog.test.js +0 -110
  229. package/tests/sdk.test.js +0 -71
  230. package/tests/stale-postmaster-pid.test.js +0 -85
  231. package/tests/stress-test.js +0 -439
  232. package/tests/sync-perf-test.js +0 -150
  233. package/tests/tcp-listen.test.js +0 -368
  234. package/tests/tenancy.test.js +0 -403
  235. package/tests/wrapper-supervision.test.js +0 -107
@@ -0,0 +1,611 @@
1
+ /* screens/settings.jsx — autopg console Settings vertical.
2
+ *
3
+ * Renders the 6-section settings schema (server / runtime / sync / supervision
4
+ * / postgres / ui) read from `GET /api/settings`. Type-aware controls dispatch
5
+ * on the schema descriptor's `type` (int → number input, bool → toggle, enum
6
+ * → segmented control, string → text input). The postgres section also exposes
7
+ * a raw passthrough panel (`postgres._extra`) with add/remove rows.
8
+ *
9
+ * Cross-cutting concerns:
10
+ * - sources[key] starting with "env:" → yellow OVERRIDDEN BY ENV chip
11
+ * - server-returned validation errors render inline beneath the offending row
12
+ * - 409 ETAG_MISMATCH responses surface a banner offering "reload" rather
13
+ * than overwriting the on-disk state
14
+ * - "Save & Restart" PUTs then POSTs /api/restart sequentially
15
+ *
16
+ * The schema descriptors are mirrored here from src/settings-schema.cjs. The
17
+ * UI lives at the boundary so it can render labels without an extra round-trip
18
+ * — the server is still the source of truth for validation. If the schema
19
+ * shape changes, this mirror needs updating in lockstep (Group 1's schema
20
+ * file ships as `version: 1`; this is the v1 view).
21
+ */
22
+
23
+ const SETTINGS_SCHEMA_VIEW = {
24
+ server: {
25
+ label: 'server',
26
+ hint: 'router · postgres backend',
27
+ fields: [
28
+ { key: 'port', type: 'int', label: 'router port', hint: 'TCP port clients connect to' },
29
+ { key: 'host', type: 'string', label: 'bind host', hint: 'router listen address' },
30
+ { key: 'pgPort', type: 'int', label: 'backend port', hint: 'internal postgres TCP port' },
31
+ { key: 'pgSocketPath', type: 'string', label: 'backend socket', hint: 'unix socket path (blank = TCP only)', allowEmpty: true },
32
+ { key: 'pgUser', type: 'string', label: 'backend user', hint: 'postgres superuser' },
33
+ { key: 'pgPassword', type: 'password', label: 'backend password', hint: 'stored at chmod 0600' },
34
+ ],
35
+ },
36
+ runtime: {
37
+ label: 'runtime',
38
+ hint: 'observability · cluster · auto-provisioning',
39
+ fields: [
40
+ { key: 'logLevel', type: 'enum', label: 'log level', options: ['debug', 'info', 'warn', 'error'] },
41
+ { key: 'autoProvision', type: 'bool', label: 'auto-provision', hint: 'auto-create missing databases on first connect' },
42
+ { key: 'enablePgvector', type: 'bool', label: 'enable pgvector', hint: 'load pgvector on database create' },
43
+ { key: 'dataDir', type: 'string', label: 'data dir', hint: 'PG cluster dir (blank = <configDir>/data)', allowEmpty: true },
44
+ { key: 'cluster', type: 'enum', label: 'cluster mode', options: ['auto', 'on', 'off'], hint: 'auto = on for multi-core hosts (--cluster / --no-cluster)' },
45
+ { key: 'workers', type: 'int', label: 'workers', hint: '0 = CPU cores; explicit count overrides (--workers)' },
46
+ { key: 'ramMode', type: 'bool', label: 'ram mode', hint: 'Linux only · /dev/shm storage, ~2x faster (--ram)' },
47
+ { key: 'statsDashboard', type: 'bool', label: 'TTY stats dashboard', hint: 'show live stats when running in foreground (--stats / --no-stats)' },
48
+ ],
49
+ },
50
+ sync: {
51
+ label: 'sync',
52
+ hint: 'logical replication',
53
+ fields: [
54
+ { key: 'enabled', type: 'bool', label: 'enable sync', hint: 'WAL-based logical replication; pairs with WAL GUCs below' },
55
+ { key: 'url', type: 'password', label: 'upstream URL', hint: 'postgresql://user:pass@host:port/db (--sync-to)', allowEmpty: true },
56
+ { key: 'databases', type: 'string', label: 'databases', hint: 'glob patterns, comma-separated (--sync-databases)' },
57
+ ],
58
+ },
59
+ supervision: {
60
+ label: 'supervision',
61
+ hint: 'pm2 lifecycle',
62
+ fields: [
63
+ { key: 'maxMemory', type: 'string', label: 'max memory', hint: 'pm2 memory ceiling (e.g. 4G)' },
64
+ { key: 'maxRestarts', type: 'int', label: 'max restarts', hint: 'pm2 rapid-restart cap' },
65
+ { key: 'minUptimeMs', type: 'int', label: 'min uptime (ms)', hint: 'window for healthy-start tracking' },
66
+ { key: 'restartDelayMs', type: 'int', label: 'restart delay (ms)', hint: 'pm2 fixed delay between restarts' },
67
+ { key: 'expBackoffRestartDelayMs', type: 'int', label: 'backoff start (ms)', hint: 'initial exponential-backoff delay' },
68
+ { key: 'expBackoffMaxMs', type: 'int', label: 'backoff cap (ms)', hint: 'maximum exponential-backoff value' },
69
+ { key: 'killTimeoutMs', type: 'int', label: 'kill timeout (ms)', hint: 'graceful shutdown window before SIGKILL' },
70
+ { key: 'logDateFormat', type: 'string', label: 'log date format', hint: 'pm2 log timestamp pattern' },
71
+ ],
72
+ },
73
+ security: {
74
+ label: 'security',
75
+ hint: 'control-socket peer auth',
76
+ fields: [
77
+ { key: 'handshakeDeadlineMs', type: 'int', label: 'handshake deadline (ms)', hint: 'force-close peers stuck in pre-handshake state' },
78
+ ],
79
+ },
80
+ audit: {
81
+ label: 'audit',
82
+ hint: 'event sink',
83
+ fields: [
84
+ { key: 'target', type: 'string', label: 'audit target', hint: 'JSONL file path or HTTP endpoint (blank = disabled)', allowEmpty: true },
85
+ ],
86
+ },
87
+ postgres: {
88
+ label: 'postgres GUCs',
89
+ hint: 'curated 14 + raw passthrough',
90
+ fields: [
91
+ { key: 'max_connections', type: 'int', label: 'max_connections' },
92
+ { key: 'shared_buffers', type: 'string', label: 'shared_buffers' },
93
+ { key: 'work_mem', type: 'string', label: 'work_mem' },
94
+ { key: 'maintenance_work_mem', type: 'string', label: 'maintenance_work_mem' },
95
+ { key: 'effective_cache_size', type: 'string', label: 'effective_cache_size' },
96
+ { key: 'wal_level', type: 'enum', label: 'wal_level', options: ['minimal', 'replica', 'logical'] },
97
+ { key: 'max_replication_slots', type: 'int', label: 'max_replication_slots' },
98
+ { key: 'max_wal_senders', type: 'int', label: 'max_wal_senders' },
99
+ { key: 'wal_keep_size', type: 'string', label: 'wal_keep_size' },
100
+ { key: 'log_statement', type: 'enum', label: 'log_statement', options: ['none', 'ddl', 'mod', 'all'] },
101
+ { key: 'log_min_duration_statement', type: 'int', label: 'log_min_duration_statement' },
102
+ { key: 'statement_timeout', type: 'int', label: 'statement_timeout' },
103
+ { key: 'idle_in_transaction_session_timeout', type: 'int', label: 'idle_in_transaction_session_timeout' },
104
+ { key: 'autovacuum', type: 'bool', label: 'autovacuum' },
105
+ ],
106
+ },
107
+ ui: {
108
+ label: 'console',
109
+ hint: 'theme · density · phosphor',
110
+ fields: [
111
+ { key: 'theme', type: 'enum', label: 'theme', options: ['mdr', 'lumon'] },
112
+ { key: 'phosphor', type: 'enum', label: 'phosphor', options: ['amber', 'green', 'white'] },
113
+ { key: 'density', type: 'enum', label: 'density', options: ['compact', 'comfortable', 'spacious'] },
114
+ { key: 'crt', type: 'bool', label: 'crt scanlines' },
115
+ ],
116
+ },
117
+ };
118
+
119
+ const GUC_NAME_REGEX_VIEW = /^[a-z][a-z0-9_]*$/;
120
+
121
+ function deepClone(value) {
122
+ if (value === null || value === undefined) return value;
123
+ if (typeof value !== 'object') return value;
124
+ if (Array.isArray(value)) return value.map(deepClone);
125
+ const out = {};
126
+ for (const [k, v] of Object.entries(value)) out[k] = deepClone(v);
127
+ return out;
128
+ }
129
+
130
+ function ScreenSettings({ theme: parentTheme, setTheme: parentSetTheme }) {
131
+ const [loaded, setLoaded] = useState(null);
132
+ const [form, setForm] = useState(null);
133
+ const [errors, setErrors] = useState({});
134
+ const [banner, setBanner] = useState(null); // { kind, text }
135
+ const [conflict, setConflict] = useState(false);
136
+ const [busy, setBusy] = useState(false);
137
+ const [extraRows, setExtraRows] = useState([]);
138
+ const [bootError, setBootError] = useState(null);
139
+
140
+ const reload = React.useCallback(async () => {
141
+ setBusy(true);
142
+ setBanner(null);
143
+ setConflict(false);
144
+ setBootError(null);
145
+ try {
146
+ const data = await window.AutopgApi.getSettings();
147
+ setLoaded(data);
148
+ setForm(deepClone(data.settings));
149
+ setErrors({});
150
+ // Materialize _extra map → array of rows for UI editing.
151
+ const extraMap = data?.settings?.postgres?._extra || {};
152
+ const rows = Object.entries(extraMap).map(([k, v]) => ({
153
+ id: `${k}-${Math.random().toString(36).slice(2, 6)}`,
154
+ name: k,
155
+ value: typeof v === 'string' ? v : String(v),
156
+ }));
157
+ setExtraRows(rows);
158
+ } catch (err) {
159
+ setBootError(err.message || String(err));
160
+ } finally {
161
+ setBusy(false);
162
+ }
163
+ }, []);
164
+
165
+ useEffect(() => {
166
+ if (!window.AutopgApi) return;
167
+ reload();
168
+ }, [reload]);
169
+
170
+ const dirty = useMemo(() => {
171
+ if (!loaded || !form) return false;
172
+ if (JSON.stringify(stripExtra(loaded.settings)) !== JSON.stringify(stripExtra(form))) return true;
173
+ return !sameExtraMap(loaded.settings?.postgres?._extra || {}, rowsToMap(extraRows));
174
+ }, [loaded, form, extraRows]);
175
+
176
+ const sources = loaded?.sources || {};
177
+
178
+ const setField = (section, key, value) => {
179
+ setForm((prev) => {
180
+ const next = deepClone(prev);
181
+ if (!next[section]) next[section] = {};
182
+ next[section][key] = value;
183
+ return next;
184
+ });
185
+ // Clear the field's stale error on edit.
186
+ setErrors((prev) => {
187
+ const dotted = `${section}.${key}`;
188
+ if (!(dotted in prev)) return prev;
189
+ const out = { ...prev };
190
+ delete out[dotted];
191
+ return out;
192
+ });
193
+ };
194
+
195
+ const buildPatch = () => {
196
+ if (!form) return {};
197
+ const patch = deepClone(stripExtra(form));
198
+ patch.postgres = patch.postgres || {};
199
+ patch.postgres._extra = rowsToMap(extraRows);
200
+ return patch;
201
+ };
202
+
203
+ const validateExtraClient = () => {
204
+ const out = {};
205
+ const seen = new Set();
206
+ for (const row of extraRows) {
207
+ const trimmed = (row.name || '').trim();
208
+ const dotted = `postgres._extra.${trimmed || row.id}`;
209
+ if (!trimmed) {
210
+ out[dotted] = { code: 'INVALID_GUC_NAME', message: 'name is required' };
211
+ continue;
212
+ }
213
+ if (!GUC_NAME_REGEX_VIEW.test(trimmed)) {
214
+ out[dotted] = {
215
+ code: 'INVALID_GUC_NAME',
216
+ message: 'must match /^[a-z][a-z0-9_]*$/',
217
+ };
218
+ continue;
219
+ }
220
+ if (seen.has(trimmed)) {
221
+ out[dotted] = { code: 'INVALID_GUC_NAME', message: 'duplicate key' };
222
+ continue;
223
+ }
224
+ seen.add(trimmed);
225
+ if (typeof row.value === 'string' && /[\n\r\0]/.test(row.value)) {
226
+ out[dotted] = { code: 'INVALID_GUC_VALUE', message: 'value contains forbidden control character' };
227
+ }
228
+ if (typeof row.value === 'string' && row.value.startsWith('-')) {
229
+ out[dotted] = { code: 'INVALID_GUC_VALUE', message: 'value must not start with "-"' };
230
+ }
231
+ }
232
+ return out;
233
+ };
234
+
235
+ const handleSave = async ({ thenRestart = false } = {}) => {
236
+ setBusy(true);
237
+ setBanner(null);
238
+
239
+ const clientErrors = validateExtraClient();
240
+ if (Object.keys(clientErrors).length) {
241
+ setErrors((prev) => ({ ...prev, ...clientErrors }));
242
+ setBanner({ kind: 'err', text: 'fix highlighted fields before saving' });
243
+ setBusy(false);
244
+ return;
245
+ }
246
+
247
+ try {
248
+ const patch = buildPatch();
249
+ const res = await window.AutopgApi.putSettings(patch);
250
+ setBanner({ kind: 'ok', text: thenRestart ? 'saved · restarting…' : 'saved' });
251
+ // Optimistically refresh the loaded baseline + etag so the dirty
252
+ // flag clears without a second full reload.
253
+ const next = { ...loaded, settings: deepClone(form), etag: res.etag };
254
+ next.settings.postgres = next.settings.postgres || {};
255
+ next.settings.postgres._extra = rowsToMap(extraRows);
256
+ setLoaded(next);
257
+ setErrors({});
258
+ setConflict(false);
259
+
260
+ if (thenRestart) {
261
+ try {
262
+ await window.AutopgApi.restart();
263
+ setBanner({ kind: 'ok', text: 'saved · restart triggered' });
264
+ } catch (err) {
265
+ setBanner({ kind: 'err', text: `restart failed: ${err.message || err.code}` });
266
+ }
267
+ }
268
+ // Always re-fetch so sources/etag are canonical.
269
+ await reload();
270
+ } catch (err) {
271
+ if (err.code === 'ETAG_MISMATCH') {
272
+ setConflict(true);
273
+ setBanner({ kind: 'warn', text: 'settings changed on disk — reload before saving' });
274
+ } else if (err.field) {
275
+ setErrors((prev) => ({ ...prev, [err.field]: { code: err.code, message: err.message } }));
276
+ setBanner({ kind: 'err', text: `${err.code}: ${err.field}` });
277
+ } else {
278
+ setBanner({ kind: 'err', text: err.message || String(err) });
279
+ }
280
+ } finally {
281
+ setBusy(false);
282
+ }
283
+ };
284
+
285
+ const handleDiscard = () => {
286
+ if (!loaded) return;
287
+ setForm(deepClone(loaded.settings));
288
+ const extraMap = loaded?.settings?.postgres?._extra || {};
289
+ const rows = Object.entries(extraMap).map(([k, v]) => ({
290
+ id: `${k}-${Math.random().toString(36).slice(2, 6)}`,
291
+ name: k,
292
+ value: typeof v === 'string' ? v : String(v),
293
+ }));
294
+ setExtraRows(rows);
295
+ setErrors({});
296
+ setBanner(null);
297
+ };
298
+
299
+ if (bootError) {
300
+ return (
301
+ <div className="page">
302
+ <div className="page-head"><h1>settings</h1></div>
303
+ <div className="panel" style={{ padding: 16, color: 'var(--err, #d66)' }}>
304
+ could not load settings · {bootError}
305
+ </div>
306
+ </div>
307
+ );
308
+ }
309
+ if (!loaded || !form) {
310
+ return (
311
+ <div className="page">
312
+ <div className="page-head"><h1>settings</h1></div>
313
+ <div className="panel" style={{ padding: 16 }}>loading…</div>
314
+ </div>
315
+ );
316
+ }
317
+
318
+ return (
319
+ <div className="page" style={{ maxWidth: 960 }}>
320
+ <div className="page-head">
321
+ <h1>settings</h1>
322
+ <span className="crumb">/ {loaded.path || '~/.autopg/settings.json'}</span>
323
+ <div className="right">
324
+ <Btn onClick={handleDiscard}>discard</Btn>
325
+ <Btn onClick={() => handleSave({ thenRestart: false })} title="persist to ~/.autopg/settings.json">save</Btn>
326
+ <Btn kind="primary" onClick={() => handleSave({ thenRestart: true })}>save &amp; restart</Btn>
327
+ </div>
328
+ </div>
329
+
330
+ {banner && (
331
+ <Alert
332
+ kind={banner.kind === 'ok' ? 'ok' : banner.kind === 'warn' ? 'warn' : 'err'}
333
+ label={banner.kind === 'ok' ? 'ok' : banner.kind === 'warn' ? 'note' : 'error'}
334
+ actions={conflict ? <Btn kind="primary" onClick={reload}>reload</Btn> : null}
335
+ >
336
+ {banner.text}
337
+ </Alert>
338
+ )}
339
+
340
+ {Object.entries(SETTINGS_SCHEMA_VIEW).map(([section, view]) => (
341
+ <SettingsSection
342
+ key={section}
343
+ section={section}
344
+ view={view}
345
+ values={form[section] || {}}
346
+ sources={sources}
347
+ errors={errors}
348
+ onChange={setField}
349
+ />
350
+ ))}
351
+
352
+ <ExtraPanel
353
+ rows={extraRows}
354
+ setRows={setExtraRows}
355
+ sources={sources}
356
+ errors={errors}
357
+ clearError={(name) => setErrors((p) => {
358
+ const dotted = `postgres._extra.${name}`;
359
+ if (!(dotted in p)) return p;
360
+ const out = { ...p };
361
+ delete out[dotted];
362
+ return out;
363
+ })}
364
+ />
365
+
366
+ <div style={{
367
+ marginTop: 32, paddingTop: 18, borderTop: '1px solid var(--line)',
368
+ display: 'flex', justifyContent: 'space-between',
369
+ fontSize: 11, color: 'var(--text-dim)',
370
+ }}>
371
+ <span>autopg · settings v1 · {dirty ? <span style={{ color: 'var(--accent)' }}>dirty</span> : 'clean'}</span>
372
+ <span>etag · <span style={{ color: 'var(--accent)' }}>{(loaded.etag || '').slice(0, 14)}…</span></span>
373
+ </div>
374
+ </div>
375
+ );
376
+ }
377
+
378
+ function SettingsSection({ section, view, values, sources, errors, onChange }) {
379
+ return (
380
+ <div style={{ marginBottom: 24 }}>
381
+ <BracketH hint={view.hint}>{view.label}</BracketH>
382
+ <div className="panel">
383
+ {view.fields.map((field) => (
384
+ <SettingsRow
385
+ key={field.key}
386
+ section={section}
387
+ field={field}
388
+ value={values[field.key]}
389
+ source={sources[`${section}.${field.key}`]}
390
+ error={errors[`${section}.${field.key}`]}
391
+ onChange={onChange}
392
+ />
393
+ ))}
394
+ </div>
395
+ </div>
396
+ );
397
+ }
398
+
399
+ function SettingsRow({ section, field, value, source, error, onChange }) {
400
+ const dotted = `${section}.${field.key}`;
401
+ const overridden = typeof source === 'string' && source.startsWith('env:');
402
+ return (
403
+ <div style={{ padding: '12px 0', borderBottom: '1px dashed var(--line)' }}>
404
+ <div style={{
405
+ display: 'grid', gridTemplateColumns: '220px 1fr', gap: 16, alignItems: 'center',
406
+ }}>
407
+ <div>
408
+ <div style={{ fontSize: 12, color: 'var(--text-primary)' }}>
409
+ {field.label}
410
+ {overridden && (
411
+ <span
412
+ title={`source: ${source}`}
413
+ style={{
414
+ marginLeft: 8, padding: '1px 6px', fontSize: 9,
415
+ letterSpacing: '0.08em', textTransform: 'uppercase',
416
+ background: 'var(--c-audit, #D6A574)', color: '#1f1a0c',
417
+ borderRadius: 3,
418
+ }}
419
+ >
420
+ overridden by env
421
+ </span>
422
+ )}
423
+ </div>
424
+ {field.hint && <div style={{ fontSize: 11, color: 'var(--text-dim)', marginTop: 2 }}>{field.hint}</div>}
425
+ </div>
426
+ <div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
427
+ <FieldControl
428
+ field={field}
429
+ value={value}
430
+ disabled={overridden}
431
+ onChange={(v) => onChange(section, field.key, v)}
432
+ />
433
+ <span style={{ fontSize: 10, color: 'var(--text-dim)', marginLeft: 'auto' }}>
434
+ {source || 'default'}
435
+ </span>
436
+ </div>
437
+ </div>
438
+ {error && (
439
+ <div style={{
440
+ marginTop: 6, marginLeft: 236, fontSize: 11, color: 'var(--err, #d66)',
441
+ }}>
442
+ {error.code}: {error.message}
443
+ </div>
444
+ )}
445
+ </div>
446
+ );
447
+ }
448
+
449
+ function FieldControl({ field, value, disabled, onChange }) {
450
+ if (field.type === 'bool') {
451
+ return (
452
+ <Seg
453
+ value={value ? 'on' : 'off'}
454
+ onChange={(v) => onChange(v === 'on')}
455
+ options={[{ value: 'off', label: 'OFF' }, { value: 'on', label: 'ON' }]}
456
+ />
457
+ );
458
+ }
459
+ if (field.type === 'enum') {
460
+ return (
461
+ <Seg
462
+ value={value}
463
+ onChange={onChange}
464
+ options={field.options.map((o) => ({ value: o, label: o.toUpperCase() }))}
465
+ />
466
+ );
467
+ }
468
+ if (field.type === 'int') {
469
+ return (
470
+ <input
471
+ className="input"
472
+ type="number"
473
+ value={value ?? ''}
474
+ disabled={disabled}
475
+ style={{ width: 160 }}
476
+ onChange={(e) => {
477
+ const raw = e.target.value;
478
+ if (raw === '') return onChange(null);
479
+ const n = Number.parseInt(raw, 10);
480
+ if (Number.isFinite(n)) onChange(n);
481
+ }}
482
+ />
483
+ );
484
+ }
485
+ if (field.type === 'password') {
486
+ return (
487
+ <input
488
+ className="input"
489
+ type="password"
490
+ value={value ?? ''}
491
+ disabled={disabled}
492
+ style={{ width: 240 }}
493
+ onChange={(e) => onChange(e.target.value)}
494
+ />
495
+ );
496
+ }
497
+ return (
498
+ <input
499
+ className="input"
500
+ type="text"
501
+ value={value ?? ''}
502
+ disabled={disabled}
503
+ style={{ width: 240 }}
504
+ onChange={(e) => onChange(e.target.value)}
505
+ />
506
+ );
507
+ }
508
+
509
+ function ExtraPanel({ rows, setRows, sources, errors, clearError }) {
510
+ const addRow = () => {
511
+ setRows((prev) => [
512
+ ...prev,
513
+ { id: `new-${Math.random().toString(36).slice(2, 8)}`, name: '', value: '' },
514
+ ]);
515
+ };
516
+ const removeRow = (id) => setRows((prev) => prev.filter((r) => r.id !== id));
517
+ const updateRow = (id, patch) => setRows((prev) => prev.map((r) => (r.id === id ? { ...r, ...patch } : r)));
518
+
519
+ return (
520
+ <div style={{ marginBottom: 24 }}>
521
+ <BracketH hint="raw -c key=value passthrough; validated against /^[a-z][a-z0-9_]*$/">postgres._extra</BracketH>
522
+ <div className="panel">
523
+ {rows.length === 0 && (
524
+ <div style={{ padding: '12px 0', color: 'var(--text-dim)', fontSize: 11 }}>
525
+ no raw GUCs configured. add one to forward an unsupported `-c key=value` to postgres.
526
+ </div>
527
+ )}
528
+ {rows.map((row) => {
529
+ const dotted = `postgres._extra.${row.name}`;
530
+ const error = errors[dotted];
531
+ const source = sources[dotted];
532
+ const overridden = typeof source === 'string' && source.startsWith('env:');
533
+ return (
534
+ <div key={row.id} style={{ padding: '8px 0', borderBottom: '1px dashed var(--line)' }}>
535
+ <div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
536
+ <input
537
+ className="input"
538
+ type="text"
539
+ placeholder="guc_name"
540
+ value={row.name}
541
+ style={{ width: 240 }}
542
+ onChange={(e) => {
543
+ clearError(row.name);
544
+ updateRow(row.id, { name: e.target.value });
545
+ }}
546
+ />
547
+ <span style={{ color: 'var(--text-dim)' }}>=</span>
548
+ <input
549
+ className="input"
550
+ type="text"
551
+ placeholder="value"
552
+ value={row.value}
553
+ style={{ flex: 1 }}
554
+ onChange={(e) => {
555
+ clearError(row.name);
556
+ updateRow(row.id, { value: e.target.value });
557
+ }}
558
+ />
559
+ {overridden && (
560
+ <span style={{
561
+ padding: '1px 6px', fontSize: 9, letterSpacing: '0.08em', textTransform: 'uppercase',
562
+ background: 'var(--c-audit, #D6A574)', color: '#1f1a0c', borderRadius: 3,
563
+ }}>overridden by env</span>
564
+ )}
565
+ <Btn size="sm" onClick={() => removeRow(row.id)}>remove</Btn>
566
+ </div>
567
+ {error && (
568
+ <div style={{ marginTop: 4, fontSize: 11, color: 'var(--err, #d66)' }}>
569
+ {error.code}: {error.message}
570
+ </div>
571
+ )}
572
+ </div>
573
+ );
574
+ })}
575
+ <div style={{ paddingTop: 12 }}>
576
+ <Btn size="sm" onClick={addRow}>+ add row</Btn>
577
+ </div>
578
+ </div>
579
+ </div>
580
+ );
581
+ }
582
+
583
+ function stripExtra(settings) {
584
+ if (!settings) return settings;
585
+ const out = deepClone(settings);
586
+ if (out.postgres) delete out.postgres._extra;
587
+ return out;
588
+ }
589
+
590
+ function rowsToMap(rows) {
591
+ const out = {};
592
+ for (const row of rows) {
593
+ const name = (row.name || '').trim();
594
+ if (!name) continue;
595
+ out[name] = row.value;
596
+ }
597
+ return out;
598
+ }
599
+
600
+ function sameExtraMap(a, b) {
601
+ const ak = Object.keys(a).sort();
602
+ const bk = Object.keys(b).sort();
603
+ if (ak.length !== bk.length) return false;
604
+ for (let i = 0; i < ak.length; i++) {
605
+ if (ak[i] !== bk[i]) return false;
606
+ if (String(a[ak[i]]) !== String(b[bk[i]])) return false;
607
+ }
608
+ return true;
609
+ }
610
+
611
+ window.ScreenSettings = ScreenSettings;
@@ -0,0 +1,5 @@
1
+ /* screens/sql.jsx — placeholder. */
2
+ function ScreenSQL() {
3
+ return window.ComingSoon({ title: 'sql editor', crumb: '/ multi-tab · history · explain' });
4
+ }
5
+ window.ScreenSQL = ScreenSQL;
@@ -0,0 +1,5 @@
1
+ /* screens/sync.jsx — placeholder. */
2
+ function ScreenSync() {
3
+ return window.ComingSoon({ title: 'sync & backups', crumb: '/ logical replication · snapshots' });
4
+ }
5
+ window.ScreenSync = ScreenSync;
@@ -0,0 +1,5 @@
1
+ /* screens/tables.jsx — placeholder. */
2
+ function ScreenTables() {
3
+ return window.ComingSoon({ title: 'tables', crumb: '/ schema · columns · indexes' });
4
+ }
5
+ window.ScreenTables = ScreenTables;