@respan/cli 0.7.1 → 0.7.2

package/dist/commands/integrate/claude-code.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateClaudeCode extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/claude-code.js

@@ -7,6 +7,37 @@ class IntegrateClaudeCode extends BaseCommand {
         const { flags } = await this.parse(IntegrateClaudeCode);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            const scope = resolveScope(flags, 'both');
+            const doLocal = scope === 'local' || scope === 'both';
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                // Remove the Stop hook entry from global settings
+                const globalSettingsPath = expandHome('~/.claude/settings.json');
+                const globalSettings = readJsonFile(globalSettingsPath);
+                const hooksSection = (globalSettings.hooks || {});
+                if (Array.isArray(hooksSection.Stop)) {
+                    hooksSection.Stop = hooksSection.Stop.filter((entry) => {
+                        const inner = Array.isArray(entry.hooks)
+                            ? entry.hooks
+                            : [];
+                        return !inner.some((h) => typeof h.command === 'string' &&
+                            (h.command.includes('respan') || h.command.includes('hook.py') || h.command.includes('claude-code')));
+                    });
+                }
+                const merged = deepMerge(globalSettings, { hooks: hooksSection });
+                if (dryRun) {
+                    this.log(`[dry-run] Would update: ${globalSettingsPath}`);
+                    this.log(JSON.stringify(merged, null, 2));
+                }
+                else {
+                    writeJsonFile(globalSettingsPath, merged);
+                    this.log(`Removed hook entry: ${globalSettingsPath}`);
+                }
+                this.log('Claude Code tracing disabled. Run "respan integrate claude-code" to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             // Verify the user is authenticated (key is read by hook from ~/.respan/)
             this.resolveApiKey();
             const baseUrl = flags['base-url'];
@@ -15,11 +46,8 @@ class IntegrateClaudeCode extends BaseCommand {
             const spanName = flags['span-name'];
             const workflowName = flags['workflow-name'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
-            // Claude Code default: both global + local
-            const scope = resolveScope(flags, 'both');
+            // Claude Code default: both global + local.
             const doGlobal = scope === 'global' || scope === 'both';
-            const doLocal = scope === 'local' || scope === 'both';
             // ── Global: hook script + registration ────────────────────────
             if (doGlobal) {
                 // 1. Write JS hook script (no Python dependency needed)
@@ -165,9 +193,11 @@ them to Respan as structured spans (chat, tool, thinking).
 Scope:
   --global   Install hook script + register in ~/.claude/settings.json
   --local    Write credentials + enable flag to .claude/settings.local.json
-  (default)  Both: install hook globally + enable for current project`;
+
+Default behavior installs the global hook and writes local project config.`;
 IntegrateClaudeCode.examples = [
     'respan integrate claude-code',
+    'respan integrate claude-code --disable',
     'respan integrate claude-code --global',
     'respan integrate claude-code --local --project-id my-project',
     'respan integrate claude-code --attrs \'{"env":"prod"}\'',

package/dist/commands/integrate/codex-cli.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateCodexCli extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/codex-cli.js

@@ -6,6 +6,26 @@ class IntegrateCodexCli extends BaseCommand {
         const { flags } = await this.parse(IntegrateCodexCli);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                // Remove the notify line from ~/.codex/config.toml
+                const configPath = expandHome('~/.codex/config.toml');
+                const existing = readTextFile(configPath);
+                const lines = existing.split('\n');
+                const filtered = lines.filter((line) => !/^\s*notify\s*=/.test(line) && !line.includes('respan integrate codex-cli'));
+                if (dryRun) {
+                    this.log(`[dry-run] Would update: ${configPath}`);
+                    this.log(filtered.join('\n'));
+                }
+                else {
+                    writeTextFile(configPath, filtered.join('\n'));
+                    this.log(`Removed notify hook: ${configPath}`);
+                }
+                this.log('Codex CLI tracing disabled. Run "respan integrate codex-cli" to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             // Verify the user is authenticated (key is read by hook from ~/.respan/)
             this.resolveApiKey();
             const projectId = flags['project-id'];
@@ -13,7 +33,6 @@ class IntegrateCodexCli extends BaseCommand {
             const spanName = flags['span-name'];
             const workflowName = flags['workflow-name'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
             // Codex CLI default: both global + local
             const scope = resolveScope(flags, 'both');
             const doGlobal = scope === 'global' || scope === 'both';
@@ -155,9 +174,11 @@ them to Respan as structured spans (chat, tool, reasoning).
 Scope:
   --global   Install hook script + register notify in ~/.codex/config.toml
   --local    Write .codex/respan.json with customer_id, span_name, etc.
-  (default)  Both: install hook globally + config for current project`;
+
+Default behavior installs the global notify hook and writes local project config.`;
 IntegrateCodexCli.examples = [
     'respan integrate codex-cli',
+    'respan integrate codex-cli --disable',
     'respan integrate codex-cli --global',
     'respan integrate codex-cli --local --customer-id frank',
     'respan integrate codex-cli --attrs \'{"env":"prod"}\'',

package/dist/commands/integrate/gemini-cli.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateGeminiCli extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/gemini-cli.js

@@ -7,6 +7,40 @@ class IntegrateGeminiCli extends BaseCommand {
         const { flags } = await this.parse(IntegrateGeminiCli);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            const scope = resolveScope(flags, 'global');
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                // Remove respan hook entries from settings.json
+                const settingsPath = scope === 'global'
+                    ? expandHome('~/.gemini/settings.json')
+                    : path.join(findProjectRoot(), '.gemini', 'settings.json');
+                const existing = readJsonFile(settingsPath);
+                const hooksSection = (existing.hooks || {});
+                for (const eventName of ['AfterModel', 'BeforeTool', 'AfterTool']) {
+                    if (!Array.isArray(hooksSection[eventName]))
+                        continue;
+                    hooksSection[eventName] = hooksSection[eventName].filter((entry) => {
+                        const inner = Array.isArray(entry.hooks)
+                            ? entry.hooks
+                            : [];
+                        return !inner.some((h) => typeof h.command === 'string' &&
+                            (h.command.includes('respan') || h.command.includes('gemini-cli')));
+                    });
+                }
+                const merged = { ...existing, hooks: hooksSection };
+                if (dryRun) {
+                    this.log(`[dry-run] Would update: ${settingsPath}`);
+                    this.log(JSON.stringify(merged, null, 2));
+                }
+                else {
+                    writeJsonFile(settingsPath, merged);
+                    this.log(`Removed hook entries: ${settingsPath}`);
+                }
+                this.log('Gemini CLI tracing disabled. Run "respan integrate gemini-cli" to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             // Verify the user is authenticated (key is read by hook from ~/.respan/)
             this.resolveApiKey();
             const projectId = flags['project-id'];
@@ -14,8 +48,6 @@ class IntegrateGeminiCli extends BaseCommand {
             const spanName = flags['span-name'];
             const workflowName = flags['workflow-name'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'global');
             // ── 1. Install hook script ──────────────────────────────────
             const hookDir = expandHome('~/.respan/hooks');
             const hookPath = `${hookDir}/gemini-cli.cjs`;
@@ -142,10 +174,10 @@ Scope:
   --global   Write to ~/.gemini/settings.json (default)
   --local    Write to .gemini/settings.json in project root
 
-Note: Gemini CLI ignores workspace-level telemetry settings, so
---global is the default.`;
+Gemini CLI ignores workspace-level telemetry settings, so --global is the default.`;
 IntegrateGeminiCli.examples = [
     'respan integrate gemini-cli',
+    'respan integrate gemini-cli --disable',
     'respan integrate gemini-cli --local',
     'respan integrate gemini-cli --project-id my-project --attrs \'{"env":"prod"}\'',
     'respan integrate gemini-cli --dry-run',

package/dist/commands/integrate/opencode.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateOpencode extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/opencode.js

@@ -1,3 +1,4 @@
+import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { execSync } from 'node:child_process';
 import { BaseCommand } from '../../lib/base-command.js';
@@ -7,12 +8,33 @@ class IntegrateOpencode extends BaseCommand {
         const { flags } = await this.parse(IntegrateOpencode);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            const scope = resolveScope(flags, 'local');
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                const pluginPath = scope === 'global'
+                    ? expandHome('~/.config/opencode/plugins/otel.json')
+                    : path.join(findProjectRoot(), '.opencode', 'plugins', 'otel.json');
+                if (dryRun) {
+                    this.log(`[dry-run] Would remove: ${pluginPath}`);
+                }
+                else {
+                    try {
+                        fs.unlinkSync(pluginPath);
+                        this.log(`Removed plugin config: ${pluginPath}`);
+                    }
+                    catch {
+                        this.log(`No plugin config found at: ${pluginPath}`);
+                    }
+                }
+                this.log('OpenCode tracing disabled. Run with --enable to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             const apiKey = this.resolveApiKey();
             const baseUrl = (flags['base-url']).replace(/\/+$/, '');
             const projectId = flags['project-id'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'local');
             // ── 1. Install opencode-otel (always global) ─────────────────
             if (dryRun) {
                 this.log('[dry-run] Would run: npm install -g opencode-otel');
@@ -89,6 +111,7 @@ Scope:
   The opencode-otel package is always installed globally.`;
 IntegrateOpencode.examples = [
     'respan integrate opencode',
+    'respan integrate opencode --disable',
     'respan integrate opencode --global',
     'respan integrate opencode --project-id my-project --attrs \'{"env":"prod"}\'',
     'respan integrate opencode --dry-run',

package/dist/hooks/claude-code.cjs

@@ -280,6 +280,7 @@ function stringToSpanId(s) {
 function toOtlpPayload(spans) {
   const otlpSpans = spans.map((span) => {
     const attrs = {};
+    if (span.session_identifier) attrs["respan.sessions.session_identifier"] = span.session_identifier;
     if (span.thread_identifier) attrs["respan.threads.thread_identifier"] = span.thread_identifier;
     if (span.customer_identifier) attrs["respan.customer_params.customer_identifier"] = span.customer_identifier;
     if (span.span_workflow_name) attrs["traceloop.workflow.name"] = span.span_workflow_name;
@@ -340,7 +341,7 @@ function toOtlpPayload(spans) {
         })
       },
       scopeSpans: [{
-        scope: { name: "respan-cli-hooks", version: "0.7.0" },
+        scope: { name: "respan-cli-hooks", version: "0.7.1" },
         spans: otlpSpans
       }]
     }]
@@ -599,6 +600,7 @@ function createSpans(sessionId, turnNum, userMsg, assistantMsgs, toolResults, co
   const rootSpanId = `claudecode_${traceUniqueId}_root`;
   spans.push({
     trace_unique_id: traceUniqueId,
+    session_identifier: threadId,
     thread_identifier: threadId,
     customer_identifier: customerId,
     span_unique_id: rootSpanId,

package/dist/hooks/claude-code.js

@@ -248,6 +248,7 @@ function createSpans(sessionId, turnNum, userMsg, assistantMsgs, toolResults, co
     const rootSpanId = `claudecode_${traceUniqueId}_root`;
     spans.push({
         trace_unique_id: traceUniqueId,
+        session_identifier: threadId,
         thread_identifier: threadId,
         customer_identifier: customerId,
         span_unique_id: rootSpanId,

package/dist/hooks/codex-cli.cjs

@@ -280,6 +280,7 @@ function stringToSpanId(s) {
 function toOtlpPayload(spans) {
   const otlpSpans = spans.map((span) => {
     const attrs = {};
+    if (span.session_identifier) attrs["respan.sessions.session_identifier"] = span.session_identifier;
     if (span.thread_identifier) attrs["respan.threads.thread_identifier"] = span.thread_identifier;
     if (span.customer_identifier) attrs["respan.customer_params.customer_identifier"] = span.customer_identifier;
     if (span.span_workflow_name) attrs["traceloop.workflow.name"] = span.span_workflow_name;
@@ -340,7 +341,7 @@ function toOtlpPayload(spans) {
         })
       },
       scopeSpans: [{
-        scope: { name: "respan-cli-hooks", version: "0.7.0" },
+        scope: { name: "respan-cli-hooks", version: "0.7.1" },
         spans: otlpSpans
       }]
     }]
@@ -573,6 +574,7 @@ function createSpans(sessionId, turnNum, turn, config) {
   const rootSpanId = `codexcli_${traceUniqueId}_root`;
   spans.push({
     trace_unique_id: traceUniqueId,
+    session_identifier: threadId,
     thread_identifier: threadId,
     customer_identifier: customerId,
     span_unique_id: rootSpanId,

package/dist/hooks/codex-cli.js

@@ -222,6 +222,7 @@ function createSpans(sessionId, turnNum, turn, config) {
     const rootSpanId = `codexcli_${traceUniqueId}_root`;
     spans.push({
         trace_unique_id: traceUniqueId,
+        session_identifier: threadId,
         thread_identifier: threadId,
         customer_identifier: customerId,
         span_unique_id: rootSpanId,

package/dist/hooks/gemini-cli.cjs

@@ -258,6 +258,7 @@ function stringToSpanId(s) {
 function toOtlpPayload(spans) {
   const otlpSpans = spans.map((span) => {
     const attrs = {};
+    if (span.session_identifier) attrs["respan.sessions.session_identifier"] = span.session_identifier;
     if (span.thread_identifier) attrs["respan.threads.thread_identifier"] = span.thread_identifier;
     if (span.customer_identifier) attrs["respan.customer_params.customer_identifier"] = span.customer_identifier;
     if (span.span_workflow_name) attrs["traceloop.workflow.name"] = span.span_workflow_name;
@@ -318,7 +319,7 @@ function toOtlpPayload(spans) {
         })
       },
       scopeSpans: [{
-        scope: { name: "respan-cli-hooks", version: "0.7.0" },
+        scope: { name: "respan-cli-hooks", version: "0.7.1" },
         spans: otlpSpans
       }]
     }]
@@ -492,6 +493,7 @@ function buildSpans(hookData, outputText, tokens, config, startTimeIso, toolTurn
   const metadata = buildMetadata(config, baseMeta);
   spans.push({
     trace_unique_id: traceUniqueId,
+    session_identifier: threadId,
     thread_identifier: threadId,
     customer_identifier: customerId,
     span_unique_id: rootSpanId,

package/dist/hooks/gemini-cli.js

@@ -201,6 +201,7 @@ function buildSpans(hookData, outputText, tokens, config, startTimeIso, toolTurn
     // Root span
     spans.push({
         trace_unique_id: traceUniqueId,
+        session_identifier: threadId,
         thread_identifier: threadId,
         customer_identifier: customerId,
         span_unique_id: rootSpanId,

package/dist/hooks/shared.d.ts

@@ -15,6 +15,7 @@ export interface SpanData {
     span_name: string;
     span_workflow_name: string;
     span_path?: string;
+    session_identifier?: string;
     thread_identifier?: string;
     customer_identifier?: string;
     model?: string;

package/dist/hooks/shared.js

@@ -315,6 +315,8 @@ export function toOtlpPayload(spans) {
         // Build OTEL-compatible attributes from SpanData fields
         const attrs = {};
         // Respan-specific attributes
+        if (span.session_identifier)
+            attrs['respan.sessions.session_identifier'] = span.session_identifier;
         if (span.thread_identifier)
             attrs['respan.threads.thread_identifier'] = span.thread_identifier;
         if (span.customer_identifier)
@@ -395,7 +397,7 @@ export function toOtlpPayload(spans) {
                     }),
                 },
                 scopeSpans: [{
-                        scope: { name: 'respan-cli-hooks', version: '0.7.0' },
+                        scope: { name: 'respan-cli-hooks', version: '0.7.1' },
                         spans: otlpSpans,
                     }],
             }],

package/dist/lib/integrate.d.ts

@@ -3,6 +3,8 @@ export declare const DEFAULT_BASE_URL = "https://api.respan.ai/api";
 export declare const integrateFlags: {
     local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/lib/integrate.js

@@ -19,6 +19,16 @@ export const integrateFlags = {
         default: false,
         exclusive: ['local'],
     }),
+    enable: Flags.boolean({
+        description: 'Enable tracing (default)',
+        default: false,
+        exclusive: ['disable'],
+    }),
+    disable: Flags.boolean({
+        description: 'Disable tracing',
+        default: false,
+        exclusive: ['enable'],
+    }),
     'project-id': Flags.string({
         description: 'Respan project ID (added to metadata / resource attributes)',
         env: 'RESPAN_PROJECT_ID',