@mmnto/totem 1.21.0 → 1.22.0

package/dist/pack-discovery.test.js

@@ -0,0 +1,343 @@
+/**
+ * Tests for the pack discovery substrate (mmnto-ai/totem#1768, ADR-097
+ * § 5 Q5 + § 10).
+ *
+ * Covers invariants 1, 2, 3, 4, 8 from `.totem/specs/pack-substrate-bundle.md`:
+ *
+ * - Missing manifest → empty packs, no throw.
+ * - Malformed manifest → fail loud.
+ * - peerDependencies engine version mismatch → structured fail loud.
+ * - Re-load after seal → throw.
+ * - Pack callback can register chunker + language; lookups return registered values.
+ *
+ * Uses the `inMemoryPacks` test escape hatch to drive the registration
+ * phase without writing fixture pack packages to `node_modules`.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { __resetLangRegistryForTests, extensionToLanguage, registeredExtensions, } from './ast-classifier.js';
+import { __resetForTests as __resetChunkerRegistryForTests, lookup as lookupChunker, registeredNames as registeredChunkerStrategies, } from './chunkers/chunker-registry.js';
+import { __resetForTests as __resetPackDiscoveryForTests, isEngineSealed, loadInstalledPacks, } from './pack-discovery.js';
+class FakeChunker {
+    strategy = 'rust-ast';
+    chunk(_content, _filePath, _type) {
+        return [];
+    }
+}
+afterEach(() => {
+    // Order matters: pack-discovery's seal flag and registries are
+    // independent state containers — reset all three each test so seal
+    // state from one case doesn't leak into the next.
+    __resetPackDiscoveryForTests();
+    __resetChunkerRegistryForTests();
+    __resetLangRegistryForTests();
+});
+describe('loadInstalledPacks: missing manifest', () => {
+    it('returns empty packs and does not throw when installed-packs.json is absent', () => {
+        const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pack-discovery-test-'));
+        try {
+            const packs = loadInstalledPacks({ projectRoot: tmpRoot, totemDir: '.totem' });
+            expect(packs).toEqual([]);
+            expect(isEngineSealed()).toBe(true);
+        }
+        finally {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    });
+});
+describe('loadInstalledPacks: malformed manifest', () => {
+    it('throws structured error on invalid JSON', () => {
+        const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pack-discovery-test-'));
+        try {
+            const totemDir = path.join(tmpRoot, '.totem');
+            fs.mkdirSync(totemDir, { recursive: true });
+            fs.writeFileSync(path.join(totemDir, 'installed-packs.json'), '{ this is not json');
+            expect(() => loadInstalledPacks({ projectRoot: tmpRoot, totemDir: '.totem' })).toThrowError(/not valid JSON/);
+        }
+        finally {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    });
+    it('throws structured error on schema validation failure', () => {
+        const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pack-discovery-test-'));
+        try {
+            const totemDir = path.join(tmpRoot, '.totem');
+            fs.mkdirSync(totemDir, { recursive: true });
+            fs.writeFileSync(path.join(totemDir, 'installed-packs.json'), JSON.stringify({ version: 99, packs: [] }));
+            expect(() => loadInstalledPacks({ projectRoot: tmpRoot, totemDir: '.totem' })).toThrowError(/failed schema validation/);
+        }
+        finally {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    });
+    it('throws on unknown sibling keys (strict schema)', () => {
+        const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pack-discovery-test-'));
+        try {
+            const totemDir = path.join(tmpRoot, '.totem');
+            fs.mkdirSync(totemDir, { recursive: true });
+            fs.writeFileSync(path.join(totemDir, 'installed-packs.json'), JSON.stringify({ version: 1, packs: [], extra: 'oops' }));
+            expect(() => loadInstalledPacks({ projectRoot: tmpRoot, totemDir: '.totem' })).toThrowError(/failed schema validation/);
+        }
+        finally {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    });
+    it('rejects manifest with duplicate pack names at the schema boundary', () => {
+        const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pack-discovery-test-'));
+        try {
+            const totemDir = path.join(tmpRoot, '.totem');
+            fs.mkdirSync(totemDir, { recursive: true });
+            fs.writeFileSync(path.join(totemDir, 'installed-packs.json'), JSON.stringify({
+                version: 1,
+                packs: [
+                    {
+                        name: '@totem/pack-rust',
+                        resolvedPath: path.resolve('/abs/a'),
+                        declaredEngineRange: '^1.19.0',
+                    },
+                    {
+                        name: '@totem/pack-rust',
+                        resolvedPath: path.resolve('/abs/b'),
+                        declaredEngineRange: '^1.19.0',
+                    },
+                ],
+            }));
+            expect(() => loadInstalledPacks({ projectRoot: tmpRoot, totemDir: '.totem' })).toThrowError(/duplicate pack entry '@totem\/pack-rust'/);
+        }
+        finally {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    });
+    it('rejects manifest entries with a relative resolvedPath at the schema boundary', () => {
+        const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pack-discovery-test-'));
+        try {
+            const totemDir = path.join(tmpRoot, '.totem');
+            fs.mkdirSync(totemDir, { recursive: true });
+            fs.writeFileSync(path.join(totemDir, 'installed-packs.json'), JSON.stringify({
+                version: 1,
+                packs: [
+                    {
+                        name: '@totem/pack-relative',
+                        resolvedPath: 'node_modules/@totem/pack-relative',
+                        declaredEngineRange: '^1.19.0',
+                    },
+                ],
+            }));
+            expect(() => loadInstalledPacks({ projectRoot: tmpRoot, totemDir: '.totem' })).toThrowError(/resolvedPath must be an absolute path/);
+        }
+        finally {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    });
+});
+describe('loadInstalledPacks: peerDependencies engine version mismatch', () => {
+    it('throws structured error naming pack name + declared range + actual engine version', () => {
+        const fakeCallback = () => { };
+        const fakePack = {
+            name: '@totem/pack-fake',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: '^2.0.0',
+        };
+        expect(() => loadInstalledPacks({
+            engineVersion: '1.21.0',
+            inMemoryPacks: [{ pack: fakePack, callback: fakeCallback }],
+        })).toThrowError(/Pack '@totem\/pack-fake' requires @mmnto\/totem '\^2\.0\.0'.*running engine is 1\.21\.0/);
+    });
+    it('passes when engine version satisfies declared range', () => {
+        const fakeCallback = () => { };
+        const fakePack = {
+            name: '@totem/pack-fake',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: '^1.19.0',
+        };
+        const packs = loadInstalledPacks({
+            engineVersion: '1.21.0',
+            inMemoryPacks: [{ pack: fakePack, callback: fakeCallback }],
+        });
+        expect(packs).toHaveLength(1);
+        expect(packs[0]?.name).toBe('@totem/pack-fake');
+    });
+    it('throws when declared range is invalid semver', () => {
+        const fakeCallback = () => { };
+        const fakePack = {
+            name: '@totem/pack-fake',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: 'not-a-semver-range',
+        };
+        expect(() => loadInstalledPacks({
+            engineVersion: '1.21.0',
+            inMemoryPacks: [{ pack: fakePack, callback: fakeCallback }],
+        })).toThrowError(/not a valid semver range/);
+    });
+});
+describe('loadInstalledPacks: re-load after seal', () => {
+    it('throws when called twice', () => {
+        loadInstalledPacks({ inMemoryPacks: [] });
+        expect(() => loadInstalledPacks({ inMemoryPacks: [] })).toThrowError(/called after engine seal/);
+    });
+});
+describe('loadInstalledPacks: pack callback registration', () => {
+    it('invokes pack callback with PackRegistrationAPI; lookups return registered values', () => {
+        const fakeCallback = (api) => {
+            api.registerChunkStrategy('rust-ast', FakeChunker);
+            api.registerLanguage('.rs', 'rust', () => '/fake/tree-sitter-rust.wasm');
+        };
+        const fakePack = {
+            name: '@totem/pack-rust-architecture',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: '^1.19.0',
+        };
+        loadInstalledPacks({
+            engineVersion: '1.21.0',
+            inMemoryPacks: [{ pack: fakePack, callback: fakeCallback }],
+        });
+        expect(lookupChunker('rust-ast')).toBe(FakeChunker);
+        expect(registeredChunkerStrategies()).toContain('rust-ast');
+        expect(extensionToLanguage('.rs')).toBe('rust');
+        expect(registeredExtensions()).toContain('.rs');
+    });
+    it('seals both registries after every callback returns', () => {
+        const fakeCallback = (api) => {
+            api.registerChunkStrategy('rust-ast', FakeChunker);
+        };
+        const fakePack = {
+            name: '@totem/pack-rust-architecture',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: '^1.19.0',
+        };
+        loadInstalledPacks({
+            engineVersion: '1.21.0',
+            inMemoryPacks: [{ pack: fakePack, callback: fakeCallback }],
+        });
+        expect(isEngineSealed()).toBe(true);
+    });
+    it('rejects an async (Promise-returning) registration callback before sealing', () => {
+        const asyncCallback = (async (api) => {
+            api.registerChunkStrategy('async-strat', FakeChunker);
+        });
+        const fakePack = {
+            name: '@totem/pack-async',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: '^1.19.0',
+        };
+        let caught;
+        try {
+            loadInstalledPacks({
+                engineVersion: '1.21.0',
+                inMemoryPacks: [{ pack: fakePack, callback: asyncCallback }],
+            });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(Error);
+        expect(caught.message).toMatch(/registration must be synchronous/);
+        expect(caught.message).toMatch(/ADR-097 § 5 Q5/);
+        expect(isEngineSealed()).toBe(false);
+    });
+    it('throws and names the pack when callback throws', () => {
+        const errorThrowingCallback = () => {
+            throw new Error('pack-side bug');
+        };
+        const fakePack = {
+            name: '@totem/pack-broken',
+            resolvedPath: '/fake/path',
+            declaredEngineRange: '^1.19.0',
+        };
+        let caught;
+        try {
+            loadInstalledPacks({
+                engineVersion: '1.21.0',
+                inMemoryPacks: [{ pack: fakePack, callback: errorThrowingCallback }],
+            });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(Error);
+        const outer = caught;
+        expect(outer.message).toMatch(/Pack '@totem\/pack-broken' registration callback threw/);
+        expect(outer.message).toMatch(/must be fixed or removed/);
+        expect(outer.cause).toBeInstanceOf(Error);
+        expect(outer.cause.message).toBe('pack-side bug');
+    });
+    it('two packs registering same chunk strategy: second fails loud', () => {
+        const callback1 = (api) => {
+            api.registerChunkStrategy('shared', FakeChunker);
+        };
+        const callback2 = (api) => {
+            api.registerChunkStrategy('shared', FakeChunker);
+        };
+        let caught;
+        try {
+            loadInstalledPacks({
+                engineVersion: '1.21.0',
+                inMemoryPacks: [
+                    {
+                        pack: {
+                            name: '@totem/pack-a',
+                            resolvedPath: '/a',
+                            declaredEngineRange: '^1.19.0',
+                        },
+                        callback: callback1,
+                    },
+                    {
+                        pack: {
+                            name: '@totem/pack-b',
+                            resolvedPath: '/b',
+                            declaredEngineRange: '^1.19.0',
+                        },
+                        callback: callback2,
+                    },
+                ],
+            });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(Error);
+        expect(caught.message).toMatch(/Pack '@totem\/pack-b' registration callback threw/);
+        expect(caught.cause.message).toMatch(/already registered/);
+    });
+    it('two packs registering same extension to different langs: second fails loud', () => {
+        const callback1 = (api) => {
+            api.registerLanguage('.shared', 'lang-a', () => '/a.wasm');
+        };
+        const callback2 = (api) => {
+            api.registerLanguage('.shared', 'lang-b', () => '/b.wasm');
+        };
+        let caught;
+        try {
+            loadInstalledPacks({
+                engineVersion: '1.21.0',
+                inMemoryPacks: [
+                    {
+                        pack: {
+                            name: '@totem/pack-a',
+                            resolvedPath: '/a',
+                            declaredEngineRange: '^1.19.0',
+                        },
+                        callback: callback1,
+                    },
+                    {
+                        pack: {
+                            name: '@totem/pack-b',
+                            resolvedPath: '/b',
+                            declaredEngineRange: '^1.19.0',
+                        },
+                        callback: callback2,
+                    },
+                ],
+            });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(Error);
+        expect(caught.message).toMatch(/Pack '@totem\/pack-b' registration callback threw/);
+        expect(caught.cause.message).toMatch(/already registered to language/);
+    });
+});
+//# sourceMappingURL=pack-discovery.test.js.map

package/dist/pack-discovery.test.js.map

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

package/dist/pack-manifest-writer.d.ts

@@ -0,0 +1,88 @@
+/**
+ * `installed-packs.json` writer (mmnto-ai/totem#1768, Step 4).
+ *
+ * Walks two source surfaces — the consumer's `package.json` dependencies
+ * for `@totem/pack-*` entries, and the consumer's `totem.config.ts`
+ * `extends` array — deduplicates, resolves each pack's installed path
+ * via npm/pnpm semantics, and writes `.totem/installed-packs.json` for
+ * `pack-discovery.ts:loadInstalledPacks()` to consume at boot.
+ *
+ * Mismatch handling (ADR-097 § 5 Q4 + Open Question 4 disposition):
+ * - In both surfaces: union, no warning.
+ * - In `extends` only (declared but not resolvable via npm): emit a
+ *   warning naming the pack; skip from the manifest. Consumer must
+ *   `pnpm add` the pack to make it work.
+ * - In `package.json` only (resolvable but not declared in extends):
+ *   emit a warning; skip from the manifest. Pack-merge only consumes
+ *   `extends`-declared packs; including the dep-only entry would be
+ *   misleading.
+ *
+ * Atomic write semantics: the writer goes through a temp file +
+ * rename, mirroring `writeReviewExtensionsFile` (mmnto-ai/totem#1527).
+ *
+ * Filesystem access happens at the CLI boundary (this module is invoked
+ * by `syncCommand`); the resolver itself takes paths + content as
+ * inputs so tests can drive it without disk I/O.
+ */
+import type { TotemConfig } from './config-schema.js';
+import type { InstalledPacksManifest } from './pack-discovery.js';
+export interface PackResolutionWarning {
+    /** Pack name surfaced in the warning. */
+    readonly name: string;
+    /**
+     * Why the pack didn't make it to the manifest. Two shapes:
+     *
+     * - `dep-only`: present in package.json but not declared in
+     *   `totem.config.ts` `extends`. Skipped because pack-merge only
+     *   consumes `extends`-declared packs.
+     * - `extends-only`: declared in `extends` but not installed
+     *   (`require.resolve` failed). Skipped because the engine cannot
+     *   load it.
+     * - `not-a-pack`: present somewhere but doesn't expose a `register`
+     *   callback (default export or named `register` function). Skipped
+     *   because pack-discovery would throw on first attempt.
+     */
+    readonly reason: 'dep-only' | 'extends-only' | 'not-a-pack';
+}
+export interface PackResolutionResult {
+    /** Packs that landed in the manifest (sorted by name). */
+    readonly resolved: InstalledPacksManifest['packs'];
+    /** Per-pack warnings for the consumer (sorted by name). */
+    readonly warnings: readonly PackResolutionWarning[];
+}
+export interface ResolveInstalledPacksInput {
+    /** Project root (where `package.json` lives). */
+    readonly projectRoot: string;
+    /** Loaded totem config (read for `extends`). */
+    readonly config: TotemConfig;
+    /**
+     * Optional override for the package.json read. Tests pass a synthetic
+     * dependencies map; production callers leave it undefined and the
+     * function reads `<projectRoot>/package.json`.
+     */
+    readonly packageJsonDeps?: Readonly<Record<string, string>>;
+    /**
+     * Optional override for the require resolver. Tests stub this to
+     * resolve fixture packs without writing to `node_modules`; production
+     * callers use the default which delegates to `createRequire`.
+     */
+    readonly resolvePackPath?: (name: string, fromDir: string) => string | undefined;
+}
+/**
+ * Compute the deduplicated union of `package.json` `@totem/pack-*` deps
+ * and `totem.config.ts` `extends` entries. Returns the manifest payload
+ * shape ready for `installed-packs.json` plus per-pack warnings for any
+ * surface mismatch.
+ *
+ * Pure function — no filesystem write. The CLI integration calls
+ * `writeInstalledPacksManifest()` to persist.
+ */
+export declare function resolveInstalledPacks(input: ResolveInstalledPacksInput): PackResolutionResult;
+/**
+ * Atomically write `<totemDir>/installed-packs.json` with the given
+ * manifest payload. Mirrors `writeReviewExtensionsFile` semantics: temp
+ * file + rename so a concurrent boot-time read sees the old or new
+ * contents, never a partial write.
+ */
+export declare function writeInstalledPacksManifest(totemDirAbs: string, manifest: InstalledPacksManifest): string;
+//# sourceMappingURL=pack-manifest-writer.d.ts.map

package/dist/pack-manifest-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-manifest-writer.d.ts","sourceRoot":"","sources":["../src/pack-manifest-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;CAC7D;AAED,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAClF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,oBAAoB,CAkD7F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CASR"}

package/dist/pack-manifest-writer.js

@@ -0,0 +1,162 @@
+/**
+ * `installed-packs.json` writer (mmnto-ai/totem#1768, Step 4).
+ *
+ * Walks two source surfaces — the consumer's `package.json` dependencies
+ * for `@totem/pack-*` entries, and the consumer's `totem.config.ts`
+ * `extends` array — deduplicates, resolves each pack's installed path
+ * via npm/pnpm semantics, and writes `.totem/installed-packs.json` for
+ * `pack-discovery.ts:loadInstalledPacks()` to consume at boot.
+ *
+ * Mismatch handling (ADR-097 § 5 Q4 + Open Question 4 disposition):
+ * - In both surfaces: union, no warning.
+ * - In `extends` only (declared but not resolvable via npm): emit a
+ *   warning naming the pack; skip from the manifest. Consumer must
+ *   `pnpm add` the pack to make it work.
+ * - In `package.json` only (resolvable but not declared in extends):
+ *   emit a warning; skip from the manifest. Pack-merge only consumes
+ *   `extends`-declared packs; including the dep-only entry would be
+ *   misleading.
+ *
+ * Atomic write semantics: the writer goes through a temp file +
+ * rename, mirroring `writeReviewExtensionsFile` (mmnto-ai/totem#1527).
+ *
+ * Filesystem access happens at the CLI boundary (this module is invoked
+ * by `syncCommand`); the resolver itself takes paths + content as
+ * inputs so tests can drive it without disk I/O.
+ */
+import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+// ─── Resolver ───────────────────────────────────────
+const PACK_NAME_PREFIX = '@totem/pack-';
+/**
+ * Compute the deduplicated union of `package.json` `@totem/pack-*` deps
+ * and `totem.config.ts` `extends` entries. Returns the manifest payload
+ * shape ready for `installed-packs.json` plus per-pack warnings for any
+ * surface mismatch.
+ *
+ * Pure function — no filesystem write. The CLI integration calls
+ * `writeInstalledPacksManifest()` to persist.
+ */
+export function resolveInstalledPacks(input) {
+    const deps = input.packageJsonDeps ?? readPackageJsonDeps(input.projectRoot);
+    const extendsList = (input.config.extends ?? []).filter((name) => name.startsWith(PACK_NAME_PREFIX));
+    const depPackNames = Object.keys(deps).filter((name) => name.startsWith(PACK_NAME_PREFIX)); // totem-context: Object.keys() returns strings; not fileGlobs ast-grep object form
+    const extendsSet = new Set(extendsList);
+    const depsSet = new Set(depPackNames);
+    const union = new Set([...extendsSet, ...depsSet]);
+    const warnings = [];
+    const resolved = [];
+    for (const name of [...union].sort()) {
+        if (!extendsSet.has(name)) {
+            // Resolvable dep that the consumer hasn't opted into via `extends`.
+            // Pack-merge only consumes extends-declared packs, so this pack
+            // would never have its rules merged anyway. Skip with a warning.
+            warnings.push({ name, reason: 'dep-only' });
+            continue;
+        }
+        if (!depsSet.has(name)) {
+            // Declared in extends but not installed via package manager.
+            // Cannot resolve a path; skip with a warning.
+            warnings.push({ name, reason: 'extends-only' });
+            continue;
+        }
+        const resolver = input.resolvePackPath ?? defaultResolvePackPath;
+        const resolvedPath = resolver(name, input.projectRoot);
+        if (!resolvedPath) {
+            warnings.push({ name, reason: 'extends-only' });
+            continue;
+        }
+        const declaredEngineRange = readPeerEngineRange(resolvedPath);
+        if (!declaredEngineRange) {
+            warnings.push({ name, reason: 'not-a-pack' });
+            continue;
+        }
+        resolved.push({
+            name,
+            resolvedPath,
+            declaredEngineRange,
+        });
+    }
+    return { resolved, warnings };
+}
+/**
+ * Atomically write `<totemDir>/installed-packs.json` with the given
+ * manifest payload. Mirrors `writeReviewExtensionsFile` semantics: temp
+ * file + rename so a concurrent boot-time read sees the old or new
+ * contents, never a partial write.
+ */
+export function writeInstalledPacksManifest(totemDirAbs, manifest) {
+    if (!fs.existsSync(totemDirAbs)) {
+        fs.mkdirSync(totemDirAbs, { recursive: true });
+    }
+    const finalPath = path.join(totemDirAbs, 'installed-packs.json');
+    const tmpPath = finalPath + '.tmp';
+    fs.writeFileSync(tmpPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+    fs.renameSync(tmpPath, finalPath);
+    return finalPath;
+}
+// ─── Internal helpers ───────────────────────────────
+function readPackageJsonDeps(projectRoot) {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return {};
+    let parsed;
+    // totem-context: intentional cleanup — package.json missing/corrupt is non-fatal to sync; treat as no deps
+    try {
+        parsed = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')); // totem-context: sync read at boot; sync command is itself synchronous CLI top-level
+    }
+    catch {
+        return {};
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return {};
+    const obj = parsed;
+    const out = {};
+    for (const field of ['dependencies', 'devDependencies']) {
+        const section = obj[field];
+        if (typeof section !== 'object' || section === null)
+            continue;
+        for (const [name, value] of Object.entries(section)) {
+            if (typeof value === 'string')
+                out[name] = value;
+        }
+    }
+    return out;
+}
+function defaultResolvePackPath(name, fromDir) {
+    // We resolve from the project root rather than from this module — packs
+    // live in the consumer's node_modules, not core's.
+    const require = createRequire(path.join(fromDir, 'package.json'));
+    try {
+        // Resolve to the package's package.json so the directory containing it
+        // is the pack's package root. require.resolve(name) would land on the
+        // package's `main` entry, which isn't what pack-discovery wants.
+        const pkgJsonPath = require.resolve(`${name}/package.json`);
+        return path.dirname(pkgJsonPath); // totem-context: intentional cleanup — unresolvable pack returns undefined to flow into the `extends-only` warning path
+    }
+    catch {
+        return undefined;
+    }
+}
+function readPeerEngineRange(packResolvedPath) {
+    const pkgPath = path.join(packResolvedPath, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return undefined;
+    let parsed;
+    // totem-context: intentional cleanup — corrupted pack package.json returns undefined to flow into the `not-a-pack` warning path
+    try {
+        parsed = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')); // totem-context: sync read at boot; sync command is itself synchronous CLI top-level
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const peer = parsed.peerDependencies; // totem-context: parsed was narrowed via `typeof !== 'object' || === null` guard above; the cast is for index access into already-validated JSON
+    if (typeof peer !== 'object' || peer === null)
+        return undefined;
+    const range = peer['@mmnto/totem']; // totem-context: peer was narrowed via `typeof !== 'object' || === null` guard above; the cast is for index access; result is runtime-checked via `typeof range === 'string'` below
+    return typeof range === 'string' ? range : undefined;
+}
+//# sourceMappingURL=pack-manifest-writer.js.map

package/dist/pack-manifest-writer.js.map

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

package/dist/pack-manifest-writer.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tests for pack manifest resolution + writer (mmnto-ai/totem#1768
+ * Step 4, Q4 disposition).
+ *
+ * Covers invariant 18 from `.totem/specs/pack-substrate-bundle.md`:
+ *
+ * - Resolves a pack present in BOTH `package.json` deps AND
+ *   `totem.config.ts` `extends` → manifest entry, no warning.
+ * - Resolves a pack only in deps → no manifest entry, `dep-only` warning.
+ * - Resolves a pack only in extends → no manifest entry, `extends-only` warning.
+ * - Pack without `peerDependencies['@mmnto/totem']` → `not-a-pack` warning.
+ * - Atomic write produces a stable JSON file.
+ */
+export {};
+//# sourceMappingURL=pack-manifest-writer.test.d.ts.map

package/dist/pack-manifest-writer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-manifest-writer.test.d.ts","sourceRoot":"","sources":["../src/pack-manifest-writer.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}