@lawaty/lacode 2.3.0-beta.2 → 2.3.0-beta.3

package/CHANGELOG.md

@@ -9,6 +9,20 @@ commit as the changelog entry it describes.
 
 ## [Unreleased]
 
+## [2.3.0-beta.3] — persist autonomy modes in global config
+
+### Changed
+
+- Modes: YOLO/YKB modes now persist in the lacode plugin options inside the global `opencode.jsonc` (single config file, comment-preserving edits).
+
+### Removed
+
+- Modes: removed `~/.config/lacode/modes.json` and `LACODE_MODES_FILE` seeding.
+
+### Fixed
+
+- Build: externalized the `jsonc-parser` runtime dependency.
+
 ## [2.3.0-beta.2] — degenerate refreshes never shrink the pool
 
 ### Added
@@ -1226,6 +1240,10 @@ experimental; `latest` remains 0.4.2.
 [Unreleased]: https://github.com/lawaty/lacode/compare/v2.1.0-beta.0...HEAD
 [2.1.0-beta.0]: https://github.com/lawaty/lacode/compare/v2.0.0-beta.0...v2.1.0-beta.0
 [2.0.0-beta.0]: https://github.com/lawaty/lacode/compare/v1.3.1...v2.0.0-beta.0
+[2.3.0-beta.3]: https://github.com/lawaty/lacode/compare/v2.3.0-beta.2...v2.3.0-beta.3
+[2.3.0-beta.2]: https://github.com/lawaty/lacode/compare/v2.3.0-beta.1...v2.3.0-beta.2
+[2.3.0-beta.1]: https://github.com/lawaty/lacode/compare/v2.3.0-beta.0...v2.3.0-beta.1
+[2.3.0-beta.0]: https://github.com/lawaty/lacode/releases/tag/v2.3.0-beta.0
 [1.3.1]: https://github.com/lawaty/lacode/releases/tag/v1.3.1
 [1.3.0-beta.9]: https://github.com/lawaty/lacode/releases/tag/v1.3.0-beta.9
 [1.3.0-beta.8]: https://github.com/lawaty/lacode/releases/tag/v1.3.0-beta.8

package/README.md

@@ -156,15 +156,15 @@ option is optional:
 | `feedbackHint` | `true` | Show the one-time feedback note on the first interactive run. `false` — or `LACODE_NO_FEEDBACK_HINT=1` — turns it off. The flag lives in `~/.local/share/opencode/lacode/feedback.json`; nothing is sent anywhere. |
 | `sound` | `true` | Play a short tone with each notification, one per outcome, so you can tell a finished session from a question or a permission prompt without reading the popup. It is opt-out: `false` — or `LACODE_SOUND=0` (`false`, `off`, `no` work too, and beat the option) — turns the sound off, and anything else, a typo included, leaves it on. |
 | `omniroute` | — | Optional [OmniRoute](docs/OMNIROUTE.md) gateway integration. Absent or `{ enabled: false }` changes nothing. |
-| `yolo` | `false` | Start with YOLO mode on: permission requests that would ask are auto-approved. Explicit `deny` rules still win. Toggle live with `/yolo`. |
-| `ykb` | `false` | Start with YKB (You Know Better) mode on: the agent is told not to ask, and questions that still appear are answered with the recommended option. Toggle live with `/ykb`. |
+| `yolo` | `false` | YOLO mode: permission requests that would ask are auto-approved. Explicit `deny` rules still win. The TUI writes this option when you run `/yolo`. |
+| `ykb` | `false` | YKB (You Know Better) mode: the agent is told not to ask, and questions that still appear are answered with the recommended option. The TUI writes this option when you run `/ykb`. |
 | `watchMs` | `1000` | How often the pool files are checked for changes. `0` disables live reload. |
 | `watchDebounceMs` | `250` | Collapse a burst of editor writes into one reload. |
 | `imagePaste` | — | Image attachments: `maxBytes` (4 MiB), `maxImages` (10) and `dir`. |
 
 ## Modes
 
-Two runtime modes can be seeded from plugin options and toggled from the TUI:
+Two runtime modes live on the lacode plugin entry and can be toggled from the TUI:
 
 | Command | Effect |
 | --- | --- |
@@ -172,7 +172,15 @@ Two runtime modes can be seeded from plugin options and toggled from the TUI:
 | `/ykb` | Toggle YKB (You Know Better). The agent is told not to ask questions and to continue with its recommendation. A question that still appears is answered with its `(Recommended)` option, or its first option when none is marked. |
 | `/modes` | Show both switches. |
 
-The toggles write `~/.config/lacode/modes.json` (override with `LACODE_MODES_FILE`) and the server picks the change up on the next decision — no restart. Turning a mode on also answers requests that are already pending. The `yolo` / `ykb` plugin options only seed the file on first run; after that, the file wins. A free-text question with no options is left for the user, since there is no option to choose.
+```jsonc
+{
+  "plugin": [
+    ["@lawaty/lacode", { "yolo": true, "ykb": false }]
+  ]
+}
+```
+
+The toggles edit the `yolo` / `ykb` options on the lacode plugin entry in your global opencode config (`~/.config/opencode/opencode.jsonc`, or `$XDG_CONFIG_HOME/opencode/opencode.jsonc`), preserving comments. The server reads that file on the next decision — no restart. Turning a mode on also answers requests that are already pending. The lacode plugin entry must already exist in the global config; a project-only entry cannot be toggled. A free-text question with no options is left for the user, since there is no option to choose.
 
 ### Staying up to date
 

package/dist/index.js

@@ -2282,9 +2282,9 @@ var STATE_DIR = join3(homedir2(), ".local", "share", "opencode", "lacode");
 var STATE_PATH = join3(STATE_DIR, "selfupdate.json");
 var LOCK_PATH = join3(STATE_DIR, "selfupdate.lock");
 function compareSemver(a, b) {
-  const parse = (v) => v.split("-")[0].split("+")[0].split(".").map((n) => Number.parseInt(n, 10) || 0);
-  const left = parse(a);
-  const right = parse(b);
+  const parse2 = (v) => v.split("-")[0].split("+")[0].split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const left = parse2(a);
+  const right = parse2(b);
   for (let i = 0; i < 3; i++) {
     const l = left[i] ?? 0;
     const r = right[i] ?? 0;
@@ -6167,35 +6167,82 @@ async function imagePasteHooks(input, options, deps) {
   }
 }
 
-// src/lib/modes.ts
+// src/lib/opencode-config.ts
 import { existsSync as existsSync5, mkdirSync as mkdirSync9, readFileSync as readFileSync10, renameSync as renameSync7, writeFileSync as writeFileSync10 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
 import { dirname as dirname6, join as join12 } from "node:path";
-var MODES_FILE = process.env.LACODE_MODES_FILE ?? join12(homedir8(), ".config", "lacode", "modes.json");
+import { applyEdits, modify, parse, printParseErrorCode } from "jsonc-parser";
+function globalOpencodeConfigPath() {
+  const base = process.env.XDG_CONFIG_HOME ?? join12(homedir8(), ".config");
+  const jsonc = join12(base, "opencode", "opencode.jsonc");
+  return existsSync5(jsonc) ? jsonc : join12(base, "opencode", "opencode.json");
+}
+var OpenCodeConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OpenCodeConfigError";
+  }
+};
+function isPlainObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function readOpencodeConfig(path4 = globalOpencodeConfigPath()) {
+  if (!existsSync5(path4)) return {};
+  const text = readFileSync10(path4, "utf8");
+  const errors = [];
+  const parsed = parse(text, errors, { allowTrailingComma: true, disallowComments: false });
+  if (errors.length > 0) {
+    const detail = errors.map((e) => `${printParseErrorCode(e.error)} at offset ${e.offset}`).join(", ");
+    throw new OpenCodeConfigError(`Failed to parse ${path4}: ${detail}`);
+  }
+  if (!isPlainObject(parsed)) {
+    throw new OpenCodeConfigError(`Config root must be an object: ${path4}`);
+  }
+  return parsed;
+}
+function pluginName(entry) {
+  if (typeof entry === "string") return entry;
+  if (Array.isArray(entry) && typeof entry[0] === "string") return entry[0];
+  return void 0;
+}
+function matchesLacode(name) {
+  if (name === "@lawaty/lacode") return true;
+  const segments = name.split(/[\\/]/);
+  return segments.some((s) => s.toLowerCase() === "lacode");
+}
+function findLacodePlugin(config) {
+  const plugins = config.plugin;
+  if (!Array.isArray(plugins)) return void 0;
+  for (let index = 0; index < plugins.length; index++) {
+    const entry = plugins[index];
+    const name = pluginName(entry);
+    if (!name || !matchesLacode(name)) continue;
+    const options = Array.isArray(entry) && isPlainObject(entry[1]) ? entry[1] : void 0;
+    return { index, name, options };
+  }
+  return void 0;
+}
+function readModeOptions(config = readOpencodeConfig()) {
+  const entry = findLacodePlugin(config);
+  const options = entry?.options;
+  const yolo = typeof options?.yolo === "boolean" ? options.yolo : void 0;
+  const ykb = typeof options?.ykb === "boolean" ? options.ykb : void 0;
+  return { yolo, ykb };
+}
+
+// src/lib/modes.ts
 var YKB_INSTRUCTION = "YKB MODE (You Know Better) is ON. Do not ask the user questions, request clarification, or wait for confirmation. When a decision is needed, choose the option you would recommend, state the choice briefly, and continue until the task is complete. Stop only if you are genuinely blocked by a missing credential, an unrecoverable error, or a permission that cannot be granted.";
-var bool = (value, fallback) => typeof value === "boolean" ? value : fallback;
 function readModes(defaults = {}) {
-  const fallback = { yolo: defaults.yolo === true, ykb: defaults.ykb === true };
   try {
-    const raw = JSON.parse(readFileSync10(MODES_FILE, "utf8"));
-    return { yolo: bool(raw?.yolo, fallback.yolo), ykb: bool(raw?.ykb, fallback.ykb) };
+    const options = readModeOptions();
+    return {
+      yolo: options.yolo ?? defaults.yolo === true,
+      ykb: options.ykb ?? defaults.ykb === true
+    };
   } catch {
-    return fallback;
+    return { yolo: defaults.yolo === true, ykb: defaults.ykb === true };
   }
 }
-function writeModes(modes) {
-  const path4 = MODES_FILE;
-  mkdirSync9(dirname6(path4), { recursive: true });
-  const tmp = `${path4}.tmp`;
-  writeFileSync10(tmp, `${JSON.stringify({ yolo: modes.yolo, ykb: modes.ykb }, null, 2)}
-`);
-  renameSync7(tmp, path4);
-}
-function seedModes(defaults) {
-  if (existsSync5(MODES_FILE)) return;
-  if (defaults.yolo !== true && defaults.ykb !== true) return;
-  writeModes({ yolo: defaults.yolo === true, ykb: defaults.ykb === true });
-}
 function recommendedAnswer(question) {
   const q = question;
   const options = (Array.isArray(q?.options) ? q.options : []).filter(
@@ -6214,7 +6261,6 @@ async function modesHooks(input, options) {
   const defaults = {};
   if (typeof opts.yolo === "boolean") defaults.yolo = opts.yolo;
   if (typeof opts.ykb === "boolean") defaults.ykb = opts.ykb;
-  seedModes(defaults);
   const state2 = () => readModes(defaults);
   const warn2 = (message) => {
     input.client.app.log({ body: { service: "modes", level: "warn", message } }).catch(() => {

package/dist/tui.js

@@ -943,28 +943,129 @@ var plugin = {
 };
 var timeline_default = plugin;
 
-// src/lib/modes.ts
+// src/lib/opencode-config.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync3, renameSync, writeFileSync } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { dirname, join as join4 } from "node:path";
-var MODES_FILE = process.env.LACODE_MODES_FILE ?? join4(homedir3(), ".config", "lacode", "modes.json");
-var bool = (value, fallback) => typeof value === "boolean" ? value : fallback;
+import { applyEdits, modify, parse, printParseErrorCode } from "jsonc-parser";
+function globalOpencodeConfigPath() {
+  const base = process.env.XDG_CONFIG_HOME ?? join4(homedir3(), ".config");
+  const jsonc = join4(base, "opencode", "opencode.jsonc");
+  return existsSync2(jsonc) ? jsonc : join4(base, "opencode", "opencode.json");
+}
+var OpenCodeConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OpenCodeConfigError";
+  }
+};
+function isPlainObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function readOpencodeConfig(path = globalOpencodeConfigPath()) {
+  if (!existsSync2(path)) return {};
+  const text = readFileSync3(path, "utf8");
+  const errors = [];
+  const parsed = parse(text, errors, { allowTrailingComma: true, disallowComments: false });
+  if (errors.length > 0) {
+    const detail = errors.map((e) => `${printParseErrorCode(e.error)} at offset ${e.offset}`).join(", ");
+    throw new OpenCodeConfigError(`Failed to parse ${path}: ${detail}`);
+  }
+  if (!isPlainObject(parsed)) {
+    throw new OpenCodeConfigError(`Config root must be an object: ${path}`);
+  }
+  return parsed;
+}
+function pluginName(entry) {
+  if (typeof entry === "string") return entry;
+  if (Array.isArray(entry) && typeof entry[0] === "string") return entry[0];
+  return void 0;
+}
+function matchesLacode(name) {
+  if (name === "@lawaty/lacode") return true;
+  const segments = name.split(/[\\/]/);
+  return segments.some((s) => s.toLowerCase() === "lacode");
+}
+function findLacodePlugin(config) {
+  const plugins = config.plugin;
+  if (!Array.isArray(plugins)) return void 0;
+  for (let index = 0; index < plugins.length; index++) {
+    const entry = plugins[index];
+    const name = pluginName(entry);
+    if (!name || !matchesLacode(name)) continue;
+    const options = Array.isArray(entry) && isPlainObject(entry[1]) ? entry[1] : void 0;
+    return { index, name, options };
+  }
+  return void 0;
+}
+function readModeOptions(config = readOpencodeConfig()) {
+  const entry = findLacodePlugin(config);
+  const options = entry?.options;
+  const yolo = typeof options?.yolo === "boolean" ? options.yolo : void 0;
+  const ykb = typeof options?.ykb === "boolean" ? options.ykb : void 0;
+  return { yolo, ykb };
+}
+function writeModeOptions(patch, path = globalOpencodeConfigPath()) {
+  if (!existsSync2(path)) {
+    throw new OpenCodeConfigError(`Cannot write mode options: config does not exist: ${path}`);
+  }
+  let text = readFileSync3(path, "utf8");
+  const errors = [];
+  const parsed = parse(text, errors, { allowTrailingComma: true, disallowComments: false });
+  if (errors.length > 0) {
+    const detail = errors.map((e) => `${printParseErrorCode(e.error)} at offset ${e.offset}`).join(", ");
+    throw new OpenCodeConfigError(`Failed to parse ${path}: ${detail}`);
+  }
+  if (!isPlainObject(parsed)) {
+    throw new OpenCodeConfigError(`Config root must be an object: ${path}`);
+  }
+  const entry = findLacodePlugin(parsed);
+  if (!entry) {
+    throw new OpenCodeConfigError(`lacode plugin entry not found in ${path}`);
+  }
+  const formattingOptions = { insertSpaces: true, tabSize: 2, eol: "\n" };
+  const pluginEntry = parsed.plugin[entry.index];
+  if (typeof pluginEntry === "string") {
+    const obj = {};
+    if (patch.yolo !== void 0) obj.yolo = patch.yolo;
+    if (patch.ykb !== void 0) obj.ykb = patch.ykb;
+    const edits = modify(text, ["plugin", entry.index], [entry.name, obj], { formattingOptions });
+    text = applyEdits(text, edits);
+  } else if (Array.isArray(pluginEntry) && !isPlainObject(pluginEntry[1])) {
+    const obj = {};
+    if (patch.yolo !== void 0) obj.yolo = patch.yolo;
+    if (patch.ykb !== void 0) obj.ykb = patch.ykb;
+    const edits = modify(text, ["plugin", entry.index, 1], obj, { formattingOptions });
+    text = applyEdits(text, edits);
+  } else {
+    const keys = ["yolo", "ykb"];
+    for (const key of keys) {
+      const value = patch[key];
+      if (value === void 0) continue;
+      const edits = modify(text, ["plugin", entry.index, 1, key], value, { formattingOptions });
+      text = applyEdits(text, edits);
+    }
+  }
+  mkdirSync(dirname(path), { recursive: true });
+  const tmp = `${path}.tmp`;
+  writeFileSync(tmp, text);
+  renameSync(tmp, path);
+}
+
+// src/lib/modes.ts
 function readModes(defaults = {}) {
-  const fallback = { yolo: defaults.yolo === true, ykb: defaults.ykb === true };
   try {
-    const raw = JSON.parse(readFileSync3(MODES_FILE, "utf8"));
-    return { yolo: bool(raw?.yolo, fallback.yolo), ykb: bool(raw?.ykb, fallback.ykb) };
+    const options = readModeOptions();
+    return {
+      yolo: options.yolo ?? defaults.yolo === true,
+      ykb: options.ykb ?? defaults.ykb === true
+    };
   } catch {
-    return fallback;
+    return { yolo: defaults.yolo === true, ykb: defaults.ykb === true };
   }
 }
 function writeModes(modes) {
-  const path = MODES_FILE;
-  mkdirSync(dirname(path), { recursive: true });
-  const tmp = `${path}.tmp`;
-  writeFileSync(tmp, `${JSON.stringify({ yolo: modes.yolo, ykb: modes.ykb }, null, 2)}
-`);
-  renameSync(tmp, path);
+  writeModeOptions({ yolo: modes.yolo, ykb: modes.ykb });
 }
 function toggleMode(name, defaults = {}) {
   const current = readModes(defaults);

package/docs/CONFIGURATION.md

@@ -52,7 +52,7 @@ restart.
 
 ## Modes
 
-Two runtime modes can be seeded from plugin options and toggled from the TUI:
+Two runtime modes live on the lacode plugin entry and can be toggled from the TUI:
 
 | Command | Effect |
 | --- | --- |
@@ -60,7 +60,15 @@ Two runtime modes can be seeded from plugin options and toggled from the TUI:
 | `/ykb` | Toggle YKB (You Know Better). The agent is told not to ask questions and to continue with its recommendation. A question that still appears is answered with its `(Recommended)` option, or its first option when none is marked. |
 | `/modes` | Show both switches. |
 
-The toggles write `~/.config/lacode/modes.json` (override with `LACODE_MODES_FILE`) and the server picks the change up on the next decision — no restart. Turning a mode on also answers requests that are already pending. The `yolo` / `ykb` plugin options only seed the file on first run; after that, the file wins. A free-text question with no options is left for the user, since there is no option to choose.
+```jsonc
+{
+  "plugin": [
+    ["@lawaty/lacode", { "yolo": true, "ykb": false }]
+  ]
+}
+```
+
+The toggles edit the `yolo` / `ykb` options on the lacode plugin entry in your global opencode config (`~/.config/opencode/opencode.jsonc`, or `$XDG_CONFIG_HOME/opencode/opencode.jsonc`), preserving comments. The server reads that file on the next decision — no restart. Turning a mode on also answers requests that are already pending. The lacode plugin entry must already exist in the global config; a project-only entry cannot be toggled. A free-text question with no options is left for the user, since there is no option to choose.
 
 
 ## Which models run which agent

package/docs/USER-STORIES.md

@@ -569,15 +569,15 @@ A failed summarization used to clear the pending flag and never reschedule, so o
 ### US-37: YOLO mode approves permissions without stopping
 **As a** user running a long autonomous task, **I want** permission prompts to be approved automatically while YOLO is on, **so that** the agent keeps working instead of waiting for routine approvals, while an explicit `deny` still protects me.
 
-Permission prompts are the main thing that breaks a long autonomous run: every `ask` blocks the session until a human answers. YOLO flips that decision to `allow` at the permission hook, keeps an explicit `deny` authoritative, and answers any request that still reaches the event bus. The state is a small file the TUI writes and the server reads on the next decision, so enabling it also clears what is already pending.
+Permission prompts are the main thing that breaks a long autonomous run: every `ask` blocks the session until a human answers. YOLO flips that decision to `allow` at the permission hook, keeps an explicit `deny` authoritative, and answers any request that still reaches the event bus. The state lives in the `yolo` option on the lacode plugin entry in the global `opencode.jsonc`; the TUI writes it and the server reads it on the next decision, so enabling it also clears what is already pending.
 
 **Story ID(s) for tests:** US-37
 **Acceptance criteria:**
 - [ ] Given YOLO is on, When the runtime's permission decision is `ask`, Then it becomes `allow` without a prompt, while an existing `deny` or `allow` is left unchanged.
 - [ ] Given YOLO is off, When the runtime's permission decision is `ask`, Then it stays `ask` and still reaches the user.
 - [ ] Given a `permission.asked` event still reaches the event bus while YOLO is on and carries a request id and a session id, When the handler runs, Then the plugin replies `once` for that request; an event missing either id is ignored.
-- [ ] Given YOLO is toggled in the TUI, When the mode file changes, Then the next permission decision sees the new value without a restart, and requests already pending are answered.
-- [ ] Given `yolo: true` in the plugin options and no live mode file, When the plugin starts, Then the file is seeded; after a TUI toggle, the live file wins.
+- [ ] Given YOLO is toggled in the TUI, When the global `opencode.jsonc` changes, Then the next permission decision sees the new value without a restart, and requests already pending are answered.
+- [ ] Given the TUI toggles a mode, When it writes the global `opencode.jsonc`, Then only the `yolo` / `ykb` options on the lacode plugin entry change, comments and formatting are preserved, and the config remains the single source of truth.
 - [ ] Given the README and configuration reference, Then the `yolo` option and the `/yolo` command are documented alongside `/modes`.
 
 ### US-38: YKB mode chooses the recommendation instead of asking
@@ -654,6 +654,6 @@ The root-level suites under `tests/` are unit-style; the `tests/stories/` suites
 the behavioural layer, written one epic per file with every test name carrying
 its story id. Run everything with `npm test`.
 
-40/40 stories covered by 375 test case(s); thinnest story has 1.
+40/40 stories covered by 376 test case(s); thinnest story has 1.
 No story is untested. The scan covers the `tests/stories/` suites and the root-level
 `tests/*-test.mjs` suites.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawaty/lacode",
-  "version": "2.3.0-beta.2",
+  "version": "2.3.0-beta.3",
   "description": "Ultimate opencode setup for Go users — cost-controlled pooled subagents, hang recovery, and notifications for opencode.",
   "license": "MIT",
   "type": "module",
@@ -68,8 +68,8 @@
   },
   "peerDependencies": {
     "@opencode-ai/plugin": "1.18.34",
-    "solid-js": "*",
-    "@opentui/solid": "*"
+    "@opentui/solid": "*",
+    "solid-js": "*"
   },
   "peerDependenciesMeta": {
     "solid-js": {
@@ -85,5 +85,8 @@
   },
   "publishConfig": {
     "tag": "latest"
+  },
+  "dependencies": {
+    "jsonc-parser": "^3.3.1"
   }
 }