@sharpee/devkit 1.0.0

package/commands/bundle.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBundle = runBundle;
+/**
+ * bundle.ts — `devkit bundle`: assemble the CLI platform bundle `dist/cli/sharpee.js`
+ * by running the exact esbuild command build.sh uses (build_bundle, 580-630).
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3). Byte-for-byte parity with
+ * build.sh is the contract — the esbuild flag list and alias order are verbatim.
+ *
+ * Public interface: runBundle(opts) -> void. Throws if the bundle is absent/empty
+ * after esbuild (the no-silent-✓ invariant).
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const repo_1 = require("../repo");
+/** Assemble dist/cli/sharpee.js + sharpee.d.ts. Assumes platform packages are built. */
+function runBundle(opts = {}) {
+    const root = opts.root ?? (0, repo_1.findRepoRoot)();
+    const log = (m) => !opts.quiet && console.log(m);
+    log('=== Bundling -> dist/cli/sharpee.js ===');
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(root, 'dist', 'cli'), { recursive: true });
+    const args = [
+        'esbuild',
+        'scripts/bundle-entry.js',
+        '--bundle',
+        '--platform=node',
+        '--target=node18',
+        '--outfile=dist/cli/sharpee.js',
+        '--external:readline',
+        '--format=cjs',
+        '--sourcemap',
+        ...repo_1.BUNDLE_ALIASES.map(([name, path]) => `--alias:${name}=${path}`),
+    ];
+    (0, node_child_process_1.execFileSync)('npx', args, { cwd: root, stdio: opts.quiet ? 'ignore' : 'inherit' });
+    // Hand-written declarations (verbatim build.sh heredoc).
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(root, 'dist', 'cli', 'sharpee.d.ts'), repo_1.BUNDLE_DTS);
+    // Invariant: assert the artifact exists and is non-empty (no silent success on a no-op build).
+    const out = (0, node_path_1.join)(root, 'dist', 'cli', 'sharpee.js');
+    if (!(0, node_fs_1.existsSync)(out) || (0, node_fs_1.statSync)(out).size === 0) {
+        throw new Error('bundle failed: dist/cli/sharpee.js is missing or empty after esbuild');
+    }
+    log(`bundle: dist/cli/sharpee.js (${(0, node_fs_1.statSync)(out).size} bytes)`);
+}
+//# sourceMappingURL=bundle.js.map

package/commands/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/devkit/src/commands/bundle.ts"],"names":[],"mappings":";;AAuBA,8BA8BC;AArDD;;;;;;;;;GASG;AACH,2DAAkD;AAClD,qCAAyE;AACzE,yCAAiC;AACjC,kCAAmE;AASnE,wFAAwF;AACxF,SAAgB,SAAS,CAAC,OAAsB,EAAE;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,mBAAY,GAAE,CAAC;IACzC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAE/C,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,MAAM,IAAI,GAAG;QACX,SAAS;QACT,yBAAyB;QACzB,UAAU;QACV,iBAAiB;QACjB,iBAAiB;QACjB,+BAA+B;QAC/B,qBAAqB;QACrB,cAAc;QACd,aAAa;QACb,GAAG,qBAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC;KACnE,CAAC;IACF,IAAA,iCAAY,EAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAEnF,yDAAyD;IACzD,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE,iBAAU,CAAC,CAAC;IAErE,+FAA+F;IAC/F,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,IAAA,oBAAU,EAAC,GAAG,CAAC,IAAI,IAAA,kBAAQ,EAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,GAAG,CAAC,gCAAgC,IAAA,kBAAQ,EAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;AACnE,CAAC"}

package/commands/clean.d.ts

@@ -0,0 +1,7 @@
+export interface CleanOptions {
+    root?: string;
+    quiet?: boolean;
+}
+/** Run every package's `clean` script, then remove the top-level `dist/`. */
+export declare function runClean(opts?: CleanOptions): void;
+//# sourceMappingURL=clean.d.ts.map

package/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/clean.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,GAAE,YAAiB,GAAG,IAAI,CAYtD"}

package/commands/clean.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runClean = runClean;
+/**
+ * clean.ts — `devkit clean`: build-artifact hygiene.
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3d). Removes the artifact classes
+ * that caused silent no-op builds (stale .tsbuildinfo) and stale dist trees, by
+ * running each package's own `clean` script plus wiping the top-level bundle dir.
+ *
+ * Public interface: runClean(opts) -> void.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const repo_1 = require("../repo");
+/** Run every package's `clean` script, then remove the top-level `dist/`. */
+function runClean(opts = {}) {
+    const root = opts.root ?? (0, repo_1.findRepoRoot)();
+    const log = (m) => !opts.quiet && console.log(m);
+    log('=== devkit clean ===');
+    // Each package's clean removes dist/, dist-esm/, tsconfig.tsbuildinfo (2026-06-17 fix).
+    (0, node_child_process_1.execFileSync)('pnpm', ['-r', '--if-present', 'run', 'clean'], {
+        cwd: root,
+        stdio: opts.quiet ? 'ignore' : 'inherit',
+    });
+    // Top-level bundle/client outputs are not owned by any package's clean.
+    (0, node_fs_1.rmSync)((0, node_path_1.join)(root, 'dist'), { recursive: true, force: true });
+    log('clean: per-package artifacts + top-level dist/ removed');
+}
+//# sourceMappingURL=clean.js.map

package/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/devkit/src/commands/clean.ts"],"names":[],"mappings":";;AAoBA,4BAYC;AAhCD;;;;;;;;GAQG;AACH,2DAAkD;AAClD,qCAAiC;AACjC,yCAAiC;AACjC,kCAAuC;AAOvC,6EAA6E;AAC7E,SAAgB,QAAQ,CAAC,OAAqB,EAAE;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,mBAAY,GAAE,CAAC;IACzC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC5B,wFAAwF;IACxF,IAAA,iCAAY,EAAC,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;QAC3D,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACzC,CAAC,CAAC;IACH,wEAAwE;IACxE,IAAA,gBAAM,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,GAAG,CAAC,wDAAwD,CAAC,CAAC;AAChE,CAAC"}

package/commands/register.d.ts

@@ -0,0 +1,5 @@
+/** `sharpee register <location> [--name <n>]` — upsert a name→path mapping. */
+export declare function runRegister(args: string[]): void;
+/** `sharpee list` — show registered stories, flagging stale entries. */
+export declare function runList(): void;
+//# sourceMappingURL=register.d.ts.map

package/commands/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/register.ts"],"names":[],"mappings":"AAWA,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAYhD;AAED,wEAAwE;AACxE,wBAAgB,OAAO,IAAI,IAAI,CAU9B"}

package/commands/register.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRegister = runRegister;
+exports.runList = runList;
+/**
+ * register.ts — `sharpee register <location>` and `sharpee list` (ADR-180 Decision 4,
+ * amended: the location-registry verb is `register`).
+ *
+ * Owner context: @sharpee/devkit. Convenience over the `~/.sharpee/devkit` registry so
+ * a story (anywhere) can be referenced by name. Pure orchestration over registry.ts.
+ *
+ * Public interface: runRegister(args), runList().
+ */
+const registry_1 = require("../registry");
+/** `sharpee register <location> [--name <n>]` — upsert a name→path mapping. */
+function runRegister(args) {
+    let location;
+    let name;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--name')
+            name = args[++i];
+        else if (!args[i].startsWith('-') && !location)
+            location = args[i];
+        else
+            throw new Error(`unexpected argument: ${args[i]}`);
+    }
+    if (!location)
+        throw new Error('register requires a <location>');
+    const entry = (0, registry_1.registerStory)(location, name);
+    console.log(`registered '${entry.name}' → ${entry.path}`);
+    console.log(`(${(0, registry_1.registryPath)()})`);
+}
+/** `sharpee list` — show registered stories, flagging stale entries. */
+function runList() {
+    const entries = (0, registry_1.listStories)();
+    if (entries.length === 0) {
+        console.log('No registered stories. Use `sharpee register <location>`.');
+        return;
+    }
+    const width = Math.max(...entries.map((e) => e.name.length));
+    for (const e of entries) {
+        console.log(`  ${e.name.padEnd(width)}  ${e.path}${e.stale ? '   [STALE: path missing]' : ''}`);
+    }
+}
+//# sourceMappingURL=register.js.map

package/commands/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/devkit/src/commands/register.ts"],"names":[],"mappings":";;AAYA,kCAYC;AAGD,0BAUC;AArCD;;;;;;;;GAQG;AACH,0CAAuE;AAEvE,+EAA+E;AAC/E,SAAgB,WAAW,CAAC,IAAc;IACxC,IAAI,QAA4B,CAAC;IACjC,IAAI,IAAwB,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ;YAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;;YAC9D,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAA,wBAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,IAAI,IAAA,uBAAY,GAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,wEAAwE;AACxE,SAAgB,OAAO;IACrB,MAAM,OAAO,GAAG,IAAA,sBAAW,GAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}

package/commands/test-npm.d.ts

@@ -0,0 +1,34 @@
+/** Default staging dir written by `tsf build --npm`. */
+export declare const DEFAULT_STAGING: string;
+export interface TestNpmOptions {
+    /** Story location (a directory containing package.json + src/). */
+    location: string;
+    /** 'local' (default) packs ~/.tsf-publish tarballs; 'registry' installs published versions. */
+    mode?: 'local' | 'registry';
+    /** Override the staging dir (local mode). Defaults to ~/.tsf-publish/sharpee. */
+    stagingDir?: string;
+    /** Glob of transcripts relative to location (default `tests/transcripts/*.transcript`). */
+    transcripts?: string;
+    /** Run transcripts as one stateful chain (dungeo walkthroughs) instead of per-file. */
+    chain?: boolean;
+    /** Compile only; skip transcript execution. */
+    quick?: boolean;
+    /** Registry version/range for @sharpee deps (registry mode; default 'latest'). */
+    registryVersion?: string;
+    /** Keep the temp dir for debugging (default false). */
+    keep?: boolean;
+}
+export interface TestNpmResult {
+    passed: number;
+    failed: number;
+    failures: string[];
+    /** false when --quick (compilation only). */
+    ran: boolean;
+}
+/**
+ * Stand up the consumer, install, compile, and run the story's transcripts.
+ * @throws if the location is not a story (no package.json or no src/), or if
+ *         install/compile fails.
+ */
+export declare function runTestNpm(opts: TestNpmOptions): TestNpmResult;
+//# sourceMappingURL=test-npm.d.ts.map

package/commands/test-npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-npm.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/test-npm.ts"],"names":[],"mappings":"AAiBA,wDAAwD;AACxD,eAAO,MAAM,eAAe,QAA6C,CAAC;AA0B1E,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6CAA6C;IAC7C,GAAG,EAAE,OAAO,CAAC;CACd;AAmBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAwF9D"}

package/commands/test-npm.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STAGING = void 0;
+exports.runTestNpm = runTestNpm;
+/**
+ * test-npm.ts — `devkit test:npm <location>`: stand up an isolated consumer
+ * project for a story, install its `@sharpee/*` closure (local staging tarballs
+ * or registry), compile it, and run its transcripts.
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 2). One parameterized command that
+ * replaces npm-test/, npm-test-dungeo/, and npm-test-familyzoo/ (AC-4).
+ *
+ * Public interface: runTestNpm(opts) -> TestNpmResult. The CLI maps the result to
+ * an exit code; tests assert on the returned counts.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const consumer_gen_1 = require("../consumer-gen");
+/** Default staging dir written by `tsf build --npm`. */
+exports.DEFAULT_STAGING = (0, node_path_1.join)((0, node_os_1.homedir)(), '.tsf-publish', 'sharpee');
+/** Story source files that are platform/UI entry points, never part of an npm consumer build. */
+const EXCLUDED_SRC = ['browser-entry.ts', 'react-entry.tsx'];
+/** The generated consumer tsconfig (inlined — it is a generated artifact, never edited). */
+const CONSUMER_TSCONFIG = {
+    compilerOptions: {
+        target: 'ES2022',
+        module: 'CommonJS',
+        moduleResolution: 'node',
+        lib: ['ES2022', 'DOM'],
+        outDir: 'dist',
+        rootDir: 'src',
+        strict: true,
+        esModuleInterop: true,
+        skipLibCheck: true,
+        declaration: false,
+        sourceMap: true,
+        forceConsistentCasingInFileNames: true,
+        resolveJsonModule: true,
+    },
+    include: ['src/**/*'],
+    exclude: ['node_modules', 'dist', 'src/browser-entry.ts', 'src/react-entry.tsx', 'src/**/*.test.ts'],
+};
+/**
+ * Expand a `dir/<glob>` pattern (single `*` wildcard in the filename) against
+ * `location`. Returns absolute paths sorted by name.
+ */
+function expandGlob(location, pattern) {
+    const slash = pattern.lastIndexOf('/');
+    const dir = slash >= 0 ? pattern.slice(0, slash) : '.';
+    const filePat = slash >= 0 ? pattern.slice(slash + 1) : pattern;
+    const abs = (0, node_path_1.join)(location, dir);
+    if (!(0, node_fs_1.existsSync)(abs))
+        return [];
+    const re = new RegExp('^' + filePat.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*') + '$');
+    return (0, node_fs_1.readdirSync)(abs)
+        .filter((f) => re.test(f))
+        .sort()
+        .map((f) => (0, node_path_1.join)(abs, f));
+}
+/**
+ * Stand up the consumer, install, compile, and run the story's transcripts.
+ * @throws if the location is not a story (no package.json or no src/), or if
+ *         install/compile fails.
+ */
+function runTestNpm(opts) {
+    const { location } = opts;
+    const mode = opts.mode ?? 'local';
+    const stagingDir = opts.stagingDir ?? exports.DEFAULT_STAGING;
+    const transcriptGlob = opts.transcripts ?? 'tests/transcripts/*.transcript';
+    const storyPkgPath = (0, node_path_1.join)(location, 'package.json');
+    if (!(0, node_fs_1.existsSync)(storyPkgPath))
+        throw new Error(`no package.json at story location: ${location}`);
+    if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(location, 'src')))
+        throw new Error(`no src/ at story location: ${location}`);
+    const tmp = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'devkit-npm-'));
+    const log = (m) => console.log(m);
+    try {
+        log(`=== devkit test:npm — ${(0, node_path_1.basename)(location)} (${mode}) ===`);
+        log(`temp: ${tmp}`);
+        // 1. Generate the consumer package.json (+ vendor tarballs for local mode).
+        const vendor = (0, node_path_1.join)(tmp, 'vendor');
+        (0, node_fs_1.mkdirSync)(vendor, { recursive: true });
+        const { closure, haveTranscriptTester } = (0, consumer_gen_1.generateConsumer)({
+            mode,
+            storyPkgPath,
+            stagingDir,
+            vendorDir: vendor,
+            outPkgPath: (0, node_path_1.join)(tmp, 'package.json'),
+            registryVersion: opts.registryVersion,
+        });
+        log(`closure (${closure.length}): ${closure.map((n) => n.replace('@sharpee/', '')).join(', ')}`);
+        if (!haveTranscriptTester) {
+            throw new Error('@sharpee/transcript-tester missing from staging — cannot run transcripts');
+        }
+        // 2. Copy story src (minus platform entry points) + tsconfig.
+        (0, node_fs_1.cpSync)((0, node_path_1.join)(location, 'src'), (0, node_path_1.join)(tmp, 'src'), { recursive: true });
+        for (const f of EXCLUDED_SRC)
+            (0, node_fs_1.rmSync)((0, node_path_1.join)(tmp, 'src', f), { force: true });
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(tmp, 'tsconfig.json'), JSON.stringify(CONSUMER_TSCONFIG, null, 2) + '\n');
+        // 3. Copy transcripts.
+        const transcripts = expandGlob(location, transcriptGlob);
+        if (!opts.quick && transcripts.length === 0) {
+            throw new Error(`no transcripts matched '${transcriptGlob}' under ${location}`);
+        }
+        const tDir = (0, node_path_1.join)(tmp, 'transcripts');
+        (0, node_fs_1.mkdirSync)(tDir, { recursive: true });
+        for (const t of transcripts)
+            (0, node_fs_1.cpSync)(t, (0, node_path_1.join)(tDir, (0, node_path_1.basename)(t)));
+        // 4. Install + compile.
+        const run = (cmd, args) => (0, node_child_process_1.execFileSync)(cmd, args, { cwd: tmp, stdio: 'inherit' });
+        log('--- npm install ---');
+        run('npm', ['install', '--no-fund', '--no-audit']);
+        log('--- tsc ---');
+        run('npx', ['tsc']);
+        if (opts.quick) {
+            log('compile-only (--quick) — OK');
+            return { passed: 0, failed: 0, failures: [], ran: false };
+        }
+        // 5. Run transcripts (chain = one stateful invocation; else per-file count).
+        log('--- transcripts ---');
+        const rel = transcripts.map((t) => (0, node_path_1.join)('transcripts', (0, node_path_1.basename)(t)));
+        if (opts.chain) {
+            try {
+                run('npx', ['transcript-test', '.', '--chain', ...rel]);
+                return { passed: transcripts.length, failed: 0, failures: [], ran: true };
+            }
+            catch {
+                return { passed: 0, failed: transcripts.length, failures: ['chain'], ran: true };
+            }
+        }
+        let passed = 0;
+        const failures = [];
+        for (const r of rel) {
+            try {
+                run('npx', ['transcript-test', '.', r]);
+                passed++;
+            }
+            catch {
+                failures.push((0, node_path_1.basename)(r, '.transcript'));
+            }
+        }
+        return { passed, failed: failures.length, failures, ran: true };
+    }
+    finally {
+        if (opts.keep) {
+            console.log(`(kept temp dir: ${tmp})`);
+        }
+        else {
+            (0, node_fs_1.rmSync)(tmp, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=test-npm.js.map

package/commands/test-npm.js.map

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

package/commands/verify.d.ts

@@ -0,0 +1,7 @@
+export interface VerifyOptions {
+    root?: string;
+    quiet?: boolean;
+}
+/** Build the npm staging (`tsf build --npm`) and dry-run the beta publish. */
+export declare function runVerify(opts?: VerifyOptions): void;
+//# sourceMappingURL=verify.d.ts.map

package/commands/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/verify.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,IAAI,CAWxD"}

package/commands/verify.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runVerify = runVerify;
+/**
+ * verify.ts — `devkit verify`: publish verification.
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3d). Replaces the dead `publish:beta`
+ * chain: builds the npm output via tsf and dry-runs the publish, so the staged
+ * packages are proven installable/publishable without releasing.
+ *
+ * Public interface: runVerify(opts) -> void.
+ */
+const node_child_process_1 = require("node:child_process");
+const repo_1 = require("../repo");
+/** Build the npm staging (`tsf build --npm`) and dry-run the beta publish. */
+function runVerify(opts = {}) {
+    const root = opts.root ?? (0, repo_1.findRepoRoot)();
+    const tsf = (0, repo_1.tsfBin)(root);
+    const log = (m) => !opts.quiet && console.log(m);
+    const stdio = opts.quiet ? 'ignore' : 'inherit';
+    log('=== devkit verify: tsf build --npm ===');
+    (0, node_child_process_1.execFileSync)(tsf, ['build', '--npm'], { cwd: root, stdio });
+    log('=== devkit verify: tsf publish --tag beta --dry-run ===');
+    (0, node_child_process_1.execFileSync)(tsf, ['publish', '--tag', 'beta', '--dry-run'], { cwd: root, stdio });
+    log('verify: npm build + publish dry-run OK');
+}
+//# sourceMappingURL=verify.js.map

package/commands/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/devkit/src/commands/verify.ts"],"names":[],"mappings":";;AAkBA,8BAWC;AA7BD;;;;;;;;GAQG;AACH,2DAAkD;AAClD,kCAA+C;AAO/C,8EAA8E;AAC9E,SAAgB,SAAS,CAAC,OAAsB,EAAE;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,mBAAY,GAAE,CAAC;IACzC,MAAM,GAAG,GAAG,IAAA,aAAM,EAAC,IAAI,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhD,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAC9C,IAAA,iCAAY,EAAC,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,GAAG,CAAC,yDAAyD,CAAC,CAAC;IAC/D,IAAA,iCAAY,EAAC,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAChD,CAAC"}

package/commands/zifmia.d.ts

@@ -0,0 +1,10 @@
+export interface ZifmiaBuildOptions {
+    quiet?: boolean;
+}
+/**
+ * Build the zifmia server and surface the Story Runtime Baseline version (for the
+ * operator's `docker build --build-arg BASELINE_VERSION=`).
+ * @throws if tools/zifmia is absent or the build produces no dist/.
+ */
+export declare function buildZifmiaServer(root: string, opts?: ZifmiaBuildOptions): void;
+//# sourceMappingURL=zifmia.d.ts.map

package/commands/zifmia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zifmia.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/zifmia.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,IAAI,CAgCnF"}

package/commands/zifmia.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildZifmiaServer = buildZifmiaServer;
+/**
+ * zifmia.ts — `devkit build --zifmia`: build the corrected multi-user server
+ * (ADR-177) at tools/zifmia/ (build.sh build_zifmia_server, 996-1032).
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3c). devkit invokes the zifmia
+ * package's own build verbatim (`pnpm --filter @sharpee/zifmia build`) — it does
+ * not reimplement it. Per ADR-180 the `.sharpee` story bundle is deferred, so this
+ * target does not build one.
+ *
+ * Public interface: buildZifmiaServer(root, opts) -> void.
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Build the zifmia server and surface the Story Runtime Baseline version (for the
+ * operator's `docker build --build-arg BASELINE_VERSION=`).
+ * @throws if tools/zifmia is absent or the build produces no dist/.
+ */
+function buildZifmiaServer(root, opts = {}) {
+    const log = (m) => !opts.quiet && console.log(m);
+    const zifmiaDir = (0, node_path_1.join)(root, 'tools', 'zifmia');
+    if (!(0, node_fs_1.existsSync)(zifmiaDir))
+        throw new Error('tools/zifmia not found');
+    log('=== Building zifmia (multi-user server, ADR-177) ===');
+    (0, node_child_process_1.execFileSync)('pnpm', ['--filter', '@sharpee/zifmia', 'build'], {
+        cwd: root,
+        stdio: opts.quiet ? 'ignore' : 'inherit',
+    });
+    // ADR-178 §AC-3: surface the baseline version sourced from the built manifest.
+    const baselineMod = (0, node_path_1.join)(root, 'packages', 'story-runtime-baseline', 'dist', 'index.js');
+    if ((0, node_fs_1.existsSync)(baselineMod)) {
+        try {
+            const ver = (0, node_child_process_1.execFileSync)('node', ['-p', `require(${JSON.stringify(baselineMod)}).BASELINE_VERSION`], {
+                cwd: root,
+                encoding: 'utf8',
+            }).trim();
+            if (ver) {
+                log(`Story Runtime Baseline: v${ver}`);
+                log(`  (docker build expects --build-arg BASELINE_VERSION=${ver}; docker-compose.yml does this automatically)`);
+            }
+        }
+        catch {
+            /* baseline version is informational only — never fail the build over it */
+        }
+    }
+    // Invariant: assert the server dist exists (no silent success).
+    const dist = (0, node_path_1.join)(zifmiaDir, 'dist');
+    if (!(0, node_fs_1.existsSync)(dist))
+        throw new Error('zifmia build produced no tools/zifmia/dist/');
+    log('Output: tools/zifmia/dist/');
+}
+//# sourceMappingURL=zifmia.js.map

package/commands/zifmia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zifmia.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/devkit/src/commands/zifmia.ts"],"names":[],"mappings":";;AAwBA,8CAgCC;AAxDD;;;;;;;;;;GAUG;AACH,2DAAkD;AAClD,qCAAqC;AACrC,yCAAiC;AAMjC;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,IAAY,EAAE,OAA2B,EAAE;IAC3E,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,IAAA,oBAAU,EAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAEtE,GAAG,CAAC,sDAAsD,CAAC,CAAC;IAC5D,IAAA,iCAAY,EAAC,MAAM,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE;QAC7D,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACzC,CAAC,CAAC;IAEH,+EAA+E;IAC/E,MAAM,WAAW,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACzF,IAAI,IAAA,oBAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAA,iCAAY,EAAC,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,oBAAoB,CAAC,EAAE;gBACnG,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;gBACvC,GAAG,CAAC,wDAAwD,GAAG,+CAA+C,CAAC,CAAC;YAClH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACtF,GAAG,CAAC,4BAA4B,CAAC,CAAC;AACpC,CAAC"}

package/consumer-gen.d.ts

@@ -0,0 +1,49 @@
+export type StagingMap = Record<string, string>;
+/**
+ * Map `@sharpee/<x>` package name -> its staging subdirectory. The directory name
+ * is not assumed to equal the short package name, so each package.json is read.
+ * @throws if stagingDir does not exist.
+ */
+export declare function scanStaging(stagingDir: string): StagingMap;
+/** The story's directly-declared `@sharpee/*` dependencies (the closure seed). */
+export declare function readSharpeeSeed(storyPkgPath: string): string[];
+/**
+ * Transitive closure over `@sharpee/*` deps. Pure: `depsOf(name)` returns the
+ * `@sharpee/*` deps of `name`. Returns every reachable package including the seed.
+ */
+export declare function computeClosure(seed: string[], depsOf: (name: string) => string[]): Set<string>;
+/** `depsOf` backed by the staging map — only deps present in staging are followed. */
+export declare function stagingDepsOf(stagingDir: string, staging: StagingMap, name: string): string[];
+export interface GenerateConsumerOptions {
+    /** 'local' packs the full closure as tarballs from staging; 'registry' declares seed deps. */
+    mode: 'local' | 'registry';
+    /** Path to the story's package.json (source of the seed deps). */
+    storyPkgPath: string;
+    /** `~/.tsf-publish/sharpee` — the `tsf build --npm` output (local mode only). */
+    stagingDir: string;
+    /** Directory to write tarballs into (local mode only). */
+    vendorDir: string;
+    /** Where the generated consumer package.json is written. */
+    outPkgPath: string;
+    /** Registry version/range for `@sharpee/*` deps in registry mode (default 'latest'). */
+    registryVersion?: string;
+}
+export interface GenerateConsumerResult {
+    /** Packages written as runtime deps (full closure in local mode; seed in registry mode). */
+    closure: string[];
+    /** true if transcript-tester is available as a dev dep (always true in registry mode). */
+    haveTranscriptTester: boolean;
+}
+/**
+ * Generate the consumer package.json.
+ *
+ * Local mode packs the story's **full transitive `@sharpee` closure** into tarballs
+ * and `file:`-refs them — required because `file:` deps do not resolve their own
+ * `@sharpee` deps from anywhere. Registry mode declares only the story's **seed**
+ * `@sharpee` deps and lets npm resolve transitive deps from the registry, exactly
+ * as a real consumer install would (avoids staging-vs-registry graph divergence).
+ *
+ * @throws (local mode) if any seed dep is absent from the local staging.
+ */
+export declare function generateConsumer(opts: GenerateConsumerOptions): GenerateConsumerResult;
+//# sourceMappingURL=consumer-gen.d.ts.map

package/consumer-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-gen.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/devkit/src/consumer-gen.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAa1D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAU9F;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK7F;AAED,MAAM,WAAW,uBAAuB;IACtC,8FAA8F;IAC9F,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,4FAA4F;IAC5F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0FAA0F;IAC1F,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CAwDtF"}