mthds 0.0.6 → 0.0.8

package/dist/package/exceptions.js

@@ -0,0 +1,73 @@
+export class MthdsPackageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MthdsPackageError";
+    }
+}
+export class ManifestError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "ManifestError";
+    }
+}
+export class ManifestParseError extends ManifestError {
+    constructor(message) {
+        super(message);
+        this.name = "ManifestParseError";
+    }
+}
+export class ManifestValidationError extends ManifestError {
+    constructor(message) {
+        super(message);
+        this.name = "ManifestValidationError";
+    }
+}
+export class VCSFetchError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "VCSFetchError";
+    }
+}
+export class VersionResolutionError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "VersionResolutionError";
+    }
+}
+export class PackageCacheError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "PackageCacheError";
+    }
+}
+export class LockFileError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "LockFileError";
+    }
+}
+export class IntegrityError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "IntegrityError";
+    }
+}
+export class DependencyResolveError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "DependencyResolveError";
+    }
+}
+export class TransitiveDependencyError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "TransitiveDependencyError";
+    }
+}
+export class QualifiedRefError extends MthdsPackageError {
+    constructor(message) {
+        super(message);
+        this.name = "QualifiedRefError";
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/package/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/package/exceptions.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,iBAAiB;IAC3D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,iBAAiB;IAC3D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,iBAAiB;IAC9D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/package/lock-file.d.ts

@@ -0,0 +1,27 @@
+import { type ParsedManifest } from "./manifest/schema.js";
+export declare const LOCK_FILENAME = "methods.lock";
+export declare const HASH_PREFIX = "sha256:";
+export interface LockedPackage {
+    readonly version: string;
+    readonly hash: string;
+    readonly source: string;
+}
+export interface LockFile {
+    readonly packages: Record<string, LockedPackage>;
+}
+/**
+ * Compute a deterministic SHA-256 hash of a directory's contents.
+ * Sorts by POSIX-normalized relative path for cross-platform determinism.
+ */
+export declare function computeDirectoryHash(directory: string): string;
+export declare function parseLockFile(content: string): LockFile;
+export declare function serializeLockFile(lockFile: LockFile): string;
+export interface ResolvedDepForLock {
+    readonly alias: string;
+    readonly address: string;
+    readonly manifest: ParsedManifest | null;
+    readonly packageRoot: string;
+}
+export declare function generateLockFile(resolvedDeps: ResolvedDepForLock[]): LockFile;
+export declare function verifyLockedPackage(locked: LockedPackage, address: string, cacheRoot?: string): void;
+export declare function verifyLockFile(lockFile: LockFile, cacheRoot?: string): void;

package/dist/package/lock-file.js

@@ -0,0 +1,137 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative, posix, sep } from "node:path";
+import { parse, stringify } from "smol-toml";
+import { IntegrityError, LockFileError } from "./exceptions.js";
+import { isValidSemver } from "./manifest/schema.js";
+import { getCachedPackagePath } from "./package-cache.js";
+export const LOCK_FILENAME = "methods.lock";
+export const HASH_PREFIX = "sha256:";
+const HASH_PATTERN = /^sha256:[0-9a-f]{64}$/;
+// ---------------------------------------------------------------------------
+// Hash computation
+// ---------------------------------------------------------------------------
+function collectFilesRecursive(dir, baseDir, result) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        const relPath = relative(baseDir, fullPath);
+        const posixRelPath = relPath.split(sep).join(posix.sep);
+        // Skip .git
+        if (posixRelPath.split(posix.sep).includes(".git"))
+            continue;
+        if (entry.isFile()) {
+            result.push(fullPath);
+        }
+        else if (entry.isDirectory()) {
+            collectFilesRecursive(fullPath, baseDir, result);
+        }
+    }
+}
+/**
+ * Compute a deterministic SHA-256 hash of a directory's contents.
+ * Sorts by POSIX-normalized relative path for cross-platform determinism.
+ */
+export function computeDirectoryHash(directory) {
+    if (!existsSync(directory) || !statSync(directory).isDirectory()) {
+        throw new LockFileError(`Directory '${directory}' does not exist or is not a directory`);
+    }
+    const hasher = createHash("sha256");
+    const filePaths = [];
+    collectFilesRecursive(directory, directory, filePaths);
+    // Sort by POSIX relative path
+    filePaths.sort((a, b) => {
+        const relA = relative(directory, a).split(sep).join(posix.sep);
+        const relB = relative(directory, b).split(sep).join(posix.sep);
+        return relA < relB ? -1 : relA > relB ? 1 : 0;
+    });
+    for (const filePath of filePaths) {
+        const relativePosix = relative(directory, filePath).split(sep).join(posix.sep);
+        hasher.update(relativePosix, "utf-8");
+        hasher.update(readFileSync(filePath));
+    }
+    return `${HASH_PREFIX}${hasher.digest("hex")}`;
+}
+// ---------------------------------------------------------------------------
+// TOML parse / serialize
+// ---------------------------------------------------------------------------
+function validateLockedPackage(address, entry) {
+    const version = entry["version"];
+    if (typeof version !== "string" || !isValidSemver(version)) {
+        throw new LockFileError(`Invalid version '${version}' for '${address}' in lock file`);
+    }
+    const hash = entry["hash"];
+    if (typeof hash !== "string" || !HASH_PATTERN.test(hash)) {
+        throw new LockFileError(`Invalid hash for '${address}' in lock file`);
+    }
+    const source = entry["source"];
+    if (typeof source !== "string" || !source.startsWith("https://")) {
+        throw new LockFileError(`Invalid source '${source}' for '${address}' in lock file`);
+    }
+    return { version, hash, source };
+}
+export function parseLockFile(content) {
+    if (!content.trim()) {
+        return { packages: {} };
+    }
+    let raw;
+    try {
+        raw = parse(content);
+    }
+    catch (err) {
+        throw new LockFileError(`Invalid TOML syntax in lock file: ${err.message}`);
+    }
+    const packages = {};
+    for (const [address, entry] of Object.entries(raw)) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            throw new LockFileError(`Lock file entry for '${address}' must be a table, got ${typeof entry}`);
+        }
+        packages[address] = validateLockedPackage(address, entry);
+    }
+    return { packages };
+}
+export function serializeLockFile(lockFile) {
+    const doc = {};
+    for (const address of Object.keys(lockFile.packages).sort()) {
+        const locked = lockFile.packages[address];
+        doc[address] = {
+            version: locked.version,
+            hash: locked.hash,
+            source: locked.source,
+        };
+    }
+    return stringify(doc);
+}
+export function generateLockFile(resolvedDeps) {
+    const packages = {};
+    for (const resolved of resolvedDeps) {
+        if (resolved.manifest === null) {
+            throw new LockFileError(`Remote dependency '${resolved.alias}' (${resolved.address}) has no manifest — cannot generate lock entry`);
+        }
+        const address = resolved.address;
+        const version = resolved.manifest.version;
+        const hash = computeDirectoryHash(resolved.packageRoot);
+        const source = `https://${address}`;
+        packages[address] = { version, hash, source };
+    }
+    return { packages };
+}
+// ---------------------------------------------------------------------------
+// Verification
+// ---------------------------------------------------------------------------
+export function verifyLockedPackage(locked, address, cacheRoot) {
+    const cachedPath = getCachedPackagePath(address, locked.version, cacheRoot);
+    if (!existsSync(cachedPath) || !statSync(cachedPath).isDirectory()) {
+        throw new IntegrityError(`Cached package '${address}@${locked.version}' not found at '${cachedPath}'`);
+    }
+    const actualHash = computeDirectoryHash(cachedPath);
+    if (actualHash !== locked.hash) {
+        throw new IntegrityError(`Integrity check failed for '${address}@${locked.version}': expected ${locked.hash}, got ${actualHash}`);
+    }
+}
+export function verifyLockFile(lockFile, cacheRoot) {
+    for (const [address, locked] of Object.entries(lockFile.packages)) {
+        verifyLockedPackage(locked, address, cacheRoot);
+    }
+}
+//# sourceMappingURL=lock-file.js.map

package/dist/package/lock-file.js.map

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

package/dist/package/manifest/convert.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Bridge between the flat ParsedManifest (package manager) and the nested
+ * MethodsManifest (installer/validate) types.
+ */
+import type { MethodsManifest } from "./types.js";
+import type { ParsedManifest } from "./schema.js";
+/**
+ * Convert a flat ParsedManifest to the nested MethodsManifest used by installer code.
+ */
+export declare function parsedManifestToLegacy(parsed: ParsedManifest): MethodsManifest;
+/**
+ * Convert a nested MethodsManifest to a flat ParsedManifest.
+ */
+export declare function legacyToParsedManifest(legacy: MethodsManifest): ParsedManifest;

package/dist/package/manifest/convert.js

@@ -0,0 +1,83 @@
+/**
+ * Convert a flat ParsedManifest to the nested MethodsManifest used by installer code.
+ */
+export function parsedManifestToLegacy(parsed) {
+    // Build nested exports
+    let exports;
+    if (Object.keys(parsed.exports).length > 0) {
+        const root = {};
+        for (const [domainPath, domainExport] of Object.entries(parsed.exports)) {
+            const segments = domainPath.split(".");
+            let current = root;
+            for (let idx = 0; idx < segments.length - 1; idx++) {
+                const segment = segments[idx];
+                if (!(segment in current) || typeof current[segment] !== "object" || Array.isArray(current[segment])) {
+                    current[segment] = {};
+                }
+                current = current[segment];
+            }
+            const lastSegment = segments[segments.length - 1];
+            const existing = current[lastSegment];
+            if (existing && typeof existing === "object" && !Array.isArray(existing)) {
+                // Merge pipes into existing node
+                existing["pipes"] = [...domainExport.pipes];
+            }
+            else {
+                current[lastSegment] = { pipes: [...domainExport.pipes] };
+            }
+        }
+        exports = root;
+    }
+    return {
+        package: {
+            ...(parsed.name !== undefined ? { name: parsed.name } : {}),
+            address: parsed.address,
+            version: parsed.version,
+            description: parsed.description,
+            ...(parsed.displayName !== undefined ? { display_name: parsed.displayName } : {}),
+            ...(parsed.authors.length > 0 ? { authors: parsed.authors } : {}),
+            ...(parsed.license !== undefined ? { license: parsed.license } : {}),
+            ...(parsed.mthdsVersion !== undefined ? { mthds_version: parsed.mthdsVersion } : {}),
+            ...(parsed.mainPipe !== undefined ? { main_pipe: parsed.mainPipe } : {}),
+        },
+        ...(exports !== undefined ? { exports } : {}),
+    };
+}
+/**
+ * Convert a nested MethodsManifest to a flat ParsedManifest.
+ */
+export function legacyToParsedManifest(legacy) {
+    // Flatten nested exports
+    const exports = {};
+    if (legacy.exports) {
+        flattenExports(legacy.exports, "", exports);
+    }
+    return {
+        address: legacy.package.address,
+        version: legacy.package.version,
+        description: legacy.package.description,
+        authors: legacy.package.authors ?? [],
+        exports,
+        ...(legacy.package.name !== undefined ? { name: legacy.package.name } : {}),
+        ...(legacy.package.display_name !== undefined ? { displayName: legacy.package.display_name } : {}),
+        ...(legacy.package.license !== undefined ? { license: legacy.package.license } : {}),
+        ...(legacy.package.mthds_version !== undefined ? { mthdsVersion: legacy.package.mthds_version } : {}),
+        ...(legacy.package.main_pipe !== undefined ? { mainPipe: legacy.package.main_pipe } : {}),
+    };
+}
+function flattenExports(node, prefix, result) {
+    for (const [key, value] of Object.entries(node)) {
+        if (key === "pipes" || value === undefined)
+            continue;
+        const currentPath = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === "object" && !Array.isArray(value)) {
+            const exportNode = value;
+            if (exportNode.pipes) {
+                result[currentPath] = { pipes: [...exportNode.pipes] };
+            }
+            // Recurse into sub-nodes
+            flattenExports(exportNode, currentPath, result);
+        }
+    }
+}
+//# sourceMappingURL=convert.js.map

package/dist/package/manifest/convert.js.map

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

package/dist/package/manifest/parser.d.ts

@@ -0,0 +1,9 @@
+import { type ParsedManifest } from "./schema.js";
+/**
+ * Parse METHODS.toml content into a ParsedManifest.
+ */
+export declare function parseMethodsToml(content: string): ParsedManifest;
+/**
+ * Serialize a ParsedManifest to a TOML string.
+ */
+export declare function serializeManifestToToml(manifest: ParsedManifest): string;

package/dist/package/manifest/parser.js

@@ -0,0 +1,261 @@
+import { parse, stringify } from "smol-toml";
+import { z } from "zod";
+import { ManifestParseError, ManifestValidationError } from "../exceptions.js";
+import { isValidSemver, isValidVersionConstraint, isValidAddress, isValidMethodName, isReservedDomainPath, MethodsTomlSchema, DomainExportsSchema, } from "./schema.js";
+import { isDomainCodeValid, isPipeCodeValid } from "./validation.js";
+// ---------------------------------------------------------------------------
+// Zod error formatting
+// ---------------------------------------------------------------------------
+function formatZodError(err) {
+    return err.issues
+        .map((issue) => {
+        const path = issue.path;
+        const pathStr = path.join(".");
+        if (issue.code === "unrecognized_keys") {
+            if (path.length === 0) {
+                return `Unknown sections in METHODS.toml: ${issue.keys.sort().join(", ")}`;
+            }
+            return `Unknown keys in [${pathStr}]: ${issue.keys.sort().join(", ")}`;
+        }
+        if (issue.code === "invalid_type") {
+            // "expected string, received undefined" — extract received from message
+            const receivedUndefined = issue.message.includes("received undefined");
+            if (receivedUndefined) {
+                return path.length === 1
+                    ? `[${pathStr}] section is required`
+                    : `[${pathStr}] is required`;
+            }
+            return `[${pathStr}]: ${issue.message}`;
+        }
+        return pathStr ? `[${pathStr}]: ${issue.message}` : issue.message;
+    })
+        .join("; ");
+}
+// ---------------------------------------------------------------------------
+// Exports flattening
+// ---------------------------------------------------------------------------
+/**
+ * Recursively walk nested export sub-tables to flatten them into dotted domain paths.
+ * e.g. { legal: { contracts: { pipes: ["extract_clause"] } } }
+ * -> { "legal.contracts": { pipes: ["extract_clause"] } }
+ */
+function walkExportsTable(table, prefix) {
+    const result = {};
+    for (const [key, value] of Object.entries(table)) {
+        const currentPath = prefix ? `${prefix}.${key}` : key;
+        if (value === null || typeof value !== "object" || Array.isArray(value)) {
+            throw new ManifestValidationError(`Invalid entry '${key}' in [exports${prefix ? `.${prefix}` : ""}]: expected a table, got ${value === null ? "null" : Array.isArray(value) ? "array" : typeof value}`);
+        }
+        {
+            const valueDict = value;
+            if ("pipes" in valueDict) {
+                // Validate this domain entry with DomainExportsSchema (rejects unknown keys at leaf)
+                const nonTableKeys = Object.fromEntries(Object.entries(valueDict).filter(([, v]) => v === null || typeof v !== "object" || Array.isArray(v)));
+                try {
+                    DomainExportsSchema.parse(nonTableKeys);
+                }
+                catch (err) {
+                    if (err instanceof z.ZodError) {
+                        throw new ManifestValidationError(`Invalid domain [exports.${currentPath}]: ${formatZodError(err)}`);
+                    }
+                    throw err;
+                }
+                const pipesValue = valueDict["pipes"];
+                if (!Array.isArray(pipesValue)) {
+                    throw new ManifestValidationError(`'pipes' in domain '${currentPath}' must be a list, got ${typeof pipesValue}`);
+                }
+                for (const pipe of pipesValue) {
+                    if (typeof pipe !== "string") {
+                        throw new ManifestValidationError(`'pipes' in domain '${currentPath}' must contain only strings`);
+                    }
+                }
+                result[currentPath] = { pipes: pipesValue };
+                // Also recurse into remaining sub-tables
+                for (const [subKey, subValue] of Object.entries(valueDict)) {
+                    if (subKey !== "pipes" && subValue !== null && typeof subValue === "object" && !Array.isArray(subValue)) {
+                        Object.assign(result, walkExportsTable({ [subKey]: subValue }, currentPath));
+                    }
+                }
+            }
+            else {
+                // Check there are no unexpected non-table values at this level
+                for (const [subKey, subValue] of Object.entries(valueDict)) {
+                    if (subValue === null || typeof subValue !== "object" || Array.isArray(subValue)) {
+                        throw new ManifestValidationError(`Unknown key '${subKey}' in [exports.${currentPath}]. Only 'pipes' and sub-domain tables are allowed.`);
+                    }
+                }
+                Object.assign(result, walkExportsTable(valueDict, currentPath));
+            }
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Parse
+// ---------------------------------------------------------------------------
+/**
+ * Parse METHODS.toml content into a ParsedManifest.
+ */
+export function parseMethodsToml(content) {
+    let raw;
+    try {
+        raw = parse(content);
+    }
+    catch (err) {
+        throw new ManifestParseError(`Invalid TOML syntax in METHODS.toml: ${err.message}`);
+    }
+    // Step 1: Structural validation via Zod (rejects unknown keys, wrong types, missing required)
+    let validated;
+    try {
+        validated = MethodsTomlSchema.parse(raw);
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new ManifestValidationError(formatZodError(err));
+        }
+        throw err;
+    }
+    const pkg = validated.package;
+    // Step 2: Semantic validation on [package] fields
+    if (!isValidAddress(pkg.address)) {
+        throw new ManifestValidationError(`Invalid package address '${pkg.address}'. Address must follow hostname/path pattern (e.g. 'github.com/org/repo').`);
+    }
+    if (!isValidSemver(pkg.version)) {
+        throw new ManifestValidationError(`Invalid version '${pkg.version}'. Must be valid semver (e.g. '1.0.0', '2.1.3-beta.1').`);
+    }
+    if (!pkg.description.trim()) {
+        throw new ManifestValidationError("[package.description] is required and must be a non-empty string");
+    }
+    let displayName;
+    if (pkg.display_name !== undefined) {
+        const dn = pkg.display_name.trim();
+        if (!dn) {
+            throw new ManifestValidationError("Display name must not be empty or whitespace when provided");
+        }
+        if (dn.length > 128) {
+            throw new ManifestValidationError(`Display name must not exceed 128 characters (got ${dn.length})`);
+        }
+        displayName = dn;
+    }
+    const authors = [];
+    if (pkg.authors) {
+        for (const [idx, author] of pkg.authors.entries()) {
+            if (!author.trim()) {
+                throw new ManifestValidationError(`Author at index ${idx} must not be empty or whitespace`);
+            }
+            authors.push(author.trim());
+        }
+    }
+    let license;
+    if (pkg.license !== undefined) {
+        const trimmedLicense = pkg.license.trim();
+        if (!trimmedLicense) {
+            throw new ManifestValidationError("License must not be empty or whitespace when provided");
+        }
+        license = trimmedLicense;
+    }
+    let mthdsVersion;
+    if (pkg.mthds_version !== undefined) {
+        if (!isValidVersionConstraint(pkg.mthds_version)) {
+            throw new ManifestValidationError(`Invalid mthds_version constraint '${pkg.mthds_version}'. Must be a valid version constraint.`);
+        }
+        mthdsVersion = pkg.mthds_version;
+    }
+    let name;
+    if (pkg.name !== undefined) {
+        if (!isValidMethodName(pkg.name)) {
+            throw new ManifestValidationError(`Invalid method name '${pkg.name}'. Must be 2-25 lowercase chars (letters, digits, hyphens, underscores), starting with a letter.`);
+        }
+        name = pkg.name;
+    }
+    let mainPipe;
+    if (pkg.main_pipe !== undefined) {
+        if (!isPipeCodeValid(pkg.main_pipe)) {
+            throw new ManifestValidationError(`Invalid main_pipe '${pkg.main_pipe}'. Must be a valid snake_case pipe code.`);
+        }
+        mainPipe = pkg.main_pipe;
+    }
+    // Step 3: Process and validate exports
+    let exports = {};
+    if (validated.exports) {
+        exports = walkExportsTable(validated.exports, "");
+        for (const [domainPath, domainExport] of Object.entries(exports)) {
+            if (!isDomainCodeValid(domainPath)) {
+                throw new ManifestValidationError(`Invalid domain path '${domainPath}' in [exports]. Domain paths must be dot-separated snake_case segments.`);
+            }
+            if (isReservedDomainPath(domainPath)) {
+                const firstSegment = domainPath.split(".")[0];
+                throw new ManifestValidationError(`Domain path '${domainPath}' uses reserved domain '${firstSegment}'. ` +
+                    `Reserved domains (mthds, native, pipelex) cannot be used in package exports.`);
+            }
+            for (const pipe of domainExport.pipes) {
+                if (!isPipeCodeValid(pipe)) {
+                    throw new ManifestValidationError(`Invalid pipe name '${pipe}' in [exports.${domainPath}]. Pipe names must be in snake_case.`);
+                }
+            }
+        }
+    }
+    return {
+        address: pkg.address,
+        version: pkg.version,
+        description: pkg.description.trim(),
+        authors,
+        exports,
+        ...(name !== undefined ? { name } : {}),
+        ...(displayName !== undefined ? { displayName } : {}),
+        ...(license !== undefined ? { license } : {}),
+        ...(mthdsVersion !== undefined ? { mthdsVersion } : {}),
+        ...(mainPipe !== undefined ? { mainPipe } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Serialize
+// ---------------------------------------------------------------------------
+/**
+ * Serialize a ParsedManifest to a TOML string.
+ */
+export function serializeManifestToToml(manifest) {
+    const doc = {};
+    // [package] section
+    const packageSection = {};
+    if (manifest.name !== undefined) {
+        packageSection["name"] = manifest.name;
+    }
+    packageSection["address"] = manifest.address;
+    if (manifest.displayName !== undefined) {
+        packageSection["display_name"] = manifest.displayName;
+    }
+    packageSection["version"] = manifest.version;
+    packageSection["description"] = manifest.description;
+    if (manifest.authors.length > 0) {
+        packageSection["authors"] = manifest.authors;
+    }
+    if (manifest.license !== undefined) {
+        packageSection["license"] = manifest.license;
+    }
+    if (manifest.mthdsVersion !== undefined) {
+        packageSection["mthds_version"] = manifest.mthdsVersion;
+    }
+    if (manifest.mainPipe !== undefined) {
+        packageSection["main_pipe"] = manifest.mainPipe;
+    }
+    doc["package"] = packageSection;
+    // [exports] section — rebuild nested structure from dotted paths
+    if (Object.keys(manifest.exports).length > 0) {
+        const exportsRoot = {};
+        for (const [domainPath, domainExport] of Object.entries(manifest.exports)) {
+            const segments = domainPath.split(".");
+            let current = exportsRoot;
+            for (const segment of segments) {
+                if (!(segment in current)) {
+                    current[segment] = {};
+                }
+                current = current[segment];
+            }
+            current["pipes"] = domainExport.pipes;
+        }
+        doc["exports"] = exportsRoot;
+    }
+    return stringify(doc);
+}
+//# sourceMappingURL=parser.js.map

package/dist/package/manifest/parser.js.map

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