@nekostack/cli 1.0.0

package/dist/formatters/pretty.js

@@ -0,0 +1,229 @@
+/**
+ * Terminal-readable formatters for the four `neko schema *` verbs
+ * plus the two cross-cutting result kinds (load failures and Issues).
+ * v0.7 Step 28.
+ *
+ * Each function returns a `string` ending in exactly one trailing
+ * newline — same shape as `formatJson` (Step 27), so command modules
+ * can write either through the same `stdout`/`stderr` writer without
+ * remembering to add `\n`.
+ *
+ * Pure utility. No `console.*`, no `process.*`, no `fs.*`. Static-
+ * scan asserted by [`../../tests/formatters/pretty.test.ts`](../../tests/formatters/pretty.test.ts).
+ *
+ * Color is NOT applied here. CLI plan §"Explicit non-scope" defers
+ * richer color to a later phase; v0.7 ships plain ANSI-free output
+ * that respects `NO_COLOR` by default (i.e., never emits codes).
+ *
+ * Output stability — pretty output is **not** a contract across
+ * versions (the locked promise is `--json`, see [`./json.ts`](./json.ts)).
+ * These functions still aim for a deterministic shape so snapshot
+ * tests can compare against known strings; downstream consumers
+ * should consume `--json` rather than parsing pretty output.
+ *
+ * Pure: takes data in, returns a string. Inputs are never mutated;
+ * sorted/iterated lazily and the caller's arrays are preserved.
+ */
+// =============================================================================
+// `neko schema list`
+// =============================================================================
+/**
+ * Render a registry-listing as a fixed-width table. Format matches
+ * the example in the CLI companion plan:
+ *
+ *     3 schemas in workspace:
+ *       com.nekostack.tenant.Tenant      1.0.0          path/to/tenant.schema.ts
+ *       com.nekostack.audit.AuditEvent   1.0.0          path/to/audit-event.schema.ts
+ *
+ * Empty input produces a single human-readable line. Versions are
+ * displayed as `(unversioned)` when the entry's `schemaVersion` is
+ * `undefined`. Entries are NOT re-sorted here — `listHandler`
+ * already returns them in deterministic schemaId-ascending order.
+ */
+export function formatListPretty(entries) {
+    if (entries.length === 0)
+        return "No schemas found in workspace.\n";
+    const header = `${pluralize(entries.length, "schema", "schemas")} in workspace:`;
+    const rows = entries.map((e) => ({
+        id: e.schemaId,
+        version: e.schemaVersion ?? "(unversioned)",
+        path: e.sourcePath,
+    }));
+    const idWidth = maxWidth(rows.map((r) => r.id));
+    const versionWidth = maxWidth(rows.map((r) => r.version));
+    const lines = rows.map((r) => `  ${r.id.padEnd(idWidth)}   ${r.version.padEnd(versionWidth)}   ${r.path}`);
+    return [header, ...lines].join("\n") + "\n";
+}
+// =============================================================================
+// `neko schema migrate list`
+// =============================================================================
+/**
+ * Render a migration-listing as a fixed-width table. Same shape as
+ * `formatListPretty` but with `(schemaId, fromVersion → toVersion,
+ * sourcePath)` columns. Entries are NOT re-sorted —
+ * `listMigrationsHandler` already returns them in
+ * `(schemaId, fromVersion, toVersion)` ascending order.
+ *
+ * The `migration` field on `MigrationEntry` (the loaded `AnyMigration`)
+ * is deliberately NOT rendered: it carries a closure `transform` that
+ * the v0.8 boundary forbids touching here, and the pretty output is
+ * for human review of the registry shape only.
+ */
+export function formatMigrationListPretty(entries) {
+    if (entries.length === 0)
+        return "No migrations found in workspace.\n";
+    const header = `${pluralize(entries.length, "migration", "migrations")} in workspace:`;
+    const rows = entries.map((e) => ({
+        id: e.schemaId,
+        versions: `${e.fromVersion} → ${e.toVersion}`,
+        path: e.sourcePath,
+    }));
+    const idWidth = maxWidth(rows.map((r) => r.id));
+    const versionsWidth = maxWidth(rows.map((r) => r.versions));
+    const lines = rows.map((r) => `  ${r.id.padEnd(idWidth)}   ${r.versions.padEnd(versionsWidth)}   ${r.path}`);
+    return [header, ...lines].join("\n") + "\n";
+}
+// =============================================================================
+// `neko schema diff`
+// =============================================================================
+/**
+ * Render a `DiffResult.data` payload (the unwrapped success branch).
+ * Header carries the count + `worstSeverity`; rows list each change
+ * as `[severity] kind at path — message`.
+ *
+ * Empty change list prints `No changes.` with the worst-severity
+ * sentinel `null`. Non-empty lists print the count and severity in
+ * a uniform header so machine post-processing (e.g., a CI script
+ * grepping the pretty output, even though `--json` is the contract)
+ * has a stable single-line summary at the top.
+ */
+export function formatDiffPretty(payload) {
+    if (payload.changes.length === 0)
+        return "No changes.\n";
+    const header = `${pluralize(payload.changes.length, "change", "changes")} (worst severity: ${payload.worstSeverity}):`;
+    const lines = payload.changes.map((c) => formatDiffChange(c));
+    return [header, ...lines].join("\n") + "\n";
+}
+function formatDiffChange(c) {
+    const pathText = formatIssuePath(c.path);
+    const where = pathText === "" ? "(root)" : pathText;
+    return `  [${c.severity}] ${c.kind} at ${where} — ${c.message}`;
+}
+// =============================================================================
+// `neko schema check`
+// =============================================================================
+/**
+ * Render a list of freshness verdicts (`CheckResult.data.verdicts`).
+ * Header is a per-status tally:
+ *
+ *     4 artifacts: 2 clean, 1 cosmetic_drift, 1 stale
+ *
+ * Body lists each verdict as `[status] artifactPath` in input order
+ * (the schema-side handler emits in the order the CLI handed it the
+ * artifacts, which is already deterministic — see Step 24).
+ *
+ * Empty input prints a single human-readable line; the CLI dispatch
+ * layer is responsible for deciding what an empty `check` exits as.
+ */
+export function formatCheckPretty(verdicts) {
+    if (verdicts.length === 0)
+        return "No artifacts to check.\n";
+    const counts = {
+        clean: 0,
+        cosmetic_drift: 0,
+        stale: 0,
+        integrity_error: 0,
+    };
+    for (const v of verdicts)
+        counts[v.status] += 1;
+    const tally = [
+        ["clean", counts.clean],
+        ["cosmetic_drift", counts.cosmetic_drift],
+        ["stale", counts.stale],
+        ["integrity_error", counts.integrity_error],
+    ]
+        .filter(([, n]) => n > 0)
+        .map(([k, n]) => `${n} ${k}`)
+        .join(", ");
+    const header = `${pluralize(verdicts.length, "artifact", "artifacts")}: ${tally}`;
+    const lines = verdicts.map((v) => `  [${v.status}] ${v.artifactPath}`);
+    return [header, ...lines].join("\n") + "\n";
+}
+// =============================================================================
+// `neko schema generate`
+// =============================================================================
+/**
+ * Render the list of `GeneratedArtifact`s `generateHandler` returned.
+ * The CLI dispatch layer is what actually writes each artifact's
+ * `content` to its `suggestedPath`; this formatter only summarizes
+ * the plan for the user's terminal.
+ *
+ *     Generated 12 artifacts (3 schemas × 4 kinds):
+ *       com.x.Tenant     typescript    schemas/generated/tenant.types.ts
+ *       com.x.Tenant     zod           schemas/generated/tenant.zod.ts
+ *       …
+ *
+ * Empty input prints a single human-readable line. Artifacts are
+ * NOT re-sorted — `generateHandler` already emits them in
+ * deterministic schemaId-then-kind order.
+ */
+export function formatGeneratePretty(artifacts) {
+    if (artifacts.length === 0)
+        return "No artifacts generated.\n";
+    const schemaIds = new Set(artifacts.map((a) => a.schemaId));
+    const header = `Generated ${pluralize(artifacts.length, "artifact", "artifacts")} (${pluralize(schemaIds.size, "schema", "schemas")} × ${Math.round(artifacts.length / Math.max(schemaIds.size, 1))} kinds):`;
+    const idWidth = maxWidth(artifacts.map((a) => a.schemaId));
+    const kindWidth = maxWidth(artifacts.map((a) => a.kind));
+    const lines = artifacts.map((a) => `  ${a.schemaId.padEnd(idWidth)}   ${a.kind.padEnd(kindWidth)}   ${a.suggestedPath}`);
+    return [header, ...lines].join("\n") + "\n";
+}
+export function formatLoadFailuresPretty(failures, opts = {}) {
+    if (failures.length === 0)
+        return "No load failures.\n";
+    const noun = opts.noun ?? { singular: "schema file", plural: "schema files" };
+    const header = `${pluralize(failures.length, `${noun.singular} failed`, `${noun.plural} failed`)} to load:`;
+    const lines = failures.map((f) => `  [${f.reason}] ${f.path} — ${f.message}`);
+    return [header, ...lines].join("\n") + "\n";
+}
+// =============================================================================
+// Schema-side `Issue[]` rendering
+// =============================================================================
+/**
+ * Render a list of `Issue`s — used when a schema-side handler returns
+ * `Result.failure` and the CLI needs a human-readable digest.
+ * Severity prefixes the message; `error` is the only severity v0.7
+ * emits, but the formatter handles the full vocabulary for
+ * forward compatibility.
+ */
+export function formatIssuesPretty(issues) {
+    if (issues.length === 0)
+        return "No issues.\n";
+    const header = `${pluralize(issues.length, "issue", "issues")}:`;
+    const lines = issues.map((i) => {
+        const where = formatIssuePath(i.path);
+        const pathPart = where === "" ? "" : ` at ${where}`;
+        return `  [${i.severity}] ${i.code}${pathPart} — ${i.message}`;
+    });
+    return [header, ...lines].join("\n") + "\n";
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function pluralize(n, singular, plural) {
+    return `${n} ${n === 1 ? singular : plural}`;
+}
+function maxWidth(values) {
+    let max = 0;
+    for (const v of values) {
+        if (v.length > max)
+            max = v.length;
+    }
+    return max;
+}
+function formatIssuePath(path) {
+    return path
+        .map((segment) => typeof segment === "number" ? `[${segment}]` : segment)
+        .join(".")
+        .replace(/\.\[/g, "[");
+}
+//# sourceMappingURL=pretty.js.map

package/dist/formatters/pretty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty.js","sourceRoot":"","sources":["../../src/formatters/pretty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAaH,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiC;IAEjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kCAAkC,CAAC;IAEpE,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,gBAAgB,CAAC;IACjF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,EAAE,EAAE,CAAC,CAAC,QAAQ;QACd,OAAO,EAAE,CAAC,CAAC,aAAa,IAAI,eAAe;QAC3C,IAAI,EAAE,CAAC,CAAC,UAAU;KACnB,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAC9E,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAkC;IAElC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,qCAAqC,CAAC;IAEvE,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,gBAAgB,CAAC;IACvF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,EAAE,EAAE,CAAC,CAAC,QAAQ;QACd,QAAQ,EAAE,GAAG,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,SAAS,EAAE;QAC7C,IAAI,EAAE,CAAC,CAAC,UAAU;KACnB,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAChF,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAGC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC;IAEzD,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,qBAAqB,OAAO,CAAC,aAAa,IAAI,CAAC;IACvH,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAa;IACrC,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpD,OAAO,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AAClE,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAqC;IAErC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,0BAA0B,CAAC;IAE7D,MAAM,MAAM,GAA+C;QACzD,KAAK,EAAE,CAAC;QACR,cAAc,EAAE,CAAC;QACjB,KAAK,EAAE,CAAC;QACR,eAAe,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhD,MAAM,KAAK,GACT;QACE,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC;QACzC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC,iBAAiB,EAAE,MAAM,CAAC,eAAe,CAAC;KAE9C;SACE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,KAAK,KAAK,EAAE,CAAC;IAClF,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAuC;IAEvC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,2BAA2B,CAAC;IAE/D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,aAAa,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAE9M,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CACvF,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AA2BD,MAAM,UAAU,wBAAwB,CACtC,QAAgC,EAChC,OAA+B,EAAE;IAEjC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC;IAExD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC9E,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,SAAS,CAAC,WAAW,CAAC;IAC5G,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAClD,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAE/C,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,GAAG,QAAQ,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC9C,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,SAAS,SAAS,CAAC,CAAS,EAAE,QAAgB,EAAE,MAAc;IAC5D,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,MAAyB;IACzC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;YAAE,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,IAAkC;IACzD,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CACvD;SACA,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# 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,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/loaders/read-artifacts.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `loadCommittedArtifacts(generatedDir)` — CLI-side committed-artifact
+ * reader for the `check` command (v0.7 Step 24).
+ *
+ * Walks `generatedDir` for the four locked NekoStack artifact-name
+ * suffixes (Master plan Decision #6) and reads each one's bytes as
+ * UTF-8 text. Returns one {@link CommittedArtifact} per file. The
+ * schema-side `checkHandler` then parses each artifact's provenance
+ * block and applies the two-hash freshness matrix; this loader only
+ * handles the filesystem read.
+ *
+ *   <generatedDir>/<basename>.types.ts          ← TS output
+ *   <generatedDir>/<basename>.zod.ts            ← Zod source
+ *   <generatedDir>/<basename>.json.schema.json  ← JSON Schema
+ *   <generatedDir>/<basename>.openapi.json      ← OpenAPI 3.1 component
+ *
+ * Multi-schema source files add a discriminator slug between the
+ * basename and the artifact suffix (e.g. `account.com-x-tenant.types.ts`).
+ * The glob patterns below match the full set without re-deriving the
+ * discriminator rule — any file whose name ends in one of the four
+ * suffixes is treated as a candidate artifact.
+ *
+ * Behavior:
+ *
+ *   - Default behavior reads every artifact under the dir, recursively.
+ *   - If the directory does not exist, returns `[]` — the schema-side
+ *     `checkHandler` treats "no artifacts" as a no-op verdict, which
+ *     is the right shape for a fresh workspace before its first
+ *     `neko schema generate` run.
+ *   - Per-artifact paths returned to the caller are
+ *     {@link generatedDir}-relative, forward-slash-normalized, for
+ *     stable display across platforms (same convention as the walker
+ *     in `walk-workspace.ts`).
+ *
+ * No `console.*`, no `process.exit`, no stdout/stderr writes — static-
+ * scan asserted by [`../../tests/loaders/read-artifacts.test.ts`](../../tests/loaders/read-artifacts.test.ts).
+ *
+ * This module does NOT:
+ *   - Parse artifact provenance (schema-side `parseProvenanceFromText`).
+ *   - Compute freshness verdicts (schema-side `checkHandler`).
+ *   - Write artifacts to disk (Step 32's `generate.ts` command).
+ *   - Decide exit codes (Step 25/26).
+ */
+import type { CommittedArtifact } from "@nekostack/schema/cli";
+export type { CommittedArtifact };
+/**
+ * Artifact-name suffixes matched by the locked v0.7 path convention.
+ * Exported so downstream code (Step 31's `check.ts` dispatch) can
+ * advertise the same list without re-deriving it. Listed in the same
+ * order as `GENERATOR_KINDS` on the schema side: `typescript`, `zod`,
+ * `jsonSchema`, `openApi`.
+ */
+export declare const ARTIFACT_SUFFIXES: readonly [".types.ts", ".zod.ts", ".json.schema.json", ".openapi.json"];
+export declare function loadCommittedArtifacts(generatedDir: string): Promise<readonly CommittedArtifact[]>;
+//# sourceMappingURL=read-artifacts.d.ts.map

package/dist/loaders/read-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-artifacts.d.ts","sourceRoot":"","sources":["../../src/loaders/read-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,yEAKpB,CAAC;AAIX,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CA4BvC"}

package/dist/loaders/read-artifacts.js

@@ -0,0 +1,99 @@
+/**
+ * `loadCommittedArtifacts(generatedDir)` — CLI-side committed-artifact
+ * reader for the `check` command (v0.7 Step 24).
+ *
+ * Walks `generatedDir` for the four locked NekoStack artifact-name
+ * suffixes (Master plan Decision #6) and reads each one's bytes as
+ * UTF-8 text. Returns one {@link CommittedArtifact} per file. The
+ * schema-side `checkHandler` then parses each artifact's provenance
+ * block and applies the two-hash freshness matrix; this loader only
+ * handles the filesystem read.
+ *
+ *   <generatedDir>/<basename>.types.ts          ← TS output
+ *   <generatedDir>/<basename>.zod.ts            ← Zod source
+ *   <generatedDir>/<basename>.json.schema.json  ← JSON Schema
+ *   <generatedDir>/<basename>.openapi.json      ← OpenAPI 3.1 component
+ *
+ * Multi-schema source files add a discriminator slug between the
+ * basename and the artifact suffix (e.g. `account.com-x-tenant.types.ts`).
+ * The glob patterns below match the full set without re-deriving the
+ * discriminator rule — any file whose name ends in one of the four
+ * suffixes is treated as a candidate artifact.
+ *
+ * Behavior:
+ *
+ *   - Default behavior reads every artifact under the dir, recursively.
+ *   - If the directory does not exist, returns `[]` — the schema-side
+ *     `checkHandler` treats "no artifacts" as a no-op verdict, which
+ *     is the right shape for a fresh workspace before its first
+ *     `neko schema generate` run.
+ *   - Per-artifact paths returned to the caller are
+ *     {@link generatedDir}-relative, forward-slash-normalized, for
+ *     stable display across platforms (same convention as the walker
+ *     in `walk-workspace.ts`).
+ *
+ * No `console.*`, no `process.exit`, no stdout/stderr writes — static-
+ * scan asserted by [`../../tests/loaders/read-artifacts.test.ts`](../../tests/loaders/read-artifacts.test.ts).
+ *
+ * This module does NOT:
+ *   - Parse artifact provenance (schema-side `parseProvenanceFromText`).
+ *   - Compute freshness verdicts (schema-side `checkHandler`).
+ *   - Write artifacts to disk (Step 32's `generate.ts` command).
+ *   - Decide exit codes (Step 25/26).
+ */
+import { readFile, stat } from "node:fs/promises";
+import { glob } from "node:fs/promises";
+import { isAbsolute, resolve, sep } from "node:path";
+/**
+ * Artifact-name suffixes matched by the locked v0.7 path convention.
+ * Exported so downstream code (Step 31's `check.ts` dispatch) can
+ * advertise the same list without re-deriving it. Listed in the same
+ * order as `GENERATOR_KINDS` on the schema side: `typescript`, `zod`,
+ * `jsonSchema`, `openApi`.
+ */
+export const ARTIFACT_SUFFIXES = [
+    ".types.ts",
+    ".zod.ts",
+    ".json.schema.json",
+    ".openapi.json",
+];
+const ARTIFACT_GLOB = `**/*{${ARTIFACT_SUFFIXES.join(",")}}`;
+export async function loadCommittedArtifacts(generatedDir) {
+    const dirAbs = isAbsolute(generatedDir)
+        ? generatedDir
+        : resolve(generatedDir);
+    // Missing-or-not-a-directory → no artifacts. The check verb's right
+    // shape on a fresh workspace is "no verdicts, no error" — let the
+    // schema-side handler decide whether that means clean or stale.
+    if (!(await isDirectory(dirAbs)))
+        return [];
+    const relativeRaw = [];
+    for await (const p of glob(ARTIFACT_GLOB, { cwd: dirAbs })) {
+        relativeRaw.push(p);
+    }
+    // Deterministic ordering — alphabetical on forward-slash-normalized
+    // relative paths. Same convention as `walk-workspace.ts`.
+    const relative = relativeRaw
+        .map((p) => p.split(sep).join("/"))
+        .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    const out = [];
+    for (const rel of relative) {
+        const abs = resolve(dirAbs, rel);
+        const content = await readFile(abs, "utf8");
+        out.push({ path: rel, content });
+    }
+    return out;
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+async function isDirectory(path) {
+    try {
+        const s = await stat(path);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=read-artifacts.js.map

package/dist/loaders/read-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-artifacts.js","sourceRoot":"","sources":["../../src/loaders/read-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAKrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,SAAS;IACT,mBAAmB;IACnB,eAAe;CACP,CAAC;AAEX,MAAM,aAAa,GAAG,QAAQ,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,YAAoB;IAEpB,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC;QACrC,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1B,oEAAoE;IACpE,kEAAkE;IAClE,gEAAgE;IAChE,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC3D,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,oEAAoE;IACpE,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,WAAW;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/loaders/read-migrations.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `readMigrations({ root, pattern? })` — CLI-side discovery + load of
+ * authored `*.migration.ts` files (v0.8 Step 19).
+ *
+ * The CLI is the only filesystem walker and the only place that
+ * dynamic-imports authored migration modules (Master plan Decision #1;
+ * v0.8 INVARIANTS — `no apply, no transform execution` stays in force).
+ * This function:
+ *
+ *   1. Glob-walks `pattern` (default `**​/*.migration.ts`) under
+ *      `root` using Node's built-in `fs/promises.glob` — same approach
+ *      as the v0.7 `walk-workspace.ts`.
+ *   2. Reads each match's UTF-8 source text verbatim.
+ *   3. Hands the absolute path to a dynamic `import()` routed through
+ *      the tsx ESM hook registered once by the sibling `tsx-loader.ts`
+ *      module (importing it for the `register()` side effect is
+ *      sufficient — no per-call `tsImport()`).
+ *   4. Validates the module's default export structurally as an
+ *      `AnyMigration` (`schemaId` / `from` / `to` strings + `transform`
+ *      function). Anything else → `no_migration_export` failure.
+ *   5. Pairs the load result with its `sourceText` and workspace-
+ *      relative, forward-slash-normalized `sourcePath` into one
+ *      `MigrationSourceEntry`.
+ *   6. Collects every per-file failure into a separate `failures`
+ *      array — never short-circuits.
+ *
+ * **Top-level evaluation nuance.** Authored migration files are
+ * TypeScript modules. tsx evaluates their top-level code at import
+ * time; this is the CLI side of the v0.8 boundary (the schema package
+ * never imports authored migration modules). A top-level throw
+ * classifies as `runtime_error` — the rest of the walk continues.
+ *
+ * **`transform` is NEVER invoked here.** This loader reads, imports,
+ * validates the export shape, and stops. A static-scan test asserts
+ * the source contains no `.transform(` call.
+ *
+ * No `console.*`, no `process.exit`, no stdout/stderr writes —
+ * static-scan asserted by [`../../tests/loaders/read-migrations.test.ts`](../../tests/loaders/read-migrations.test.ts).
+ *
+ * This module does NOT:
+ *   - Build a `MigrationRegistry` (that's `buildMigrationRegistry` on
+ *     the schema side).
+ *   - Parse the JSDoc provenance header (that's
+ *     `parseMigrationProvenanceFromText` on the schema side).
+ *   - Plan, verify, or stub migrations (Steps 21 / 22 / 23 commands).
+ *   - Format output (later steps).
+ *   - Decide exit codes (later steps).
+ */
+import type { MigrationSourceEntry } from "@nekostack/schema/cli";
+import { type LoadFailure } from "./tsx-loader.js";
+export type { MigrationSourceEntry, LoadFailure };
+export declare const DEFAULT_MIGRATION_PATTERN = "**/*.migration.ts";
+export interface ReadMigrationsOpts {
+    /** Workspace root. Must be passed explicitly; the loader does not
+     *  fall back to `process.cwd()`. Dispatch layer resolves `--root`
+     *  (or its default) and hands the absolute path in. */
+    readonly root: string;
+    /** Optional glob, **replaces** {@link DEFAULT_MIGRATION_PATTERN}. */
+    readonly pattern?: string;
+}
+export interface ReadMigrationsResult {
+    /** One entry per successfully loaded migration file, sorted by
+     *  `sourcePath`. */
+    readonly entries: readonly MigrationSourceEntry[];
+    /** Per-file failures collected across the walk; ordered the same
+     *  way as discovery. Empty array when every file loaded cleanly. */
+    readonly failures: readonly LoadFailure[];
+}
+export declare function readMigrations(opts: ReadMigrationsOpts): Promise<ReadMigrationsResult>;
+//# sourceMappingURL=read-migrations.d.ts.map

package/dist/loaders/read-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-migrations.d.ts","sourceRoot":"","sources":["../../src/loaders/read-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAOH,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMhF,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,CAAC;AAMlD,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC;;2DAEuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC;wBACoB;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD;wEACoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAMD,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA0F/B"}