@osovv/vv-opencode 1.4.5 → 1.6.0

package/dist/lib/opencode/paths.d.ts

@@ -0,0 +1,21 @@
+export type Scope = "global" | "project";
+export type ResolvedPaths = {
+    scope: Scope;
+    cwd: string;
+    configHome: string;
+    projectRoot?: string;
+    opencodeBaseDir: string;
+    vvocBaseDir: string;
+    vvocConfigPath: string;
+    managedAgentsDirPath: string;
+    managedSkillsDirPath: string;
+    opencodeConfigPath: string;
+    opencodeAlternatePaths: string[];
+    opencodeTuiConfigPath: string;
+    opencodeTuiAlternatePaths: string[];
+};
+export declare function resolvePaths(options: {
+    scope: Scope;
+    cwd: string;
+    configDir?: string;
+}): Promise<ResolvedPaths>;

package/dist/lib/opencode/paths.js

@@ -0,0 +1,62 @@
+// FILE: src/lib/opencode/paths.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Scope-aware path resolution for OpenCode runtime/TUI and vvoc config locations.
+//   SCOPE: Global/project write-target resolution, managed agents/skills directory derivation, alternate config file discovery for opencode.json(c) and tui.json(c), and the Scope/ResolvedPaths contract shared by every config-mutating zone.
+//   DEPENDS: [node:path, src/lib/config-layers.ts, src/lib/vvoc-paths.ts, src/lib/opencode/shared-utils.ts]
+//   LINKS: [M-CLI-CONFIG, M-CONFIG-LAYERS]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   Scope - Supported installation scopes for vvoc config writes.
+//   ResolvedPaths - Scope-aware path bundle for OpenCode runtime/TUI and vvoc config locations.
+//   resolvePaths - Resolves OpenCode runtime/TUI and vvoc config paths for global/project scopes.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-OPENCODE-MODULE-SPLIT - Extracted path resolution and alternate-config discovery from the former src/lib/opencode.ts monolith into this zone module.]
+// END_CHANGE_SUMMARY
+import { join } from "node:path";
+import { resolveConfigWriteTargets } from "../config-layers.js";
+import { getConfigHome, getVvocAgentsDir, getVvocSkillsDir } from "../vvoc-paths.js";
+import { readOptionalText } from "./shared-utils.js";
+const OPENCODE_CONFIG_FILE_NAMES = ["opencode.json", "opencode.jsonc"];
+const OPENCODE_TUI_CONFIG_FILE_NAMES = ["tui.json", "tui.jsonc"];
+// START_BLOCK_RESOLVE_CONFIG_PATHS
+export async function resolvePaths(options) {
+    const targets = await resolveConfigWriteTargets(options);
+    const configHome = getConfigHome(options.configDir);
+    const managedAgentsDirPath = getVvocAgentsDir(targets.vvocBaseDir);
+    const managedSkillsDirPath = getVvocSkillsDir(targets.vvocBaseDir);
+    return {
+        scope: options.scope,
+        cwd: options.cwd,
+        configHome,
+        projectRoot: targets.projectRoot,
+        opencodeBaseDir: targets.opencodeBaseDir,
+        vvocBaseDir: targets.vvocBaseDir,
+        vvocConfigPath: targets.vvocConfigPath,
+        managedAgentsDirPath,
+        managedSkillsDirPath,
+        opencodeConfigPath: targets.opencodeConfigPath,
+        opencodeAlternatePaths: await resolveOpenCodeAlternates(targets.opencodeBaseDir, targets.opencodeConfigPath),
+        opencodeTuiConfigPath: targets.opencodeTuiConfigPath,
+        opencodeTuiAlternatePaths: await resolveConfigAlternates(targets.opencodeBaseDir, targets.opencodeTuiConfigPath, OPENCODE_TUI_CONFIG_FILE_NAMES),
+    };
+}
+async function resolveOpenCodeAlternates(opencodeBaseDir, selectedPath) {
+    return resolveConfigAlternates(opencodeBaseDir, selectedPath, OPENCODE_CONFIG_FILE_NAMES);
+}
+async function resolveConfigAlternates(baseDir, selectedPath, fileNames) {
+    const alternates = [];
+    for (const candidate of fileNames.map((name) => join(baseDir, name))) {
+        if (candidate !== selectedPath && (await readOptionalText(candidate)) !== undefined) {
+            alternates.push(candidate);
+        }
+    }
+    return alternates;
+}
+// END_BLOCK_RESOLVE_CONFIG_PATHS
+//# sourceMappingURL=paths.js.map

package/dist/lib/opencode/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/lib/opencode/paths.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,iBAAiB;AACjB,wBAAwB;AACxB,6FAA6F;AAC7F,gPAAgP;AAChP,4GAA4G;AAC5G,2CAA2C;AAC3C,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,gGAAgG;AAChG,kGAAkG;AAClG,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,0KAA0K;AAC1K,qBAAqB;AAErB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,0BAA0B,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAU,CAAC;AAChF,MAAM,8BAA8B,GAAG,CAAC,UAAU,EAAE,WAAW,CAAU,CAAC;AAoB1E,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAIlC;IACC,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACnE,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnE,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,oBAAoB;QACpB,oBAAoB;QACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,sBAAsB,EAAE,MAAM,yBAAyB,CACrD,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,kBAAkB,CAC3B;QACD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,yBAAyB,EAAE,MAAM,uBAAuB,CACtD,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,qBAAqB,EAC7B,8BAA8B,CAC/B;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,eAAuB,EACvB,YAAoB;IAEpB,OAAO,uBAAuB,CAAC,eAAe,EAAE,YAAY,EAAE,0BAA0B,CAAC,CAAC;AAC5F,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,OAAe,EACf,YAAoB,EACpB,SAA4B;IAE5B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,SAAS,KAAK,YAAY,IAAI,CAAC,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACpF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AACD,iCAAiC"}

package/dist/lib/opencode/plugin-registration.d.ts

@@ -0,0 +1,17 @@
+import { type JsonObject, type WriteResult } from "./shared-utils.js";
+import type { ResolvedPaths } from "./paths.js";
+export declare const TUI_PACKAGE_SPECIFIER: string;
+export declare const MINIMUM_TUI_OPENCODE_VERSION = "1.18.2";
+export type TuiPluginEntry = string | [string, JsonObject];
+export declare function ensurePackageConfigText(text: string | undefined, packageSpecifier?: string): string;
+export declare function ensureTuiPackageConfigText(text: string | undefined, packageSpecifier?: string): string;
+export declare function ensureTuiPackageInstalled(paths: Pick<ResolvedPaths, "opencodeTuiConfigPath">): Promise<WriteResult>;
+export declare function ensurePackageInstalled(paths: ResolvedPaths): Promise<{
+    path: string;
+    changed: boolean;
+}>;
+export declare function readPluginList(document: JsonObject, label: string): string[];
+export declare function readTuiPluginList(document: JsonObject, label: string): TuiPluginEntry[];
+export declare function isPackagePluginSpecifier(value: string): boolean;
+export declare function readTuiPluginName(entry: TuiPluginEntry): string;
+export declare function isTuiPackageSpecifier(value: string): boolean;

package/dist/lib/opencode/plugin-registration.js

@@ -0,0 +1,210 @@
+// FILE: src/lib/opencode/plugin-registration.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Conservative pinned runtime and TUI plugin registration for OpenCode config.
+//   SCOPE: Pinned base-package specifier constants, plugin-list parsing and normalization with legacy /tui spec migration and tuple-option preservation, and idempotent writes of the pinned vvoc plugin into opencode.json(c) and the pinned base package into tui.json(c).
+//   DEPENDS: [jsonc-parser, src/lib/package.ts, src/lib/opencode/shared-utils.ts]
+//   LINKS: [M-CLI-CONFIG]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   TUI_PACKAGE_SPECIFIER - Pinned base package specifier registered in tui.json(c) so OpenCode selects its ./tui export.
+//   MINIMUM_TUI_OPENCODE_VERSION - Minimum OpenCode host version supported by the managed TUI plugin.
+//   TuiPluginEntry - Supported TUI plugin string or tuple entry.
+//   ensurePackageConfigText - Ensures OpenCode config contains the pinned vvoc plugin specifier.
+//   ensureTuiPackageConfigText - Ensures TUI config contains the pinned vvoc base package while preserving tuple options.
+//   ensureTuiPackageInstalled - Writes the pinned vvoc base package into dedicated tui.json(c).
+//   ensurePackageInstalled - Writes the pinned vvoc plugin specifier into OpenCode config.
+//   readPluginList - Reads the runtime plugin array from a parsed OpenCode config.
+//   readTuiPluginList - Reads the TUI plugin array accepting string and tuple entries.
+//   isPackagePluginSpecifier - True when a plugin entry is the vvoc base package.
+//   isTuiPackageSpecifier - True when a TUI entry equals the pinned base package specifier.
+//   readTuiPluginName - Extracts the name from a TUI plugin entry.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-OPENCODE-MODULE-SPLIT - Extracted runtime/TUI plugin pinning and plugin-list normalization from the former src/lib/opencode.ts monolith into this zone module.]
+// END_CHANGE_SUMMARY
+import { applyEdits, format, modify } from "jsonc-parser";
+import { getPinnedPackageSpecifier, PACKAGE_NAME, PACKAGE_VERSION } from "../package.js";
+import { ensureTrailingNewline, isJsonObject, OPENCODE_SCHEMA_URL, OPENCODE_TUI_SCHEMA_URL, parseObjectDocument, readOptionalText, renderJson, writeText, } from "./shared-utils.js";
+export const TUI_PACKAGE_SPECIFIER = `${PACKAGE_NAME}@${PACKAGE_VERSION}`;
+export const MINIMUM_TUI_OPENCODE_VERSION = "1.18.2";
+const JSON_FORMAT = {
+    insertSpaces: true,
+    tabSize: 2,
+    eol: "\n",
+};
+// START_BLOCK_ENSURE_OPENCODE_PLUGIN_CONFIG
+export function ensurePackageConfigText(text, packageSpecifier = PACKAGE_NAME) {
+    if (!text?.trim()) {
+        return renderJson({
+            $schema: OPENCODE_SCHEMA_URL,
+            plugin: [packageSpecifier],
+        });
+    }
+    const document = parseObjectDocument(text, "OpenCode config");
+    const currentPlugins = readPluginList(document, "OpenCode config");
+    let nextText = text;
+    if (!Object.hasOwn(document, "$schema")) {
+        nextText = applyEdits(nextText, modify(nextText, ["$schema"], OPENCODE_SCHEMA_URL, {
+            formattingOptions: JSON_FORMAT,
+            getInsertionIndex: () => 0,
+        }));
+    }
+    const nextPlugins = normalizePluginList(currentPlugins, packageSpecifier);
+    if (JSON.stringify(nextPlugins) !== JSON.stringify(currentPlugins)) {
+        nextText = applyEdits(nextText, modify(nextText, ["plugin"], nextPlugins, {
+            formattingOptions: JSON_FORMAT,
+        }));
+    }
+    return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
+}
+// END_BLOCK_ENSURE_OPENCODE_PLUGIN_CONFIG
+// START_BLOCK_ENSURE_TUI_PLUGIN_CONFIG
+export function ensureTuiPackageConfigText(text, packageSpecifier = TUI_PACKAGE_SPECIFIER) {
+    if (!text?.trim()) {
+        return renderJson({
+            $schema: OPENCODE_TUI_SCHEMA_URL,
+            plugin: [packageSpecifier],
+        });
+    }
+    const document = parseObjectDocument(text, "OpenCode TUI config");
+    const currentPlugins = readTuiPluginList(document, "OpenCode TUI config");
+    let nextText = text;
+    if (!Object.hasOwn(document, "$schema")) {
+        nextText = applyEdits(nextText, modify(nextText, ["$schema"], OPENCODE_TUI_SCHEMA_URL, {
+            formattingOptions: JSON_FORMAT,
+            getInsertionIndex: () => 0,
+        }));
+    }
+    const nextPlugins = normalizeTuiPluginList(currentPlugins, packageSpecifier);
+    if (JSON.stringify(nextPlugins) !== JSON.stringify(currentPlugins)) {
+        nextText = applyEdits(nextText, modify(nextText, ["plugin"], nextPlugins, {
+            formattingOptions: JSON_FORMAT,
+        }));
+    }
+    return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
+}
+export async function ensureTuiPackageInstalled(paths) {
+    const currentText = await readOptionalText(paths.opencodeTuiConfigPath);
+    const nextText = ensureTuiPackageConfigText(currentText);
+    if ((currentText ?? "") === nextText) {
+        return { action: "kept", path: paths.opencodeTuiConfigPath };
+    }
+    await writeText(paths.opencodeTuiConfigPath, nextText);
+    return {
+        action: currentText ? "updated" : "created",
+        path: paths.opencodeTuiConfigPath,
+    };
+}
+// END_BLOCK_ENSURE_TUI_PLUGIN_CONFIG
+// START_BLOCK_INSTALL_PACKAGE_AND_GUARDIAN_CONFIG
+export async function ensurePackageInstalled(paths) {
+    const currentText = await readOptionalText(paths.opencodeConfigPath);
+    const nextText = ensurePackageConfigText(currentText, await getPinnedPackageSpecifier());
+    if (currentText === nextText) {
+        return { path: paths.opencodeConfigPath, changed: false };
+    }
+    await writeText(paths.opencodeConfigPath, nextText);
+    return { path: paths.opencodeConfigPath, changed: true };
+}
+// END_BLOCK_INSTALL_PACKAGE_AND_GUARDIAN_CONFIG
+// START_BLOCK_PARSE_AND_NORMALIZE_CONFIG_VALUES
+export function readPluginList(document, label) {
+    const raw = document.plugin;
+    if (raw === undefined)
+        return [];
+    if (!Array.isArray(raw) || raw.some((entry) => typeof entry !== "string")) {
+        throw new Error(`${label}: expected "plugin" to be an array of strings`);
+    }
+    return raw.slice();
+}
+export function readTuiPluginList(document, label) {
+    const raw = document.plugin;
+    if (raw === undefined)
+        return [];
+    if (!Array.isArray(raw)) {
+        throw new Error(`${label}: expected "plugin" to be an array`);
+    }
+    return raw.map((entry, index) => {
+        if (typeof entry === "string") {
+            return entry;
+        }
+        if (Array.isArray(entry) &&
+            entry.length === 2 &&
+            typeof entry[0] === "string" &&
+            isJsonObject(entry[1])) {
+            return [entry[0], entry[1]];
+        }
+        throw new Error(`${label}: expected "plugin[${index}]" to be a string or [string, options] tuple`);
+    });
+}
+function normalizePluginList(currentPlugins, packageSpecifier) {
+    const nextPlugins = [];
+    const seen = new Set();
+    let insertedPackage = false;
+    const push = (value) => {
+        if (!seen.has(value)) {
+            seen.add(value);
+            nextPlugins.push(value);
+        }
+    };
+    for (const plugin of currentPlugins) {
+        if (isPackagePluginSpecifier(plugin)) {
+            if (!insertedPackage) {
+                push(packageSpecifier);
+                insertedPackage = true;
+            }
+            continue;
+        }
+        push(plugin);
+    }
+    if (!insertedPackage) {
+        push(packageSpecifier);
+    }
+    return nextPlugins;
+}
+function normalizeTuiPluginList(currentPlugins, packageSpecifier) {
+    const nextPlugins = [];
+    let insertedPackage = false;
+    for (const entry of currentPlugins) {
+        if (!isManagedTuiPackageSpecifier(readTuiPluginName(entry))) {
+            nextPlugins.push(entry);
+            continue;
+        }
+        if (insertedPackage) {
+            continue;
+        }
+        nextPlugins.push(typeof entry === "string" ? packageSpecifier : [packageSpecifier, entry[1]]);
+        insertedPackage = true;
+    }
+    if (!insertedPackage) {
+        nextPlugins.push(packageSpecifier);
+    }
+    return nextPlugins;
+}
+export function isPackagePluginSpecifier(value) {
+    return value === PACKAGE_NAME || value.startsWith(`${PACKAGE_NAME}@`);
+}
+export function readTuiPluginName(entry) {
+    return typeof entry === "string" ? entry : entry[0];
+}
+function isManagedTuiPackageSpecifier(value) {
+    return (isBasePackageSpecifier(value) ||
+        value === `${PACKAGE_NAME}/tui` ||
+        (value.startsWith(`${PACKAGE_NAME}@`) && value.endsWith("/tui")));
+}
+export function isTuiPackageSpecifier(value) {
+    return value === TUI_PACKAGE_SPECIFIER;
+}
+function isBasePackageSpecifier(value) {
+    if (value === PACKAGE_NAME)
+        return true;
+    const prefix = `${PACKAGE_NAME}@`;
+    return value.startsWith(prefix) && !value.slice(prefix.length).includes("/");
+}
+// END_BLOCK_PARSE_AND_NORMALIZE_CONFIG_VALUES
+//# sourceMappingURL=plugin-registration.js.map

package/dist/lib/opencode/plugin-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registration.js","sourceRoot":"","sources":["../../../src/lib/opencode/plugin-registration.ts"],"names":[],"mappings":"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"}

package/dist/lib/opencode/shared-utils.d.ts

@@ -0,0 +1,30 @@
+import { type VvocConfig } from "../vvoc-config.js";
+export declare const CLI_NAME = "vvoc";
+export declare const OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
+export declare const OPENCODE_TUI_SCHEMA_URL = "https://opencode.ai/tui.json";
+export type JsonObject = Record<string, unknown>;
+export type WriteResult = {
+    action: "created" | "updated" | "kept" | "skipped";
+    path: string;
+    reason?: string;
+};
+export type OpenCodeAgentOverride = {
+    model?: string;
+};
+export declare function parseObjectDocument(text: string, label: string): JsonObject;
+export declare function readStringArray(value: unknown, label: string): string[];
+export declare function updateAgentEntryText(text: string, agentName: string, entry: JsonObject): string;
+export declare function ensureOpenCodeConfigText(text: string | undefined): string;
+export declare function readNonEmptyString(value: unknown, label: string): string;
+export declare function isJsonObject(value: unknown): value is JsonObject;
+export declare function mergeJsonObjects(current: JsonObject, patch: JsonObject): JsonObject;
+export declare function readOptionalObject(document: JsonObject, key: string, label: string): JsonObject | undefined;
+export declare function readAgentOverride(entry: JsonObject | undefined, label: string): OpenCodeAgentOverride;
+export declare function isManagedFile(text: string): boolean;
+export declare function hasYamlFrontmatter(text: string): boolean;
+export declare function renderJson(value: unknown): string;
+export declare function stripMarkdownFrontmatter(text: string): string;
+export declare function ensureTrailingNewline(text: string): string;
+export declare function writeResolvedVvocConfig(path: string, currentText: string | undefined, config: VvocConfig): Promise<WriteResult>;
+export declare function readOptionalText(path: string): Promise<string | undefined>;
+export declare function writeText(path: string, text: string): Promise<void>;

package/dist/lib/opencode/shared-utils.js

@@ -0,0 +1,183 @@
+// FILE: src/lib/opencode/shared-utils.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Private shared JSONC document, value, text, and filesystem helpers plus cross-zone constants used by every src/lib/opencode zone module.
+//   SCOPE: JSONC parse/edit primitives with strict object validation, bounded string/array readers, shared role-agnostic agent value readers, managed-file markers, canonical JSON rendering, strict vvoc render-and-write, atomic-ish text IO, write-result shape, and the OpenCode schema URL constants consumed by config-producing zones.
+//   DEPENDS: [jsonc-parser, node:fs/promises, node:path, src/lib/vvoc-config.ts]
+//   LINKS: [M-CLI-CONFIG]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   CLI_NAME - Canonical vvoc CLI binary name.
+//   OPENCODE_SCHEMA_URL - OpenCode config schema URL.
+//   OPENCODE_TUI_SCHEMA_URL - OpenCode TUI config schema URL.
+//   JsonObject - Internal mutable JSON object shape.
+//   WriteResult - Result shape returned by managed config write operations.
+//   OpenCodeAgentOverride - Agent override config for OpenCode.
+//   parseObjectDocument - Strict JSONC parse returning a top-level object or throwing a labeled error.
+//   readStringArray - Reads a required string array with a labeled error.
+//   updateAgentEntryText - Rewrites one agent.<name> object with formatting.
+//   ensureOpenCodeConfigText - Ensures an OpenCode config document with $schema exists.
+//   readNonEmptyString - Reads a required non-empty trimmed string with a labeled error.
+//   isJsonObject - Narrows an unknown value to JsonObject.
+//   mergeJsonObjects - Deep-merges a patch object into a current object.
+//   readOptionalObject - Reads an optional object field with a labeled error.
+//   readAgentOverride - Reads the model override from one agent entry.
+//   isManagedFile - True when text carries the vvoc managed marker.
+//   hasYamlFrontmatter - True when text starts with a YAML frontmatter block.
+//   renderJson - Renders a value as canonical two-space JSON with trailing newline.
+//   stripMarkdownFrontmatter - Removes a leading YAML frontmatter block.
+//   ensureTrailingNewline - Appends a trailing newline when missing.
+//   writeResolvedVvocConfig - Renders and writes a vvoc config only when text changed.
+//   readOptionalText - Reads a file as text, returning undefined on ENOENT.
+//   writeText - Writes text, creating parent directories.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-OPENCODE-MODULE-SPLIT - Extracted the shared JSON/value/text/filesystem helper block and cross-zone constants from the former src/lib/opencode.ts monolith into this zone module.]
+// END_CHANGE_SUMMARY
+import { applyEdits, format, modify, parse } from "jsonc-parser";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { renderVvocConfig } from "../vvoc-config.js";
+export const CLI_NAME = "vvoc";
+export const OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
+export const OPENCODE_TUI_SCHEMA_URL = "https://opencode.ai/tui.json";
+const MANAGED_MARKER = "Managed by vvoc";
+const JSON_FORMAT = {
+    insertSpaces: true,
+    tabSize: 2,
+    eol: "\n",
+};
+// START_BLOCK_SHARED_DOCUMENT_UTILS
+export function parseObjectDocument(text, label) {
+    const errors = [];
+    const value = parse(text, errors, {
+        allowEmptyContent: false,
+        allowTrailingComma: true,
+        disallowComments: false,
+    });
+    if (errors.length > 0) {
+        throw new Error(`${label}: failed to parse JSONC (${errors.length} error(s))`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label}: expected a top-level object`);
+    }
+    return value;
+}
+export function readStringArray(value, label) {
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+        throw new Error(`${label}: expected an array of strings`);
+    }
+    return value.slice();
+}
+export function updateAgentEntryText(text, agentName, entry) {
+    const nextText = applyEdits(text, modify(text, ["agent", agentName], entry, {
+        formattingOptions: JSON_FORMAT,
+    }));
+    return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
+}
+export function ensureOpenCodeConfigText(text) {
+    if (!text?.trim()) {
+        return renderJson({
+            $schema: OPENCODE_SCHEMA_URL,
+        });
+    }
+    const document = parseObjectDocument(text, "OpenCode config");
+    let nextText = text;
+    if (!Object.hasOwn(document, "$schema")) {
+        nextText = applyEdits(nextText, modify(nextText, ["$schema"], OPENCODE_SCHEMA_URL, {
+            formattingOptions: JSON_FORMAT,
+            getInsertionIndex: () => 0,
+        }));
+    }
+    return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
+}
+// END_BLOCK_SHARED_DOCUMENT_UTILS
+// START_BLOCK_JSON_VALUE_HELPERS
+export function readNonEmptyString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`${label}: expected a non-empty string`);
+    }
+    return value.trim();
+}
+export function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+export function mergeJsonObjects(current, patch) {
+    const merged = { ...current };
+    for (const [key, patchValue] of Object.entries(patch)) {
+        const currentValue = merged[key];
+        merged[key] =
+            isJsonObject(currentValue) && isJsonObject(patchValue)
+                ? mergeJsonObjects(currentValue, patchValue)
+                : patchValue;
+    }
+    return merged;
+}
+export function readOptionalObject(document, key, label) {
+    const value = document[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label}: expected "${key}" to be an object`);
+    }
+    return value;
+}
+export function readAgentOverride(entry, label) {
+    if (!entry) {
+        return {};
+    }
+    return {
+        model: entry.model === undefined ? undefined : readNonEmptyString(entry.model, `${label}.model`),
+    };
+}
+// END_BLOCK_JSON_VALUE_HELPERS
+// START_BLOCK_FILESYSTEM_HELPERS
+export function isManagedFile(text) {
+    return text.includes(MANAGED_MARKER);
+}
+export function hasYamlFrontmatter(text) {
+    return text.startsWith("---\n");
+}
+export function renderJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export function stripMarkdownFrontmatter(text) {
+    const normalized = text.replaceAll("\r\n", "\n");
+    return normalized.replace(/^---\n[\s\S]*?\n---\n?/, "");
+}
+export function ensureTrailingNewline(text) {
+    return text.endsWith("\n") ? text : `${text}\n`;
+}
+export async function writeResolvedVvocConfig(path, currentText, config) {
+    const nextText = renderVvocConfig(config);
+    if ((currentText ?? "") === nextText) {
+        return { action: "kept", path };
+    }
+    await writeText(path, nextText);
+    return {
+        action: currentText ? "updated" : "created",
+        path,
+    };
+}
+export async function readOptionalText(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+export async function writeText(path, text) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, text, "utf8");
+}
+// END_BLOCK_FILESYSTEM_HELPERS
+//# sourceMappingURL=shared-utils.js.map

package/dist/lib/opencode/shared-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-utils.js","sourceRoot":"","sources":["../../../src/lib/opencode/shared-utils.ts"],"names":[],"mappings":"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"}

package/dist/lib/opencode/vvoc-config-io.d.ts

@@ -0,0 +1,9 @@
+import { type GuardianConfigOverrides, type VvocConfig } from "../vvoc-config.js";
+import { type WriteResult } from "./shared-utils.js";
+import type { ResolvedPaths } from "./paths.js";
+export declare function readVvocConfig(paths: Pick<ResolvedPaths, "vvocConfigPath">): Promise<VvocConfig | undefined>;
+export declare function installVvocConfig(paths: Pick<ResolvedPaths, "vvocConfigPath">): Promise<WriteResult>;
+export declare function syncVvocConfig(paths: Pick<ResolvedPaths, "vvocConfigPath">): Promise<WriteResult>;
+export declare function writeGuardianConfig(paths: Pick<ResolvedPaths, "vvocConfigPath">, overrides: GuardianConfigOverrides, options?: {
+    merge?: boolean;
+}): Promise<WriteResult>;

package/dist/lib/opencode/vvoc-config-io.js

@@ -0,0 +1,58 @@
+// FILE: src/lib/opencode/vvoc-config-io.ts
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Strict scoped IO for the canonical vvoc.json config document.
+//   SCOPE: Read the canonical vvoc.json when present, create/refresh it with materialized plugin-owned entries (hashline-edit routing, tool-history-compaction, peak-hours, spec-guard), rewrite it preserving valid current values, and merge or replace the guardian section.
+//   DEPENDS: [src/lib/vvoc-config.ts, src/lib/plugin-toggle-config.ts, src/lib/opencode/shared-utils.ts, src/lib/opencode/paths.ts]
+//   LINKS: [M-CLI-CONFIG]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   readVvocConfig - Loads the canonical vvoc.json document when present.
+//   installVvocConfig - Creates or refreshes the canonical vvoc.json document.
+//   syncVvocConfig - Rewrites the canonical vvoc.json document while preserving valid current values.
+//   writeGuardianConfig - Writes the guardian section into the canonical vvoc.json document.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [C-OPENCODE-MODULE-SPLIT - Extracted canonical vvoc.json IO from the former src/lib/opencode.ts monolith into this zone module.]
+// END_CHANGE_SUMMARY
+import { createDefaultVvocConfig, createGuardianConfig, parseVvocConfigText, } from "../vvoc-config.js";
+import { materializeHashlineEditEntry, materializeToolHistoryCompactionEntry, materializePeakHoursEntry, materializeSpecGuardEntry, } from "../plugin-toggle-config.js";
+import { readOptionalText, writeResolvedVvocConfig } from "./shared-utils.js";
+// START_BLOCK_VVOC_CONFIG_IO
+export async function readVvocConfig(paths) {
+    const currentText = await readOptionalText(paths.vvocConfigPath);
+    return currentText ? parseVvocConfigText(currentText, paths.vvocConfigPath) : undefined;
+}
+export async function installVvocConfig(paths) {
+    return syncVvocConfig(paths);
+}
+export async function syncVvocConfig(paths) {
+    const currentText = await readOptionalText(paths.vvocConfigPath);
+    const nextConfig = currentText
+        ? parseVvocConfigText(currentText, paths.vvocConfigPath)
+        : createDefaultVvocConfig();
+    nextConfig.plugins["hashline-edit"] = materializeHashlineEditEntry(nextConfig.plugins["hashline-edit"]);
+    nextConfig.plugins["tool-history-compaction"] = materializeToolHistoryCompactionEntry(nextConfig.plugins["tool-history-compaction"]);
+    nextConfig.plugins["peak-hours"] = materializePeakHoursEntry(nextConfig.plugins["peak-hours"]);
+    nextConfig.plugins["spec-guard"] = materializeSpecGuardEntry(nextConfig.plugins["spec-guard"]);
+    return writeResolvedVvocConfig(paths.vvocConfigPath, currentText, nextConfig);
+}
+export async function writeGuardianConfig(paths, overrides, options = {}) {
+    const currentText = await readOptionalText(paths.vvocConfigPath);
+    const currentConfig = currentText
+        ? parseVvocConfigText(currentText, paths.vvocConfigPath)
+        : createDefaultVvocConfig();
+    const nextConfig = {
+        ...currentConfig,
+        guardian: options.merge
+            ? createGuardianConfig({ ...currentConfig.guardian, ...overrides })
+            : createGuardianConfig(overrides),
+    };
+    return writeResolvedVvocConfig(paths.vvocConfigPath, currentText, nextConfig);
+}
+// END_BLOCK_VVOC_CONFIG_IO
+//# sourceMappingURL=vvoc-config-io.js.map

package/dist/lib/opencode/vvoc-config-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vvoc-config-io.js","sourceRoot":"","sources":["../../../src/lib/opencode/vvoc-config-io.ts"],"names":[],"mappings":"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"}