@osovv/vv-opencode 0.5.5 → 0.6.0

package/dist/commands/install.js

@@ -1,8 +1,8 @@
 // FILE: src/commands/install.ts
-// VERSION: 0.2.5
+// VERSION: 0.2.6
 // START_MODULE_CONTRACT
 //   PURPOSE: Install vv-opencode into OpenCode config and bootstrap vvoc-managed config files.
-//   SCOPE: Scope parsing, path resolution, pinned plugin registration, and initial Guardian/Memory config creation.
+//   SCOPE: Scope parsing, path resolution, pinned plugin registration, managed subagent prompt scaffolding, and initial Guardian/Memory config creation.
 //   DEPENDS: [citty, src/lib/opencode.ts]
 //   LINKS: [M-CLI-COMMANDS, M-CLI-CONFIG]
 //   ROLE: RUNTIME
@@ -14,10 +14,10 @@
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v0.2.5 - Added GRACE command markup around install flow so vvoc bootstrap behavior is easier to inspect.]
+//   LAST_CHANGE: [v0.2.6 - Added managed subagent registration and prompt scaffolding to install.]
 // END_CHANGE_SUMMARY
 import { defineCommand } from "citty";
-import { describeWriteResult, ensurePackageInstalled, installGuardianConfig, installMemoryConfig, installSecretsRedactionConfig, resolvePaths, } from "../lib/opencode.js";
+import { describeWriteResult, ensurePackageInstalled, installGuardianConfig, installManagedSubagentPrompts, installMemoryConfig, installSecretsRedactionConfig, resolvePaths, syncManagedSubagentRegistrations, } from "../lib/opencode.js";
 export default defineCommand({
     meta: {
         name: "install",
@@ -64,7 +64,14 @@ export default defineCommand({
             configDir,
         });
         const opencode = await ensurePackageInstalled(paths);
+        const managedSubagents = await syncManagedSubagentRegistrations(paths);
         console.log(`${opencode.changed ? "Updated" : "Kept"} ${opencode.path}`);
+        console.log(`${managedSubagents.changed ? "Updated" : "Kept"} ${managedSubagents.path} (managed subagents)`);
+        for (const result of await installManagedSubagentPrompts(paths, {
+            force: Boolean(args.force),
+        })) {
+            console.log(describeWriteResult(result));
+        }
         if (args["guardian-config"] === false) {
             console.log(`Skipped ${paths.guardianConfigPath} (guardian config disabled)`);
         }

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":"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"}

package/dist/commands/sync.js

@@ -1,8 +1,8 @@
 // FILE: src/commands/sync.ts
-// VERSION: 0.2.5
+// VERSION: 0.2.6
 // START_MODULE_CONTRACT
 //   PURPOSE: Sync managed vvoc config files and keep the OpenCode plugin specifier current.
-//   SCOPE: Scope parsing, path resolution, pinned plugin sync, and managed Guardian/Memory config rewrites.
+//   SCOPE: Scope parsing, path resolution, pinned plugin sync, managed subagent prompt sync, and managed Guardian/Memory config rewrites.
 //   DEPENDS: [citty, src/lib/opencode.ts]
 //   LINKS: [M-CLI-COMMANDS, M-CLI-CONFIG]
 //   ROLE: RUNTIME
@@ -14,10 +14,10 @@
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v0.2.5 - Added GRACE command markup around sync flow for deterministic config maintenance navigation.]
+//   LAST_CHANGE: [v0.2.6 - Added managed subagent registration and prompt syncing to vvoc sync.]
 // END_CHANGE_SUMMARY
 import { defineCommand } from "citty";
-import { describeWriteResult, ensurePackageInstalled, resolvePaths, syncGuardianConfig, syncMemoryConfig, } from "../lib/opencode.js";
+import { describeWriteResult, ensurePackageInstalled, resolvePaths, syncManagedSubagentPrompts, syncManagedSubagentRegistrations, syncGuardianConfig, syncMemoryConfig, } from "../lib/opencode.js";
 export default defineCommand({
     meta: {
         name: "sync",
@@ -49,9 +49,15 @@ export default defineCommand({
             configDir,
         });
         const opencode = await ensurePackageInstalled(paths);
+        const managedSubagents = await syncManagedSubagentRegistrations(paths);
+        const managedPrompts = await syncManagedSubagentPrompts(paths, { force: Boolean(args.force) });
         const guardian = await syncGuardianConfig(paths, { force: Boolean(args.force) });
         const memory = await syncMemoryConfig(paths, { force: Boolean(args.force) });
         console.log(`${opencode.changed ? "Updated" : "Kept"} ${opencode.path}`);
+        console.log(`${managedSubagents.changed ? "Updated" : "Kept"} ${managedSubagents.path} (managed subagents)`);
+        for (const result of managedPrompts) {
+            console.log(describeWriteResult(result));
+        }
         console.log(describeWriteResult(guardian));
         console.log(describeWriteResult(memory));
         // END_BLOCK_APPLY_SYNC_COMMAND

package/dist/commands/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,iBAAiB;AACjB,wBAAwB;AACxB,4FAA4F;AAC5F,4GAA4G;AAC5G,0CAA0C;AAC1C,0CAA0C;AAC1C,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,qEAAqE;AACrE,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,yHAAyH;AACzH,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAE5B,eAAe,aAAa,CAAC;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,wCAAwC;KACtD;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,gCAAgC;SAC9C;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;SAC7E;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,8CAA8C;SAC5D;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,iCAAiC;QACjC,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;QACrD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAE7E,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;QACzC,+BAA+B;IACjC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"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"}

package/dist/lib/managed-agents.d.ts

@@ -0,0 +1,13 @@
+export declare const MANAGED_SUBAGENT_NAMES: readonly ["implementer", "spec-reviewer", "code-reviewer", "investitagor"];
+export type ManagedSubagentName = (typeof MANAGED_SUBAGENT_NAMES)[number];
+export type ManagedSubagentDefinition = {
+    name: ManagedSubagentName;
+    description: string;
+    promptFileName: `${ManagedSubagentName}.md`;
+    steps?: number;
+    permission?: Record<string, unknown>;
+};
+export declare const MANAGED_SUBAGENTS: readonly ManagedSubagentDefinition[];
+export declare function isManagedSubagentName(value: string): value is ManagedSubagentName;
+export declare function getManagedSubagentDefinition(name: ManagedSubagentName): ManagedSubagentDefinition;
+export declare function loadManagedSubagentTemplate(name: ManagedSubagentName): Promise<string>;

package/dist/lib/managed-agents.js

@@ -0,0 +1,83 @@
+// FILE: src/lib/managed-agents.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Describe vvoc-managed OpenCode subagents and load their bundled prompt templates.
+//   SCOPE: Built-in subagent metadata, name validation, definition lookup, and template file loading from package assets.
+//   DEPENDS: [node:fs/promises]
+//   LINKS: [M-CLI-CONFIG]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   ManagedSubagentName - Canonical vvoc-managed subagent names.
+//   ManagedSubagentDefinition - Metadata used to register a managed subagent in OpenCode config.
+//   MANAGED_SUBAGENT_NAMES - Ordered managed subagent names.
+//   MANAGED_SUBAGENTS - Built-in managed subagent definitions.
+//   isManagedSubagentName - Checks whether a string is one of the managed subagent names.
+//   getManagedSubagentDefinition - Returns metadata for a managed subagent.
+//   loadManagedSubagentTemplate - Loads the bundled prompt template for a managed subagent.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Added bundled metadata and asset-backed prompt loading for vvoc-managed subagents.]
+// END_CHANGE_SUMMARY
+import { readFile } from "node:fs/promises";
+export const MANAGED_SUBAGENT_NAMES = [
+    "implementer",
+    "spec-reviewer",
+    "code-reviewer",
+    "investitagor",
+];
+export const MANAGED_SUBAGENTS = [
+    {
+        name: "implementer",
+        description: "Implements approved changes with focused verification and a minimal diff.",
+        promptFileName: "implementer.md",
+        steps: 8,
+    },
+    {
+        name: "spec-reviewer",
+        description: "Checks an implementation against the requested spec and flags missing or extra behavior.",
+        promptFileName: "spec-reviewer.md",
+        steps: 6,
+        permission: {
+            edit: "deny",
+        },
+    },
+    {
+        name: "code-reviewer",
+        description: "Reviews changes for bugs, regressions, maintainability risks, and missing tests.",
+        promptFileName: "code-reviewer.md",
+        steps: 6,
+        permission: {
+            edit: "deny",
+        },
+    },
+    {
+        name: "investitagor",
+        description: "Investigates bugs and unclear behavior before implementation work begins.",
+        promptFileName: "investitagor.md",
+        steps: 6,
+        permission: {
+            edit: "deny",
+        },
+    },
+];
+const MANAGED_SUBAGENT_MAP = new Map(MANAGED_SUBAGENTS.map((definition) => [definition.name, definition]));
+export function isManagedSubagentName(value) {
+    return MANAGED_SUBAGENT_MAP.has(value);
+}
+export function getManagedSubagentDefinition(name) {
+    const definition = MANAGED_SUBAGENT_MAP.get(name);
+    if (!definition) {
+        throw new Error(`unknown managed subagent: ${name}`);
+    }
+    return definition;
+}
+export async function loadManagedSubagentTemplate(name) {
+    const definition = getManagedSubagentDefinition(name);
+    const assetUrl = new URL(`../../templates/agents/${definition.promptFileName}`, import.meta.url);
+    return readFile(assetUrl, "utf8");
+}
+//# sourceMappingURL=managed-agents.js.map

package/dist/lib/managed-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-agents.js","sourceRoot":"","sources":["../../src/lib/managed-agents.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,iBAAiB;AACjB,wBAAwB;AACxB,+FAA+F;AAC/F,0HAA0H;AAC1H,gCAAgC;AAChC,0BAA0B;AAC1B,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,iEAAiE;AACjE,iGAAiG;AACjG,6DAA6D;AAC7D,+DAA+D;AAC/D,0FAA0F;AAC1F,4EAA4E;AAC5E,4FAA4F;AAC5F,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,+GAA+G;AAC/G,qBAAqB;AAErB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa;IACb,eAAe;IACf,eAAe;IACf,cAAc;CACN,CAAC;AAYX,MAAM,CAAC,MAAM,iBAAiB,GAAyC;IACrE;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,2EAA2E;QACxF,cAAc,EAAE,gBAAgB;QAChC,KAAK,EAAE,CAAC;KACT;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0FAA0F;QAC5F,cAAc,EAAE,kBAAkB;QAClC,KAAK,EAAE,CAAC;QACR,UAAU,EAAE;YACV,IAAI,EAAE,MAAM;SACb;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,kFAAkF;QAC/F,cAAc,EAAE,kBAAkB;QAClC,KAAK,EAAE,CAAC;QACR,UAAU,EAAE;YACV,IAAI,EAAE,MAAM;SACb;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2EAA2E;QACxF,cAAc,EAAE,iBAAiB;QACjC,KAAK,EAAE,CAAC;QACR,UAAU,EAAE;YACV,IAAI,EAAE,MAAM;SACb;KACF;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CACrE,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,oBAAoB,CAAC,GAAG,CAAC,KAA4B,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAyB;IACpE,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAyB;IACzE,MAAM,UAAU,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,0BAA0B,UAAU,CAAC,cAAc,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjG,OAAO,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/opencode.d.ts

@@ -1,3 +1,4 @@
+import { type ManagedSubagentName } from "./managed-agents.js";
 import { type MemoryConfigOverrides } from "../plugins/memory-store.js";
 import { PACKAGE_NAME } from "./package.js";
 export declare const CLI_NAME = "vvoc";
@@ -10,6 +11,7 @@ export type ResolvedPaths = {
     configHome: string;
     opencodeBaseDir: string;
     vvocBaseDir: string;
+    managedAgentsDirPath: string;
     opencodeConfigPath: string;
     opencodeAlternatePaths: string[];
     guardianConfigPath: string;
@@ -31,6 +33,7 @@ export type WriteResult = {
     path: string;
     reason?: string;
 };
+export type ManagedSubagentModelMap = Record<ManagedSubagentName, string | undefined>;
 export type InstallationInspection = {
     scope: Scope;
     opencode: {
@@ -73,6 +76,22 @@ export declare function resolvePaths(options: {
     configDir?: string;
 }): Promise<ResolvedPaths>;
 export declare function ensurePackageConfigText(text: string | undefined, packageSpecifier?: string): string;
+export declare function ensureManagedSubagentsConfigText(text: string | undefined, paths: Pick<ResolvedPaths, "managedAgentsDirPath" | "opencodeConfigPath">): string;
+export declare function syncManagedSubagentRegistrations(paths: ResolvedPaths): Promise<{
+    path: string;
+    changed: boolean;
+}>;
+export declare function installManagedSubagentPrompts(paths: ResolvedPaths, options: {
+    force: boolean;
+}): Promise<WriteResult[]>;
+export declare function syncManagedSubagentPrompts(paths: ResolvedPaths, options: {
+    force: boolean;
+}): Promise<WriteResult[]>;
+export declare function readManagedSubagentModels(paths: Pick<ResolvedPaths, "opencodeConfigPath">): Promise<ManagedSubagentModelMap>;
+export declare function writeManagedSubagentModel(paths: Pick<ResolvedPaths, "managedAgentsDirPath" | "opencodeConfigPath">, agentName: ManagedSubagentName, options: {
+    model?: string;
+    ensureEntry: boolean;
+}): Promise<WriteResult>;
 export declare function parseGuardianConfigText(text: string, label: string): GuardianConfigOverrides;
 export declare function renderGuardianConfig(overrides?: GuardianConfigOverrides): string;
 export declare function ensurePackageInstalled(paths: ResolvedPaths): Promise<{

package/dist/lib/opencode.js

@@ -1,9 +1,9 @@
 // FILE: src/lib/opencode.ts
-// VERSION: 0.2.5
+// VERSION: 0.2.6
 // START_MODULE_CONTRACT
 //   PURPOSE: Manage OpenCode plugin registration and vvoc-owned config files.
-//   SCOPE: Scope-aware path resolution, pinned plugin writes, Guardian/Memory config rendering and sync, and installation inspection.
-//   DEPENDS: [jsonc-parser, node:fs/promises, node:path, src/lib/package.ts, src/lib/vvoc-paths.ts, src/plugins/memory-store.ts]
+//   SCOPE: Scope-aware path resolution, pinned plugin writes, managed subagent registration/prompt sync, Guardian/Memory config rendering and sync, and installation inspection.
+//   DEPENDS: [jsonc-parser, node:fs/promises, node:path, src/lib/managed-agents.ts, src/lib/package.ts, src/lib/vvoc-paths.ts, src/plugins/memory-store.ts]
 //   LINKS: [M-CLI-CONFIG]
 //   ROLE: RUNTIME
 //   MAP_MODE: EXPORTS
@@ -20,9 +20,15 @@
 //   InstallationInspection - Current OpenCode and vvoc installation status snapshot.
 //   resolvePaths - Resolves OpenCode and vvoc config paths for global/project scopes.
 //   ensurePackageConfigText - Ensures OpenCode config contains the pinned vvoc plugin specifier.
+//   ensureManagedSubagentsConfigText - Ensures OpenCode config contains the vvoc-managed subagent registrations.
 //   parseGuardianConfigText - Parses Guardian config JSONC into typed overrides.
 //   renderGuardianConfig - Renders managed Guardian config JSONC.
 //   ensurePackageInstalled - Writes the pinned vvoc plugin specifier into OpenCode config.
+//   syncManagedSubagentRegistrations - Syncs the canonical vvoc-managed subagent registrations into OpenCode config.
+//   installManagedSubagentPrompts - Creates managed vvoc prompt files for the bundled subagents when missing.
+//   syncManagedSubagentPrompts - Rewrites managed vvoc prompt files for the bundled subagents.
+//   readManagedSubagentModels - Reads model overrides for the bundled vvoc subagents from OpenCode config.
+//   writeManagedSubagentModel - Writes or removes a bundled vvoc subagent model override in OpenCode config.
 //   installGuardianConfig - Creates or preserves managed Guardian config.
 //   syncGuardianConfig - Rewrites managed Guardian config while preserving current values.
 //   writeGuardianConfig - Writes explicit Guardian overrides to managed config.
@@ -33,14 +39,15 @@
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v0.2.5 - Added GRACE runtime markup and symbol-accurate export mapping for OpenCode/vvoc config helpers.]
+//   LAST_CHANGE: [v0.2.6 - Added vvoc-managed OpenCode subagent registration, prompt scaffolding, and model override helpers.]
 // END_CHANGE_SUMMARY
 import { applyEdits, format, modify, parse } from "jsonc-parser";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { dirname, join, relative } from "node:path";
+import { MANAGED_SUBAGENTS, getManagedSubagentDefinition, loadManagedSubagentTemplate, } from "./managed-agents.js";
 import { parseMemoryConfigText, renderMemoryConfig, } from "../plugins/memory-store.js";
 import { getPinnedPackageSpecifier, PACKAGE_NAME } from "./package.js";
-import { getConfigHome, getGlobalOpencodeDir, getGlobalVvocDir, getProjectVvocDir, } from "./vvoc-paths.js";
+import { getConfigHome, getGlobalOpencodeDir, getGlobalVvocDir, getProjectVvocDir, getVvocAgentsDir, } from "./vvoc-paths.js";
 export const CLI_NAME = "vvoc";
 export { PACKAGE_NAME };
 export const OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
@@ -66,6 +73,7 @@ export async function resolvePaths(options) {
     const vvocBaseDir = options.scope === "global"
         ? getGlobalVvocDir(options.configDir)
         : getProjectVvocDir(options.cwd);
+    const managedAgentsDirPath = getVvocAgentsDir(vvocBaseDir);
     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)));
@@ -76,6 +84,7 @@ export async function resolvePaths(options) {
         configHome,
         opencodeBaseDir,
         vvocBaseDir,
+        managedAgentsDirPath,
         opencodeConfigPath: opencodeSelection.primary,
         opencodeAlternatePaths: opencodeSelection.alternates,
         guardianConfigPath: guardianSelection.primary,
@@ -113,6 +122,138 @@ export function ensurePackageConfigText(text, packageSpecifier = PACKAGE_NAME) {
     return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
 }
 // END_BLOCK_ENSURE_OPENCODE_PLUGIN_CONFIG
+// START_BLOCK_ENSURE_MANAGED_SUBAGENT_CONFIG
+export function ensureManagedSubagentsConfigText(text, paths) {
+    if (!text?.trim()) {
+        return renderJson({
+            $schema: OPENCODE_SCHEMA_URL,
+            agent: Object.fromEntries(MANAGED_SUBAGENTS.map((definition) => [
+                definition.name,
+                getManagedSubagentRegistration(paths, definition.name),
+            ])),
+        });
+    }
+    const document = parseObjectDocument(text, "OpenCode config");
+    const currentAgents = readAgentMap(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,
+        }));
+    }
+    for (const definition of MANAGED_SUBAGENTS) {
+        const currentEntry = currentAgents[definition.name];
+        const nextEntry = {
+            ...getManagedSubagentRegistration(paths, definition.name),
+            ...currentEntry,
+        };
+        if (JSON.stringify(currentEntry) === JSON.stringify(nextEntry)) {
+            continue;
+        }
+        nextText = applyEdits(nextText, modify(nextText, ["agent", definition.name], nextEntry, {
+            formattingOptions: JSON_FORMAT,
+        }));
+    }
+    return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
+}
+export async function syncManagedSubagentRegistrations(paths) {
+    const currentText = await readOptionalText(paths.opencodeConfigPath);
+    const nextText = ensureManagedSubagentsConfigText(currentText, paths);
+    if (currentText === nextText) {
+        return { path: paths.opencodeConfigPath, changed: false };
+    }
+    await writeText(paths.opencodeConfigPath, nextText);
+    return { path: paths.opencodeConfigPath, changed: true };
+}
+export async function installManagedSubagentPrompts(paths, options) {
+    const results = [];
+    for (const definition of MANAGED_SUBAGENTS) {
+        const promptPath = getManagedSubagentPromptPath(paths, definition.name);
+        const currentText = await readOptionalText(promptPath);
+        if (!currentText) {
+            await writeText(promptPath, await renderManagedSubagentPrompt(definition.name));
+            results.push({ action: "created", path: promptPath });
+            continue;
+        }
+        if (!options.force) {
+            if (!isManagedFile(currentText)) {
+                results.push({
+                    action: "skipped",
+                    path: promptPath,
+                    reason: "existing file is not managed by vvoc",
+                });
+            }
+            else {
+                results.push({ action: "kept", path: promptPath });
+            }
+            continue;
+        }
+        results.push(await syncManagedSubagentPrompt(paths, definition.name, options));
+    }
+    return results;
+}
+export async function syncManagedSubagentPrompts(paths, options) {
+    const results = [];
+    for (const definition of MANAGED_SUBAGENTS) {
+        results.push(await syncManagedSubagentPrompt(paths, definition.name, options));
+    }
+    return results;
+}
+export async function readManagedSubagentModels(paths) {
+    const models = Object.fromEntries(MANAGED_SUBAGENTS.map((definition) => [definition.name, undefined]));
+    const currentText = await readOptionalText(paths.opencodeConfigPath);
+    if (!currentText) {
+        return models;
+    }
+    const document = parseObjectDocument(currentText, paths.opencodeConfigPath);
+    const agentMap = readAgentMap(document, paths.opencodeConfigPath);
+    for (const definition of MANAGED_SUBAGENTS) {
+        const currentEntry = agentMap[definition.name];
+        if (currentEntry?.model !== undefined) {
+            models[definition.name] = readNonEmptyString(currentEntry.model, `${definition.name}: model`);
+        }
+    }
+    return models;
+}
+export async function writeManagedSubagentModel(paths, agentName, options) {
+    const currentText = await readOptionalText(paths.opencodeConfigPath);
+    if (!currentText && !options.ensureEntry) {
+        return { action: "kept", path: paths.opencodeConfigPath };
+    }
+    const baseText = options.ensureEntry
+        ? ensureManagedSubagentsConfigText(currentText, paths)
+        : currentText;
+    if (!baseText) {
+        return { action: "kept", path: paths.opencodeConfigPath };
+    }
+    const document = parseObjectDocument(baseText, paths.opencodeConfigPath);
+    const agentMap = readAgentMap(document, paths.opencodeConfigPath);
+    const currentEntry = agentMap[agentName];
+    if (!currentEntry && !options.ensureEntry) {
+        return { action: "kept", path: paths.opencodeConfigPath };
+    }
+    const nextEntry = {
+        ...getManagedSubagentRegistration(paths, agentName),
+        ...currentEntry,
+    };
+    if (options.model) {
+        nextEntry.model = options.model;
+    }
+    else {
+        delete nextEntry.model;
+    }
+    const nextText = updateAgentEntryText(baseText, agentName, nextEntry);
+    if ((currentText ?? "") === nextText) {
+        return { action: "kept", path: paths.opencodeConfigPath };
+    }
+    await writeText(paths.opencodeConfigPath, nextText);
+    return {
+        action: currentText ? "updated" : "created",
+        path: paths.opencodeConfigPath,
+    };
+}
+// END_BLOCK_ENSURE_MANAGED_SUBAGENT_CONFIG
 export function parseGuardianConfigText(text, label) {
     return normalizeGuardianOverrides(parseObjectDocument(text, label), label);
 }
@@ -513,6 +654,86 @@ function normalizePluginList(currentPlugins, packageSpecifier) {
 function isPackagePluginSpecifier(value) {
     return value === PACKAGE_NAME || value.startsWith(`${PACKAGE_NAME}@`);
 }
+// START_BLOCK_MANAGED_SUBAGENT_HELPERS
+function readAgentMap(document, label) {
+    const raw = document.agent;
+    if (raw === undefined) {
+        return {};
+    }
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`${label}: expected "agent" to be an object`);
+    }
+    const entries = {};
+    for (const [name, value] of Object.entries(raw)) {
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+            throw new Error(`${label}: expected "agent.${name}" to be an object`);
+        }
+        entries[name] = value;
+    }
+    return entries;
+}
+function getManagedSubagentPromptPath(paths, agentName) {
+    return join(paths.managedAgentsDirPath, getManagedSubagentDefinition(agentName).promptFileName);
+}
+function getManagedSubagentPromptReference(paths, agentName) {
+    const promptPath = getManagedSubagentPromptPath(paths, agentName);
+    const promptRef = relative(dirname(paths.opencodeConfigPath), promptPath).replaceAll("\\", "/");
+    return `{file:${promptRef.startsWith(".") ? promptRef : `./${promptRef}`}}`;
+}
+function getManagedSubagentRegistration(paths, agentName) {
+    const definition = getManagedSubagentDefinition(agentName);
+    const registration = {
+        description: definition.description,
+        mode: "subagent",
+        prompt: getManagedSubagentPromptReference(paths, agentName),
+    };
+    if (definition.steps !== undefined) {
+        registration.steps = definition.steps;
+    }
+    if (definition.permission) {
+        registration.permission = definition.permission;
+    }
+    return registration;
+}
+async function renderManagedSubagentPrompt(agentName) {
+    const template = (await loadManagedSubagentTemplate(agentName)).trim();
+    const header = [
+        "<!-- Managed by vvoc.",
+        "`vvoc sync` rewrites files with this marker while preserving agent registration and model settings elsewhere.",
+        "Remove this comment if you want to manage the file manually.",
+        "-->",
+        "",
+    ].join("\n");
+    return `${header}${template}\n`;
+}
+async function syncManagedSubagentPrompt(paths, agentName, options) {
+    const promptPath = getManagedSubagentPromptPath(paths, agentName);
+    const currentText = await readOptionalText(promptPath);
+    if (!currentText) {
+        await writeText(promptPath, await renderManagedSubagentPrompt(agentName));
+        return { action: "created", path: promptPath };
+    }
+    if (!options.force && !isManagedFile(currentText)) {
+        return {
+            action: "skipped",
+            path: promptPath,
+            reason: "existing file is not managed by vvoc",
+        };
+    }
+    const nextText = await renderManagedSubagentPrompt(agentName);
+    if (currentText === nextText) {
+        return { action: "kept", path: promptPath };
+    }
+    await writeText(promptPath, nextText);
+    return { action: "updated", path: promptPath };
+}
+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)));
+}
+// END_BLOCK_MANAGED_SUBAGENT_HELPERS
 function normalizeGuardianOverrides(raw, label) {
     if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
         throw new Error(`${label}: expected a top-level object`);