opencode-rules-md 0.8.3 → 0.8.5

package/dist/src/cli/install.js

@@ -0,0 +1,148 @@
+// ---------------------------------------------------------------------------
+// src/cli/install.ts — `omd install` command implementation.
+//
+// Dual-config install loop: iterates over ["opencode", "tui"], loads each
+// config, normalizes + deduplicates the plugin list, appends the fresh
+// specifier, and writes atomically with a timestamped backup. When the version
+// is omitted or "latest", the latest published npm version is resolved so the
+// written specifier matches the concrete version (important for accurate
+// update checks) and any stale local cache can be purged.
+// ---------------------------------------------------------------------------
+import { dirname, join } from 'path';
+import { PLUGIN_NAME, loadGlobalConfig, matchesPlugin, normalizePlugin, backupIfWritable, rotateBackups, writeAtomically, } from './config.js';
+import { fetchLatestVersion } from './registry.js';
+import { purgeDirectory, resolveCachePath } from './update.js';
+export const CONFIG_BASENAMES = ['opencode', 'tui'];
+/**
+ * Resolve the concrete version to write.
+ *
+ * - If the user supplied an explicit version (not "latest" and not empty), use
+ *   it unchanged.
+ * - Otherwise, ask the npm registry for the latest published version.
+ * - If the registry is unreachable, fall back to the literal "@latest" tag so
+ *   the install command never hard-fails due to network issues. This preserves
+ *   the previous behavior while still allowing the cache check to compare when
+ *   a concrete version is known.
+ */
+async function resolveVersion(opts) {
+    const raw = opts.version?.trim() ?? '';
+    const wantsLatest = raw === '' || raw === 'latest';
+    if (!wantsLatest) {
+        return raw;
+    }
+    // Tests can short-circuit the network call via latestVersion.
+    if (opts.latestVersion !== undefined) {
+        return opts.latestVersion;
+    }
+    const latest = await fetchLatestVersion();
+    return latest ?? 'latest';
+}
+/**
+ * Read the version field from a cached package.json, if present.
+ * Returns null when the file is missing or unreadable.
+ */
+function readCacheVersion(fs, cachePath) {
+    const pkgPath = join(cachePath, 'package.json');
+    try {
+        if (!fs.existsSync(pkgPath)) {
+            return null;
+        }
+        const pkg = JSON.parse(fs.readFileSync(pkgPath));
+        return typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        // A broken cache is treated as "version unknown" so it gets purged.
+        return null;
+    }
+}
+/**
+ * Purge the local cache directory when it is stale relative to the version we
+ * just installed. If the cache version cannot be determined, we err on the
+ * side of purging so the next npx invocation fetches a fresh copy.
+ */
+function purgeCacheIfStale(fs, env, resolvedVersion) {
+    // The literal "latest" tag is not a comparable version; we only purge when
+    // we have a concrete resolved version to compare against.
+    if (resolvedVersion === 'latest') {
+        return false;
+    }
+    const cachePath = resolveCachePath(env);
+    if (!fs.existsSync(cachePath)) {
+        return false;
+    }
+    const cacheVersion = readCacheVersion(fs, cachePath);
+    if (cacheVersion === null || cacheVersion !== resolvedVersion) {
+        purgeDirectory(fs, cachePath);
+        return true;
+    }
+    return false;
+}
+/**
+ * Install opencode-rules-md into both opencode.json and tui.json configs.
+ *
+ * Options:
+ *   version    — npm version specifier (default: latest from registry)
+ *   dryRun     — run full pipeline without writing to disk
+ *   yes        — accepted for future prompts, no-op here
+ *   latestVersion — test hook for the resolved latest version
+ */
+export const runInstall = async (opts = {}, fs, env) => {
+    const resolvedVersion = await resolveVersion(opts);
+    const freshEntry = `${PLUGIN_NAME}@${resolvedVersion}`;
+    const results = [];
+    let anyProcessed = false;
+    for (const basename of CONFIG_BASENAMES) {
+        const loaded = loadGlobalConfig(fs, env, basename);
+        const plugins = normalizePlugin(loaded.data['plugins']);
+        // Find existing entry for this plugin
+        const existingEntry = plugins.find(p => matchesPlugin(p));
+        // No-op if the same specifier is already installed
+        if (existingEntry === freshEntry) {
+            results.push({ path: loaded.path, status: 'skipped', backup: null });
+            continue;
+        }
+        anyProcessed = true;
+        // Build the new plugin list: remove all matching entries, append fresh specifier.
+        // Existing non-matching plugins are preserved in their original order.
+        const withoutStale = plugins.filter(p => !matchesPlugin(p));
+        const newPlugins = [...withoutStale, freshEntry];
+        const newData = { ...loaded.data, plugins: newPlugins };
+        const newContent = JSON.stringify(newData, null, 2) + '\n';
+        if (opts.dryRun) {
+            results.push({ path: loaded.path, status: 'wrote', backup: null });
+            continue;
+        }
+        // Backup the existing file if it exists
+        let backup;
+        if (loaded.exists) {
+            backup = backupIfWritable(fs, loaded.path);
+            if (backup !== undefined) {
+                const dir = dirname(loaded.path);
+                const segs = loaded.path.replace(/\\/g, '/').split('/');
+                const base = segs[segs.length - 1] ?? loaded.path;
+                const dot = base.lastIndexOf('.');
+                const name = dot >= 0 ? base.slice(0, dot) : base;
+                rotateBackups(fs, dir, name, 3);
+            }
+        }
+        writeAtomically(fs, loaded.path, newContent);
+        results.push({
+            path: loaded.path,
+            status: 'wrote',
+            backup: backup ?? null,
+        });
+    }
+    // After writing the configs, purge a stale local cache so the next run of the
+    // plugin starts from the version we just registered. In dry-run mode we
+    // never touch the filesystem.
+    let purged = false;
+    if (!opts.dryRun) {
+        purged = purgeCacheIfStale(fs, env, resolvedVersion);
+    }
+    return {
+        status: anyProcessed ? 'wrote' : 'skipped',
+        results,
+        purged,
+    };
+};
+//# sourceMappingURL=install.js.map

package/dist/src/cli/install.js.map

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

package/dist/src/cli/main.d.ts

@@ -0,0 +1,14 @@
+import type { CliFs } from './config.js';
+export interface MainOptions {
+    fs?: CliFs;
+    env?: NodeJS.ProcessEnv;
+    stdout?: (s: string) => void;
+    stderr?: (s: string) => void;
+    /**
+     * Optional injection point for tests: pretend the npm registry returned this
+     * version when "latest" is requested by install or update.
+     */
+    latestVersion?: string;
+}
+export declare const runMain: (opts: MainOptions, argv: string[]) => Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/src/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/cli/main.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuHzC,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,OAAO,GAClB,MAAM,WAAW,EACjB,MAAM,MAAM,EAAE,KACb,OAAO,CAAC,MAAM,CA4IhB,CAAC"}

package/dist/src/cli/main.js

@@ -0,0 +1,244 @@
+// ---------------------------------------------------------------------------
+// src/cli/main.ts — `omd` CLI entry point.
+//
+// Command dispatch using node:util.parseArgs.
+// Bare `omd` → install (default).
+// Exit codes: 0 success/no-op, 1 health failure, 2 usage error.
+// ---------------------------------------------------------------------------
+import { parseArgs } from 'node:util';
+import { runInstall } from './install.js';
+import { runUninstall } from './uninstall.js';
+import { runStatus, runDoctor } from './status.js';
+import { runUpdate } from './update.js';
+import { createRealFs } from './real-fs.js';
+// ─── Usage ───────────────────────────────────────────────────────────────────
+const USAGE = `omd — opencode-rules-md plugin manager
+
+Usage:
+  omd [command] [options]
+
+Commands:
+  install   Register opencode-rules-md in both opencode.json and tui.json
+  uninstall Remove opencode-rules-md from both configs
+  status    Show installed plugin state for each config
+  doctor    Run health checks for the plugin environment
+  update    Check for new versions and purge stale cache
+
+Options:
+  --dry-run    Show what would be changed without writing
+  --version    Pin to a specific version (install only)
+  --latest     Use the latest version (install only)
+  --purge      Also remove ~/.cache/opencode/node_modules/opencode-rules-md (uninstall only)
+  --yes        Accept all prompts automatically
+
+Examples:
+  omd               # install with defaults (latest)
+  omd install        # same as bare omd
+  omd install --dry-run
+  omd install --version 2.0.0
+  omd uninstall --purge
+`.trim();
+const printUsage = (stdout) => {
+    stdout(USAGE);
+};
+// ─── Manual argv parsing — extract command before passing to parseArgs ────────
+/**
+ * Known option flags (long-form).
+ * We detect unknown flags by scanning argv for anything starting with `-` or `--`
+ * that is NOT in this set.
+ */
+const KNOWN_FLAGS = new Set([
+    '--help', '--dry-run', '--latest', '--purge', '--yes', '--version',
+    '-h', '-V',
+]);
+/**
+ * Known short options that take a value.
+ * e.g. `--version 2.0.0` → values.version = '2.0.0'
+ */
+const SHORT_OPTIONS_WITH_VALUE = new Set(['v']);
+/**
+ * Known long options that take a value.
+ */
+const LONG_OPTIONS_WITH_VALUE = new Set(['version']);
+/**
+ * Extract the command name (first non-option positional) from argv.
+ * Also returns unknown flags found before the command.
+ *
+ * Examples:
+ *   []           → { command: 'install', args: [], unknownFlags: [] }
+ *   ['install']  → { command: 'install', args: [], unknownFlags: [] }
+ *   ['notacommand'] → { command: 'notacommand', args: [], unknownFlags: [] }
+ *   ['install', '--dry-run'] → { command: 'install', args: ['--dry-run'], unknownFlags: [] }
+ *   ['install', '--unknown-opt'] → { command: 'install', args: ['--unknown-opt'], unknownFlags: ['--unknown-opt'] }
+ */
+function extractCommand(argv) {
+    const unknownFlags = [];
+    let command = null;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--') {
+            // Argument separator — remaining args are positional
+            break;
+        }
+        if (!arg.startsWith('-')) {
+            // First non-option is the command
+            if (command === null) {
+                command = arg;
+            }
+            continue;
+        }
+        // It's an option — check if known
+        if (!KNOWN_FLAGS.has(arg)) {
+            unknownFlags.push(arg);
+        }
+        // Skip the value for options that take one
+        const flagName = arg.startsWith('--')
+            ? arg.slice(2)
+            : arg.startsWith('-')
+                ? arg.slice(1)
+                : '';
+        if (LONG_OPTIONS_WITH_VALUE.has(flagName) ||
+            SHORT_OPTIONS_WITH_VALUE.has(flagName)) {
+            // Skip the next argv element if it's not an option itself
+            if (i + 1 < argv.length && !argv[i + 1].startsWith('-')) {
+                i++;
+            }
+        }
+    }
+    return { command, unknownFlags };
+}
+export const runMain = async (opts, argv) => {
+    const { fs = createRealFs(), env = process.env, stdout = (s) => console.log(s), stderr = (s) => console.error(s), } = opts;
+    // Intercept --help/-h before anything else
+    if (argv.includes('--help') || argv.includes('-h')) {
+        printUsage(stdout);
+        return 0;
+    }
+    // Extract command and detect unknown flags before parseArgs
+    const { command, unknownFlags } = extractCommand(argv);
+    if (unknownFlags.length > 0) {
+        stderr(`omd: unknown option ${unknownFlags[0]}`);
+        stderr("Run 'omd --help' for usage.");
+        return 2;
+    }
+    // Default to install for bare `omd`
+    const resolvedCommand = command ?? 'install';
+    try {
+        switch (resolvedCommand) {
+            case 'install': {
+                // Remaining argv for parseArgs to extract options
+                const remaining = argv.slice(argv.indexOf('install') + 1 || argv.indexOf(resolvedCommand) + 1);
+                const { values } = parseArgs({
+                    argv: remaining,
+                    allowPositionals: true,
+                    strict: false,
+                    options: {
+                        'dry-run': { type: 'boolean', default: false },
+                        version: { type: 'string', default: undefined },
+                        latest: { type: 'boolean', default: false },
+                        yes: { type: 'boolean', default: false },
+                    },
+                });
+                const installOpts = {
+                    version: values['latest'] ? 'latest' : String(values['version'] ?? ''),
+                    dryRun: Boolean(values['dry-run']),
+                    yes: Boolean(values['yes']),
+                    latestVersion: opts.latestVersion,
+                };
+                const result = await runInstall(installOpts, fs, env);
+                if (result.status === 'skipped') {
+                    stdout('omd: already installed (no changes needed)');
+                    return 0;
+                }
+                for (const r of result.results) {
+                    if (r.status === 'wrote') {
+                        stdout(`omd: registered in ${r.path}`);
+                    }
+                    else if (r.status === 'skipped') {
+                        stdout(`omd: ${r.path} — already up to date`);
+                    }
+                }
+                if (result.purged) {
+                    stdout('omd: cache purged');
+                }
+                return 0;
+            }
+            case 'uninstall': {
+                const remaining = argv.slice(argv.indexOf(resolvedCommand) + 1);
+                const { values } = parseArgs({
+                    argv: remaining,
+                    allowPositionals: true,
+                    strict: false,
+                    options: {
+                        'dry-run': { type: 'boolean', default: false },
+                        purge: { type: 'boolean', default: false },
+                        yes: { type: 'boolean', default: false },
+                    },
+                });
+                const uninstallOpts = {
+                    purge: Boolean(values['purge']),
+                    dryRun: Boolean(values['dry-run']),
+                    yes: Boolean(values['yes']),
+                };
+                const result = runUninstall(uninstallOpts, fs, env);
+                if (result.status === 'skipped') {
+                    stdout('omd: not installed (no changes needed)');
+                    return 0;
+                }
+                for (const r of result.results) {
+                    if (r.status === 'wrote') {
+                        stdout(`omd: removed from ${r.path}`);
+                    }
+                    else if (r.status === 'skipped') {
+                        stdout(`omd: ${r.path} — not present`);
+                    }
+                }
+                if (result.purged) {
+                    stdout('omd: cache purged');
+                }
+                return 0;
+            }
+            case 'status': {
+                await runStatus(fs, env, stdout);
+                return 0;
+            }
+            case 'doctor': {
+                const docResult = await runDoctor(fs, env, stdout, stderr);
+                return docResult.ok ? 0 : 1;
+            }
+            case 'update': {
+                const remaining = argv.slice(argv.indexOf(resolvedCommand) + 1);
+                const { values } = parseArgs({
+                    argv: remaining,
+                    allowPositionals: true,
+                    strict: false,
+                    options: {
+                        'dry-run': { type: 'boolean', default: false },
+                    },
+                });
+                const dryRun = Boolean(values['dry-run']);
+                const updateResult = await runUpdate(fs, env, stdout, stderr, { dryRun, latestVersion: opts.latestVersion });
+                if (updateResult.status === 'current') {
+                    stdout('omd: already at latest version');
+                }
+                return 0;
+            }
+            default:
+                stderr(`omd: unknown command '${resolvedCommand}'`);
+                stderr("Run 'omd --help' for usage.");
+                return 2;
+        }
+    }
+    catch (err) {
+        stderr(`omd: ${err.message}`);
+        return 1;
+    }
+};
+// ─── Entry point ─────────────────────────────────────────────────────────────
+// Only run when executed directly (not imported as a module in tests).
+const isMainModule = import.meta.url === `file://${process.argv[1]?.replace(/\\/g, '/')}`;
+if (isMainModule) {
+    const exitCode = await runMain({}, process.argv.slice(2));
+    process.exit(exitCode);
+}
+//# sourceMappingURL=main.js.map

package/dist/src/cli/main.js.map

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

package/dist/src/cli/real-fs.d.ts

@@ -0,0 +1,3 @@
+import type { CliFs } from "./config";
+export declare const createRealFs: () => CliFs;
+//# sourceMappingURL=real-fs.d.ts.map

package/dist/src/cli/real-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-fs.d.ts","sourceRoot":"","sources":["../../../src/cli/real-fs.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,eAAO,MAAM,YAAY,QAAO,KAsB9B,CAAC"}

package/dist/src/cli/real-fs.js

@@ -0,0 +1,32 @@
+// ---------------------------------------------------------------------------
+// src/cli/real-fs.ts — Default `CliFs` adapter backed by `node:fs`.
+//
+// The CLI commands default to the real filesystem in production. Tests inject
+// an in-memory adapter to keep everything deterministic and fast. All methods
+// are sync — the CLI is short-lived and never benefits from async I/O.
+// ---------------------------------------------------------------------------
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmdirSync, unlinkSync, writeFileSync, } from "node:fs";
+export const createRealFs = () => ({
+    readFileSync: (path) => readFileSync(path, "utf8"),
+    writeFileSync: (path, content) => {
+        writeFileSync(path, content);
+    },
+    renameSync: (from, to) => {
+        renameSync(from, to);
+    },
+    copyFileSync: (from, to) => {
+        copyFileSync(from, to);
+    },
+    unlinkSync: (path) => {
+        unlinkSync(path);
+    },
+    mkdirSync: (path, opts) => {
+        mkdirSync(path, opts);
+    },
+    readdirSync: (path) => readdirSync(path),
+    existsSync: (path) => existsSync(path),
+    rmdirSync: (path) => {
+        rmdirSync(path);
+    },
+});
+//# sourceMappingURL=real-fs.js.map

package/dist/src/cli/real-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-fs.js","sourceRoot":"","sources":["../../../src/cli/real-fs.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,MAAM,CAAC,MAAM,YAAY,GAAG,GAAU,EAAE,CAAC,CAAC;IACxC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;IAClD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QAC/B,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;QACvB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvB,CAAC;IACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;QACzB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACxB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;QAClB,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;CACF,CAAC,CAAC"}

package/dist/src/cli/registry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fetch the latest version string from the npm registry.
+ * Returns `null` when the registry is unreachable or the response is
+ * malformed — callers treat `null` as "can't determine, don't block".
+ */
+export declare const fetchLatestVersion: () => Promise<string | null>;
+/**
+ * Return whether the installed version is older than the latest.
+ * Unknown versions (null on either side) are never treated as stale.
+ */
+export declare const isStale: (installed: string | null, latest: string | null) => boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/cli/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/cli/registry.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,MAAM,GAAG,IAAI,CAShE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAClB,WAAW,MAAM,GAAG,IAAI,EACxB,QAAQ,MAAM,GAAG,IAAI,KACpB,OAGF,CAAC"}

package/dist/src/cli/registry.js

@@ -0,0 +1,34 @@
+// ---------------------------------------------------------------------------
+// src/cli/registry.ts — npm registry helpers for `omd`.
+//
+// Fetches the latest published version of `opencode-rules-md` from the npm
+// registry. Uses the native `fetch()` API (Node 20+) — no extra dependencies.
+// ---------------------------------------------------------------------------
+const REGISTRY_URL = "https://registry.npmjs.org/opencode-rules-md/latest";
+/**
+ * Fetch the latest version string from the npm registry.
+ * Returns `null` when the registry is unreachable or the response is
+ * malformed — callers treat `null` as "can't determine, don't block".
+ */
+export const fetchLatestVersion = async () => {
+    try {
+        const res = await fetch(REGISTRY_URL);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Return whether the installed version is older than the latest.
+ * Unknown versions (null on either side) are never treated as stale.
+ */
+export const isStale = (installed, latest) => {
+    if (!installed || !latest)
+        return false;
+    return installed !== latest;
+};
+//# sourceMappingURL=registry.js.map

package/dist/src/cli/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/cli/registry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAE9E,MAAM,YAAY,GAAG,qDAAqD,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,IAA4B,EAAE;IACnE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyB,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,SAAwB,EACxB,MAAqB,EACZ,EAAE;IACX,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,SAAS,KAAK,MAAM,CAAC;AAC9B,CAAC,CAAC"}

package/dist/src/cli/status.d.ts

@@ -0,0 +1,44 @@
+import { type CliFs } from './config.js';
+export interface StatusEntry {
+    basename: string;
+    path: string;
+    format: string;
+    installed: string | null;
+    notInstalled?: boolean;
+    otherPlugins: string[];
+    latest: string | null;
+    isLatest: boolean | null;
+}
+export interface StatusResult {
+    configs: StatusEntry[];
+}
+export interface DoctorOptions {
+    nodeVersion?: string;
+    hasBun?: boolean;
+    ruleDirExists?: boolean;
+}
+export interface DoctorResult {
+    ok: boolean;
+    issues: string[];
+    warnings: string[];
+    info: string[];
+}
+/**
+ * Run the status command: read-only probe for both opencode.json and tui.json.
+ * Reports path, format, installed specifier, other plugins, and freshness.
+ */
+export declare const runStatus: (fs: CliFs, env: NodeJS.ProcessEnv, log: (s: string) => void) => Promise<StatusResult>;
+/**
+ * Run the doctor command: health checks for the plugin environment.
+ * - Node >= 20: issue if below
+ * - Bun on PATH: issue if absent
+ * - Configs readable: issue if absent or malformed
+ * - Plugin shape valid: issue if malformed
+ * - Rule dir existence: warning if absent
+ * - Config dir writable: issue if not writable
+ * - Package freshness: info line about update availability
+ *
+ * Exit 1 if any issues found.
+ */
+export declare const runDoctor: (fs: CliFs, env: NodeJS.ProcessEnv, log: (s: string) => void, error: (s: string) => void, opts?: DoctorOptions) => Promise<DoctorResult>;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/status.ts"],"names":[],"mappings":"AAWA,OAAO,EAIL,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAID,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAWD;;;GAGG;AACH,eAAO,MAAM,SAAS,GACpB,IAAI,KAAK,EACT,KAAK,MAAM,CAAC,UAAU,EACtB,KAAK,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,KACvB,OAAO,CAAC,YAAY,CA+CtB,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GACpB,IAAI,KAAK,EACT,KAAK,MAAM,CAAC,UAAU,EACtB,KAAK,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACxB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC1B,OAAM,aAAkB,KACvB,OAAO,CAAC,YAAY,CA6GtB,CAAC"}