spidersan 0.20.1 → 0.20.2

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,42 @@
+/**
+ * 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',
+        // A4B general-purpose backend on :8082 (mlx_lm.server). The model id must be
+        // the exact HF-cache id — mlx_lm.server resolves it from the local cache.
+        // gitOps routing is unaffected: event-handler.ts hardcodes its own :1234 default.
+        model: 'mlx-community/gemma-4-26b-a4b-it-4bit',
+        baseUrl: 'http://127.0.0.1:8082/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,6EAA6E;QAC7E,0EAA0E;QAC1E,kFAAkF;QAClF,KAAK,EAAE,uCAAuC;QAC9C,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/ast.d.ts

@@ -0,0 +1,44 @@
+import Parser from 'tree-sitter';
+export interface SymbolInfo {
+    name: string;
+    type: 'function' | 'class' | 'method';
+    startLine: number;
+    endLine: number;
+    /** Enclosing class name for methods, so `A.render` and `B.render` don't collide. */
+    parent?: string;
+    content?: string;
+    hash?: string;
+}
+export declare class ASTParser {
+    private parser;
+    constructor();
+    parse(code: string): Parser.Tree;
+    /**
+     * Parse a file and return all defined symbols (functions, classes, methods)
+     */
+    getSymbols(filePath: string): SymbolInfo[];
+    /**
+     * Compute SHA-256 hash of code content
+     */
+    computeHash(content: string): string;
+    private extractSymbols;
+    /**
+     * Compare two versions of code and find symbols that differ in content.
+     * With `baseContent` (the merge-base version) this is a three-way check: a
+     * symbol only conflicts if BOTH sides changed it from base. Without it the
+     * check is two-way and over-reports one-sided edits.
+     */
+    findSymbolConflicts(contentA: string, labelA: string, contentB: string, labelB: string, baseContent?: string): SymbolConflict[];
+}
+/** Language-agnostic core: two symbol lists (+ optional merge-base list) → conflicts. */
+export declare function compareSymbols(symbolsA: SymbolInfo[], labelA: string, symbolsB: SymbolInfo[], labelB: string, symbolsBase?: SymbolInfo[]): SymbolConflict[];
+export declare const qualify: (s: SymbolInfo) => string;
+export interface SymbolConflict {
+    symbolName: string;
+    symbolType: string;
+    locations: {
+        file: string;
+        range: [number, number];
+    }[];
+}
+//# sourceMappingURL=ast.d.ts.map

package/dist/lib/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/lib/ast.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAKjC,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAS;;IAQvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI;IAKhC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAS1C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIpC,OAAO,CAAC,cAAc;IA6FtB;;;;;OAKG;IACH,mBAAmB,CACf,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAChC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAChC,WAAW,CAAC,EAAE,MAAM,GACrB,cAAc,EAAE;CAOtB;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EACtC,QAAQ,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EACtC,WAAW,CAAC,EAAE,UAAU,EAAE,GAC3B,cAAc,EAAE,CAkClB;AAED,eAAO,MAAM,OAAO,GAAI,GAAG,UAAU,KAAG,MAAuD,CAAC;AAEhG,MAAM,WAAW,cAAc;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EAAE,CAAC;CAC1D"}

package/dist/lib/ast.js

@@ -0,0 +1,160 @@
+import Parser from 'tree-sitter';
+import TypeScript from 'tree-sitter-typescript';
+import fs from 'fs';
+import { createHash } from 'crypto';
+export class ASTParser {
+    parser;
+    constructor() {
+        this.parser = new Parser();
+        // TypeScript binding quirk
+        this.parser.setLanguage(TypeScript.typescript);
+    }
+    parse(code) {
+        // node-tree-sitter throws "Invalid argument" past its default ~32KB buffer
+        return this.parser.parse(code, undefined, { bufferSize: Math.max(code.length + 1, 32 * 1024) });
+    }
+    /**
+     * Parse a file and return all defined symbols (functions, classes, methods)
+     */
+    getSymbols(filePath) {
+        if (!fs.existsSync(filePath)) {
+            return [];
+        }
+        const code = fs.readFileSync(filePath, 'utf-8');
+        const tree = this.parse(code);
+        return this.extractSymbols(tree);
+    }
+    /**
+     * Compute SHA-256 hash of code content
+     */
+    computeHash(content) {
+        return createHash('sha256').update(content).digest('hex');
+    }
+    extractSymbols(tree) {
+        const symbols = [];
+        const cursor = tree.walk();
+        // Stack of symbols we are currently inside
+        const stack = [];
+        let visitedChildren = false;
+        let depth = 0;
+        while (true) {
+            if (visitedChildren) {
+                // Post-visit: Check if we are leaving a symbol node
+                if (stack.length > 0) {
+                    const top = stack[stack.length - 1];
+                    // Check if the current node (which we are done with) matches the stack top
+                    if (top.depth === depth &&
+                        top.startLine === cursor.startPosition.row + 1 &&
+                        top.endLine === cursor.endPosition.row + 1) {
+                        stack.pop();
+                        if (top.name) {
+                            const content = cursor.nodeText;
+                            symbols.push({
+                                name: top.name,
+                                type: top.type,
+                                startLine: top.startLine,
+                                endLine: top.endLine,
+                                ...(top.parent ? { parent: top.parent } : {}),
+                                content: content,
+                                hash: this.computeHash(content)
+                            });
+                        }
+                    }
+                }
+                if (cursor.gotoNextSibling()) {
+                    visitedChildren = false;
+                }
+                else {
+                    if (!cursor.gotoParent())
+                        break;
+                    depth--;
+                    // After returning to parent, we are done with its children
+                    visitedChildren = true;
+                }
+            }
+            else {
+                // Pre-visit
+                const type = cursor.nodeType;
+                // 1. Check if it is a symbol definition
+                const valueType = type === 'variable_declarator'
+                    ? cursor.currentNode.childForFieldName('value')?.type
+                    : undefined;
+                // `const f = () => {}` / `const f = function () {}` are functions too
+                const isFnConst = valueType === 'arrow_function' || valueType === 'function_expression' || valueType === 'function';
+                if (type === 'function_declaration' || type === 'class_declaration' || type === 'method_definition' || isFnConst) {
+                    const parentClass = type === 'method_definition'
+                        ? [...stack].reverse().find(e => e.type === 'class')?.name ?? undefined
+                        : undefined;
+                    stack.push({
+                        type: isFnConst ? 'function' : type.replace('_declaration', '').replace('_definition', ''),
+                        startLine: cursor.startPosition.row + 1,
+                        endLine: cursor.endPosition.row + 1,
+                        name: null,
+                        parent: parentClass,
+                        depth: depth
+                    });
+                }
+                // 2. Check if it is the 'name' field of the parent symbol
+                else if (stack.length > 0 && cursor.currentFieldName === 'name') {
+                    const top = stack[stack.length - 1];
+                    // Name must be a direct child of the symbol
+                    if (top.depth === depth - 1) {
+                        top.name = cursor.nodeText;
+                    }
+                }
+                if (cursor.gotoFirstChild()) {
+                    visitedChildren = false;
+                    depth++;
+                }
+                else {
+                    visitedChildren = true;
+                }
+            }
+        }
+        return symbols;
+    }
+    /**
+     * Compare two versions of code and find symbols that differ in content.
+     * With `baseContent` (the merge-base version) this is a three-way check: a
+     * symbol only conflicts if BOTH sides changed it from base. Without it the
+     * check is two-way and over-reports one-sided edits.
+     */
+    findSymbolConflicts(contentA, labelA, contentB, labelB, baseContent) {
+        return compareSymbols(this.extractSymbols(this.parse(contentA)), labelA, this.extractSymbols(this.parse(contentB)), labelB, baseContent === undefined ? undefined : this.extractSymbols(this.parse(baseContent)));
+    }
+}
+/** Language-agnostic core: two symbol lists (+ optional merge-base list) → conflicts. */
+export function compareSymbols(symbolsA, labelA, symbolsB, labelB, symbolsBase) {
+    const baseContentByName = new Map();
+    symbolsBase?.forEach(s => baseContentByName.set(qualify(s), s.content));
+    const baseContent = symbolsBase;
+    const conflicts = [];
+    // Map for fast lookup
+    const mapB = new Map();
+    symbolsB.forEach(s => mapB.set(qualify(s), s));
+    for (const symA of symbolsA) {
+        const symB = mapB.get(qualify(symA));
+        // If symbol exists in both and content differs
+        if (symB && symA.content !== symB.content) {
+            if (baseContent !== undefined) {
+                const base = baseContentByName.get(qualify(symA));
+                // one-sided edit: the other side still equals base, git merges it cleanly
+                if (symA.content === base || symB.content === base)
+                    continue;
+            }
+            conflicts.push({
+                symbolName: qualify(symA),
+                symbolType: symA.type,
+                locations: [
+                    { file: labelA, range: [symA.startLine, symA.endLine] },
+                    { file: labelB, range: [symB.startLine, symB.endLine] }
+                ]
+            });
+        }
+    }
+    // A class always "changes" when one of its methods does; report the method, not both.
+    return conflicts.filter(c => c.symbolType !== 'class' ||
+        !conflicts.some(m => m.symbolType === 'method' && m.symbolName.startsWith(`${c.symbolName}.`)));
+}
+export const qualify = (s) => (s.parent ? `${s.parent}.${s.name}` : s.name);
+//# sourceMappingURL=ast.js.map

package/dist/lib/ast.js.map

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

package/dist/lib/carries.d.ts

@@ -0,0 +1,22 @@
+export interface CarriedCommit {
+    sha: string;
+    subject: string;
+}
+export interface InheritedCommit extends CarriedCommit {
+    /** Other open remote branches that also contain this commit (self/base excluded). */
+    branches: string[];
+}
+export interface CarriesReport {
+    own: CarriedCommit[];
+    inherited: InheritedCommit[];
+    /** carries ∩ another-open-branch ≠ ∅ */
+    flagged: boolean;
+}
+/**
+ * @param base         ref the PR merges into (e.g. `origin/main`).
+ * @param prRef        the PR head ref (e.g. `refs/spidersan/pr-81`).
+ * @param selfBranches remote refs that ARE this PR or the base — excluded from the
+ *                     "other branch" set (e.g. [`origin/<headBranch>`, base]).
+ */
+export declare function analyzeCarries(base: string, prRef: string, selfBranches?: string[]): CarriesReport;
+//# sourceMappingURL=carries.d.ts.map

package/dist/lib/carries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carries.d.ts","sourceRoot":"","sources":["../../src/lib/carries.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IAClD,qFAAqF;IACrF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,aAAa,EAAE,CAAC;IACrB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,aAAa,CAkCtG"}

package/dist/lib/carries.js

@@ -0,0 +1,56 @@
+/**
+ * carries(pr) — provenance predicate.
+ *
+ * carries(pr) = commits reachable from the PR head but not from the base, split into
+ * the author's OWN commits vs commits also reachable from another OPEN branch
+ * (INHERITED). Flag when the intersection with any other branch is non-empty.
+ *
+ * Why intersection, not superset (spidersan #257 / birdsan review): `carries(A) ⊃
+ * commits_of(B)` under-fires — a PR can share commits with B while B holds further
+ * commits the PR never inherited (the real #78/sherlock2 case). Any shared commit is
+ * the entanglement signal, so the condition is `∩ ≠ ∅`, computed per-commit here.
+ *
+ * Pure-ish: only reads git, never mutates. Spec: docs/DESIGN_pr_grammar_predicates.md.
+ */
+import { execFileSync } from 'child_process';
+/**
+ * @param base         ref the PR merges into (e.g. `origin/main`).
+ * @param prRef        the PR head ref (e.g. `refs/spidersan/pr-81`).
+ * @param selfBranches remote refs that ARE this PR or the base — excluded from the
+ *                     "other branch" set (e.g. [`origin/<headBranch>`, base]).
+ */
+export function analyzeCarries(base, prRef, selfBranches = []) {
+    let log;
+    try {
+        log = execFileSync('git', ['log', '--format=%H%x09%s', `${base}..${prRef}`], { encoding: 'utf-8' });
+    }
+    catch {
+        return { own: [], inherited: [], flagged: false };
+    }
+    const self = new Set(selfBranches);
+    const own = [];
+    const inherited = [];
+    for (const line of log.split('\n').filter(Boolean)) {
+        const tab = line.indexOf('\t');
+        const sha = tab >= 0 ? line.slice(0, tab) : line;
+        const subject = tab >= 0 ? line.slice(tab + 1) : '';
+        let branches = [];
+        try {
+            branches = execFileSync('git', ['branch', '-r', '--contains', sha], { encoding: 'utf-8' })
+                .split('\n')
+                .map((b) => b.replace(/^[*+]?\s*/, '').trim())
+                .filter(Boolean)
+                .filter((b) => !b.includes(' -> ')) // drop symbolic refs (origin/HEAD -> origin/main)
+                .filter((b) => !self.has(b));
+        }
+        catch {
+            // detached / unknown ref → treat as own (no other branch claims it)
+        }
+        if (branches.length > 0)
+            inherited.push({ sha, subject, branches });
+        else
+            own.push({ sha, subject });
+    }
+    return { own, inherited, flagged: inherited.length > 0 };
+}
+//# sourceMappingURL=carries.js.map