@osovv/vv-opencode 0.3.0 → 0.4.1

package/README.md

@@ -289,8 +289,8 @@ npm publish
 
 ## Repository layout
 
-- `src/plugins/guardian.ts` - Guardian OpenCode plugin
-- `src/plugins/memory.ts` - Memory OpenCode plugin and reviewer subagent config
+- `src/plugins/guardian/` - Guardian OpenCode plugin (index.ts + policy.md)
+- `src/plugins/memory/` - Memory OpenCode plugin (index.ts + system-instruction.md + reviewer.md)
 - `src/plugins/memory-store.ts` - file-based memory store and search logic
 - `src/lib/opencode.ts` - config path resolution and JSONC helpers for the CLI
 - `src/lib/vvoc-paths.ts` - shared vvoc/openCode path helpers

package/dist/cli.js

@@ -19,6 +19,7 @@
 //   LAST_CHANGE: [v0.2.5 - Added GRACE script markup so the vvoc entrypoint and command tree can be navigated quickly.]
 // END_CHANGE_SUMMARY
 import { defineCommand, runMain } from "citty";
+import agent from "./commands/agent.js";
 import doctor from "./commands/doctor.js";
 import guardian from "./commands/guardian.js";
 import install from "./commands/install.js";
@@ -35,6 +36,7 @@ const main = defineCommand({
         description: "Install and sync vv-opencode plugins for OpenCode.",
     },
     subCommands: {
+        agent,
         install,
         sync,
         status,

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,mBAAmB;AACnB,iBAAiB;AACjB,wBAAwB;AACxB,uDAAuD;AACvD,+FAA+F;AAC/F,2LAA2L;AAC3L,4BAA4B;AAC5B,iBAAiB;AACjB,qBAAqB;AACrB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,oEAAoE;AACpE,wCAAwC;AACxC,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,wHAAwH;AACxH,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAC1C,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAC9C,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAC1C,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,iCAAiC;AACjC,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;AAEjD,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,oDAAoD;KAClE;IACD,WAAW,EAAE;QACX,OAAO;QACP,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;QACR,OAAO;KACR;CACF,CAAC,CAAC;AACH,+BAA+B;AAE/B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,mBAAmB;AACnB,iBAAiB;AACjB,wBAAwB;AACxB,uDAAuD;AACvD,+FAA+F;AAC/F,2LAA2L;AAC3L,4BAA4B;AAC5B,iBAAiB;AACjB,qBAAqB;AACrB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,oEAAoE;AACpE,wCAAwC;AACxC,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,wHAAwH;AACxH,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAC1C,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAC9C,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAC1C,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,iCAAiC;AACjC,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;AAEjD,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,oDAAoD;KAClE;IACD,WAAW,EAAE;QACX,KAAK;QACL,OAAO;QACP,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;QACR,OAAO;KACR;CACF,CAAC,CAAC;AACH,+BAA+B;AAE/B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/agent.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("citty").CommandDef<import("citty").ArgsDef>;
+export default _default;

package/dist/commands/agent.js

@@ -0,0 +1,250 @@
+// FILE: src/commands/agent.ts
+// VERSION: 0.3.4
+// START_MODULE_CONTRACT
+//   PURPOSE: Manage agent model overrides for guardian and memory-reviewer agents.
+//   SCOPE: Agent model setting, unsetting, and listing via vvoc agent command tree.
+//   DEPENDS: [citty, src/lib/opencode.ts, src/plugins/memory-store.ts]
+//   LINKS: [M-CLI-COMMANDS]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   default - Agent command group.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.3.4 - Added granular agent model configuration via vvoc agent command.]
+// END_CHANGE_SUMMARY
+import { defineCommand } from "citty";
+import { describeWriteResult, parseGuardianConfigText, renderGuardianConfig, resolvePaths, } from "../lib/opencode.js";
+import { parseMemoryConfigText, renderMemoryConfig, } from "../plugins/memory-store.js";
+const guardianSet = defineCommand({
+    meta: {
+        name: "set",
+        description: "Set the Guardian agent model override.",
+    },
+    args: {
+        model: {
+            type: "positional",
+            required: true,
+            description: "Model in provider/model-id[:variant] format.",
+        },
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Write global or project config.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global config home.",
+        },
+    },
+    async run({ args }) {
+        const { model, variant } = parseModelArg(args.model, "set");
+        const scope = args.scope === "project" ? "project" : "global";
+        const configDir = typeof args["config-dir"] === "string" ? args["config-dir"] : undefined;
+        const paths = await resolvePaths({ scope: scope, cwd: process.cwd(), configDir });
+        const currentText = await Bun.file(paths.guardianConfigPath)
+            .text()
+            .catch(() => "");
+        const current = currentText
+            ? parseGuardianConfigText(currentText, paths.guardianConfigPath)
+            : {};
+        const merged = { ...current, model, variant };
+        const nextText = renderGuardianConfig(merged);
+        if (currentText.trim() === nextText.trim()) {
+            console.log(describeWriteResult({ action: "kept", path: paths.guardianConfigPath }));
+            return;
+        }
+        await Bun.write(paths.guardianConfigPath, nextText);
+        console.log(describeWriteResult({
+            action: currentText ? "updated" : "created",
+            path: paths.guardianConfigPath,
+        }));
+    },
+});
+const guardianUnset = defineCommand({
+    meta: {
+        name: "unset",
+        description: "Remove the Guardian agent model override.",
+    },
+    args: {
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Write global or project config.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global config home.",
+        },
+    },
+    async run({ args }) {
+        const scope = args.scope === "project" ? "project" : "global";
+        const configDir = typeof args["config-dir"] === "string" ? args["config-dir"] : undefined;
+        const paths = await resolvePaths({ scope: scope, cwd: process.cwd(), configDir });
+        const currentText = await Bun.file(paths.guardianConfigPath)
+            .text()
+            .catch(() => "");
+        if (!currentText) {
+            console.log(describeWriteResult({ action: "kept", path: paths.guardianConfigPath }));
+            return;
+        }
+        const current = parseGuardianConfigText(currentText, paths.guardianConfigPath);
+        const { model: _model, variant: _variant, ...rest } = current;
+        const nextText = renderGuardianConfig(rest);
+        if (currentText.trim() === nextText.trim()) {
+            console.log(describeWriteResult({ action: "kept", path: paths.guardianConfigPath }));
+            return;
+        }
+        await Bun.write(paths.guardianConfigPath, nextText);
+        console.log(describeWriteResult({ action: "updated", path: paths.guardianConfigPath }));
+    },
+});
+const guardianCmd = defineCommand({
+    meta: {
+        name: "guardian",
+        description: "Manage the Guardian agent.",
+    },
+    subCommands: {
+        set: guardianSet,
+        unset: guardianUnset,
+    },
+});
+const memoryReviewerSet = defineCommand({
+    meta: {
+        name: "set",
+        description: "Set the memory-reviewer agent model override.",
+    },
+    args: {
+        model: {
+            type: "positional",
+            required: true,
+            description: "Model in provider/model-id[:variant] format.",
+        },
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Write global or project config.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global config home.",
+        },
+    },
+    async run({ args }) {
+        const { model, variant } = parseModelArg(args.model, "set");
+        const overrides = { reviewerModel: model };
+        if (variant) {
+            overrides.reviewerVariant = variant;
+        }
+        const scope = args.scope === "project" ? "project" : "global";
+        const configDir = typeof args["config-dir"] === "string" ? args["config-dir"] : undefined;
+        const paths = await resolvePaths({ scope: scope, cwd: process.cwd(), configDir });
+        const currentText = await Bun.file(paths.memoryConfigPath)
+            .text()
+            .catch(() => "");
+        const current = currentText ? parseMemoryConfigText(currentText, paths.memoryConfigPath) : {};
+        const merged = {
+            enabled: current.enabled ?? true,
+            defaultSearchLimit: current.defaultSearchLimit,
+            reviewerModel: model,
+            reviewerVariant: variant,
+        };
+        const nextText = renderMemoryConfig(merged);
+        if (currentText.trim() === nextText.trim()) {
+            console.log(describeWriteResult({ action: "kept", path: paths.memoryConfigPath }));
+            return;
+        }
+        await Bun.write(paths.memoryConfigPath, nextText);
+        console.log(describeWriteResult({
+            action: currentText ? "updated" : "created",
+            path: paths.memoryConfigPath,
+        }));
+    },
+});
+const memoryReviewerUnset = defineCommand({
+    meta: {
+        name: "unset",
+        description: "Remove the memory-reviewer agent model override.",
+    },
+    args: {
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Write global or project config.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global config home.",
+        },
+    },
+    async run({ args }) {
+        const scope = args.scope === "project" ? "project" : "global";
+        const configDir = typeof args["config-dir"] === "string" ? args["config-dir"] : undefined;
+        const paths = await resolvePaths({ scope: scope, cwd: process.cwd(), configDir });
+        const currentText = await Bun.file(paths.memoryConfigPath)
+            .text()
+            .catch(() => "");
+        if (!currentText) {
+            console.log(describeWriteResult({ action: "kept", path: paths.memoryConfigPath }));
+            return;
+        }
+        const current = parseMemoryConfigText(currentText, paths.memoryConfigPath);
+        const nextText = renderMemoryConfig({
+            enabled: current.enabled ?? true,
+            defaultSearchLimit: current.defaultSearchLimit,
+        });
+        if (currentText.trim() === nextText.trim()) {
+            console.log(describeWriteResult({ action: "kept", path: paths.memoryConfigPath }));
+            return;
+        }
+        await Bun.write(paths.memoryConfigPath, nextText);
+        console.log(describeWriteResult({ action: "updated", path: paths.memoryConfigPath }));
+    },
+});
+const memoryReviewerCmd = defineCommand({
+    meta: {
+        name: "memory-reviewer",
+        description: "Manage the memory-reviewer agent.",
+    },
+    subCommands: {
+        set: memoryReviewerSet,
+        unset: memoryReviewerUnset,
+    },
+});
+export default defineCommand({
+    meta: {
+        name: "agent",
+        description: "Manage agent model overrides.",
+    },
+    subCommands: {
+        guardian: guardianCmd,
+        "memory-reviewer": memoryReviewerCmd,
+    },
+});
+function parseModelArg(value, operation) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`model argument required for ${operation}`);
+    }
+    const trimmed = value.trim();
+    if (trimmed.includes(":")) {
+        const lastColon = trimmed.lastIndexOf(":");
+        const model = trimmed.slice(0, lastColon);
+        const variant = trimmed.slice(lastColon + 1);
+        if (!model.includes("/")) {
+            throw new Error(`model must be in provider/model-id format, got: ${trimmed}`);
+        }
+        return { model, variant };
+    }
+    if (!trimmed.includes("/")) {
+        throw new Error(`model must be in provider/model-id format, got: ${trimmed}`);
+    }
+    return { model: trimmed };
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/install.d.ts

@@ -23,5 +23,10 @@ declare const _default: import("citty").CommandDef<{
         readonly default: true;
         readonly description: "Create memory.jsonc when missing.";
     };
+    readonly "secrets-redaction-config": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly description: "Create secrets-redaction.config.json when missing.";
+    };
 }>;
 export default _default;

package/dist/commands/install.js

@@ -17,7 +17,7 @@
 //   LAST_CHANGE: [v0.2.5 - Added GRACE command markup around install flow so vvoc bootstrap behavior is easier to inspect.]
 // END_CHANGE_SUMMARY
 import { defineCommand } from "citty";
-import { describeWriteResult, ensurePackageInstalled, installGuardianConfig, installMemoryConfig, resolvePaths, } from "../lib/opencode.js";
+import { describeWriteResult, ensurePackageInstalled, installGuardianConfig, installMemoryConfig, installSecretsRedactionConfig, resolvePaths, } from "../lib/opencode.js";
 export default defineCommand({
     meta: {
         name: "install",
@@ -48,6 +48,11 @@ export default defineCommand({
             default: true,
             description: "Create memory.jsonc when missing.",
         },
+        "secrets-redaction-config": {
+            type: "boolean",
+            default: true,
+            description: "Create secrets-redaction.config.json when missing.",
+        },
     },
     async run({ args }) {
         // START_BLOCK_APPLY_INSTALL_COMMAND
@@ -69,10 +74,20 @@ export default defineCommand({
         }
         if (args["memory-config"] === false) {
             console.log(`Skipped ${paths.memoryConfigPath} (memory config disabled)`);
-            return;
         }
-        const memory = await installMemoryConfig(paths, { force: Boolean(args.force) });
-        console.log(describeWriteResult(memory));
+        else {
+            const memory = await installMemoryConfig(paths, { force: Boolean(args.force) });
+            console.log(describeWriteResult(memory));
+        }
+        if (args["secrets-redaction-config"] === false) {
+            console.log(`Skipped ${paths.secretsRedactionConfigPath} (secrets-redaction config disabled)`);
+        }
+        else {
+            const secretsRedaction = await installSecretsRedactionConfig(paths, {
+                force: Boolean(args.force),
+            });
+            console.log(describeWriteResult(secretsRedaction));
+        }
         // END_BLOCK_APPLY_INSTALL_COMMAND
     },
 });

package/dist/commands/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,iBAAiB;AACjB,wBAAwB;AACxB,+FAA+F;AAC/F,oHAAoH;AACpH,0CAA0C;AAC1C,0CAA0C;AAC1C,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,4FAA4F;AAC5F,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,4HAA4H;AAC5H,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,6BAA6B,EAC7B,YAAY,GAEb,MAAM,oBAAoB,CAAC;AAE5B,eAAe,aAAa,CAAC;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,2CAA2C;KACzD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YAC9B,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,oCAAoC;SAClD;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;SAC7E;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,4DAA4D;SAC1E;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,qCAAqC;SACnD;QACD,eAAe,EAAE;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,mCAAmC;SACjD;QACD,0BAA0B,EAAE;YAC1B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,oDAAoD;SAClE;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,oCAAoC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9D,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1F,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC;YAC/B,KAAK,EAAE,KAAc;YACrB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,SAAS;SACV,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzE,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,kBAAkB,6BAA6B,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,gBAAgB,2BAA2B,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,IAAI,CAAC,0BAA0B,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CACT,WAAW,KAAK,CAAC,0BAA0B,sCAAsC,CAClF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,gBAAgB,GAAG,MAAM,6BAA6B,CAAC,KAAK,EAAE;gBAClE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;aAC3B,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,kCAAkC;IACpC,CAAC;CACF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { GuardianPlugin } from "./plugins/guardian.js";
-export { MemoryPlugin } from "./plugins/memory.js";
+export { GuardianPlugin } from "./plugins/guardian/index.js";
+export { MemoryPlugin } from "./plugins/memory/index.js";
 export { SecretsRedactionPlugin } from "./plugins/secrets-redaction.js";

package/dist/index.js

@@ -16,7 +16,7 @@
 // START_CHANGE_SUMMARY
 //   LAST_CHANGE: [v0.3.0 - Added SecretsRedactionPlugin for secret redaction in LLM requests.]
 // END_CHANGE_SUMMARY
-export { GuardianPlugin } from "./plugins/guardian.js";
-export { MemoryPlugin } from "./plugins/memory.js";
+export { GuardianPlugin } from "./plugins/guardian/index.js";
+export { MemoryPlugin } from "./plugins/memory/index.js";
 export { SecretsRedactionPlugin } from "./plugins/secrets-redaction.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,iBAAiB;AACjB,wBAAwB;AACxB,wFAAwF;AACxF,8FAA8F;AAC9F,gGAAgG;AAChG,4EAA4E;AAC5E,iBAAiB;AACjB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,oHAAoH;AACpH,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,+FAA+F;AAC/F,qBAAqB;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,iBAAiB;AACjB,wBAAwB;AACxB,wFAAwF;AACxF,8FAA8F;AAC9F,gGAAgG;AAChG,4EAA4E;AAC5E,iBAAiB;AACjB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,oHAAoH;AACpH,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,+FAA+F;AAC/F,qBAAqB;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/lib/opencode.d.ts

@@ -16,6 +16,8 @@ export type ResolvedPaths = {
     guardianAlternatePaths: string[];
     memoryConfigPath: string;
     memoryConfigAlternates: string[];
+    secretsRedactionConfigPath: string;
+    secretsRedactionConfigAlternates: string[];
 };
 export type GuardianConfigOverrides = {
     model?: string;
@@ -55,6 +57,13 @@ export type InstallationInspection = {
         parseError?: string;
         overrides?: MemoryConfigOverrides;
     };
+    secretsRedaction: {
+        path: string;
+        exists: boolean;
+        alternates: string[];
+        managed: boolean;
+        parseError?: string;
+    };
     warnings: string[];
     problems: string[];
 };
@@ -85,5 +94,13 @@ export declare function installMemoryConfig(paths: ResolvedPaths, options: {
 export declare function syncMemoryConfig(paths: ResolvedPaths, options: {
     force: boolean;
 }): Promise<WriteResult>;
+export declare function renderSecretsRedactionConfig(): string;
+export declare function parseSecretsRedactionConfigText(text: string, _filePath: string): Record<string, unknown>;
+export declare function installSecretsRedactionConfig(paths: ResolvedPaths, options: {
+    force: boolean;
+}): Promise<WriteResult>;
+export declare function syncSecretsRedactionConfig(paths: ResolvedPaths, options: {
+    force: boolean;
+}): Promise<WriteResult>;
 export declare function inspectInstallation(paths: ResolvedPaths): Promise<InstallationInspection>;
 export declare function describeWriteResult(result: WriteResult): string;

package/dist/lib/opencode.js

@@ -50,6 +50,10 @@ const DEFAULT_GUARDIAN_APPROVAL_RISK_THRESHOLD = 80;
 const GUARDIAN_CONFIG_FILE_NAMES = ["guardian.jsonc", "guardian.json"];
 const MEMORY_CONFIG_FILE_NAMES = ["memory.jsonc", "memory.json"];
 const OPENCODE_CONFIG_FILE_NAMES = ["opencode.json", "opencode.jsonc"];
+const SECRETS_REDACTION_CONFIG_FILE_NAMES = [
+    "secrets-redaction.config.json",
+    "secrets-redaction.config.jsonc",
+];
 const JSON_FORMAT = {
     insertSpaces: true,
     tabSize: 2,
@@ -65,6 +69,7 @@ export async function resolvePaths(options) {
     const opencodeSelection = await selectPrimaryPath(OPENCODE_CONFIG_FILE_NAMES.map((name) => join(opencodeBaseDir, name)));
     const guardianSelection = await selectPrimaryPath(GUARDIAN_CONFIG_FILE_NAMES.map((name) => join(vvocBaseDir, name)));
     const memorySelection = await selectPrimaryPath(MEMORY_CONFIG_FILE_NAMES.map((name) => join(vvocBaseDir, name)));
+    const secretsRedactionSelection = await selectPrimaryPath(SECRETS_REDACTION_CONFIG_FILE_NAMES.map((name) => join(vvocBaseDir, name)));
     return {
         scope: options.scope,
         cwd: options.cwd,
@@ -77,6 +82,8 @@ export async function resolvePaths(options) {
         guardianAlternatePaths: guardianSelection.alternates,
         memoryConfigPath: memorySelection.primary,
         memoryConfigAlternates: memorySelection.alternates,
+        secretsRedactionConfigPath: secretsRedactionSelection.primary,
+        secretsRedactionConfigAlternates: secretsRedactionSelection.alternates,
     };
 }
 // END_BLOCK_RESOLVE_CONFIG_PATHS
@@ -250,6 +257,79 @@ export async function syncMemoryConfig(paths, options) {
     return { action: "updated", path: paths.memoryConfigPath };
 }
 // END_BLOCK_INSTALL_MEMORY_CONFIG
+// START_BLOCK_INSTALL_SECRETS_REDACTION_CONFIG
+export function renderSecretsRedactionConfig() {
+    const lines = [
+        "// Managed by vvoc.",
+        "// `vvoc sync` rewrites files with this marker while preserving current values.",
+        "// Remove this header if you want to manage the file manually.",
+        "",
+        "{",
+        '  "enabled": true,',
+        '  "secret": "${VVOC_SECRET}",',
+        '  "ttlMs": 3600000,',
+        '  "maxMappings": 10000,',
+        '  "patterns": {',
+        '    "keywords": [],',
+        '    "regex": [],',
+        '    "builtin": ["email", "uuid", "ipv4", "mac", "openai_key", "anthropic_key", "github_token", "aws_access_key", "stripe_key", "bearer_token", "bearer_dot", "syn_key", "hex_token"],',
+        '    "exclude": []',
+        "  },",
+        '  "debug": false',
+        "}",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+export function parseSecretsRedactionConfigText(text, _filePath) {
+    const errors = [];
+    const result = parse(text, errors, { allowTrailingComma: true });
+    if (errors.length > 0) {
+        throw new Error(`parse error at offset ${errors[0].offset}`);
+    }
+    if (typeof result !== "object" || result === null) {
+        throw new Error("root must be an object");
+    }
+    return result;
+}
+export async function installSecretsRedactionConfig(paths, options) {
+    const currentText = await readOptionalText(paths.secretsRedactionConfigPath);
+    if (!currentText) {
+        await writeText(paths.secretsRedactionConfigPath, renderSecretsRedactionConfig());
+        return { action: "created", path: paths.secretsRedactionConfigPath };
+    }
+    if (!options.force) {
+        if (!isManagedFile(currentText)) {
+            return {
+                action: "skipped",
+                path: paths.secretsRedactionConfigPath,
+                reason: "existing file is not managed by vvoc",
+            };
+        }
+        return { action: "kept", path: paths.secretsRedactionConfigPath };
+    }
+    return syncSecretsRedactionConfig(paths, options);
+}
+export async function syncSecretsRedactionConfig(paths, options) {
+    const currentText = await readOptionalText(paths.secretsRedactionConfigPath);
+    if (!currentText) {
+        await writeText(paths.secretsRedactionConfigPath, renderSecretsRedactionConfig());
+        return { action: "created", path: paths.secretsRedactionConfigPath };
+    }
+    if (!options.force && !isManagedFile(currentText)) {
+        return {
+            action: "skipped",
+            path: paths.secretsRedactionConfigPath,
+            reason: "existing file is not managed by vvoc",
+        };
+    }
+    const nextText = renderSecretsRedactionConfig();
+    if (currentText === nextText) {
+        return { action: "kept", path: paths.secretsRedactionConfigPath };
+    }
+    await writeText(paths.secretsRedactionConfigPath, nextText);
+    return { action: "updated", path: paths.secretsRedactionConfigPath };
+}
+// END_BLOCK_INSTALL_SECRETS_REDACTION_CONFIG
 // START_BLOCK_INSPECT_INSTALLATION_STATE
 export async function inspectInstallation(paths) {
     const warnings = [];
@@ -263,6 +343,9 @@ export async function inspectInstallation(paths) {
     if (paths.memoryConfigAlternates.length > 0) {
         warnings.push(`multiple Memory config files exist: ${[paths.memoryConfigPath, ...paths.memoryConfigAlternates].join(", ")}`);
     }
+    if (paths.secretsRedactionConfigAlternates.length > 0) {
+        warnings.push(`multiple SecretsRedaction config files exist: ${[paths.secretsRedactionConfigPath, ...paths.secretsRedactionConfigAlternates].join(", ")}`);
+    }
     const opencodeText = await readOptionalText(paths.opencodeConfigPath);
     let opencodeParseError;
     let plugins = [];
@@ -304,6 +387,20 @@ export async function inspectInstallation(paths) {
             problems.push(memoryParseError);
         }
     }
+    const secretsRedactionText = await readOptionalText(paths.secretsRedactionConfigPath);
+    let secretsRedactionParseError;
+    const secretsRedactionManaged = secretsRedactionText
+        ? isManagedFile(secretsRedactionText)
+        : false;
+    if (secretsRedactionText) {
+        try {
+            parseSecretsRedactionConfigText(secretsRedactionText, paths.secretsRedactionConfigPath);
+        }
+        catch (error) {
+            secretsRedactionParseError = error instanceof Error ? error.message : String(error);
+            problems.push(secretsRedactionParseError);
+        }
+    }
     if (!pluginConfigured) {
         problems.push(`${PACKAGE_NAME} is not configured in ${paths.opencodeConfigPath}`);
     }
@@ -333,6 +430,13 @@ export async function inspectInstallation(paths) {
             parseError: memoryParseError,
             overrides: memoryOverrides,
         },
+        secretsRedaction: {
+            path: paths.secretsRedactionConfigPath,
+            exists: Boolean(secretsRedactionText),
+            alternates: paths.secretsRedactionConfigAlternates,
+            managed: secretsRedactionManaged,
+            parseError: secretsRedactionParseError,
+        },
         warnings,
         problems,
     };