@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/store/install-plan.d.ts

@@ -0,0 +1,26 @@
+import type { StorePackageInspection } from "./inspector.ts";
+import type { StoreResolvedSource } from "./resolver.ts";
+export type StoreInstallScope = "user" | "project";
+export type StoreInstallScriptPolicy = "never" | "ask" | "allow";
+export type StoreCompatibilityStatus = "compatible" | "incompatible" | "unknown";
+export interface StoreInstallPlan {
+    input: string;
+    source: string;
+    scope: StoreInstallScope;
+    tracking: boolean;
+    resolved: StoreResolvedSource;
+    inspection: StorePackageInspection;
+    compatibility: StoreCompatibilityStatus;
+    scriptPolicy: StoreInstallScriptPolicy;
+    warnings: string[];
+}
+export interface BuildStoreInstallPlanOptions {
+    resolved: StoreResolvedSource;
+    inspection: StorePackageInspection;
+    scope: StoreInstallScope;
+    scriptPolicy: StoreInstallScriptPolicy;
+    currentVersion?: string;
+}
+export declare function getCompatibilityStatus(range: string | undefined, currentVersion?: string): StoreCompatibilityStatus;
+export declare function buildStoreInstallPlan(options: BuildStoreInstallPlanOptions): StoreInstallPlan;
+//# sourceMappingURL=install-plan.d.ts.map

package/dist/store/install-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plan.d.ts","sourceRoot":"","sources":["../../src/store/install-plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC;AACnD,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AACjE,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,sBAAsB,CAAC;IACnC,aAAa,EAAE,wBAAwB,CAAC;IACxC,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,iBAAiB,CAAC;IACzB,YAAY,EAAE,wBAAwB,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAyBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,SAAU,GAAG,wBAAwB,CAsBpH;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,gBAAgB,CAsC7F","sourcesContent":["import { VERSION } from \"../config.ts\";\nimport type { StorePackageInspection } from \"./inspector.ts\";\nimport type { StoreResolvedSource } from \"./resolver.ts\";\n\nexport type StoreInstallScope = \"user\" | \"project\";\nexport type StoreInstallScriptPolicy = \"never\" | \"ask\" | \"allow\";\nexport type StoreCompatibilityStatus = \"compatible\" | \"incompatible\" | \"unknown\";\n\nexport interface StoreInstallPlan {\n\tinput: string;\n\tsource: string;\n\tscope: StoreInstallScope;\n\ttracking: boolean;\n\tresolved: StoreResolvedSource;\n\tinspection: StorePackageInspection;\n\tcompatibility: StoreCompatibilityStatus;\n\tscriptPolicy: StoreInstallScriptPolicy;\n\twarnings: string[];\n}\n\nexport interface BuildStoreInstallPlanOptions {\n\tresolved: StoreResolvedSource;\n\tinspection: StorePackageInspection;\n\tscope: StoreInstallScope;\n\tscriptPolicy: StoreInstallScriptPolicy;\n\tcurrentVersion?: string;\n}\n\nfunction parseVersionParts(version: string): [number, number, number] | undefined {\n\tconst match = version.match(/^(\\d+)\\.(\\d+)\\.(\\d+)/);\n\tif (!match) {\n\t\treturn undefined;\n\t}\n\treturn [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\nfunction compareVersions(left: string, right: string): number | undefined {\n\tconst leftParts = parseVersionParts(left);\n\tconst rightParts = parseVersionParts(right);\n\tif (!leftParts || !rightParts) {\n\t\treturn undefined;\n\t}\n\tfor (let index = 0; index < leftParts.length; index++) {\n\t\tconst diff = leftParts[index] - rightParts[index];\n\t\tif (diff !== 0) {\n\t\t\treturn diff;\n\t\t}\n\t}\n\treturn 0;\n}\n\nexport function getCompatibilityStatus(range: string | undefined, currentVersion = VERSION): StoreCompatibilityStatus {\n\tif (!range) {\n\t\treturn \"unknown\";\n\t}\n\tconst trimmed = range.trim();\n\tif (!trimmed) {\n\t\treturn \"unknown\";\n\t}\n\n\tconst greaterThanOrEqual = trimmed.match(/^>=\\s*(\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?)$/);\n\tif (greaterThanOrEqual?.[1]) {\n\t\tconst comparison = compareVersions(currentVersion, greaterThanOrEqual[1]);\n\t\treturn comparison === undefined ? \"unknown\" : comparison >= 0 ? \"compatible\" : \"incompatible\";\n\t}\n\n\tconst exact = trimmed.match(/^=?\\s*(\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?)$/);\n\tif (exact?.[1]) {\n\t\tconst comparison = compareVersions(currentVersion, exact[1]);\n\t\treturn comparison === undefined ? \"unknown\" : comparison === 0 ? \"compatible\" : \"incompatible\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction hasDirectScripts(inspection: StorePackageInspection): boolean {\n\treturn Object.keys(inspection.scripts).length > 0;\n}\n\nexport function buildStoreInstallPlan(options: BuildStoreInstallPlanOptions): StoreInstallPlan {\n\tconst compatibility = getCompatibilityStatus(\n\t\toptions.resolved.catalogPackage?.compatibility?.volt,\n\t\toptions.currentVersion ?? VERSION,\n\t);\n\tconst warnings = [\n\t\t...options.resolved.warnings,\n\t\t...options.inspection.warnings,\n\t\t\"Extensions run as local code with the full permissions of the Volt process.\",\n\t];\n\n\tif (options.resolved.catalogPackage && options.resolved.catalogPackage.verified !== true) {\n\t\twarnings.push(\"This catalog entry is not marked verified by Volt maintainers.\");\n\t}\n\tif (compatibility === \"incompatible\") {\n\t\twarnings.push(`Catalog compatibility range is ${options.resolved.catalogPackage?.compatibility?.volt}.`);\n\t}\n\tif (options.scriptPolicy === \"never\") {\n\t\twarnings.push(\"Package lifecycle scripts will be disabled for this store install.\");\n\t} else if (options.scriptPolicy === \"allow\") {\n\t\twarnings.push(\"Package lifecycle scripts are allowed for this store install.\");\n\t} else if (hasDirectScripts(options.inspection)) {\n\t\twarnings.push(\n\t\t\t\"Package declares scripts; interactive confirmation is required before allowing lifecycle scripts.\",\n\t\t);\n\t}\n\n\treturn {\n\t\tinput: options.resolved.input,\n\t\tsource: options.resolved.source,\n\t\tscope: options.scope,\n\t\ttracking: options.resolved.tracking,\n\t\tresolved: options.resolved,\n\t\tinspection: options.inspection,\n\t\tcompatibility,\n\t\tscriptPolicy: options.scriptPolicy,\n\t\twarnings,\n\t};\n}\n"]}

package/dist/store/install-plan.js

@@ -0,0 +1,80 @@
+import { VERSION } from "../config.js";
+function parseVersionParts(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match) {
+        return undefined;
+    }
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compareVersions(left, right) {
+    const leftParts = parseVersionParts(left);
+    const rightParts = parseVersionParts(right);
+    if (!leftParts || !rightParts) {
+        return undefined;
+    }
+    for (let index = 0; index < leftParts.length; index++) {
+        const diff = leftParts[index] - rightParts[index];
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    return 0;
+}
+export function getCompatibilityStatus(range, currentVersion = VERSION) {
+    if (!range) {
+        return "unknown";
+    }
+    const trimmed = range.trim();
+    if (!trimmed) {
+        return "unknown";
+    }
+    const greaterThanOrEqual = trimmed.match(/^>=\s*(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)$/);
+    if (greaterThanOrEqual?.[1]) {
+        const comparison = compareVersions(currentVersion, greaterThanOrEqual[1]);
+        return comparison === undefined ? "unknown" : comparison >= 0 ? "compatible" : "incompatible";
+    }
+    const exact = trimmed.match(/^=?\s*(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)$/);
+    if (exact?.[1]) {
+        const comparison = compareVersions(currentVersion, exact[1]);
+        return comparison === undefined ? "unknown" : comparison === 0 ? "compatible" : "incompatible";
+    }
+    return "unknown";
+}
+function hasDirectScripts(inspection) {
+    return Object.keys(inspection.scripts).length > 0;
+}
+export function buildStoreInstallPlan(options) {
+    const compatibility = getCompatibilityStatus(options.resolved.catalogPackage?.compatibility?.volt, options.currentVersion ?? VERSION);
+    const warnings = [
+        ...options.resolved.warnings,
+        ...options.inspection.warnings,
+        "Extensions run as local code with the full permissions of the Volt process.",
+    ];
+    if (options.resolved.catalogPackage && options.resolved.catalogPackage.verified !== true) {
+        warnings.push("This catalog entry is not marked verified by Volt maintainers.");
+    }
+    if (compatibility === "incompatible") {
+        warnings.push(`Catalog compatibility range is ${options.resolved.catalogPackage?.compatibility?.volt}.`);
+    }
+    if (options.scriptPolicy === "never") {
+        warnings.push("Package lifecycle scripts will be disabled for this store install.");
+    }
+    else if (options.scriptPolicy === "allow") {
+        warnings.push("Package lifecycle scripts are allowed for this store install.");
+    }
+    else if (hasDirectScripts(options.inspection)) {
+        warnings.push("Package declares scripts; interactive confirmation is required before allowing lifecycle scripts.");
+    }
+    return {
+        input: options.resolved.input,
+        source: options.resolved.source,
+        scope: options.scope,
+        tracking: options.resolved.tracking,
+        resolved: options.resolved,
+        inspection: options.inspection,
+        compatibility,
+        scriptPolicy: options.scriptPolicy,
+        warnings,
+    };
+}
+//# sourceMappingURL=install-plan.js.map

package/dist/store/install-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plan.js","sourceRoot":"","sources":["../../src/store/install-plan.ts"],"names":[],"mappings":"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","sourcesContent":["import { VERSION } from \"../config.ts\";\nimport type { StorePackageInspection } from \"./inspector.ts\";\nimport type { StoreResolvedSource } from \"./resolver.ts\";\n\nexport type StoreInstallScope = \"user\" | \"project\";\nexport type StoreInstallScriptPolicy = \"never\" | \"ask\" | \"allow\";\nexport type StoreCompatibilityStatus = \"compatible\" | \"incompatible\" | \"unknown\";\n\nexport interface StoreInstallPlan {\n\tinput: string;\n\tsource: string;\n\tscope: StoreInstallScope;\n\ttracking: boolean;\n\tresolved: StoreResolvedSource;\n\tinspection: StorePackageInspection;\n\tcompatibility: StoreCompatibilityStatus;\n\tscriptPolicy: StoreInstallScriptPolicy;\n\twarnings: string[];\n}\n\nexport interface BuildStoreInstallPlanOptions {\n\tresolved: StoreResolvedSource;\n\tinspection: StorePackageInspection;\n\tscope: StoreInstallScope;\n\tscriptPolicy: StoreInstallScriptPolicy;\n\tcurrentVersion?: string;\n}\n\nfunction parseVersionParts(version: string): [number, number, number] | undefined {\n\tconst match = version.match(/^(\\d+)\\.(\\d+)\\.(\\d+)/);\n\tif (!match) {\n\t\treturn undefined;\n\t}\n\treturn [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\nfunction compareVersions(left: string, right: string): number | undefined {\n\tconst leftParts = parseVersionParts(left);\n\tconst rightParts = parseVersionParts(right);\n\tif (!leftParts || !rightParts) {\n\t\treturn undefined;\n\t}\n\tfor (let index = 0; index < leftParts.length; index++) {\n\t\tconst diff = leftParts[index] - rightParts[index];\n\t\tif (diff !== 0) {\n\t\t\treturn diff;\n\t\t}\n\t}\n\treturn 0;\n}\n\nexport function getCompatibilityStatus(range: string | undefined, currentVersion = VERSION): StoreCompatibilityStatus {\n\tif (!range) {\n\t\treturn \"unknown\";\n\t}\n\tconst trimmed = range.trim();\n\tif (!trimmed) {\n\t\treturn \"unknown\";\n\t}\n\n\tconst greaterThanOrEqual = trimmed.match(/^>=\\s*(\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?)$/);\n\tif (greaterThanOrEqual?.[1]) {\n\t\tconst comparison = compareVersions(currentVersion, greaterThanOrEqual[1]);\n\t\treturn comparison === undefined ? \"unknown\" : comparison >= 0 ? \"compatible\" : \"incompatible\";\n\t}\n\n\tconst exact = trimmed.match(/^=?\\s*(\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?)$/);\n\tif (exact?.[1]) {\n\t\tconst comparison = compareVersions(currentVersion, exact[1]);\n\t\treturn comparison === undefined ? \"unknown\" : comparison === 0 ? \"compatible\" : \"incompatible\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction hasDirectScripts(inspection: StorePackageInspection): boolean {\n\treturn Object.keys(inspection.scripts).length > 0;\n}\n\nexport function buildStoreInstallPlan(options: BuildStoreInstallPlanOptions): StoreInstallPlan {\n\tconst compatibility = getCompatibilityStatus(\n\t\toptions.resolved.catalogPackage?.compatibility?.volt,\n\t\toptions.currentVersion ?? VERSION,\n\t);\n\tconst warnings = [\n\t\t...options.resolved.warnings,\n\t\t...options.inspection.warnings,\n\t\t\"Extensions run as local code with the full permissions of the Volt process.\",\n\t];\n\n\tif (options.resolved.catalogPackage && options.resolved.catalogPackage.verified !== true) {\n\t\twarnings.push(\"This catalog entry is not marked verified by Volt maintainers.\");\n\t}\n\tif (compatibility === \"incompatible\") {\n\t\twarnings.push(`Catalog compatibility range is ${options.resolved.catalogPackage?.compatibility?.volt}.`);\n\t}\n\tif (options.scriptPolicy === \"never\") {\n\t\twarnings.push(\"Package lifecycle scripts will be disabled for this store install.\");\n\t} else if (options.scriptPolicy === \"allow\") {\n\t\twarnings.push(\"Package lifecycle scripts are allowed for this store install.\");\n\t} else if (hasDirectScripts(options.inspection)) {\n\t\twarnings.push(\n\t\t\t\"Package declares scripts; interactive confirmation is required before allowing lifecycle scripts.\",\n\t\t);\n\t}\n\n\treturn {\n\t\tinput: options.resolved.input,\n\t\tsource: options.resolved.source,\n\t\tscope: options.scope,\n\t\ttracking: options.resolved.tracking,\n\t\tresolved: options.resolved,\n\t\tinspection: options.inspection,\n\t\tcompatibility,\n\t\tscriptPolicy: options.scriptPolicy,\n\t\twarnings,\n\t};\n}\n"]}

package/dist/store/render.d.ts

@@ -0,0 +1,11 @@
+import type { StoreCatalogPackage } from "./catalog.ts";
+import type { StorePackageInspection } from "./inspector.ts";
+import type { StoreInstallPlan } from "./install-plan.ts";
+import type { StoreResolvedSource } from "./resolver.ts";
+export declare function formatStoreSourceSummary(source: string): string;
+export declare function formatStoreInstallPlanTarget(plan: StoreInstallPlan): string;
+export declare function formatStoreProgressMessage(source: string, message: string): string;
+export declare function renderCatalogSearch(packages: readonly StoreCatalogPackage[], query?: string): string;
+export declare function renderStoreShow(resolved: StoreResolvedSource, inspection: StorePackageInspection): string;
+export declare function renderStoreInstallPlan(plan: StoreInstallPlan): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/store/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/store/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAqB,MAAM,gBAAgB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQzD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe/D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAM3E;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElF;AA6CD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAcpG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,mBAAmB,EAAE,UAAU,EAAE,sBAAsB,GAAG,MAAM,CAmCzG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA2BrE","sourcesContent":["import chalk from \"chalk\";\nimport { parseGitUrl } from \"../utils/git.ts\";\nimport type { StoreCatalogPackage, StoreResourceType } from \"./catalog.ts\";\nimport type { StorePackageInspection, StoreVoltManifest } from \"./inspector.ts\";\nimport type { StoreInstallPlan } from \"./install-plan.ts\";\nimport type { StoreResolvedSource } from \"./resolver.ts\";\n\nconst RESOURCE_TYPES: StoreResourceType[] = [\"extensions\", \"skills\", \"prompts\", \"themes\"];\n\nfunction formatList(values: readonly string[] | undefined): string {\n\treturn values && values.length > 0 ? values.join(\", \") : \"none\";\n}\n\nexport function formatStoreSourceSummary(source: string): string {\n\tconst gitSource = parseGitUrl(source);\n\tif (gitSource) {\n\t\tconst ref = gitSource.ref\n\t\t\t? ` @ ${/^[0-9a-f]{40}$/i.test(gitSource.ref) ? gitSource.ref.slice(0, 12) : gitSource.ref}`\n\t\t\t: \"\";\n\t\treturn `git ${gitSource.host}/${gitSource.path}${ref}`;\n\t}\n\n\tif (source.startsWith(\"npm:\")) {\n\t\tconst spec = source.slice(\"npm:\".length).trim();\n\t\treturn spec ? `npm ${spec}` : source;\n\t}\n\n\treturn source;\n}\n\nexport function formatStoreInstallPlanTarget(plan: StoreInstallPlan): string {\n\tconst catalogPackage = plan.resolved.catalogPackage;\n\tif (catalogPackage) {\n\t\treturn `${catalogPackage.id} - ${catalogPackage.name}`;\n\t}\n\treturn formatStoreSourceSummary(plan.resolved.source);\n}\n\nexport function formatStoreProgressMessage(source: string, message: string): string {\n\treturn source ? message.split(source).join(formatStoreSourceSummary(source)) : message;\n}\n\nfunction renderRecord(title: string, values: Record<string, string>): string[] {\n\tconst entries = Object.entries(values);\n\tif (entries.length === 0) {\n\t\treturn [`${title}: none`];\n\t}\n\treturn [`${title}:`, ...entries.map(([name, version]) => `  - ${name}: ${version}`)];\n}\n\nfunction renderVoltManifest(manifest: StoreVoltManifest | undefined): string[] {\n\tif (!manifest) {\n\t\treturn [\"Volt manifest: none\"];\n\t}\n\tconst lines = [\"Volt manifest:\"];\n\tfor (const resourceType of RESOURCE_TYPES) {\n\t\tconst entries = manifest[resourceType];\n\t\tif (entries !== undefined) {\n\t\t\tlines.push(`  ${resourceType}: ${formatList(entries)}`);\n\t\t}\n\t}\n\tif (manifest.image) {\n\t\tlines.push(`  image: ${manifest.image}`);\n\t}\n\tif (manifest.video) {\n\t\tlines.push(`  video: ${manifest.video}`);\n\t}\n\treturn lines;\n}\n\nfunction renderDiscoveredResources(inspection: StorePackageInspection): string[] {\n\tconst lines = [\"Discovered resources:\"];\n\tfor (const resourceType of RESOURCE_TYPES) {\n\t\tlines.push(`  ${resourceType}: ${formatList(inspection.discoveredResources[resourceType])}`);\n\t}\n\treturn lines;\n}\n\nfunction renderWarnings(warnings: readonly string[]): string[] {\n\tif (warnings.length === 0) {\n\t\treturn [];\n\t}\n\treturn [\"Warnings:\", ...warnings.map((warning) => `  - ${warning}`)];\n}\n\nexport function renderCatalogSearch(packages: readonly StoreCatalogPackage[], query?: string): string {\n\tif (packages.length === 0) {\n\t\treturn query?.trim() ? `No store packages found for \"${query.trim()}\".` : \"No store packages found.\";\n\t}\n\n\tconst lines = [chalk.bold(\"Store packages:\")];\n\tfor (const pkg of packages) {\n\t\tconst verified = pkg.verified ? \" verified\" : \"\";\n\t\tconst categories = pkg.categories && pkg.categories.length > 0 ? ` [${pkg.categories.join(\", \")}]` : \"\";\n\t\tlines.push(`${pkg.id} - ${pkg.name}${verified}${categories}`);\n\t\tlines.push(chalk.dim(`  ${pkg.description}`));\n\t\tlines.push(chalk.dim(`  Source: ${formatStoreSourceSummary(pkg.source)}`));\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nexport function renderStoreShow(resolved: StoreResolvedSource, inspection: StorePackageInspection): string {\n\tconst lines: string[] = [];\n\tconst catalogPackage = resolved.catalogPackage;\n\tif (catalogPackage) {\n\t\tlines.push(chalk.bold(catalogPackage.name));\n\t\tlines.push(`ID: ${catalogPackage.id}`);\n\t\tlines.push(`Description: ${catalogPackage.description}`);\n\t\tlines.push(`Source: ${formatStoreSourceSummary(catalogPackage.source)}`);\n\t\tlines.push(`Verified: ${catalogPackage.verified === true ? \"yes\" : \"no\"}`);\n\t\tif (catalogPackage.repo) lines.push(`Repo: ${catalogPackage.repo}`);\n\t\tif (catalogPackage.author) lines.push(`Author: ${catalogPackage.author}`);\n\t\tif (catalogPackage.license) lines.push(`License: ${catalogPackage.license}`);\n\t\tif (catalogPackage.resources) lines.push(`Catalog resources: ${formatList(catalogPackage.resources)}`);\n\t\tif (catalogPackage.compatibility?.volt) lines.push(`Volt compatibility: ${catalogPackage.compatibility.volt}`);\n\t\tlines.push(\"\");\n\t} else {\n\t\tlines.push(chalk.bold(resolved.input));\n\t\tlines.push(`Source: ${formatStoreSourceSummary(resolved.source)}`);\n\t\tlines.push(\"\");\n\t}\n\n\tlines.push(chalk.bold(\"Package metadata\"));\n\tlines.push(`Name: ${inspection.packageName ?? \"unknown\"}`);\n\tlines.push(`Version: ${inspection.packageVersion ?? \"unknown\"}`);\n\tlines.push(`Description: ${inspection.packageDescription ?? \"unknown\"}`);\n\tlines.push(`License: ${inspection.packageLicense ?? \"unknown\"}`);\n\tlines.push(`Repository: ${inspection.packageRepository ?? \"unknown\"}`);\n\tlines.push(...renderVoltManifest(inspection.voltManifest));\n\tlines.push(...renderDiscoveredResources(inspection));\n\tlines.push(...renderRecord(\"Dependencies\", inspection.dependencies));\n\tlines.push(...renderRecord(\"Peer dependencies\", inspection.peerDependencies));\n\tlines.push(...renderRecord(\"Optional dependencies\", inspection.optionalDependencies));\n\tlines.push(...renderRecord(\"Scripts\", inspection.scripts));\n\tlines.push(...renderWarnings([...resolved.warnings, ...inspection.warnings]));\n\treturn lines.join(\"\\n\");\n}\n\nexport function renderStoreInstallPlan(plan: StoreInstallPlan): string {\n\tconst target = formatStoreInstallPlanTarget(plan);\n\tconst source = formatStoreSourceSummary(plan.source);\n\tconst lines = [\n\t\tchalk.bold(\"Store install plan\"),\n\t\t...(target !== source ? [`Package: ${target}`] : []),\n\t\t`Source: ${source}`,\n\t\t`Scope: ${plan.scope}`,\n\t\t`Tracking: ${plan.tracking ? \"yes\" : \"no\"}`,\n\t\t`Script policy: ${plan.scriptPolicy}`,\n\t\t`Compatibility: ${plan.compatibility}`,\n\t\t\"\",\n\t\tchalk.bold(\"Package metadata\"),\n\t\t`Name: ${plan.inspection.packageName ?? \"unknown\"}`,\n\t\t`Version: ${plan.inspection.packageVersion ?? \"unknown\"}`,\n\t\t`Description: ${plan.inspection.packageDescription ?? \"unknown\"}`,\n\t\t`License: ${plan.inspection.packageLicense ?? \"unknown\"}`,\n\t\t`Repository: ${plan.inspection.packageRepository ?? \"unknown\"}`,\n\t\t...renderVoltManifest(plan.inspection.voltManifest),\n\t\t...renderDiscoveredResources(plan.inspection),\n\t\t...renderRecord(\"Dependencies\", plan.inspection.dependencies),\n\t\t...renderRecord(\"Peer dependencies\", plan.inspection.peerDependencies),\n\t\t...renderRecord(\"Optional dependencies\", plan.inspection.optionalDependencies),\n\t\t...renderRecord(\"Scripts\", plan.inspection.scripts),\n\t\t...renderWarnings(plan.warnings),\n\t];\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/store/render.js

@@ -0,0 +1,153 @@
+import chalk from "chalk";
+import { parseGitUrl } from "../utils/git.js";
+const RESOURCE_TYPES = ["extensions", "skills", "prompts", "themes"];
+function formatList(values) {
+    return values && values.length > 0 ? values.join(", ") : "none";
+}
+export function formatStoreSourceSummary(source) {
+    const gitSource = parseGitUrl(source);
+    if (gitSource) {
+        const ref = gitSource.ref
+            ? ` @ ${/^[0-9a-f]{40}$/i.test(gitSource.ref) ? gitSource.ref.slice(0, 12) : gitSource.ref}`
+            : "";
+        return `git ${gitSource.host}/${gitSource.path}${ref}`;
+    }
+    if (source.startsWith("npm:")) {
+        const spec = source.slice("npm:".length).trim();
+        return spec ? `npm ${spec}` : source;
+    }
+    return source;
+}
+export function formatStoreInstallPlanTarget(plan) {
+    const catalogPackage = plan.resolved.catalogPackage;
+    if (catalogPackage) {
+        return `${catalogPackage.id} - ${catalogPackage.name}`;
+    }
+    return formatStoreSourceSummary(plan.resolved.source);
+}
+export function formatStoreProgressMessage(source, message) {
+    return source ? message.split(source).join(formatStoreSourceSummary(source)) : message;
+}
+function renderRecord(title, values) {
+    const entries = Object.entries(values);
+    if (entries.length === 0) {
+        return [`${title}: none`];
+    }
+    return [`${title}:`, ...entries.map(([name, version]) => `  - ${name}: ${version}`)];
+}
+function renderVoltManifest(manifest) {
+    if (!manifest) {
+        return ["Volt manifest: none"];
+    }
+    const lines = ["Volt manifest:"];
+    for (const resourceType of RESOURCE_TYPES) {
+        const entries = manifest[resourceType];
+        if (entries !== undefined) {
+            lines.push(`  ${resourceType}: ${formatList(entries)}`);
+        }
+    }
+    if (manifest.image) {
+        lines.push(`  image: ${manifest.image}`);
+    }
+    if (manifest.video) {
+        lines.push(`  video: ${manifest.video}`);
+    }
+    return lines;
+}
+function renderDiscoveredResources(inspection) {
+    const lines = ["Discovered resources:"];
+    for (const resourceType of RESOURCE_TYPES) {
+        lines.push(`  ${resourceType}: ${formatList(inspection.discoveredResources[resourceType])}`);
+    }
+    return lines;
+}
+function renderWarnings(warnings) {
+    if (warnings.length === 0) {
+        return [];
+    }
+    return ["Warnings:", ...warnings.map((warning) => `  - ${warning}`)];
+}
+export function renderCatalogSearch(packages, query) {
+    if (packages.length === 0) {
+        return query?.trim() ? `No store packages found for "${query.trim()}".` : "No store packages found.";
+    }
+    const lines = [chalk.bold("Store packages:")];
+    for (const pkg of packages) {
+        const verified = pkg.verified ? " verified" : "";
+        const categories = pkg.categories && pkg.categories.length > 0 ? ` [${pkg.categories.join(", ")}]` : "";
+        lines.push(`${pkg.id} - ${pkg.name}${verified}${categories}`);
+        lines.push(chalk.dim(`  ${pkg.description}`));
+        lines.push(chalk.dim(`  Source: ${formatStoreSourceSummary(pkg.source)}`));
+    }
+    return lines.join("\n");
+}
+export function renderStoreShow(resolved, inspection) {
+    const lines = [];
+    const catalogPackage = resolved.catalogPackage;
+    if (catalogPackage) {
+        lines.push(chalk.bold(catalogPackage.name));
+        lines.push(`ID: ${catalogPackage.id}`);
+        lines.push(`Description: ${catalogPackage.description}`);
+        lines.push(`Source: ${formatStoreSourceSummary(catalogPackage.source)}`);
+        lines.push(`Verified: ${catalogPackage.verified === true ? "yes" : "no"}`);
+        if (catalogPackage.repo)
+            lines.push(`Repo: ${catalogPackage.repo}`);
+        if (catalogPackage.author)
+            lines.push(`Author: ${catalogPackage.author}`);
+        if (catalogPackage.license)
+            lines.push(`License: ${catalogPackage.license}`);
+        if (catalogPackage.resources)
+            lines.push(`Catalog resources: ${formatList(catalogPackage.resources)}`);
+        if (catalogPackage.compatibility?.volt)
+            lines.push(`Volt compatibility: ${catalogPackage.compatibility.volt}`);
+        lines.push("");
+    }
+    else {
+        lines.push(chalk.bold(resolved.input));
+        lines.push(`Source: ${formatStoreSourceSummary(resolved.source)}`);
+        lines.push("");
+    }
+    lines.push(chalk.bold("Package metadata"));
+    lines.push(`Name: ${inspection.packageName ?? "unknown"}`);
+    lines.push(`Version: ${inspection.packageVersion ?? "unknown"}`);
+    lines.push(`Description: ${inspection.packageDescription ?? "unknown"}`);
+    lines.push(`License: ${inspection.packageLicense ?? "unknown"}`);
+    lines.push(`Repository: ${inspection.packageRepository ?? "unknown"}`);
+    lines.push(...renderVoltManifest(inspection.voltManifest));
+    lines.push(...renderDiscoveredResources(inspection));
+    lines.push(...renderRecord("Dependencies", inspection.dependencies));
+    lines.push(...renderRecord("Peer dependencies", inspection.peerDependencies));
+    lines.push(...renderRecord("Optional dependencies", inspection.optionalDependencies));
+    lines.push(...renderRecord("Scripts", inspection.scripts));
+    lines.push(...renderWarnings([...resolved.warnings, ...inspection.warnings]));
+    return lines.join("\n");
+}
+export function renderStoreInstallPlan(plan) {
+    const target = formatStoreInstallPlanTarget(plan);
+    const source = formatStoreSourceSummary(plan.source);
+    const lines = [
+        chalk.bold("Store install plan"),
+        ...(target !== source ? [`Package: ${target}`] : []),
+        `Source: ${source}`,
+        `Scope: ${plan.scope}`,
+        `Tracking: ${plan.tracking ? "yes" : "no"}`,
+        `Script policy: ${plan.scriptPolicy}`,
+        `Compatibility: ${plan.compatibility}`,
+        "",
+        chalk.bold("Package metadata"),
+        `Name: ${plan.inspection.packageName ?? "unknown"}`,
+        `Version: ${plan.inspection.packageVersion ?? "unknown"}`,
+        `Description: ${plan.inspection.packageDescription ?? "unknown"}`,
+        `License: ${plan.inspection.packageLicense ?? "unknown"}`,
+        `Repository: ${plan.inspection.packageRepository ?? "unknown"}`,
+        ...renderVoltManifest(plan.inspection.voltManifest),
+        ...renderDiscoveredResources(plan.inspection),
+        ...renderRecord("Dependencies", plan.inspection.dependencies),
+        ...renderRecord("Peer dependencies", plan.inspection.peerDependencies),
+        ...renderRecord("Optional dependencies", plan.inspection.optionalDependencies),
+        ...renderRecord("Scripts", plan.inspection.scripts),
+        ...renderWarnings(plan.warnings),
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/store/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/store/render.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from \"chalk\";\nimport { parseGitUrl } from \"../utils/git.ts\";\nimport type { StoreCatalogPackage, StoreResourceType } from \"./catalog.ts\";\nimport type { StorePackageInspection, StoreVoltManifest } from \"./inspector.ts\";\nimport type { StoreInstallPlan } from \"./install-plan.ts\";\nimport type { StoreResolvedSource } from \"./resolver.ts\";\n\nconst RESOURCE_TYPES: StoreResourceType[] = [\"extensions\", \"skills\", \"prompts\", \"themes\"];\n\nfunction formatList(values: readonly string[] | undefined): string {\n\treturn values && values.length > 0 ? values.join(\", \") : \"none\";\n}\n\nexport function formatStoreSourceSummary(source: string): string {\n\tconst gitSource = parseGitUrl(source);\n\tif (gitSource) {\n\t\tconst ref = gitSource.ref\n\t\t\t? ` @ ${/^[0-9a-f]{40}$/i.test(gitSource.ref) ? gitSource.ref.slice(0, 12) : gitSource.ref}`\n\t\t\t: \"\";\n\t\treturn `git ${gitSource.host}/${gitSource.path}${ref}`;\n\t}\n\n\tif (source.startsWith(\"npm:\")) {\n\t\tconst spec = source.slice(\"npm:\".length).trim();\n\t\treturn spec ? `npm ${spec}` : source;\n\t}\n\n\treturn source;\n}\n\nexport function formatStoreInstallPlanTarget(plan: StoreInstallPlan): string {\n\tconst catalogPackage = plan.resolved.catalogPackage;\n\tif (catalogPackage) {\n\t\treturn `${catalogPackage.id} - ${catalogPackage.name}`;\n\t}\n\treturn formatStoreSourceSummary(plan.resolved.source);\n}\n\nexport function formatStoreProgressMessage(source: string, message: string): string {\n\treturn source ? message.split(source).join(formatStoreSourceSummary(source)) : message;\n}\n\nfunction renderRecord(title: string, values: Record<string, string>): string[] {\n\tconst entries = Object.entries(values);\n\tif (entries.length === 0) {\n\t\treturn [`${title}: none`];\n\t}\n\treturn [`${title}:`, ...entries.map(([name, version]) => `  - ${name}: ${version}`)];\n}\n\nfunction renderVoltManifest(manifest: StoreVoltManifest | undefined): string[] {\n\tif (!manifest) {\n\t\treturn [\"Volt manifest: none\"];\n\t}\n\tconst lines = [\"Volt manifest:\"];\n\tfor (const resourceType of RESOURCE_TYPES) {\n\t\tconst entries = manifest[resourceType];\n\t\tif (entries !== undefined) {\n\t\t\tlines.push(`  ${resourceType}: ${formatList(entries)}`);\n\t\t}\n\t}\n\tif (manifest.image) {\n\t\tlines.push(`  image: ${manifest.image}`);\n\t}\n\tif (manifest.video) {\n\t\tlines.push(`  video: ${manifest.video}`);\n\t}\n\treturn lines;\n}\n\nfunction renderDiscoveredResources(inspection: StorePackageInspection): string[] {\n\tconst lines = [\"Discovered resources:\"];\n\tfor (const resourceType of RESOURCE_TYPES) {\n\t\tlines.push(`  ${resourceType}: ${formatList(inspection.discoveredResources[resourceType])}`);\n\t}\n\treturn lines;\n}\n\nfunction renderWarnings(warnings: readonly string[]): string[] {\n\tif (warnings.length === 0) {\n\t\treturn [];\n\t}\n\treturn [\"Warnings:\", ...warnings.map((warning) => `  - ${warning}`)];\n}\n\nexport function renderCatalogSearch(packages: readonly StoreCatalogPackage[], query?: string): string {\n\tif (packages.length === 0) {\n\t\treturn query?.trim() ? `No store packages found for \"${query.trim()}\".` : \"No store packages found.\";\n\t}\n\n\tconst lines = [chalk.bold(\"Store packages:\")];\n\tfor (const pkg of packages) {\n\t\tconst verified = pkg.verified ? \" verified\" : \"\";\n\t\tconst categories = pkg.categories && pkg.categories.length > 0 ? ` [${pkg.categories.join(\", \")}]` : \"\";\n\t\tlines.push(`${pkg.id} - ${pkg.name}${verified}${categories}`);\n\t\tlines.push(chalk.dim(`  ${pkg.description}`));\n\t\tlines.push(chalk.dim(`  Source: ${formatStoreSourceSummary(pkg.source)}`));\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nexport function renderStoreShow(resolved: StoreResolvedSource, inspection: StorePackageInspection): string {\n\tconst lines: string[] = [];\n\tconst catalogPackage = resolved.catalogPackage;\n\tif (catalogPackage) {\n\t\tlines.push(chalk.bold(catalogPackage.name));\n\t\tlines.push(`ID: ${catalogPackage.id}`);\n\t\tlines.push(`Description: ${catalogPackage.description}`);\n\t\tlines.push(`Source: ${formatStoreSourceSummary(catalogPackage.source)}`);\n\t\tlines.push(`Verified: ${catalogPackage.verified === true ? \"yes\" : \"no\"}`);\n\t\tif (catalogPackage.repo) lines.push(`Repo: ${catalogPackage.repo}`);\n\t\tif (catalogPackage.author) lines.push(`Author: ${catalogPackage.author}`);\n\t\tif (catalogPackage.license) lines.push(`License: ${catalogPackage.license}`);\n\t\tif (catalogPackage.resources) lines.push(`Catalog resources: ${formatList(catalogPackage.resources)}`);\n\t\tif (catalogPackage.compatibility?.volt) lines.push(`Volt compatibility: ${catalogPackage.compatibility.volt}`);\n\t\tlines.push(\"\");\n\t} else {\n\t\tlines.push(chalk.bold(resolved.input));\n\t\tlines.push(`Source: ${formatStoreSourceSummary(resolved.source)}`);\n\t\tlines.push(\"\");\n\t}\n\n\tlines.push(chalk.bold(\"Package metadata\"));\n\tlines.push(`Name: ${inspection.packageName ?? \"unknown\"}`);\n\tlines.push(`Version: ${inspection.packageVersion ?? \"unknown\"}`);\n\tlines.push(`Description: ${inspection.packageDescription ?? \"unknown\"}`);\n\tlines.push(`License: ${inspection.packageLicense ?? \"unknown\"}`);\n\tlines.push(`Repository: ${inspection.packageRepository ?? \"unknown\"}`);\n\tlines.push(...renderVoltManifest(inspection.voltManifest));\n\tlines.push(...renderDiscoveredResources(inspection));\n\tlines.push(...renderRecord(\"Dependencies\", inspection.dependencies));\n\tlines.push(...renderRecord(\"Peer dependencies\", inspection.peerDependencies));\n\tlines.push(...renderRecord(\"Optional dependencies\", inspection.optionalDependencies));\n\tlines.push(...renderRecord(\"Scripts\", inspection.scripts));\n\tlines.push(...renderWarnings([...resolved.warnings, ...inspection.warnings]));\n\treturn lines.join(\"\\n\");\n}\n\nexport function renderStoreInstallPlan(plan: StoreInstallPlan): string {\n\tconst target = formatStoreInstallPlanTarget(plan);\n\tconst source = formatStoreSourceSummary(plan.source);\n\tconst lines = [\n\t\tchalk.bold(\"Store install plan\"),\n\t\t...(target !== source ? [`Package: ${target}`] : []),\n\t\t`Source: ${source}`,\n\t\t`Scope: ${plan.scope}`,\n\t\t`Tracking: ${plan.tracking ? \"yes\" : \"no\"}`,\n\t\t`Script policy: ${plan.scriptPolicy}`,\n\t\t`Compatibility: ${plan.compatibility}`,\n\t\t\"\",\n\t\tchalk.bold(\"Package metadata\"),\n\t\t`Name: ${plan.inspection.packageName ?? \"unknown\"}`,\n\t\t`Version: ${plan.inspection.packageVersion ?? \"unknown\"}`,\n\t\t`Description: ${plan.inspection.packageDescription ?? \"unknown\"}`,\n\t\t`License: ${plan.inspection.packageLicense ?? \"unknown\"}`,\n\t\t`Repository: ${plan.inspection.packageRepository ?? \"unknown\"}`,\n\t\t...renderVoltManifest(plan.inspection.voltManifest),\n\t\t...renderDiscoveredResources(plan.inspection),\n\t\t...renderRecord(\"Dependencies\", plan.inspection.dependencies),\n\t\t...renderRecord(\"Peer dependencies\", plan.inspection.peerDependencies),\n\t\t...renderRecord(\"Optional dependencies\", plan.inspection.optionalDependencies),\n\t\t...renderRecord(\"Scripts\", plan.inspection.scripts),\n\t\t...renderWarnings(plan.warnings),\n\t];\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/store/resolver.d.ts

@@ -0,0 +1,22 @@
+import { type StoreCatalog, type StoreCatalogPackage } from "./catalog.ts";
+export type StoreResolvedSourceKind = "catalog" | "npm" | "git" | "local";
+export interface StoreResolvedSource {
+    input: string;
+    source: string;
+    kind: StoreResolvedSourceKind;
+    catalogPackage?: StoreCatalogPackage;
+    pinned: boolean;
+    tracking: boolean;
+    warnings: string[];
+}
+export type StoreGitLsRemote = (repo: string, ref: string) => Promise<string>;
+export interface ResolveStoreSourceOptions {
+    input: string;
+    catalog: StoreCatalog;
+    track?: boolean;
+    pinGit?: boolean;
+    ref?: string;
+    gitLsRemote?: StoreGitLsRemote;
+}
+export declare function resolveStoreSource(options: ResolveStoreSourceOptions): Promise<StoreResolvedSource>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/store/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/store/resolver.ts"],"names":[],"mappings":"AASA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAExB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,uBAAuB,CAAC;IAC9B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAkHD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA0GzG","sourcesContent":["import type { ChildProcessByStdio } from \"node:child_process\";\nimport { isAbsolute } from \"node:path\";\nimport type { Readable } from \"node:stream\";\nimport { spawnProcess } from \"../utils/child-process.ts\";\nimport type { GitSource } from \"../utils/git.ts\";\nimport { parseGitUrl } from \"../utils/git.ts\";\nimport { type ParsedNpmSpec, parseNpmSpec } from \"../utils/npm-spec.ts\";\nimport { isLocalPath } from \"../utils/paths.ts\";\nimport { getSubprocessEnv } from \"../utils/process-env.ts\";\nimport {\n\tfindCatalogPackage,\n\ttype StoreCatalog,\n\ttype StoreCatalogPackage,\n\tsuggestCatalogPackageIds,\n} from \"./catalog.ts\";\n\nexport type StoreResolvedSourceKind = \"catalog\" | \"npm\" | \"git\" | \"local\";\n\nexport interface StoreResolvedSource {\n\tinput: string;\n\tsource: string;\n\tkind: StoreResolvedSourceKind;\n\tcatalogPackage?: StoreCatalogPackage;\n\tpinned: boolean;\n\ttracking: boolean;\n\twarnings: string[];\n}\n\nexport type StoreGitLsRemote = (repo: string, ref: string) => Promise<string>;\n\nexport interface ResolveStoreSourceOptions {\n\tinput: string;\n\tcatalog: StoreCatalog;\n\ttrack?: boolean;\n\tpinGit?: boolean;\n\tref?: string;\n\tgitLsRemote?: StoreGitLsRemote;\n}\n\nconst GIT_REMOTE_TIMEOUT_MS = 10000;\n\nfunction parseNpmSource(source: string): ParsedNpmSpec | undefined {\n\tif (!source.startsWith(\"npm:\")) {\n\t\treturn undefined;\n\t}\n\tconst spec = source.slice(\"npm:\".length).trim();\n\tif (!spec) {\n\t\tthrow new Error(\"npm store source must include a package spec\");\n\t}\n\treturn parseNpmSpec(spec);\n}\n\nfunction isStoreLocalPathInput(input: string): boolean {\n\tconst trimmed = input.trim();\n\treturn (\n\t\ttrimmed === \".\" ||\n\t\ttrimmed === \"..\" ||\n\t\ttrimmed.startsWith(\"./\") ||\n\t\ttrimmed.startsWith(\".\\\\\") ||\n\t\ttrimmed.startsWith(\"../\") ||\n\t\ttrimmed.startsWith(\"..\\\\\") ||\n\t\ttrimmed.startsWith(\"~/\") ||\n\t\ttrimmed.startsWith(\"~\\\\\") ||\n\t\ttrimmed.startsWith(\"file://\") ||\n\t\tisAbsolute(trimmed) ||\n\t\t(isLocalPath(trimmed) && (trimmed.includes(\"/\") || trimmed.includes(\"\\\\\")))\n\t);\n}\n\nfunction formatGitSource(source: GitSource, ref?: string): string {\n\treturn `git:${source.repo}${ref ? `@${ref}` : \"\"}`;\n}\n\nfunction withGitRef(source: GitSource, ref: string): GitSource {\n\treturn {\n\t\t...source,\n\t\tref,\n\t\tpinned: true,\n\t};\n}\n\nfunction isCommitRef(ref: string): boolean {\n\treturn /^[0-9a-f]{40}$/i.test(ref);\n}\n\nfunction parseLsRemoteCommit(output: string, ref: string): string {\n\tconst escapedRef = ref.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\tconst refPattern = ref === \"HEAD\" ? \"HEAD\" : escapedRef;\n\tconst pattern = new RegExp(`^([0-9a-f]{40})\\\\s+${refPattern}$`, \"im\");\n\tconst exactMatch = output.match(pattern);\n\tif (exactMatch?.[1]) {\n\t\treturn exactMatch[1];\n\t}\n\tconst firstCommit = output.match(/^([0-9a-f]{40})\\s+/m);\n\tif (firstCommit?.[1]) {\n\t\treturn firstCommit[1];\n\t}\n\tthrow new Error(`Unable to resolve git ref ${ref}`);\n}\n\nfunction runGitLsRemote(repo: string, ref: string): Promise<string> {\n\treturn new Promise((resolvePromise, reject) => {\n\t\tconst child = spawnProcess(\"git\", [\"ls-remote\", repo, ref], {\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\tenv: { ...getSubprocessEnv(), GIT_TERMINAL_PROMPT: \"0\" },\n\t\t}) as ChildProcessByStdio<null, Readable, Readable>;\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet timedOut = false;\n\t\tconst timeout = setTimeout(() => {\n\t\t\ttimedOut = true;\n\t\t\tchild.kill();\n\t\t}, GIT_REMOTE_TIMEOUT_MS);\n\n\t\tchild.stdout.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\t\tchild.stderr.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\t\tchild.once(\"error\", (error) => {\n\t\t\tclearTimeout(timeout);\n\t\t\treject(error);\n\t\t});\n\t\tchild.once(\"close\", (code, signal) => {\n\t\t\tclearTimeout(timeout);\n\t\t\tif (timedOut) {\n\t\t\t\treject(new Error(`git ls-remote ${repo} ${ref} timed out`));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (code === 0) {\n\t\t\t\tresolvePromise(stdout.trim());\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst status = code === null ? `signal ${signal ?? \"unknown\"}` : `code ${code}`;\n\t\t\treject(new Error(`git ls-remote ${repo} ${ref} failed with ${status}: ${stderr || stdout}`));\n\t\t});\n\t});\n}\n\nasync function resolveGitCommit(repo: string, ref: string, gitLsRemote?: StoreGitLsRemote): Promise<string> {\n\tconst output = gitLsRemote ? await gitLsRemote(repo, ref) : await runGitLsRemote(repo, ref);\n\treturn parseLsRemoteCommit(output, ref);\n}\n\nfunction buildUnknownSourceError(input: string, catalog: StoreCatalog): Error {\n\tconst suggestions = suggestCatalogPackageIds(catalog, input);\n\tconst suffix = suggestions.length > 0 ? ` Did you mean ${suggestions.join(\", \")}?` : \"\";\n\treturn new Error(`Unknown store package or source: ${input}.${suffix}`);\n}\n\nexport async function resolveStoreSource(options: ResolveStoreSourceOptions): Promise<StoreResolvedSource> {\n\tconst input = options.input.trim();\n\tif (!input) {\n\t\tthrow new Error(\"Missing store source.\");\n\t}\n\n\tconst catalogPackage = findCatalogPackage(options.catalog, input);\n\tconst baseSource = catalogPackage?.source ?? input;\n\tconst baseKind: StoreResolvedSourceKind = catalogPackage ? \"catalog\" : \"local\";\n\tconst warnings: string[] = [];\n\tconst track = options.track ?? false;\n\n\tconst npmInfo = parseNpmSource(baseSource);\n\tif (npmInfo) {\n\t\tif (options.ref) {\n\t\t\tthrow new Error(\"--ref is only valid for git store sources\");\n\t\t}\n\t\tif (track) {\n\t\t\tthrow new Error(\"--track is only valid for git store sources\");\n\t\t}\n\t\tif (!npmInfo.version) {\n\t\t\twarnings.push(`npm package ${npmInfo.name} is not pinned to an exact version.`);\n\t\t} else if (!npmInfo.exactVersion) {\n\t\t\twarnings.push(`npm package ${npmInfo.name} uses non-exact version spec \"${npmInfo.version}\".`);\n\t\t}\n\t\tconst pinned = npmInfo.exactVersion;\n\t\treturn {\n\t\t\tinput,\n\t\t\tsource: baseSource,\n\t\t\tkind: catalogPackage ? \"catalog\" : \"npm\",\n\t\t\t...(catalogPackage ? { catalogPackage } : {}),\n\t\t\tpinned,\n\t\t\ttracking: !pinned,\n\t\t\twarnings,\n\t\t};\n\t}\n\n\tlet gitSource = parseGitUrl(baseSource);\n\tif (gitSource) {\n\t\tif (options.ref) {\n\t\t\tgitSource = withGitRef(gitSource, options.ref);\n\t\t}\n\n\t\tif (!gitSource.ref) {\n\t\t\tif (track || options.pinGit === false) {\n\t\t\t\twarnings.push(\"Git source has no ref and will track the repository default branch if installed.\");\n\t\t\t\treturn {\n\t\t\t\t\tinput,\n\t\t\t\t\tsource: formatGitSource(gitSource),\n\t\t\t\t\tkind: catalogPackage ? \"catalog\" : \"git\",\n\t\t\t\t\t...(catalogPackage ? { catalogPackage } : {}),\n\t\t\t\t\tpinned: false,\n\t\t\t\t\ttracking: true,\n\t\t\t\t\twarnings,\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst commit = await resolveGitCommit(gitSource.repo, \"HEAD\", options.gitLsRemote);\n\t\t\treturn {\n\t\t\t\tinput,\n\t\t\t\tsource: formatGitSource(gitSource, commit),\n\t\t\t\tkind: catalogPackage ? \"catalog\" : \"git\",\n\t\t\t\t...(catalogPackage ? { catalogPackage } : {}),\n\t\t\t\tpinned: true,\n\t\t\t\ttracking: false,\n\t\t\t\twarnings,\n\t\t\t};\n\t\t}\n\n\t\tif (!isCommitRef(gitSource.ref)) {\n\t\t\twarnings.push(`Git ref \"${gitSource.ref}\" can be moved by repository owners; commits are more reproducible.`);\n\t\t}\n\t\treturn {\n\t\t\tinput,\n\t\t\tsource: options.ref ? formatGitSource(gitSource, gitSource.ref) : baseSource,\n\t\t\tkind: catalogPackage ? \"catalog\" : \"git\",\n\t\t\t...(catalogPackage ? { catalogPackage } : {}),\n\t\t\tpinned: !track,\n\t\t\ttracking: track,\n\t\t\twarnings,\n\t\t};\n\t}\n\n\tif (!catalogPackage && !isStoreLocalPathInput(input)) {\n\t\tthrow buildUnknownSourceError(input, options.catalog);\n\t}\n\tif (options.ref) {\n\t\tthrow new Error(\"--ref is only valid for git store sources\");\n\t}\n\tif (track) {\n\t\tthrow new Error(\"--track is only valid for git store sources\");\n\t}\n\n\tif (catalogPackage && !isLocalPath(baseSource)) {\n\t\tthrow new Error(`Catalog package ${catalogPackage.id} has an unsupported source: ${baseSource}`);\n\t}\n\n\twarnings.push(\"Local package paths are not reproducible and should not appear in public catalogs.\");\n\treturn {\n\t\tinput,\n\t\tsource: baseSource,\n\t\tkind: catalogPackage ? baseKind : \"local\",\n\t\t...(catalogPackage ? { catalogPackage } : {}),\n\t\tpinned: false,\n\t\ttracking: false,\n\t\twarnings,\n\t};\n}\n"]}

package/dist/store/resolver.js

@@ -0,0 +1,207 @@
+import { isAbsolute } from "node:path";
+import { spawnProcess } from "../utils/child-process.js";
+import { parseGitUrl } from "../utils/git.js";
+import { parseNpmSpec } from "../utils/npm-spec.js";
+import { isLocalPath } from "../utils/paths.js";
+import { getSubprocessEnv } from "../utils/process-env.js";
+import { findCatalogPackage, suggestCatalogPackageIds, } from "./catalog.js";
+const GIT_REMOTE_TIMEOUT_MS = 10000;
+function parseNpmSource(source) {
+    if (!source.startsWith("npm:")) {
+        return undefined;
+    }
+    const spec = source.slice("npm:".length).trim();
+    if (!spec) {
+        throw new Error("npm store source must include a package spec");
+    }
+    return parseNpmSpec(spec);
+}
+function isStoreLocalPathInput(input) {
+    const trimmed = input.trim();
+    return (trimmed === "." ||
+        trimmed === ".." ||
+        trimmed.startsWith("./") ||
+        trimmed.startsWith(".\\") ||
+        trimmed.startsWith("../") ||
+        trimmed.startsWith("..\\") ||
+        trimmed.startsWith("~/") ||
+        trimmed.startsWith("~\\") ||
+        trimmed.startsWith("file://") ||
+        isAbsolute(trimmed) ||
+        (isLocalPath(trimmed) && (trimmed.includes("/") || trimmed.includes("\\"))));
+}
+function formatGitSource(source, ref) {
+    return `git:${source.repo}${ref ? `@${ref}` : ""}`;
+}
+function withGitRef(source, ref) {
+    return {
+        ...source,
+        ref,
+        pinned: true,
+    };
+}
+function isCommitRef(ref) {
+    return /^[0-9a-f]{40}$/i.test(ref);
+}
+function parseLsRemoteCommit(output, ref) {
+    const escapedRef = ref.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const refPattern = ref === "HEAD" ? "HEAD" : escapedRef;
+    const pattern = new RegExp(`^([0-9a-f]{40})\\s+${refPattern}$`, "im");
+    const exactMatch = output.match(pattern);
+    if (exactMatch?.[1]) {
+        return exactMatch[1];
+    }
+    const firstCommit = output.match(/^([0-9a-f]{40})\s+/m);
+    if (firstCommit?.[1]) {
+        return firstCommit[1];
+    }
+    throw new Error(`Unable to resolve git ref ${ref}`);
+}
+function runGitLsRemote(repo, ref) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawnProcess("git", ["ls-remote", repo, ref], {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...getSubprocessEnv(), GIT_TERMINAL_PROMPT: "0" },
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            child.kill();
+        }, GIT_REMOTE_TIMEOUT_MS);
+        child.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.once("error", (error) => {
+            clearTimeout(timeout);
+            reject(error);
+        });
+        child.once("close", (code, signal) => {
+            clearTimeout(timeout);
+            if (timedOut) {
+                reject(new Error(`git ls-remote ${repo} ${ref} timed out`));
+                return;
+            }
+            if (code === 0) {
+                resolvePromise(stdout.trim());
+                return;
+            }
+            const status = code === null ? `signal ${signal ?? "unknown"}` : `code ${code}`;
+            reject(new Error(`git ls-remote ${repo} ${ref} failed with ${status}: ${stderr || stdout}`));
+        });
+    });
+}
+async function resolveGitCommit(repo, ref, gitLsRemote) {
+    const output = gitLsRemote ? await gitLsRemote(repo, ref) : await runGitLsRemote(repo, ref);
+    return parseLsRemoteCommit(output, ref);
+}
+function buildUnknownSourceError(input, catalog) {
+    const suggestions = suggestCatalogPackageIds(catalog, input);
+    const suffix = suggestions.length > 0 ? ` Did you mean ${suggestions.join(", ")}?` : "";
+    return new Error(`Unknown store package or source: ${input}.${suffix}`);
+}
+export async function resolveStoreSource(options) {
+    const input = options.input.trim();
+    if (!input) {
+        throw new Error("Missing store source.");
+    }
+    const catalogPackage = findCatalogPackage(options.catalog, input);
+    const baseSource = catalogPackage?.source ?? input;
+    const baseKind = catalogPackage ? "catalog" : "local";
+    const warnings = [];
+    const track = options.track ?? false;
+    const npmInfo = parseNpmSource(baseSource);
+    if (npmInfo) {
+        if (options.ref) {
+            throw new Error("--ref is only valid for git store sources");
+        }
+        if (track) {
+            throw new Error("--track is only valid for git store sources");
+        }
+        if (!npmInfo.version) {
+            warnings.push(`npm package ${npmInfo.name} is not pinned to an exact version.`);
+        }
+        else if (!npmInfo.exactVersion) {
+            warnings.push(`npm package ${npmInfo.name} uses non-exact version spec "${npmInfo.version}".`);
+        }
+        const pinned = npmInfo.exactVersion;
+        return {
+            input,
+            source: baseSource,
+            kind: catalogPackage ? "catalog" : "npm",
+            ...(catalogPackage ? { catalogPackage } : {}),
+            pinned,
+            tracking: !pinned,
+            warnings,
+        };
+    }
+    let gitSource = parseGitUrl(baseSource);
+    if (gitSource) {
+        if (options.ref) {
+            gitSource = withGitRef(gitSource, options.ref);
+        }
+        if (!gitSource.ref) {
+            if (track || options.pinGit === false) {
+                warnings.push("Git source has no ref and will track the repository default branch if installed.");
+                return {
+                    input,
+                    source: formatGitSource(gitSource),
+                    kind: catalogPackage ? "catalog" : "git",
+                    ...(catalogPackage ? { catalogPackage } : {}),
+                    pinned: false,
+                    tracking: true,
+                    warnings,
+                };
+            }
+            const commit = await resolveGitCommit(gitSource.repo, "HEAD", options.gitLsRemote);
+            return {
+                input,
+                source: formatGitSource(gitSource, commit),
+                kind: catalogPackage ? "catalog" : "git",
+                ...(catalogPackage ? { catalogPackage } : {}),
+                pinned: true,
+                tracking: false,
+                warnings,
+            };
+        }
+        if (!isCommitRef(gitSource.ref)) {
+            warnings.push(`Git ref "${gitSource.ref}" can be moved by repository owners; commits are more reproducible.`);
+        }
+        return {
+            input,
+            source: options.ref ? formatGitSource(gitSource, gitSource.ref) : baseSource,
+            kind: catalogPackage ? "catalog" : "git",
+            ...(catalogPackage ? { catalogPackage } : {}),
+            pinned: !track,
+            tracking: track,
+            warnings,
+        };
+    }
+    if (!catalogPackage && !isStoreLocalPathInput(input)) {
+        throw buildUnknownSourceError(input, options.catalog);
+    }
+    if (options.ref) {
+        throw new Error("--ref is only valid for git store sources");
+    }
+    if (track) {
+        throw new Error("--track is only valid for git store sources");
+    }
+    if (catalogPackage && !isLocalPath(baseSource)) {
+        throw new Error(`Catalog package ${catalogPackage.id} has an unsupported source: ${baseSource}`);
+    }
+    warnings.push("Local package paths are not reproducible and should not appear in public catalogs.");
+    return {
+        input,
+        source: baseSource,
+        kind: catalogPackage ? baseKind : "local",
+        ...(catalogPackage ? { catalogPackage } : {}),
+        pinned: false,
+        tracking: false,
+        warnings,
+    };
+}
+//# sourceMappingURL=resolver.js.map