spidersan 0.20.1 → 0.20.2

package/dist/lib/trunk.js

@@ -0,0 +1,116 @@
+/**
+ * Trunk branch detection.
+ *
+ * Centralizes the "which branch is trunk?" question that was previously
+ * hardcoded as `main`/`master` in several places.
+ *
+ * Resolution order (first hit wins):
+ *   1. `git symbolic-ref refs/remotes/origin/HEAD` (strip the `origin/` prefix)
+ *   2. `.spidersanrc` `trunk` key
+ *   3. `main`   — if that branch exists
+ *   4. `master` — if that branch exists
+ *   5. `'main'` — default fallback
+ *
+ * Pure + cached per `cwd` within a process. Tolerates a missing
+ * `origin/HEAD` (fresh clones throw — we catch and fall through).
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { execGit } from './git.js';
+const CONFIG_FILES = ['.spidersanrc', '.spidersanrc.json', '.spidersan.config.json'];
+// Per-cwd cache so repeated calls within a process don't re-shell out to git.
+const cache = new Map();
+function resolveCwd(opts) {
+    return opts?.cwd ?? process.cwd();
+}
+/** origin/HEAD symbolic-ref → branch name, or null if unset / fresh clone. */
+function fromOriginHead(cwd) {
+    try {
+        const out = execGit(['-C', cwd, 'symbolic-ref', 'refs/remotes/origin/HEAD'], {
+            stdio: ['pipe', 'pipe', 'ignore'],
+        }).trim();
+        // e.g. "refs/remotes/origin/develop" → "develop"
+        const prefix = 'refs/remotes/origin/';
+        const ref = out.startsWith(prefix) ? out.slice(prefix.length) : out.replace(/^origin\//, '');
+        return ref || null;
+    }
+    catch {
+        // Fresh clones / no origin/HEAD set: throws — fall through.
+        return null;
+    }
+}
+/** `.spidersanrc` `trunk` key (project-local), or null if absent/unreadable. */
+function fromConfig(cwd) {
+    for (const filename of CONFIG_FILES) {
+        const path = join(cwd, filename);
+        if (!existsSync(path))
+            continue;
+        try {
+            const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+            const trunk = parsed?.trunk;
+            if (typeof trunk === 'string' && trunk.trim()) {
+                return trunk.trim();
+            }
+        }
+        catch {
+            // Malformed config — ignore and keep looking.
+        }
+    }
+    return null;
+}
+/** True if a local branch ref exists. */
+function branchExists(cwd, branch) {
+    try {
+        execGit(['-C', cwd, 'rev-parse', '--verify', `refs/heads/${branch}`], {
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveTrunk(cwd) {
+    const fromHead = fromOriginHead(cwd);
+    if (fromHead)
+        return fromHead;
+    const fromCfg = fromConfig(cwd);
+    if (fromCfg)
+        return fromCfg;
+    if (branchExists(cwd, 'main'))
+        return 'main';
+    if (branchExists(cwd, 'master'))
+        return 'master';
+    return 'main';
+}
+/**
+ * Resolve the repo's trunk branch name.
+ *
+ * @param opts.cwd - Repo directory (defaults to `process.cwd()`).
+ * @returns The trunk branch name (e.g. `'main'`, `'master'`, `'develop'`).
+ */
+export function getTrunkBranch(opts) {
+    const cwd = resolveCwd(opts);
+    const cached = cache.get(cwd);
+    if (cached !== undefined)
+        return cached;
+    const trunk = resolveTrunk(cwd);
+    cache.set(cwd, trunk);
+    return trunk;
+}
+/**
+ * True if `branch` is the repo's trunk.
+ *
+ * @param branch - Branch name to test.
+ * @param opts.cwd - Repo directory (defaults to `process.cwd()`).
+ */
+export function isTrunk(branch, opts) {
+    return branch === getTrunkBranch(opts);
+}
+/**
+ * Clear the per-cwd trunk cache. Intended for tests; harmless in production.
+ */
+export function _clearTrunkCache() {
+    cache.clear();
+}
+//# sourceMappingURL=trunk.js.map

package/dist/lib/trunk.js.map

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

package/dist/lib/update-check.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Update Check Module
+ *
+ * Checks npm registry for newer versions and displays update notification.
+ * Non-blocking, fails silently.
+ */
+/**
+ * Check for updates (non-blocking)
+ */
+export declare function checkForUpdates(): Promise<void>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/lib/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/lib/update-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuEH;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAkCrD"}

package/dist/lib/update-check.js

@@ -0,0 +1,113 @@
+/**
+ * Update Check Module
+ *
+ * Checks npm registry for newer versions and displays update notification.
+ * Non-blocking, fails silently.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_DIR = join(homedir(), '.spidersan');
+const UPDATE_CACHE = join(CONFIG_DIR, 'update-cache.json');
+const PACKAGE_NAME = 'spidersan';
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * Get current installed version
+ */
+function getCurrentVersion() {
+    try {
+        const packagePath = new URL('../../package.json', import.meta.url);
+        const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Load update cache
+ */
+function loadCache() {
+    try {
+        if (existsSync(UPDATE_CACHE)) {
+            return JSON.parse(readFileSync(UPDATE_CACHE, 'utf-8'));
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return { lastCheck: 0, latestVersion: null };
+}
+/**
+ * Save update cache
+ */
+function saveCache(cache) {
+    try {
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        writeFileSync(UPDATE_CACHE, JSON.stringify(cache));
+    }
+    catch {
+        // Ignore
+    }
+}
+/**
+ * Compare semantic versions
+ */
+function isNewerVersion(current, latest) {
+    const currentParts = current.split('.').map(Number);
+    const latestParts = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((latestParts[i] || 0) > (currentParts[i] || 0))
+            return true;
+        if ((latestParts[i] || 0) < (currentParts[i] || 0))
+            return false;
+    }
+    return false;
+}
+/**
+ * Check for updates (non-blocking)
+ */
+export async function checkForUpdates() {
+    try {
+        const cache = loadCache();
+        const now = Date.now();
+        // Only check once per day
+        if (now - cache.lastCheck < CHECK_INTERVAL_MS && cache.latestVersion) {
+            showUpdateNotification(cache.latestVersion);
+            return;
+        }
+        // Fetch latest version from npm (with timeout)
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const response = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!response.ok)
+            return;
+        const data = await response.json();
+        const latestVersion = data.version;
+        // Update cache
+        saveCache({ lastCheck: now, latestVersion });
+        // Show notification if newer
+        showUpdateNotification(latestVersion);
+    }
+    catch {
+        // Silent fail - don't interrupt user
+    }
+}
+/**
+ * Display update notification if newer version available
+ */
+function showUpdateNotification(latestVersion) {
+    const currentVersion = getCurrentVersion();
+    if (isNewerVersion(currentVersion, latestVersion)) {
+        console.log('');
+        console.log('╭─────────────────────────────────────────────╮');
+        console.log(`│  🕷️ Update available: ${currentVersion} → ${latestVersion.padEnd(10)}    │`);
+        console.log('│  Run: npm install -g spidersan              │');
+        console.log('╰─────────────────────────────────────────────╯');
+        console.log('');
+    }
+}
+//# sourceMappingURL=update-check.js.map

package/dist/lib/update-check.js.map

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

package/dist/lib/watch-renderer.d.ts

@@ -0,0 +1,13 @@
+import type { DriftResult, DriftSkipped } from './remote-drift.js';
+export interface FetchPollRenderOptions {
+    branch: string;
+    drift: DriftResult | DriftSkipped;
+    timestamp?: string;
+}
+/** Pure. Returns terminal string for --fetch-poll drift warnings and heartbeats. */
+export declare function renderFetchPollHeartbeat(opts: {
+    branch: string;
+    timestamp?: string;
+}): string;
+export declare function renderFetchPollDrift(opts: FetchPollRenderOptions): string;
+//# sourceMappingURL=watch-renderer.d.ts.map

package/dist/lib/watch-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-renderer.d.ts","sourceRoot":"","sources":["../../src/lib/watch-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM7F;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAgBzE"}

package/dist/lib/watch-renderer.js

@@ -0,0 +1,35 @@
+/** Pure. Returns terminal string for --fetch-poll drift warnings and heartbeats. */
+export function renderFetchPollHeartbeat(opts) {
+    if (opts.timestamp) {
+        return `📡 [FETCH-POLL] Remote unchanged (checked at ${opts.timestamp})`;
+    }
+    return '📡 [FETCH-POLL] Remote unchanged';
+}
+export function renderFetchPollDrift(opts) {
+    if ('skipped' in opts.drift) {
+        return `📡 [FETCH-POLL] Skipped: ${opts.drift.reason}`;
+    }
+    const drift = opts.drift;
+    const driftSummary = drift.driftZone.length > 0
+        ? drift.driftZone.map((file) => formatDriftZoneEntry(file, drift)).join(', ')
+        : '(none reported)';
+    return [
+        '📡 [FETCH-POLL] Remote advanced while you\'re working!',
+        `   Branch: ${drift.branch}  |  Remote is ${drift.remoteAhead} commit(s) ahead`,
+        `   Drift zone: ${driftSummary}`,
+        `   → Run: git fetch origin && git log --oneline ${drift.remote} -5`,
+    ].join('\n').trimEnd();
+}
+function formatDriftZoneEntry(file, result) {
+    const labels = [];
+    const registered = result.registeredInDrift.find((entry) => entry.file === file);
+    const unstaged = result.unstagedInDrift.some((entry) => entry.file === file);
+    if (registered && registered.tier !== null) {
+        labels.push(`registered tier ${registered.tier}`);
+    }
+    if (unstaged) {
+        labels.push('unstaged ⚠');
+    }
+    return labels.length > 0 ? `${file} [${labels.join(', ')}]` : file;
+}
+//# sourceMappingURL=watch-renderer.js.map

package/dist/lib/watch-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-renderer.js","sourceRoot":"","sources":["../../src/lib/watch-renderer.ts"],"names":[],"mappings":"AAQA,oFAAoF;AACpF,MAAM,UAAU,wBAAwB,CAAC,IAA4C;IACjF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,gDAAgD,IAAI,CAAC,SAAS,GAAG,CAAC;IAC7E,CAAC;IAED,OAAO,kCAAkC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAA4B;IAC7D,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,4BAA4B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7E,CAAC,CAAC,iBAAiB,CAAC;IAExB,OAAO;QACH,wDAAwD;QACxD,cAAc,KAAK,CAAC,MAAM,kBAAkB,KAAK,CAAC,WAAW,kBAAkB;QAC/E,kBAAkB,YAAY,EAAE;QAChC,mDAAmD,KAAK,CAAC,MAAM,KAAK;KACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY,EAAE,MAAmB;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE7E,IAAI,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,mBAAmB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC"}

package/dist/storage/adapter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Storage Adapter Interface
+ *
+ * Abstract interface for branch registry storage.
+ * Implementations: LocalStorage (JSON), SupabaseStorage (Pro)
+ */
+export interface Branch {
+    name: string;
+    files: string[];
+    registeredAt: Date;
+    agent?: string;
+    /**
+     * Claude Code session (the id `tbe`/ccsessions lists) that last registered this
+     * branch, so a conflict can say WHICH session to resume. Local registry only:
+     * meaningless off the machine that owns the session, and not synced to Supabase.
+     */
+    sessionId?: string;
+    status: 'active' | 'completed' | 'abandoned';
+    description?: string;
+    /** Branches that must merge BEFORE this one (`spidersan depends`). */
+    dependsOn?: string[];
+    /** PR that merged this branch (`spidersan merged --pr`). */
+    prNumber?: number;
+    /**
+     * Per-file claims from before 0.20.0, when `watch` and `spidersan
+     * claim`/`release` wrote them. Nothing writes this any more; it stays
+     * so registries that still carry it keep parsing.
+     */
+    claims?: Record<string, {
+        agent: string;
+        at: string;
+    }>;
+}
+export interface BranchRegistry {
+    branches: Record<string, Branch>;
+    version: string;
+    projectId?: string;
+}
+/**
+ * @deprecated Use BranchRegistryStore for local registry access and
+ * SupabaseRegistrySyncClient for cross-machine sync.
+ */
+export interface StorageAdapter {
+    /**
+     * Initialize the storage (create directories, connect to DB, etc.)
+     */
+    init(): Promise<void>;
+    /**
+     * Check if storage is initialized
+     */
+    isInitialized(): Promise<boolean>;
+    /**
+     * Get all registered branches
+     */
+    list(): Promise<Branch[]>;
+    /**
+     * Register a new branch
+     */
+    register(branch: Omit<Branch, 'registeredAt'>): Promise<Branch>;
+    /**
+     * Update an existing branch
+     */
+    update(name: string, updates: Partial<Branch>): Promise<Branch | null>;
+    /**
+     * Unregister a branch
+     */
+    unregister(name: string): Promise<boolean>;
+    /**
+     * Get a specific branch by name
+     */
+    get(name: string): Promise<Branch | null>;
+    /**
+     * Find branches that touch specific files
+     */
+    findByFiles(files: string[]): Promise<Branch[]>;
+    /**
+     * Clean up old branches
+     */
+    cleanup(olderThan: Date, includeActive?: boolean): Promise<string[]>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/storage/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/storage/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEvE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhD;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACxE"}

package/dist/storage/adapter.js

@@ -0,0 +1,8 @@
+/**
+ * Storage Adapter Interface
+ *
+ * Abstract interface for branch registry storage.
+ * Implementations: LocalStorage (JSON), SupabaseStorage (Pro)
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/storage/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/storage/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/storage/branch-registry-store.d.ts

@@ -0,0 +1,13 @@
+import type { Branch } from './adapter.js';
+export interface BranchRegistryStore {
+    init(): Promise<void>;
+    isInitialized(): Promise<boolean>;
+    list(): Promise<Branch[]>;
+    register(branch: Omit<Branch, 'registeredAt'>): Promise<Branch>;
+    update(name: string, updates: Partial<Branch>): Promise<Branch | null>;
+    unregister(name: string): Promise<boolean>;
+    get(name: string): Promise<Branch | null>;
+    findByFiles(files: string[]): Promise<Branch[]>;
+    cleanup(olderThan: Date, includeActive?: boolean): Promise<string[]>;
+}
+//# sourceMappingURL=branch-registry-store.d.ts.map

package/dist/storage/branch-registry-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-registry-store.d.ts","sourceRoot":"","sources":["../../src/storage/branch-registry-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAChC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACxE"}

package/dist/storage/branch-registry-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=branch-registry-store.js.map

package/dist/storage/branch-registry-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-registry-store.js","sourceRoot":"","sources":["../../src/storage/branch-registry-store.ts"],"names":[],"mappings":""}

package/dist/storage/factory.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Storage factory - selects the right storage backend
+ */
+import type { StorageAdapter } from './adapter.js';
+export declare function getStorage(): Promise<StorageAdapter>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/storage/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAQ1D"}

package/dist/storage/factory.js

@@ -0,0 +1,14 @@
+/**
+ * Storage factory - selects the right storage backend
+ */
+import { LocalStorage } from './local.js';
+import { SupabaseStorage } from './supabase.js';
+import { resolveSupabaseCredentials } from '../lib/supabase-credentials.js';
+export async function getStorage() {
+    const supabaseConfig = await resolveSupabaseCredentials();
+    if (supabaseConfig) {
+        return new SupabaseStorage(supabaseConfig);
+    }
+    return new LocalStorage();
+}
+//# sourceMappingURL=factory.js.map

package/dist/storage/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,UAAU;IAC5B,MAAM,cAAc,GAAG,MAAM,0BAA0B,EAAE,CAAC;IAE1D,IAAI,cAAc,EAAE,CAAC;QACjB,OAAO,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,IAAI,YAAY,EAAE,CAAC;AAC9B,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,10 @@
+export * from './adapter.js';
+export * from './branch-registry-store.js';
+export * from './local.js';
+export * from './json-branch-registry-store.js';
+export * from './memory-branch-registry-store.js';
+export * from './supabase.js';
+export * from './supabase-registry-sync-client.js';
+export * from './supabase-registry-sync-client-impl.js';
+export * from './factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,eAAe,CAAC;AAC9B,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,cAAc,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,11 @@
+// Branch storage adapters
+export * from './adapter.js';
+export * from './branch-registry-store.js';
+export * from './local.js';
+export * from './json-branch-registry-store.js';
+export * from './memory-branch-registry-store.js';
+export * from './supabase.js';
+export * from './supabase-registry-sync-client.js';
+export * from './supabase-registry-sync-client-impl.js';
+export * from './factory.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,eAAe,CAAC;AAC9B,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,cAAc,CAAC"}

package/dist/storage/json-branch-registry-store.d.ts

@@ -0,0 +1,19 @@
+import type { Branch } from './adapter.js';
+import type { BranchRegistryStore } from './branch-registry-store.js';
+export declare class JsonBranchRegistryStore implements BranchRegistryStore {
+    private basePath;
+    private registryPath;
+    constructor(basePath?: string);
+    init(): Promise<void>;
+    isInitialized(): Promise<boolean>;
+    list(): Promise<Branch[]>;
+    register(branch: Omit<Branch, 'registeredAt'>): Promise<Branch>;
+    update(name: string, updates: Partial<Branch>): Promise<Branch | null>;
+    unregister(name: string): Promise<boolean>;
+    get(name: string): Promise<Branch | null>;
+    findByFiles(files: string[]): Promise<Branch[]>;
+    cleanup(olderThan: Date, includeActive?: boolean): Promise<string[]>;
+    private load;
+    private save;
+}
+//# sourceMappingURL=json-branch-registry-store.d.ts.map

package/dist/storage/json-branch-registry-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-branch-registry-store.d.ts","sourceRoot":"","sources":["../../src/storage/json-branch-registry-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AA6BtE,qBAAa,uBAAwB,YAAW,mBAAmB;IAC/D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,QAAQ,GAAE,MAAsB;IAKtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAY/D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAetE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM/C,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAuB1D,IAAI;YA+BJ,IAAI;CAMrB"}