mthds 0.0.7 → 0.0.9

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":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,OAAe,EACf,SAAkB;IAElB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,mBAAmB,EAAE,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,iBAAiB,CACzB,qCAAqC,OAAO,kBAAkB,OAAO,8BAA8B,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,OAAe,EACf,SAAkB;IAElB,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,OAAe,EACf,OAAe,EACf,SAAkB;IAElB,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,GAAG,SAAS,UAAU,CAAC;IAE3C,IAAI,CAAC;QACH,4DAA4D;QAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3C,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,oCAAoC;QACpC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,2BAA2B;QAC3B,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,oCAAoC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,oCAAoC;QACpC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8BAA8B;QAC9B,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,IAAI,iBAAiB,CACzB,4BAA4B,OAAO,IAAI,OAAO,eAAgB,GAAa,CAAC,OAAO,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,OAAe,EACf,SAAkB;IAElB,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CACzB,oCAAoC,OAAO,IAAI,OAAO,SAAS,OAAO,MAAO,GAAa,CAAC,OAAO,EAAE,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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":"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"}

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;

package/dist/package/semver.js

@@ -0,0 +1,77 @@
+import semver from "semver";
+export class SemVerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SemVerError";
+    }
+}
+/**
+ * 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 function parseVersion(versionStr) {
+    const cleaned = versionStr.startsWith("v") ? versionStr.slice(1) : versionStr;
+    const parsed = semver.parse(cleaned);
+    if (parsed === null) {
+        throw new SemVerError(`Invalid semver version: '${versionStr}'`);
+    }
+    return parsed;
+}
+/**
+ * Parse a constraint string into a semver Range.
+ * Supports: "^1.0.0", "~1.0.0", ">=1.0.0 <2.0.0", "*", "1.*", etc.
+ */
+export function parseConstraint(constraintStr) {
+    try {
+        const range = new semver.Range(constraintStr);
+        return range;
+    }
+    catch {
+        throw new SemVerError(`Invalid semver constraint: '${constraintStr}'`);
+    }
+}
+/**
+ * Check whether a version satisfies a constraint.
+ */
+export function versionSatisfies(version, constraint) {
+    return semver.satisfies(version, constraint);
+}
+/**
+ * Select the minimum version that satisfies a constraint (MVS).
+ * Sorts versions ascending and returns the first match.
+ */
+export function selectMinimumVersion(availableVersions, constraint) {
+    const sorted = [...availableVersions].sort(semver.compare);
+    for (const version of sorted) {
+        if (semver.satisfies(version, constraint)) {
+            return version;
+        }
+    }
+    return null;
+}
+/**
+ * Select the minimum version that satisfies ALL constraints simultaneously.
+ * Used for diamond dependency resolution.
+ */
+export function selectMinimumVersionForMultipleConstraints(availableVersions, constraints) {
+    const sorted = [...availableVersions].sort(semver.compare);
+    for (const version of sorted) {
+        if (constraints.every((constraint) => semver.satisfies(version, constraint))) {
+            return version;
+        }
+    }
+    return 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 function parseVersionTag(tag) {
+    try {
+        return parseVersion(tag);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=semver.js.map

package/dist/package/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/package/semver.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CAAC,4BAA4B,UAAU,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB;IACnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,+BAA+B,aAAa,GAAG,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,UAAwB;IAC/E,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,iBAAkC,EAClC,UAAwB;IAExB,MAAM,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0CAA0C,CACxD,iBAAkC,EAClC,WAA2B;IAE3B,MAAM,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/package/vcs-resolver.d.ts

@@ -0,0 +1,19 @@
+import type { SemVer } from "semver";
+/**
+ * Map a package address to a git clone URL.
+ * Prepends https:// and appends .git (unless already present).
+ */
+export declare function addressToCloneUrl(address: string): string;
+/**
+ * List remote git tags that are valid semver versions.
+ * Runs `git ls-remote --tags <url>` and parses the output.
+ */
+export declare function listRemoteVersionTags(cloneUrl: string): Promise<Array<[SemVer, string]>>;
+/**
+ * Select the minimum version matching a constraint from a list of tags (MVS).
+ */
+export declare function resolveVersionFromTags(versionTags: Array<[SemVer, string]>, versionConstraint: string): [SemVer, string];
+/**
+ * Clone a git repository at a specific tag with depth 1.
+ */
+export declare function cloneAtVersion(cloneUrl: string, versionTag: string, destination: string): Promise<void>;

package/dist/package/vcs-resolver.js

@@ -0,0 +1,115 @@
+import { execFile } from "node:child_process";
+import { VCSFetchError, VersionResolutionError } from "./exceptions.js";
+import { parseConstraint, parseVersionTag, selectMinimumVersion, SemVerError } from "./semver.js";
+/**
+ * Map a package address to a git clone URL.
+ * Prepends https:// and appends .git (unless already present).
+ */
+export function addressToCloneUrl(address) {
+    let url = `https://${address}`;
+    if (!url.endsWith(".git")) {
+        url = `${url}.git`;
+    }
+    return url;
+}
+function execGit(args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile("git", args, { timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                if (error.code === "ENOENT") {
+                    reject(new VCSFetchError("git is not installed or not found on PATH"));
+                    return;
+                }
+                if (error.killed) {
+                    reject(new VCSFetchError(`Timed out running: git ${args.join(" ")}`));
+                    return;
+                }
+                reject(new VCSFetchError(`git ${args[0]} failed: ${stderr.trim()}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+/**
+ * List remote git tags that are valid semver versions.
+ * Runs `git ls-remote --tags <url>` and parses the output.
+ */
+export async function listRemoteVersionTags(cloneUrl) {
+    let stdout;
+    try {
+        stdout = await execGit(["ls-remote", "--tags", cloneUrl], 60_000);
+    }
+    catch (err) {
+        if (err instanceof VCSFetchError)
+            throw err;
+        throw new VCSFetchError(`Failed to list remote tags from '${cloneUrl}': ${err.message}`);
+    }
+    const versionTags = [];
+    for (const line of stdout.trim().split("\n")) {
+        if (!line.trim())
+            continue;
+        const parts = line.split("\t");
+        if (parts.length < 2)
+            continue;
+        const ref = parts[1];
+        // Skip dereferenced tags
+        if (ref.endsWith("^{}"))
+            continue;
+        // Extract tag name from refs/tags/...
+        const tagName = ref.startsWith("refs/tags/") ? ref.slice("refs/tags/".length) : ref;
+        const version = parseVersionTag(tagName);
+        if (version !== null) {
+            versionTags.push([version, tagName]);
+        }
+    }
+    return versionTags;
+}
+/**
+ * Select the minimum version matching a constraint from a list of tags (MVS).
+ */
+export function resolveVersionFromTags(versionTags, versionConstraint) {
+    if (versionTags.length === 0) {
+        throw new VersionResolutionError(`No version tags available to satisfy constraint '${versionConstraint}'`);
+    }
+    let constraint;
+    try {
+        constraint = parseConstraint(versionConstraint);
+    }
+    catch (err) {
+        if (err instanceof SemVerError) {
+            throw new VersionResolutionError(`Invalid version constraint '${versionConstraint}': ${err.message}`);
+        }
+        throw err;
+    }
+    const versions = versionTags.map((entry) => entry[0]);
+    const selected = selectMinimumVersion(versions, constraint);
+    if (selected === null) {
+        const availableStr = versionTags
+            .map((entry) => entry[0])
+            .sort((a, b) => a.compare(b))
+            .map((ver) => ver.version)
+            .join(", ");
+        throw new VersionResolutionError(`No version satisfying '${versionConstraint}' found among: ${availableStr}`);
+    }
+    for (const [ver, tagName] of versionTags) {
+        if (ver.compare(selected) === 0) {
+            return [selected, tagName];
+        }
+    }
+    throw new VersionResolutionError(`Internal error: selected version ${selected.version} not found in tag list`);
+}
+/**
+ * Clone a git repository at a specific tag with depth 1.
+ */
+export async function cloneAtVersion(cloneUrl, versionTag, destination) {
+    try {
+        await execGit(["clone", "--depth", "1", "--branch", versionTag, cloneUrl, destination], 120_000);
+    }
+    catch (err) {
+        if (err instanceof VCSFetchError)
+            throw err;
+        throw new VCSFetchError(`Failed to clone '${cloneUrl}' at tag '${versionTag}': ${err.message}`);
+    }
+}
+//# sourceMappingURL=vcs-resolver.js.map

package/dist/package/vcs-resolver.js.map

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

package/dist/package/visibility.d.ts

@@ -0,0 +1,25 @@
+import type { BundleMetadata } from "./bundle-metadata.js";
+import type { ParsedManifest } from "./manifest/schema.js";
+import { parsePipeRef } from "./qualified-ref.js";
+export interface VisibilityError {
+    readonly pipeRef: string;
+    readonly sourceDomain: string;
+    readonly targetDomain: string;
+    readonly context: string;
+    readonly message: string;
+}
+export declare class PackageVisibilityChecker {
+    private readonly manifest;
+    private readonly bundleMetadatas;
+    private readonly exportedPipes;
+    private readonly mainPipes;
+    constructor(manifest: ParsedManifest | null, bundleMetadatas: BundleMetadata[]);
+    isPipeAccessibleFrom(pipeRef: ReturnType<typeof parsePipeRef>, sourceDomain: string): boolean;
+    validateAllPipeReferences(): VisibilityError[];
+    validateCrossPackageReferences(): VisibilityError[];
+    validateReservedDomains(): VisibilityError[];
+}
+/**
+ * Convenience function: check visibility for a set of bundle metadatas.
+ */
+export declare function checkVisibility(manifest: ParsedManifest | null, bundleMetadatas: BundleMetadata[]): VisibilityError[];