portweave 0.1.0

package/dist/config/schema.js

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+const SERVICE_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+const ENV_VAR_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+const PLACEHOLDER_PATTERN = /\$\{([^}]+)\}/g;
+const PORT_MIN = 1;
+const PORT_MAX = 65535;
+const envVarSchema = z
+    .string()
+    .regex(ENV_VAR_PATTERN, 'envVar must match /^[A-Z][A-Z0-9_]*$/');
+const discoveryEnvSchema = z.record(envVarSchema, z.string());
+const serviceEntrySchema = z.strictObject({
+    discoveryEnv: discoveryEnvSchema.optional(),
+    envVar: envVarSchema,
+    group: z.string().min(1, 'group must be a non-empty string').optional(),
+    preferred: z
+        .int('preferred must be an integer')
+        .min(PORT_MIN, `preferred must be >= ${String(PORT_MIN)}`)
+        .max(PORT_MAX, `preferred must be <= ${String(PORT_MAX)}`)
+        .optional(),
+});
+const servicesMapSchema = z
+    .record(z.string().regex(SERVICE_NAME_PATTERN, 'service name must be kebab-case'), serviceEntrySchema)
+    .refine((value) => Object.keys(value).length > 0, {
+    error: 'services must contain at least one entry',
+});
+const configFileSchema = z.strictObject({
+    $schema: z.string().optional(),
+    services: servicesMapSchema,
+});
+function formatZodIssues(error) {
+    return error.issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+        return `${path}: ${issue.message}`;
+    })
+        .join('\n');
+}
+function collectPlaceholders(value) {
+    const found = [];
+    for (const match of value.matchAll(PLACEHOLDER_PATTERN)) {
+        found.push(match[1]);
+    }
+    return found;
+}
+function checkCrossFieldRules(raw) {
+    const ctx = {
+        errors: [],
+        seen: new Map(),
+        serviceNames: new Set(Object.keys(raw.services)),
+    };
+    for (const [name, entry] of Object.entries(raw.services)) {
+        recordEnvVar(name, entry, ctx);
+        checkDiscoveryEnv(name, entry, ctx);
+    }
+    return ctx.errors;
+}
+function recordEnvVar(name, entry, ctx) {
+    const owner = `services.${name}.envVar`;
+    const prior = ctx.seen.get(entry.envVar);
+    if (prior !== undefined) {
+        ctx.errors.push(`${owner}: duplicate identifier "${entry.envVar}" already declared at ${prior}`);
+        return;
+    }
+    ctx.seen.set(entry.envVar, owner);
+}
+function checkDiscoveryEnv(name, entry, ctx) {
+    if (entry.discoveryEnv === undefined) {
+        return;
+    }
+    for (const [envKey, template] of Object.entries(entry.discoveryEnv)) {
+        const owner = `services.${name}.discoveryEnv.${envKey}`;
+        const prior = ctx.seen.get(envKey);
+        if (prior !== undefined) {
+            ctx.errors.push(`${owner}: duplicate identifier "${envKey}" already declared at ${prior}`);
+        }
+        else {
+            ctx.seen.set(envKey, owner);
+        }
+        for (const placeholder of collectPlaceholders(template)) {
+            if (!ctx.serviceNames.has(placeholder)) {
+                ctx.errors.push(`${owner}: template references unknown service "${placeholder}"`);
+            }
+        }
+    }
+}
+// SERVICE_NAME_PATTERN (^[a-z][a-z0-9-]*$) is load-bearing for stable service
+// ordering: V8 reorders purely-numeric keys ahead of other keys, so requiring
+// names to start with [a-z] ensures JSON.parse insertion-order is preserved.
+function normalize(raw, ctx) {
+    const services = Object.entries(raw.services).map(([name, entry]) => ({
+        discoveryEnv: entry.discoveryEnv ?? {},
+        envVar: entry.envVar,
+        ...(entry.group !== undefined ? { group: entry.group } : {}),
+        name,
+        ...(entry.preferred !== undefined ? { preferred: entry.preferred } : {}),
+    }));
+    const groups = {};
+    for (const service of services) {
+        if (service.group !== undefined) {
+            const bucket = groups[service.group] ?? [];
+            bucket.push(service.name);
+            groups[service.group] = bucket;
+        }
+    }
+    return {
+        groups,
+        services,
+        source: ctx.source,
+        ...(ctx.sourcePath !== undefined ? { sourcePath: ctx.sourcePath } : {}),
+    };
+}
+export function validateAndNormalizeConfig(input, ctx) {
+    const parsed = configFileSchema.safeParse(input);
+    if (!parsed.success) {
+        return err(new PortweaveError(PW_ERROR_CODES.CONFIG_INVALID, formatZodIssues(parsed.error)));
+    }
+    const crossFieldErrors = checkCrossFieldRules(parsed.data);
+    if (crossFieldErrors.length > 0) {
+        return err(new PortweaveError(PW_ERROR_CODES.CONFIG_INVALID, crossFieldErrors.join('\n')));
+    }
+    return ok(normalize(parsed.data, ctx));
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/env/build.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '../config/index.ts';
+import type { Allocation } from '../allocator/allocate.ts';
+export declare function buildEnvMap(allocation: Allocation, config: Config): Record<string, string>;
+//# sourceMappingURL=build.d.ts.map

package/dist/env/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/env/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAG1D,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB"}

package/dist/env/build.js

@@ -0,0 +1,17 @@
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { evaluateTemplate } from "./templates.js";
+export function buildEnvMap(allocation, config) {
+    const result = {};
+    for (const service of config.services) {
+        if (!Object.hasOwn(allocation.ports, service.name)) {
+            throw new PortweaveError(PW_ERROR_CODES.ENV_BUILD_INVALID, `service "${service.name}" has no port in the allocation — config/allocation drift detected`);
+        }
+        const port = allocation.ports[service.name];
+        result[service.envVar] = String(port);
+        for (const [discoveryKey, template] of Object.entries(service.discoveryEnv)) {
+            result[discoveryKey] = evaluateTemplate(template, allocation.ports);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=build.js.map

package/dist/env/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/env/build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,UAAU,WAAW,CACzB,UAAsB,EACtB,MAAc;IAEd,MAAM,MAAM,GAA2B,EAAE,CAAA;IAEzC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,cAAc,CACtB,cAAc,CAAC,iBAAiB,EAChC,YAAY,OAAO,CAAC,IAAI,oEAAoE,CAC7F,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAErC,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CACnD,OAAO,CAAC,YAAY,CACrB,EAAE,CAAC;YACF,MAAM,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/env/dotenv-merge.d.ts

@@ -0,0 +1,5 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+export declare function readDotenvFile(path: string): Promise<Result<Record<string, string>, PortweaveError>>;
+export declare function applyDotenvOverrides(computed: Readonly<Record<string, string>>, dotenv: Readonly<Record<string, string>>): Record<string, string>;
+//# sourceMappingURL=dotenv-merge.d.ts.map

package/dist/env/dotenv-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotenv-merge.d.ts","sourceRoot":"","sources":["../../src/env/dotenv-merge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAkDnD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CA+BzD;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}

package/dist/env/dotenv-merge.js

@@ -0,0 +1,73 @@
+import { readFile } from 'node:fs/promises';
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+import { err, ok } from "../result.js";
+// Matches KEY=value, KEY="value", KEY='value' — key must start with a letter
+// or underscore and contain only word chars.
+const DOTENV_LINE_PATTERN = /^([A-Za-z_][A-Za-z0-9_]*)=(["']?)(.*)(\2)$/;
+function parseLine(line, lineNumber) {
+    const trimmed = line.trim();
+    // Skip blank lines and comment lines
+    if (trimmed === '' || trimmed.startsWith('#')) {
+        return ok({ key: '', value: '' });
+    }
+    const match = DOTENV_LINE_PATTERN.exec(trimmed);
+    if (match === null) {
+        return err(new PortweaveError(PW_ERROR_CODES.ENV_DOTENV_PARSE_FAILED, `malformed .env line ${String(lineNumber)}: ${trimmed}`));
+    }
+    const key = match[1];
+    const quote = match[2];
+    let value;
+    if (quote === '"' || quote === "'") {
+        // Strip surrounding quotes (match group 3 is the inner content).
+        // `#` inside a quoted value is treated literally per dotenv convention.
+        value = match[3];
+    }
+    else {
+        // Unquoted: everything after the =. Strip inline trailing comments
+        // (` # ...` to end-of-line) since unquoted values cannot contain a `#`
+        // literal without breaking dotenv consumers. Users who need a literal
+        // `#` should quote the value.
+        const eqIndex = trimmed.indexOf('=');
+        const raw = trimmed.slice(eqIndex + 1);
+        const commentMatch = /\s+#.*$/.exec(raw);
+        value =
+            commentMatch === null ? raw : raw.slice(0, commentMatch.index).trimEnd();
+    }
+    return ok({ key, value });
+}
+export async function readDotenvFile(path) {
+    let content;
+    try {
+        content = await readFile(path, 'utf-8');
+    }
+    catch (caught) {
+        if (typeof caught === 'object' &&
+            caught !== null &&
+            'code' in caught &&
+            caught.code === 'ENOENT') {
+            return ok({});
+        }
+        throw caught;
+    }
+    const result = {};
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        const parsed = parseLine(line, i + 1);
+        if (!parsed.ok) {
+            return parsed;
+        }
+        // Blank lines and comments produce key='' — skip them
+        if (parsed.value.key !== '') {
+            result[parsed.value.key] = parsed.value.value;
+        }
+    }
+    return ok(result);
+}
+export function applyDotenvOverrides(computed, dotenv) {
+    const result = {};
+    for (const [key, computedValue] of Object.entries(computed)) {
+        result[key] = key in dotenv ? dotenv[key] : computedValue;
+    }
+    return result;
+}
+//# sourceMappingURL=dotenv-merge.js.map

package/dist/env/dotenv-merge.js.map

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

package/dist/env/index.d.ts

@@ -0,0 +1,4 @@
+export { buildEnvMap } from './build.ts';
+export { type ResolvedEnv, resolveEnv } from './resolve.ts';
+export { evaluateTemplate } from './templates.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,KAAK,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/env/index.js

@@ -0,0 +1,4 @@
+export { buildEnvMap } from "./build.js";
+export { resolveEnv } from "./resolve.js";
+export { evaluateTemplate } from "./templates.js";
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAoB,UAAU,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/env/resolve.d.ts

@@ -0,0 +1,11 @@
+import type { Allocation } from '../allocator/allocate.ts';
+import type { Config } from '../config/index.ts';
+import { type PortweaveError as PortweaveErrorType } from '../errors.ts';
+import { type Result } from '../result.ts';
+export interface ResolvedEnv {
+    readonly createdPortweaveDir: boolean;
+    readonly currentEnvPath: string;
+    readonly env: Readonly<Record<string, string>>;
+}
+export declare function resolveEnv(allocation: Allocation, config: Config, projectRoot: string): Promise<Result<ResolvedEnv, PortweaveErrorType>>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/env/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/env/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAEL,KAAK,cAAc,IAAI,kBAAkB,EAC1C,MAAM,cAAc,CAAA;AACrB,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AAKnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC/C;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAuBlD"}

package/dist/env/resolve.js

@@ -0,0 +1,29 @@
+import { resolve } from 'node:path';
+import { PortweaveError, } from "../errors.js";
+import { err, ok } from "../result.js";
+import { buildEnvMap } from "./build.js";
+import { applyDotenvOverrides, readDotenvFile } from "./dotenv-merge.js";
+import { atomicWriteDotenv, ensurePortweaveDir } from "./writer.js";
+export async function resolveEnv(allocation, config, projectRoot) {
+    let computed;
+    try {
+        computed = buildEnvMap(allocation, config);
+    }
+    catch (caught) {
+        if (caught instanceof PortweaveError) {
+            return err(caught);
+        }
+        throw caught;
+    }
+    const dotenvPath = resolve(projectRoot, '.env');
+    const dotenvResult = await readDotenvFile(dotenvPath);
+    if (!dotenvResult.ok) {
+        return dotenvResult;
+    }
+    const final = applyDotenvOverrides(computed, dotenvResult.value);
+    const { created } = await ensurePortweaveDir(projectRoot);
+    const currentEnvPath = resolve(projectRoot, '.portweave/current.env');
+    await atomicWriteDotenv(currentEnvPath, final);
+    return ok({ createdPortweaveDir: created, currentEnvPath, env: final });
+}
+//# sourceMappingURL=resolve.js.map

package/dist/env/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/env/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EACL,cAAc,GAEf,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAQnE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,UAAsB,EACtB,MAAc,EACd,WAAmB;IAEnB,IAAI,QAAgC,CAAA;IACpC,IAAI,CAAC;QACH,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAC5C,CAAC;IAAC,OAAO,MAAe,EAAE,CAAC;QACzB,IAAI,MAAM,YAAY,cAAc,EAAE,CAAC;YACrC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,MAAM,CAAA;IACd,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC/C,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;QACrB,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IAChE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAA;IACzD,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAA;IACrE,MAAM,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;IAE9C,OAAO,EAAE,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;AACzE,CAAC"}

package/dist/env/templates.d.ts

@@ -0,0 +1,2 @@
+export declare function evaluateTemplate(template: string, ports: Readonly<Record<string, number>>): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/env/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/env/templates.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,MAAM,CAUR"}

package/dist/env/templates.js

@@ -0,0 +1,11 @@
+import { PortweaveError, PW_ERROR_CODES } from "../errors.js";
+const PLACEHOLDER_PATTERN = /\$\{([^}]+)\}/g;
+export function evaluateTemplate(template, ports) {
+    return template.replaceAll(PLACEHOLDER_PATTERN, (_, name) => {
+        if (!Object.hasOwn(ports, name)) {
+            throw new PortweaveError(PW_ERROR_CODES.ENV_BUILD_INVALID, `discoveryEnv template references unknown service "${name}"`);
+        }
+        return String(ports[name]);
+    });
+}
+//# sourceMappingURL=templates.js.map

package/dist/env/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/env/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7D,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AAE5C,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,KAAuC;IAEvC,OAAO,QAAQ,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QAClE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,cAAc,CACtB,cAAc,CAAC,iBAAiB,EAChC,qDAAqD,IAAI,GAAG,CAC7D,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/env/writer.d.ts

@@ -0,0 +1,6 @@
+export declare function serializeDotenv(env: Readonly<Record<string, string>>): string;
+export declare function ensurePortweaveDir(projectRoot: string): Promise<{
+    created: boolean;
+}>;
+export declare function atomicWriteDotenv(path: string, env: Readonly<Record<string, string>>): Promise<void>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/env/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/env/writer.ts"],"names":[],"mappings":"AAcA,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAc7E;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuC/B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/env/writer.js

@@ -0,0 +1,68 @@
+import { access, mkdir, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const NEEDS_QUOTING = /[\s#$"'\\]/;
+function shouldQuote(value) {
+    return NEEDS_QUOTING.test(value);
+}
+function quoteValue(value) {
+    const escaped = value.replaceAll('\\', '\\\\').replaceAll('"', '\\"');
+    return `"${escaped}"`;
+}
+export function serializeDotenv(env) {
+    const keys = Object.keys(env).sort();
+    if (keys.length === 0) {
+        return '';
+    }
+    return (keys
+        .map((key) => {
+        const value = env[key];
+        const serializedValue = shouldQuote(value) ? quoteValue(value) : value;
+        return `${key}=${serializedValue}`;
+    })
+        .join('\n') + '\n');
+}
+export async function ensurePortweaveDir(projectRoot) {
+    const portweaveDir = join(projectRoot, '.portweave');
+    const gitignorePath = join(portweaveDir, '.gitignore');
+    // Try to access the directory to check if it already exists
+    let dirAlreadyExisted = true;
+    try {
+        await access(portweaveDir);
+    }
+    catch {
+        // pw-allow-swallow: access throws ENOENT when dir is absent; we handle
+        // the "did not exist" case below by setting the flag.
+        dirAlreadyExisted = false;
+    }
+    await mkdir(portweaveDir, { mode: 0o700, recursive: true });
+    if (!dirAlreadyExisted) {
+        // First creation — write the .gitignore
+        await writeFile(gitignorePath, '*\n', { encoding: 'utf-8', flag: 'wx' });
+        return { created: true };
+    }
+    // Directory already existed — ensure .gitignore exists but don't overwrite
+    try {
+        await access(gitignorePath);
+        // .gitignore already present — nothing to do
+    }
+    catch {
+        // pw-allow-swallow: .gitignore absent even though dir existed (e.g. user
+        // deleted it manually). Write it now using 'wx' so a concurrent writer
+        // doesn't clobber an existing file.
+        try {
+            await writeFile(gitignorePath, '*\n', { encoding: 'utf-8', flag: 'wx' });
+        }
+        catch {
+            // pw-allow-swallow: concurrent writer may have created it between our
+            // access check and writeFile — that outcome is fine for our purposes.
+        }
+    }
+    return { created: false };
+}
+export async function atomicWriteDotenv(path, env) {
+    const tempPath = `${path}.tmp.${process.pid.toString()}.${Date.now().toString()}`;
+    const contents = serializeDotenv(env);
+    await writeFile(tempPath, contents, { encoding: 'utf-8', mode: 0o600 });
+    await rename(tempPath, path);
+}
+//# sourceMappingURL=writer.js.map

package/dist/env/writer.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,22 @@
+export declare const PW_ERROR_CODES: {
+    readonly ALLOCATION_EXHAUSTED: "PW0401";
+    readonly CLI_CHILD_SPAWN_FAILED: "PW0602";
+    readonly CLI_INVALID_FLAGS: "PW0601";
+    readonly CLI_NO_ALLOCATION: "PW0603";
+    readonly CONFIG_INVALID: "PW0102";
+    readonly CONFIG_MISSING: "PW0101";
+    readonly ENV_BUILD_INVALID: "PW0501";
+    readonly ENV_DOTENV_PARSE_FAILED: "PW0502";
+    readonly NOT_A_GIT_REPO: "PW0201";
+    readonly REGISTRY_CORRUPT: "PW0302";
+    readonly REGISTRY_LOCKED: "PW0301";
+    readonly RUNTIME_CONFIG_NOT_FOUND: "PW0701";
+    readonly RUNTIME_NOT_INITIALIZED: "PW0702";
+    readonly WORKTREE_OFFSET_INVALID: "PW0202";
+};
+export type PortweaveErrorCode = (typeof PW_ERROR_CODES)[keyof typeof PW_ERROR_CODES];
+export declare class PortweaveError extends Error {
+    readonly code: PortweaveErrorCode;
+    constructor(code: PortweaveErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAiBuB,CAAA;AAElD,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;AAItD,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;gBAErB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAMtD"}

package/dist/errors.js

@@ -0,0 +1,32 @@
+// Seed PW error codes. PW#### grouped by component in 100-blocks — see
+// the table in .ai/specs/result-types/result-types.md.
+export const PW_ERROR_CODES = {
+    ALLOCATION_EXHAUSTED: 'PW0401',
+    CLI_CHILD_SPAWN_FAILED: 'PW0602',
+    CLI_INVALID_FLAGS: 'PW0601',
+    CLI_NO_ALLOCATION: 'PW0603',
+    CONFIG_INVALID: 'PW0102',
+    CONFIG_MISSING: 'PW0101',
+    ENV_BUILD_INVALID: 'PW0501',
+    ENV_DOTENV_PARSE_FAILED: 'PW0502',
+    NOT_A_GIT_REPO: 'PW0201',
+    REGISTRY_CORRUPT: 'PW0302',
+    REGISTRY_LOCKED: 'PW0301',
+    // PW07xx — library-runtime block (see .ai/specs/library-runtime)
+    RUNTIME_CONFIG_NOT_FOUND: 'PW0701',
+    // PW0702 reserved for future cached-state failure; not emitted at v0
+    RUNTIME_NOT_INITIALIZED: 'PW0702',
+    WORKTREE_OFFSET_INVALID: 'PW0202',
+};
+// Carries a stable PW#### code for cross-module dispatch. The setPrototypeOf
+// call is load-bearing for `instanceof` under transpilation — do not remove.
+export class PortweaveError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'PortweaveError';
+        this.code = code;
+        Object.setPrototypeOf(this, PortweaveError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,oBAAoB,EAAE,QAAQ;IAC9B,sBAAsB,EAAE,QAAQ;IAChC,iBAAiB,EAAE,QAAQ;IAC3B,iBAAiB,EAAE,QAAQ;IAC3B,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,QAAQ;IACxB,iBAAiB,EAAE,QAAQ;IAC3B,uBAAuB,EAAE,QAAQ;IACjC,cAAc,EAAE,QAAQ;IACxB,gBAAgB,EAAE,QAAQ;IAC1B,eAAe,EAAE,QAAQ;IACzB,iEAAiE;IACjE,wBAAwB,EAAE,QAAQ;IAClC,qEAAqE;IACrE,uBAAuB,EAAE,QAAQ;IACjC,uBAAuB,EAAE,QAAQ;CACe,CAAA;AAKlD,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAoB;IAEjC,YAAY,IAAwB,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IACvD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { allocate, type Allocation, type AllocationResult, MAX_PROBE_RETRIES, orderServicesForAllocation, } from './allocator/allocate.ts';
+export { findFreeBlock, resolvePoolRange } from './allocator/pool.ts';
+export { probeBlock, probePort } from './allocator/probe.ts';
+export { type Config, loadConfig, type LoadConfigOptions, type ServiceSpec, synthesizeAnonymousConfig, } from './config/index.ts';
+export { buildEnvMap, evaluateTemplate, type ResolvedEnv, resolveEnv, } from './env/index.ts';
+export { PortweaveError, type PortweaveErrorCode, PW_ERROR_CODES, } from './errors.ts';
+export { andThen, err, ok, type Result } from './result.ts';
+export { detectGitWorktreeContext, type GitWorktreeContext, } from './worktree/git.ts';
+export { type AllocationKey, resolveAllocationKey } from './worktree/key.ts';
+export { deriveNamespace, MAIN_NAMESPACE, namespaceOverride, parseExplicitOffset, sanitizeNamespace, } from './worktree/namespace.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EACL,KAAK,MAAM,EACX,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,WAAW,EAChB,UAAU,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,KAAK,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { allocate, MAX_PROBE_RETRIES, orderServicesForAllocation, } from "./allocator/allocate.js";
+export { findFreeBlock, resolvePoolRange } from "./allocator/pool.js";
+export { probeBlock, probePort } from "./allocator/probe.js";
+export { loadConfig, synthesizeAnonymousConfig, } from "./config/index.js";
+export { buildEnvMap, evaluateTemplate, resolveEnv, } from "./env/index.js";
+export { PortweaveError, PW_ERROR_CODES, } from "./errors.js";
+export { andThen, err, ok } from "./result.js";
+export { detectGitWorktreeContext, } from "./worktree/git.js";
+export { resolveAllocationKey } from "./worktree/key.js";
+export { deriveNamespace, MAIN_NAMESPACE, namespaceOverride, parseExplicitOffset, sanitizeNamespace, } from "./worktree/namespace.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAGR,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAEL,UAAU,EAGV,yBAAyB,GAC1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,WAAW,EACX,gBAAgB,EAEhB,UAAU,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,cAAc,EAEd,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,aAAa,CAAA;AAC3D,OAAO,EACL,wBAAwB,GAEzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAsB,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,yBAAyB,CAAA"}

package/dist/registry/atomic-write.d.ts

@@ -0,0 +1,3 @@
+export declare function atomicWriteRegistry(path: string, contents: string): Promise<void>;
+export declare function pruneStaleTempFiles(path: string): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/registry/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/registry/atomic-write.ts"],"names":[],"mappings":"AAKA,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCrE"}

package/dist/registry/atomic-write.js

@@ -0,0 +1,43 @@
+import { readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+const TMP_SIBLING_TTL_MS = 60_000;
+export async function atomicWriteRegistry(path, contents) {
+    const tempPath = `${path}.tmp.${process.pid.toString()}.${Date.now().toString()}`;
+    await writeFile(tempPath, contents, { encoding: 'utf-8', mode: 0o600 });
+    await rename(tempPath, path);
+}
+export async function pruneStaleTempFiles(path) {
+    const dir = dirname(path);
+    const prefix = `${basename(path)}.tmp.`;
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch (caught) {
+        if (typeof caught === 'object' &&
+            caught !== null &&
+            'code' in caught &&
+            caught.code === 'ENOENT') {
+            return;
+        }
+        throw caught;
+    }
+    const now = Date.now();
+    for (const name of entries) {
+        if (!name.startsWith(prefix)) {
+            continue;
+        }
+        const candidate = join(dir, name);
+        try {
+            const info = await stat(candidate);
+            if (now - info.mtimeMs > TMP_SIBLING_TTL_MS) {
+                await rm(candidate, { force: true });
+            }
+        }
+        catch {
+            // pw-allow-swallow: tempfile may vanish between readdir and stat;
+            // a concurrent writer's cleanup is not a failure for our caller.
+        }
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/registry/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/registry/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEnD,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAEjC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,QAAgB;IAEhB,MAAM,QAAQ,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAA;IACjF,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACvE,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAA;IACvC,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,MAAe,EAAE,CAAC;QACzB,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,MAAM,IAAI,MAAM;YAChB,MAAM,CAAC,IAAI,KAAK,QAAQ,EACxB,CAAC;YACD,OAAM;QACR,CAAC;QACD,MAAM,MAAM,CAAA;IACd,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAA;YAClC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,kBAAkB,EAAE,CAAC;gBAC5C,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;YAClE,iEAAiE;QACnE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/registry/lock.d.ts

@@ -0,0 +1,4 @@
+import { PortweaveError } from '../errors.ts';
+import { type Result } from '../result.ts';
+export declare function withLock<T>(lockDir: string, fn: () => Promise<T>): Promise<Result<T, PortweaveError>>;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/registry/lock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAA;AA+EnD,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAqBpC"}