opencode-rules-md 0.6.6 → 0.8.0

package/src/cli/main.ts

@@ -1,178 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI entrypoint for opencode-rules-md installer.
- *
- * Supports:
- *   install   — add opencode-rules-md to the global opencode + tui configs
- *   status    — report whether opencode-rules-md is installed
- *
- * Flags:
- *   --version <v>  — specify a plugin version to install
- *   --latest       — install the latest version (default)
- *   --dry-run      — show what would be written, without changing files
- *   --yes          — skip confirmation prompts (future use)
- *   -h, --help     — show this help text
- */
-
-import { parseArgs } from 'node:util';
-import { pathToFileURL } from 'node:url';
-import { realpathSync } from 'node:fs';
-import { runInstall } from './install.js';
-import { runStatus } from './status.js';
-import type { CliFs } from './real-fs.js';
-import { realFs } from './real-fs.js';
-
-// ---------------------------------------------------------------------------
-// Help text
-// ---------------------------------------------------------------------------
-
-const HELP_TEXT = `opencode-rules-md CLI
-
-Usage: opencode-rules-md <command> [options]
-
-Commands:
-  install   Add opencode-rules-md to the global opencode + tui configs
-  status    Report whether opencode-rules-md is installed
-
-Options:
-  --version <v>  Specify a plugin version to install
-  --latest       Install the latest version (default)
-  --dry-run      Show what would be written, without changing files
-  --yes          Skip confirmation prompts (future use)
-  -h, --help     Show this help text
-`.trim();
-
-const USAGE_ERROR_TEXT = `Error: unknown command. Run 'opencode-rules-md --help' for usage.`.trim();
-
-// ---------------------------------------------------------------------------
-// Argument parsing
-// ---------------------------------------------------------------------------
-
-interface CliOptions {
-  version?: string;
-  latest?: boolean;
-  dryRun?: boolean;
-  yes?: boolean;
-  help?: boolean;
-}
-
-function parseCliArgs(argv: string[]): { command: string | null; options: CliOptions; unknownFlags: string[] } {
-  const { positionals, values } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-      version: { type: 'string' },
-      latest: { type: 'boolean' },
-      'dry-run': { type: 'boolean' },
-      yes: { type: 'boolean' },
-      h: { type: 'boolean' },
-      help: { type: 'boolean' },
-    },
-  });
-
-  // Extract command (first positional)
-  const command = positionals[0] ?? null;
-
-  // Extract options from parsed values
-  // Note: -h sets key 'h', --help sets key 'help'
-  const options: CliOptions = {
-    ...(values.version !== undefined && { version: values.version as string }),
-    ...(values.latest && { latest: true }),
-    ...(values['dry-run'] && { dryRun: true }),
-    ...(values.yes && { yes: true }),
-    ...((values.help || values.h) && { help: true }),
-  };
-
-  const unknownFlags: string[] = [];
-
-  return { command, options, unknownFlags };
-}
-
-// ---------------------------------------------------------------------------
-// Dispatcher
-// ---------------------------------------------------------------------------
-
-export type ExitCode = 0 | 1 | 2;
-
-export async function runMain(argv: string[], fs: CliFs = realFs): Promise<ExitCode> {
-  try {
-    const { command, options, unknownFlags } = parseCliArgs(argv);
-
-    // Handle help flag at top level (before command dispatch)
-    if (options.help) {
-      console.log(HELP_TEXT);
-      return 0;
-    }
-
-    // Handle unknown flags
-    if (unknownFlags.length > 0) {
-      console.error(`Error: unknown option(s): ${unknownFlags.join(', ')}`);
-      console.error(USAGE_ERROR_TEXT);
-      return 2;
-    }
-
-    // No command given
-    if (!command) {
-      console.error(USAGE_ERROR_TEXT);
-      return 2;
-    }
-
-    switch (command) {
-      case 'install': {
-        const installOpts: { version?: string; dryRun?: boolean } = {};
-        if (options.version !== undefined) installOpts.version = options.version;
-        if (options.dryRun) installOpts.dryRun = true;
-        runInstall(installOpts, fs);
-        return 0;
-      }
-      case 'status': {
-        const statusResult = runStatus(fs);
-        if (statusResult.installed) {
-          const spec = statusResult.serverSpecifier ?? statusResult.tuiSpecifier;
-          console.log(`opencode-rules-md is installed (${spec})`);
-        } else {
-          console.log('opencode-rules-md is not installed');
-        }
-        return 0;
-      }
-      default: {
-        console.error(`Error: unknown command '${command}'`);
-        console.error(USAGE_ERROR_TEXT);
-        return 2;
-      }
-    }
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`Error: ${message}`);
-    return 1;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Entry point
-// ---------------------------------------------------------------------------
-
-/**
- * Determine whether the current module is being executed as the main entry.
- * Uses realpathSync + pathToFileURL so symlinked invocations (e.g. npx)
- * are matched correctly.
- */
-function isInvokedAsMain(): boolean {
-  if (!process.argv[1]) return false;
-
-  try {
-    const realArgv = pathToFileURL(realpathSync(process.argv[1])).href;
-    return import.meta.url === realArgv;
-  } catch {
-    try {
-      return import.meta.url === pathToFileURL(process.argv[1]).href;
-    } catch {
-      return false;
-    }
-  }
-}
-
-// Only run if executed directly (not imported as a module)
-if (isInvokedAsMain()) {
-  void runMain(process.argv.slice(2)).then(code => process.exit(code));
-}

package/src/cli/real-fs.ts

@@ -1,65 +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';
-
-/**
- * Synchronous filesystem interface used by the CLI.
- * Tests supply an in-memory implementation; production uses this adapter.
- */
-export interface CliFs {
-  readFileSync(path: string): string;
-  writeFileSync(path: string, content: string, encoding?: string): void;
-  renameSync(from: string, to: string): void;
-  copyFileSync(from: string, to: string): void;
-  unlinkSync(path: string): void;
-  mkdirSync(path: string, opts?: { recursive?: boolean }): void;
-  readdirSync(path: string): string[];
-  existsSync(path: string): boolean;
-}
-
-/**
- * Production CliFs implementation backed by node:fs (synchronous).
- */
-export const realFs: CliFs = {
-  readFileSync(filePath: string): string {
-    return fs.readFileSync(filePath, 'utf-8');
-  },
-
-  writeFileSync(filePath: string, content: string, _encoding?: string): void {
-    // 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: string, to: string): void {
-    fs.renameSync(from, to);
-  },
-
-  copyFileSync(from: string, to: string): void {
-    fs.copyFileSync(from, to);
-  },
-
-  unlinkSync(filePath: string): void {
-    fs.unlinkSync(filePath);
-  },
-
-  mkdirSync(filePath: string, opts?: { recursive?: boolean }): void {
-    fs.mkdirSync(filePath, opts);
-  },
-
-  readdirSync(filePath: string): string[] {
-    return fs.readdirSync(filePath);
-  },
-
-  existsSync(filePath: string): boolean {
-    return fs.existsSync(filePath);
-  },
-};

package/src/cli/status.ts

@@ -1,99 +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 type { CliFs } from './real-fs.js';
-import { realFs } from './real-fs.js';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-
-// ---------------------------------------------------------------------------
-// Result types
-// ---------------------------------------------------------------------------
-
-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;
-}
-
-// ---------------------------------------------------------------------------
-// Run status
-// ---------------------------------------------------------------------------
-
-export function runStatus(cliFs: CliFs = realFs): StatusResult {
-  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: StatusResult = {
-    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: ReturnType<typeof loadGlobalConfig>): string | undefined {
-  if (load.parseError) return undefined;
-  const config = load.config;
-  const pluginList: string[] = Array.isArray(config['plugin'])
-    ? (config['plugin'] as string[])
-    : [];
-  return pluginList.find(p => p.startsWith('opencode-rules-md'));
-}
-
-function getVersion(): string {
-  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) as { version?: string };
-    return pkg.version ?? 'unknown';
-  } catch {
-    return 'unknown';
-  }
-}