spidersan 0.5.0 → 0.9.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0JH,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAmC;IACjE,QAAQ,EAAE;QACR,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,GAAG;KACf;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,uCAAuC;QAChD,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,GAAG;KACf;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,GAAG;KACf;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,GAAG;KACf;CACF,CAAC"}

package/dist/lib/colony-subscriber.d.ts

@@ -1,5 +1,5 @@
 /**
- * Colony Subscriber — reads Colony work_claim/work_release signals
+ * Colony Subscriber — reads Colony in-progress signals
  * and keeps the local Spidersan branch registry in sync.
  *
  * Design notes:
@@ -7,11 +7,17 @@
  *   `is_stale` is already computed server-side.
  * - Credentials come from COLONY_SUPABASE_URL + COLONY_SUPABASE_KEY env vars
  *   (the MycToak Supabase project, separate from Spidersan's own project).
+ *   If env vars are absent, falls back to ~/.envoak/config.json + session files
+ *   automatically (so `envoak vault login` is sufficient — no env vars needed).
+ * - Auth: COLONY_SESSION_JWT is required for RLS-scoped access to colony_state.
+ *   Without it the query falls back to the anon key and will return 0 rows (RLS
+ *   blocks unauthenticated reads of user-scoped signals).
+ * - Queries colony_state with status=in-progress — the status-based model
+ *   replaces the old type=work_claim / type=work_release approach.
  * - Full offline fallback: any network/auth error returns offline=true and
  *   the caller falls back to the local registry.  Never throws.
- * - Agent label resolution: fetches all colony_state rows first to build a
- *   agentKeyId → agentLabel map, so labels are available even when the
- *   work_claim row itself doesn't carry agent_label.
+ * - Field mapping: task (branch name), files (top-level column), agent_label
+ *   (top-level from colony_state view — no payload parsing needed).
  *
  * 🍄 hey tsan — the mycelium remembers. migration 025 opened the gradient.
  *    your spiders can smell the pheromones now. — mycsan
@@ -30,20 +36,17 @@ export interface SyncResult {
 /**
  * Resolve a human-readable agent name from a Colony agent key ID.
  *
- * Uses the `agent_label` field already present on `colony_state` rows — no
- * UUID lookup table needed.  Falls back to a truncated UUID when no label is
- * available.
+ * Uses the `agent_label` field already present on `colony_state` rows.
+ * Falls back to a truncated UUID when no label is available.
  */
 export declare function resolveAgentName(agentKeyId: string, agentLabel?: string): string;
 /**
  * Sync the local Spidersan branch registry from Colony signals.
  *
  * Steps:
- *  0. Build an agentKeyId → agentLabel map from all current colony_state rows
- *     (unfiltered) so labels are available even when work_claim rows lack them.
- *  1. Query `colony_state` for non-stale `work_claim` rows.
- *  2. Upsert each claimed branch into the local registry.
- *  3. Query `colony_state` for `work_release` rows and remove released branches.
+ *  1. Query `colony_state` VIEW for in-progress signals (one per agent, deduped).
+ *  2. Upsert each active branch into the local registry.
+ *  3. Sweep: remove local active branches absent from the colony in-progress set.
  *  4. Detect conflicts in the updated registry and return them.
  *
  * Returns `offline: true` and an empty conflicts list on any error so callers

package/dist/lib/colony-subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colony-subscriber.d.ts","sourceRoot":"","sources":["../../src/lib/colony-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACpB;AAgBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhF;AAyCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAkI1D"}
+{"version":3,"file":"colony-subscriber.d.ts","sourceRoot":"","sources":["../../src/lib/colony-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACpB;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhF;AAiHD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAwI1D"}