@respan/cli 0.10.0 → 0.11.0

package/dist/commands/setup/doctor.d.ts

@@ -13,5 +13,4 @@ export default class SetupDoctor extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private isBinaryInstalled;
 }

package/dist/commands/setup/doctor.js

@@ -5,12 +5,8 @@ import { execSync } from 'node:child_process';
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../lib/base-command.js';
 import { findProjectRoot, expandHome, readTextFile } from '../../lib/integrate.js';
-const GREEN = '\x1b[32m';
-const RED = '\x1b[31m';
-const YELLOW = '\x1b[33m';
-const DIM = '\x1b[2m';
-const BOLD = '\x1b[1m';
-const RESET = '\x1b[0m';
+import { GREEN, RED, YELLOW, DIM, BOLD, RESET } from '../../lib/colors.js';
+import { isBinaryInstalled } from '../../lib/agents.js';
 class SetupDoctor extends BaseCommand {
     async run() {
         const { flags } = await this.parse(SetupDoctor);
@@ -43,7 +39,7 @@ class SetupDoctor extends BaseCommand {
         this.log('');
         // ── 2. Respan CLI ──────────────────────────────────────────────
         this.log(`  ${BOLD}Respan CLI${RESET}`);
-        const respanInstalled = this.isBinaryInstalled('respan');
+        const respanInstalled = isBinaryInstalled('respan');
         if (respanInstalled) {
             try {
                 const version = execSync('respan --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
@@ -66,44 +62,44 @@ class SetupDoctor extends BaseCommand {
                 name: 'Claude Code',
                 globalConfigs: ['~/.claude/settings.json'],
                 localConfigs: ['.claude/settings.local.json'],
-                globalSkills: ['~/.claude/skills/respan/SKILL.md', '~/.agents/skills/respan/SKILL.md'],
-                localSkills: ['.claude/skills/respan/SKILL.md', '.agents/skills/respan/SKILL.md'],
+                globalSkills: ['~/.claude/skills/respan/SKILL.md'],
+                localSkills: ['.claude/skills/respan/SKILL.md'],
             },
             'cursor': {
                 binary: 'cursor',
                 name: 'Cursor',
                 globalConfigs: ['~/.cursor/rules'],
                 localConfigs: ['.cursor/rules'],
-                globalSkills: ['~/.cursor/skills/respan/SKILL.md', '~/.agents/skills/respan/SKILL.md'],
-                localSkills: ['.cursor/skills/respan/SKILL.md', '.agents/skills/respan/SKILL.md'],
+                globalSkills: ['~/.agents/skills/respan/SKILL.md', '~/.cursor/skills/respan/SKILL.md'],
+                localSkills: ['.agents/skills/respan/SKILL.md', '.cursor/skills/respan/SKILL.md'],
             },
             'codex-cli': {
                 binary: 'codex',
                 name: 'Codex CLI',
                 globalConfigs: ['~/.codex/config.toml'],
                 localConfigs: ['.codex/respan.json'],
-                globalSkills: ['~/.codex/skills/respan/SKILL.md', '~/.agents/skills/respan/SKILL.md'],
-                localSkills: ['.codex/skills/respan/SKILL.md', '.agents/skills/respan/SKILL.md'],
+                globalSkills: ['~/.agents/skills/respan/SKILL.md', '~/.codex/skills/respan/SKILL.md'],
+                localSkills: ['.agents/skills/respan/SKILL.md', '.codex/skills/respan/SKILL.md'],
             },
             'gemini-cli': {
                 binary: 'gemini',
                 name: 'Gemini CLI',
                 globalConfigs: ['~/.gemini/settings.json'],
                 localConfigs: ['.gemini/settings.json'],
-                globalSkills: ['~/.gemini/skills/respan/SKILL.md', '~/.agents/skills/respan/SKILL.md'],
-                localSkills: ['.gemini/skills/respan/SKILL.md', '.agents/skills/respan/SKILL.md'],
+                globalSkills: ['~/.agents/skills/respan/SKILL.md', '~/.gemini/skills/respan/SKILL.md'],
+                localSkills: ['.agents/skills/respan/SKILL.md', '.gemini/skills/respan/SKILL.md'],
             },
             'opencode': {
                 binary: 'opencode',
                 name: 'OpenCode',
                 globalConfigs: ['~/.config/opencode'],
                 localConfigs: ['.opencode'],
-                globalSkills: ['~/.config/opencode/skills/respan/SKILL.md', '~/.agents/skills/respan/SKILL.md'],
-                localSkills: ['.opencode/skills/respan/SKILL.md', '.agents/skills/respan/SKILL.md'],
+                globalSkills: ['~/.agents/skills/respan/SKILL.md', '~/.config/opencode/skills/respan/SKILL.md'],
+                localSkills: ['.agents/skills/respan/SKILL.md', '.opencode/skills/respan/SKILL.md'],
             },
         };
         for (const [id, tool] of Object.entries(tools)) {
-            const binaryFound = this.isBinaryInstalled(tool.binary);
+            const binaryFound = isBinaryInstalled(tool.binary);
             this.log(`    ${BOLD}${tool.name}${RESET} ${DIM}(${tool.binary})${RESET}`);
             // Binary
             if (binaryFound) {
@@ -129,24 +125,22 @@ class SetupDoctor extends BaseCommand {
                     }
                 }
             }
-            // Skills
+            // Skills \u2014 each tool only lists dirs it actually reads (the shared
+            // ~/.agents, or ~/.claude for Claude Code) plus its own dir as a
+            // fallback. Report the first match.
             let hasSkill = false;
             if (checkGlobal) {
-                for (const skill of tool.globalSkills) {
-                    const resolved = expandHome(skill);
-                    if (fs.existsSync(resolved)) {
-                        this.log(`      ${GREEN}\u2713${RESET} Global skill: ${DIM}${skill}${RESET}`);
-                        hasSkill = true;
-                    }
+                const found = tool.globalSkills.find((skill) => fs.existsSync(expandHome(skill)));
+                if (found) {
+                    this.log(`      ${GREEN}\u2713${RESET} Global skill: ${DIM}${found}${RESET}`);
+                    hasSkill = true;
                 }
             }
             if (checkLocal) {
-                for (const skill of tool.localSkills) {
-                    const resolved = path.join(projectRoot, skill);
-                    if (fs.existsSync(resolved)) {
-                        this.log(`      ${GREEN}\u2713${RESET} Local skill: ${DIM}${skill}${RESET}`);
-                        hasSkill = true;
-                    }
+                const found = tool.localSkills.find((skill) => fs.existsSync(path.join(projectRoot, skill)));
+                if (found) {
+                    this.log(`      ${GREEN}\u2713${RESET} Local skill: ${DIM}${found}${RESET}`);
+                    hasSkill = true;
                 }
             }
             if (binaryFound && !hasSkill) {
@@ -193,15 +187,6 @@ class SetupDoctor extends BaseCommand {
         }
         this.log('');
     }
-    isBinaryInstalled(binary) {
-        try {
-            execSync(`command -v ${binary}`, { stdio: 'pipe' });
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
 }
 SetupDoctor.description = 'Diagnose coding-agent setup for Respan';
 SetupDoctor.examples = [

package/dist/commands/setup/gateway.d.ts

@@ -0,0 +1,16 @@
+import { SetupBaseCommand } from '../../lib/setup-base-command.js';
+export default class SetupGateway extends SetupBaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-instrument': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/setup/gateway.js

@@ -0,0 +1,33 @@
+import { Flags } from '@oclif/core';
+import { SetupBaseCommand } from '../../lib/setup-base-command.js';
+class SetupGateway extends SetupBaseCommand {
+    async run() {
+        const { flags } = await this.parse(SetupGateway);
+        this.globalFlags = flags;
+        await this.runSetup('gateway', {
+            agent: flags.agent,
+            noInstrument: flags['no-instrument'],
+        });
+    }
+}
+SetupGateway.description = `Set up Respan gateway routing in this project.
+
+Runs the gateway setup flow directly (skips the "Tracing or Gateway?"
+question). Sets up your API key, installs the Respan skill, and optionally
+opens your coding agent to route the detected framework through the gateway.`;
+SetupGateway.examples = [
+    'respan setup gateway',
+    'respan setup gateway --agent claude-code',
+    'respan setup gateway --no-instrument',
+];
+SetupGateway.flags = {
+    ...SetupBaseCommand.baseFlags,
+    agent: Flags.string({
+        description: 'Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)',
+    }),
+    'no-instrument': Flags.boolean({
+        description: 'Skip opening the agent after setup',
+        default: false,
+    }),
+};
+export default SetupGateway;

package/dist/commands/setup/index.d.ts

@@ -1,45 +1,16 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class Setup extends BaseCommand {
+import { SetupBaseCommand } from '../../lib/setup-base-command.js';
+export default class Setup extends SetupBaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-instrument': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private askApiKey;
-    private verifyApiKey;
-    /**
-     * Build a rich demo OTLP trace that mimics a customer support agent workflow:
-     *   workflow: customer_support_pipeline
-     *     └── agent: support_agent
-     *           ├── tool: lookup_order
-     *           ├── chat: openai.chat (classify intent)
-     *           ├── tool: process_refund
-     *           ├── chat: openai.chat (generate response)
-     *           └── task: log_resolution
-     */
-    private buildDemoTrace;
-    private detectAgents;
-    private selectAgent;
-    private installSkill;
-    private runInstrumentAgent;
-    private getSkillMd;
-    private logStep;
-    private isBinaryInstalled;
-    private extractEnvVar;
-    private saveToEnv;
-    private getGitEmail;
-    /**
-     * Send a lightweight setup notification (email only).
-     * This helps the team know when new users set up Respan so we can
-     * reach out and help with onboarding.
-     */
-    private notifySetup;
 }