opencode-rules-md 0.7.0 → 0.8.0

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

@@ -1,42 +0,0 @@
-/**
- * Thin synchronous adapter over node:fs that implements the CliFs interface.
- * All production CLI disk I/O flows through this module — no direct node:fs
- * calls outside this file.
- */
-import * as fs from 'node:fs';
-import * as nodePath from 'node:path';
-/**
- * Production CliFs implementation backed by node:fs (synchronous).
- */
-export const realFs = {
-    readFileSync(filePath) {
-        return fs.readFileSync(filePath, 'utf-8');
-    },
-    writeFileSync(filePath, content, _encoding) {
-        // Ensure parent directory exists before writing
-        const dir = nodePath.dirname(filePath);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-        }
-        fs.writeFileSync(filePath, content, 'utf-8');
-    },
-    renameSync(from, to) {
-        fs.renameSync(from, to);
-    },
-    copyFileSync(from, to) {
-        fs.copyFileSync(from, to);
-    },
-    unlinkSync(filePath) {
-        fs.unlinkSync(filePath);
-    },
-    mkdirSync(filePath, opts) {
-        fs.mkdirSync(filePath, opts);
-    },
-    readdirSync(filePath) {
-        return fs.readdirSync(filePath);
-    },
-    existsSync(filePath) {
-        return fs.existsSync(filePath);
-    },
-};
-//# sourceMappingURL=real-fs.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"real-fs.js","sourceRoot":"","sources":["../../../src/cli/real-fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAiBtC;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAU;IAC3B,YAAY,CAAC,QAAgB;QAC3B,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,SAAkB;QACjE,gDAAgD;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,EAAU;QACjC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,EAAU;QACnC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,IAA8B;QACxD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,OAAO,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;CACF,CAAC"}

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

@@ -1,34 +0,0 @@
-/**
- * status command: read-only probe that reports install state.
- *
- * Reports install state across BOTH the server and TUI configs:
- *   - installed: yes/no (true only when present in both configs)
- *   - serverSpecifier: the registered entry in opencode.json (or undefined)
- *   - tuiSpecifier:    the registered entry in tui.json (or undefined)
- *   - serverPath:      path to the server config
- *   - tuiPath:         path to the TUI config
- *   - version:         bundled CLI version from package.json
- */
-import type { CliFs } from './real-fs.js';
-export interface StatusResult {
-    /** True only when the plugin is registered in both server and TUI configs. */
-    installed: boolean;
-    /** Server config path. */
-    serverPath: string;
-    /** TUI config path. */
-    tuiPath: string;
-    /** Registered specifier in the server config, if any. */
-    serverSpecifier?: string;
-    /** Registered specifier in the TUI config, if any. */
-    tuiSpecifier?: string;
-    /** Whether the server config existed on disk before the probe. */
-    serverExisted: boolean;
-    /** Whether the TUI config existed on disk before the probe. */
-    tuiExisted: boolean;
-    /** Bundled CLI version from package.json. */
-    version: string;
-    /** First parse error encountered, if any (server takes priority). */
-    parseError?: Error;
-}
-export declare function runStatus(cliFs?: CliFs): StatusResult;
-//# sourceMappingURL=status.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAS1C,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,aAAa,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAMD,wBAAgB,SAAS,CAAC,KAAK,GAAE,KAAc,GAAG,YAAY,CA0B7D"}

package/dist/src/cli/status.js

@@ -1,67 +0,0 @@
-/**
- * status command: read-only probe that reports install state.
- *
- * Reports install state across BOTH the server and TUI configs:
- *   - installed: yes/no (true only when present in both configs)
- *   - serverSpecifier: the registered entry in opencode.json (or undefined)
- *   - tuiSpecifier:    the registered entry in tui.json (or undefined)
- *   - serverPath:      path to the server config
- *   - tuiPath:         path to the TUI config
- *   - version:         bundled CLI version from package.json
- */
-import { loadGlobalConfig, TUI_CONFIG_FILENAME } from './config.js';
-import { realFs } from './real-fs.js';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-// ---------------------------------------------------------------------------
-// Run status
-// ---------------------------------------------------------------------------
-export function runStatus(cliFs = realFs) {
-    const serverLoad = loadGlobalConfig(cliFs);
-    const tuiLoad = loadGlobalConfig(cliFs, { filename: TUI_CONFIG_FILENAME });
-    const serverSpecifier = findSpecifier(serverLoad);
-    const tuiSpecifier = findSpecifier(tuiLoad);
-    const installed = serverSpecifier !== undefined && tuiSpecifier !== undefined;
-    const result = {
-        installed,
-        serverPath: serverLoad.path,
-        tuiPath: tuiLoad.path,
-        serverExisted: serverLoad.existed,
-        tuiExisted: tuiLoad.existed,
-        version: getVersion(),
-    };
-    if (serverSpecifier)
-        result.serverSpecifier = serverSpecifier;
-    if (tuiSpecifier)
-        result.tuiSpecifier = tuiSpecifier;
-    // Surface the first parse error so callers can warn the user
-    const parseError = serverLoad.parseError ?? tuiLoad.parseError;
-    if (parseError)
-        result.parseError = parseError;
-    return result;
-}
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-function findSpecifier(load) {
-    if (load.parseError)
-        return undefined;
-    const config = load.config;
-    const pluginList = Array.isArray(config['plugin'])
-        ? config['plugin']
-        : [];
-    return pluginList.find(p => p.startsWith('opencode-rules-md'));
-}
-function getVersion() {
-    try {
-        // Read package.json relative to the project root
-        const pkgPath = path.resolve(process.cwd(), 'package.json');
-        const content = fs.readFileSync(pkgPath, 'utf-8');
-        const pkg = JSON.parse(content);
-        return pkg.version ?? 'unknown';
-    }
-    catch {
-        return 'unknown';
-    }
-}
-//# sourceMappingURL=status.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA2BlC,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,UAAU,SAAS,CAAC,QAAe,MAAM;IAC7C,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAE3E,MAAM,eAAe,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,eAAe,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,CAAC;IAE9E,MAAM,MAAM,GAAiB;QAC3B,SAAS;QACT,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,aAAa,EAAE,UAAU,CAAC,OAAO;QACjC,UAAU,EAAE,OAAO,CAAC,OAAO;QAC3B,OAAO,EAAE,UAAU,EAAE;KACtB,CAAC;IAEF,IAAI,eAAe;QAAE,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC;IAC9D,IAAI,YAAY;QAAE,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;IAErD,6DAA6D;IAC7D,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAC/D,IAAI,UAAU;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAE/C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,aAAa,CAAC,IAAyC;IAC9D,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,UAAU,GAAa,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,CAAE,MAAM,CAAC,QAAQ,CAAc;QAChC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,iDAAiD;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;QACxD,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/src/cli/config.ts

@@ -1,364 +0,0 @@
-/**
- * CLI config helpers: discovery, JSONC-safe parsing, plugin normalization,
- * backup rotation, and atomic write.
- *
- * All filesystem access goes through the CliFs interface so tests can inject
- * an in-memory implementation without touching real disk.
- */
-
-import * as os from 'node:os';
-import * as path from 'node:path';
-import type { CliFs } from './real-fs.js';
-
-// ---------------------------------------------------------------------------
-// Public constants
-// ---------------------------------------------------------------------------
-
-/** npm package name for this plugin. */
-export const PLUGIN_NAME = 'opencode-rules-md';
-
-/** Filename for the OpenCode server config. */
-export const SERVER_CONFIG_FILENAME = 'opencode.json';
-
-/** Filename for the OpenCode TUI config. */
-export const TUI_CONFIG_FILENAME = 'tui.json';
-
-// ---------------------------------------------------------------------------
-// Public types
-// ---------------------------------------------------------------------------
-
-export interface LoadResult {
-  path: string;
-  existed: boolean;
-  config: Record<string, unknown>;
-  parseError?: Error;
-}
-
-// ---------------------------------------------------------------------------
-// JSONC comment stripper — two-pass
-// ---------------------------------------------------------------------------
-
-/**
- * Strip JSONC comments and trailing commas while preserving
- * comment-like sequences inside string literals.
- *
- * Pass 1: strip `//` and `/* * /` comments (string-aware).
- * Pass 2: strip trailing commas before `}` or `]`, skipping whitespace.
- */
-export function stripJsoncComments(content: string): string {
-  // Pass 1 — strip comments while preserving string contents
-  let result = '';
-  let i = 0;
-  let inString = false;
-  let escaped = false;
-  const len = content.length;
-
-  while (i < len) {
-    const char = content[i]!;
-
-    if (inString) {
-      result += char;
-      if (escaped) {
-        escaped = false;
-      } else if (char === '\\') {
-        escaped = true;
-      } else if (char === '"') {
-        inString = false;
-      }
-      i++;
-      continue;
-    }
-
-    if (char === '"') {
-      inString = true;
-      result += char;
-      i++;
-      continue;
-    }
-
-    // Line comment: // until newline
-    if (char === '/' && content[i + 1] === '/') {
-      i += 2;
-      while (i < len && content[i] !== '\n') i++;
-      continue;
-    }
-
-    // Block comment: /* until */
-    if (char === '/' && content[i + 1] === '*') {
-      i += 2;
-      while (i < len && !(content[i] === '*' && content[i + 1] === '/')) i++;
-      if (i < len) i += 2; // skip past */
-      continue;
-    }
-
-    result += char;
-    i++;
-  }
-
-  // Pass 2 — strip trailing commas (with whitespace skip) before } or ]
-  let out = '';
-  let inStr = false;
-  let esc = false;
-  let j = 0;
-  const outLen = result.length;
-
-  while (j < outLen) {
-    const ch = result[j]!;
-
-    if (inStr) {
-      out += ch;
-      if (esc) {
-        esc = false;
-      } else if (ch === '\\') {
-        esc = true;
-      } else if (ch === '"') {
-        inStr = false;
-      }
-      j++;
-      continue;
-    }
-
-    if (ch === '"') {
-      inStr = true;
-      out += ch;
-      j++;
-      continue;
-    }
-
-    if (ch === ',') {
-      // Skip whitespace before checking for } or ]
-      let k = j + 1;
-      while (k < outLen && /\s/.test(result[k]!)) k++;
-      if (k < outLen && /[}\]]/.test(result[k]!)) {
-        // Drop the comma; jump to the bracket
-        j = k;
-        continue;
-      }
-    }
-
-    out += ch;
-    j++;
-  }
-
-  return out;
-}
-
-// ---------------------------------------------------------------------------
-// Config path resolution
-// ---------------------------------------------------------------------------
-
-/**
- * Resolve the global opencode config path using the same precedence as
- * opencode itself: OPENCODE_CONFIG_DIR → XDG_CONFIG_HOME → HOME fallback.
- *
- * On Windows, APPDATA is tried as a last resort when XDG_CONFIG_HOME and
- * HOME are both absent.
- */
-export function resolveGlobalConfigPath(
-  fs: CliFs,
-  opts: { ensureDir?: boolean; filename?: string } = {}
-): string {
-  const dir = resolveConfigDir();
-  if (opts.ensureDir && !fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  const filename = opts.filename ?? SERVER_CONFIG_FILENAME;
-  return path.join(dir, filename);
-}
-
-function resolveConfigDir(): string {
-  if (process.env.OPENCODE_CONFIG_DIR) {
-    return process.env.OPENCODE_CONFIG_DIR;
-  }
-
-  if (process.env.XDG_CONFIG_HOME) {
-    return path.join(process.env.XDG_CONFIG_HOME, 'opencode');
-  }
-
-  const home = process.env.HOME || os.homedir();
-  if (home) {
-    return path.join(home, '.config', 'opencode');
-  }
-
-  // Windows fallback
-  const appdata = process.env.APPDATA;
-  if (appdata) {
-    return path.join(appdata, 'opencode');
-  }
-
-  throw new Error(
-    'Cannot resolve config dir: none of OPENCODE_CONFIG_DIR, XDG_CONFIG_HOME, HOME, or APPDATA is set'
-  );
-}
-
-// ---------------------------------------------------------------------------
-// JSONC-safe config load
-// ---------------------------------------------------------------------------
-
-/**
- * Load and parse a global OpenCode config file.
- * Treats a missing file as an empty config object (not an error).
- * Surfaces parse errors so callers can exit non-zero without corrupting data.
- */
-export function loadGlobalConfig(fs: CliFs, opts: { filename?: string } = {}): LoadResult {
-  const configPath = resolveGlobalConfigPath(
-    fs,
-    opts.filename ? { filename: opts.filename } : {}
-  );
-
-  if (!fs.existsSync(configPath)) {
-    return { path: configPath, existed: false, config: {} };
-  }
-
-  try {
-    const raw = fs.readFileSync(configPath);
-    const stripped = stripJsoncComments(raw);
-    // Empty after stripping means comment-only file — treat as {}
-    if (stripped.trim() === '') {
-      return { path: configPath, existed: true, config: {} };
-    }
-    const parsed = JSON.parse(stripped) as Record<string, unknown>;
-    return { path: configPath, existed: true, config: parsed };
-  } catch (err) {
-    const error = err instanceof Error ? err : new Error(String(err));
-    return { path: configPath, existed: true, config: {}, parseError: error };
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Plugin normalization helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Return the plugin array with opencode-rules-md* entries deduplicated by
- * name prefix, keeping the last occurrence of each unique prefix.
- */
-export function normalizePlugin(
-  config: Record<string, unknown>
-): string[] {
-  const raw: unknown[] = Array.isArray(config['plugin']) ? config['plugin'] : [];
-  const seen = new Map<string, number>(); // prefix → last index
-  const result: string[] = [];
-
-  for (const item of raw) {
-    if (typeof item !== 'string') continue;
-    const prefix = getPluginPrefix(item);
-    seen.set(prefix, result.length);
-    result.push(item);
-  }
-
-  // Collapse entries sharing a prefix to only the last one
-  return collapseByPrefix(result, seen);
-}
-
-/**
- * Remove all plugins matching the given prefix (used to dedupe before append).
- */
-export function removePlugin(
-  config: Record<string, unknown>,
-  prefix: string
-): void {
-  if (!Array.isArray(config['plugin'])) return;
-  const raw = config['plugin'] as string[];
-  config['plugin'] = raw.filter(
-    item => typeof item === 'string' && !item.startsWith(prefix)
-  );
-}
-
-/**
- * Add a plugin specifier, removing any existing entry with the same prefix first
- * so it ends up at the specified position (default: end). This makes the operation
- * idempotent — re-adding the same specifier just moves it to the end.
- */
-export function addPlugin(
-  config: Record<string, unknown>,
-  specifier: string
-): void {
-  if (!Array.isArray(config['plugin'])) {
-    config['plugin'] = [];
-  }
-  const plugin = config['plugin'] as string[];
-  const prefix = getPluginPrefix(specifier);
-  // Remove any existing entry with the same prefix
-  const removed = plugin.filter(p => getPluginPrefix(p) !== prefix);
-  removed.push(specifier);
-  config['plugin'] = removed;
-}
-
-// ---------------------------------------------------------------------------
-// Backup rotation
-// ---------------------------------------------------------------------------
-
-/**
- * Write a timestamped backup of the given config path and rotate so at most
- * 3 backups are retained (oldest deleted first).
- * Returns the path of the newly created backup, or null if no backup was created.
- */
-export function rotateBackups(fs: CliFs, configPath: string, _pluginName: string): string | null {
-  if (!fs.existsSync(configPath)) {
-    return null;
-  }
-
-  const dir = path.dirname(configPath);
-  const base = path.basename(configPath);
-  const timestamp = Date.now();
-  const newBak = path.join(dir, `${base}.bak.${timestamp}`);
-
-  fs.copyFileSync(configPath, newBak);
-
-  // Collect existing backups sorted by timestamp (lexical sort on numeric suffix)
-  const entries = fs.readdirSync(dir);
-  const bakFiles = entries
-    .filter(e => e.startsWith(base + '.bak.'))
-    .sort();
-
-  // Remove oldest until only 3 remain
-  while (bakFiles.length > 3) {
-    const oldest = bakFiles.shift()!;
-    fs.unlinkSync(path.join(dir, oldest));
-  }
-
-  return newBak;
-}
-
-// ---------------------------------------------------------------------------
-// Atomic write
-// ---------------------------------------------------------------------------
-
-/**
- * Write content to a temporary sibling file then rename it into place.
- * The final path is never in a partially-written state.
- */
-export function writeAtomically(fs: CliFs, configPath: string, content: string): void {
-  const dir = path.dirname(configPath);
-  const base = path.basename(configPath);
-  const tmpPath = path.join(dir, `.${base}.tmp.${Date.now()}-${process.pid}`);
-
-  fs.writeFileSync(tmpPath, content, 'utf-8');
-  fs.renameSync(tmpPath, configPath);
-}
-
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Extract the name part of a plugin specifier, stripping any version suffix.
- * e.g. "opencode-rules-md@0.1.0" → "opencode-rules-md"
- */
-function getPluginPrefix(specifier: string): string {
-  const atIdx = specifier.indexOf('@');
-  return atIdx === -1 ? specifier : specifier.substring(0, atIdx);
-}
-
-/**
- * Collapse plugins by prefix, keeping only the last occurrence of each.
- */
-function collapseByPrefix(
-  plugins: string[],
-  lastSeen: Map<string, number>
-): string[] {
-  const keptIndices = new Set([...lastSeen.values()]);
-
-  return plugins.filter((_, idx) => keptIndices.has(idx));
-}

package/src/cli/install.ts

@@ -1,171 +0,0 @@
-/**
- * install command: idempotently append opencode-rules-md to the global configs.
- *
- * Registers the plugin in BOTH:
- *   - Server config:  ~/.config/opencode/opencode.json
- *   - TUI config:     ~/.config/opencode/tui.json
- *
- * Pipeline (per config):
- *   loadGlobalConfig → abort if parseError (throw) → normalizePlugin
- *   → check no-op → (dry-run? print & return "planned")
- *   → rotateBackups → writeAtomically → print & return "wrote"
- *
- * Errors are surfaced as exceptions instead of silent status returns so
- * the CLI dispatcher can print them.
- */
-
-import {
-  loadGlobalConfig,
-  normalizePlugin,
-  removePlugin,
-  addPlugin,
-  rotateBackups,
-  writeAtomically,
-  TUI_CONFIG_FILENAME,
-} from './config.js';
-import type { CliFs } from './real-fs.js';
-import { realFs } from './real-fs.js';
-
-// ---------------------------------------------------------------------------
-// Result types
-// ---------------------------------------------------------------------------
-
-export interface ConfigUpdateResult {
-  status: 'wrote' | 'planned' | 'noop';
-  path: string;
-  specifier: string;
-  backup?: string;
-}
-
-export interface InstallResult {
-  status: 'wrote' | 'planned' | 'noop';
-  specifier: string;
-  server: ConfigUpdateResult;
-  tui: ConfigUpdateResult;
-}
-
-// ---------------------------------------------------------------------------
-// Run install
-// ---------------------------------------------------------------------------
-
-export function runInstall(
-  opts: { version?: string; dryRun?: boolean },
-  fs: CliFs = realFs
-): InstallResult {
-  const specifier = buildSpecifier(opts.version);
-
-  const server = updateConfig(specifier, opts.dryRun ?? false, fs);
-  const tui = updateConfig(specifier, opts.dryRun ?? false, fs, {
-    filename: TUI_CONFIG_FILENAME,
-  });
-
-  const aggregate: InstallResult['status'] =
-    server.status === 'wrote' || tui.status === 'wrote'
-      ? 'wrote'
-      : server.status === 'planned' || tui.status === 'planned'
-        ? 'planned'
-        : 'noop';
-
-  printSummary(aggregate, specifier, server, tui);
-
-  return { status: aggregate, specifier, server, tui };
-}
-
-// ---------------------------------------------------------------------------
-// Internal: update a single config file
-// ---------------------------------------------------------------------------
-
-interface UpdateOpts {
-  filename?: string;
-}
-
-function updateConfig(
-  specifier: string,
-  dryRun: boolean,
-  fs: CliFs,
-  opts: UpdateOpts = {}
-): ConfigUpdateResult {
-  const loadResult = loadGlobalConfig(
-    fs,
-    opts.filename ? { filename: opts.filename } : {}
-  );
-
-  // Throw on parse error — better to fail fast than to silently corrupt config
-  if (loadResult.parseError) {
-    const filename = opts.filename ?? 'opencode.json';
-    const err: Error & { configPath?: string } = new Error(
-      `opencode-rules-md: ${filename} is malformed — aborting to avoid data loss.\n` +
-        `  path:  ${loadResult.path}\n` +
-        `  error: ${loadResult.parseError.message}`
-    );
-    err.configPath = loadResult.path;
-    throw err;
-  }
-
-  const configPath = loadResult.path;
-  const config = loadResult.config;
-
-  // Normalize plugin array (dedupe by prefix)
-  config['plugin'] = normalizePlugin(config);
-
-  // Check if already installed with the same specifier — no-op
-  const existing = (config['plugin'] as string[] | undefined) ?? [];
-  if (existing.includes(specifier)) {
-    return { status: 'noop', path: configPath, specifier };
-  }
-
-  // Remove any existing opencode-rules-md* entries so this specifier is deduplicated
-  removePlugin(config, 'opencode-rules-md');
-
-  // Add the new (or re-added) specifier at the end
-  addPlugin(config, specifier);
-
-  // Dry-run: serialize and print planned content, make no changes
-  if (dryRun) {
-    const planned = JSON.stringify(config, null, 2);
-    console.log(`Planned ${configPath}:\n${planned}`);
-    return { status: 'planned', path: configPath, specifier };
-  }
-
-  // Write: rotate backups first, then atomic write
-  const backup = rotateBackups(fs, configPath, 'opencode-rules-md');
-  const serialized = JSON.stringify(config, null, 2);
-  writeAtomically(fs, configPath, serialized);
-
-  const result: ConfigUpdateResult = { status: 'wrote', path: configPath, specifier };
-  if (backup) result.backup = backup;
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-
-function buildSpecifier(version?: string): string {
-  return version ? `opencode-rules-md@${version}` : 'opencode-rules-md';
-}
-
-function printSummary(
-  status: InstallResult['status'],
-  specifier: string,
-  server: ConfigUpdateResult,
-  tui: ConfigUpdateResult
-): void {
-  if (status === 'noop') {
-    console.log(`Already installed (${specifier})`);
-    console.log(`  server config: ${server.path}`);
-    console.log(`  tui config:    ${tui.path}`);
-    return;
-  }
-
-  if (status === 'planned') {
-    console.log('Dry run complete — no files written.');
-    return;
-  }
-
-  console.log(`Installed ${specifier}`);
-  console.log(`  server config: ${server.path}`);
-  if (server.backup) console.log(`    backup:      ${server.backup}`);
-  console.log(`  tui config:    ${tui.path}`);
-  if (tui.backup) console.log(`    backup:      ${tui.backup}`);
-}