portweave 0.1.0

package/dist/cli/show.d.ts

@@ -0,0 +1,21 @@
+import type { Command } from 'commander';
+import type { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+export interface ShowOptions {
+    cwd?: string;
+    /**
+     * Test-injection override for process.env. Scoped XDG_CONFIG_HOME and
+     * other env vars flow through to `withRegistry`. Defaults to `process.env`
+     * in production. See `src/cli/__tests__/show.test.ts` for usage.
+     */
+    env?: NodeJS.ProcessEnv;
+    json?: boolean;
+    stderr?: NodeJS.WritableStream;
+    stdout?: NodeJS.WritableStream;
+}
+export interface ShowOutcome {
+    readonly exitCode: number;
+}
+export declare function runShow(options: ShowOptions): Promise<Result<ShowOutcome, PortweaveError>>;
+export declare function registerShowCommand(program: Command): void;
+//# sourceMappingURL=show.d.ts.map

package/dist/cli/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/cli/show.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAM9C,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAoHD,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAoC9C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa1D"}

package/dist/cli/show.js

@@ -0,0 +1,141 @@
+import { buildEnvMap } from "../env/index.js";
+import { ok } from "../result.js";
+import { withRegistry } from "../registry/storage.js";
+import { loadConfig } from "../config/index.js";
+import { resolveAllocationKey } from "../worktree/key.js";
+import { formatAllocationBanner } from "./banner.js";
+const NO_ALLOCATION_JSON = '{"error":"no-allocation"}\n';
+const NO_ALLOCATION_MSG = '[portweave] no allocation for this worktree — run "portweave run" first\n';
+// Checks equality by the three key fields withRegistry uses internally.
+function keysEqual(a, b) {
+    return (a.gitCommonDir === b.gitCommonDir &&
+        a.namespace === b.namespace &&
+        a.worktreeRoot === b.worktreeRoot);
+}
+function writeOut(stream, text) {
+    return new Promise((resolve, reject) => {
+        stream.write(text, (writeErr) => {
+            if (writeErr) {
+                reject(writeErr);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+function buildJsonPayload(entry, envMap) {
+    // Top-level keys alphabetically sorted per spec.
+    const payload = {
+        env: sortedObject(envMap),
+        namespace: entry.namespace,
+        ports: sortedObject(entry.ports),
+        worktreeRoot: entry.key.worktreeRoot,
+    };
+    return JSON.stringify(payload, null, 2) + '\n';
+}
+// T is constrained to the JSON-leaf types we actually use (string for env,
+// number for ports). The constraint documents valid usage and lets the
+// type narrowing through index access stay sound under future strictness.
+function sortedObject(obj) {
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+        sorted[key] = obj[key];
+    }
+    return sorted;
+}
+function lookupEntry(key, processEnv) {
+    return withRegistry((handle) => {
+        const found = handle.entries.find((e) => keysEqual(e.key, key));
+        if (found === undefined) {
+            return null;
+        }
+        handle.touch(key);
+        // Return the post-touch entry
+        const touched = handle.entries.find((e) => keysEqual(e.key, key));
+        return touched ?? found;
+    }, processEnv);
+}
+async function emitOutput(args) {
+    const { config, entry, json, stderr, stdout } = args;
+    if (!json) {
+        const banner = formatAllocationBanner({
+            allocation: entry,
+            config,
+            reused: true,
+        });
+        await writeOut(stdout, banner);
+        return 0;
+    }
+    let envMap;
+    try {
+        envMap = buildEnvMap(entry, config);
+    }
+    catch (caught) {
+        const msg = caught instanceof Error ? caught.message : String(caught);
+        await writeOut(stderr, `[portweave] ${msg}\n`);
+        return 1;
+    }
+    await writeOut(stdout, buildJsonPayload(entry, envMap));
+    return 0;
+}
+async function resolveInputs(cwd) {
+    const keyResult = resolveAllocationKey(cwd);
+    if (!keyResult.ok) {
+        return keyResult;
+    }
+    const configResult = await loadConfig(keyResult.value.worktreeRoot);
+    if (!configResult.ok) {
+        return configResult;
+    }
+    return ok({ config: configResult.value, key: keyResult.value });
+}
+export async function runShow(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const processEnv = options.env ?? process.env;
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const json = options.json === true;
+    const inputsResult = await resolveInputs(cwd);
+    if (!inputsResult.ok) {
+        await writeOut(stderr, `[portweave] ${inputsResult.error.message}\n`);
+        return ok({ exitCode: 1 });
+    }
+    const { config, key } = inputsResult.value;
+    const registryResult = await lookupEntry(key, processEnv);
+    if (!registryResult.ok) {
+        await writeOut(stderr, `[portweave] ${registryResult.error.message}\n`);
+        return ok({ exitCode: 1 });
+    }
+    if (registryResult.value === null) {
+        await writeOut(stdout, json ? NO_ALLOCATION_JSON : '');
+        if (!json) {
+            await writeOut(stderr, NO_ALLOCATION_MSG);
+        }
+        return ok({ exitCode: 1 });
+    }
+    const exitCode = await emitOutput({
+        config,
+        entry: registryResult.value,
+        json,
+        stderr,
+        stdout,
+    });
+    return ok({ exitCode });
+}
+export function registerShowCommand(program) {
+    program
+        .command('show')
+        .description('Print the port allocation for the current worktree')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        const result = await runShow({ json: opts.json });
+        if (!result.ok) {
+            process.stderr.write(`[portweave] ${result.error.message}\n`);
+            process.exit(1);
+        }
+        process.exit(result.value.exitCode);
+    });
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/show.js.map

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

package/dist/cli/spawn.d.ts

@@ -0,0 +1,30 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+import type { RunIo } from './run.ts';
+export interface SpawnChildOptions {
+    env: NodeJS.ProcessEnv;
+    io: Pick<RunIo, 'stderr' | 'stdout'>;
+    signal?: AbortSignal;
+}
+export interface SpawnChildResult {
+    exitCode: null | number;
+    signal: NodeJS.Signals | null;
+}
+/**
+ * Spawns a child process with `stdio: 'inherit'`, forwards SIGINT and SIGTERM,
+ * and resolves with the child's exit status.
+ *
+ * - Resolves with `ok({ exitCode, signal })` on any child exit (including non-zero).
+ * - Returns `err(PortweaveError(CLI_CHILD_SPAWN_FAILED))` if the child fails to start.
+ * - If `signal` is provided, aborts by sending SIGTERM to the child when the signal fires.
+ */
+export declare function spawnChild(argv: readonly string[], options: SpawnChildOptions): Promise<Result<SpawnChildResult, PortweaveError>>;
+/**
+ * Converts a `SpawnChildResult` into a numeric exit code following POSIX
+ * shell conventions:
+ * - exitCode is returned as-is when not null
+ * - signal termination → 128 + signal number
+ * - unknown termination → 1
+ */
+export declare function resolveExitCode(result: SpawnChildResult): number;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/cli/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/cli/spawn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IAMtB,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAgEnD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUhE"}

package/dist/cli/spawn.js

@@ -0,0 +1,85 @@
+import { spawn } from 'node:child_process';
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+/**
+ * Spawns a child process with `stdio: 'inherit'`, forwards SIGINT and SIGTERM,
+ * and resolves with the child's exit status.
+ *
+ * - Resolves with `ok({ exitCode, signal })` on any child exit (including non-zero).
+ * - Returns `err(PortweaveError(CLI_CHILD_SPAWN_FAILED))` if the child fails to start.
+ * - If `signal` is provided, aborts by sending SIGTERM to the child when the signal fires.
+ */
+export function spawnChild(argv, options) {
+    if (argv.length === 0) {
+        return Promise.resolve(err(new PortweaveError(PW_ERROR_CODES.CLI_CHILD_SPAWN_FAILED, 'No command provided to spawnChild')));
+    }
+    const [cmd, ...args] = argv;
+    return new Promise((resolve) => {
+        // spawn (not exec) is used intentionally: no shell is involved, so shell
+        // metacharacters in argv are inert. Relative-path commands (e.g. ./my-script)
+        // are allowed — that is user-intent behavior, not a vulnerability, since the
+        // caller explicitly passed the command string.
+        const child = spawn(cmd, args, { env: options.env, stdio: 'inherit' });
+        const sigintHandler = () => {
+            child.kill('SIGINT');
+        };
+        const sigtermHandler = () => {
+            child.kill('SIGTERM');
+        };
+        process.on('SIGINT', sigintHandler);
+        process.on('SIGTERM', sigtermHandler);
+        let abortHandler;
+        if (options.signal !== undefined) {
+            abortHandler = () => {
+                child.kill('SIGTERM');
+            };
+            options.signal.addEventListener('abort', abortHandler);
+        }
+        function teardown() {
+            process.off('SIGINT', sigintHandler);
+            process.off('SIGTERM', sigtermHandler);
+            if (options.signal !== undefined && abortHandler !== undefined) {
+                options.signal.removeEventListener('abort', abortHandler);
+            }
+        }
+        child.on('error', (error) => {
+            teardown();
+            resolve(err(new PortweaveError(PW_ERROR_CODES.CLI_CHILD_SPAWN_FAILED, `failed to spawn "${cmd}": ${error.message}`)));
+        });
+        child.on('exit', (code, signal) => {
+            teardown();
+            resolve(ok({ exitCode: code, signal }));
+        });
+    });
+}
+/**
+ * Converts a `SpawnChildResult` into a numeric exit code following POSIX
+ * shell conventions:
+ * - exitCode is returned as-is when not null
+ * - signal termination → 128 + signal number
+ * - unknown termination → 1
+ */
+export function resolveExitCode(result) {
+    if (result.exitCode !== null) {
+        return result.exitCode;
+    }
+    if (result.signal !== null) {
+        return 128 + signalNumber(result.signal);
+    }
+    // Both exitCode and signal are null: child was killed externally before the
+    // exit event fired with meaningful values. Return 1 as a safe non-zero sentinel.
+    return 1;
+}
+const SIGNAL_NUMBERS = {
+    SIGABRT: 6,
+    SIGHUP: 1,
+    SIGINT: 2,
+    SIGKILL: 9,
+    SIGQUIT: 3,
+    SIGSTOP: 19,
+    SIGTERM: 15,
+};
+function signalNumber(signal) {
+    return SIGNAL_NUMBERS[signal] ?? 0;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/cli/spawn.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+export declare function buildCli(): Command;
+export declare function main(argv?: readonly string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,QAAQ,IAAI,OAAO,CAiBlC;AAED,wBAAsB,IAAI,CACxB,IAAI,GAAE,SAAS,MAAM,EAAiB,GACrC,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/cli.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { Command } from 'commander';
+import { PortweaveError } from "./errors.js";
+import { registerRunCommand } from "./cli/run.js";
+import { registerShowCommand } from "./cli/show.js";
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+export function buildCli() {
+    const program = new Command('portweave');
+    program
+        .version(pkg.version, '-V, --version', 'output the version number')
+        .description('Zero-thought, conflict-free local-dev port allocation across projects and git worktrees.')
+        .enablePositionalOptions()
+        .option('--config <path>', 'path to portweave config file')
+        .option('--count <n>', 'number of ports to allocate (anonymous mode)')
+        .option('--verbose', 'print additional diagnostic output');
+    registerRunCommand(program);
+    registerShowCommand(program);
+    return program;
+}
+export async function main(argv = process.argv) {
+    const program = buildCli();
+    try {
+        await program.parseAsync(argv);
+        const ec = process.exitCode;
+        return typeof ec === 'number' ? ec : 0;
+    }
+    catch (caught) {
+        if (caught instanceof PortweaveError) {
+            process.stderr.write(`[portweave] error: ${caught.message} (${caught.code})\n`);
+        }
+        else if (caught instanceof Error) {
+            process.stderr.write(`[portweave] error: ${caught.message}\n`);
+            const verbose = argv.includes('--verbose');
+            if (verbose && caught.stack !== undefined) {
+                process.stderr.write(caught.stack + '\n');
+            }
+        }
+        else {
+            process.stderr.write(`[portweave] error: unknown error\n`);
+        }
+        return 1;
+    }
+}
+// Entry point when run as a script
+if (import.meta.url === `file://${process.argv[1]}`) {
+    void main().then((code) => {
+        process.exit(code);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE7D,MAAM,UAAU,QAAQ;IACtB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IAExC,OAAO;SACJ,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC;SAClE,WAAW,CACV,0FAA0F,CAC3F;SACA,uBAAuB,EAAE;SACzB,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;SAC1D,MAAM,CAAC,aAAa,EAAE,8CAA8C,CAAC;SACrE,MAAM,CAAC,WAAW,EAAE,oCAAoC,CAAC,CAAA;IAE5D,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAC3B,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAE5B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAA0B,OAAO,CAAC,IAAI;IAEtC,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAA;IAE1B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAC9B,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAA;QAC3B,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC;IAAC,OAAO,MAAe,EAAE,CAAC;QACzB,IAAI,MAAM,YAAY,cAAc,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,IAAI,KAAK,CAC1D,CAAA;QACH,CAAC;aAAM,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,OAAO,IAAI,CAAC,CAAA;YAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YAC1C,IAAI,OAAO,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;YAC3C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAA;QAC5D,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/config/anonymous.d.ts

@@ -0,0 +1,5 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+import type { Config } from './schema.ts';
+export declare function synthesizeAnonymousConfig(count: number): Result<Config, PortweaveError>;
+//# sourceMappingURL=anonymous.d.ts.map

package/dist/config/anonymous.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymous.d.ts","sourceRoot":"","sources":["../../src/config/anonymous.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,aAAa,CAAA;AAKtD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAsBhC"}

package/dist/config/anonymous.js

@@ -0,0 +1,21 @@
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+const ANONYMOUS_COUNT_MIN = 1;
+const ANONYMOUS_COUNT_MAX = 100;
+export function synthesizeAnonymousConfig(count) {
+    if (!Number.isInteger(count) ||
+        count < ANONYMOUS_COUNT_MIN ||
+        count > ANONYMOUS_COUNT_MAX) {
+        return err(new PortweaveError(PW_ERROR_CODES.CONFIG_INVALID, `count must be an integer in [${String(ANONYMOUS_COUNT_MIN)}, ${String(ANONYMOUS_COUNT_MAX)}], received ${String(count)}`));
+    }
+    const services = [];
+    for (let i = 1; i <= count; i += 1) {
+        services.push({
+            discoveryEnv: {},
+            envVar: `PORT_${String(i)}`,
+            name: `port-${String(i)}`,
+        });
+    }
+    return ok({ groups: {}, services, source: 'anonymous' });
+}
+//# sourceMappingURL=anonymous.js.map

package/dist/config/anonymous.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymous.js","sourceRoot":"","sources":["../../src/config/anonymous.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,cAAc,CAAA;AAGnD,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAC7B,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B,MAAM,UAAU,yBAAyB,CACvC,KAAa;IAEb,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACxB,KAAK,GAAG,mBAAmB;QAC3B,KAAK,GAAG,mBAAmB,EAC3B,CAAC;QACD,OAAO,GAAG,CACR,IAAI,cAAc,CAChB,cAAc,CAAC,cAAc,EAC7B,gCAAgC,MAAM,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAAC,mBAAmB,CAAC,eAAe,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1H,CACF,CAAA;IACH,CAAC;IACD,MAAM,QAAQ,GAAkB,EAAE,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC;YACZ,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,EAAE;YAC3B,IAAI,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,EAAE;SAC1B,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;AAC1D,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+export { synthesizeAnonymousConfig } from './anonymous.ts';
+export { loadConfig, type LoadConfigOptions } from './loader.ts';
+export { type Config, type ServiceSpec } from './schema.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+export { synthesizeAnonymousConfig } from "./anonymous.js";
+export { loadConfig } from "./loader.js";
+export {} from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAiC,MAAM,aAAa,CAAA"}

package/dist/config/loader.d.ts

@@ -0,0 +1,8 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+import { type Config } from './schema.ts';
+export interface LoadConfigOptions {
+    configPath?: string;
+}
+export declare function loadConfig(cwd: string, opts?: LoadConfigOptions): Promise<Result<Config, PortweaveError>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,KAAK,MAAM,EAA8B,MAAM,aAAa,CAAA;AAIrE,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AA2DD,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAsBzC"}

package/dist/config/loader.js

@@ -0,0 +1,59 @@
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, resolve } from 'node:path';
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+import { validateAndNormalizeConfig } from "./schema.js";
+const DEFAULT_CONFIG_FILENAME = 'portweave.config.json';
+function resolveConfigPath(cwd, configPath) {
+    if (configPath === undefined) {
+        return resolve(cwd, DEFAULT_CONFIG_FILENAME);
+    }
+    return isAbsolute(configPath) ? configPath : resolve(cwd, configPath);
+}
+function describe(caught) {
+    return caught instanceof Error ? caught.message : String(caught);
+}
+async function readConfigFile(absolutePath) {
+    try {
+        const contents = await readFile(absolutePath, 'utf8');
+        return { contents, tag: 'ok' };
+    }
+    catch (caught) {
+        if (caught instanceof Error &&
+            'code' in caught &&
+            caught.code === 'ENOENT') {
+            return { tag: 'missing' };
+        }
+        return {
+            problem: new PortweaveError(PW_ERROR_CODES.CONFIG_INVALID, `failed to read ${absolutePath}: ${describe(caught)}`),
+            tag: 'error',
+        };
+    }
+}
+function parseJson(contents, absolutePath) {
+    try {
+        return ok(JSON.parse(contents));
+    }
+    catch (caught) {
+        return err(new PortweaveError(PW_ERROR_CODES.CONFIG_INVALID, `failed to parse JSON at ${absolutePath}: ${describe(caught)}`));
+    }
+}
+export async function loadConfig(cwd, opts) {
+    const absolutePath = resolveConfigPath(cwd, opts?.configPath);
+    const outcome = await readConfigFile(absolutePath);
+    if (outcome.tag === 'missing') {
+        return err(new PortweaveError(PW_ERROR_CODES.CONFIG_MISSING, `no portweave.config.json at ${absolutePath}`));
+    }
+    if (outcome.tag === 'error') {
+        return err(outcome.problem);
+    }
+    const parsed = parseJson(outcome.contents, absolutePath);
+    if (!parsed.ok) {
+        return parsed;
+    }
+    return validateAndNormalizeConfig(parsed.value, {
+        source: 'file',
+        sourcePath: absolutePath,
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,21 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+export interface ServiceSpec {
+    discoveryEnv: Record<string, string>;
+    envVar: string;
+    group?: string;
+    name: string;
+    preferred?: number;
+}
+export interface Config {
+    groups: Record<string, string[]>;
+    services: ServiceSpec[];
+    source: 'anonymous' | 'file';
+    sourcePath?: string;
+}
+export interface NormalizationContext {
+    source: 'anonymous' | 'file';
+    sourcePath?: string;
+}
+export declare function validateAndNormalizeConfig(input: unknown, ctx: NormalizationContext): Result<Config, PortweaveError>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AA0CnD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,MAAM,EAAE,WAAW,GAAG,MAAM,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAiHD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,oBAAoB,GACxB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAoBhC"}