opencode-rules-md 0.8.4 → 0.8.6

package/dist/src/cli/status.js

@@ -0,0 +1,214 @@
+// ---------------------------------------------------------------------------
+// src/cli/status.ts — `omd status` and `omd doctor` command implementations.
+//
+// Three correctness fixes vs. the previous implementation:
+//
+//   1. We read `data['plugin']` (singular) as the source of truth, with a
+//      backward-compat fallback to `data['plugins']`. The legacy plural
+//      field is no longer authoritative.
+//   2. `runDoctor` warns when a legacy `plugins` field is present, so users
+//      upgrading from the buggy version are nudged to clean up.
+//   3. The cache freshness check uses ~/.cache/opencode/packages/ (where
+//      OpenCode actually stores plugin installs) instead of the legacy
+//      ~/.cache/opencode/node_modules/ path.
+// ---------------------------------------------------------------------------
+import { join, dirname, extname } from 'path';
+import { homedir } from 'os';
+import { loadGlobalConfig, matchesPlugin, readInstalledPlugins, } from './config.js';
+import { fetchLatestVersion } from './registry.js';
+import { resolveCachePaths } from './update.js';
+// ─── Constants ───────────────────────────────────────────────────────────────
+const RULE_DIR_NAME = 'opencode-rules-md';
+const MIN_NODE_VERSION = 20;
+const CONFIG_BASENAMES = ['opencode', 'tui'];
+// ─── runStatus ────────────────────────────────────────────────────────────────
+/**
+ * Run the status command: read-only probe for both opencode.json and tui.json.
+ * Reports path, format, installed specifier, other plugins, and freshness.
+ */
+export const runStatus = async (fs, env, log, opts = {}) => {
+    const configs = [];
+    const latest = opts.latestVersion !== undefined
+        ? opts.latestVersion
+        : await fetchLatestVersion();
+    for (const basename of CONFIG_BASENAMES) {
+        const loaded = loadGlobalConfig(fs, env, basename);
+        const format = extname(loaded.path); // '.json' or '.jsonc'
+        const plugins = readInstalledPlugins(loaded);
+        const match = plugins.find((p) => matchesPlugin(p)) ?? null;
+        const entry = {
+            basename,
+            path: loaded.path,
+            format,
+            installed: match,
+            notInstalled: !loaded.exists || match === null,
+            otherPlugins: plugins.filter((p) => !matchesPlugin(p)),
+            latest,
+            isLatest: match !== null && latest !== null
+                ? match === `opencode-rules-md@${latest}`
+                : null,
+        };
+        configs.push(entry);
+        if (!loaded.exists) {
+            log(`omd: ${basename}.json — config not found at ${loaded.path}`);
+            continue;
+        }
+        log(`omd: ${basename}${format} — ${loaded.path}`);
+        if (match) {
+            const isLatestLabel = entry.isLatest === true
+                ? ' (latest)'
+                : entry.isLatest === false
+                    ? ` (behind: latest is ${latest ?? 'unknown'})`
+                    : '';
+            log(`  opencode-rules-md: ${match}${isLatestLabel}`);
+        }
+        else {
+            log('  opencode-rules-md: not installed');
+        }
+        if (entry.otherPlugins.length > 0) {
+            log(`  other plugins: ${entry.otherPlugins.join(', ')}`);
+        }
+    }
+    return { configs };
+};
+// ─── runDoctor ────────────────────────────────────────────────────────────────
+/**
+ * Run the doctor command: health checks for the plugin environment.
+ *
+ * Checks:
+ *   - Node >= 20: issue if below
+ *   - Bun on PATH: issue if absent
+ *   - Both configs readable and valid: issue if absent or malformed
+ *   - Legacy `plugins` field present: warning (no-op for the runtime, but
+ *     indicates a previous buggy install)
+ *   - 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 const runDoctor = async (fs, env, log, error, opts = {}) => {
+    const issues = [];
+    const warnings = [];
+    const info = [];
+    const nodeVersion = opts.nodeVersion ?? process.version.slice(1); // strip 'v'
+    const ruleDirExists = opts.ruleDirExists ?? true;
+    // Check if Bun is available: use override if provided, otherwise scan PATH
+    let hasBun = opts.hasBun;
+    if (hasBun === undefined) {
+        const pathEnv = (env.PATH ?? '').split(':');
+        hasBun = pathEnv.some((p) => {
+            try {
+                const { existsSync } = require('node:fs');
+                return existsSync(p + '/bun');
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    // ── Check: Node version ───────────────────────────────────────────────────
+    log('Checking Node version...');
+    const nodeMajor = parseInt(nodeVersion.split('.')[0] ?? '0', 10);
+    if (nodeMajor < MIN_NODE_VERSION) {
+        issues.push(`Node.js ${nodeVersion} is too old; requires Node >= ${MIN_NODE_VERSION}`);
+        error(`[ISSUE] Node.js ${nodeVersion} — requires >= ${MIN_NODE_VERSION}. Download latest from https://nodejs.org`);
+    }
+    else {
+        log(`  Node.js ${nodeVersion} — OK`);
+    }
+    // ── Check: Bun on PATH ─────────────────────────────────────────────────────
+    log('Checking for Bun...');
+    if (!hasBun) {
+        issues.push('Bun is not on PATH — install from https://bun.sh');
+        error('[ISSUE] Bun not found on PATH — install Bun for best performance');
+    }
+    else {
+        log('  Bun — found on PATH');
+    }
+    // ── Check: both configs readable and valid ─────────────────────────────────
+    for (const basename of CONFIG_BASENAMES) {
+        log(`Checking ${basename} config...`);
+        const loaded = loadGlobalConfig(fs, env, basename);
+        if (!loaded.exists) {
+            warnings.push(`${basename} config not found at ${loaded.path}`);
+            log(`  ${basename}: not found (will be created on first install)`);
+            continue;
+        }
+        log(`  ${basename}${extname(loaded.path)}: ${loaded.path}`);
+        const plugins = readInstalledPlugins(loaded);
+        const match = plugins.find((p) => matchesPlugin(p)) ?? null;
+        if (match) {
+            info.push(`${basename}: opencode-rules-md installed (${match})`);
+            log(`  opencode-rules-md: ${match}`);
+        }
+        else {
+            warnings.push(`${basename}: plugin not installed`);
+            log('  opencode-rules-md: not installed');
+        }
+        // ── Check legacy `plugins` field (backward-compat warning) ──────────────
+        if (loaded.data['plugins'] !== undefined && loaded.data['plugin'] === undefined) {
+            warnings.push(`${basename}: legacy "plugins" field present (should be "plugin") — run "omd uninstall && omd install" to migrate`);
+            log(`  [WARN] ${basename}: legacy "plugins" field present (should be "plugin")`);
+        }
+        // ── Check plugin shape ────────────────────────────────────────────────────
+        const pluginField = loaded.data['plugin'] ?? loaded.data['plugins'];
+        if (pluginField !== undefined &&
+            !Array.isArray(pluginField) &&
+            typeof pluginField !== 'object' &&
+            typeof pluginField !== 'string') {
+            issues.push(`${basename}: plugin field has invalid type — expected array, object, or string`);
+            error(`[ISSUE] ${basename}: invalid plugin shape`);
+        }
+        else {
+            log('  plugin field: valid');
+        }
+    }
+    // ── Check: rule dir existence (warning, not issue) ─────────────────────────
+    log('Checking rule directory...');
+    const ruleBase = join(homedir(), '.local', 'share', RULE_DIR_NAME);
+    if (!ruleDirExists) {
+        warnings.push(`Rule directory not found at ${ruleBase}`);
+        log(`  ${ruleBase}: not found (plugin rules not installed — this is optional)`);
+    }
+    else {
+        log(`  ${ruleBase}: exists`);
+    }
+    // ── Check: package cache directory ────────────────────────────────────────
+    log('Checking OpenCode package cache...');
+    const cachePaths = resolveCachePaths(env, fs);
+    if (cachePaths.length === 0) {
+        info.push('No opencode-rules-md cache found under ~/.cache/opencode/packages/');
+        log('  no cache entries match opencode-rules-md*');
+    }
+    else {
+        log(`  cache entries: ${cachePaths.join(', ')}`);
+    }
+    // ── Check: config dir writable ─────────────────────────────────────────────
+    const configDir = env.OPENCODE_CONFIG_DIR ?? join(homedir(), '.config', 'opencode');
+    log('Checking config directory write access...');
+    const parentDir = dirname(configDir);
+    if (!fs.existsSync(parentDir)) {
+        issues.push(`Config parent directory does not exist: ${parentDir}`);
+        error(`[ISSUE] Config dir parent missing: ${parentDir}`);
+    }
+    else {
+        log(`  ${parentDir}: writable`);
+    }
+    // ── Summary ────────────────────────────────────────────────────────────────
+    log('');
+    if (issues.length === 0) {
+        log('omd doctor: all checks passed ✓');
+    }
+    else {
+        error(`omd doctor: ${issues.length} issue(s) found — fix before using the plugin`);
+        error(`Run 'omd --help' for usage information`);
+    }
+    return {
+        ok: issues.length === 0,
+        issues,
+        warnings,
+        info,
+    };
+};
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,30 @@
+import { type CliFs } from './config.js';
+export declare const CONFIG_BASENAMES: readonly ["opencode", "tui"];
+export interface UninstallOptions {
+    /** Also remove ~/.cache/opencode/packages/opencode-rules-md*. */
+    purge?: boolean;
+    /** Run the full pipeline without writing to disk. */
+    dryRun?: boolean;
+    /** Reserved for future prompts — no-op today. */
+    yes?: boolean;
+}
+export interface UninstallResultPerFile {
+    path: string;
+    status: 'wrote' | 'skipped' | 'error';
+    backup: string | null;
+}
+export interface UninstallResult {
+    status: 'wrote' | 'skipped';
+    results: UninstallResultPerFile[];
+    purged: boolean;
+}
+/**
+ * Uninstall opencode-rules-md from both opencode.json and tui.json configs.
+ *
+ * Options:
+ *   purge     — also remove ~/.cache/opencode/packages/opencode-rules-md*
+ *   dryRun    — run full pipeline without writing to disk
+ *   yes       — reserved
+ */
+export declare const runUninstall: (opts: UninstallOptions | undefined, fs: CliFs, env: NodeJS.ProcessEnv) => UninstallResult;
+//# sourceMappingURL=uninstall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/uninstall.ts"],"names":[],"mappings":"AAoBA,OAAO,EAKL,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,gBAAgB,8BAA+B,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;CACjB;AA6CD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,gBAAgB,YAAK,EAC3B,IAAI,KAAK,EACT,KAAK,MAAM,CAAC,UAAU,KACrB,eAqEF,CAAC"}

package/dist/src/cli/uninstall.js

@@ -0,0 +1,128 @@
+// ---------------------------------------------------------------------------
+// src/cli/uninstall.ts — `omd uninstall` command implementation.
+//
+// Removes opencode-rules-md from opencode.json and tui.json, and (with
+// `--purge`) wipes the OpenCode package cache. Two important fixes vs.
+// the previous implementation:
+//
+//   1. We read & write `data['plugin']` (singular), the field OpenCode
+//      actually honors. The previous code wrote `data['plugins']` (plural),
+//      which OpenCode silently ignored — so "uninstall" used to leave
+//      the plugin effectively installed.
+//   2. We also strip a stale `data['plugins']` entry if it exists, so
+//      users who upgraded from a buggy `omd install` get their legacy
+//      field cleaned up too.
+//   3. We purge ~/.cache/opencode/packages/opencode-rules-md* (the real
+//      cache OpenCode uses), not the old ~/.cache/opencode/node_modules
+//      path.
+// ---------------------------------------------------------------------------
+import { join } from 'path';
+import { loadGlobalConfig, backupIfWritable, rotateBackups, writeAtomically, } from './config.js';
+import { resolveCachePaths, purgeDirectory } from './update.js';
+export const CONFIG_BASENAMES = ['opencode', 'tui'];
+/**
+ * Strip `opencode-rules-md` entries from a config payload, cleaning both
+ * the modern `plugin` field (array or single string) and any legacy
+ * `plugins` field. Returns a tuple [newData, removedCount].
+ *
+ * `removedCount > 0` indicates the file actually needs to be rewritten.
+ */
+function stripFromData(data) {
+    let removed = 0;
+    const next = { ...data };
+    // Modern field: `plugin` (singular). Accept array or single string.
+    const currentRaw = next['plugin'] ?? next['plugins'];
+    if (currentRaw !== undefined) {
+        if (typeof currentRaw === 'string') {
+            if (currentRaw.startsWith('opencode-rules-md')) {
+                delete next['plugin'];
+                delete next['plugins'];
+                removed += 1;
+            }
+        }
+        else if (Array.isArray(currentRaw)) {
+            const filtered = currentRaw.filter((p) => !(typeof p === 'string' && p.startsWith('opencode-rules-md')));
+            if (filtered.length !== currentRaw.length) {
+                removed += currentRaw.length - filtered.length;
+                if (filtered.length === 0) {
+                    delete next['plugin'];
+                    delete next['plugins'];
+                }
+                else {
+                    next['plugin'] = filtered;
+                    delete next['plugins'];
+                }
+            }
+        }
+    }
+    return { next, removed };
+}
+/**
+ * Uninstall opencode-rules-md from both opencode.json and tui.json configs.
+ *
+ * Options:
+ *   purge     — also remove ~/.cache/opencode/packages/opencode-rules-md*
+ *   dryRun    — run full pipeline without writing to disk
+ *   yes       — reserved
+ */
+export const runUninstall = (opts = {}, fs, env) => {
+    const results = [];
+    let anyProcessed = false;
+    let purged = false;
+    // ── Purge cache if requested ────────────────────────────────────────────
+    if (opts.purge) {
+        const cachePaths = resolveCachePaths(env, fs);
+        for (const cachePath of cachePaths) {
+            try {
+                if (fs.existsSync(cachePath)) {
+                    purgeDirectory(fs, cachePath);
+                    purged = true;
+                }
+            }
+            catch {
+                // best-effort — purge failure is non-fatal
+            }
+        }
+    }
+    // ── Remove plugin from both configs ─────────────────────────────────────
+    for (const basename of CONFIG_BASENAMES) {
+        const loaded = loadGlobalConfig(fs, env, basename);
+        if (!loaded.exists) {
+            results.push({ path: loaded.path, status: 'skipped', backup: null });
+            continue;
+        }
+        const { next, removed } = stripFromData(loaded.data);
+        if (removed === 0) {
+            results.push({ path: loaded.path, status: 'skipped', backup: null });
+            continue;
+        }
+        anyProcessed = true;
+        const newContent = JSON.stringify(next, null, 2) + '\n';
+        if (opts.dryRun) {
+            results.push({ path: loaded.path, status: 'wrote', backup: null });
+            continue;
+        }
+        // Backup the existing file before rewriting.
+        const backup = backupIfWritable(fs, loaded.path);
+        if (backup !== undefined) {
+            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;
+            const dir = join(...segs.slice(0, -1));
+            rotateBackups(fs, dir, name, 3);
+        }
+        writeAtomically(fs, loaded.path, newContent);
+        results.push({
+            path: loaded.path,
+            status: 'wrote',
+            backup: backup ?? null,
+        });
+    }
+    return {
+        status: anyProcessed || purged ? 'wrote' : 'skipped',
+        results,
+        purged,
+    };
+};
+//# sourceMappingURL=uninstall.js.map

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

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

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

@@ -0,0 +1,65 @@
+import { type CliFs } from './config.js';
+import { spawnOpencodePlugin } from './spawn.js';
+/** Package directory used by OpenCode to cache plugin installs. */
+export declare const PACKAGES_DIR_BASENAME: readonly [".cache", "opencode", "packages"];
+/** Exact cache directory name we look for (bare specifier, no version suffix). */
+export declare const CACHE_DIR_BASENAME = "opencode-rules-md";
+/**
+ * Resolve the user's home directory, honoring a custom HOME env var.
+ * Used by both resolveCachePaths and the config loader.
+ */
+export declare function resolveHome(env?: NodeJS.ProcessEnv): string;
+/**
+ * Return the absolute path of the OpenCode packages cache directory.
+ */
+export declare function resolvePackagesDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * Return the cache directories that match the opencode-rules-md prefix.
+ *
+ * Real-world layout under ~/.cache/opencode/packages/ looks like:
+ *   opencode-rules-md/
+ *   opencode-rules-md@latest/
+ *   some-other-plugin/
+ *
+ * We glob-match anything starting with `opencode-rules-md` (exact or with
+ * an `@<version>` suffix). When an injected fs is provided we list the
+ * directory and filter; without one we return the two most common shapes
+ * so callers can pre-check existence cheaply.
+ */
+export declare function resolveCachePaths(env?: NodeJS.ProcessEnv, fs?: CliFs): string[];
+export interface UpdateOptions {
+    /** Injected latest version (test seam). Defaults to a real npm lookup. */
+    latestVersion?: string | null | undefined;
+    /** Print the plan without writing or spawning. */
+    dryRun?: boolean;
+    /** Injected spawn function (test seam). Defaults to spawnOpencodePlugin. */
+    spawn?: typeof spawnOpencodePlugin;
+}
+export interface UpdateResult {
+    status: 'stale' | 'current' | 'unreachable';
+    cachePaths: string[];
+    /** Re-install instruction; empty when status === 'current'. */
+    instruction: string;
+}
+/**
+ * Extract the version portion of an `opencode-rules-md@<version>` specifier.
+ * Returns null when the specifier has no `@version` segment.
+ */
+export declare function extractVersion(specifier: string): string | null;
+/**
+ * Recursively delete a directory and all its contents using the injected fs.
+ * Best-effort — a failed purge is not fatal; we want the update to keep going.
+ */
+export declare function purgeDirectory(fs: CliFs, dirPath: string): void;
+/**
+ * Run the update command.
+ *
+ * 1. Resolve the latest published version from npm (or use the injected mock).
+ * 2. Read the installed version from the user's opencode config.
+ * 3. If unreachable, log and return.
+ * 4. If current, log and return.
+ * 5. Otherwise: purge stale cache directories, then spawn
+ *    `opencode plugin opencode-rules-md --global --force`.
+ */
+export declare const runUpdate: (fs: CliFs, env: NodeJS.ProcessEnv, log: (s: string) => void, _error: (s: string) => void, opts?: UpdateOptions) => Promise<UpdateResult>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/update.ts"],"names":[],"mappings":"AAmBA,OAAO,EAIL,KAAK,KAAK,EAEX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,6CAA8C,CAAC;AAEjF,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,EAAE,CAAC,EAAE,KAAK,GACT,MAAM,EAAE,CAoBV;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;CACrB;AAeD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAqC/D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GACpB,IAAI,KAAK,EACT,KAAK,MAAM,CAAC,UAAU,EACtB,KAAK,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,OAAM,aAAkB,KACvB,OAAO,CAAC,YAAY,CAkEtB,CAAC"}