portweave 0.1.0

package/dist/registry/lock.js

@@ -0,0 +1,86 @@
+import { mkdir, rm, stat } from 'node:fs/promises';
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+const LOCK_RETRY_COUNT_DEFAULT = 100;
+const LOCK_RETRY_DELAY_MS = 25;
+const STALE_LOCK_MS = 30_000;
+function getErrorCode(value) {
+    if (typeof value !== 'object' || value === null || !('code' in value)) {
+        return undefined;
+    }
+    const code = value.code;
+    return typeof code === 'string' ? code : undefined;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function resolveLockConfig() {
+    const raw = process.env.PORTWEAVE_LOCK_TIMEOUT_MS;
+    if (raw === undefined || raw.length === 0) {
+        return {
+            retryCount: LOCK_RETRY_COUNT_DEFAULT,
+            retryDelayMs: LOCK_RETRY_DELAY_MS,
+            staleMs: STALE_LOCK_MS,
+        };
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return {
+            retryCount: LOCK_RETRY_COUNT_DEFAULT,
+            retryDelayMs: LOCK_RETRY_DELAY_MS,
+            staleMs: STALE_LOCK_MS,
+        };
+    }
+    return {
+        retryCount: Math.max(1, Math.ceil(parsed / LOCK_RETRY_DELAY_MS)),
+        retryDelayMs: LOCK_RETRY_DELAY_MS,
+        staleMs: STALE_LOCK_MS,
+    };
+}
+async function tryRemoveStaleLock(lockDir, staleMs) {
+    try {
+        const info = await stat(lockDir);
+        if (Date.now() - info.mtimeMs > staleMs) {
+            await rm(lockDir, { force: true, recursive: true });
+        }
+    }
+    catch (caught) {
+        // pw-allow-swallow: ENOENT means the lock vanished concurrently — no action needed.
+        // Any other error is unexpected; remove forcefully as best-effort and let the
+        // retry loop surface the failure.
+        if (getErrorCode(caught) !== 'ENOENT') {
+            await rm(lockDir, { force: true, recursive: true });
+        }
+    }
+}
+async function tryAcquire(lockDir) {
+    try {
+        await mkdir(lockDir);
+        return true;
+    }
+    catch (caught) {
+        if (getErrorCode(caught) === 'EEXIST') {
+            return false;
+        }
+        throw caught;
+    }
+}
+export async function withLock(lockDir, fn) {
+    const config = resolveLockConfig();
+    for (let attempt = 0; attempt < config.retryCount; attempt++) {
+        const acquired = await tryAcquire(lockDir);
+        if (acquired) {
+            try {
+                const value = await fn();
+                return ok(value);
+            }
+            finally {
+                await rm(lockDir, { force: true, recursive: true });
+            }
+        }
+        await tryRemoveStaleLock(lockDir, config.staleMs);
+        await sleep(config.retryDelayMs);
+    }
+    return err(new PortweaveError(PW_ERROR_CODES.REGISTRY_LOCKED, `timed out acquiring registry lock at ${lockDir} after ${config.retryCount.toString()} retries`));
+}
+//# sourceMappingURL=lock.js.map

package/dist/registry/lock.js.map

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

package/dist/registry/paths.d.ts

@@ -0,0 +1,7 @@
+export interface RegistryPaths {
+    readonly lockDir: string;
+    readonly registryDir: string;
+    readonly registryFile: string;
+}
+export declare function resolveRegistryPath(env?: NodeJS.ProcessEnv): RegistryPaths;
+//# sourceMappingURL=paths.d.ts.map

package/dist/registry/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/registry/paths.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,aAAa,CAUf"}

package/dist/registry/paths.js

@@ -0,0 +1,13 @@
+import { homedir } from 'node:os';
+import { isAbsolute, join } from 'node:path';
+export function resolveRegistryPath(env = process.env) {
+    const xdg = env.XDG_CONFIG_HOME;
+    const configHome = xdg && xdg.length > 0 && isAbsolute(xdg) ? xdg : join(homedir(), '.config');
+    const registryDir = join(configHome, 'portweave');
+    return {
+        lockDir: join(registryDir, 'registry.lock'),
+        registryDir,
+        registryFile: join(registryDir, 'registry.json'),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/registry/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/registry/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAQ5C,MAAM,UAAU,mBAAmB,CACjC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAA;IAC/B,MAAM,UAAU,GACd,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7E,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IACjD,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC;QAC3C,WAAW;QACX,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC;KACjD,CAAA;AACH,CAAC"}

package/dist/registry/prune.d.ts

@@ -0,0 +1,3 @@
+import type { RegistryEntry } from './types.ts';
+export declare function pruneStaleEntries(entries: readonly RegistryEntry[], fsExists?: (path: string) => boolean): RegistryEntry[];
+//# sourceMappingURL=prune.d.ts.map

package/dist/registry/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/registry/prune.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAe/C,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAgC,GAC3D,aAAa,EAAE,CAQjB"}

package/dist/registry/prune.js

@@ -0,0 +1,24 @@
+import { existsSync, statSync } from 'node:fs';
+function defaultDirectoryExists(path) {
+    if (!existsSync(path)) {
+        return false;
+    }
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        // pw-allow-swallow: statSync failure after existsSync succeeds means the path
+        // was removed between the two calls. Treat as non-existent.
+        return false;
+    }
+}
+export function pruneStaleEntries(entries, fsExists = defaultDirectoryExists) {
+    const kept = [];
+    for (const entry of entries) {
+        if (fsExists(entry.key.worktreeRoot)) {
+            kept.push(entry);
+        }
+    }
+    return kept;
+}
+//# sourceMappingURL=prune.js.map

package/dist/registry/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../src/registry/prune.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAG9C,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,8EAA8E;QAC9E,4DAA4D;QAC5D,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAiC,EACjC,WAAsC,sBAAsB;IAE5D,MAAM,IAAI,GAAoB,EAAE,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/registry/serialize.d.ts

@@ -0,0 +1,6 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+import { type RegistryFile } from './types.ts';
+export declare function loadRegistryFile(path: string): Promise<Result<RegistryFile, PortweaveError>>;
+export declare function serializeRegistry(file: RegistryFile): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/registry/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/registry/serialize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAA;AA0FnB,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CA4C/C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAoB5D"}

package/dist/registry/serialize.js

@@ -0,0 +1,134 @@
+import { readFile } from 'node:fs/promises';
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+import { REGISTRY_VERSION, } from "./types.js";
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isIsoDateString(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    const parsed = Date.parse(value);
+    return !Number.isNaN(parsed);
+}
+function parseKey(raw) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    const { gitCommonDir, namespace, worktreeRoot } = raw;
+    if (typeof worktreeRoot !== 'string' || typeof namespace !== 'string') {
+        return null;
+    }
+    if (gitCommonDir !== null && typeof gitCommonDir !== 'string') {
+        return null;
+    }
+    // offsetOverride is not persisted — always null on deserialization
+    return { gitCommonDir, namespace, offsetOverride: null, worktreeRoot };
+}
+function parsePorts(raw) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    const ports = {};
+    for (const [name, port] of Object.entries(raw)) {
+        if (typeof port !== 'number' || !Number.isInteger(port)) {
+            return null;
+        }
+        ports[name] = port;
+    }
+    return ports;
+}
+function parseEntry(raw) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    const key = parseKey(raw.key);
+    if (key === null) {
+        return null;
+    }
+    const ports = parsePorts(raw.ports);
+    if (ports === null) {
+        return null;
+    }
+    if (!isIsoDateString(raw.lastUsedAt)) {
+        return null;
+    }
+    if (typeof raw.namespace !== 'string') {
+        return null;
+    }
+    return {
+        key,
+        lastUsedAt: raw.lastUsedAt,
+        namespace: raw.namespace,
+        ports,
+    };
+}
+function parseRegistry(raw) {
+    if (!isRecord(raw)) {
+        return null;
+    }
+    if (raw.version !== REGISTRY_VERSION) {
+        return null;
+    }
+    if (!Array.isArray(raw.entries)) {
+        return null;
+    }
+    const entries = [];
+    for (const item of raw.entries) {
+        const entry = parseEntry(item);
+        if (entry === null) {
+            return null;
+        }
+        entries.push(entry);
+    }
+    return { entries, version: REGISTRY_VERSION };
+}
+export async function loadRegistryFile(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf-8');
+    }
+    catch (caught) {
+        if (isRecord(caught) &&
+            typeof caught.code === 'string' &&
+            caught.code === 'ENOENT') {
+            return ok({ entries: [], version: REGISTRY_VERSION });
+        }
+        const message = caught instanceof Error ? caught.message : 'unknown error';
+        return err(new PortweaveError(PW_ERROR_CODES.REGISTRY_CORRUPT, `failed to read registry file at ${path}: ${message}`));
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (caught) {
+        const message = caught instanceof Error ? caught.message : 'invalid JSON';
+        return err(new PortweaveError(PW_ERROR_CODES.REGISTRY_CORRUPT, `registry file at ${path} is not valid JSON: ${message}`));
+    }
+    const file = parseRegistry(parsed);
+    if (file === null) {
+        return err(new PortweaveError(PW_ERROR_CODES.REGISTRY_CORRUPT, `registry file at ${path} failed schema validation`));
+    }
+    return ok(file);
+}
+export function serializeRegistry(file) {
+    const sorted = [...file.entries].sort((a, b) => {
+        if (a.key.worktreeRoot !== b.key.worktreeRoot) {
+            return a.key.worktreeRoot < b.key.worktreeRoot ? -1 : 1;
+        }
+        return a.key.namespace < b.key.namespace ? -1 : 1;
+    });
+    const normalized = sorted.map((entry) => ({
+        key: {
+            gitCommonDir: entry.key.gitCommonDir,
+            namespace: entry.key.namespace,
+            worktreeRoot: entry.key.worktreeRoot,
+        },
+        lastUsedAt: entry.lastUsedAt,
+        namespace: entry.namespace,
+        ports: Object.fromEntries(Object.entries(entry.ports).sort(([a], [b]) => (a < b ? -1 : 1))),
+    }));
+    return `${JSON.stringify({ entries: normalized, version: file.version }, null, 2)}\n`;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/registry/serialize.js.map

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

package/dist/registry/storage.concurrent.d.ts

@@ -0,0 +1,3 @@
+export declare const CONCURRENT_WRITER_PATH: string;
+export declare const CONCURRENT_WRITER_COUNT: 8;
+//# sourceMappingURL=storage.concurrent.d.ts.map

package/dist/registry/storage.concurrent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.concurrent.d.ts","sourceRoot":"","sources":["../../src/registry/storage.concurrent.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,sBAAsB,EAAE,MAAmC,CAAA;AACxE,eAAO,MAAM,uBAAuB,EAAG,CAAU,CAAA"}

package/dist/registry/storage.concurrent.js

@@ -0,0 +1,10 @@
+// Concurrency test surface — kept separate from storage.ts so the path
+// helpers and constants used by the concurrent integration test live next
+// to the test rather than polluting the runtime module. Imported only from
+// __tests__/storage.concurrent.test.ts; structure-check requires that a
+// .test.ts file has a sibling source module at this location.
+import { fileURLToPath } from 'node:url';
+const FIXTURE_URL = new URL('./__tests__/fixtures/concurrent-writer.ts', import.meta.url);
+export const CONCURRENT_WRITER_PATH = fileURLToPath(FIXTURE_URL);
+export const CONCURRENT_WRITER_COUNT = 8;
+//# sourceMappingURL=storage.concurrent.js.map

package/dist/registry/storage.concurrent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.concurrent.js","sourceRoot":"","sources":["../../src/registry/storage.concurrent.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,8DAA8D;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,2CAA2C,EAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAW,aAAa,CAAC,WAAW,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAA"}

package/dist/registry/storage.d.ts

@@ -0,0 +1,11 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+import { type AllocationKey, type RegistryEntry } from './types.ts';
+export interface WithRegistryHandle {
+    readonly entries: readonly RegistryEntry[];
+    remove: (key: AllocationKey) => void;
+    touch: (key: AllocationKey) => void;
+    upsert: (entry: RegistryEntry) => void;
+}
+export declare function withRegistry<T>(fn: (handle: WithRegistryHandle) => Promise<T> | T, env?: NodeJS.ProcessEnv): Promise<Result<T, PortweaveError>>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/registry/storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAM/C,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;IAC1C,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAA;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CACvC;AAsED,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAClD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CA2CpC"}

package/dist/registry/storage.js

@@ -0,0 +1,101 @@
+import { mkdir } from 'node:fs/promises';
+import { PortweaveError } from "../errors.js";
+import { err } from "../result.js";
+import { atomicWriteRegistry, pruneStaleTempFiles } from "./atomic-write.js";
+import { withLock } from "./lock.js";
+import { resolveRegistryPath } from "./paths.js";
+import { pruneStaleEntries } from "./prune.js";
+import { loadRegistryFile, serializeRegistry } from "./serialize.js";
+import { REGISTRY_VERSION, } from "./types.js";
+function keysEqual(a, b) {
+    return (a.worktreeRoot === b.worktreeRoot &&
+        a.namespace === b.namespace &&
+        a.gitCommonDir === b.gitCommonDir);
+}
+function buildHandle(state) {
+    return {
+        /** Insertion-ordered, not sort-ordered. Callers that need sorted order must sort themselves. */
+        get entries() {
+            return state.entries;
+        },
+        remove(key) {
+            const before = state.entries.length;
+            state.entries = state.entries.filter((e) => !keysEqual(e.key, key));
+            if (state.entries.length !== before) {
+                state.mutated = true;
+            }
+        },
+        touch(key) {
+            const idx = state.entries.findIndex((e) => keysEqual(e.key, key));
+            if (idx === -1) {
+                return;
+            }
+            const existing = state.entries[idx];
+            const next = {
+                key: existing.key,
+                lastUsedAt: new Date().toISOString(),
+                namespace: existing.namespace,
+                ports: existing.ports,
+            };
+            state.entries = [
+                ...state.entries.slice(0, idx),
+                next,
+                ...state.entries.slice(idx + 1),
+            ];
+            state.mutated = true;
+        },
+        upsert(entry) {
+            const idx = state.entries.findIndex((e) => keysEqual(e.key, entry.key));
+            if (idx === -1) {
+                state.entries = [...state.entries, entry];
+            }
+            else {
+                state.entries = [
+                    ...state.entries.slice(0, idx),
+                    entry,
+                    ...state.entries.slice(idx + 1),
+                ];
+            }
+            state.mutated = true;
+        },
+    };
+}
+const LOAD_ERROR_KIND = 'load-error';
+const OK_KIND = 'ok';
+export async function withRegistry(fn, env = process.env) {
+    const paths = resolveRegistryPath(env);
+    await mkdir(paths.registryDir, { mode: 0o700, recursive: true });
+    const lockResult = await withLock(paths.lockDir, async () => {
+        await pruneStaleTempFiles(paths.registryFile);
+        const loaded = await loadRegistryFile(paths.registryFile);
+        if (!loaded.ok) {
+            return { error: loaded.error, kind: LOAD_ERROR_KIND };
+        }
+        const fileBefore = loaded.value;
+        const prunedEntries = pruneStaleEntries(fileBefore.entries);
+        const initialMutated = prunedEntries.length !== fileBefore.entries.length;
+        const state = {
+            entries: prunedEntries,
+            mutated: initialMutated,
+        };
+        const handle = buildHandle(state);
+        const value = await fn(handle);
+        if (state.mutated) {
+            const nextFile = {
+                entries: state.entries,
+                version: REGISTRY_VERSION,
+            };
+            await atomicWriteRegistry(paths.registryFile, serializeRegistry(nextFile));
+        }
+        return { kind: OK_KIND, value };
+    });
+    if (!lockResult.ok) {
+        return lockResult;
+    }
+    const inner = lockResult.value;
+    if (inner.kind === LOAD_ERROR_KIND) {
+        return err(inner.error);
+    }
+    return { ok: true, value: inner.value };
+}
+//# sourceMappingURL=storage.js.map

package/dist/registry/storage.js.map

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

package/dist/registry/types.d.ts

@@ -0,0 +1,14 @@
+import type { AllocationKey } from '../worktree/key.ts';
+export type { AllocationKey };
+export interface RegistryEntry {
+    readonly key: AllocationKey;
+    readonly lastUsedAt: string;
+    readonly namespace: string;
+    readonly ports: Readonly<Record<string, number>>;
+}
+export interface RegistryFile {
+    readonly entries: readonly RegistryEntry[];
+    readonly version: 1;
+}
+export declare const REGISTRY_VERSION: 1;
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,YAAY,EAAE,aAAa,EAAE,CAAA;AAE7B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAA"}

package/dist/registry/types.js

@@ -0,0 +1,2 @@
+export const REGISTRY_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAA"}

package/dist/result.d.ts

@@ -0,0 +1,11 @@
+export declare function andThen<T, U, E>(result: Result<T, E>, fn: (value: T) => Result<U, E>): Result<U, E>;
+export declare const err: <E>(error: E) => Result<never, E>;
+export declare const ok: <T>(value: T) => Result<T, never>;
+export type Result<T, E> = {
+    error: E;
+    ok: false;
+} | {
+    ok: true;
+    value: T;
+};
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAEd;AAED,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAA2B,CAAA;AAE5E,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAA0B,CAAA;AAE1E,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA"}

package/dist/result.js

@@ -0,0 +1,6 @@
+export function andThen(result, fn) {
+    return result.ok ? fn(result.value) : result;
+}
+export const err = (error) => ({ error, ok: false });
+export const ok = (value) => ({ ok: true, value });
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CACrB,MAAoB,EACpB,EAA8B;IAE9B,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;AAE5E,MAAM,CAAC,MAAM,EAAE,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA"}

package/dist/runtime/error-passthrough.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Error passthrough contract for the runtime library.
+ *
+ * The runtime functions pass upstream errors through to the caller unchanged —
+ * the `code` and `message` from the originating module reach the top-level
+ * `Result.error` without wrapping. This module documents and re-exports the
+ * error codes the runtime can surface, so callers can dispatch on them.
+ *
+ * See .ai/specs/library-runtime/library-runtime.md §Error handling for the
+ * full error table.
+ *
+ * Module note: structure:check pairs every `*.test.ts` with a sibling source
+ * file. `error-passthrough.test.ts` (which asserts the passthrough contract)
+ * pairs with this file. The re-exports are intentionally thin — the canonical
+ * definitions live in `../errors.ts`. This module is listed in `knip.json`'s
+ * `ignoreExportsUsedInFile` because its exports are only consumed by the
+ * sibling test.
+ */
+export { PortweaveError, type PortweaveErrorCode, PW_ERROR_CODES, } from '../errors.ts';
+//# sourceMappingURL=error-passthrough.d.ts.map

package/dist/runtime/error-passthrough.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-passthrough.d.ts","sourceRoot":"","sources":["../../src/runtime/error-passthrough.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,cAAc,GACf,MAAM,cAAc,CAAA"}

package/dist/runtime/error-passthrough.js

@@ -0,0 +1,20 @@
+/**
+ * Error passthrough contract for the runtime library.
+ *
+ * The runtime functions pass upstream errors through to the caller unchanged —
+ * the `code` and `message` from the originating module reach the top-level
+ * `Result.error` without wrapping. This module documents and re-exports the
+ * error codes the runtime can surface, so callers can dispatch on them.
+ *
+ * See .ai/specs/library-runtime/library-runtime.md §Error handling for the
+ * full error table.
+ *
+ * Module note: structure:check pairs every `*.test.ts` with a sibling source
+ * file. `error-passthrough.test.ts` (which asserts the passthrough contract)
+ * pairs with this file. The re-exports are intentionally thin — the canonical
+ * definitions live in `../errors.ts`. This module is listed in `knip.json`'s
+ * `ignoreExportsUsedInFile` because its exports are only consumed by the
+ * sibling test.
+ */
+export { PortweaveError, PW_ERROR_CODES, } from "../errors.js";
+//# sourceMappingURL=error-passthrough.js.map

package/dist/runtime/error-passthrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-passthrough.js","sourceRoot":"","sources":["../../src/runtime/error-passthrough.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,cAAc,EAEd,cAAc,GACf,MAAM,cAAc,CAAA"}

package/dist/runtime/exports-smoke.d.ts

@@ -0,0 +1,4 @@
+export declare const FIXTURE_CONSUMER_CONFIG: string;
+export declare function makeConsumerProject(consumerDir: string, packFile: string): Promise<void>;
+export declare function makeTmpSmokeDir(label: string): Promise<string>;
+//# sourceMappingURL=exports-smoke.d.ts.map

package/dist/runtime/exports-smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports-smoke.d.ts","sourceRoot":"","sources":["../../src/runtime/exports-smoke.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,uBAAuB,QAElC,CAAA;AAEF,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpE"}

package/dist/runtime/exports-smoke.js

@@ -0,0 +1,36 @@
+/**
+ * Utilities for the exports smoke test. These helpers create a minimal
+ * consumer project that installs portweave from a local pack file, then
+ * verifies that `import { ports } from 'portweave/runtime'` resolves correctly.
+ *
+ * Kept as a named module so the structure:check tooling can pair it with
+ * `exports-smoke.test.ts`.
+ */
+import { execFile } from 'node:child_process';
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export const FIXTURE_CONSUMER_CONFIG = JSON.stringify({
+    services: { api: { envVar: 'API_PORT' } },
+});
+export async function makeConsumerProject(consumerDir, packFile) {
+    await writeFile(join(consumerDir, 'package.json'), JSON.stringify({
+        dependencies: { portweave: `file:${packFile}` },
+        name: 'smoke-consumer',
+        type: 'module',
+        version: '0.0.0',
+    }));
+    await execFileAsync('npm', ['install', '--prefer-offline', '--no-audit'], {
+        cwd: consumerDir,
+        env: { ...process.env, NODE_ENV: 'test' },
+    });
+    await writeFile(join(consumerDir, 'portweave.config.json'), FIXTURE_CONSUMER_CONFIG);
+}
+export async function makeTmpSmokeDir(label) {
+    // Use mkdtemp to guarantee uniqueness; pid + Date.now() leaves a theoretical
+    // collision window under concurrent runs.
+    return mkdtemp(join(tmpdir(), `portweave-smoke-${label}-`));
+}
+//# sourceMappingURL=exports-smoke.js.map

package/dist/runtime/exports-smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports-smoke.js","sourceRoot":"","sources":["../../src/runtime/exports-smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC;IACpD,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE;CAC1C,CAAC,CAAA;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,QAAgB;IAEhB,MAAM,SAAS,CACb,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACjC,IAAI,CAAC,SAAS,CAAC;QACb,YAAY,EAAE,EAAE,SAAS,EAAE,QAAQ,QAAQ,EAAE,EAAE;QAC/C,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;KACjB,CAAC,CACH,CAAA;IACD,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE;QACxE,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC1C,CAAC,CAAA;IACF,MAAM,SAAS,CACb,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAC1C,uBAAuB,CACxB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa;IACjD,6EAA6E;IAC7E,0CAA0C;IAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,KAAK,GAAG,CAAC,CAAC,CAAA;AAC7D,CAAC"}