ioc-manifest 4.0.0 → 4.0.2

package/README.md

@@ -59,6 +59,32 @@ Full documentation lives at **[reharik.github.io/ioc-manifest](https://reharik.g
 - **[Quick start](https://reharik.github.io/ioc-manifest/guide/quick-start)** — units → config → generate → bootstrap, in a few minutes.
 - **[Adopting on an existing codebase](https://reharik.github.io/ioc-manifest/guide/adopting)** — why the first run is red, and how to read it.
 
+## Working on ioc-manifest
+
+The test suite runs in two lanes.
+
+```bash
+npm run test:fast   # ~6s, 568 tests — everything that builds no TypeScript program
+npm test            # the whole suite; what CI runs
+```
+
+**Iterate on `test:fast`; run the full suite before you report anything.** `test:fast` is the
+non-`*.integration.test.ts` glob, and what earns a file the `.integration` suffix is mechanism, not
+taste: a test that builds a TypeScript program, spawns a subprocess, or runs codegen belongs in the
+slow lane, because every one of those costs seconds. `src/test-support/testLaneSeam.test.ts`
+enforces that in both directions — it fails on a fast-lane file that can reach any of the three, and
+on an `.integration` file that can reach none of them — so the suffix cannot quietly stop being
+true. When it fails, the fix is a rename, and the message says which way.
+
+The rest of the checks:
+
+```bash
+npm run typecheck   # tsc --noEmit
+npm run build       # dist/
+npm run gen:manifest && git diff --exit-code src/generated   # generated-diff must be zero
+npm run example:full                                          # the multi-package example, end to end
+```
+
 ## Contributing to the docs
 
 The docs are a [VitePress](https://vitepress.dev/) site under `docs/`.

package/dist/cli/ioc.js

@@ -1,301 +1,14 @@
 #!/usr/bin/env node
 /**
- * @fileoverview `ioc` CLI: generates and inspects Awilix manifests.
+ * @fileoverview The `ioc` executable: argv in, exit code out.
  *
- * - `ioc generate` — runs the full generation pipeline (discover, plan, emit).
- * - `ioc inspect` — human-readable contract / implementation summary + manifest validation. Reads
- *   the generated manifest by PARSING it (see `loadManifestForInspection`), never by importing it:
- *   the CLI runs under plain `node`, which cannot import a `.ts` file at all.
- * - `ioc inspect --discovery` — re-runs source discovery (no manifest read) for drift analysis.
- * - `ioc explain <key>` — one cradle key: what it resolves to, its lifetime and the chain that
- *   decided it, what it depends on, and who depends on it. Same two modes as `inspect`.
- * - `ioc validate` — app mode only: cross-manifest composition checks without writing files (CI gate).
+ * Everything the CLI actually does is in `runIocCli.ts`. This file is the process boundary and
+ * nothing else — it is what `bin/ioc.cjs` spawns, and what the tests that care about the process
+ * contract spawn too.
  *
- * Resolves config like generation (`tryLoadIocConfig`, optional `--config`), walking up from cwd
- * (or `--project`) to find `ioc.config.ts` in a monorepo.
+ * `process.exitCode` rather than `process.exit`: the latter would truncate any output still queued
+ * on a pipe, which is exactly the situation the `--json` surfaces are used in.
  */
-import path from "node:path";
-import { parseIocCliArgv } from "./parseIocCli.js";
-import { formatCommandMap, formatVerbHelp } from "./commandMap.js";
-import { generateManifest } from "../generator/generateManifest.js";
-import { resolveIocConfigPath, resolveProjectRootFromIocConfigPath, tryLoadIocConfig, } from "../config/loadIocConfig.js";
-import { buildDiscoveryReport, buildInspectionReport, filterDiscoveryReportByContract, filterInspectionReportByContract, formatDiscoveryReport, formatDiscoveryReportJson, formatInspectionReport, formatInspectionReportJson, readPriorGroupMembers, } from "../inspection/index.js";
-import { loadManifestForInspection, tryLoadManifestForInspection, } from "../inspection/loadManifestForInspection.js";
-import { resolveDiscoveryManifestContext, runDiscoveryAnalysis, } from "../inspection/runDiscoveryAnalysis.js";
-import { explainFromDiscovery, explainFromManifest, } from "../inspection/explain.js";
-import { buildExplainComposedView, } from "../inspection/explainComposedView.js";
-import { loadCompositionContext } from "../composition/compositionContext.js";
-import { assessFreshness } from "../composition/freshnessPass.js";
-import { isAppMode } from "../config/iocMode.js";
-import { formatExplainReport, formatExplainReportJson, } from "../inspection/formatExplain.js";
-import { printValidateResult, runValidate, } from "../validate/runValidate.js";
-import { formatCaughtErrorForTerminal } from "../diagnostics/colorizeDiagnostic.js";
-import { formatStalenessBanner, readGenerationRecord, readGenerationState, } from "../diagnostics/generationState.js";
-import { currentInputsForConfigPath } from "../diagnostics/currentInputsHash.js";
-import { formatFreshnessAdvisory, formatFreshnessBanner, isStale, isUnknown, judgeFreshness, } from "../diagnostics/freshness.js";
-import { LOCAL_PACKAGE_IDENTIFIER } from "../config/packageIdentifier.js";
-/**
- * The composed picture `ioc explain` answers over, in app mode.
- *
- * The SAME loader the composition suite builds its picture from — `loadCompositionContext` — so an
- * explanation and a `ioc validate` finding about the same key cannot be built on different readings
- * of the same manifests. Library mode gets `undefined` and the local answer it has always had.
- *
- * Degradation is a note, never a failure. `explain` is a view: an app whose composed package cannot
- * be resolved still deserves an answer about its own keys, and saying which half of the picture is
- * missing is strictly better than refusing the question. The same stance every other part of
- * inspection takes about an unreadable composed package.
- *
- * The freshness pass runs for the COMPOSED packages only. The local package is already bannered by
- * {@link bannerIfNotFresh} in manifest mode and is read from source in discovery mode, so judging it
- * again here would print the same warning twice.
- */
-const loadExplainComposedView = async (cfgPath, knownConfig, json) => {
-    const config = knownConfig ?? (await tryLoadIocConfig(cfgPath));
-    if (config === undefined || !isAppMode(config)) {
-        return undefined;
-    }
-    const projectRoot = resolveProjectRootFromIocConfigPath(cfgPath);
-    const loaded = await loadCompositionContext({
-        projectRoot,
-        configPath: cfgPath,
-        config,
-    });
-    if (!loaded.ok) {
-        if (!json) {
-            console.error(`note: the composed picture could not be read (${loaded.message}) — this answer covers this package only.`);
-            console.error("");
-        }
-        return undefined;
-    }
-    const freshness = await assessFreshness({
-        projectRoot,
-        configPath: cfgPath,
-        config,
-        slices: loaded.context.slices,
-        includeLocal: false,
-    });
-    return buildExplainComposedView({ context: loaded.context, freshness });
-};
-const formatResolvedScanDir = (e) => {
-    if (e.scope !== undefined) {
-        return `${e.absPath} [scope=${e.scope}]`;
-    }
-    return e.absPath;
-};
-/**
- * Prints the staleness banner ahead of an artifact-derived report, and returns the marker.
- *
- * On stderr, deliberately: the report itself goes to stdout and is routinely piped into a file or
- * another tool. A caveat that vanished into that pipe would be a caveat nobody reads, and one that
- * rode along inside the payload would corrupt it. stderr is where `logInspectContext` already puts
- * the same kind of framing.
- *
- * `--json` gets the marker as data instead, so nothing is printed here.
- */
-const bannerIfStale = (generatedDir, json) => {
-    const marker = readGenerationState(generatedDir);
-    if (marker !== undefined && !json) {
-        console.error(formatStalenessBanner(marker));
-        console.error("");
-    }
-    return marker;
-};
-/**
- * Prints the freshness banner for THIS package ahead of a manifest-derived report.
- *
- * Banner only, and local only. `inspect` and `explain` describe one package's artifacts; there is
- * no composed picture here to attribute a per-finding caveat to, and nothing in their reports is a
- * "finding" in the sense the composition suite means. What a reader needs is the one fact that
- * changes how to read everything below: the manifest being summarised may predate the sources.
- *
- * Manifest mode only. `--discovery` re-reads the source, so its answer is current by construction
- * and a freshness caveat on it would be about a document it is not showing.
- *
- * Nothing is added to `--json`: these documents carry `staleness` because a failed generation is a
- * fact about the artifacts they are reporting. Freshness here is advisory-only by ruling, and the
- * verb that publishes it as data is `ioc validate`.
- */
-const bannerIfNotFresh = async (generatedDir, cfgPath, json) => {
-    if (json) {
-        return;
-    }
-    const current = await currentInputsForConfigPath(cfgPath);
-    const freshness = judgeFreshness({
-        name: LOCAL_PACKAGE_IDENTIFIER,
-        sourceId: LOCAL_PACKAGE_IDENTIFIER,
-        record: readGenerationRecord(generatedDir),
-        currentHash: current.hash,
-        ...(current.unknown !== undefined ? { currentUnknown: current.unknown } : {}),
-    });
-    if (isStale(freshness)) {
-        console.error(formatFreshnessBanner(freshness));
-        console.error("");
-    }
-    else if (isUnknown(freshness)) {
-        console.error(formatFreshnessAdvisory(freshness));
-        console.error("");
-    }
-};
-/** Adds the `staleness` field to a JSON report document, when there is one. Never renames. */
-const withStalenessField = (json, marker) => {
-    if (marker === undefined) {
-        return json;
-    }
-    const parsed = JSON.parse(json);
-    return JSON.stringify({ ...parsed, staleness: marker }, null, 2);
-};
-const logInspectContext = (cfgPath, scanDirs) => {
-    console.error(`[ioc inspect] resolved config: ${cfgPath}`);
-    console.error(`[ioc inspect] resolved discovery scanDirs: ${scanDirs.map(formatResolvedScanDir).join("; ")}`);
-};
-const main = async () => {
-    const parsed = parseIocCliArgv(process.argv);
-    if (parsed.kind === "help") {
-        // `--json` is not a thing a help screen has; what a pipe gets is the same text without escapes,
-        // which `formatCommandMap` handles through the shared TTY/NO_COLOR check.
-        console.log(parsed.verb === undefined
-            ? formatCommandMap()
-            : formatVerbHelp(parsed.verb));
-        return;
-    }
-    if (parsed.kind === "generate") {
-        const cli = parsed.options;
-        await generateManifest({
-            iocConfigPath: cli.iocConfigPath,
-            paths: cli.projectDir !== undefined
-                ? { projectRoot: path.resolve(cli.projectDir) }
-                : undefined,
-        });
-        return;
-    }
-    if (parsed.kind === "validate") {
-        /**
-         * `validate` is separate from `generate` so dev codegen can tolerate transient sibling drift;
-         * validate is the pre-merge / pre-deploy gate that reports every composition issue at once.
-         * Run after `ioc generate`. Does not modify any files.
-         */
-        const cli = parsed.options;
-        const searchStart = path.resolve(cli.projectDir ?? process.cwd());
-        const cfgPath = resolveIocConfigPath(searchStart, cli.iocConfigPath);
-        const config = await tryLoadIocConfig(cfgPath);
-        if (config === undefined) {
-            throw new Error(`No ioc config found at ${cfgPath}. Pass --config or run from a project with ioc.config.ts.`);
-        }
-        const projectRoot = resolveProjectRootFromIocConfigPath(cfgPath);
-        const result = await runValidate({
-            projectRoot,
-            configPath: cfgPath,
-            config,
-            json: cli.json,
-        });
-        const code = printValidateResult(result, cli.json);
-        if (code !== 0) {
-            process.exitCode = code;
-        }
-        return;
-    }
-    if (parsed.kind === "explain") {
-        const cli = parsed.options;
-        const searchStart = path.resolve(cli.projectDir ?? process.cwd());
-        // Two modes, the same two sources `inspect` uses: the manifest on disk, or a fresh scan. The
-        // scan is the only one that can say WHY a lifetime is what it is; the report says so itself
-        // rather than leaving a reader to wonder why the chain is missing.
-        let staleness;
-        let report;
-        if (cli.discovery) {
-            const resolved = await resolveDiscoveryManifestContext({
-                iocConfigPath: cli.iocConfigPath,
-                searchStartDir: searchStart,
-            });
-            const analysis = await runDiscoveryAnalysis({ reuseResolution: resolved });
-            // Discovery mode reads SOURCE, so its own answer is never stale — but a reader who reaches
-            // for `--discovery` after a failing generation is reconciling two worlds, and saying that the
-            // artifacts beside it are stale is the whole point of the banner.
-            staleness = bannerIfStale(analysis.generatedDir, cli.json);
-            report = explainFromDiscovery(cli.key, analysis, await loadExplainComposedView(resolved.cfgPath, resolved.config, cli.json));
-        }
-        else {
-            const manifest = await loadManifestForInspection(cli.iocConfigPath, searchStart);
-            staleness = bannerIfStale(manifest.generatedDir, cli.json);
-            await bannerIfNotFresh(manifest.generatedDir, manifest.cfgPath, cli.json);
-            report = explainFromManifest(cli.key, manifest, await loadExplainComposedView(manifest.cfgPath, undefined, cli.json));
-        }
-        console.log(cli.json
-            ? withStalenessField(formatExplainReportJson(report), staleness)
-            : formatExplainReport(report));
-        // An unknown key is a failed question, not a healthy report — CI and shell scripts need to see
-        // that in the exit code.
-        if (report.resolution.kind === "unknown") {
-            process.exitCode = 1;
-        }
-        return;
-    }
-    const cli = parsed.options;
-    const searchStart = path.resolve(cli.projectDir ?? process.cwd());
-    if (cli.discovery) {
-        const resolved = await resolveDiscoveryManifestContext({
-            iocConfigPath: cli.iocConfigPath,
-            searchStartDir: searchStart,
-        });
-        logInspectContext(resolved.cfgPath, resolved.options.paths.scanDirs);
-        const staleness = bannerIfStale(resolved.options.paths.generatedDir, cli.json);
-        const analysis = await runDiscoveryAnalysis({
-            reuseResolution: resolved,
-        });
-        // The manifest is read here and nowhere deeper: `runDiscoveryAnalysis` answers "what does the
-        // source say", and must keep answering it without a generated file in sight. What the manifest
-        // adds is the BEFORE side — which contracts were group members last generation — and a report
-        // that cannot find one simply loses that one signal.
-        const prior = await tryLoadManifestForInspection(cli.iocConfigPath, searchStart);
-        const full = buildDiscoveryReport({
-            ...analysis,
-            ...(prior !== undefined
-                ? { priorGroupMembers: readPriorGroupMembers(prior.groups) }
-                : {}),
-        });
-        const report = cli.contract !== undefined
-            ? filterDiscoveryReportByContract(full, cli.contract)
-            : full;
-        console.log(cli.json
-            ? withStalenessField(formatDiscoveryReportJson(report), staleness)
-            : formatDiscoveryReport(report, { verbose: cli.verbose }));
-        return;
-    }
-    const manifest = await loadManifestForInspection(cli.iocConfigPath, searchStart);
-    logInspectContext(manifest.cfgPath, manifest.scanDirs);
-    const staleness = bannerIfStale(manifest.generatedDir, cli.json);
-    await bannerIfNotFresh(manifest.generatedDir, manifest.cfgPath, cli.json);
-    const full = buildInspectionReport(manifest.contracts, {
-        groups: manifest.groups,
-        scopeRoots: manifest.scopeRoots,
-    });
-    const report = cli.contract !== undefined
-        ? filterInspectionReportByContract(full, cli.contract)
-        : full;
-    console.log(cli.json
-        ? withStalenessField(formatInspectionReportJson(report), staleness)
-        : formatInspectionReport(report, { verbose: cli.verbose }));
-};
-/**
- * The one place a thrown diagnostic becomes terminal output.
- *
- * Generation is this tool's primary error surface — the demand model, the group law, scope-root
- * verification and the whole composition suite all reach a developer as a thrown `Error.message` —
- * so this is where those messages get their colour. It is applied HERE and nowhere upstream because
- * `Error.message` itself must stay escape-free: it is serialized, matched and re-wrapped by things
- * that are not terminals (see `diagnostics/colorizeDiagnostic.ts`).
- *
- * `IOC_DEBUG=1` prints the error object whole, stack included, and is left exactly as it was — it
- * exists to show the raw thing, and tinting it would defeat that.
- */
-main().catch((error) => {
-    if (process.env.IOC_DEBUG === "1") {
-        console.error(error);
-    }
-    else {
-        console.error(formatCaughtErrorForTerminal(error));
-    }
-    process.exit(1);
-});
+import { runIocCli } from "./runIocCli.js";
+process.exitCode = await runIocCli(process.argv);
 //# sourceMappingURL=ioc.js.map

package/dist/cli/ioc.js.map

@@ -1 +1 @@
-{"version":3,"file":"ioc.js","sourceRoot":"","sources":["../../src/cli/ioc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ioc.js","sourceRoot":"","sources":["../../src/cli/ioc.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,CAAC,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli/runIocCli.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The whole CLI, including the one place a thrown diagnostic becomes terminal output.
+ *
+ * Generation is this tool's primary error surface — the demand model, the group law, scope-root
+ * verification and the whole composition suite all reach a developer as a thrown `Error.message` —
+ * so this is where those messages get their colour. It is applied HERE and nowhere upstream because
+ * `Error.message` itself must stay escape-free: it is serialized, matched and re-wrapped by things
+ * that are not terminals (see `diagnostics/colorizeDiagnostic.ts`).
+ *
+ * `IOC_DEBUG=1` prints the error object whole, stack included, and is left exactly as it was — it
+ * exists to show the raw thing, and tinting it would defeat that.
+ *
+ * The catch lives inside the exported function rather than around its call, so the error surface is
+ * part of what "running the CLI" means for every caller — a test that asks for an unknown verb gets
+ * the same message and the same 1 that a shell does.
+ */
+export declare const runIocCli: (argv: readonly string[]) => Promise<number>;
+//# sourceMappingURL=runIocCli.d.ts.map

package/dist/cli/runIocCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runIocCli.d.ts","sourceRoot":"","sources":["../../src/cli/runIocCli.ts"],"names":[],"mappings":"AAqZA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,GAAU,MAAM,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAWvE,CAAC"}