@sharpee/devkit 1.0.0

package/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/devkit/src/cli.ts"],"names":[],"mappings":""}

package/cli.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * cli.ts — the `sharpee` command (ADR-180; engine package @sharpee/devkit).
+ *
+ * Owner context: the single Sharpee build/test/scaffold CLI. `build` is
+ * **location-aware** — inside the monorepo it builds platform + bundle + in-repo
+ * stories; in a standalone author project it builds that project's story via its
+ * own toolchain (+ .sharpee + browser).
+ *
+ * Public interface: process argv -> subcommand dispatch -> process exit code.
+ */
+const test_npm_1 = require("./commands/test-npm");
+const build_1 = require("./commands/build");
+const bundle_1 = require("./commands/bundle");
+const clean_1 = require("./commands/clean");
+const verify_1 = require("./commands/verify");
+const repo_1 = require("./repo");
+// Standalone (author-project) commands, absorbed from the former @sharpee/sharpee CLI.
+const build_2 = require("./standalone/build");
+const build_browser_1 = require("./standalone/build-browser");
+const init_1 = require("./standalone/init");
+const init_browser_1 = require("./standalone/init-browser");
+const ifid_1 = require("./standalone/ifid");
+const register_1 = require("./commands/register");
+const registry_1 = require("./registry");
+const node_fs_1 = require("node:fs");
+const USAGE = `sharpee — Interactive Fiction build/test/scaffold CLI (ADR-180)
+
+Usage:
+  sharpee build [story|path] [options]   Build a story (location-aware: monorepo vs standalone)
+  sharpee build-browser [options]        Build the browser client only
+  sharpee init <name>                    Scaffold a new story project
+  sharpee init-browser                   Add a browser client to the current project
+  sharpee ifid                           IFID utilities (generate, validate)
+  sharpee bundle                         (monorepo) Assemble dist/cli/sharpee.js
+  sharpee clean                          Remove build artifacts (dist, dist-esm, tsbuildinfo)
+  sharpee verify                         tsf build --npm + publish dry-run
+  sharpee test:npm <loc|name> [options]  Stand up an npm consumer for a story and run its transcripts
+  sharpee register <location> [--name]   Register a name→path mapping in ~/.sharpee/devkit
+  sharpee list                           List registered stories
+
+build (monorepo) options:
+  [story|path]            In-repo story name or path (stories/<n>, tutorials/<n>, or a directory)
+  --browser               Also build the self-contained browser client (dist/web/<story>/)
+  --zifmia                Also build the zifmia multi-user server (tools/zifmia/dist/)
+  --skip <pkg>            Resume the platform build from this package short-name
+  --version <v> | --build-date <iso> | --no-version | --no-genai | --no-bundle | --esm
+
+build (standalone, in an author project): compiles src/ + emits the .sharpee bundle and
+  browser client. --test also runs the project's transcripts.
+
+test:npm options:
+  --local [default] | --registry | --version <range> | --staging <dir>
+  --transcripts <glob> | --chain | --quick | --keep
+
+Reserved (later): test, play, bundle:story`;
+/** Parse the monorepo `build` flags (positional [story] + options). */
+function parseBuild(args) {
+    const opts = {};
+    let i = 0;
+    while (i < args.length) {
+        const a = args[i];
+        if (a === '--skip')
+            opts.skipTo = args[++i];
+        else if (a === '--version')
+            opts.version = args[++i];
+        else if (a === '--build-date')
+            opts.buildDate = args[++i];
+        else if (a === '--no-version')
+            opts.noVersion = true;
+        else if (a === '--no-genai')
+            opts.noGenai = true;
+        else if (a === '--no-bundle')
+            opts.bundle = false;
+        else if (a === '--esm')
+            opts.esm = true;
+        else if (a === '--browser')
+            opts.browser = true;
+        else if (a === '--zifmia')
+            opts.zifmia = true;
+        else if (a.startsWith('-'))
+            throw new Error(`unknown option: ${a}`);
+        else if (!opts.story)
+            opts.story = a;
+        else
+            throw new Error(`unexpected argument: ${a}`);
+        i++;
+    }
+    return opts;
+}
+/** Parse the `test:npm` flags after the positional <location>. */
+function parseTestNpm(args) {
+    const opts = { location: '' };
+    let i = 0;
+    while (i < args.length) {
+        const a = args[i];
+        if (a === '--local')
+            opts.mode = 'local';
+        else if (a === '--registry')
+            opts.mode = 'registry';
+        else if (a === '--chain')
+            opts.chain = true;
+        else if (a === '--quick')
+            opts.quick = true;
+        else if (a === '--keep')
+            opts.keep = true;
+        else if (a === '--version')
+            opts.registryVersion = args[++i];
+        else if (a === '--staging')
+            opts.stagingDir = args[++i];
+        else if (a === '--transcripts')
+            opts.transcripts = args[++i];
+        else if (a.startsWith('-'))
+            throw new Error(`unknown option: ${a}`);
+        else if (!opts.location)
+            opts.location = a;
+        else
+            throw new Error(`unexpected argument: ${a}`);
+        i++;
+    }
+    if (!opts.location)
+        throw new Error('test:npm requires a story <location>');
+    return opts;
+}
+async function main(argv) {
+    const [command, ...rest] = argv;
+    if (!command || command === '--help' || command === '-h' || command === 'help') {
+        console.log(USAGE);
+        return command && command !== 'help' ? 1 : 0;
+    }
+    switch (command) {
+        case 'build': {
+            if ((0, repo_1.detectMode)() === 'monorepo') {
+                (0, build_1.runBuild)(parseBuild(rest));
+                return 0;
+            }
+            // Standalone: build the cwd project, or a registered story by name.
+            const positional = rest.find((a) => !a.startsWith('-'));
+            const flags = rest.filter((a) => a !== positional);
+            let dir;
+            if (positional) {
+                dir = (0, registry_1.lookupStory)(positional) ?? undefined; // throws if registered-but-stale
+                if (!dir) {
+                    throw new Error(`'${positional}' is not a registered story — run \`sharpee register <location>\`, or run \`sharpee build\` from the project directory`);
+                }
+            }
+            if (flags.includes('--browser'))
+                await (0, build_browser_1.runBuildBrowserCommand)(flags.filter((a) => a !== '--browser'), dir);
+            else
+                await (0, build_2.runBuildCommand)(flags, dir);
+            return 0;
+        }
+        case 'build-browser': {
+            if ((0, repo_1.detectMode)() === 'monorepo')
+                (0, build_1.runBuild)({ ...parseBuild(rest), browser: true });
+            else
+                await (0, build_browser_1.runBuildBrowserCommand)(rest);
+            return 0;
+        }
+        case 'init':
+            await (0, init_1.runInitCommand)(rest);
+            return 0;
+        case 'init-browser':
+            await (0, init_browser_1.runInitBrowserCommand)(rest);
+            return 0;
+        case 'ifid':
+            (0, ifid_1.runIfidCommand)(rest);
+            return 0;
+        case 'bundle':
+            (0, bundle_1.runBundle)({});
+            return 0;
+        case 'clean':
+            (0, clean_1.runClean)({});
+            return 0;
+        case 'verify':
+            (0, verify_1.runVerify)({});
+            return 0;
+        case 'test:npm': {
+            const opts = parseTestNpm(rest);
+            // Resolve a registered story name → its path (so `test:npm <name>` works; ADR AC-3).
+            if (!(0, node_fs_1.existsSync)(opts.location))
+                opts.location = (0, registry_1.lookupStory)(opts.location) ?? opts.location;
+            const r = (0, test_npm_1.runTestNpm)(opts);
+            if (!r.ran)
+                return 0;
+            console.log('===========================================');
+            console.log(`  RESULTS: ${r.passed} passing, ${r.failed} failures`);
+            console.log('===========================================');
+            if (r.failed > 0) {
+                console.log('Failures: ' + r.failures.join(', '));
+                return 1;
+            }
+            return 0;
+        }
+        case 'register':
+            (0, register_1.runRegister)(rest);
+            return 0;
+        case 'list':
+            (0, register_1.runList)();
+            return 0;
+        case 'test':
+        case 'play':
+            console.error(`sharpee ${command}: not yet implemented`);
+            return 2;
+        default:
+            console.error(`unknown command: ${command}\n`);
+            console.log(USAGE);
+            return 2;
+    }
+}
+main(process.argv.slice(2))
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    console.error('sharpee: ' + (err instanceof Error ? err.message : String(err)));
+    process.exit(2);
+});
+//# sourceMappingURL=cli.js.map

package/cli.js.map

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

package/commands/browser.d.ts

@@ -0,0 +1,10 @@
+export interface BrowserBuildOptions {
+    quiet?: boolean;
+}
+/**
+ * Build the browser client for `story` into dist/web/<story>/. Assumes platform +
+ * story (incl. ESM where applicable) are already built.
+ * @throws if the story or its browser-entry.ts is missing, or game.js is empty after esbuild.
+ */
+export declare function buildBrowserClient(root: string, story: string, opts?: BrowserBuildOptions): void;
+//# sourceMappingURL=browser.d.ts.map

package/commands/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/browser.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,IAAI,CAgFpG"}

package/commands/browser.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBrowserClient = buildBrowserClient;
+/**
+ * browser.ts — `devkit build <story> --browser`: the self-contained single-player
+ * web app at dist/web/<story>/ (build.sh build_browser_client, 877-952).
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3b). The author's player-facing
+ * deliverable (AC-9): an IIFE game.js + css + html that boots in one load, portable
+ * to any static host. Byte-for-byte parity with build.sh until the 3d cutover.
+ *
+ * Public interface: buildBrowserClient(root, story, 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");
+/** Copy a template file if present (build.sh's per-file `if [ -f ]` copies). */
+function copyIfExists(src, dest) {
+    if (!(0, node_fs_1.existsSync)(src))
+        return false;
+    (0, node_fs_1.cpSync)(src, dest);
+    return true;
+}
+/**
+ * Build the browser client for `story` into dist/web/<story>/. Assumes platform +
+ * story (incl. ESM where applicable) are already built.
+ * @throws if the story or its browser-entry.ts is missing, or game.js is empty after esbuild.
+ */
+function buildBrowserClient(root, story, opts = {}) {
+    const log = (m) => !opts.quiet && console.log(m);
+    const storyDir = (0, repo_1.resolveStoryDir)(root, story);
+    if (!storyDir)
+        throw new Error(`story not found: ${story}`);
+    const entry = (0, node_path_1.join)(storyDir, 'src', 'browser-entry.ts');
+    if (!(0, node_fs_1.existsSync)(entry))
+        throw new Error(`browser entry not found: ${entry}`);
+    const outRel = (0, node_path_1.join)('dist', 'web', story);
+    const outDir = (0, node_path_1.join)(root, outRel);
+    (0, node_fs_1.mkdirSync)(outDir, { recursive: true });
+    log(`=== Building Browser Client: ${story} ===`);
+    // Bundle — verbatim build.sh esbuild invocation (single platform-browser alias; the
+    // IIFE bakes the platform + story into one payload, so the page boots in a single load).
+    (0, node_child_process_1.execFileSync)('npx', [
+        'esbuild',
+        (0, node_path_1.join)(storyDir, 'src', 'browser-entry.ts'),
+        '--bundle',
+        '--platform=browser',
+        '--target=es2020',
+        '--format=iife',
+        '--global-name=SharpeeGame',
+        `--outfile=${(0, node_path_1.join)(outRel, 'game.js')}`,
+        '--sourcemap',
+        '--minify',
+        '--conditions=require',
+        '--define:process.env.PARSER_DEBUG=undefined',
+        '--define:process.env.DEBUG_PRONOUNS=undefined',
+        '--define:process.env.NODE_ENV="production"',
+        `--alias:@sharpee/platform-browser=${(0, node_path_1.join)(root, 'packages', 'platform-browser', 'dist', 'index.js')}`,
+    ], { cwd: root, stdio: opts.quiet ? 'ignore' : 'inherit' });
+    const tpl = (0, node_path_1.join)(root, 'templates', 'browser');
+    // index.html (title set at runtime by BrowserClient from story config).
+    copyIfExists((0, node_path_1.join)(tpl, 'index.html'), (0, node_path_1.join)(outDir, 'index.html'));
+    // CSS: base (structural, ADR-170), decorations (prose vocabulary, ADR-174), infocom→styles (theme).
+    copyIfExists((0, node_path_1.join)(tpl, 'base.css'), (0, node_path_1.join)(outDir, 'base.css'));
+    copyIfExists((0, node_path_1.join)(tpl, 'decorations.css'), (0, node_path_1.join)(outDir, 'decorations.css'));
+    copyIfExists((0, node_path_1.join)(tpl, 'infocom.css'), (0, node_path_1.join)(outDir, 'styles.css'));
+    // Theme assets (per-theme bundled webfonts). rm -rf first to avoid cp-into-existing nesting.
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(tpl, 'themes'))) {
+        (0, node_fs_1.rmSync)((0, node_path_1.join)(outDir, 'themes'), { recursive: true, force: true });
+        (0, node_fs_1.cpSync)((0, node_path_1.join)(tpl, 'themes'), (0, node_path_1.join)(outDir, 'themes'), { recursive: true });
+    }
+    // Story assets (audio, images): copy the contents of <story>/assets/ into the output.
+    // Skip dotfiles to match build.sh's `cp "$ASSETS_DIR"/*` (bash glob excludes dotfiles,
+    // so .DS_Store and friends never reach the deliverable).
+    const assetsDir = (0, node_path_1.join)(storyDir, 'assets');
+    if ((0, node_fs_1.existsSync)(assetsDir)) {
+        for (const entryName of (0, node_fs_1.readdirSync)(assetsDir)) {
+            if (entryName.startsWith('.'))
+                continue;
+            (0, node_fs_1.cpSync)((0, node_path_1.join)(assetsDir, entryName), (0, node_path_1.join)(outDir, entryName), { recursive: true });
+        }
+    }
+    // Website mirror.
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(root, 'website', 'public'))) {
+        const webDir = (0, node_path_1.join)(root, 'website', 'public', 'web', story);
+        (0, node_fs_1.mkdirSync)(webDir, { recursive: true });
+        (0, node_fs_1.cpSync)((0, node_path_1.join)(outDir, 'game.js'), (0, node_path_1.join)(webDir, 'game.js'));
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(outDir, 'index.html')))
+            (0, node_fs_1.cpSync)((0, node_path_1.join)(outDir, 'index.html'), (0, node_path_1.join)(webDir, 'index.html'));
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(outDir, 'base.css')))
+            (0, node_fs_1.cpSync)((0, node_path_1.join)(outDir, 'base.css'), (0, node_path_1.join)(webDir, 'base.css'));
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(outDir, 'styles.css')))
+            (0, node_fs_1.cpSync)((0, node_path_1.join)(outDir, 'styles.css'), (0, node_path_1.join)(webDir, 'styles.css'));
+        if ((0, node_fs_1.existsSync)((0, node_path_1.join)(outDir, 'themes'))) {
+            (0, node_fs_1.rmSync)((0, node_path_1.join)(webDir, 'themes'), { recursive: true, force: true });
+            (0, node_fs_1.cpSync)((0, node_path_1.join)(outDir, 'themes'), (0, node_path_1.join)(webDir, 'themes'), { recursive: true });
+        }
+    }
+    // Invariant: assert the deliverable exists (no silent success on an empty build).
+    const gameJs = (0, node_path_1.join)(outDir, 'game.js');
+    if (!(0, node_fs_1.existsSync)(gameJs) || (0, node_fs_1.statSync)(gameJs).size === 0) {
+        throw new Error(`browser build failed: ${(0, node_path_1.join)(outRel, 'game.js')} is missing or empty`);
+    }
+    log(`Output: ${outRel}/ (${(0, node_fs_1.statSync)(gameJs).size} bytes)`);
+}
+//# sourceMappingURL=browser.js.map

package/commands/browser.js.map

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

package/commands/build.d.ts

@@ -0,0 +1,38 @@
+export interface BuildOptions {
+    root?: string;
+    /** Story name to build (resolved stories/<name> then tutorials/<name>). */
+    story?: string;
+    /** Resume the platform build from this package short-name (build.sh --skip). */
+    skipTo?: string;
+    /** Explicit version to stamp (else read packages/sharpee/package.json). */
+    version?: string;
+    /** Frozen build date (parity determinism). Defaults to now in build.sh's format. */
+    buildDate?: string;
+    /** Skip version stamping (build.sh --no-version). */
+    noVersion?: boolean;
+    /** Skip genai-api generation. */
+    noGenai?: boolean;
+    /** Run the ESM build pass (needed for browser/story-bundle targets; false for the CLI bundle). */
+    esm?: boolean;
+    /** Run the bundle step at the end (default true — the full build.sh pipeline). */
+    bundle?: boolean;
+    /** Also build the browser client (dist/web/<story>/). Implies --esm; requires a story. */
+    browser?: boolean;
+    /** Also build the zifmia multi-user server (tools/zifmia/dist/). Implies --esm. */
+    zifmia?: boolean;
+    quiet?: boolean;
+}
+/**
+ * Stamp versions (build.sh update_versions, CLI/story scope). Returns the resolved
+ * SHARPEE_VERSION so callers can log it. See module-level Behavior Statement.
+ */
+export declare function stampVersions(root: string, opts: BuildOptions): string;
+/** Build all platform packages in dependency order (build.sh build_platform). */
+export declare function buildPlatform(root: string, opts: BuildOptions): void;
+/** Generate the genai-api reference (build.sh generate_genai_api). */
+export declare function generateGenaiApi(root: string, opts: BuildOptions): void;
+/** Build a story package (build.sh build_story + resolve_story_pkg). */
+export declare function buildStory(root: string, story: string, opts: BuildOptions): void;
+/** Run the full build pipeline. */
+export declare function runBuild(opts?: BuildOptions): void;
+//# sourceMappingURL=build.d.ts.map

package/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/build.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kGAAkG;IAClG,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAaD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAsCtE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CA+BpE;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAKvE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAmBhF;AAED,mCAAmC;AACnC,wBAAgB,QAAQ,CAAC,IAAI,GAAE,YAAiB,GAAG,IAAI,CAkBtD"}

package/commands/build.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stampVersions = stampVersions;
+exports.buildPlatform = buildPlatform;
+exports.generateGenaiApi = generateGenaiApi;
+exports.buildStory = buildStory;
+exports.runBuild = runBuild;
+/**
+ * build.ts — `devkit build`: the full platform+story build pipeline (build.sh
+ * update_versions + build_platform + generate_genai_api + build_story + build_bundle).
+ * devkit orchestrates; tsf/pnpm compile.
+ *
+ * Owner context: @sharpee/devkit (ADR-180 Phase 3). Output must match build.sh
+ * byte-for-byte (frozen version+date) until build.sh is retired at cutover.
+ *
+ * Public interface: runBuild(opts). Sub-steps stampVersions/buildPlatform/
+ * generateGenaiApi/buildStory are exported for the parity harness + tests.
+ */
+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");
+const bundle_1 = require("./bundle");
+const browser_1 = require("./browser");
+const zifmia_1 = require("./zifmia");
+/**
+ * The generator name written into stamped version.ts files. build.sh was retired at
+ * the ADR-180 Phase 3d cutover (parity verified byte-identical first), so devkit now
+ * names itself as the generator.
+ */
+const GENERATOR = 'devkit';
+function nowStamp() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/** Rewrite a package.json's version, preserving key order + 2-space indent + trailing newline. */
+function writePkgVersion(pkgPath, version) {
+    const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, 'utf8'));
+    pkg.version = version;
+    (0, node_fs_1.writeFileSync)(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+}
+/**
+ * Stamp versions (build.sh update_versions, CLI/story scope). Returns the resolved
+ * SHARPEE_VERSION so callers can log it. See module-level Behavior Statement.
+ */
+function stampVersions(root, opts) {
+    const sharpeePkg = (0, node_path_1.join)(root, 'packages', 'sharpee', 'package.json');
+    const sharpeeVersion = opts.version ?? JSON.parse((0, node_fs_1.readFileSync)(sharpeePkg, 'utf8')).version;
+    if (opts.noVersion)
+        return sharpeeVersion;
+    const buildDate = opts.buildDate ?? nowStamp();
+    if ((0, node_fs_1.existsSync)(sharpeePkg))
+        writePkgVersion(sharpeePkg, sharpeeVersion);
+    // Story version.ts — stories/<name> only (build.sh quirk: tutorials are not stamped).
+    // Accepts a path or a name (resolveStory), so `./sharpee build stories/dungeo` stamps too.
+    if (opts.story) {
+        const resolved = (0, repo_1.resolveStory)(root, opts.story);
+        if (resolved && resolved.underStories) {
+            const storyVer = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(resolved.dir, 'package.json'), 'utf8')).version;
+            const versionFile = (0, node_path_1.join)(resolved.dir, 'src', 'version.ts');
+            (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(versionFile), { recursive: true });
+            (0, node_fs_1.writeFileSync)(versionFile, `/**
+ * Version information for ${resolved.name}
+ * Auto-generated by ${GENERATOR} - DO NOT EDIT
+ */
+export const STORY_VERSION = '${storyVer}';
+export const BUILD_DATE = '${buildDate}';
+export const ENGINE_VERSION = '${sharpeeVersion}';
+export const VERSION_INFO = { version: STORY_VERSION, buildDate: BUILD_DATE, engineVersion: ENGINE_VERSION } as const;
+`);
+        }
+    }
+    // zifmia package.json version (build.sh update_versions stamps it for -c zifmia).
+    if (opts.zifmia) {
+        const zifmiaPkg = (0, node_path_1.join)(root, 'tools', 'zifmia', 'package.json');
+        if ((0, node_fs_1.existsSync)(zifmiaPkg))
+            writePkgVersion(zifmiaPkg, sharpeeVersion);
+    }
+    return sharpeeVersion;
+}
+/** Build all platform packages in dependency order (build.sh build_platform). */
+function buildPlatform(root, opts) {
+    const run = (pkg, args) => (0, node_child_process_1.execFileSync)(pkg, args, { cwd: root, stdio: opts.quiet ? 'ignore' : 'inherit' });
+    let skipping = Boolean(opts.skipTo);
+    for (const [pkg, dir] of repo_1.PLATFORM_PACKAGES) {
+        if (skipping) {
+            if (dir === opts.skipTo)
+                skipping = false;
+            else
+                continue;
+        }
+        run('pnpm', ['--filter', pkg, 'build']);
+        // Invariant: assert the compile produced output (precludes the .tsbuildinfo silent no-op class).
+        const distIndex = (0, node_path_1.join)(root, 'packages', dir, 'dist', 'index.js');
+        if (!(0, node_fs_1.existsSync)(distIndex)) {
+            throw new Error(`build of ${pkg} produced no dist/index.js (silent no-op?) at ${distIndex}`);
+        }
+    }
+    if (opts.esm) {
+        let esmSkip = Boolean(opts.skipTo);
+        for (const [pkg, dir] of repo_1.PLATFORM_PACKAGES) {
+            if (esmSkip) {
+                if (dir === opts.skipTo)
+                    esmSkip = false;
+                else
+                    continue;
+            }
+            if ((0, node_fs_1.existsSync)((0, node_path_1.join)(root, 'packages', dir, 'tsconfig.esm.json'))) {
+                // tsf drives the esm target so esmExtensions post-processing runs (build.sh comment 555-557).
+                run((0, repo_1.tsfBin)(root), ['build', '--condition', 'esm', '--filter', pkg]);
+            }
+        }
+    }
+}
+/** Generate the genai-api reference (build.sh generate_genai_api). */
+function generateGenaiApi(root, opts) {
+    (0, node_child_process_1.execFileSync)('node', ['scripts/generate-genai-api.js'], {
+        cwd: root,
+        stdio: opts.quiet ? 'ignore' : 'inherit',
+    });
+}
+/** Build a story package (build.sh build_story + resolve_story_pkg). */
+function buildStory(root, story, opts) {
+    const resolved = (0, repo_1.resolveStory)(root, story);
+    if (!resolved)
+        throw new Error(`story not found: ${story} (a path, or a stories/|tutorials/ name)`);
+    if (!resolved.inRepo || !resolved.pkg) {
+        // Standalone / out-of-repo stories build via their own toolchain — ADR-180 Phase U2.
+        throw new Error(`'${story}' is not an in-repo story (stories/ or tutorials/); standalone builds land in ADR-180 Phase U2`);
+    }
+    (0, node_child_process_1.execFileSync)('pnpm', ['--filter', resolved.pkg, 'build'], {
+        cwd: root,
+        stdio: opts.quiet ? 'ignore' : 'inherit',
+    });
+    if (opts.esm && (0, node_fs_1.existsSync)((0, node_path_1.join)(resolved.dir, 'tsconfig.esm.json'))) {
+        (0, node_child_process_1.execFileSync)((0, repo_1.tsfBin)(root), ['build', '--condition', 'esm', '--filter', resolved.pkg], {
+            cwd: root,
+            stdio: opts.quiet ? 'ignore' : 'inherit',
+        });
+    }
+}
+/** Run the full build pipeline. */
+function runBuild(opts = {}) {
+    const root = opts.root ?? (0, repo_1.findRepoRoot)();
+    const log = (m) => !opts.quiet && console.log(m);
+    // Client targets (browser/zifmia) need the ESM build pass (build.sh runs it when a client is requested).
+    const effective = opts.browser || opts.zifmia ? { ...opts, esm: true } : opts;
+    if (effective.browser && !effective.story)
+        throw new Error('--browser requires a story');
+    log('=== devkit build ===');
+    const version = stampVersions(root, effective);
+    log(`version: ${version}${effective.story ? ` · story: ${effective.story}` : ''}`);
+    buildPlatform(root, effective);
+    if (!effective.noGenai)
+        generateGenaiApi(root, effective);
+    if (effective.story)
+        buildStory(root, effective.story, effective);
+    if (effective.bundle !== false)
+        (0, bundle_1.runBundle)({ root, quiet: effective.quiet });
+    if (effective.browser)
+        (0, browser_1.buildBrowserClient)(root, effective.story, { quiet: effective.quiet });
+    if (effective.zifmia)
+        (0, zifmia_1.buildZifmiaServer)(root, { quiet: effective.quiet });
+    log('=== build complete ===');
+}
+//# sourceMappingURL=build.js.map

package/commands/build.js.map

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

package/commands/bundle.d.ts

@@ -0,0 +1,9 @@
+export interface BundleOptions {
+    /** Monorepo root; defaults to the workspace above cwd. */
+    root?: string;
+    /** Suppress per-step logging. */
+    quiet?: boolean;
+}
+/** Assemble dist/cli/sharpee.js + sharpee.d.ts. Assumes platform packages are built. */
+export declare function runBundle(opts?: BundleOptions): void;
+//# sourceMappingURL=bundle.d.ts.map

package/commands/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/commands/bundle.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,IAAI,CA8BxD"}