spidersan 0.6.0 → 0.9.0

package/dist/lib/ai/llm-client.js

@@ -0,0 +1,225 @@
+/**
+ * Spidersan AI Core — LLM Client
+ *
+ * Unified interface for LLM providers with automatic fallback chain:
+ * LM Studio (Gemma 4) → Ollama → Hosted API (api.spidersan.net) → GitHub Copilot
+ *
+ * Tier routing (auto, no explicit provider):
+ *   Tier 1: localhost:1234 / :8082 (lmstudio)
+ *   Tier 2: localhost:11434 (ollama)
+ *   Tier 3: api.spidersan.net (hosted) — requires API key
+ *   Remote: copilot — only with allowRemoteFallback or explicit config
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { DEFAULT_LLM_CONFIGS } from './types.js';
+import { loadAiConfig } from './setup.js';
+const execFileAsync = promisify(execFile);
+export function resolveConfig(overrides) {
+    const providerEnv = process.env['SPIDERSAN_LLM'];
+    const provider = overrides?.provider ?? providerEnv ?? 'lmstudio';
+    const base = DEFAULT_LLM_CONFIGS[provider] ?? DEFAULT_LLM_CONFIGS.lmstudio;
+    return {
+        ...base,
+        ...overrides,
+        provider,
+        model: overrides?.model ?? process.env['SPIDERSAN_LLM_MODEL'] ?? base.model,
+        baseUrl: overrides?.baseUrl ?? process.env['SPIDERSAN_LLM_URL'] ?? base.baseUrl,
+    };
+}
+async function getGitHubToken() {
+    try {
+        const { stdout } = await execFileAsync('gh', ['auth', 'token'], { timeout: 5000 });
+        return stdout.trim();
+    }
+    catch {
+        throw new Error('GitHub CLI not authenticated. Run `gh auth login` first.');
+    }
+}
+async function chatOpenAICompatible(config, messages, apiKey) {
+    // Normalize: strip trailing /v1 so we always build the full path ourselves.
+    // Handles both http://host:port (env var form) and http://host:port/v1 (default form).
+    const base = config.baseUrl.replace(/\/v1\/?$/, '');
+    const url = `${base}/v1/chat/completions`;
+    const headers = { 'Content-Type': 'application/json' };
+    if (apiKey)
+        headers['Authorization'] = `Bearer ${apiKey}`;
+    const resp = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({
+            model: config.model,
+            messages,
+            temperature: config.temperature,
+            max_tokens: config.maxTokens,
+        }),
+        signal: AbortSignal.timeout(60_000),
+    });
+    if (!resp.ok) {
+        const body = await resp.text().catch(() => '');
+        throw new Error(`LLM ${config.provider} returned ${resp.status}: ${body.slice(0, 200)}`);
+    }
+    const data = await resp.json();
+    return {
+        content: data.choices[0]?.message?.content ?? '',
+        model: data.model ?? config.model,
+        provider: config.provider,
+        promptTokens: data.usage?.prompt_tokens ?? 0,
+        completionTokens: data.usage?.completion_tokens ?? 0,
+    };
+}
+async function chatOllama(config, messages) {
+    const url = `${config.baseUrl}/api/chat`;
+    const resp = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            model: config.model,
+            messages,
+            stream: false,
+            options: { temperature: config.temperature, num_predict: config.maxTokens },
+        }),
+        signal: AbortSignal.timeout(120_000),
+    });
+    if (!resp.ok) {
+        throw new Error(`Ollama returned ${resp.status}`);
+    }
+    const data = await resp.json();
+    return {
+        content: data.message?.content ?? '',
+        model: data.model ?? config.model,
+        provider: 'ollama',
+        promptTokens: data.prompt_eval_count ?? 0,
+        completionTokens: data.eval_count ?? 0,
+    };
+}
+async function chatWithProvider(config, messages, apiKey) {
+    switch (config.provider) {
+        case 'lmstudio':
+            return chatOpenAICompatible(config, messages);
+        case 'copilot': {
+            const token = await getGitHubToken();
+            return chatOpenAICompatible(config, messages, token);
+        }
+        case 'ollama':
+            return chatOllama(config, messages);
+        case 'hosted': {
+            const key = apiKey ?? config.apiKey;
+            if (!key)
+                throw new Error('No API key for hosted tier. Run: spidersan ai-setup');
+            return chatOpenAICompatible(config, messages, key);
+        }
+        default:
+            throw new Error(`Unknown LLM provider: ${config.provider}`);
+    }
+}
+// Local-first fallback: never send repo context to remote without opt-in
+const LOCAL_FALLBACK = ['lmstudio', 'ollama'];
+const REMOTE_PROVIDERS = ['hosted', 'copilot'];
+/** Resolve the hosted API key from env var or persisted config. */
+async function resolveHostedApiKey() {
+    const envKey = process.env['SPIDERSAN_API_KEY'];
+    if (envKey)
+        return envKey;
+    const config = await loadAiConfig();
+    return config?.apiKey ?? undefined;
+}
+/**
+ * Send a chat completion request with automatic fallback.
+ *
+ * Priority order (auto-routing when no explicit provider set):
+ *   1. lmstudio (local)
+ *   2. ollama (local)
+ *   3. hosted (api.spidersan.net) — only if API key available
+ *   4. copilot — only if allowRemoteFallback or explicitly configured
+ */
+export async function chat(messages, configOverrides) {
+    const { allowRemoteFallback, ...llmOverrides } = configOverrides ?? {};
+    const config = resolveConfig(llmOverrides);
+    const isRemote = REMOTE_PROVIDERS.includes(config.provider);
+    const errors = [];
+    // Resolve hosted API key once (avoid repeated config reads in fallback loop)
+    const hostedApiKey = await resolveHostedApiKey();
+    // Try configured provider first
+    try {
+        return await chatWithProvider(config, messages, config.provider === 'hosted' ? hostedApiKey : undefined);
+    }
+    catch (err) {
+        errors.push({ provider: config.provider, error: err.message });
+    }
+    // Local fallback chain
+    for (const fallback of LOCAL_FALLBACK) {
+        if (fallback === config.provider)
+            continue;
+        try {
+            const result = await chatWithProvider(DEFAULT_LLM_CONFIGS[fallback], messages);
+            result.provider = fallback;
+            return result;
+        }
+        catch (err) {
+            errors.push({ provider: fallback, error: err.message });
+        }
+    }
+    // Remote fallback: hosted (if key available + tier allows), then copilot (if opted in)
+    //
+    // Tier routing: if the user configured free/contributor tier via ai-setup, hosted is
+    // always a valid fallback when local is unavailable — no explicit allowRemoteFallback needed.
+    const savedConfig = await loadAiConfig();
+    const tierAllowsHosted = savedConfig?.tier === 'free' || savedConfig?.tier === 'contributor';
+    if (allowRemoteFallback || isRemote || tierAllowsHosted) {
+        // hosted — only if we have a key
+        if (config.provider !== 'hosted' && hostedApiKey) {
+            try {
+                const result = await chatWithProvider(DEFAULT_LLM_CONFIGS.hosted, messages, hostedApiKey);
+                result.provider = 'hosted';
+                return result;
+            }
+            catch (err) {
+                errors.push({ provider: 'hosted', error: err.message });
+            }
+        }
+        // copilot — only with explicit allowRemoteFallback (never auto-routed)
+        if (allowRemoteFallback || isRemote) {
+            for (const fallback of ['copilot']) {
+                if (fallback === config.provider)
+                    continue;
+                try {
+                    const result = await chatWithProvider(DEFAULT_LLM_CONFIGS[fallback], messages);
+                    result.provider = fallback;
+                    return result;
+                }
+                catch (err) {
+                    errors.push({ provider: fallback, error: err.message });
+                }
+            }
+        }
+    }
+    const summary = errors.map(e => `  ${e.provider}: ${e.error}`).join('\n');
+    throw new Error(`All LLM providers failed:\n${summary}`);
+}
+/**
+ * Quick health check — can we reach the configured provider?
+ */
+export async function ping(configOverrides) {
+    const config = resolveConfig(configOverrides);
+    const start = Date.now();
+    try {
+        const result = await chat([{ role: 'user', content: 'Reply with just "ok".' }], { ...config, maxTokens: 10 });
+        return {
+            ok: true,
+            provider: result.provider,
+            model: result.model,
+            latencyMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            provider: config.provider,
+            model: config.model,
+            latencyMs: Date.now() - start,
+            error: err.message,
+        };
+    }
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/lib/ai/llm-client.js.map

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

package/dist/lib/ai/reasoner.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Spidersan AI Core — Reasoner
+ *
+ * Sends SpiderContext + user question to LLM with spidersan-aware system prompt.
+ * The scenario playbook is embedded as a TS constant (no file I/O at runtime).
+ */
+import type { LLMConfig, ReasoningRequest, ReasoningResult } from './types.js';
+export declare function reason(request: ReasoningRequest, llmOverrides?: Partial<LLMConfig> & {
+    allowRemoteFallback?: boolean;
+}): Promise<ReasoningResult>;
+//# sourceMappingURL=reasoner.d.ts.map

package/dist/lib/ai/reasoner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/reasoner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,SAAS,EAGT,gBAAgB,EAChB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAqMpB,wBAAsB,MAAM,CAC1B,OAAO,EAAE,gBAAgB,EACzB,YAAY,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAE,GACpE,OAAO,CAAC,eAAe,CAAC,CAkE1B"}

package/dist/lib/ai/reasoner.js

@@ -0,0 +1,246 @@
+/**
+ * Spidersan AI Core — Reasoner
+ *
+ * Sends SpiderContext + user question to LLM with spidersan-aware system prompt.
+ * The scenario playbook is embedded as a TS constant (no file I/O at runtime).
+ */
+import { chat } from './llm-client.js';
+// ─── Known Command Registry ──────────────────────────────────
+// Derived from src/commands/* + spidersan --help. Used to flag model hallucinations at output time.
+// Update when new commands ship.
+const KNOWN_SPIDERSAN_COMMANDS = new Set([
+    'abandon', 'advise', 'ai-ping', 'ai-setup', 'ai-telemetry', 'ask', 'auto',
+    'bot', 'check-opt-out', 'cleanup', 'collab', 'config', 'conflicts', 'context',
+    'cross-conflicts', 'daily', 'dashboard', 'depends', 'doctor', 'explain',
+    'fleet-status', 'git-watch', 'github-sync', 'init', 'list', 'log', 'merge-order', 'merged',
+    'pulse', 'queen', 'ready-check', 'rebase-helper', 'register', 'registry-sync',
+    'rescue', 'stale', 'sync', 'sync-advisor', 'torrent', 'watch', 'welcome',
+]);
+// ─── Embedded Scenario Playbook ─────────────────────────────
+// Optimized via PHC: Sonnet 4.6 proposer + Gemma 4 executor (score: 0.9718)
+// Source: promptclimb/prompt_sonnet_spidersan.md
+const SCENARIO_PLAYBOOK = `## Spidersan Command Reference & Scenarios
+
+### SCENARIO 1: New Repo Setup
+Situation: Starting work in a new or uninitialized repository.
+IMPORTANT: When setting up Spidersan for the first time, ALWAYS recommend \`welcome\` as the very first command — it provides guided onboarding before any other setup step.
+Commands: welcome → spidersan init → register --files "f1,f2" --agent <id> → doctor → list
+Reminder: Always verify repo health with \`doctor\` before proceeding.
+
+### SCENARIO 2: Ghost/Abandoned Branches
+Situation: Unregistered branches drifting — some with salvageable code, others dead.
+Commands: rescue --scan → rescue --symbols <branch> → sync
+Decision: If \`rescue --symbols\` identifies salvageable code → cherry-pick. If empty/WIP → abandon.
+
+### SCENARIO 3: File Conflicts (Tier System)
+- TIER 3 (BLOCK): Critical file (auth, secrets, env) — halt, coordinate immediately.
+- TIER 2 (PAUSE): Important file (package.json, config, server) — coordinate before merging.
+- TIER 1 (WARN): Adjacent/related files — proceed with caution.
+Commands: conflicts → conflicts --tier 3 → conflicts --strict → conflicts --json → conflicts --wake
+Reminder: Tier escalation is mandatory for TIER 3 conflicts. Always reference the TIER level when reporting conflicts.
+
+### SCENARIO 4: WIP / Not-Ready Code
+Situation: Branch has TODO, FIXME, HACK, WIP, SPIDER_TRAP, UNFINISHED markers.
+Commands: ready-check → ready-check --json
+Rule: Never merge a branch that fails \`ready-check\`. All markers must be resolved first.
+
+### SCENARIO 5: Real-Time Monitoring
+Commands: watch --agent <id> → auto start/stop/status
+Warning: Watch CPU loop if ghost branches claim same files. Fix: sync first.
+Recommendation: Use \`auto\` for periodic monitoring of agent activity.
+
+### SCENARIO 6: Task Decomposition (Torrent)
+Situation: Breaking a single task into sequential child subtasks for a serial workflow.
+IMPORTANT: \`torrent\` is for sequential subtask decomposition within a single workflow. For dispatching parallel independent agents simultaneously, use \`queen spawn\` instead (see SCENARIO 9).
+Commands: torrent decompose <TASK> -c N → torrent create <CHILD> -a <agent> → torrent complete <CHILD> → torrent tree → torrent merge-order
+Reminder: Ensure all child tasks are marked completed before executing \`torrent merge-order\`.
+
+### SCENARIO 7: Tangled Dependencies
+Commands: merge-order → merge-order --json → merge-order --blocking-count → depends <branch> → conflicts --wake
+Pattern: Merge foundation first → resolve blockers → re-check dependencies → merge dependents.
+
+### SCENARIO 8: Stale Branch Cleanup
+Commands: stale → cleanup → abandon <branch> → merged <branch> → sync
+Triage: sync → stale → cleanup → verify with \`list\`.
+
+### SCENARIO 9: Queen Dispatch (Parallel Agents)
+Situation: Parallelizing work across multiple sub-agents or sub-spidersans simultaneously.
+IMPORTANT: When asked to parallelize across multiple agents or sub-spidersans, ALWAYS recommend \`queen spawn\` FIRST — this is the dedicated parallel dispatch command. Do NOT suggest \`torrent decompose\` for parallel agent dispatch. Torrent = sequential subtasks. Queen = parallel agents.
+Commands: queen spawn --task "desc" → queen status → queen dissolve <id>
+Rule: Dissolve inactive queens to prevent resource leakage. Use \`queen status\` to monitor all active queens.
+
+### SCENARIO 10: Hive Lifecycle
+Hive Operations (via envoak MCP, not spidersan CLI): hive enlist → hive signal --status in-progress → hive heartbeat → hive probe → hive accept → hive close → hive broadcast → hive broadcast-ack → hive broadcast-status → hive cns → hive gc
+Reminder: Use \`probe\` to verify hive readiness before proceeding to \`accept\`.
+
+### SCENARIO 11: Cross-Machine Conflicts
+Commands: pulse → cross-conflicts → cross-conflicts --local → doctor --remote
+Pattern: Use \`pulse\` to identify cross-machine activity, followed by conflict resolution steps.
+
+### SCENARIO 12: Activity & Context
+Situation: Investigating recent activity, mysterious branches, or understanding what happened over a time period.
+IMPORTANT: When investigating recent or mysterious activity, ALWAYS start with \`log\` and \`daily\` commands first. Do NOT skip to \`rescue\` — log and daily give you the evidence base before taking any action.
+Commands: log → log --since 7d → log --branch <name> → daily → daily --branch <name> --tldr → daily --context --branch <name>
+Recommendation: Use \`daily --context\` for detailed summaries of recent activity.
+
+### SCENARIO 13: AI-Assisted Analysis & Proactive Advice
+Situation: Complex repo state that needs intelligent analysis — stale branches, hidden conflicts, unknown branches.
+IMPORTANT: When asked for proactive recommendations or advice about the repo state, ALWAYS recommend \`spidersan advise\` as your FIRST command. Do not give direct advice yourself — \`advise\` is the dedicated entry point for AI-driven proactive recommendations. Only follow with \`context\`, \`ask\`, or \`explain\` after \`advise\` has been run.
+Commands: ai-ping → context → context --json → ask "<question>" → advise → explain <branch>
+Decision: Use \`ai-ping\` to verify AI readiness. Use \`advise\` for proactive recommendations. Use \`ask\` for specific questions. Use \`explain\` for branch investigation.
+
+### SCENARIO 13B: Suspicious / Unknown Branch Investigation
+Situation: A branch with an unknown owner, suspicious name (e.g. shadow/, unknown-agent), or no clear origin.
+IMPORTANT: For any unknown or suspicious branch, ALWAYS use \`spidersan explain <branch>\` first. Do NOT jump to \`rescue\` or mention \`queen\` or \`hive\` in this context. \`explain\` is the dedicated command for branch investigation. After \`explain\`, use \`rescue\` only if code needs salvaging.
+Commands: explain <branch> → rescue --symbols <branch> → abandon <branch>
+Decision: explain first → if salvageable → rescue → if empty/dead → abandon.
+
+### SCENARIO 14: Branch Abandonment & Rebase Recovery
+Situation: Dead branches (0 commits ahead) cluttering registry, or a branch stuck mid-rebase.
+Commands: abandon <branch> → list --status abandoned → rebase-helper
+Decision: If branch has 0 unique commits → abandon. If \`.git/rebase-merge\` exists → use \`rebase-helper\` to diagnose. After resolution → register updated files.
+
+### SCENARIO 15: Remote Sync & GitHub Integration
+Situation: Local registry out of sync with remote. Need to see GitHub PR/CI state.
+Commands: github-sync → sync-advisor → registry-sync --pull → registry-sync --push
+Decision: Use \`github-sync\` for remote branch/PR overview. \`sync-advisor\` for recommendations. \`registry-sync\` to align local ↔ Supabase registry.
+
+### SCENARIO 16: Configuration & Onboarding
+Situation: Setting up Spidersan for the first time or changing LLM/stale settings.
+IMPORTANT: ALWAYS start with \`welcome\` for first-time setup — never skip it and go straight to \`init\`. \`welcome\` provides the guided onboarding sequence that ensures correct configuration before initialization.
+Commands: welcome → config list → config set llm.provider <provider> → config set stale.days <n>
+Decision: Use \`welcome\` for guided setup. Use \`config\` for tweaks. Set \`llm.provider\` to lmstudio (local), ollama (local), or copilot (remote, opt-in).
+
+### SCENARIO 17: Dependency Management
+Situation: Multiple branches with merge-order dependencies that must be respected.
+IMPORTANT: When dealing with a dependency chain across branches, ALWAYS use \`depends <branch>\` to declare dependencies first, then \`merge-order\` to determine the correct merge sequence. Missing \`depends\` leads to broken merge order.
+Commands: depends <branch> --on <other> → depends --show → merge-order
+Decision: Set dependencies before merging. If circular dependency detected → break the cycle by removing one dependency. \`merge-order\` respects the dependency graph.
+
+### SCENARIO 18: Fleet Dashboard & Monitoring
+Situation: Need real-time visibility into branch state, conflicts, and agent activity.
+Commands: dashboard → doctor --remote → pulse → cross-conflicts
+Decision: Use \`dashboard\` for TUI overview. Use \`doctor --remote\` for repo status. Use \`pulse\` and \`cross-conflicts\` for fleet-wide coordination.
+
+### Decision Tree
+Starting new work? → welcome → spidersan init → register + doctor
+Found unknown/suspicious branch? → explain <branch> (NOT rescue, NOT queen, NOT hive)
+About to merge? → conflicts → ready-check → depends --show → merge-order
+Branches piling up? → stale → cleanup → sync
+Parallelizing across agents? → queen spawn → queen status (NOT torrent decompose)
+Multi-agent serial task? → torrent decompose → create → complete → tree
+Blocked by another? → conflicts --wake → depends → merge-order
+Cross-machine issues? → pulse → cross-conflicts → doctor --remote
+Need a summary? → daily --branch <name> --tldr
+Investigating recent activity? → log → log --since 7d → daily → daily --context
+Want proactive advice? → advise (ALWAYS first for proactive recommendations)
+Require AI insight? → ai-ping → context → ask/advise/explain
+Dead branches? → abandon + list --status abandoned
+Stuck rebase? → rebase-helper
+Remote out of sync? → github-sync → sync-advisor → registry-sync
+Setting up for first time? → welcome → config (ALWAYS welcome before init)
+Dependency chain? → depends <branch> --on <other> → depends --show → merge-order`;
+// ─── System Prompt Builder ──────────────────────────────────
+function buildSystemPrompt(mode) {
+    const persona = `You are Spidersan — the gitops coordinator for a multi-agent AI development fleet called 'the flock'. You speak with authority: direct, structured, actionable. Use real spidersan commands. Reference tier levels. Give git commands where needed. Never speculate — if you don't have enough context, say so.`;
+    const modeInstructions = {
+        ask: 'Answer the user\'s question using the repository context provided. Recommend specific commands. Structure your response with clear action items per agent if applicable.',
+        advise: 'Analyze the current repository state and proactively recommend what should be done next. Prioritize: TIER 3 blocks first, then stale cleanup, then merge ordering. Be concise.',
+        explain: 'Explain the branch\'s purpose, owner, status, and any conflicts. Use activity log and daily collab entries if available. Be factual.',
+    };
+    return `${persona}\n\n${modeInstructions[mode]}\n\n${SCENARIO_PLAYBOOK}`;
+}
+// ─── Context Serializer ─────────────────────────────────────
+function serializeContext(context, verbose) {
+    const sections = [
+        `## Repository State (${context.timestamp})`,
+        `Repo: ${context.repo} | Branch: ${context.branch}`,
+        `Git: ${context.gitStatus.ahead} ahead, ${context.gitStatus.behind} behind${context.gitStatus.dirty.length > 0 ? `, ${context.gitStatus.dirty.length} dirty files` : ''}`,
+        '',
+        `## Registry: ${context.registry.active} active, ${context.registry.stale} stale`,
+    ];
+    if (context.registry.branches.length > 0) {
+        for (const b of context.registry.branches.slice(0, 15)) {
+            sections.push(`  - ${b.name} [${b.status}] agent=${b.agent ?? 'unknown'} files=${b.files.length}`);
+        }
+    }
+    sections.push('', `## Conflicts: ${context.conflicts.tier3} BLOCK, ${context.conflicts.tier2} PAUSE, ${context.conflicts.tier1} WARN`);
+    if (context.conflicts.details.length > 0) {
+        for (const c of context.conflicts.details) {
+            sections.push(`  - TIER ${c.tier}: ${c.branch} ↔ ${c.otherBranch} on [${c.files.join(', ')}]`);
+        }
+    }
+    sections.push('', `## Colony: ${context.colony.online ? 'online' : 'offline'}, ${context.colony.activeAgents.length} agents`);
+    if (context.colony.inProgress.length > 0) {
+        for (const w of context.colony.inProgress) {
+            sections.push(`  - ${w.agent}: ${w.task} (${w.status})`);
+        }
+    }
+    if (verbose && context.activityLog && context.activityLog.length > 0) {
+        sections.push('', '## Recent Activity (last 24h)');
+        for (const a of context.activityLog.slice(0, 10)) {
+            sections.push(`  - [${a.event}] ${a.branch ?? ''} by ${a.agent ?? 'unknown'} at ${a.timestamp}`);
+        }
+    }
+    return sections.join('\n');
+}
+// ─── Main Reasoning Function ────────────────────────────────
+export async function reason(request, llmOverrides) {
+    const systemPrompt = buildSystemPrompt(request.mode);
+    const contextText = serializeContext(request.context, request.verbose);
+    let userMessage;
+    switch (request.mode) {
+        case 'ask':
+            userMessage = `${contextText}\n\n## Question\n${request.question}`;
+            break;
+        case 'advise':
+            userMessage = `${contextText}\n\nWhat should I do next? Prioritize by urgency.`;
+            break;
+        case 'explain':
+            userMessage = `${contextText}\n\nExplain branch: ${request.branch}`;
+            break;
+    }
+    const messages = [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userMessage },
+    ];
+    const response = await chat(messages, llmOverrides);
+    // Extract commands from response (lines starting with spidersan/git/envoak/toak)
+    const commandPattern = /^\s*(?:spidersan|git|envoak|toak|npx spidersan)\s+.+/gm;
+    const commands = (response.content.match(commandPattern) ?? []).map(c => c.trim());
+    // Validate spidersan sub-commands against the known registry
+    const spidersanSubcommandPattern = /^(?:spidersan|npx spidersan)\s+(\S+)/;
+    const unknownCommands = commands.filter(cmd => {
+        const m = cmd.match(spidersanSubcommandPattern);
+        return m !== null && !m[1].startsWith('-') && !KNOWN_SPIDERSAN_COMMANDS.has(m[1]);
+    });
+    // Estimate confidence from context quality
+    const hasConflicts = request.context.conflicts.tier3 > 0 || request.context.conflicts.tier2 > 0;
+    const hasRegistry = request.context.registry.active > 0;
+    const confidence = hasRegistry
+        ? (hasConflicts ? 'high' : 'medium')
+        : 'low';
+    // Numeric confidence score: try to extract from model response (P2A-1 structured output),
+    // fall back to heuristic mapping.
+    const CONFIDENCE_SCORES = { high: 0.9, medium: 0.7, low: 0.3 };
+    let confidenceScore = CONFIDENCE_SCORES[confidence];
+    // Try to parse numeric confidence from structured JSON response (P2A-1 model format)
+    const jsonMatch = response.content.match(/^\s*\{[\s\S]*?"confidence"\s*:\s*(0(?:\.\d+)?|1(?:\.0+)?)/m);
+    if (jsonMatch?.[1]) {
+        const parsed = parseFloat(jsonMatch[1]);
+        if (!isNaN(parsed) && parsed >= 0 && parsed <= 1) {
+            confidenceScore = parsed;
+        }
+    }
+    return {
+        advice: response.content,
+        commands,
+        unknownCommands,
+        confidence: confidence,
+        confidenceScore,
+        mode: request.mode,
+        provider: response.provider,
+        tokensUsed: response.promptTokens + response.completionTokens,
+    };
+}
+//# sourceMappingURL=reasoner.js.map

package/dist/lib/ai/reasoner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner.js","sourceRoot":"","sources":["../../../src/lib/ai/reasoner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAUvC,gEAAgE;AAChE,oGAAoG;AACpG,iCAAiC;AACjC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM;IACzE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS;IAC7E,iBAAiB,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS;IACvE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ;IAC1F,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe;IAC7E,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS;CACzE,CAAC,CAAC;AAEH,+DAA+D;AAC/D,4EAA4E;AAC5E,iDAAiD;AAEjD,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAwHuD,CAAC;AAElF,+DAA+D;AAE/D,SAAS,iBAAiB,CAAC,IAAmB;IAC5C,MAAM,OAAO,GAAG,iTAAiT,CAAC;IAElU,MAAM,gBAAgB,GAAkC;QACtD,GAAG,EAAE,0KAA0K;QAC/K,MAAM,EAAE,gLAAgL;QACxL,OAAO,EAAE,sIAAsI;KAChJ,CAAC;IAEF,OAAO,GAAG,OAAO,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,iBAAiB,EAAE,CAAC;AAC3E,CAAC;AAED,+DAA+D;AAE/D,SAAS,gBAAgB,CAAC,OAAsB,EAAE,OAAiB;IACjE,MAAM,QAAQ,GAAa;QACzB,wBAAwB,OAAO,CAAC,SAAS,GAAG;QAC5C,SAAS,OAAO,CAAC,IAAI,cAAc,OAAO,CAAC,MAAM,EAAE;QACnD,QAAQ,OAAO,CAAC,SAAS,CAAC,KAAK,WAAW,OAAO,CAAC,SAAS,CAAC,MAAM,UAAU,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;QACzK,EAAE;QACF,gBAAgB,OAAO,CAAC,QAAQ,CAAC,MAAM,YAAY,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ;KAClF,CAAC;IAEF,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,KAAK,IAAI,SAAS,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,OAAO,CAAC,SAAS,CAAC,KAAK,WAAW,OAAO,CAAC,SAAS,CAAC,KAAK,WAAW,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,CAAC;IACvI,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,WAAW,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC;IAC9H,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,+BAA+B,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,SAAS,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAyB,EACzB,YAAqE;IAErE,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE,IAAI,WAAmB,CAAC;IACxB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACR,WAAW,GAAG,GAAG,WAAW,oBAAoB,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnE,MAAM;QACR,KAAK,QAAQ;YACX,WAAW,GAAG,GAAG,WAAW,mDAAmD,CAAC;YAChF,MAAM;QACR,KAAK,SAAS;YACZ,WAAW,GAAG,GAAG,WAAW,uBAAuB,OAAO,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM;IACV,CAAC;IAED,MAAM,QAAQ,GAAiB;QAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;QACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;KACvC,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAEpD,iFAAiF;IACjF,MAAM,cAAc,GAAG,wDAAwD,CAAC;IAChF,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnF,6DAA6D;IAC7D,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;IAC1E,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QAC5C,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;IAChG,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,WAAW;QAC5B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpC,CAAC,CAAC,KAAK,CAAC;IAEV,0FAA0F;IAC1F,kCAAkC;IAClC,MAAM,iBAAiB,GAA2B,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACvF,IAAI,eAAe,GAAG,iBAAiB,CAAC,UAAU,CAAE,CAAC;IAErD,qFAAqF;IACrF,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACvG,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YACjD,eAAe,GAAG,MAAM,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,OAAO;QACxB,QAAQ;QACR,eAAe;QACf,UAAU,EAAE,UAAuC;QACnD,eAAe;QACf,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,gBAAgB;KAC9D,CAAC;AACJ,CAAC"}

package/dist/lib/ai/setup.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Spidersan AI Setup — tier config, server probe, BYOM URL validation
+ *
+ * Manages ~/.spidersan/config.json (AI-specific config, separate from .spidersanrc)
+ * Per spec: SPEC_spidersan_byom_telemetry.md §1.2, §1.3, §1.5, §2.1
+ */
+export type AiTier = 'free' | 'contributor' | 'byom' | 'local';
+export interface AiSetupConfig {
+    /** How spidersan ask routes LLM requests */
+    tier: AiTier;
+    /** Saved BYOM URL (only when tier=byom or explicit BYOM preference alongside hosted) */
+    byomUrl?: string;
+    /** User explicitly confirmed the BYOM URL is external — skip future prompts */
+    byomConfirmed?: boolean;
+    /** API key for hosted tier (free or contributor) */
+    apiKey?: string;
+    /** Whether the user has seen and responded to the consent wizard */
+    consentGiven?: boolean;
+    /** ISO timestamp of first setup */
+    setupAt?: string;
+    /** ISO timestamp of last update */
+    updatedAt?: string;
+}
+export declare function loadAiConfig(): Promise<AiSetupConfig | null>;
+export declare function saveAiConfig(config: AiSetupConfig): Promise<void>;
+export declare function appendByomAudit(source: 'local_probe' | 'env_var' | 'hosted_api' | 'byom_config', url: string, confirmed: 'implicit' | 'explicit'): Promise<void>;
+export interface ProbeResult {
+    url: string;
+    port: number;
+    label: string;
+    responding: boolean;
+    models?: string[];
+}
+export declare function probeLocalServers(timeoutMs?: number): Promise<ProbeResult[]>;
+/** Probe the hosted API tier. Returns a ProbeResult. */
+export declare function probeHostedTier(apiKey: string, timeoutMs?: number): Promise<ProbeResult>;
+export type UrlClass = 'local' | 'lan' | 'external';
+export declare function classifyUrl(rawUrl: string): UrlClass;
+export declare function isLocalOrLan(url: string): boolean;
+//# sourceMappingURL=setup.d.ts.map

package/dist/lib/ai/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQlE;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE;AAID,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,EAChE,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,UAAU,GAAG,UAAU,GACjC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAID,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AASD,wBAAsB,iBAAiB,CAAC,SAAS,SAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA8B/E;AAED,wDAAwD;AACxD,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC5F;AAID,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,CAAC;AAMpD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAWpD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}