spidersan 0.6.0 → 0.10.0

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":"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"}

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"}

package/dist/lib/ai/setup.js

@@ -0,0 +1,154 @@
+/**
+ * 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
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { HOSTED_API_BASE_URL } from './types.js';
+// ─── Paths ──────────────────────────────────────────────────
+const SPIDERSAN_HOME = join(homedir(), '.spidersan');
+const CONFIG_PATH = join(SPIDERSAN_HOME, 'config.json');
+const BYOM_AUDIT_PATH = join(SPIDERSAN_HOME, 'byom-audit.log');
+// ─── Config persistence ─────────────────────────────────────
+export async function loadAiConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return null;
+    try {
+        const raw = await readFile(CONFIG_PATH, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveAiConfig(config) {
+    await mkdir(SPIDERSAN_HOME, { recursive: true });
+    const updated = {
+        ...config,
+        updatedAt: new Date().toISOString(),
+        setupAt: config.setupAt ?? new Date().toISOString(),
+    };
+    await writeFile(CONFIG_PATH, JSON.stringify(updated, null, 2), { mode: 0o600 });
+}
+// ─── BYOM audit log ─────────────────────────────────────────
+export async function appendByomAudit(source, url, confirmed) {
+    const line = `${new Date().toISOString()}  source=${source}  url=${url}  confirmed=${confirmed}\n`;
+    try {
+        await mkdir(SPIDERSAN_HOME, { recursive: true });
+        const { appendFile } = await import('node:fs/promises');
+        await appendFile(BYOM_AUDIT_PATH, line);
+        // Rotate at 1 MB
+        const { stat } = await import('node:fs/promises');
+        const stats = await stat(BYOM_AUDIT_PATH);
+        if (stats.size > 1_000_000) {
+            const existing = await readFile(BYOM_AUDIT_PATH, 'utf8');
+            const lines = existing.split('\n');
+            // Keep last 500 lines
+            await writeFile(BYOM_AUDIT_PATH, lines.slice(-500).join('\n'));
+        }
+    }
+    catch {
+        // Audit log failure is never fatal
+    }
+}
+const LOCAL_PROBE_TARGETS = [
+    { port: 8095, label: 'spidersan model (mlx_lm.server)' },
+    { port: 8082, label: 'LM Studio (custom port)' },
+    { port: 11434, label: 'Ollama' },
+    { port: 1234, label: 'LM Studio (default)' },
+];
+export async function probeLocalServers(timeoutMs = 800) {
+    const results = await Promise.allSettled(LOCAL_PROBE_TARGETS.map(async ({ port, label }) => {
+        const url = `http://localhost:${port}/v1/models`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url, {
+                signal: controller.signal,
+                headers: { Accept: 'application/json' },
+            });
+            clearTimeout(timer);
+            if (!res.ok) {
+                return { url: `http://localhost:${port}/v1`, port, label, responding: false };
+            }
+            let models;
+            try {
+                const body = (await res.json());
+                models = body.data?.map((m) => m.id).slice(0, 3);
+            }
+            catch {
+                // model list parse failure is non-fatal
+            }
+            return { url: `http://localhost:${port}/v1`, port, label, responding: true, models };
+        }
+        catch {
+            clearTimeout(timer);
+            return { url: `http://localhost:${port}/v1`, port, label, responding: false };
+        }
+    }));
+    return results.map((r) => (r.status === 'fulfilled' ? r.value : null)).filter(Boolean);
+}
+/** Probe the hosted API tier. Returns a ProbeResult. */
+export async function probeHostedTier(apiKey, timeoutMs = 2000) {
+    const base = HOSTED_API_BASE_URL;
+    const url = `${base}/models`;
+    const label = 'Hosted API (spidersan-api-proxy)';
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            signal: controller.signal,
+            headers: {
+                Accept: 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+        });
+        clearTimeout(timer);
+        if (res.status === 401) {
+            return { url: base, port: 443, label, responding: false };
+        }
+        if (!res.ok) {
+            return { url: base, port: 443, label, responding: false };
+        }
+        let models;
+        try {
+            const body = (await res.json());
+            models = body.data?.map((m) => m.id).slice(0, 3);
+        }
+        catch {
+            // non-fatal
+        }
+        return { url: base, port: 443, label, responding: true, models };
+    }
+    catch {
+        clearTimeout(timer);
+        return { url: base, port: 443, label, responding: false };
+    }
+}
+const LAN_PREFIXES = ['192.168.', '10.', '172.16.', '172.17.', '172.18.', '172.19.',
+    '172.20.', '172.21.', '172.22.', '172.23.', '172.24.', '172.25.', '172.26.',
+    '172.27.', '172.28.', '172.29.', '172.30.', '172.31.'];
+export function classifyUrl(rawUrl) {
+    try {
+        const parsed = new URL(rawUrl);
+        const host = parsed.hostname;
+        if (host === 'localhost' || host === '127.0.0.1' || host === '::1')
+            return 'local';
+        if (host.endsWith('.local'))
+            return 'lan';
+        if (LAN_PREFIXES.some((prefix) => host.startsWith(prefix)))
+            return 'lan';
+        return 'external';
+    }
+    catch {
+        return 'external';
+    }
+}
+export function isLocalOrLan(url) {
+    return classifyUrl(url) !== 'external';
+}
+//# sourceMappingURL=setup.js.map

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

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

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

@@ -0,0 +1,135 @@
+/**
+ * Spidersan AI Core — Type Definitions
+ *
+ * Shared types for context aggregation, LLM reasoning, and event handling.
+ * Used by CLI (ask/advise/explain), MCP tools, webhook, and agent mode.
+ */
+export interface BranchSummary {
+    name: string;
+    agent: string | null;
+    files: string[];
+    status: 'active' | 'merged' | 'abandoned' | 'completed';
+    lastUpdated: string;
+    commitsBehindMain: number;
+}
+export interface ConflictSummary {
+    branch: string;
+    otherBranch: string;
+    tier: 1 | 2 | 3;
+    files: string[];
+    agent: string | null;
+    otherAgent: string | null;
+}
+export interface WorkSignal {
+    agent: string;
+    task: string;
+    status: string;
+    lastHeartbeat: string;
+}
+export interface ActivityEntry {
+    event: string;
+    branch: string | null;
+    agent: string | null;
+    details: Record<string, unknown>;
+    timestamp: string;
+}
+export interface DailyEntry {
+    agent: string;
+    content: string;
+    timestamp: string;
+}
+export interface SpiderContext {
+    timestamp: string;
+    repo: string;
+    branch: string;
+    registry: {
+        active: number;
+        stale: number;
+        branches: BranchSummary[];
+    };
+    conflicts: {
+        tier1: number;
+        tier2: number;
+        tier3: number;
+        details: ConflictSummary[];
+    };
+    gitStatus: {
+        ahead: number;
+        behind: number;
+        dirty: string[];
+    };
+    colony: {
+        online: boolean;
+        activeAgents: string[];
+        inProgress: WorkSignal[];
+    };
+    activityLog?: ActivityEntry[];
+    dailyCollab?: DailyEntry[];
+}
+export type LLMProvider = 'lmstudio' | 'copilot' | 'ollama' | 'hosted';
+export interface LLMConfig {
+    provider: LLMProvider;
+    model: string;
+    baseUrl: string;
+    apiKey?: string;
+    temperature: number;
+    maxTokens: number;
+}
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMResponse {
+    content: string;
+    model: string;
+    provider: LLMProvider;
+    promptTokens: number;
+    completionTokens: number;
+}
+export type ReasoningMode = 'ask' | 'advise' | 'explain';
+export interface ReasoningRequest {
+    mode: ReasoningMode;
+    question?: string;
+    branch?: string;
+    context: SpiderContext;
+    verbose?: boolean;
+}
+export interface ReasoningResult {
+    advice: string;
+    commands: string[];
+    /** Commands suggested by the model that are not in the known spidersan CLI. Empty = all validated. */
+    unknownCommands: string[];
+    confidence: 'high' | 'medium' | 'low';
+    /** Numeric confidence score 0.0–1.0. Values below 0.7 trigger a "review manually" warning. */
+    confidenceScore: number;
+    mode: ReasoningMode;
+    provider: LLMProvider;
+    tokensUsed: number;
+}
+export type EventType = 'push' | 'pull_request' | 'colony_signal' | 'branch_register';
+export interface EventPayload {
+    type: EventType;
+    repo: string;
+    branch?: string;
+    agent?: string;
+    files?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface Advice {
+    tier: 0 | 1 | 2 | 3;
+    action: 'info' | 'warn' | 'pause' | 'block';
+    message: string;
+    commands: string[];
+    escalateToLLM: boolean;
+}
+export interface AIConfig {
+    llm: LLMConfig;
+    enableColony: boolean;
+    enableMemoak: boolean;
+    enableDailyBridge: boolean;
+    playbookPath?: string;
+}
+/** Canonical hosted API base URL — shared between types, setup probe, and llm-client. */
+export declare const HOSTED_API_BASE_URL = "https://api.spidersan.net/v1";
+export declare const DEFAULT_LLM_CONFIGS: Record<LLMProvider, LLMConfig>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/ai/types.js

@@ -0,0 +1,39 @@
+/**
+ * Spidersan AI Core — Type Definitions
+ *
+ * Shared types for context aggregation, LLM reasoning, and event handling.
+ * Used by CLI (ask/advise/explain), MCP tools, webhook, and agent mode.
+ */
+/** Canonical hosted API base URL — shared between types, setup probe, and llm-client. */
+export const HOSTED_API_BASE_URL = 'https://api.spidersan.net/v1';
+export const DEFAULT_LLM_CONFIGS = {
+    lmstudio: {
+        provider: 'lmstudio',
+        model: 'gemma-4-26b-a4b-it',
+        baseUrl: 'http://127.0.0.1:1234/v1',
+        temperature: 0.4,
+        maxTokens: 800,
+    },
+    copilot: {
+        provider: 'copilot',
+        model: 'gpt-4o',
+        baseUrl: 'https://models.inference.ai.azure.com',
+        temperature: 0.4,
+        maxTokens: 800,
+    },
+    ollama: {
+        provider: 'ollama',
+        model: 'gemma3:4b',
+        baseUrl: 'http://localhost:11434',
+        temperature: 0.4,
+        maxTokens: 800,
+    },
+    hosted: {
+        provider: 'hosted',
+        model: 'spidersan-v1',
+        baseUrl: HOSTED_API_BASE_URL,
+        temperature: 0.4,
+        maxTokens: 800,
+    },
+};
+//# sourceMappingURL=types.js.map