@fnclaude/cli 1.1.0 → 2.0.0

package/src/autoname.ts

@@ -1,273 +0,0 @@
-// Port of src/autoname.go from the Go reference implementation.
-//
-// shouldAutoName — predicate for automatic --name injection.
-// generateName  — Anthropic API call (or claude CLI fallback) to produce a
-//                 short kebab-case session label from the initial prompt.
-
-import Anthropic from '@anthropic-ai/sdk';
-import type { NameConfig } from './config.js';
-
-// ── predicates ──────────────────────────────────────────────────────────────
-
-/**
- * shouldAutoName returns true when the passthrough slice meets all conditions
- * for automatic --name injection:
- *
- *   - contains "--" followed by at least one non-empty token
- *   - does NOT already contain --name / -n / --name=* / -n=*
- *   - does NOT contain -p / --print
- *   - does NOT contain -r / --resume / -r=* / --resume=*
- *   - does NOT contain -c / --continue
- *   - does NOT contain --from-pr / --from-pr=* / -P / -P=*
- */
-export function shouldAutoName(passthrough: readonly string[]): boolean {
-  // Find "--" and verify at least one non-empty token follows.
-  const sepIdx = passthrough.indexOf('--');
-  if (sepIdx < 0) return false;
-
-  const hasPrompt = passthrough.slice(sepIdx + 1).some((t) => t !== '');
-  if (!hasPrompt) return false;
-
-  // Check for disqualifying tokens.
-  for (const t of passthrough) {
-    if (
-      t === '--name' ||
-      t === '-n' ||
-      t.startsWith('--name=') ||
-      t.startsWith('-n=')
-    )
-      return false;
-    if (t === '-p' || t === '--print') return false;
-    if (
-      t === '-r' ||
-      t === '--resume' ||
-      t.startsWith('-r=') ||
-      t.startsWith('--resume=')
-    )
-      return false;
-    if (t === '-c' || t === '--continue') return false;
-    if (
-      t === '--from-pr' ||
-      t.startsWith('--from-pr=') ||
-      t === '-P' ||
-      t.startsWith('-P=')
-    )
-      return false;
-  }
-  return true;
-}
-
-/**
- * extractPrompt returns the first non-empty token after "--" in passthrough.
- * Returns undefined if not found.
- */
-export function extractPrompt(passthrough: readonly string[]): string | undefined {
-  const sepIdx = passthrough.indexOf('--');
-  if (sepIdx < 0) return undefined;
-  for (const t of passthrough.slice(sepIdx + 1)) {
-    if (t !== '') return t;
-  }
-  return undefined;
-}
-
-// ── stop-words + heuristic fallback ────────────────────────────────────────
-
-const STOP_WORDS = new Set([
-  'a',
-  'an',
-  'the',
-  'is',
-  'are',
-  'was',
-  'were',
-  'do',
-  'does',
-  'did',
-  'of',
-  'for',
-  'to',
-  'in',
-  'on',
-  'at',
-  'with',
-  'this',
-  'that',
-  'please',
-  'can',
-  'could',
-  'would',
-  'should',
-]);
-
-/**
- * heuristicName derives a session name from a prompt without any LLM call.
- * Takes up to 3 non-stop-word, alphanumeric tokens joined with "-".
- */
-export function heuristicName(prompt: string): string {
-  const words = prompt.toLowerCase().split(/\s+/);
-  const kept: string[] = [];
-  for (const w of words) {
-    if (STOP_WORDS.has(w)) continue;
-    const clean = w.replace(/[^a-z0-9]/g, '');
-    if (clean !== '') kept.push(clean);
-    if (kept.length === 3) break;
-  }
-  return kept.length === 0 ? 'session' : kept.join('-');
-}
-
-// ── slug sanitization ───────────────────────────────────────────────────────
-
-const RE_NON_SLUG = /[^a-z0-9-]+/g;
-const RE_MULTI_DASH = /-{2,}/g;
-const RE_WHITESPACE = /\s+/g;
-
-/**
- * sanitizeSlug cleans raw LLM output into a valid kebab slug (up to 3 dash-
- * separated segments). Returns undefined when nothing survives sanitization.
- */
-export function sanitizeSlug(raw: string): string | undefined {
-  let s = raw.trim().toLowerCase();
-  s = s.replace(RE_WHITESPACE, '-');
-  s = s.replace(RE_NON_SLUG, '');
-  s = s.replace(RE_MULTI_DASH, '-');
-  s = s.replace(/^-+|-+$/g, '');
-  // Take first 3 dash-segments.
-  const parts = s.split('-');
-  s = parts.slice(0, 3).join('-');
-  // Trim again in case joining re-introduced edge dashes.
-  s = s.replace(/^-+|-+$/g, '');
-  return s !== '' ? s : undefined;
-}
-
-// ── LLM client abstraction ──────────────────────────────────────────────────
-
-export const NAME_SYSTEM_PROMPT =
-  "Generate a 1-3 word lowercase hyphen-separated label for this user's request. " +
-  'Output ONLY the label — no punctuation, no quotes, no explanation, no leading ' +
-  "'Label:'. Examples: 'fix-login-bug', 'add-dark-mode', 'refactor-auth'.";
-
-/**
- * LlmClientFn is the injectable seam for the LLM call. Tests can swap in a
- * fake without touching the Anthropic SDK.
- */
-export type LlmClientFn = (
-  model: string,
-  prompt: string,
-  signal: AbortSignal,
-) => Promise<string>;
-
-/**
- * defaultLlmClient returns an LlmClientFn backed by the real Anthropic API.
- */
-export function defaultLlmClient(apiKey: string): LlmClientFn {
-  return async (model, prompt, signal) => {
-    const client = new Anthropic({ apiKey });
-    const msg = await client.messages.create(
-      {
-        model,
-        max_tokens: 30,
-        system: NAME_SYSTEM_PROMPT,
-        messages: [{ role: 'user', content: prompt }],
-      },
-      { signal },
-    );
-    for (const blk of msg.content) {
-      if (blk.type === 'text') return blk.text;
-    }
-    throw new Error('no text block in response');
-  };
-}
-
-/**
- * claudeCliFn shells out to `claude -p --model <model> <combined-prompt>`.
- * Used as fallback when ANTHROPIC_API_KEY is absent.
- */
-export type SpawnFn = (
-  cmd: string,
-  args: string[],
-  signal: AbortSignal,
-) => Promise<string>;
-
-// Production spawn implementation using Bun.spawn.
-export const defaultSpawnFn: SpawnFn = async (cmd, args, signal) => {
-  const proc = Bun.spawn([cmd, ...args], {
-    stdout: 'pipe',
-    stderr: 'pipe',
-  });
-
-  // Kill on abort.
-  signal.addEventListener('abort', () => {
-    try {
-      proc.kill();
-    } catch {
-      // ignore
-    }
-  });
-
-  const [stdout] = await Promise.all([
-    new Response(proc.stdout).text(),
-    proc.exited,
-  ]);
-
-  const exitCode = proc.exitCode;
-  if (exitCode !== 0) {
-    throw new Error(`claude exited with code ${exitCode}`);
-  }
-  return stdout;
-};
-
-export function claudeCliFn(model: string, spawnFn: SpawnFn = defaultSpawnFn): LlmClientFn {
-  return async (_model, prompt, signal) => {
-    const combined = `${NAME_SYSTEM_PROMPT}\n\nUser request: ${prompt}`;
-    return spawnFn('claude', ['-p', '--model', model, combined], signal);
-  };
-}
-
-// ── generateName ────────────────────────────────────────────────────────────
-
-/**
- * generateName produces a session name for the given prompt.
- *
- * llmFn may be omitted; it is selected automatically:
- *   - defaultLlmClient when apiKey is non-empty
- *   - claudeCliFn otherwise (falls back to the user's existing auth)
- *
- * On any error the function falls back to heuristicName silently.
- */
-export async function generateName(
-  prompt: string | undefined,
-  cfg: NameConfig,
-  apiKey: string,
-  llmFn?: LlmClientFn,
-): Promise<string> {
-  const resolved = prompt ?? '';
-  let usingCLI = false;
-  if (!llmFn) {
-    if (apiKey) {
-      llmFn = defaultLlmClient(apiKey);
-    } else {
-      llmFn = claudeCliFn(cfg.model);
-      usingCLI = true;
-    }
-  }
-
-  // cfg.timeout is in milliseconds (NameConfig stores ms).
-  let timeoutMs = cfg.timeout;
-  if (timeoutMs <= 0) {
-    // claude -p cold-start is multi-second; give the CLI path more room.
-    timeoutMs = usingCLI ? 15_000 : 3_000;
-  }
-
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-
-  try {
-    const raw = await llmFn(cfg.model, resolved, controller.signal);
-    const name = sanitizeSlug(raw);
-    return name !== undefined ? name : heuristicName(resolved);
-  } catch {
-    return heuristicName(resolved);
-  } finally {
-    clearTimeout(timer);
-  }
-}

package/src/clipboard.ts

@@ -1,149 +0,0 @@
-// Port of src/clipboard.go from the Go reference implementation.
-//
-// pickClipboardTool — detects the platform-appropriate clipboard binary.
-// copyToClipboard   — spawns that binary and pipes text into its stdin.
-
-// ── types ────────────────────────────────────────────────────────────────────
-
-/** Encodes the platform-detected clipboard tool choice. */
-export interface ClipboardTool {
-  name: string;
-  args: string[];
-}
-
-/**
- * SpawnResult is the injectable seam used in tests to avoid exec'ing real
- * clipboard binaries. Production code calls defaultSpawnClipboard.
- */
-export type ClipboardSpawnFn = (
-  name: string,
-  args: string[],
-  text: string,
-) => Promise<void>;
-
-// ── detection ─────────────────────────────────────────────────────────────────
-
-/**
- * pickClipboardTool returns the first tool that matches the current runtime
- * + environment, or null if no supported clipboard integration is available.
- *
- * Detection rules (matches the Go reference):
- *
- *   Linux (Wayland — $WAYLAND_DISPLAY set): wl-copy
- *   Linux (X11    — $DISPLAY set):          xclip -selection clipboard
- *   macOS (process.platform === 'darwin'):  pbcopy
- *   Windows (process.platform === 'win32'): clip
- *
- * Pure function of (platform, env-lookup) — trivially testable without
- * exec'ing anything.
- */
-export function pickClipboardTool(
-  platform: NodeJS.Platform,
-  env: (key: string) => string | undefined,
-): ClipboardTool | null {
-  switch (platform) {
-    case 'linux': {
-      if (env('WAYLAND_DISPLAY')) {
-        return { name: 'wl-copy', args: [] };
-      }
-      if (env('DISPLAY')) {
-        return { name: 'xclip', args: ['-selection', 'clipboard'] };
-      }
-      // Headless Linux: no supported tool.
-      return null;
-    }
-    case 'darwin':
-      return { name: 'pbcopy', args: [] };
-    case 'win32':
-      return { name: 'clip', args: [] };
-    default:
-      return null;
-  }
-}
-
-// ── spawn implementation ──────────────────────────────────────────────────────
-
-/**
- * defaultClipboardSpawn spawns cmd with args and writes text to its stdin
- * using Bun.spawn. Throws on non-zero exit.
- */
-export const defaultClipboardSpawn: ClipboardSpawnFn = async (name, args, text) => {
-  const proc = Bun.spawn([name, ...args], {
-    stdin: 'pipe',
-    stdout: 'ignore',
-    stderr: 'ignore',
-  });
-
-  // Write text into stdin then close it.
-  const writer = proc.stdin;
-  writer.write(text);
-  await writer.end();
-
-  const exitCode = await proc.exited;
-  if (exitCode !== 0) {
-    throw new Error(`${name} exited with code ${exitCode}`);
-  }
-};
-
-// ── xsel fallback ────────────────────────────────────────────────────────────
-
-/**
- * xselFallback tries xsel --clipboard --input when xclip is unavailable or
- * fails. Returns true on success, false + error on failure.
- */
-async function xselFallback(
-  text: string,
-  spawnFn: ClipboardSpawnFn,
-): Promise<{ ok: boolean; err?: Error }> {
-  try {
-    await spawnFn('xsel', ['--clipboard', '--input'], text);
-    return { ok: true };
-  } catch (e) {
-    return { ok: false, err: e as Error };
-  }
-}
-
-// ── public API ────────────────────────────────────────────────────────────────
-
-/**
- * copyToClipboard writes text to the user's clipboard via the
- * platform-appropriate tool. Returns { ok: true } on success or
- * { ok: false, error } on failure (tool missing, exec error, no detector
- * matched, etc.).
- *
- * Detection precedence and tool choice are documented on pickClipboardTool.
- */
-export async function copyToClipboard(
-  text: string,
-  spawnFn: ClipboardSpawnFn = defaultClipboardSpawn,
-  platform: NodeJS.Platform = process.platform,
-  env: (key: string) => string | undefined = (k) => process.env[k],
-): Promise<{ ok: boolean; error?: Error }> {
-  const tool = pickClipboardTool(platform, env);
-  if (!tool) {
-    return {
-      ok: false,
-      error: new Error(
-        `no clipboard integration available for platform=${platform}`,
-      ),
-    };
-  }
-
-  try {
-    await spawnFn(tool.name, tool.args, text);
-    return { ok: true };
-  } catch (primaryErr) {
-    // X11 fallback: try xsel before giving up.
-    if (tool.name === 'xclip') {
-      const fb = await xselFallback(text, spawnFn);
-      if (fb.ok) return { ok: true };
-      return {
-        ok: false,
-        error: new Error(
-          `xclip failed (${(primaryErr as Error).message}); xsel fallback failed (${fb.err?.message})`,
-        ),
-      };
-    }
-    return { ok: false, error: primaryErr as Error };
-  }
-}