@osovv/vv-opencode 0.1.0

package/AGENTS.md

@@ -0,0 +1,164 @@
+# GRACE Framework - Project Engineering Protocol
+
+## Keywords
+opencode, plugins, workflow
+
+## Annotation
+Portable OpenCode workflow package with plugins and a Bun CLI for install, sync, and cross-device setup.
+
+## Core Principles
+
+### 1. Never Write Code Without a Contract
+Before generating or editing any module, create or update its MODULE_CONTRACT with PURPOSE, SCOPE, INPUTS, and OUTPUTS. The contract is the source of truth. Code implements the contract, not the other way around.
+
+### 2. Semantic Markup Is Load-Bearing Structure
+Markers like `// START_BLOCK_<NAME>` and `// END_BLOCK_<NAME>` are navigation anchors, not documentation. They must be:
+- uniquely named
+- paired
+- proportionally sized so one block fits inside an LLM working window
+
+### 3. Knowledge Graph Is Always Current
+`docs/knowledge-graph.xml` is the project map. When you add a module, move a module, rename exports, or add dependencies, update the graph so future agents can navigate deterministically.
+
+### 4. Verification Is a First-Class Artifact
+Testing, traces, and log anchors are designed before large execution waves. `docs/verification-plan.xml` is part of the architecture, not an afterthought. Logs are evidence. Tests are executable contracts.
+
+### 5. Top-Down Synthesis
+Code generation follows:
+`RequirementsAnalysis -> TechnologyStack -> DevelopmentPlan -> VerificationPlan -> Code + Tests`
+
+Never jump straight to code when requirements, architecture, or verification intent are still unclear.
+
+### 6. Governed Autonomy
+Agents have freedom in HOW to implement, but not in WHAT to build. Contracts, plans, graph references, and verification requirements define the allowed space.
+
+## Semantic Markup Reference
+
+### Module Level
+```
+// FILE: path/to/file.ext
+// VERSION: 1.0.0
+// START_MODULE_CONTRACT
+//   PURPOSE: [What this module does - one sentence]
+//   SCOPE: [What operations are included]
+//   DEPENDS: [List of module dependencies]
+//   LINKS: [Knowledge graph references]
+//   ROLE: [Optional: RUNTIME | TEST | BARREL | CONFIG | TYPES | SCRIPT]
+//   MAP_MODE: [Optional: EXPORTS | LOCALS | SUMMARY | NONE]
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   exportedSymbol - one-line description
+// END_MODULE_MAP
+```
+
+### Function or Component Level
+```
+// START_CONTRACT: functionName
+//   PURPOSE: [What it does]
+//   INPUTS: { paramName: Type - description }
+//   OUTPUTS: { ReturnType - description }
+//   SIDE_EFFECTS: [External state changes or "none"]
+//   LINKS: [Related modules/functions]
+// END_CONTRACT: functionName
+```
+
+### Code Block Level
+```
+// START_BLOCK_VALIDATE_INPUT
+// ... code ...
+// END_BLOCK_VALIDATE_INPUT
+```
+
+### Change Tracking
+```
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v1.2.0 - What changed and why]
+// END_CHANGE_SUMMARY
+```
+
+### Optional Lint Semantics
+
+Use `ROLE` and `MAP_MODE` only when the file should be linted differently from a normal runtime module.
+
+- `RUNTIME` + `EXPORTS`: normal source files with public APIs
+- `TEST` + `LOCALS`: tests where the map should describe helpers, fixtures, and assertion surfaces
+- `BARREL` + `SUMMARY`: re-export aggregators and grouped entry points
+- `CONFIG` + `NONE`: build or tool configuration files
+- `TYPES` + `EXPORTS`: pure type/interface modules
+- `SCRIPT` + `LOCALS`: CLI/bootstrap/smoke scripts
+
+## Logging and Trace Convention
+
+All important logs must point back to semantic blocks:
+```
+logger.info(`[ModuleName][functionName][BLOCK_NAME] message`, {
+  correlationId,
+  stableField: value,
+});
+```
+
+Rules:
+- prefer structured fields over prose-heavy log lines
+- redact secrets and high-risk payloads
+- treat missing log anchors on critical branches as a verification defect
+- update tests when log markers change intentionally
+
+## Verification Conventions
+
+`docs/verification-plan.xml` is the project-wide verification contract. Keep it current when module scope, test files, commands, critical log markers, or gate expectations change. Use `docs/operational-packets.xml` as the canonical schema for execution packets, graph deltas, verification deltas, and failure handoff packets.
+
+Testing rules:
+- deterministic assertions first
+- trace or log assertions when trajectory matters
+- test files may also carry MODULE_CONTRACT, MODULE_MAP, semantic blocks, and CHANGE_SUMMARY when they are substantial
+- module-local tests should stay close to the module they verify
+- wave-level and phase-level checks should be explicit in the verification plan
+
+## File Structure
+```
+docs/
+  requirements.xml       - Product requirements and use cases
+  technology.xml         - Stack decisions, tooling, observability, testing
+  development-plan.xml   - Modules, phases, data flows, ownership, write scopes
+  verification-plan.xml  - Test strategy, trace expectations, module and phase gates
+  knowledge-graph.xml    - Project-wide navigation graph
+  operational-packets.xml - Canonical packet, delta, and failure handoff templates
+src/
+  ... code with GRACE markup ...
+tests/
+  ... tests with GRACE-aware evidence where appropriate ...
+```
+
+## Documentation Artifacts - Unique Tag Convention
+
+In `docs/*.xml`, repeated entities must use their unique ID as the XML tag name instead of a generic tag with an `ID` attribute. This reduces closing-tag ambiguity and gives LLMs stronger anchors.
+
+### Tag naming conventions
+
+| Entity type | Anti-pattern | Correct (unique tags) |
+|---|---|---|
+| Module | `<Module ID="M-CONFIG">...</Module>` | `<M-CONFIG NAME="Config" TYPE="UTILITY">...</M-CONFIG>` |
+| Verification module | `<Verification ID="V-M-AUTH">...</Verification>` | `<V-M-AUTH MODULE="M-AUTH">...</V-M-AUTH>` |
+| Phase | `<Phase number="1">...</Phase>` | `<Phase-1 name="Foundation">...</Phase-1>` |
+| Flow | `<Flow ID="DF-SEARCH">...</Flow>` | `<DF-SEARCH NAME="...">...</DF-SEARCH>` |
+| Use case | `<UseCase ID="UC-001">...</UseCase>` | `<UC-001>...</UC-001>` |
+| Step | `<step order="1">...</step>` | `<step-1>...</step-1>` |
+| Export | `<export name="config" .../>` | `<export-config .../>` |
+| Function | `<function name="search" .../>` | `<fn-search .../>` |
+| Type | `<type name="SearchResult" .../>` | `<type-SearchResult .../>` |
+| Class | `<class name="Error" .../>` | `<class-Error .../>` |
+
+### What NOT to change
+- `CrossLink` tags stay self-closing
+- single-use structural wrappers like `<contract>`, `<inputs>`, `<outputs>`, `<annotations>`, `<test-files>`, `<module-checks>`, and `<phase-gates>` stay generic
+- code-level markup already uses unique names and stays as-is
+
+## Rules for Modifications
+
+1. Read the MODULE_CONTRACT before editing any file.
+2. After editing source or test files, update MODULE_MAP in a way that matches the file's role and map mode.
+3. After adding or removing modules, update `docs/knowledge-graph.xml`.
+4. After changing test files, commands, critical scenarios, or log markers, update `docs/verification-plan.xml`.
+5. After fixing bugs, add a CHANGE_SUMMARY entry and strengthen nearby verification if the old evidence was weak.
+6. Never remove semantic markup anchors unless the structure is intentionally replaced with better anchors.

package/README.md

@@ -0,0 +1,43 @@
+# vv-opencode
+
+`@osovv/vv-opencode` - переносимый набор плагинов и CLI для `opencode`.
+
+Стартовая цель репозитория:
+
+- упаковать `guardian` как npm-плагин для `opencode`
+- добавить CLI `vvoc` для установки, синка и диагностики конфигов
+- сделать перенос workflow между устройствами предсказуемым и идемпотентным
+
+## План v1
+
+- npm-пакет `@osovv/vv-opencode`
+- bin `vvoc`
+- экспорт `GuardianPlugin`
+- команды `install`, `sync`, `status`, `doctor`, `guardian config`
+
+## Локальная разработка
+
+```bash
+bun install
+bun run build
+bun test
+```
+
+## Установка в OpenCode
+
+После публикации пакета:
+
+```bash
+bunx vvoc install
+```
+
+CLI добавит `@osovv/vv-opencode` в `opencode` config и при необходимости создаст `guardian.jsonc`.
+
+Эквивалент ручной настройки:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@osovv/vv-opencode"]
+}
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/cli.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env bun
+import { defineCommand, runMain } from "citty";
+import doctor from "./commands/doctor.js";
+import guardian from "./commands/guardian.js";
+import install from "./commands/install.js";
+import status from "./commands/status.js";
+import sync from "./commands/sync.js";
+const main = defineCommand({
+    meta: {
+        name: "vvoc",
+        version: "0.1.0",
+        description: "Install and sync vv-opencode plugins for OpenCode.",
+    },
+    subCommands: {
+        install,
+        sync,
+        status,
+        doctor,
+        guardian,
+    },
+});
+await runMain(main);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,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;AAEtC,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,oDAAoD;KAClE;IACD,WAAW,EAAE;QACX,OAAO;QACP,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;KACT;CACF,CAAC,CAAC;AAEH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,19 @@
+declare const _default: import("citty").CommandDef<{
+    readonly scope: {
+        readonly type: "enum";
+        readonly options: ["global", "project"];
+        readonly default: "global";
+        readonly description: "Inspect global or project config.";
+    };
+    readonly source: {
+        readonly type: "enum";
+        readonly options: ["local", "npm"];
+        readonly default: "local";
+        readonly description: "Validate local plugin shim or npm package configuration.";
+    };
+    readonly "config-dir": {
+        readonly type: "string";
+        readonly description: "Override the global OpenCode config directory.";
+    };
+}>;
+export default _default;

package/dist/commands/doctor.js

@@ -0,0 +1,70 @@
+import { defineCommand } from "citty";
+import { inspectInstallation, resolvePaths } from "../lib/opencode.js";
+export default defineCommand({
+    meta: {
+        name: "doctor",
+        description: "Diagnose vv-opencode installation issues.",
+    },
+    args: {
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Inspect global or project config.",
+        },
+        source: {
+            type: "enum",
+            options: ["local", "npm"],
+            default: "local",
+            description: "Validate local plugin shim or npm package configuration.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global OpenCode config directory.",
+        },
+    },
+    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 inspection = await inspectInstallation(paths);
+        const problems = [...inspection.problems];
+        if (args.source === "npm") {
+            if (!inspection.opencode.packageConfigured) {
+                problems.push(`${inspection.opencode.path} does not include ${"@osovv/vv-opencode"}`);
+            }
+        }
+        else if (!inspection.localPlugin.exists) {
+            problems.push(`${inspection.localPlugin.path} is missing`);
+        }
+        console.log(`Scope: ${inspection.scope}`);
+        console.log(`OpenCode config: ${inspection.opencode.path}`);
+        console.log(`OpenCode config parse: ${inspection.opencode.parseError ? inspection.opencode.parseError : "ok"}`);
+        console.log(`Configured plugins: ${inspection.opencode.plugins.length > 0 ? inspection.opencode.plugins.join(", ") : "<none>"}`);
+        console.log(`Local plugin shim: ${inspection.localPlugin.path}`);
+        console.log(`Local plugin shim state: ${inspection.localPlugin.exists ? inspection.localPlugin.managed ? "managed" : "unmanaged" : "missing"}`);
+        console.log(`Guardian config: ${inspection.guardian.path}`);
+        console.log(`Guardian config parse: ${inspection.guardian.parseError ? inspection.guardian.parseError : inspection.guardian.exists ? "ok" : "missing"}`);
+        console.log(`Guardian config managed by vvoc: ${inspection.guardian.managed ? "yes" : "no"}`);
+        if (inspection.warnings.length > 0) {
+            console.log("Warnings:");
+            for (const warning of inspection.warnings) {
+                console.log(`- ${warning}`);
+            }
+        }
+        if (problems.length > 0) {
+            console.error("Problems:");
+            for (const problem of problems) {
+                console.error(`- ${problem}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        console.log("Doctor: ok");
+    },
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/guardian.d.ts

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

package/dist/commands/guardian.js

@@ -0,0 +1,119 @@
+import { defineCommand } from "citty";
+import { describeWriteResult, renderGuardianConfig, resolvePaths, writeGuardianConfig, } from "../lib/opencode.js";
+const config = defineCommand({
+    meta: {
+        name: "config",
+        description: "Write or print guardian.jsonc.",
+    },
+    args: {
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Write global or project Guardian config.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global OpenCode config directory.",
+        },
+        force: {
+            type: "boolean",
+            description: "Allow overwriting an unmanaged guardian config.",
+        },
+        print: {
+            type: "boolean",
+            description: "Print the config instead of writing it.",
+        },
+        model: {
+            type: "string",
+            description: "Override the Guardian model.",
+        },
+        variant: {
+            type: "string",
+            description: "Override the Guardian variant.",
+        },
+        "timeout-ms": {
+            type: "string",
+            description: "Timeout in milliseconds.",
+        },
+        "approval-risk-threshold": {
+            type: "string",
+            description: "Approval threshold from 0 to 100.",
+        },
+        "review-toast-duration-ms": {
+            type: "string",
+            description: "Toast duration in milliseconds.",
+        },
+    },
+    async run({ args }) {
+        const overrides = readGuardianOverridesFromArgs(args);
+        if (args.print) {
+            process.stdout.write(renderGuardianConfig(overrides));
+            return;
+        }
+        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 result = await writeGuardianConfig(paths, overrides, { force: Boolean(args.force) });
+        console.log(describeWriteResult(result));
+        if (result.action === "skipped") {
+            process.exitCode = 1;
+        }
+    },
+});
+export default defineCommand({
+    meta: {
+        name: "guardian",
+        description: "Guardian-specific helpers.",
+    },
+    subCommands: {
+        config,
+    },
+});
+function readGuardianOverridesFromArgs(args) {
+    const overrides = {};
+    if (typeof args.model === "string" && args.model.trim()) {
+        overrides.model = args.model.trim();
+    }
+    if (typeof args.variant === "string" && args.variant.trim()) {
+        overrides.variant = args.variant.trim();
+    }
+    const timeoutMs = parsePositiveIntegerArg(args["timeout-ms"], "timeout-ms");
+    if (timeoutMs !== undefined) {
+        overrides.timeoutMs = timeoutMs;
+    }
+    const approvalRiskThreshold = parseThresholdArg(args["approval-risk-threshold"], "approval-risk-threshold");
+    if (approvalRiskThreshold !== undefined) {
+        overrides.approvalRiskThreshold = approvalRiskThreshold;
+    }
+    const reviewToastDurationMs = parsePositiveIntegerArg(args["review-toast-duration-ms"], "review-toast-duration-ms");
+    if (reviewToastDurationMs !== undefined) {
+        overrides.reviewToastDurationMs = reviewToastDurationMs;
+    }
+    return overrides;
+}
+function parsePositiveIntegerArg(value, label) {
+    if (value === undefined || value === "") {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${label} must be a positive integer`);
+    }
+    return Math.round(parsed);
+}
+function parseThresholdArg(value, label) {
+    if (value === undefined || value === "") {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`${label} must be a number`);
+    }
+    return Math.max(0, Math.min(100, Math.round(parsed)));
+}
+//# sourceMappingURL=guardian.js.map

package/dist/commands/guardian.js.map

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

package/dist/commands/install.d.ts

@@ -0,0 +1,28 @@
+declare const _default: import("citty").CommandDef<{
+    readonly scope: {
+        readonly type: "enum";
+        readonly options: ["global", "project"];
+        readonly default: "global";
+        readonly description: "Write to global or project config.";
+    };
+    readonly source: {
+        readonly type: "enum";
+        readonly options: ["local", "npm"];
+        readonly default: "local";
+        readonly description: "Install a local plugin shim or npm package reference.";
+    };
+    readonly "config-dir": {
+        readonly type: "string";
+        readonly description: "Override the global OpenCode config directory.";
+    };
+    readonly force: {
+        readonly type: "boolean";
+        readonly description: "Allow overwriting an existing guardian config when needed.";
+    };
+    readonly "guardian-config": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly description: "Create guardian.jsonc when missing.";
+    };
+}>;
+export default _default;

package/dist/commands/install.js

@@ -0,0 +1,59 @@
+import { defineCommand } from "citty";
+import { describeWriteResult, ensurePackageInstalled, installGuardianConfig, installLocalPlugin, resolvePaths, } from "../lib/opencode.js";
+export default defineCommand({
+    meta: {
+        name: "install",
+        description: "Install vv-opencode into OpenCode config.",
+    },
+    args: {
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Write to global or project config.",
+        },
+        source: {
+            type: "enum",
+            options: ["local", "npm"],
+            default: "local",
+            description: "Install a local plugin shim or npm package reference.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global OpenCode config directory.",
+        },
+        force: {
+            type: "boolean",
+            description: "Allow overwriting an existing guardian config when needed.",
+        },
+        "guardian-config": {
+            type: "boolean",
+            default: true,
+            description: "Create guardian.jsonc when missing.",
+        },
+    },
+    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,
+        });
+        if (args.source === "npm") {
+            const opencode = await ensurePackageInstalled(paths);
+            console.log(`${opencode.changed ? "Updated" : "Kept"} ${opencode.path}`);
+        }
+        else {
+            const localPlugin = await installLocalPlugin(paths, { force: Boolean(args.force) });
+            console.log(describeWriteResult(localPlugin));
+        }
+        if (args["guardian-config"] === false) {
+            console.log(`Skipped ${paths.guardianConfigPath} (guardian config disabled)`);
+            return;
+        }
+        const guardian = await installGuardianConfig(paths, { force: Boolean(args.force) });
+        console.log(describeWriteResult(guardian));
+    },
+});
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,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,MAAM,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;YACzB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,uDAAuD;SACrE;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;SAC9D;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;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,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,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,kBAAkB,6BAA6B,CAAC,CAAC;YAC9E,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,13 @@
+declare const _default: import("citty").CommandDef<{
+    readonly scope: {
+        readonly type: "enum";
+        readonly options: ["global", "project"];
+        readonly default: "global";
+        readonly description: "Inspect global or project config.";
+    };
+    readonly "config-dir": {
+        readonly type: "string";
+        readonly description: "Override the global OpenCode config directory.";
+    };
+}>;
+export default _default;

package/dist/commands/status.js

@@ -0,0 +1,47 @@
+import { defineCommand } from "citty";
+import { inspectInstallation, resolvePaths } from "../lib/opencode.js";
+export default defineCommand({
+    meta: {
+        name: "status",
+        description: "Show vv-opencode installation status.",
+    },
+    args: {
+        scope: {
+            type: "enum",
+            options: ["global", "project"],
+            default: "global",
+            description: "Inspect global or project config.",
+        },
+        "config-dir": {
+            type: "string",
+            description: "Override the global OpenCode config directory.",
+        },
+    },
+    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 inspection = await inspectInstallation(paths);
+        console.log(`Scope: ${inspection.scope}`);
+        console.log(`OpenCode config: ${inspection.opencode.path}`);
+        console.log(`OpenCode config exists: ${inspection.opencode.exists ? "yes" : "no"}`);
+        console.log(`Package configured in opencode.json: ${inspection.opencode.packageConfigured ? "yes" : "no"}`);
+        console.log(`Local plugin shim: ${inspection.localPlugin.path}`);
+        console.log(`Local plugin shim exists: ${inspection.localPlugin.exists ? "yes" : "no"}`);
+        console.log(`Local plugin shim managed by vvoc: ${inspection.localPlugin.managed ? "yes" : "no"}`);
+        console.log(`Guardian config: ${inspection.guardian.path}`);
+        console.log(`Guardian config exists: ${inspection.guardian.exists ? "yes" : "no"}`);
+        console.log(`Guardian config managed by vvoc: ${inspection.guardian.managed ? "yes" : "no"}`);
+        if (inspection.warnings.length > 0) {
+            console.log("Warnings:");
+            for (const warning of inspection.warnings) {
+                console.log(`- ${warning}`);
+            }
+        }
+    },
+});
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,23 @@
+declare const _default: import("citty").CommandDef<{
+    readonly scope: {
+        readonly type: "enum";
+        readonly options: ["global", "project"];
+        readonly default: "global";
+        readonly description: "Sync global or project config.";
+    };
+    readonly source: {
+        readonly type: "enum";
+        readonly options: ["local", "npm"];
+        readonly default: "local";
+        readonly description: "Sync a local plugin shim or npm package reference.";
+    };
+    readonly "config-dir": {
+        readonly type: "string";
+        readonly description: "Override the global OpenCode config directory.";
+    };
+    readonly force: {
+        readonly type: "boolean";
+        readonly description: "Allow rewriting unmanaged guardian config files.";
+    };
+}>;
+export default _default;