mthds 0.0.6 → 0.0.8

package/dist/package/manifest/schema.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Flat parsed manifest types and Zod schemas for the package manager.
+ *
+ * Zod schemas are the **source of truth** for which keys are allowed in
+ * METHODS.toml.  `.strict()` rejects unknown keys (equivalent to Pydantic's
+ * `extra="forbid"`).
+ *
+ * This is separate from the nested MethodsManifest in types.ts which is used
+ * by the installer. A conversion bridge (convert.ts) maps between the two.
+ */
+import { z } from "zod";
+export declare const RESERVED_DOMAINS: ReadonlySet<string>;
+export declare const MTHDS_STANDARD_VERSION = "1.0.0";
+export declare function isReservedDomainPath(domainPath: string): boolean;
+export declare function isValidSemver(version: string): boolean;
+export declare function isValidVersionConstraint(constraint: string): boolean;
+export declare function isValidAddress(address: string): boolean;
+/** Method name: lowercase alphanumeric + hyphens/underscores, 2-25 chars, starts with a letter */
+export declare const METHOD_NAME_RE: RegExp;
+export declare function isValidMethodName(name: string): boolean;
+/** Raw [package] section in METHODS.toml */
+export declare const PackageSectionSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    address: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    display_name: z.ZodOptional<z.ZodString>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    license: z.ZodOptional<z.ZodString>;
+    mthds_version: z.ZodOptional<z.ZodString>;
+    main_pipe: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Flattened domain exports (after walkExportsTable) */
+export declare const DomainExportsSchema: z.ZodObject<{
+    pipes: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+/** Top-level METHODS.toml structure */
+export declare const MethodsTomlSchema: z.ZodObject<{
+    package: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        address: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodString;
+        display_name: z.ZodOptional<z.ZodString>;
+        authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        license: z.ZodOptional<z.ZodString>;
+        mthds_version: z.ZodOptional<z.ZodString>;
+        main_pipe: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    exports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export interface DomainExports {
+    readonly pipes: string[];
+}
+/**
+ * Flat parsed manifest — the primary model for the package manager.
+ *
+ * All export domains are flattened to dotted paths (e.g. "legal.contracts").
+ */
+export interface ParsedManifest {
+    readonly name?: string;
+    readonly address: string;
+    readonly displayName?: string;
+    readonly version: string;
+    readonly description: string;
+    readonly authors: string[];
+    readonly license?: string;
+    readonly mthdsVersion?: string;
+    readonly mainPipe?: string;
+    readonly exports: Record<string, DomainExports>;
+}

package/dist/package/manifest/schema.js

@@ -0,0 +1,73 @@
+/**
+ * Flat parsed manifest types and Zod schemas for the package manager.
+ *
+ * Zod schemas are the **source of truth** for which keys are allowed in
+ * METHODS.toml.  `.strict()` rejects unknown keys (equivalent to Pydantic's
+ * `extra="forbid"`).
+ *
+ * This is separate from the nested MethodsManifest in types.ts which is used
+ * by the installer. A conversion bridge (convert.ts) maps between the two.
+ */
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Regex patterns
+// ---------------------------------------------------------------------------
+const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+const _SINGLE_CONSTRAINT = "(?:" +
+    "\\*" +
+    "|(?:(?:\\^|~|>=?|<=?|==|!=)?(?:0|[1-9]\\d*)(?:\\.(?:0|[1-9]\\d*|\\*))?(?:\\.(?:0|[1-9]\\d*|\\*))?)" +
+    "(?:-(?:(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?" +
+    ")";
+const VERSION_CONSTRAINT_RE = new RegExp(`^${_SINGLE_CONSTRAINT}(?:\\s*,\\s*${_SINGLE_CONSTRAINT})*$`);
+const ADDRESS_RE = /^[a-zA-Z0-9._-]+\.[a-zA-Z0-9._-]+\/[a-zA-Z0-9._/-]+$/;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const RESERVED_DOMAINS = new Set(["native", "mthds", "pipelex"]);
+export const MTHDS_STANDARD_VERSION = "1.0.0";
+// ---------------------------------------------------------------------------
+// Standalone validation helpers (used outside the parser too)
+// ---------------------------------------------------------------------------
+export function isReservedDomainPath(domainPath) {
+    const firstSegment = domainPath.split(".")[0];
+    return RESERVED_DOMAINS.has(firstSegment);
+}
+export function isValidSemver(version) {
+    return SEMVER_RE.test(version);
+}
+export function isValidVersionConstraint(constraint) {
+    return VERSION_CONSTRAINT_RE.test(constraint.trim());
+}
+export function isValidAddress(address) {
+    return ADDRESS_RE.test(address);
+}
+// ---------------------------------------------------------------------------
+// Zod schemas — source of truth for allowed TOML keys
+// ---------------------------------------------------------------------------
+/** Method name: lowercase alphanumeric + hyphens/underscores, 2-25 chars, starts with a letter */
+export const METHOD_NAME_RE = /^[a-z][a-z0-9_-]{1,24}$/;
+export function isValidMethodName(name) {
+    return METHOD_NAME_RE.test(name);
+}
+/** Raw [package] section in METHODS.toml */
+export const PackageSectionSchema = z.object({
+    name: z.string().optional(),
+    address: z.string(),
+    version: z.string(),
+    description: z.string(),
+    display_name: z.string().optional(),
+    authors: z.array(z.string()).optional(),
+    license: z.string().optional(),
+    mthds_version: z.string().optional(),
+    main_pipe: z.string().optional(),
+}).strict();
+/** Flattened domain exports (after walkExportsTable) */
+export const DomainExportsSchema = z.object({
+    pipes: z.array(z.string()),
+}).strict();
+/** Top-level METHODS.toml structure */
+export const MethodsTomlSchema = z.object({
+    package: PackageSectionSchema,
+    exports: z.record(z.string(), z.unknown()).optional(),
+}).strict();
+//# sourceMappingURL=schema.js.map

package/dist/package/manifest/schema.js.map

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

package/dist/{resolver → package/manifest}/types.d.ts

@@ -4,6 +4,7 @@ export interface ParsedAddress {
     readonly subpath: string | null;
 }
 export interface PackageSection {
+    readonly name?: string;
     readonly address: string;
     readonly version: string;
     readonly description: string;
@@ -11,20 +12,16 @@ export interface PackageSection {
     readonly authors?: string[];
     readonly license?: string;
     readonly mthds_version?: string;
+    readonly main_pipe?: string;
 }
 export interface ExportNode {
     readonly pipes?: string[];
     readonly [subdomain: string]: ExportNode | string[] | undefined;
 }
 export type Exports = Record<string, ExportNode>;
-export interface DependencySpec {
-    readonly address: string;
-    readonly version: string;
-}
 export interface MethodsManifest {
     readonly package: PackageSection;
     readonly exports?: Exports;
-    readonly dependencies?: Record<string, DependencySpec>;
 }
 export interface MethodsFile {
     readonly relativePath: string;

package/dist/{resolver → package/manifest}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resolver/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/package/manifest/types.ts"],"names":[],"mappings":""}

package/dist/{resolver → package/manifest}/validate.js

@@ -1,4 +1,6 @@
 import { parse } from "smol-toml";
+import { METHOD_NAME_RE } from "./schema.js";
+import { isPipeCodeValid } from "./validation.js";
 const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
 const SNAKE_CASE_RE = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/;
 const SLUG_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
@@ -122,6 +124,24 @@ export function validateManifest(raw) {
             errors.push('[package.mthds_version] must be a string.');
         }
     }
+    // package.name (optional)
+    if (pkg["name"] !== undefined) {
+        if (typeof pkg["name"] !== "string") {
+            errors.push('[package.name] must be a string.');
+        }
+        else if (!METHOD_NAME_RE.test(pkg["name"])) {
+            errors.push(`[package.name] "${pkg["name"]}" is invalid: must be 2-25 lowercase chars (letters, digits, hyphens, underscores), starting with a letter.`);
+        }
+    }
+    // package.main_pipe (optional)
+    if (pkg["main_pipe"] !== undefined) {
+        if (typeof pkg["main_pipe"] !== "string") {
+            errors.push('[package.main_pipe] must be a string.');
+        }
+        else if (!isPipeCodeValid(pkg["main_pipe"])) {
+            errors.push(`[package.main_pipe] "${pkg["main_pipe"]}" must be a valid snake_case pipe code.`);
+        }
+    }
     // --- [exports] section (optional, hierarchical) ---
     const exports = parsed["exports"];
     if (exports && typeof exports === "object") {
@@ -134,25 +154,9 @@ export function validateManifest(raw) {
             validateExportNode(node, domain, errors);
         }
     }
-    // --- [dependencies] section (optional) ---
-    const deps = parsed["dependencies"];
-    if (deps && typeof deps === "object") {
-        for (const [alias, dep] of Object.entries(deps)) {
-            if (!SNAKE_CASE_RE.test(alias)) {
-                errors.push(`[dependencies."${alias}"] alias must be snake_case.`);
-            }
-            const d = dep;
-            if (!d || typeof d !== "object") {
-                errors.push(`[dependencies."${alias}"] must be a table with address and version.`);
-                continue;
-            }
-            if (typeof d["address"] !== "string" || !d["address"]) {
-                errors.push(`[dependencies."${alias}".address] is required.`);
-            }
-            if (typeof d["version"] !== "string" || !d["version"]) {
-                errors.push(`[dependencies."${alias}".version] is required.`);
-            }
-        }
+    // --- [dependencies] section — not allowed ---
+    if (parsed["dependencies"] !== undefined) {
+        errors.push('[dependencies] section is not supported. Dependencies have been removed from the MTHDS standard.');
     }
     if (errors.length > 0) {
         return { valid: false, errors };
@@ -162,15 +166,16 @@ export function validateManifest(raw) {
         address: pkg["address"],
         version: pkg["version"],
         description: pkg["description"],
+        ...(pkg["name"] !== undefined ? { name: pkg["name"] } : {}),
         ...(pkg["display_name"] !== undefined ? { display_name: pkg["display_name"] } : {}),
         ...(pkg["authors"] !== undefined ? { authors: pkg["authors"] } : {}),
         ...(pkg["license"] !== undefined ? { license: pkg["license"] } : {}),
         ...(pkg["mthds_version"] !== undefined ? { mthds_version: pkg["mthds_version"] } : {}),
+        ...(pkg["main_pipe"] !== undefined ? { main_pipe: pkg["main_pipe"] } : {}),
     };
     const manifest = {
         package: manifestPkg,
         ...(exports ? { exports: exports } : {}),
-        ...(deps ? { dependencies: deps } : {}),
     };
     return { valid: true, errors: [], manifest };
 }

package/dist/package/manifest/validate.js.map

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

package/dist/package/manifest/validation.d.ts

@@ -0,0 +1,10 @@
+export declare function isSnakeCase(word: string): boolean;
+export declare function isPascalCase(word: string): boolean;
+/**
+ * Check if a domain code is valid.
+ * Accepts single-segment (e.g. "legal") and hierarchical dotted paths
+ * (e.g. "legal.contracts"). Each segment must be snake_case.
+ * Supports cross-package domain codes (e.g. "alias->scoring").
+ */
+export declare function isDomainCodeValid(code: string): boolean;
+export declare function isPipeCodeValid(pipeCode: string): boolean;

package/dist/package/manifest/validation.js

@@ -0,0 +1,34 @@
+const SNAKE_CASE_RE = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/;
+const PASCAL_CASE_RE = /^[A-Z][a-zA-Z0-9]*$/;
+export function isSnakeCase(word) {
+    return SNAKE_CASE_RE.test(word);
+}
+export function isPascalCase(word) {
+    return PASCAL_CASE_RE.test(word);
+}
+/**
+ * Check if a domain code is valid.
+ * Accepts single-segment (e.g. "legal") and hierarchical dotted paths
+ * (e.g. "legal.contracts"). Each segment must be snake_case.
+ * Supports cross-package domain codes (e.g. "alias->scoring").
+ */
+export function isDomainCodeValid(code) {
+    if (!code)
+        return false;
+    if (code.includes("->")) {
+        const arrowIdx = code.indexOf("->");
+        const alias = code.slice(0, arrowIdx);
+        const remainder = code.slice(arrowIdx + 2);
+        if (!isSnakeCase(alias))
+            return false;
+        return isDomainCodeValid(remainder);
+    }
+    if (code.startsWith(".") || code.endsWith(".") || code.includes("..")) {
+        return false;
+    }
+    return code.split(".").every((segment) => isSnakeCase(segment));
+}
+export function isPipeCodeValid(pipeCode) {
+    return isSnakeCase(pipeCode);
+}
+//# sourceMappingURL=validation.js.map

package/dist/package/manifest/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/package/manifest/validation.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,iCAAiC,CAAC;AACxD,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAE7C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/package/package-cache.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Return the default cache root directory: ~/.mthds/packages
+ */
+export declare function getDefaultCacheRoot(): string;
+/**
+ * Compute the cache path for a package version.
+ * Includes path traversal protection.
+ */
+export declare function getCachedPackagePath(address: string, version: string, cacheRoot?: string): string;
+/**
+ * Check whether a package version exists in the cache.
+ * A directory is considered cached if it exists and is non-empty.
+ */
+export declare function isCached(address: string, version: string, cacheRoot?: string): boolean;
+/**
+ * Copy a package directory into the cache.
+ * Uses a staging directory + rename for safe writes. Removes .git/ from the cached copy.
+ */
+export declare function storeInCache(sourceDir: string, address: string, version: string, cacheRoot?: string): string;
+/**
+ * Remove a cached package version.
+ * Returns true if the directory existed and was removed.
+ */
+export declare function removeCachedPackage(address: string, version: string, cacheRoot?: string): boolean;

package/dist/package/package-cache.js

@@ -0,0 +1,92 @@
+import { existsSync, mkdirSync, readdirSync, renameSync, rmSync, cpSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve, sep } from "node:path";
+import { PackageCacheError } from "./exceptions.js";
+/**
+ * Return the default cache root directory: ~/.mthds/packages
+ */
+export function getDefaultCacheRoot() {
+    return join(homedir(), ".mthds", "packages");
+}
+/**
+ * Compute the cache path for a package version.
+ * Includes path traversal protection.
+ */
+export function getCachedPackagePath(address, version, cacheRoot) {
+    const root = resolve(cacheRoot ?? getDefaultCacheRoot());
+    const resolved = resolve(root, address, version);
+    if (!resolved.startsWith(root + sep)) {
+        throw new PackageCacheError(`Path traversal detected: address '${address}' and version '${version}' resolve outside cache root`);
+    }
+    return resolved;
+}
+/**
+ * Check whether a package version exists in the cache.
+ * A directory is considered cached if it exists and is non-empty.
+ */
+export function isCached(address, version, cacheRoot) {
+    const pkgPath = getCachedPackagePath(address, version, cacheRoot);
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const entries = readdirSync(pkgPath);
+        return entries.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Copy a package directory into the cache.
+ * Uses a staging directory + rename for safe writes. Removes .git/ from the cached copy.
+ */
+export function storeInCache(sourceDir, address, version, cacheRoot) {
+    const finalPath = getCachedPackagePath(address, version, cacheRoot);
+    const stagingPath = `${finalPath}.staging`;
+    try {
+        // Ensure parent directory exists before any file operations
+        const parentDir = resolve(finalPath, "..");
+        mkdirSync(parentDir, { recursive: true });
+        // Clean up any leftover staging dir
+        if (existsSync(stagingPath)) {
+            rmSync(stagingPath, { recursive: true, force: true });
+        }
+        // Copy source into staging
+        cpSync(sourceDir, stagingPath, { recursive: true });
+        // Remove .git/ from the staged copy
+        const gitDir = join(stagingPath, ".git");
+        if (existsSync(gitDir)) {
+            rmSync(gitDir, { recursive: true, force: true });
+        }
+        // Atomic rename into final location
+        if (existsSync(finalPath)) {
+            rmSync(finalPath, { recursive: true, force: true });
+        }
+        renameSync(stagingPath, finalPath);
+    }
+    catch (err) {
+        // Clean up staging on failure
+        if (existsSync(stagingPath)) {
+            rmSync(stagingPath, { recursive: true, force: true });
+        }
+        throw new PackageCacheError(`Failed to store package '${address}@${version}' in cache: ${err.message}`);
+    }
+    return finalPath;
+}
+/**
+ * Remove a cached package version.
+ * Returns true if the directory existed and was removed.
+ */
+export function removeCachedPackage(address, version, cacheRoot) {
+    const pkgPath = getCachedPackagePath(address, version, cacheRoot);
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        rmSync(pkgPath, { recursive: true, force: true });
+    }
+    catch (err) {
+        throw new PackageCacheError(`Failed to remove cached package '${address}@${version}' at '${pkgPath}': ${err.message}`);
+    }
+    return true;
+}
+//# sourceMappingURL=package-cache.js.map

package/dist/package/package-cache.js.map

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

package/dist/package/qualified-ref.d.ts

@@ -0,0 +1,41 @@
+export interface QualifiedRef {
+    readonly domainPath: string | null;
+    readonly localCode: string;
+}
+/**
+ * Check if a ref is domain-qualified (has a domain path).
+ */
+export declare function isQualified(ref: QualifiedRef): boolean;
+/**
+ * Get the full reference string.
+ */
+export declare function fullRef(ref: QualifiedRef): string;
+/**
+ * Parse a reference string by splitting on the last dot.
+ * No naming-convention check on localCode.
+ */
+export declare function parseRef(raw: string): QualifiedRef;
+/**
+ * Parse a concept ref. Validates domain_path segments are snake_case, localCode is PascalCase.
+ */
+export declare function parseConceptRef(raw: string): QualifiedRef;
+/**
+ * Parse a pipe ref. Validates domain_path segments are snake_case, localCode is snake_case.
+ */
+export declare function parsePipeRef(raw: string): QualifiedRef;
+/**
+ * True if this ref belongs to the given domain (same domain or bare).
+ */
+export declare function isLocalTo(ref: QualifiedRef, domain: string): boolean;
+/**
+ * True if this ref belongs to a different domain.
+ */
+export declare function isExternalTo(ref: QualifiedRef, domain: string): boolean;
+/**
+ * Check if a raw reference string contains the cross-package '->' prefix.
+ */
+export declare function hasCrossPackagePrefix(raw: string): boolean;
+/**
+ * Split a cross-package reference into [alias, remainder].
+ */
+export declare function splitCrossPackageRef(raw: string): [string, string];

package/dist/package/qualified-ref.js

@@ -0,0 +1,105 @@
+import { QualifiedRefError } from "./exceptions.js";
+import { isSnakeCase, isPascalCase } from "./manifest/validation.js";
+/**
+ * Check if a ref is domain-qualified (has a domain path).
+ */
+export function isQualified(ref) {
+    return ref.domainPath !== null;
+}
+/**
+ * Get the full reference string.
+ */
+export function fullRef(ref) {
+    if (ref.domainPath !== null) {
+        return `${ref.domainPath}.${ref.localCode}`;
+    }
+    return ref.localCode;
+}
+/**
+ * Parse a reference string by splitting on the last dot.
+ * No naming-convention check on localCode.
+ */
+export function parseRef(raw) {
+    if (!raw) {
+        throw new QualifiedRefError("Qualified reference cannot be empty");
+    }
+    if (raw.startsWith(".") || raw.endsWith(".")) {
+        throw new QualifiedRefError(`Qualified reference '${raw}' must not start or end with a dot`);
+    }
+    if (raw.includes("..")) {
+        throw new QualifiedRefError(`Qualified reference '${raw}' must not contain consecutive dots`);
+    }
+    if (!raw.includes(".")) {
+        return { domainPath: null, localCode: raw };
+    }
+    const lastDot = raw.lastIndexOf(".");
+    const domainPath = raw.slice(0, lastDot);
+    const localCode = raw.slice(lastDot + 1);
+    return { domainPath, localCode };
+}
+function validateDomainPath(domainPath, raw) {
+    for (const segment of domainPath.split(".")) {
+        if (!isSnakeCase(segment)) {
+            throw new QualifiedRefError(`Domain segment '${segment}' in reference '${raw}' must be snake_case`);
+        }
+    }
+}
+/**
+ * Parse a concept ref. Validates domain_path segments are snake_case, localCode is PascalCase.
+ */
+export function parseConceptRef(raw) {
+    const ref = parseRef(raw);
+    if (!isPascalCase(ref.localCode)) {
+        throw new QualifiedRefError(`Concept code '${ref.localCode}' in reference '${raw}' must be PascalCase`);
+    }
+    if (ref.domainPath !== null) {
+        validateDomainPath(ref.domainPath, raw);
+    }
+    return ref;
+}
+/**
+ * Parse a pipe ref. Validates domain_path segments are snake_case, localCode is snake_case.
+ */
+export function parsePipeRef(raw) {
+    const ref = parseRef(raw);
+    if (!isSnakeCase(ref.localCode)) {
+        throw new QualifiedRefError(`Pipe code '${ref.localCode}' in reference '${raw}' must be snake_case`);
+    }
+    if (ref.domainPath !== null) {
+        validateDomainPath(ref.domainPath, raw);
+    }
+    return ref;
+}
+/**
+ * True if this ref belongs to the given domain (same domain or bare).
+ */
+export function isLocalTo(ref, domain) {
+    if (ref.domainPath === null)
+        return true;
+    return ref.domainPath === domain;
+}
+/**
+ * True if this ref belongs to a different domain.
+ */
+export function isExternalTo(ref, domain) {
+    if (ref.domainPath === null)
+        return false;
+    return ref.domainPath !== domain;
+}
+/**
+ * Check if a raw reference string contains the cross-package '->' prefix.
+ */
+export function hasCrossPackagePrefix(raw) {
+    return raw.includes("->");
+}
+/**
+ * Split a cross-package reference into [alias, remainder].
+ */
+export function splitCrossPackageRef(raw) {
+    if (!raw.includes("->")) {
+        throw new QualifiedRefError(`Reference '${raw}' is not a cross-package reference (no '->' found)`);
+    }
+    const idx = raw.indexOf("->");
+    return [raw.slice(0, idx), raw.slice(idx + 2)];
+}
+//# sourceMappingURL=qualified-ref.js.map

package/dist/package/qualified-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualified-ref.js","sourceRoot":"","sources":["../../src/package/qualified-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAOrE;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAiB;IAC3C,OAAO,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,GAAiB;IACvC,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC,SAAS,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,iBAAiB,CAAC,qCAAqC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,iBAAiB,CACzB,wBAAwB,GAAG,oCAAoC,CAChE,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,iBAAiB,CACzB,wBAAwB,GAAG,qCAAqC,CACjE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB,EAAE,GAAW;IACzD,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,OAAO,mBAAmB,GAAG,sBAAsB,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,GAAG,CAAC,SAAS,mBAAmB,GAAG,sBAAsB,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,iBAAiB,CACzB,cAAc,GAAG,CAAC,SAAS,mBAAmB,GAAG,sBAAsB,CACxE,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAiB,EAAE,MAAc;IACzD,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAiB,EAAE,MAAc;IAC5D,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,iBAAiB,CACzB,cAAc,GAAG,oDAAoD,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/package/semver.d.ts

@@ -0,0 +1,33 @@
+import semver from "semver";
+export declare class SemVerError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a version string into a semver SemVer object.
+ * Strips a leading 'v' prefix if present (common in git tags like v1.2.3).
+ */
+export declare function parseVersion(versionStr: string): semver.SemVer;
+/**
+ * Parse a constraint string into a semver Range.
+ * Supports: "^1.0.0", "~1.0.0", ">=1.0.0 <2.0.0", "*", "1.*", etc.
+ */
+export declare function parseConstraint(constraintStr: string): semver.Range;
+/**
+ * Check whether a version satisfies a constraint.
+ */
+export declare function versionSatisfies(version: semver.SemVer, constraint: semver.Range): boolean;
+/**
+ * Select the minimum version that satisfies a constraint (MVS).
+ * Sorts versions ascending and returns the first match.
+ */
+export declare function selectMinimumVersion(availableVersions: semver.SemVer[], constraint: semver.Range): semver.SemVer | null;
+/**
+ * Select the minimum version that satisfies ALL constraints simultaneously.
+ * Used for diamond dependency resolution.
+ */
+export declare function selectMinimumVersionForMultipleConstraints(availableVersions: semver.SemVer[], constraints: semver.Range[]): semver.SemVer | null;
+/**
+ * Parse a git tag into a SemVer, returning null if not a valid semver tag.
+ * Handles tags like "v1.2.3" and "1.2.3", gracefully ignores non-semver tags.
+ */
+export declare function parseVersionTag(tag: string): semver.SemVer | null;