@ashlr/hub 2.2.0

package/dist/cli/wire.js

@@ -0,0 +1,205 @@
+/**
+ * `ashlr wire` — wire the ashlr MCP gateway into editor config(s).
+ *
+ * Usage:
+ *   ashlr wire [claude|codex|cursor|all]  [--config <path>]  [--json]
+ *
+ * Defaults to detected editors when no target is specified.
+ * Backup-first, deep-merge mcpServers, idempotent, LOCAL only.
+ * `--config <path>` overrides the default config path for the first/only target
+ * (temp-config-safe for tests; with `all` it applies to each detected editor).
+ *
+ * Exit codes:
+ *   0  all targets wired (or already up-to-date)
+ *   1  one or more targets failed
+ *   2  bad usage
+ */
+import { pad, makeColors, isTty } from './ui.js';
+const { bold, dim, red, green, yellow, cyan, gray } = makeColors(isTty());
+// ---------------------------------------------------------------------------
+// Lazy import — integrations built by another agent; degrade gracefully
+// ---------------------------------------------------------------------------
+async function importEditors() {
+    return import('../core/integrations/editors.js');
+}
+// ---------------------------------------------------------------------------
+// Arg parsing
+// ---------------------------------------------------------------------------
+const VALID_TARGETS = ['claude', 'codex', 'cursor', 'all'];
+function parseWireArgs(args) {
+    let explicitTarget = null;
+    let configPath;
+    let json = false;
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--json') {
+            json = true;
+        }
+        else if (arg === '--config') {
+            const val = args[++i];
+            if (!val || val.startsWith('--')) {
+                return { targets: [], json, usageError: `--config requires a path; got: ${val ?? '(missing)'}` };
+            }
+            configPath = val;
+        }
+        else if (VALID_TARGETS.includes(arg)) {
+            if (explicitTarget !== null) {
+                return { targets: [], json, usageError: `multiple targets specified; pass one of: claude codex cursor all` };
+            }
+            explicitTarget = arg;
+        }
+        else if (arg.startsWith('--')) {
+            return { targets: [], json, usageError: `unknown flag: ${arg}` };
+        }
+        else {
+            return { targets: [], json, usageError: `unexpected argument: ${arg}` };
+        }
+        i++;
+    }
+    // Resolve targets; 'all' and default (no target) → detect
+    if (explicitTarget === 'all' || explicitTarget === null) {
+        // Will be filled in at runtime via detectEditors()
+        return { targets: [], configPath, json, usageError: undefined };
+    }
+    return { targets: [explicitTarget], configPath, json };
+}
+// ---------------------------------------------------------------------------
+// Help
+// ---------------------------------------------------------------------------
+function printWireHelp() {
+    console.log('');
+    console.log(bold('  ashlr wire') + dim(' — wire the ashlr MCP gateway into editor config(s)'));
+    console.log('');
+    console.log('  ' + bold('Usage:'));
+    console.log('');
+    console.log(`    ashlr wire ${cyan('[claude|codex|cursor|all]')} [options]`);
+    console.log('');
+    console.log('  ' + bold('Options:'));
+    console.log('');
+    const opts = [
+        ['[target]', 'Editor to wire: claude, codex, cursor, or all. Defaults to detected editors.'],
+        ['--config <path>', 'Override the config path (temp-config-safe for tests).'],
+        ['--json', 'Emit results as JSON on stdout.'],
+        ['--claude-md', 'Print a CLAUDE.md snippet teaching agents the CLI-first ashlr usage (read-only).'],
+    ];
+    const w = Math.max(...opts.map(([o]) => o.length));
+    for (const [opt, desc] of opts) {
+        console.log(`    ${cyan(pad(opt, w))}  ${desc}`);
+    }
+    console.log('');
+    console.log('  ' + bold('What it does:'));
+    console.log('');
+    console.log(`    ${dim('• Backs up the editor config before any write.')}`);
+    console.log(`    ${dim('• Deep-merges the "ashlr" MCP gateway into mcpServers — never clobbers existing entries.')}`);
+    console.log(`    ${dim('• Idempotent: re-running with the same config is a no-op.')}`);
+    console.log(`    ${dim('• LOCAL only: only writes the editor\'s own config file.')}`);
+    console.log('');
+    console.log('  ' + bold('Examples:'));
+    console.log('');
+    console.log(`    ${cyan('ashlr wire')}                     ${dim('# wire all detected editors')}`);
+    console.log(`    ${cyan('ashlr wire claude')}              ${dim('# wire only Claude Code')}`);
+    console.log(`    ${cyan('ashlr wire all --json')}          ${dim('# wire all, machine-readable output')}`);
+    console.log(`    ${cyan('ashlr wire claude --config /tmp/test.json')}  ${dim('# test against a temp file')}`);
+    console.log('');
+}
+// ---------------------------------------------------------------------------
+// cmdWire — main entry point
+// ---------------------------------------------------------------------------
+/**
+ * `ashlr wire <claude|codex|cursor|all>` — wire MCP gateway into editor config(s).
+ * Defaults to detected editors; backup-first, idempotent, local.
+ * Returns a process exit code.
+ */
+export async function cmdWire(args) {
+    const sub = args[0];
+    if (sub === '--help' || sub === '-h' || sub === 'help') {
+        printWireHelp();
+        return 0;
+    }
+    // M31: `ashlr wire --claude-md` — print a ready-to-paste CLAUDE.md snippet
+    // teaching agents the CLI-first ashlr usage. Read-only; writes nothing.
+    if (args.includes('--claude-md')) {
+        const { claudeMdSnippet } = await import('./help.js');
+        process.stdout.write(claudeMdSnippet());
+        return 0;
+    }
+    const parsed = parseWireArgs(args);
+    if (parsed.usageError) {
+        process.stderr.write(red('error: ') + parsed.usageError + '\n');
+        return 2;
+    }
+    // Load the editors integration module
+    let mod;
+    try {
+        mod = await importEditors();
+    }
+    catch {
+        process.stderr.write(red('error: ') + 'Editor integration module not yet available.\n');
+        return 1;
+    }
+    // Resolve targets: empty means use detectEditors()
+    const resolvedTargets = parsed.targets.length > 0
+        ? parsed.targets
+        : mod.detectEditors();
+    if (resolvedTargets.length === 0) {
+        if (parsed.json) {
+            process.stdout.write(JSON.stringify({ wired: [], skipped: [], errors: [], detected: [] }, null, 2) + '\n');
+        }
+        else {
+            console.log('');
+            console.log(yellow('  No editors detected.'));
+            console.log(dim('  Install Claude Code, Cursor, or Codex and try again.'));
+            console.log(dim('  Or pass an explicit target: ashlr wire claude'));
+            console.log('');
+        }
+        return 0;
+    }
+    if (!parsed.json) {
+        console.log('');
+        console.log(bold('  ashlr wire') + gray(`  — wiring ${resolvedTargets.join(', ')}`));
+        console.log('');
+    }
+    const results = [];
+    for (const target of resolvedTargets) {
+        const opts = parsed.configPath ? { configPath: parsed.configPath } : {};
+        let result;
+        try {
+            result = await mod.wireEditor(target, opts);
+        }
+        catch (err) {
+            result = {
+                ok: false,
+                detail: err instanceof Error ? err.message : String(err),
+            };
+        }
+        results.push({ target, ...result });
+        if (!parsed.json) {
+            const icon = result.ok ? green('✓') : red('✗');
+            const targetLabel = bold(target);
+            const detailStr = result.ok ? dim(result.detail) : red(result.detail);
+            console.log(`  ${icon}  ${targetLabel}  ${detailStr}`);
+        }
+    }
+    if (parsed.json) {
+        const wired = results.filter(r => r.ok).map(r => r.target);
+        const errors = results.filter(r => !r.ok).map(r => ({ target: r.target, detail: r.detail }));
+        process.stdout.write(JSON.stringify({ wired, errors, detected: resolvedTargets }, null, 2) + '\n');
+    }
+    else {
+        console.log('');
+        const allOk = results.every(r => r.ok);
+        const anyFailed = results.some(r => !r.ok);
+        if (allOk) {
+            console.log(dim('  All editors wired. Restart your editor to pick up the new MCP entry.'));
+        }
+        else if (anyFailed) {
+            const failCount = results.filter(r => !r.ok).length;
+            console.log(yellow(`  ${failCount} target(s) failed — check the details above.`));
+        }
+        console.log('');
+    }
+    const exitCode = results.some(r => !r.ok) ? 1 : 0;
+    return exitCode;
+}
+//# sourceMappingURL=wire.js.map

package/dist/cli/wire.js.map

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

package/dist/core/classify.d.ts

@@ -0,0 +1,51 @@
+/**
+ * classify.ts — cheap, synchronous heuristics for categorising Desktop items.
+ *
+ * Rules:
+ *  - Never throw; return null / 'other' on any error.
+ *  - Zero runtime deps (Node builtins only).
+ *  - Synchronous everywhere — called in a tight scan loop.
+ */
+import type { ItemKind } from './types.js';
+/**
+ * Return the category bucket for `itemPath`:
+ *  - For a path under `github/<category>/<repo>` → the category name
+ *    (e.g. "dev-tools", "side-projects").
+ *  - For a path directly under the Desktop (or its known doc folders) →
+ *    the top-level folder name (e.g. "Business", "Client-Work").
+ *  - Otherwise → null.
+ */
+export declare function categoryOf(itemPath: string): string | null;
+/**
+ * Return a one-line description for `itemPath` (a directory or file):
+ *  1. package.json "description" field (if present and non-empty).
+ *  2. First H1 (`# …`) in README.md / README.markdown / README (stripped of `#`).
+ *  3. First non-empty non-heading line in the README.
+ *  4. null if none found.
+ *
+ * Capped at 160 characters.
+ */
+export declare function describe(itemPath: string): string | null;
+/**
+ * Cheap heuristic language detection (no AST, no external tools):
+ *  1. package.json present → JavaScript or TypeScript (check for .ts devDeps).
+ *  2. Cargo.toml → Rust.
+ *  3. pyproject.toml | requirements.txt | setup.py → Python.
+ *  4. Package.swift → Swift.
+ *  5. go.mod → Go.
+ *  6. Gemfile | *.gemspec → Ruby.
+ *  7. pom.xml | build.gradle → Java/Kotlin.
+ *  8. Shallow directory scan — most common source extension wins.
+ *  9. null if undetermined.
+ */
+export declare function primaryLanguage(itemPath: string): string | null;
+/**
+ * Determine the fundamental kind of `itemPath`:
+ *  - 'symlink'    — lstat shows it's a symbolic link (checked first).
+ *  - 'repo'       — directory that contains a .git entry.
+ *  - 'doc-folder' — directory whose basename is a known doc-category folder.
+ *  - 'doc'        — file with a document extension.
+ *  - 'asset'      — file with an image/media/archive extension.
+ *  - 'other'      — anything else.
+ */
+export declare function kindOf(itemPath: string): ItemKind;