@telorun/cli 0.41.0 → 0.43.0

package/dist/commands/module.js

@@ -0,0 +1,331 @@
+import { splitIntegrity } from "@telorun/analyzer";
+import { defaultTransportRegistry } from "@telorun/kernel";
+import { defaultCustomTags } from "@telorun/templating";
+import * as fs from "fs";
+import * as path from "path";
+import semver from "semver";
+import { parseAllDocuments } from "yaml";
+import { createLogger } from "../logger.js";
+import { findModuleDoc } from "./manifest-imports.js";
+const DEFAULT_REGISTRY_URL = "https://registry.telo.run";
+const errMsg = (err) => (err instanceof Error ? err.message : String(err));
+function resolveRegistryUrl(explicit) {
+    return explicit ?? process.env.TELO_REGISTRY_URL ?? DEFAULT_REGISTRY_URL;
+}
+/** Normalize a ref for version enumeration. The version segment is irrelevant to
+ *  `listVersions` (only the `<ns>/<name>` path or OCI repo is used), but the
+ *  registry transport only owns refs that carry an `@version` — so a bare
+ *  `std/console` gets a placeholder version, mirroring `telo upgrade`. Scheme
+ *  refs (`oci://`) and already-versioned refs pass through. */
+function refForEnumeration(ref) {
+    const base = splitIntegrity(ref).base;
+    if (base.includes("://") || base.includes("@"))
+        return base;
+    return `${base}@0.0.0`;
+}
+/** Newest-first: valid SemVer sorted by precedence, then any non-SemVer tags
+ *  (digests, `latest`, …) appended in lexical order so output stays stable. */
+function sortVersionsDesc(versions) {
+    const valid = [];
+    const other = [];
+    for (const v of versions)
+        (semver.valid(v) ? valid : other).push(v);
+    valid.sort(semver.rcompare);
+    other.sort();
+    return [...valid, ...other];
+}
+/** If `ref` addresses a module on the local filesystem — path-like (`.`/`/`) or
+ *  resolving to an existing file/dir — return the `telo.yaml` path to read;
+ *  otherwise `null` (the ref is remote, dispatch through a transport). A
+ *  directory resolves to `<dir>/telo.yaml`, mirroring `telo run` / `check`. */
+function localManifestPath(ref) {
+    const base = splitIntegrity(ref).base;
+    if (base.includes("://"))
+        return null;
+    const pathLike = base.startsWith(".") || base.startsWith("/");
+    const resolved = path.resolve(process.cwd(), base);
+    let stat;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch {
+        // Path-like but missing: still treat as local so we report a clear read
+        // error rather than "no transport". A bare `ns/name` that isn't on disk is
+        // a registry ref — leave it to the transport.
+        return pathLike ? resolved : null;
+    }
+    return stat.isDirectory() ? path.join(resolved, "telo.yaml") : resolved;
+}
+/** The `metadata.version` declared by the module doc in `text`, or `null` when
+ *  no `Telo.Application` / `Telo.Library` doc carries one. */
+function declaredVersion(text) {
+    const docs = parseAllDocuments(text, { customTags: defaultCustomTags() });
+    const version = findModuleDoc(docs)?.getIn(["metadata", "version"]);
+    return typeof version === "string" ? version : null;
+}
+function readFileOrExit(filePath, log) {
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        console.error(`${log.error("error")}  cannot read ${path.relative(process.cwd(), filePath)}: ${errMsg(err)}`);
+        process.exit(1);
+    }
+}
+function versionOrExit(text, label, log) {
+    const version = declaredVersion(text);
+    if (!version) {
+        console.error(`${log.error("error")}  ${label} declares no metadata.version`);
+        process.exit(1);
+    }
+    return version;
+}
+function emitVersions(versions, json, log) {
+    if (json) {
+        console.log(JSON.stringify(versions));
+        return;
+    }
+    if (versions.length === 0) {
+        console.error(log.dim("no published versions"));
+        return;
+    }
+    for (const v of versions)
+        console.log(v);
+}
+/** Read a single remote manifest (a direct URL, or any transport-owned ref) and
+ *  return its verified bytes. `source.read` checks the inline `#sha256-...` hash
+ *  when the ref is pinned — a mismatch throws, never a silent fallback. */
+async function readRemoteManifest(registry, ref, log) {
+    const transport = registry.forRef(ref);
+    if (!transport) {
+        const base = splitIntegrity(ref).base;
+        console.error(`${log.error("error")}  cannot resolve '${ref}' — registry refs need a version (e.g. '${base}@<version>')`);
+        process.exit(1);
+    }
+    try {
+        return (await transport.source.read(ref)).text;
+    }
+    catch (err) {
+        console.error(`${log.error("error")}  ${errMsg(err)}`);
+        process.exit(1);
+    }
+}
+async function runVersions(argv) {
+    const log = createLogger(false);
+    // 1. Local module — one version, the one it declares on disk.
+    const localPath = localManifestPath(argv.ref);
+    if (localPath) {
+        const text = readFileOrExit(localPath, log);
+        emitVersions([versionOrExit(text, path.relative(process.cwd(), localPath), log)], argv.json, log);
+        return;
+    }
+    const registry = defaultTransportRegistry(resolveRegistryUrl(argv.registryUrl));
+    const base = splitIntegrity(argv.ref).base;
+    // 2. Direct URL — a single manifest at a fixed location, no version list.
+    if (base.startsWith("http://") || base.startsWith("https://")) {
+        const text = await readRemoteManifest(registry, argv.ref, log);
+        emitVersions([versionOrExit(text, argv.ref, log)], argv.json, log);
+        return;
+    }
+    // 3. Enumerable — a registry `ns/name` or `oci://host/repo` ref.
+    const enumRef = refForEnumeration(argv.ref);
+    if (!registry.forRef(enumRef)) {
+        console.error(`${log.error("error")}  no transport handles '${argv.ref}'`);
+        process.exit(1);
+    }
+    let versions;
+    try {
+        versions = await registry.listVersions(enumRef);
+    }
+    catch (err) {
+        console.error(`${log.error("error")}  ${errMsg(err)}`);
+        process.exit(1);
+    }
+    if (versions === null) {
+        console.error(`${log.error("error")}  module not found: ${argv.ref}`);
+        process.exit(1);
+    }
+    emitVersions(sortVersionsDesc(versions), argv.json, log);
+}
+/** Resolve `ref` to a single manifest's text — local file, direct URL, or any
+ *  transport-owned ref — shared by `manifest` / `resources` / `kinds`. */
+async function loadManifestText(ref, registryUrl, log) {
+    const localPath = localManifestPath(ref);
+    return localPath
+        ? readFileOrExit(localPath, log)
+        : readRemoteManifest(defaultTransportRegistry(resolveRegistryUrl(registryUrl)), ref, log);
+}
+function parseDocs(text) {
+    return parseAllDocuments(text, { customTags: defaultCustomTags() });
+}
+async function runManifest(argv) {
+    const log = createLogger(false);
+    const text = await loadManifestText(argv.ref, argv.registryUrl, log);
+    process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+}
+/** Every declared resource instance: each non-module, non-definition doc. */
+function extractResources(docs) {
+    const out = [];
+    for (const doc of docs) {
+        const kind = doc.get("kind");
+        // A resource instance is any doc that isn't a framework doc. Every framework
+        // doc kind is namespaced under `Telo.` (Application, Library, Definition,
+        // Abstract, Import, …), while an instance is `<ImportAlias>.<Kind>` — so this
+        // stays correct as new `Telo.*` doc kinds land, with no list to maintain.
+        if (typeof kind !== "string" || kind.startsWith("Telo."))
+            continue;
+        const name = doc.getIn(["metadata", "name"]);
+        out.push({ kind, name: typeof name === "string" ? name : "" });
+    }
+    return out;
+}
+/** PascalCase a kebab module name into a suggested import alias (`http-server` →
+ *  `HttpServer`). Only a hint — the consumer picks any PascalCase alias. */
+function pascalCase(name) {
+    return name
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join("");
+}
+/** The resource kinds a module defines: each `Telo.Definition` / `Telo.Abstract`
+ *  as its suffix, owning module, capability, export status, and description. A
+ *  plain inspector — how a downstream consumer (e.g. the discovery hub) composes
+ *  these facts into an embedding passage is that consumer's own concern. */
+function extractKinds(docs) {
+    const moduleDoc = findModuleDoc(docs);
+    const moduleName = moduleDoc?.getIn(["metadata", "name"]);
+    const prefix = typeof moduleName === "string" ? moduleName : "";
+    const rawExports = moduleDoc?.getIn(["exports", "kinds"]);
+    const exportList = Array.isArray(rawExports)
+        ? rawExports
+        : rawExports && typeof rawExports.toJSON === "function"
+            ? rawExports.toJSON()
+            : [];
+    const exported = new Set(exportList.filter((v) => typeof v === "string"));
+    const out = [];
+    for (const doc of docs) {
+        const kind = doc.get("kind");
+        if (kind !== "Telo.Definition" && kind !== "Telo.Abstract")
+            continue;
+        const name = doc.getIn(["metadata", "name"]);
+        if (typeof name !== "string")
+            continue;
+        const capability = doc.get("capability");
+        const descRaw = doc.getIn(["metadata", "description"]);
+        out.push({
+            name,
+            module: prefix,
+            capability: typeof capability === "string" ? capability : "",
+            abstract: kind === "Telo.Abstract",
+            exported: exported.has(name),
+            description: typeof descRaw === "string" ? descRaw.trim() : undefined,
+        });
+    }
+    return out;
+}
+async function runResources(argv) {
+    const log = createLogger(false);
+    const resources = extractResources(parseDocs(await loadManifestText(argv.ref, argv.registryUrl, log)));
+    if (argv.json) {
+        console.log(JSON.stringify(resources));
+        return;
+    }
+    if (resources.length === 0) {
+        console.error(log.dim("no resources declared"));
+        return;
+    }
+    for (const r of resources)
+        console.log(`${r.kind}${r.name ? `  ${log.dim(r.name)}` : ""}`);
+}
+async function runKinds(argv) {
+    const log = createLogger(false);
+    const kinds = extractKinds(parseDocs(await loadManifestText(argv.ref, argv.registryUrl, log)));
+    if (argv.json) {
+        console.log(JSON.stringify(kinds));
+        return;
+    }
+    if (kinds.length === 0) {
+        console.error(log.dim("no kinds defined"));
+        return;
+    }
+    // The prefix in a `kind:` field is the consumer's import alias, not the module
+    // name — surface a concrete usage hint so the bare suffixes below aren't misread.
+    const alias = pascalCase(kinds[0].module) || "Alias";
+    console.error(log.dim(`import as e.g. ${alias}: ${argv.ref} — then write ${alias}.<Kind>`));
+    for (const k of kinds) {
+        const cap = k.abstract ? "abstract" : k.capability;
+        const badge = k.exported ? log.ok(" (exported)") : "";
+        console.log(`${k.name}  ${log.dim(cap)}${badge}`);
+        if (k.description)
+            console.log(`    ${log.dim(k.description.split("\n")[0])}`);
+    }
+}
+export function moduleCommand(yargs) {
+    return yargs.command("module <subcommand>", "Inspect modules across transports (local path, registry, OCI, direct URL)", (y) => y
+        .command("versions <ref>", "List a module's versions, newest first (one entry for a local path or direct URL)", (yy) => yy
+        .positional("ref", {
+        describe: "Module ref: ./path, std/console, oci://host/repo, or an https URL",
+        type: "string",
+        demandOption: true,
+    })
+        .option("registry-url", {
+        type: "string",
+        describe: "Base URL for the telo module registry. Overrides TELO_REGISTRY_URL.",
+    })
+        .option("json", {
+        type: "boolean",
+        default: false,
+        describe: "Emit the versions as a JSON array",
+    }), async (argv) => {
+        await runVersions(argv);
+    })
+        .command("manifest <ref>", "Print a module's telo.yaml (verified against the inline hash when pinned)", (yy) => yy
+        .positional("ref", {
+        describe: "Module ref: ./path, std/console@0.9.0, oci://host/repo@1.2.0, or an https URL",
+        type: "string",
+        demandOption: true,
+    })
+        .option("registry-url", {
+        type: "string",
+        describe: "Base URL for the telo module registry. Overrides TELO_REGISTRY_URL.",
+    }), async (argv) => {
+        await runManifest(argv);
+    })
+        .command("resources <ref>", "List the resource instances declared in a module's manifest", (yy) => yy
+        .positional("ref", {
+        describe: "Module ref: ./path, std/console@0.9.0, oci://host/repo@1.2.0, or an https URL",
+        type: "string",
+        demandOption: true,
+    })
+        .option("registry-url", {
+        type: "string",
+        describe: "Base URL for the telo module registry. Overrides TELO_REGISTRY_URL.",
+    })
+        .option("json", {
+        type: "boolean",
+        default: false,
+        describe: "Emit the resources as a JSON array",
+    }), async (argv) => {
+        await runResources(argv);
+    })
+        .command("kinds <ref>", "List the resource kinds a module defines (name, capability, exported)", (yy) => yy
+        .positional("ref", {
+        describe: "Module ref: ./path, std/console@0.9.0, oci://host/repo@1.2.0, or an https URL",
+        type: "string",
+        demandOption: true,
+    })
+        .option("registry-url", {
+        type: "string",
+        describe: "Base URL for the telo module registry. Overrides TELO_REGISTRY_URL.",
+    })
+        .option("json", {
+        type: "boolean",
+        default: false,
+        describe: "Emit the kinds as a JSON array",
+    }), async (argv) => {
+        await runKinds(argv);
+    })
+        .demandCommand(1, "Specify a module subcommand (versions | manifest | resources | kinds)"), () => { });
+}
+//# sourceMappingURL=module.js.map

package/dist/commands/module.js.map

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

package/dist/commands/publish.d.ts

@@ -1,17 +1,27 @@
 import { Loader } from "@telorun/analyzer";
 import { LocalFileSource } from "@telorun/kernel";
 import type { Argv } from "yargs";
+import { type Logger } from "../logger.js";
 import type { BumpLevel } from "../publishers/interface.js";
 export declare function expandAndInlineIncludes(content: string, manifestDir: string): string;
 /** Read the first doc's `files:` glob patterns (empty when none declared). */
 export declare function readFilesPatterns(content: string): string[];
-export declare function canonicalizeRelativeImports(content: string, manifestPath: string, loader: Loader, localFileSource: LocalFileSource): Promise<string>;
+export declare function canonicalizeRelativeImports(content: string, manifestPath: string, destination: string, loader: Loader, localFileSource: LocalFileSource): Promise<{
+    content: string;
+    refs: string[];
+}>;
+export declare function pinImports(content: string, registry: string, frozen: boolean, log: Logger): Promise<{
+    content: string;
+    pinned: number;
+    unresolved: string[];
+}>;
 export declare function publish(argv: {
     paths: string[];
     registry: string;
     bump?: BumpLevel;
     dryRun: boolean;
     skipControllers: boolean;
+    frozen: boolean;
 }): Promise<void>;
 export declare function publishCommand(yargs: Argv): Argv;
 //# sourceMappingURL=publish.d.ts.map

package/dist/commands/publish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAsD,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAIlC,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,4BAA4B,CAAC;AA8F9E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAyDpF;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3D;AAWD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,MAAM,CAAC,CAoCjB;AA6VD,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAqChD"}
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAsE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EAAE,eAAe,EAA4B,MAAM,iBAAiB,CAAC;AAI5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAA2C,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,4BAA4B,CAAC;AA8F9E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAyDpF;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3D;AAaD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4C9C;AAaD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoCpE;AAuUD,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuChB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CA4ChD"}