@mmnto/totem 1.53.3 → 1.53.5

package/dist/parity-detect.test.js

@@ -0,0 +1,274 @@
+/**
+ * Tests for the version-pinned parity drift detector (PR-1,
+ * mmnto-ai/totem#2069 on top of skeleton #2070).
+ *
+ * The detector is pure + side-effect-free: every filesystem / git seam is
+ * injectable so these tests drive it against synthetic fixtures, NOT the live
+ * cohort. Each invariant from the spec's "Invariants to lock via tests" list
+ * gets a case: pass / warn / fail-under-blocking+strict (the fail-promotion is a
+ * CLI-edge concern — the detector itself only ever returns warn here) / skip on
+ * not-declared / skip on not-a-consumer / skip on floor-unresolved /
+ * no-throw-on-read-failure / never-networks / claim-class-bound (pin currency
+ * only, never content equality).
+ *
+ * Mirrors the temp-file + discriminated-union style of `parity-manifest.test.ts`
+ * and the injected-seam style of `strategy-resolver.test.ts`.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { deriveCohortRepoId, detectVersionPinnedContract, packageNameForContract, resolveCohortFloor, } from './parity-detect.js';
+import { cleanTmpDir } from './test-utils.js';
+let tmpRoot;
+beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-parity-detect-'));
+});
+afterEach(() => {
+    cleanTmpDir(tmpRoot);
+});
+// ─── Fixture builders ───────────────────────────────────
+/** Build a minimal version-pinned deps contract for one of the 4 PR-1 ids. */
+function depsContract(over = {}) {
+    return {
+        id: 'mmnto-totem-version',
+        dimension: 'dependency-cohort',
+        canonicalSource: 'mmnto-ai/totem',
+        detectionMethod: 'consumer package.json caret range + resolved install vs floor',
+        expectedValueOrDerivation: 'consumer pin resolves to the current published @mmnto/totem',
+        tractability: 'version-pinned',
+        trackingIssue: 'mmnto-ai/totem-strategy#482',
+        ...over,
+    };
+}
+/** Write a `packages/<dir>/package.json` with the given name + version. */
+function writePackage(rootDir, dir, name, version) {
+    const pkgDir = path.join(rootDir, 'packages', dir);
+    fs.mkdirSync(pkgDir, { recursive: true });
+    fs.writeFileSync(path.join(pkgDir, 'package.json'), JSON.stringify({ name, version }, null, 2), 'utf-8');
+}
+/**
+ * Write a self-in-tree totem monorepo at `rootDir` carrying `@mmnto/totem` at
+ * `version`, plus a marker package so the glob has more than one entry.
+ */
+function writeSelfInTree(rootDir, version) {
+    writePackage(rootDir, 'totem', '@mmnto/totem', version);
+    writePackage(rootDir, 'cli', '@mmnto/cli', version);
+}
+/** Build a base context with all seams pointed at the temp consumer repo. */
+function baseCtx(over = {}) {
+    return {
+        cwd: tmpRoot,
+        gitRoot: tmpRoot,
+        repoId: 'totem-status',
+        ...over,
+    };
+}
+/** Write the consumer's package.json declaring `name` in `dependencies`. */
+function writeConsumerPkg(rootDir, deps, field = 'dependencies') {
+    fs.writeFileSync(path.join(rootDir, 'package.json'), JSON.stringify({ name: 'consumer-repo', [field]: deps }, null, 2), 'utf-8');
+}
+/** Write `node_modules/<pkg>/package.json#version` so install resolution wins. */
+function writeInstalled(rootDir, pkg, version) {
+    const dir = path.join(rootDir, 'node_modules', ...pkg.split('/'));
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ name: pkg, version }, null, 2), 'utf-8');
+}
+// ─── packageNameForContract ─────────────────────────────
+describe('packageNameForContract', () => {
+    it('derives @mmnto/<x> from an `mmnto-<x>-version` id with no path locator', () => {
+        expect(packageNameForContract(depsContract({ id: 'mmnto-totem-version' }))).toBe('@mmnto/totem');
+        expect(packageNameForContract(depsContract({ id: 'mmnto-mcp-version' }))).toBe('@mmnto/mcp');
+        expect(packageNameForContract(depsContract({ id: 'mmnto-cli-version' }))).toBe('@mmnto/cli');
+        expect(packageNameForContract(depsContract({ id: 'mmnto-pack-rust-architecture-version' }))).toBe('@mmnto/pack-rust-architecture');
+    });
+    it('prefers the canonical-source package.json `name` when a path locator is present', () => {
+        writePackage(tmpRoot, 'cli', '@mmnto/cli', '1.0.0');
+        const contract = depsContract({
+            id: 'mmnto-cli-version',
+            canonicalSource: 'mmnto-ai/totem:packages/cli/package.json#version',
+        });
+        expect(packageNameForContract(contract, tmpRoot)).toBe('@mmnto/cli');
+    });
+    it('returns undefined for ids that are not deps-version contracts', () => {
+        expect(packageNameForContract(depsContract({ id: 'governance-doctrine' }))).toBeUndefined();
+        expect(packageNameForContract(depsContract({ id: 'agent-memory-doctrine' }))).toBeUndefined();
+        expect(packageNameForContract(depsContract({ id: 'gate-config' }))).toBeUndefined();
+    });
+    it('prefers an explicit package: field over the id convention (derive-not-guess, strategy#517)', () => {
+        // Vendor name + a non-conventional id: only the package: field can resolve it.
+        expect(packageNameForContract(depsContract({ id: 'google-genai-coupling', package: '@google/genai' }))).toBe('@google/genai');
+        // package: wins even when the id convention WOULD match (no silent divergence).
+        expect(packageNameForContract(depsContract({ id: 'mmnto-totem-version', package: '@mmnto/totem' }))).toBe('@mmnto/totem');
+    });
+});
+// ─── deriveCohortRepoId ─────────────────────────────────
+describe('deriveCohortRepoId', () => {
+    it('extracts <name> from an mmnto-ai/<name> git origin remote (ssh + https, .git suffix)', () => {
+        expect(deriveCohortRepoId(tmpRoot, { remoteUrl: 'git@github.com:mmnto-ai/totem-status.git' })).toBe('totem-status');
+        expect(deriveCohortRepoId(tmpRoot, { remoteUrl: 'https://github.com/mmnto-ai/totem.git' })).toBe('totem');
+        expect(deriveCohortRepoId(tmpRoot, { remoteUrl: 'https://github.com/mmnto-ai/liquid-city' })).toBe('liquid-city');
+    });
+    it('falls back to package.json name basename (scope stripped) when no remote', () => {
+        writeConsumerPkg(tmpRoot, {});
+        fs.writeFileSync(path.join(tmpRoot, 'package.json'), JSON.stringify({ name: '@mmnto/totem-status' }, null, 2), 'utf-8');
+        expect(deriveCohortRepoId(tmpRoot, { remoteUrl: undefined, gitRoot: tmpRoot })).toBe('totem-status');
+    });
+    it('falls back to the git-root dir basename when neither remote nor package name resolve', () => {
+        const named = path.join(tmpRoot, 'my-cohort-repo');
+        fs.mkdirSync(named, { recursive: true });
+        expect(deriveCohortRepoId(named, { remoteUrl: undefined, gitRoot: named })).toBe('my-cohort-repo');
+    });
+    it('never networks / never throws on a git failure (returns a fallback or undefined)', () => {
+        // A remote-reader that throws must not propagate — the helper degrades.
+        expect(() => deriveCohortRepoId(tmpRoot, {
+            readRemote: () => {
+                throw new Error('git exploded');
+            },
+            gitRoot: tmpRoot,
+        })).not.toThrow();
+    });
+});
+// ─── resolveCohortFloor ─────────────────────────────────
+describe('resolveCohortFloor', () => {
+    it('resolves self-in-tree when the current git root IS the canonical-source repo', () => {
+        writeSelfInTree(tmpRoot, '1.53.3');
+        const result = resolveCohortFloor('@mmnto/totem', tmpRoot);
+        expect(result.resolved).toBe(true);
+        if (result.resolved) {
+            expect(result.version).toBe('1.53.3');
+            expect(result.source).toBe('self-in-tree');
+        }
+    });
+    it('resolves a sibling ../totem checkout when not self-in-tree', () => {
+        // gitRoot is the consumer; the floor lives in a sibling totem checkout.
+        const consumer = path.join(tmpRoot, 'totem-status');
+        const sibling = path.join(tmpRoot, 'totem');
+        fs.mkdirSync(consumer, { recursive: true });
+        writeSelfInTree(sibling, '2.0.0');
+        const result = resolveCohortFloor('@mmnto/totem', consumer);
+        expect(result.resolved).toBe(true);
+        if (result.resolved) {
+            expect(result.version).toBe('2.0.0');
+            expect(result.source).toBe('sibling');
+        }
+    });
+    it('is honest-absent (resolved:false + reason) when no floor is reachable + NEVER networks', () => {
+        const consumer = path.join(tmpRoot, 'lonely');
+        fs.mkdirSync(consumer, { recursive: true });
+        const result = resolveCohortFloor('@mmnto/totem', consumer);
+        expect(result.resolved).toBe(false);
+        if (!result.resolved) {
+            expect(result.reason).toMatch(/not locally determinable|sibling/i);
+        }
+    });
+    it('does not throw when a package.json in the glob is unreadable/corrupt', () => {
+        const pkgDir = path.join(tmpRoot, 'packages', 'totem');
+        fs.mkdirSync(pkgDir, { recursive: true });
+        fs.writeFileSync(path.join(pkgDir, 'package.json'), '{ not valid json', 'utf-8');
+        expect(() => resolveCohortFloor('@mmnto/totem', tmpRoot)).not.toThrow();
+    });
+});
+// ─── detectVersionPinnedContract ────────────────────────
+describe('detectVersionPinnedContract', () => {
+    it('PASS — installed ≥ floor, consumer declares the pin (sensor reports pass)', () => {
+        writeSelfInTree(tmpRoot, '1.50.0');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.50.0' });
+        writeInstalled(tmpRoot, '@mmnto/totem', '1.53.3');
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('pass');
+    });
+    it('WARN — installed < floor (stale pin); message carries declared/installed/floor', () => {
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.40.0' });
+        writeInstalled(tmpRoot, '@mmnto/totem', '1.40.0');
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('warn');
+        expect(verdict.message).toContain('1.40.0'); // installed
+        expect(verdict.message).toContain('1.53.3'); // floor
+    });
+    it('detector NEVER emits fail — even a blocking contract returns warn (CLI promotes)', () => {
+        // Claim-class + layering invariant: fail-promotion is a CLI-edge concern.
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.40.0' });
+        writeInstalled(tmpRoot, '@mmnto/totem', '1.40.0');
+        const verdict = detectVersionPinnedContract(depsContract({ blocking: true }), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('warn');
+        expect(verdict.status).not.toBe('fail');
+    });
+    it('SKIP (distinct) — applicable consumer missing an expected pin is expected-but-absent, NOT cohort-permitted', () => {
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { 'unrelated-dep': '^1.0.0' });
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('skip');
+        expect(verdict.message).toMatch(/expected but not declared|applicable consumer/i);
+        // Must stay DISTINCT from the not-a-consumer skip — else the consumers field
+        // does nothing for the missing case (strategy design-call 3).
+        expect(verdict.message).not.toMatch(/permits absence|not in consumers/i);
+    });
+    it('SKIP — consumers present and current repo not listed (not-a-consumer)', () => {
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.50.0' });
+        const verdict = detectVersionPinnedContract(depsContract({ consumers: ['totem-strategy', 'liquid-city'] }), baseCtx({ repoId: 'totem-status' }));
+        expect(verdict.status).toBe('skip');
+    });
+    it('SKIP — consumers present but repo id unresolvable: surface it, do NOT silently apply (Greptile P1)', () => {
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.50.0' });
+        const verdict = detectVersionPinnedContract(depsContract({ consumers: ['totem-strategy'] }), baseCtx({ repoId: undefined }));
+        expect(verdict.status).toBe('skip');
+        expect(verdict.message).toMatch(/cannot determine applicability|repo id unresolvable/i);
+    });
+    it('resolves an installed version hoisted to a PARENT node_modules (monorepo, GCA-1)', () => {
+        // Floor 2.0.0 self-in-tree at the git root; the consumer cwd is a nested
+        // subdir whose dep is hoisted to the root node_modules, not its own.
+        writeSelfInTree(tmpRoot, '2.0.0');
+        const sub = path.join(tmpRoot, 'apps', 'web');
+        fs.mkdirSync(sub, { recursive: true });
+        writeConsumerPkg(sub, { '@mmnto/totem': '^2.0.0' });
+        writeInstalled(tmpRoot, '@mmnto/totem', '2.0.0'); // hoisted at the root, not in sub
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ cwd: sub, gitRoot: tmpRoot, repoId: 'totem' }));
+        expect(verdict.status).toBe('pass');
+        expect(verdict.message).toContain('2.0.0');
+    });
+    it('SKIP — floor unresolvable (no self-in-tree, no sibling); reason in message, no throw', () => {
+        const consumer = path.join(tmpRoot, 'lonely');
+        fs.mkdirSync(consumer, { recursive: true });
+        writeConsumerPkg(consumer, { '@mmnto/totem': '^1.50.0' });
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ cwd: consumer, gitRoot: consumer, repoId: 'totem-status' }));
+        expect(verdict.status).toBe('skip');
+    });
+    it('SKIP — id resolves no deps package name (doctrine pin handed back to CLI as skip)', () => {
+        const verdict = detectVersionPinnedContract(depsContract({ id: 'governance-doctrine' }), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('skip');
+    });
+    it('no-throw on a corrupt consumer package.json — degrades to skip/warn', () => {
+        fs.writeFileSync(path.join(tmpRoot, 'package.json'), '{ broken', 'utf-8');
+        writeSelfInTree(tmpRoot, '1.53.3');
+        expect(() => detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }))).not.toThrow();
+    });
+    it('falls back to semver.minVersion(range) when node_modules is absent', () => {
+        // No install — minVersion('^1.53.0') = 1.53.0, equals floor → pass.
+        writeSelfInTree(tmpRoot, '1.53.0');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.53.0' });
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('pass');
+    });
+    it('SKIP (never throws) on an invalid declared range — claim guarded', () => {
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': 'not-a-range' });
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }));
+        expect(verdict.status).toBe('skip');
+    });
+    it('claim-class bound — the verdict is pin-currency only, never a content-equality verdict', () => {
+        // A version-pinned contract must never assert content drift. We assert the
+        // message is framed around versions/pins, not file content equality.
+        writeSelfInTree(tmpRoot, '1.53.3');
+        writeConsumerPkg(tmpRoot, { '@mmnto/totem': '^1.40.0' });
+        writeInstalled(tmpRoot, '@mmnto/totem', '1.40.0');
+        const verdict = detectVersionPinnedContract(depsContract(), baseCtx({ repoId: 'totem' }));
+        expect(verdict.message).not.toMatch(/content|file|hash|byte/i);
+        expect(verdict.message).toMatch(/version|pin|floor|install/i);
+    });
+});
+//# sourceMappingURL=parity-detect.test.js.map

package/dist/parity-detect.test.js.map

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

package/dist/parity-manifest.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Parity-manifest parser + config-path resolver (mmnto-ai/totem-strategy#448).
+ *
+ * The strategy repo owns `doctrine/parity-manifest.yaml` — the canonical,
+ * machine-readable enumeration of cohort parity dimensions the `totem doctor
+ * --parity` sensor checks for drift. This module is the SKELETON foundation:
+ * it resolves the consumer-configured config-path to the manifest, parses +
+ * Zod-validates the manifest at the system boundary, and maps the YAML
+ * kebab-case keys to camelCase type fields. Per-contract drift detection
+ * (per-dimension semantics against populated deps contracts) is OUT OF SCOPE
+ * for this skeleton and lives in a follow-on.
+ *
+ * Design invariants:
+ *   - **Honest-absent (Tenet 14):** absence is never an error. Unconfigured →
+ *     a `not-configured` signal; configured-but-missing → a distinct
+ *     `not-found` signal. The resolver and parser NEVER throw for absence.
+ *   - **Zod at the boundary only:** the manifest is untrusted on-disk input;
+ *     Zod validates it once at the parse boundary, then callers work with
+ *     typed values.
+ *   - **schema-version gate:** the supported schema version is `1`. An
+ *     unsupported version does NOT parse contracts — the parser returns an
+ *     `unsupported-schema` signal so the doctor can refuse an incompatible
+ *     future shape (per the manifest's own header contract).
+ *   - **Pure:** no caching, no logging, no process state. Each call reads from
+ *     scratch.
+ */
+import { z } from 'zod';
+/**
+ * The single parity-manifest schema version this doctor build understands.
+ * The manifest carries `schema-version: 1` as top-level lifecycle DATA so the
+ * doctor can refuse to parse an incompatible future shape rather than
+ * silently misread it. Bump in lockstep with a schema migration.
+ */
+export declare const SUPPORTED_PARITY_SCHEMA_VERSION = 1;
+/**
+ * Tractability bounds what the doctor may assert about a contract (the
+ * honest-absent rule):
+ *   - `mechanical`         file-content / structural equality; doctor may
+ *                          pass/warn/fail.
+ *   - `version-pinned`     consumer pins a canonical version/SHA; doctor checks
+ *                          pin currency only, never semantic content.
+ *   - `manual-attestation` genuinely semantic, no mechanical sensor; doctor
+ *                          surfaces staleness only, NEVER fails.
+ */
+export declare const ParityTractabilitySchema: z.ZodEnum<["mechanical", "version-pinned", "manual-attestation"]>;
+export type ParityTractability = z.infer<typeof ParityTractabilitySchema>;
+/**
+ * One parsed parity contract — the camelCase public shape. Mirrors the #508
+ * manifest schema exactly. `blocking` is parsed but UNUSED in the skeleton
+ * (per-contract gating is post-skeleton). `consumers` (absent = applies to all
+ * cohort repos) supports ADR-102 per-consumer applicability so the doctor can
+ * later distinguish drift from cohort-permits-absence.
+ */
+export interface ParityContract {
+    id: string;
+    dimension: string;
+    /** `null` = no external canonical source. The ONLY ref the resolver touches. */
+    canonicalSource: string | null;
+    /** Human-only context for `canonicalSource`. NEVER parsed as a ref. */
+    sourceNote?: string;
+    detectionMethod: string;
+    expectedValueOrDerivation: string;
+    tractability: ParityTractability;
+    trackingIssue: string;
+    /** Optional human-readable title. */
+    title?: string;
+    /**
+     * Optional doctor exit-code policy flag. Parsed but UNUSED in the skeleton —
+     * per-contract gating is deferred to a follow-on.
+     */
+    blocking?: boolean;
+    /**
+     * Optional cohort applicability (which repos carry this contract). Absent =
+     * applies to all cohort repos (ADR-102 per-consumer applicability).
+     */
+    consumers?: string[];
+    /**
+     * Optional explicit package identifier (mmnto-ai/totem-strategy#517) — the
+     * machine-parseable `@mmnto/*` (or vendor) package name a version/vendor
+     * contract pins. Preferred over the id-convention guess when present.
+     */
+    package?: string;
+}
+/** A fully parsed + validated parity manifest. */
+export interface ParityManifest {
+    schemaVersion: number;
+    status: string;
+    contracts: ParityContract[];
+}
+/**
+ * Honest-absent resolver outcome (discriminated union):
+ *   - `not-configured` — no `orient.parityManifest` set. Sensor → `skip`.
+ *   - `not-found`      — configured, but no file at the resolved path. Sensor
+ *                        → `warn` (distinct, actionable).
+ *   - `resolved`       — a file exists at `path` (absolute).
+ *
+ * Resolution NEVER throws for absence — both absent states are first-class
+ * return values, not exceptions.
+ */
+export type ParityManifestPathStatus = {
+    status: 'not-configured';
+} | {
+    status: 'not-found';
+    path: string;
+} | {
+    status: 'resolved';
+    path: string;
+};
+/**
+ * Resolve the configured `orient.parityManifest` config-path to an absolute
+ * manifest path. Relative values anchor at `root` (the config/repo root);
+ * absolute values are normalized as-is. Mirrors `resolveStrategyRoot`'s
+ * relative-anchoring behavior so a deep cwd doesn't mis-anchor the value.
+ *
+ * @param configValue The raw `orient.parityManifest` config string (or undefined).
+ * @param root        The config/repo root to anchor relative values against.
+ */
+export declare function resolveParityManifestPath(configValue: string | undefined, root: string): ParityManifestPathStatus;
+/**
+ * Honest-absent parse outcome (discriminated union):
+ *   - `unparseable`        — invalid YAML or Zod-schema validation failure.
+ *                            Sensor → `warn` (never crash).
+ *   - `unsupported-schema` — `schema-version` ≠ the supported version.
+ *                            Contracts are NOT parsed. Sensor → `warn`.
+ *   - `ok`                 — a fully parsed + validated manifest.
+ *
+ * Parsing NEVER throws — every failure is a first-class return value so the
+ * doctor pipeline degrades to a `warn` line rather than crashing (mirrors the
+ * `findStaleRules` best-effort fallback idiom).
+ */
+export type ParityManifestParseResult = {
+    status: 'unparseable';
+    reason: string;
+} | {
+    status: 'unsupported-schema';
+    schemaVersion: number;
+} | {
+    status: 'ok';
+    manifest: ParityManifest;
+};
+/**
+ * Parse raw YAML manifest text into a validated `ParityManifest`.
+ *
+ * Order of operations matters: the `schema-version` gate runs BEFORE the full
+ * contract validation so an unsupported future shape is rejected with a clear
+ * `unsupported-schema` signal rather than a confusing Zod failure against a
+ * v1-shaped schema. Within v1, contracts are Zod-validated and the kebab-case
+ * YAML keys are mapped to the camelCase `ParityContract` fields.
+ */
+export declare function parseParityManifest(yamlText: string): ParityManifestParseResult;
+/**
+ * Convenience: resolve the config-path, read the file, and parse it in one
+ * call. Returns the resolver's honest-absent signals (`not-configured` /
+ * `not-found`) directly, or the parse result. Read failures degrade to an
+ * `unparseable` parse result (never throws), so the doctor surface has a single
+ * exhaustive switch to render against.
+ */
+export type ParityManifestLoadResult = {
+    status: 'not-configured';
+} | {
+    status: 'not-found';
+    path: string;
+} | {
+    status: 'unparseable';
+    reason: string;
+    path: string;
+} | {
+    status: 'unsupported-schema';
+    schemaVersion: number;
+    path: string;
+} | {
+    status: 'ok';
+    manifest: ParityManifest;
+    path: string;
+};
+export declare function loadParityManifest(configValue: string | undefined, root: string): ParityManifestLoadResult;
+//# sourceMappingURL=parity-manifest.d.ts.map

package/dist/parity-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity-manifest.d.ts","sourceRoot":"","sources":["../src/parity-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAIjD;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,mEAInC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AA8C1E;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,CAAC;IAClC,YAAY,EAAE,kBAAkB,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAID;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACX,wBAAwB,CAgB1B;AAkBD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,yBAAyB,GACjC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,CA+C/E;AAoBD;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACX,wBAAwB,CA4B1B"}