@proteinjs/reflection-build 1.5.0 → 2.0.1

package/CHANGELOG.md

@@ -3,6 +3,46 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.1](https://github.com/proteinjs/reflection/compare/@proteinjs/reflection-build@2.0.0...@proteinjs/reflection-build@2.0.1) (2026-08-22)
+
+
+### Bug Fixes
+
+* never instantiate abstract classes from objects(); stamp class-level isAbstract in the parser ([b971030](https://github.com/proteinjs/reflection/commit/b971030f42b8660cc2f0688848ecfe8599ca1dcf))
+
+
+
+
+
+# [2.0.0](https://github.com/proteinjs/reflection/compare/@proteinjs/reflection-build@1.5.0...@proteinjs/reflection-build@2.0.0) (2026-08-18)
+
+
+### Bug Fixes
+
+* **reflection-build:** emit package-relative filePaths in the source graph — kills the build-machine path disclosure ([df453e5](https://github.com/proteinjs/reflection/commit/df453e5433a6d085686c0818ec66d4826a7de6f2))
+
+
+### Features
+
+* **reflection-build:** reflection-doctor CLI — inventory, orphan detection, --explain parent-edge traces ([ab53c39](https://github.com/proteinjs/reflection/commit/ab53c39df976feeb46ce9d6130bcf397b0d48a5e))
+* **reflection-build:** validate-don't-mutate package-config contract + generalized ./test subpath contract (BuildContract, --fix) ([88b0a2b](https://github.com/proteinjs/reflection/commit/88b0a2b011fcf817fad6fbdff7fa5078422f4ba1))
+
+
+### BREAKING CHANGES
+
+* **reflection-build:** reflection-build no longer rewrites package.json/tsconfig.json on
+every build. It validates them as a contract: absent config is completed (including
+the ./test subpath's root stubs, exports/typesVersions, tsconfig excludes), but
+CONFLICTING config now FAILS the build with a friendly error (nothing changed on
+disk) instead of being silently overwritten. Run `reflection-build --fix` once to
+adopt the contract on out-of-sync packages.
+
+Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
+
+
+
+
+
 # [1.5.0](https://github.com/proteinjs/reflection/compare/@proteinjs/reflection-build@1.4.12...@proteinjs/reflection-build@1.5.0) (2026-08-14)
 
 

package/dist/modules/typescript-parser/declarations/ClassDeclaration.d.ts

@@ -18,6 +18,7 @@ export declare class ClassDeclaration implements ClassLikeDeclaration, Exportabl
     start?: number | undefined;
     end?: number | undefined;
     ctor: ConstructorDeclaration | undefined;
+    isAbstract: boolean;
     accessors: AccessorDeclaration[];
     properties: PropertyDeclaration[];
     methods: MethodDeclaration[];

package/dist/modules/typescript-parser/declarations/ClassDeclaration.js

@@ -16,6 +16,7 @@ class ClassDeclaration {
         this.isExported = isExported;
         this.start = start;
         this.end = end;
+        this.isAbstract = false;
         this.accessors = [];
         this.properties = [];
         this.methods = [];

package/dist/modules/typescript-parser/node-parser/class-parser.js

@@ -78,6 +78,12 @@ exports.parseCtorParams = parseCtorParams;
 function parseClass(tsResource, node) {
     const name = node.name ? node.name.text : parse_utilities_1.getDefaultResourceIdentifier(tsResource);
     const classDeclaration = new ClassDeclaration_1.ClassDeclaration(name, parse_utilities_1.isNodeExported(node), node.getStart(), node.getEnd());
+    // The class-level `abstract` keyword lives in the class node's own modifiers — member scans
+    // (abstract accessors/methods/properties) are NOT a substitute: an abstract class need not
+    // declare any abstract member, and consumers (reflection's SourceRepository) must know the
+    // class itself is not instantiable.
+    classDeclaration.isAbstract =
+        node.modifiers !== undefined && node.modifiers.some(m => m.kind === typescript_1.SyntaxKind.AbstractKeyword);
     if (parse_utilities_1.isNodeDefaultExported(node)) {
         classDeclaration.isExported = false;
         tsResource.declarations.push(new DefaultDeclaration_1.DefaultDeclaration(classDeclaration.name, tsResource));

package/dist/src/BuildContract.d.ts

@@ -0,0 +1,69 @@
+export interface BuildContractOptions {
+    /** Root of the package being built (contains package.json) */
+    packageDir: string;
+    /** First REFLECTION_SOURCE_DIRS entry; 'src' for prod builds */
+    primaryRoot: string;
+    /** REFLECTION_DIST_DIR or 'dist' */
+    distDirRel: string;
+    /** Absolute path to the generated index .ts this invocation emits */
+    generatedIndexPath: string;
+    /** Write conflicting values to the contract instead of failing the build */
+    fix: boolean;
+}
+/**
+ * The package-config contract of a reflection build (task #104 §3.3, validate-don't-mutate).
+ *
+ * A build's artifact is only usable if the package's config points at it, so reflection-build
+ * owns that config as a contract instead of silently rewriting files on every build:
+ *
+ * - ABSENT config is completed in place (a fresh or copied package gets main/types, subpath
+ *   mappings, stubs — the zero-ceremony workflow survives).
+ * - EXISTING config that conflicts with the contract fails the build with a friendly error
+ *   (plain words, why it matters, the exact lines to paste, `--fix` offered first) and leaves
+ *   every file untouched.
+ * - `reflection-build --fix` writes the contract over conflicting values; it is idempotent.
+ *
+ * Prod builds (primary root 'src') own main/types + the tsconfig include. Subpath builds
+ * (primary root e.g. 'test') own the complete subpath contract — root <root>.js/<root>.d.ts
+ * stubs, exports/typesVersions mappings, files[] entries, tsconfig excludes (the d51556f0
+ * class, generalized): consumers must resolve the subpath to built dist in every install
+ * shape and resolution mode, never to sources.
+ */
+export declare class BuildContract {
+    private readonly options;
+    constructor(options: BuildContractOptions);
+    apply(): Promise<void>;
+    private applyPackageJson;
+    /** Prod builds: main/types point at the built reflection artifact. */
+    private settleEntryPoints;
+    /** Subpath builds: exports map "." and "./<root>" to the built artifacts. */
+    private settleSubpathExports;
+    /** Subpath builds: typesVersions carries the subpath's types for node10 resolution. */
+    private settleTypesVersions;
+    /** Subpath builds: an existing files allowlist must keep shipping the root stubs. */
+    private settleFilesAllowlist;
+    /**
+     * Subpath builds: root stubs that win the node10/paths-mapped file lookup, so every install
+     * shape resolves the subpath to built dist — never to sources (the TS6059/ts-jest class).
+     */
+    private applyStubs;
+    /**
+     * tsconfig: include the generated index; on subpath builds, exclude the root stubs from
+     * compilation. List membership only — nothing here can conflict.
+     */
+    private applyTsconfig;
+    /**
+     * Settle one string field: absent → set; equal → ok; a dangling value (points at a file
+     * that does not exist — npm init's boilerplate `"main": "index.js"`, a stale copy) → set;
+     * a value that points at a real, different file is a deliberate setting → conflict.
+     */
+    private settleString;
+    private formatConflicts;
+    private isProd;
+    private prodIndexJs;
+    private prodIndexDts;
+    private subpathIndexJs;
+    private subpathIndexDts;
+    private stubJsName;
+    private stubDtsName;
+}

package/dist/src/BuildContract.js

@@ -0,0 +1,393 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildContract = void 0;
+var fs = __importStar(require("fs"));
+var path = __importStar(require("path"));
+var tsconfigTemplate = require('./tsconfigTemplate.json');
+/**
+ * The package-config contract of a reflection build (task #104 §3.3, validate-don't-mutate).
+ *
+ * A build's artifact is only usable if the package's config points at it, so reflection-build
+ * owns that config as a contract instead of silently rewriting files on every build:
+ *
+ * - ABSENT config is completed in place (a fresh or copied package gets main/types, subpath
+ *   mappings, stubs — the zero-ceremony workflow survives).
+ * - EXISTING config that conflicts with the contract fails the build with a friendly error
+ *   (plain words, why it matters, the exact lines to paste, `--fix` offered first) and leaves
+ *   every file untouched.
+ * - `reflection-build --fix` writes the contract over conflicting values; it is idempotent.
+ *
+ * Prod builds (primary root 'src') own main/types + the tsconfig include. Subpath builds
+ * (primary root e.g. 'test') own the complete subpath contract — root <root>.js/<root>.d.ts
+ * stubs, exports/typesVersions mappings, files[] entries, tsconfig excludes (the d51556f0
+ * class, generalized): consumers must resolve the subpath to built dist in every install
+ * shape and resolution mode, never to sources.
+ */
+var BuildContract = /** @class */ (function () {
+    function BuildContract(options) {
+        this.options = options;
+    }
+    BuildContract.prototype.apply = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var conflicts, writes, _i, writes_1, write;
+            return __generator(this, function (_a) {
+                conflicts = [];
+                writes = [];
+                this.applyPackageJson(conflicts, writes);
+                this.applyStubs(conflicts, writes);
+                this.applyTsconfig(writes);
+                if (conflicts.length > 0) {
+                    throw new Error(this.formatConflicts(conflicts));
+                }
+                for (_i = 0, writes_1 = writes; _i < writes_1.length; _i++) {
+                    write = writes_1[_i];
+                    fs.writeFileSync(write.filePath, write.content);
+                }
+                return [2 /*return*/];
+            });
+        });
+    };
+    BuildContract.prototype.applyPackageJson = function (conflicts, writes) {
+        var packageJsonPath = path.join(this.options.packageDir, 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+            throw new Error("package.json does not exist, run `npm init -y` to create one");
+        }
+        var original = fs.readFileSync(packageJsonPath, 'utf-8');
+        var packageJson = JSON.parse(original);
+        if (this.isProd()) {
+            this.settleEntryPoints(packageJson, conflicts);
+        }
+        else {
+            this.settleSubpathExports(packageJson, conflicts);
+            this.settleTypesVersions(packageJson, conflicts);
+            this.settleFilesAllowlist(packageJson);
+        }
+        var updated = JSON.stringify(packageJson, null, 2);
+        if (updated !== JSON.stringify(JSON.parse(original), null, 2)) {
+            writes.push({ filePath: packageJsonPath, content: updated });
+        }
+    };
+    /** Prod builds: main/types point at the built reflection artifact. */
+    BuildContract.prototype.settleEntryPoints = function (packageJson, conflicts) {
+        var pasteBlock = ["  \"main\": \"".concat(this.prodIndexJs(), "\","), "  \"types\": \"".concat(this.prodIndexDts(), "\"")].join('\n');
+        var whyItMatters = 'Every consumer loads this package through main/types; pointing them anywhere but the ' +
+            'built reflection artifact ships a package that loads the wrong code.';
+        this.settleString(packageJson, 'main', this.prodIndexJs(), conflicts, whyItMatters, pasteBlock);
+        this.settleString(packageJson, 'types', this.prodIndexDts(), conflicts, whyItMatters, pasteBlock);
+    };
+    /** Subpath builds: exports map "." and "./<root>" to the built artifacts. */
+    BuildContract.prototype.settleSubpathExports = function (packageJson, conflicts) {
+        var _a;
+        var root = this.options.primaryRoot;
+        var expectedExports = (_a = {
+                '.': { types: this.prodIndexDts(), default: this.prodIndexJs() }
+            },
+            _a["./".concat(root)] = { types: this.subpathIndexDts(), default: this.subpathIndexJs() },
+            _a);
+        var whyItMatters = "Consumers import '<package>/".concat(root, "' through these mappings; a wrong mapping resolves ") +
+            'to the wrong files (or to sources), breaking consumer builds.';
+        if (packageJson.exports == null) {
+            packageJson.exports = expectedExports;
+            return;
+        }
+        for (var _i = 0, _b = Object.keys(expectedExports); _i < _b.length; _i++) {
+            var subpath = _b[_i];
+            var expected = expectedExports[subpath];
+            var current = packageJson.exports[subpath];
+            if (current == null) {
+                packageJson.exports[subpath] = expected;
+            }
+            else if (JSON.stringify(current) !== JSON.stringify(expected)) {
+                if (this.options.fix) {
+                    packageJson.exports[subpath] = expected;
+                }
+                else {
+                    conflicts.push({
+                        file: 'package.json',
+                        found: "\"exports\" maps \"".concat(subpath, "\" to ").concat(JSON.stringify(current)),
+                        expected: JSON.stringify(expected),
+                        whyItMatters: whyItMatters,
+                        pasteBlock: "  \"exports\": ".concat(JSON.stringify(expectedExports, null, 2).replace(/\n/g, '\n  ')),
+                    });
+                }
+            }
+        }
+    };
+    /** Subpath builds: typesVersions carries the subpath's types for node10 resolution. */
+    BuildContract.prototype.settleTypesVersions = function (packageJson, conflicts) {
+        var _a;
+        var root = this.options.primaryRoot;
+        // No leading './' by typesVersions convention.
+        var expected = [this.subpathIndexDts().replace(/^\.\//, '')];
+        var expectedBlock = { '*': (_a = {}, _a[root] = expected, _a) };
+        if (packageJson.typesVersions == null) {
+            packageJson.typesVersions = expectedBlock;
+            return;
+        }
+        if (packageJson.typesVersions['*'] == null) {
+            packageJson.typesVersions['*'] = expectedBlock['*'];
+            return;
+        }
+        var current = packageJson.typesVersions['*'][root];
+        if (current == null) {
+            packageJson.typesVersions['*'][root] = expected;
+        }
+        else if (JSON.stringify(current) !== JSON.stringify(expected)) {
+            if (this.options.fix) {
+                packageJson.typesVersions['*'][root] = expected;
+            }
+            else {
+                conflicts.push({
+                    file: 'package.json',
+                    found: "\"typesVersions\" maps \"".concat(root, "\" to ").concat(JSON.stringify(current)),
+                    expected: JSON.stringify(expected),
+                    whyItMatters: "Editors and node10-resolution consumers find '<package>/".concat(root, "' types through this ") +
+                        'mapping; a wrong mapping breaks type resolution for every consumer.',
+                    pasteBlock: "  \"typesVersions\": ".concat(JSON.stringify(expectedBlock, null, 2).replace(/\n/g, '\n  ')),
+                });
+            }
+        }
+    };
+    /** Subpath builds: an existing files allowlist must keep shipping the root stubs. */
+    BuildContract.prototype.settleFilesAllowlist = function (packageJson) {
+        if (!Array.isArray(packageJson.files)) {
+            // No allowlist means npm publishes the stubs already; adding one would change what
+            // gets published, which is not this contract's call.
+            return;
+        }
+        for (var _i = 0, _a = [this.stubJsName(), this.stubDtsName()]; _i < _a.length; _i++) {
+            var stub = _a[_i];
+            if (!packageJson.files.includes(stub)) {
+                packageJson.files.push(stub);
+            }
+        }
+    };
+    /**
+     * Subpath builds: root stubs that win the node10/paths-mapped file lookup, so every install
+     * shape resolves the subpath to built dist — never to sources (the TS6059/ts-jest class).
+     */
+    BuildContract.prototype.applyStubs = function (conflicts, writes) {
+        if (this.isProd()) {
+            return;
+        }
+        var root = this.options.primaryRoot;
+        var targetNoExt = "./".concat(this.options.distDirRel, "/generated/").concat(root, "/index");
+        var whyItMatters = "Consumers compiled with node10/classic resolution (or a tsconfig paths mapping) resolve " +
+            "'<package>/".concat(root, "' as a file path, bypassing the exports map; without a root stub that ") +
+            'lands on sources in workspace-symlinked installs (TS6059 breaks the consumer build).';
+        var stubJs = {
+            file: this.stubJsName(),
+            content: "// Node10/classic-resolution stub for the `./".concat(root, "` subpath, owned by reflection-build.\n") +
+                "// Consumers that bypass the exports map (node10 resolution, tsconfig paths mappings) resolve\n" +
+                "// this file path first, so every install shape loads the built dist \u2014 never sources.\n" +
+                "module.exports = require('".concat(targetNoExt, ".js');\n"),
+        };
+        var stubDts = {
+            file: this.stubDtsName(),
+            content: "// Types counterpart of ".concat(this.stubJsName(), " \u2014 see that file for why this stub exists.\n") +
+                "export * from '".concat(targetNoExt, "';\n"),
+        };
+        for (var _i = 0, _a = [stubJs, stubDts]; _i < _a.length; _i++) {
+            var stub = _a[_i];
+            var stubPath = path.join(this.options.packageDir, stub.file);
+            if (!fs.existsSync(stubPath)) {
+                writes.push({ filePath: stubPath, content: stub.content });
+                continue;
+            }
+            var current = fs.readFileSync(stubPath, 'utf-8');
+            if (current.includes(targetNoExt)) {
+                continue;
+            }
+            if (this.options.fix) {
+                writes.push({ filePath: stubPath, content: stub.content });
+            }
+            else {
+                conflicts.push({
+                    file: stub.file,
+                    found: "".concat(stub.file, " exists but does not point at ").concat(targetNoExt),
+                    expected: targetNoExt,
+                    whyItMatters: whyItMatters,
+                    pasteBlock: stub.content.replace(/^/gm, '  ').trimRight(),
+                });
+            }
+        }
+    };
+    /**
+     * tsconfig: include the generated index; on subpath builds, exclude the root stubs from
+     * compilation. List membership only — nothing here can conflict.
+     */
+    BuildContract.prototype.applyTsconfig = function (writes) {
+        var tsconfigPath = path.join(this.options.packageDir, 'tsconfig.json');
+        var includePath = "./".concat(path.relative(this.options.packageDir, this.options.generatedIndexPath));
+        if (!fs.existsSync(tsconfigPath)) {
+            var tsconfig_1 = Object.assign({}, tsconfigTemplate);
+            tsconfig_1.include = [includePath];
+            if (!this.isProd()) {
+                // Fresh exclude must carry node_modules: an explicit exclude replaces the default one.
+                tsconfig_1.exclude = ['node_modules', this.stubJsName(), this.stubDtsName()];
+            }
+            writes.push({ filePath: tsconfigPath, content: JSON.stringify(tsconfig_1, null, 4) });
+            return;
+        }
+        var original = fs.readFileSync(tsconfigPath, 'utf-8');
+        var tsconfig = JSON.parse(original);
+        if (tsconfig.include && !tsconfig.include.includes(includePath)) {
+            tsconfig.include.push(includePath);
+        }
+        if (!this.isProd()) {
+            if (!Array.isArray(tsconfig.exclude)) {
+                tsconfig.exclude = ['node_modules'];
+            }
+            for (var _i = 0, _a = [this.stubJsName(), this.stubDtsName()]; _i < _a.length; _i++) {
+                var stub = _a[_i];
+                if (!tsconfig.exclude.includes(stub)) {
+                    tsconfig.exclude.push(stub);
+                }
+            }
+        }
+        var updated = JSON.stringify(tsconfig, null, 4);
+        if (updated !== JSON.stringify(JSON.parse(original), null, 4)) {
+            writes.push({ filePath: tsconfigPath, content: updated });
+        }
+    };
+    /**
+     * Settle one string field: absent → set; equal → ok; a dangling value (points at a file
+     * that does not exist — npm init's boilerplate `"main": "index.js"`, a stale copy) → set;
+     * a value that points at a real, different file is a deliberate setting → conflict.
+     */
+    BuildContract.prototype.settleString = function (packageJson, field, expected, conflicts, whyItMatters, pasteBlock) {
+        var current = packageJson[field];
+        if (current === expected) {
+            return;
+        }
+        if (typeof current === 'string' && fs.existsSync(path.join(this.options.packageDir, current))) {
+            if (this.options.fix) {
+                packageJson[field] = expected;
+            }
+            else {
+                conflicts.push({
+                    file: 'package.json',
+                    found: "\"".concat(field, "\" is \"").concat(current, "\""),
+                    expected: expected,
+                    whyItMatters: whyItMatters,
+                    pasteBlock: pasteBlock,
+                });
+            }
+            return;
+        }
+        packageJson[field] = expected;
+    };
+    BuildContract.prototype.formatConflicts = function (conflicts) {
+        var lines = [];
+        lines.push("reflection-build: this package's config conflicts with what the build produces.");
+        lines.push("Nothing was changed on disk.");
+        lines.push('');
+        for (var _i = 0, conflicts_1 = conflicts; _i < conflicts_1.length; _i++) {
+            var conflict = conflicts_1[_i];
+            lines.push("- ".concat(conflict.file, ": ").concat(conflict.found));
+            lines.push("  the build's artifact is ".concat(conflict.expected));
+            lines.push("  Why it matters: ".concat(conflict.whyItMatters));
+        }
+        lines.push('');
+        lines.push("The quickest fix \u2014 rewrite just these fields to match the build:");
+        lines.push('');
+        lines.push("  npx reflection-build --fix");
+        lines.push('');
+        lines.push("Or paste the expected values in yourself:");
+        lines.push('');
+        var seen = {};
+        for (var _a = 0, conflicts_2 = conflicts; _a < conflicts_2.length; _a++) {
+            var conflict = conflicts_2[_a];
+            if (seen[conflict.pasteBlock]) {
+                continue;
+            }
+            seen[conflict.pasteBlock] = true;
+            lines.push(conflict.pasteBlock);
+            lines.push('');
+        }
+        return lines.join('\n');
+    };
+    BuildContract.prototype.isProd = function () {
+        return this.options.primaryRoot === 'src';
+    };
+    BuildContract.prototype.prodIndexJs = function () {
+        return "./".concat(path.join(this.options.distDirRel, 'generated', 'index.js'));
+    };
+    BuildContract.prototype.prodIndexDts = function () {
+        return "./".concat(path.join(this.options.distDirRel, 'generated', 'index.d.ts'));
+    };
+    BuildContract.prototype.subpathIndexJs = function () {
+        return "./".concat(path.join(this.options.distDirRel, 'generated', this.options.primaryRoot, 'index.js'));
+    };
+    BuildContract.prototype.subpathIndexDts = function () {
+        return "./".concat(path.join(this.options.distDirRel, 'generated', this.options.primaryRoot, 'index.d.ts'));
+    };
+    BuildContract.prototype.stubJsName = function () {
+        return "".concat(this.options.primaryRoot, ".js");
+    };
+    BuildContract.prototype.stubDtsName = function () {
+        return "".concat(this.options.primaryRoot, ".d.ts");
+    };
+    return BuildContract;
+}());
+exports.BuildContract = BuildContract;
+//# sourceMappingURL=BuildContract.js.map

package/dist/src/BuildContract.js.map

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

package/dist/src/ReflectionDoctor.d.ts

@@ -0,0 +1,95 @@
+export interface DoctorReport {
+    text: string;
+    healthy: boolean;
+    dependencies: {
+        /** reflection-built deps whose graphs load at runtime */
+        loaded: string[];
+        /** declared deps that ship no graph (normal for non-reflection deps) */
+        withoutGraph: string[];
+        /** deps opted out via SKIP_REFLECTION_LOAD */
+        skipped: string[];
+    };
+    nodeCount: number;
+    edgeCount: number;
+    sourceLinkCount: number;
+    drift: {
+        /** declarations in current sources missing from the built artifact (stale dist) */
+        missingFromDist: string[];
+        /** declarations in the built artifact no longer in sources (stale dist) */
+        onlyInDist: string[];
+    };
+    orphans: Orphan[];
+}
+export interface Orphan {
+    qualifiedName: string;
+    unresolvedParent: string;
+    cause: string;
+}
+export interface Explanation {
+    text: string;
+    verdict: string;
+}
+/**
+ * reflection-doctor (task #104 §3.1): purely analytical diagnostics for a reflection-built
+ * package, run from the package dir. Executes NO dependency code — its own graph and every
+ * dependency graph are harvested statically from `dist/generated/index.js` artifacts (the
+ * same upward node_modules walk the build's import gate uses, transitively, mirroring what
+ * the runtime would merge).
+ *
+ * - `diagnose()` prints the registered inventory (deps with graphs / without / skip-listed),
+ *   this package's node+edge+sourceLink counts, emitted-vs-source drift (stale dist), and
+ *   ORPHANS: nodes the build kept because a parent is foreign, whose parent's package
+ *   resolves to no loadable graph — the undeclared-dep / typo footgun that the runtime
+ *   silently prunes today.
+ * - `explain(name)` prints the parent-edge resolution trace for one declaration — how (or
+ *   why not) it becomes Loadable — naming the broken hop and its cause.
+ */
+export declare class ReflectionDoctor {
+    private readonly packageDir;
+    private readonly skipList;
+    constructor(packageDir: string, options?: {
+        skipList?: string[];
+    });
+    diagnose(): Promise<DoctorReport>;
+    explain(nameOrQualifiedName: string): Promise<Explanation>;
+    /**
+     * Recursive parent-edge trace. Returns the first Loadable-reaching direct parent (for the
+     * objects() verdict) and the first broken hop encountered, if any.
+     */
+    private trace;
+    private classifyUnresolvedParent;
+    /** Why a package contributes no graph, from the consuming package's point of view. */
+    private classifyPackage;
+    /**
+     * Orphans: nodes this package's build kept (foreign parent ⇒ benefit of the doubt), whose
+     * parent's package contributes NO graph at runtime — the runtime will silently prune them.
+     * Parents living in loaded graphs that simply aren't Loadable are not orphans (that pruning
+     * is by design); `explain` covers those.
+     */
+    private findOrphans;
+    /** Emitted-vs-source drift: rebuild-needed detection for the prod graph. */
+    private computeDrift;
+    /**
+     * Statically harvest this package's graph and, transitively, every reflection-built
+     * dependency's graph — the same set the runtime merges.
+     */
+    private harvestUniverse;
+    private addToUniverse;
+    /** Extract the serialized graph from a generated index without executing it. */
+    private parseArtifactGraph;
+    private parseSourceLinkKeys;
+    private dependencyInventory;
+    private resolveTarget;
+    /** The declaration is in no harvested graph — diagnose why from this package's sources. */
+    private explainNotFound;
+    /** Raw parser pass over src — sees non-exported declarations the graph never contains. */
+    private findDeclarationInSources;
+    private checkSourceLink;
+    private findValuedNode;
+    private describeKind;
+    private formatReport;
+    /** True for shapes a qualified name can take; inline type expressions (unions, literals, comments) fail this. */
+    private isResolvableQualifiedName;
+    private dependencyNames;
+    private readPackageJson;
+}