@procedures/mark 0.0.0-stage → 0.2.0

package/dist/client-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-mode.js","sourceRoot":"","sources":["../src/client-mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAUzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAc,EACd,KAAc,EACd,MAAgC;IAEhC,0FAA0F;IAC1F,2FAA2F;IAC3F,6FAA6F;IAC7F,0FAA0F;IAC1F,qFAAqF;IACrF,2FAA2F;IAC3F,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IACjF,8EAA8E;IAC9E,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAgE,CAAC;IACrE,IAAI,MAA8C,CAAC;IACnD,IAAI,CAAC;QACH,wBAAwB;QACxB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACxD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,YAAY,CAAC;QAE/C,oBAAoB;QACpB,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC;YAClC,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,cAAc,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,CAAC,KAAK,EAAE,EAAE;SAC9D,CAAC,CAAC;QACH,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAEnC,6FAA6F;QAC7F,gGAAgG;QAChG,gCAAgC;QAChC,MAAM,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sFAAsF;IACtF,sFAAsF;IACtF,IAAI,CAAC;QACH,yFAAyF;QACzF,oBAAoB;QACpB,IAAI,IAAoC,CAAC;QACzC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACvB,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,KAAK;YAClB,OAAO,EAAE,MAAM,KAAK,SAAS;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ecosystem.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Workspace-based Procedure Discovery
+ *
+ * Dynamically discovers and loads procedures from the packages of the
+ * monorepo this CLI lives in. This enables the CLI to automatically find
+ * all available procedures without hardcoding imports.
+ *
+ * Discovery flow:
+ * 1. Walk up from this module to the folder that holds pnpm-workspace.yaml
+ * 2. For each packages/* folder, read its package.json
+ * 3. If it has client.procedures, dynamically import it
+ * 4. The register.js entry of each package registers its procedures in PROCEDURE_REGISTRY
+ */
+import { type ProcedureRegistry } from "@procedures/client";
+interface DiscoveredPackage {
+    name: string;
+    path: string;
+    proceduresPath: string;
+    /** The file of the side-effect-free `./module` entry, when the package has one (roadmap 3.1) */
+    modulePath?: string | undefined;
+}
+/**
+ * Find the workspace root: the nearest folder above this module that holds pnpm-workspace.yaml
+ */
+export declare function findWorkspaceRoot(): string | null;
+/**
+ * Discover workspace packages that declare client.procedures
+ */
+export declare function discoverFromEcosystem(root?: string | null): DiscoveredPackage[];
+/**
+ * This function registers all core procedures of `@procedures/client` in the global registry: the
+ * control flow and `procedure.*` of `clientModule`, and the math, string, array, object, comparison
+ * and type procedures (`client.add` and the others). An import registers none of them
+ * (ARCHITECTURE-PROPOSALS-2026-10, P9). (Docs review DOC-6: before, `mark client add` was an
+ * unknown command.) A procedure that is registered already stays.
+ */
+export declare function registerCoreProcedures(): number;
+/**
+ * Dynamically load procedures from discovered packages.
+ *
+ * A package that fails to load gives one warning line on stderr, also without `verbose`: before,
+ * its commands were missing with no message (deep dive CLI-18). A package that is not built yet
+ * (no procedures file) is reported only with `verbose`. `warn: false` turns the warnings off (the
+ * build of mark writes the manifest while other packages can still be in their build).
+ */
+export declare function loadEcosystemProcedures(verbose?: boolean, warn?: boolean): Promise<string[]>;
+/**
+ * Get list of ecosystem packages that have procedures
+ */
+export declare function listEcosystemProcedurePackages(): Array<{
+    name: string;
+    path: string;
+}>;
+/** The registry of `mark` and the names of the packages that it holds. */
+export interface EcosystemRegistry {
+    registry: ProcedureRegistry;
+    loaded: string[];
+}
+/**
+ * The registry of `mark` (roadmap 3.1): a registry of its own, built from the module of each
+ * workspace package that declares `client.procedures`, with all the core procedures. The global
+ * registry does not change for a package with a module entry. A package that fails to load gives
+ * one warning line on stderr, as with `loadEcosystemProcedures()`.
+ */
+export declare function loadEcosystemRegistry(verbose?: boolean, warn?: boolean): Promise<EcosystemRegistry>;
+export {};
+//# sourceMappingURL=ecosystem.d.ts.map

package/dist/ecosystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem.d.ts","sourceRoot":"","sources":["../src/ecosystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAc5B,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AA6BD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAYjD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,MAAM,GAAG,IAA0B,GAAG,iBAAiB,EAAE,CA4BpG;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAS/C;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,UAAQ,EAAE,IAAI,UAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuC7F;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAKtF;AAKD,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAsBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,UAAQ,EAAE,IAAI,UAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoBpG"}

package/dist/ecosystem.js

@@ -0,0 +1,212 @@
+/**
+ * Workspace-based Procedure Discovery
+ *
+ * Dynamically discovers and loads procedures from the packages of the
+ * monorepo this CLI lives in. This enables the CLI to automatically find
+ * all available procedures without hardcoding imports.
+ *
+ * Discovery flow:
+ * 1. Walk up from this module to the folder that holds pnpm-workspace.yaml
+ * 2. For each packages/* folder, read its package.json
+ * 3. If it has client.procedures, dynamically import it
+ * 4. The register.js entry of each package registers its procedures in PROCEDURE_REGISTRY
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { PROCEDURE_REGISTRY, allCoreProcedures, clientModule, createRegistry, defineModule, pathToKey, registerModules, } from "@procedures/client";
+/** The file of the `./module` export of a package, relative to the package folder. */
+function moduleEntryOf(packageJson) {
+    const entry = packageJson.exports?.["./module"];
+    if (typeof entry === "string")
+        return entry;
+    if (entry && typeof entry === "object") {
+        const target = entry.import ?? entry.default;
+        return typeof target === "string" ? target : undefined;
+    }
+    return undefined;
+}
+// =============================================================================
+// Discovery
+// =============================================================================
+/**
+ * Read and parse JSON file
+ */
+function readJson(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the workspace root: the nearest folder above this module that holds pnpm-workspace.yaml
+ */
+export function findWorkspaceRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        if (fs.existsSync(path.join(dir, "pnpm-workspace.yaml"))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+/**
+ * Discover workspace packages that declare client.procedures
+ */
+export function discoverFromEcosystem(root = findWorkspaceRoot()) {
+    const discovered = [];
+    if (!root) {
+        // Not running from inside the monorepo, nothing to discover
+        return discovered;
+    }
+    const packagesDir = path.join(root, "packages");
+    const entries = fs.readdirSync(packagesDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const packageDir = path.join(packagesDir, entry.name);
+        const packageJson = readJson(path.join(packageDir, "package.json"));
+        if (packageJson?.client?.procedures) {
+            discovered.push({
+                name: packageJson.name,
+                path: packageDir,
+                proceduresPath: packageJson.client.procedures,
+                modulePath: moduleEntryOf(packageJson),
+            });
+        }
+    }
+    return discovered;
+}
+/**
+ * This function registers all core procedures of `@procedures/client` in the global registry: the
+ * control flow and `procedure.*` of `clientModule`, and the math, string, array, object, comparison
+ * and type procedures (`client.add` and the others). An import registers none of them
+ * (ARCHITECTURE-PROPOSALS-2026-10, P9). (Docs review DOC-6: before, `mark client add` was an
+ * unknown command.) A procedure that is registered already stays.
+ */
+export function registerCoreProcedures() {
+    let added = 0;
+    for (const procedure of [...clientModule.procedures, ...allCoreProcedures]) {
+        if (!PROCEDURE_REGISTRY.has(procedure.path)) {
+            PROCEDURE_REGISTRY.register(procedure);
+            added++;
+        }
+    }
+    return added;
+}
+/**
+ * Dynamically load procedures from discovered packages.
+ *
+ * A package that fails to load gives one warning line on stderr, also without `verbose`: before,
+ * its commands were missing with no message (deep dive CLI-18). A package that is not built yet
+ * (no procedures file) is reported only with `verbose`. `warn: false` turns the warnings off (the
+ * build of mark writes the manifest while other packages can still be in their build).
+ */
+export async function loadEcosystemProcedures(verbose = false, warn = true) {
+    registerCoreProcedures();
+    const discovered = discoverFromEcosystem();
+    const loaded = [];
+    for (const pkg of discovered) {
+        // Build the full path to the procedures file
+        const proceduresFullPath = path.join(pkg.path, pkg.proceduresPath);
+        // Check if file exists
+        if (!fs.existsSync(proceduresFullPath)) {
+            if (verbose) {
+                console.warn(`Procedures file not found (build the package): ${proceduresFullPath}`);
+            }
+            continue;
+        }
+        try {
+            // Dynamic import - the module will self-register procedures. pathToFileURL escapes
+            // "#", "%" and spaces in the path (before, a string join broke such paths).
+            await import(pathToFileURL(proceduresFullPath).href);
+            loaded.push(pkg.name);
+            if (verbose) {
+                console.log(`Loaded procedures from: ${pkg.name}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message.split("\n")[0] : String(error);
+            if (warn) {
+                console.warn(`mark: the procedures of ${pkg.name} did not load: ${message}`);
+            }
+            if (verbose && error instanceof Error && error.stack) {
+                console.warn(error.stack);
+            }
+        }
+    }
+    return loaded;
+}
+/**
+ * Get list of ecosystem packages that have procedures
+ */
+export function listEcosystemProcedurePackages() {
+    return discoverFromEcosystem().map((pkg) => ({
+        name: pkg.name,
+        path: pkg.path,
+    }));
+}
+/** The core procedures that `mark` serves: all of them, also the ones that the core import does not register. */
+const allCoreModule = defineModule("@procedures/client (all core procedures)", allCoreProcedures);
+/**
+ * The module of a package: its `./module` entry (it registers nothing), or else the procedures
+ * that importing its procedures file adds to the global registry (a package of the old kind).
+ */
+async function moduleOfPackage(pkg) {
+    if (pkg.modulePath) {
+        const file = path.join(pkg.path, pkg.modulePath);
+        if (fs.existsSync(file)) {
+            const exports = (await import(pathToFileURL(file).href));
+            if (exports.default && Array.isArray(exports.default.procedures))
+                return exports.default;
+        }
+    }
+    const proceduresFile = path.join(pkg.path, pkg.proceduresPath);
+    if (!fs.existsSync(proceduresFile))
+        return undefined;
+    const before = new Set(PROCEDURE_REGISTRY.getAll().map((procedure) => pathToKey(procedure.path)));
+    await import(pathToFileURL(proceduresFile).href);
+    const added = PROCEDURE_REGISTRY.getAll().filter((procedure) => !before.has(pathToKey(procedure.path)));
+    return { name: pkg.name, procedures: added };
+}
+/**
+ * The registry of `mark` (roadmap 3.1): a registry of its own, built from the module of each
+ * workspace package that declares `client.procedures`, with all the core procedures. The global
+ * registry does not change for a package with a module entry. A package that fails to load gives
+ * one warning line on stderr, as with `loadEcosystemProcedures()`.
+ */
+export async function loadEcosystemRegistry(verbose = false, warn = true) {
+    const registry = createRegistry(allCoreModule);
+    const loaded = [];
+    for (const pkg of discoverFromEcosystem()) {
+        try {
+            const module = await moduleOfPackage(pkg);
+            if (!module) {
+                if (verbose)
+                    console.warn(`Procedures file not found (build the package): ${path.join(pkg.path, pkg.proceduresPath)}`);
+                continue;
+            }
+            registerModules(registry, [module]);
+            loaded.push(pkg.name);
+            if (verbose)
+                console.log(`Loaded procedures from: ${pkg.name}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message.split("\n")[0] : String(error);
+            if (warn)
+                console.warn(`mark: the procedures of ${pkg.name} did not load: ${message}`);
+            if (verbose && error instanceof Error && error.stack)
+                console.warn(error.stack);
+        }
+    }
+    return { registry, loaded };
+}
+//# sourceMappingURL=ecosystem.js.map

package/dist/ecosystem.js.map

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

package/dist/failure.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Procedure-level failure
+ *
+ * A procedure reports a failure in one of three ways, and `mark` exits with code 1 for each:
+ *
+ * 1. It throws an error. This is the usual way.
+ * 2. It returns an object with `success: false`. Use this when the result has more to show,
+ *    for example the list of problems of `lib audit`.
+ * 3. It returns an object with a numeric `exitCode` that is not 0. Use this for a procedure that
+ *    runs an external command (`vitest run`, `shell run`), so the caller sees the command's result.
+ *
+ * For a streaming procedure, each item is examined: one failed item makes the command fail.
+ */
+/** A short description of the failure that a result reports, or undefined when it reports none */
+export declare function failureOf(result: unknown): string | undefined;
+//# sourceMappingURL=failure.d.ts.map

package/dist/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAa7D"}

package/dist/failure.js

@@ -0,0 +1,47 @@
+/**
+ * Procedure-level failure
+ *
+ * A procedure reports a failure in one of three ways, and `mark` exits with code 1 for each:
+ *
+ * 1. It throws an error. This is the usual way.
+ * 2. It returns an object with `success: false`. Use this when the result has more to show,
+ *    for example the list of problems of `lib audit`.
+ * 3. It returns an object with a numeric `exitCode` that is not 0. Use this for a procedure that
+ *    runs an external command (`vitest run`, `shell run`), so the caller sees the command's result.
+ *
+ * For a streaming procedure, each item is examined: one failed item makes the command fail.
+ */
+/** A short description of the failure that a result reports, or undefined when it reports none */
+export function failureOf(result) {
+    if (!result || typeof result !== "object" || Array.isArray(result)) {
+        return undefined;
+    }
+    const record = result;
+    const exitCode = record["exitCode"];
+    if (typeof exitCode === "number" && exitCode !== 0) {
+        return `exit code ${exitCode}`;
+    }
+    if (record["success"] === false) {
+        return firstText(record["error"]) ?? firstText(record["errors"]) ?? firstText(record["message"]) ?? "success: false";
+    }
+    return undefined;
+}
+/** The first text of a value: a string, the message of an error object, or the first of a list */
+function firstText(value) {
+    if (typeof value === "string" && value.length > 0) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const text = firstText(item);
+            if (text)
+                return text;
+        }
+        return undefined;
+    }
+    if (value && typeof value === "object" && typeof value.message === "string") {
+        return value.message;
+    }
+    return undefined;
+}
+//# sourceMappingURL=failure.js.map

package/dist/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,kGAAkG;AAClG,MAAM,UAAU,SAAS,CAAC,MAAe;IACvC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,aAAa,QAAQ,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,gBAAgB,CAAC;IACvH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kGAAkG;AAClG,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;QACxB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvG,OAAQ,KAA6B,CAAC,OAAO,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Output Formatting
+ *
+ * Formats procedure results for CLI output based on metadata hints.
+ */
+export type OutputFormat = "text" | "json" | "table" | "streaming";
+/**
+ * Print interface (used by formatOutput)
+ */
+export interface Print {
+    info: (message: string) => void;
+    error: (message: string) => void;
+    success: (message: string) => void;
+    warning: (message: string) => void;
+    table: (data: string[][], options?: {
+        format?: string;
+    }) => void;
+    spin: (message: string) => Spinner;
+}
+export interface Spinner {
+    stop: () => void;
+    succeed: (message?: string) => void;
+    fail: (message?: string) => void;
+    text: string;
+}
+/**
+ * Format and print the result based on output format hint
+ */
+export declare function formatOutput(print: Print, result: unknown, format?: OutputFormat): void;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,EACf,MAAM,GAAE,YAAqB,GAC5B,IAAI,CAoBN"}

package/dist/format.js

@@ -0,0 +1,125 @@
+/**
+ * Output Formatting
+ *
+ * Formats procedure results for CLI output based on metadata hints.
+ */
+/**
+ * Format and print the result based on output format hint
+ */
+export function formatOutput(print, result, format = "text") {
+    if (result === undefined || result === null) {
+        return;
+    }
+    switch (format) {
+        case "json":
+            print.info(JSON.stringify(result, null, 2));
+            break;
+        case "table":
+            formatTable(print, result);
+            break;
+        case "text":
+        case "streaming":
+        default:
+            formatText(print, result);
+            break;
+    }
+}
+/**
+ * Format as text - handles common result shapes
+ */
+function formatText(print, result) {
+    // String output
+    if (typeof result === "string") {
+        print.info(result);
+        return;
+    }
+    // Result with output field (common pattern)
+    if (isObjectWithOutput(result)) {
+        print.info(result.output);
+        return;
+    }
+    // Result with message field
+    if (isObjectWithMessage(result)) {
+        if (result.success === false) {
+            print.error(result.message);
+        }
+        else {
+            print.success(result.message);
+        }
+        return;
+    }
+    // Result with error field
+    if (isObjectWithError(result)) {
+        print.error(result.error);
+        return;
+    }
+    // Array of items
+    if (Array.isArray(result)) {
+        for (const item of result) {
+            formatText(print, item);
+        }
+        return;
+    }
+    // Fallback to JSON
+    print.info(JSON.stringify(result, null, 2));
+}
+/**
+ * Format as table - handles arrays of objects
+ */
+function formatTable(print, result) {
+    // Result with rows/headers
+    if (isTableResult(result)) {
+        const headers = result.headers ?? Object.keys(result.rows[0] ?? {});
+        const data = [headers];
+        for (const row of result.rows) {
+            if (Array.isArray(row)) {
+                data.push(row.map(String));
+            }
+            else if (typeof row === "object" && row !== null) {
+                data.push(headers.map((h) => String(row[h] ?? "")));
+            }
+        }
+        print.table(data);
+        return;
+    }
+    // Plain array of objects
+    if (Array.isArray(result) && result.length > 0 && typeof result[0] === "object") {
+        const headers = Object.keys(result[0]);
+        const data = [headers];
+        for (const row of result) {
+            if (typeof row === "object" && row !== null) {
+                data.push(headers.map((h) => String(row[h] ?? "")));
+            }
+        }
+        print.table(data);
+        return;
+    }
+    // Fallback to text
+    formatText(print, result);
+}
+// Type guards
+function isObjectWithOutput(val) {
+    return (typeof val === "object" &&
+        val !== null &&
+        "output" in val &&
+        typeof val.output === "string");
+}
+function isObjectWithMessage(val) {
+    return (typeof val === "object" &&
+        val !== null &&
+        "message" in val &&
+        typeof val.message === "string");
+}
+function isObjectWithError(val) {
+    return (typeof val === "object" &&
+        val !== null &&
+        "error" in val &&
+        typeof val.error === "string");
+}
+function isTableResult(val) {
+    return (typeof val === "object" &&
+        val !== null &&
+        "rows" in val &&
+        Array.isArray(val.rows));
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mark CLI
+ *
+ * A generic CLI that reflects registered procedures from client packages.
+ * Importing this module runs nothing: the `mark` bin (`dist/bin.js`) runs the CLI.
+ */
+export { run, main, executeArgs, initCli, type CliContext } from "./cli.js";
+export { parseCommandLine, parseLeadingGlobals, type ParsedCommandLine, type Globals } from "./args.js";
+export { failureOf } from "./failure.js";
+export { parseFromSchema, generateHelp, extractSchemaFields, convertValue, type CLIMeta, type FieldType, type SchemaFieldInfo, } from "./parse.js";
+export { formatOutput, type OutputFormat } from "./format.js";
+export { readLockfile, writeLockfile, removeLockfile, isServerAlive, getLockfilePath, getLockfileDir, getLogPath, rotateLogFile, type LockfileData, } from "./lockfile.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,aAAa,EACb,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Mark CLI
+ *
+ * A generic CLI that reflects registered procedures from client packages.
+ * Importing this module runs nothing: the `mark` bin (`dist/bin.js`) runs the CLI.
+ */
+export { run, main, executeArgs, initCli } from "./cli.js";
+export { parseCommandLine, parseLeadingGlobals } from "./args.js";
+export { failureOf } from "./failure.js";
+export { parseFromSchema, generateHelp, extractSchemaFields, convertValue, } from "./parse.js";
+export { formatOutput } from "./format.js";
+export { readLockfile, writeLockfile, removeLockfile, isServerAlive, getLockfilePath, getLockfileDir, getLogPath, rotateLogFile, } from "./lockfile.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAmB,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAwC,MAAM,WAAW,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,GAIb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,aAAa,GAEd,MAAM,eAAe,CAAC"}

package/dist/lockfile.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lockfiles of the CLI server: `mark` uses the shared module of `client-server`, so `mark` and the
+ * `server.*` procedures read and write the same files the same way (deep dive CLI-4). This module
+ * adds what only `mark` needs: the log file and the build id.
+ */
+import { checkServer, findServer, readAllLockfiles, readLockfileForPort, removeLockfileForPort, type LockfileData } from "@procedures/peer/lockfile";
+export type { LockfileData };
+export { checkServer, findServer, readAllLockfiles, readLockfileForPort, removeLockfileForPort };
+/**
+ * The build of this `mark`: its file and the time of its last build. A warm server runs only the
+ * commands of the same build (deep dive CLI-14): after `pnpm build`, or from another checkout,
+ * the CLI runs the command itself.
+ */
+export declare function currentBuild(): string;
+export declare function writeLockfile(data: LockfileData): Promise<void>;
+/** The first lockfile whose server answers as its peer (any folder, any build). */
+export declare function readLockfile(): Promise<LockfileData | null>;
+/** True when the lockfile's server answers as its peer. A dead server's lockfile is removed. */
+export declare function isServerAlive(lockfile: LockfileData): Promise<boolean>;
+/** This function removes the lockfile of the default port (3000). */
+export declare function removeLockfile(): Promise<void>;
+export declare function getLockfileDir(): string;
+export declare function getLockfilePath(): string;
+export declare function getLogPath(): string;
+export declare function rotateLogFile(): Promise<void>;
+//# sourceMappingURL=lockfile.d.ts.map

package/dist/lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../src/lockfile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,WAAW,EACX,UAAU,EAGV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EAErB,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,CAAC;AAKjG;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAOrC;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAED,mFAAmF;AACnF,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAKjE;AAED,gGAAgG;AAChG,wBAAsB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5E;AAED,qEAAqE;AACrE,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAOnD"}