@sharpee/devkit 1.0.0

package/consumer-gen.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanStaging = scanStaging;
+exports.readSharpeeSeed = readSharpeeSeed;
+exports.computeClosure = computeClosure;
+exports.stagingDepsOf = stagingDepsOf;
+exports.generateConsumer = generateConsumer;
+/**
+ * consumer-gen.ts — generate a consumer `package.json` that installs a story's
+ * `@sharpee/*` closure either from the local `tsf build --npm` staging (tarballs)
+ * or from the registry (version refs).
+ *
+ * Owner context: @sharpee/devkit `test:npm` command (ADR-180 Phase 2). This is the
+ * single, drift-free replacement for the hand-listed dep arrays in npm-test/ and
+ * npm-test-dungeo/ and the standalone gen-consumer.mjs in npm-test-familyzoo/.
+ *
+ * Public interface:
+ *   scanStaging(stagingDir)                  -> name->dir map of @sharpee packages
+ *   readSharpeeSeed(storyPkgPath)            -> story's direct @sharpee deps
+ *   computeClosure(seed, depsOf)             -> full transitive @sharpee set (pure)
+ *   generateConsumer(opts)                   -> writes package.json (+ tarballs for local)
+ */
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const SHARPEE = '@sharpee/';
+/** transcript-tester supplies the `transcript-test` bin (dev-only). */
+const TT = '@sharpee/transcript-tester';
+/**
+ * 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.
+ */
+function scanStaging(stagingDir) {
+    if (!(0, node_fs_1.existsSync)(stagingDir)) {
+        throw new Error(`local npm staging not found at ${stagingDir} — run \`tsf build --npm\` first`);
+    }
+    const map = {};
+    for (const d of (0, node_fs_1.readdirSync)(stagingDir, { withFileTypes: true })) {
+        if (!d.isDirectory())
+            continue;
+        const pj = (0, node_path_1.join)(stagingDir, d.name, 'package.json');
+        if (!(0, node_fs_1.existsSync)(pj))
+            continue;
+        const p = JSON.parse((0, node_fs_1.readFileSync)(pj, 'utf8'));
+        if (typeof p.name === 'string' && p.name.startsWith(SHARPEE))
+            map[p.name] = d.name;
+    }
+    return map;
+}
+/** The story's directly-declared `@sharpee/*` dependencies (the closure seed). */
+function readSharpeeSeed(storyPkgPath) {
+    const pkg = JSON.parse((0, node_fs_1.readFileSync)(storyPkgPath, 'utf8'));
+    return Object.keys(pkg.dependencies || {}).filter((n) => n.startsWith(SHARPEE));
+}
+/**
+ * Transitive closure over `@sharpee/*` deps. Pure: `depsOf(name)` returns the
+ * `@sharpee/*` deps of `name`. Returns every reachable package including the seed.
+ */
+function computeClosure(seed, depsOf) {
+    const closure = new Set();
+    const stack = [...seed];
+    while (stack.length) {
+        const n = stack.pop();
+        if (closure.has(n))
+            continue;
+        closure.add(n);
+        for (const d of depsOf(n))
+            if (!closure.has(d))
+                stack.push(d);
+    }
+    return closure;
+}
+/** `depsOf` backed by the staging map — only deps present in staging are followed. */
+function stagingDepsOf(stagingDir, staging, name) {
+    const dir = staging[name];
+    if (!dir)
+        return [];
+    const p = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(stagingDir, dir, 'package.json'), 'utf8'));
+    return Object.keys(p.dependencies || {}).filter((n) => n.startsWith(SHARPEE) && staging[n]);
+}
+/**
+ * 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.
+ */
+function generateConsumer(opts) {
+    const { mode, storyPkgPath, vendorDir, outPkgPath } = opts;
+    const seed = readSharpeeSeed(storyPkgPath);
+    const dependencies = {};
+    const devDependencies = { typescript: '^5.0.0' };
+    let written;
+    let haveTT;
+    if (mode === 'local') {
+        const staging = scanStaging(opts.stagingDir);
+        const missing = seed.filter((n) => !staging[n]);
+        if (missing.length) {
+            throw new Error(`story deps absent from local staging: ${missing.join(', ')} — run \`tsf build --npm\` first`);
+        }
+        const pack = (name) => {
+            const dir = (0, node_path_1.join)(opts.stagingDir, staging[name]);
+            const out = (0, node_child_process_1.execFileSync)('npm', ['pack', dir, '--pack-destination', vendorDir, '--ignore-scripts', '--json'], { encoding: 'utf8' });
+            return JSON.parse(out)[0].filename;
+        };
+        written = [...computeClosure(seed, (n) => stagingDepsOf(opts.stagingDir, staging, n))].sort();
+        for (const n of written)
+            dependencies[n] = `file:vendor/${pack(n)}`;
+        haveTT = Boolean(staging[TT]);
+        if (haveTT)
+            devDependencies[TT] = `file:vendor/${pack(TT)}`;
+    }
+    else {
+        const version = opts.registryVersion || 'latest';
+        written = [...seed].sort();
+        for (const n of written)
+            dependencies[n] = version;
+        haveTT = true; // transcript-tester is published; npm resolves it from the registry
+        devDependencies[TT] = version;
+    }
+    (0, node_fs_1.writeFileSync)(outPkgPath, JSON.stringify({
+        name: 'sharpee-devkit-consumer',
+        version: '1.0.0',
+        private: true,
+        description: `devkit test:npm consumer (${mode})`,
+        main: 'dist/index.js',
+        dependencies,
+        devDependencies,
+    }, null, 2) + '\n');
+    return { closure: written, haveTranscriptTester: haveTT };
+}
+//# sourceMappingURL=consumer-gen.js.map

package/consumer-gen.js.map

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

package/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @sharpee/devkit — Sharpee build/test/verify orchestration (ADR-180).
+ *
+ * Owner context: published authoring devtool. devkit orchestrates; tsf compiles.
+ * Public interface: the `devkit` CLI bin (see cli.ts) plus the programmatic
+ * surfaces below for embedding/testing.
+ */
+export { runTestNpm } from './commands/test-npm';
+export type { TestNpmOptions, TestNpmResult } from './commands/test-npm';
+export { DEFAULT_STAGING } from './commands/test-npm';
+export { runBuild, stampVersions, buildPlatform, generateGenaiApi, buildStory } from './commands/build';
+export type { BuildOptions } from './commands/build';
+export { runBundle } from './commands/bundle';
+export type { BundleOptions } from './commands/bundle';
+export { buildBrowserClient } from './commands/browser';
+export type { BrowserBuildOptions } from './commands/browser';
+export { buildZifmiaServer } from './commands/zifmia';
+export type { ZifmiaBuildOptions } from './commands/zifmia';
+export { runClean } from './commands/clean';
+export type { CleanOptions } from './commands/clean';
+export { runRegister, runList } from './commands/register';
+export { registryPath, readRegistry, registerStory, listStories, lookupStory } from './registry';
+export type { Registry, RegistryEntry } from './registry';
+export { runVerify } from './commands/verify';
+export type { VerifyOptions } from './commands/verify';
+export { findRepoRoot, resolveStoryDir, resolveStory, findMonorepoRoot, detectMode, PLATFORM_PACKAGES, BUNDLE_ALIASES, BUNDLE_DTS, } from './repo';
+export { generateConsumer, scanStaging, readSharpeeSeed, computeClosure, stagingDepsOf, } from './consumer-gen';
+export type { StagingMap, GenerateConsumerOptions, GenerateConsumerResult, } from './consumer-gen';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/devkit/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxG,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,UAAU,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/index.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stagingDepsOf = exports.computeClosure = exports.readSharpeeSeed = exports.scanStaging = exports.generateConsumer = exports.BUNDLE_DTS = exports.BUNDLE_ALIASES = exports.PLATFORM_PACKAGES = exports.detectMode = exports.findMonorepoRoot = exports.resolveStory = exports.resolveStoryDir = exports.findRepoRoot = exports.runVerify = exports.lookupStory = exports.listStories = exports.registerStory = exports.readRegistry = exports.registryPath = exports.runList = exports.runRegister = exports.runClean = exports.buildZifmiaServer = exports.buildBrowserClient = exports.runBundle = exports.buildStory = exports.generateGenaiApi = exports.buildPlatform = exports.stampVersions = exports.runBuild = exports.DEFAULT_STAGING = exports.runTestNpm = void 0;
+/**
+ * @sharpee/devkit — Sharpee build/test/verify orchestration (ADR-180).
+ *
+ * Owner context: published authoring devtool. devkit orchestrates; tsf compiles.
+ * Public interface: the `devkit` CLI bin (see cli.ts) plus the programmatic
+ * surfaces below for embedding/testing.
+ */
+var test_npm_1 = require("./commands/test-npm");
+Object.defineProperty(exports, "runTestNpm", { enumerable: true, get: function () { return test_npm_1.runTestNpm; } });
+var test_npm_2 = require("./commands/test-npm");
+Object.defineProperty(exports, "DEFAULT_STAGING", { enumerable: true, get: function () { return test_npm_2.DEFAULT_STAGING; } });
+var build_1 = require("./commands/build");
+Object.defineProperty(exports, "runBuild", { enumerable: true, get: function () { return build_1.runBuild; } });
+Object.defineProperty(exports, "stampVersions", { enumerable: true, get: function () { return build_1.stampVersions; } });
+Object.defineProperty(exports, "buildPlatform", { enumerable: true, get: function () { return build_1.buildPlatform; } });
+Object.defineProperty(exports, "generateGenaiApi", { enumerable: true, get: function () { return build_1.generateGenaiApi; } });
+Object.defineProperty(exports, "buildStory", { enumerable: true, get: function () { return build_1.buildStory; } });
+var bundle_1 = require("./commands/bundle");
+Object.defineProperty(exports, "runBundle", { enumerable: true, get: function () { return bundle_1.runBundle; } });
+var browser_1 = require("./commands/browser");
+Object.defineProperty(exports, "buildBrowserClient", { enumerable: true, get: function () { return browser_1.buildBrowserClient; } });
+var zifmia_1 = require("./commands/zifmia");
+Object.defineProperty(exports, "buildZifmiaServer", { enumerable: true, get: function () { return zifmia_1.buildZifmiaServer; } });
+var clean_1 = require("./commands/clean");
+Object.defineProperty(exports, "runClean", { enumerable: true, get: function () { return clean_1.runClean; } });
+var register_1 = require("./commands/register");
+Object.defineProperty(exports, "runRegister", { enumerable: true, get: function () { return register_1.runRegister; } });
+Object.defineProperty(exports, "runList", { enumerable: true, get: function () { return register_1.runList; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "registryPath", { enumerable: true, get: function () { return registry_1.registryPath; } });
+Object.defineProperty(exports, "readRegistry", { enumerable: true, get: function () { return registry_1.readRegistry; } });
+Object.defineProperty(exports, "registerStory", { enumerable: true, get: function () { return registry_1.registerStory; } });
+Object.defineProperty(exports, "listStories", { enumerable: true, get: function () { return registry_1.listStories; } });
+Object.defineProperty(exports, "lookupStory", { enumerable: true, get: function () { return registry_1.lookupStory; } });
+var verify_1 = require("./commands/verify");
+Object.defineProperty(exports, "runVerify", { enumerable: true, get: function () { return verify_1.runVerify; } });
+var repo_1 = require("./repo");
+Object.defineProperty(exports, "findRepoRoot", { enumerable: true, get: function () { return repo_1.findRepoRoot; } });
+Object.defineProperty(exports, "resolveStoryDir", { enumerable: true, get: function () { return repo_1.resolveStoryDir; } });
+Object.defineProperty(exports, "resolveStory", { enumerable: true, get: function () { return repo_1.resolveStory; } });
+Object.defineProperty(exports, "findMonorepoRoot", { enumerable: true, get: function () { return repo_1.findMonorepoRoot; } });
+Object.defineProperty(exports, "detectMode", { enumerable: true, get: function () { return repo_1.detectMode; } });
+Object.defineProperty(exports, "PLATFORM_PACKAGES", { enumerable: true, get: function () { return repo_1.PLATFORM_PACKAGES; } });
+Object.defineProperty(exports, "BUNDLE_ALIASES", { enumerable: true, get: function () { return repo_1.BUNDLE_ALIASES; } });
+Object.defineProperty(exports, "BUNDLE_DTS", { enumerable: true, get: function () { return repo_1.BUNDLE_DTS; } });
+var consumer_gen_1 = require("./consumer-gen");
+Object.defineProperty(exports, "generateConsumer", { enumerable: true, get: function () { return consumer_gen_1.generateConsumer; } });
+Object.defineProperty(exports, "scanStaging", { enumerable: true, get: function () { return consumer_gen_1.scanStaging; } });
+Object.defineProperty(exports, "readSharpeeSeed", { enumerable: true, get: function () { return consumer_gen_1.readSharpeeSeed; } });
+Object.defineProperty(exports, "computeClosure", { enumerable: true, get: function () { return consumer_gen_1.computeClosure; } });
+Object.defineProperty(exports, "stagingDepsOf", { enumerable: true, get: function () { return consumer_gen_1.stagingDepsOf; } });
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/devkit/src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,gDAAiD;AAAxC,sGAAA,UAAU,OAAA;AAEnB,gDAAsD;AAA7C,2GAAA,eAAe,OAAA;AACxB,0CAAwG;AAA/F,iGAAA,QAAQ,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,yGAAA,gBAAgB,OAAA;AAAE,mGAAA,UAAU,OAAA;AAE7E,4CAA8C;AAArC,mGAAA,SAAS,OAAA;AAElB,8CAAwD;AAA/C,6GAAA,kBAAkB,OAAA;AAE3B,4CAAsD;AAA7C,2GAAA,iBAAiB,OAAA;AAE1B,0CAA4C;AAAnC,iGAAA,QAAQ,OAAA;AAEjB,gDAA2D;AAAlD,uGAAA,WAAW,OAAA;AAAE,mGAAA,OAAO,OAAA;AAC7B,uCAAiG;AAAxF,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,uGAAA,WAAW,OAAA;AAE5E,4CAA8C;AAArC,mGAAA,SAAS,OAAA;AAElB,+BASgB;AARd,oGAAA,YAAY,OAAA;AACZ,uGAAA,eAAe,OAAA;AACf,oGAAA,YAAY,OAAA;AACZ,wGAAA,gBAAgB,OAAA;AAChB,kGAAA,UAAU,OAAA;AACV,yGAAA,iBAAiB,OAAA;AACjB,sGAAA,cAAc,OAAA;AACd,kGAAA,UAAU,OAAA;AAEZ,+CAMwB;AALtB,gHAAA,gBAAgB,OAAA;AAChB,2GAAA,WAAW,OAAA;AACX,+GAAA,eAAe,OAAA;AACf,8GAAA,cAAc,OAAA;AACd,6GAAA,aAAa,OAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@sharpee/devkit",
+  "version": "1.0.0",
+  "description": "The Sharpee CLI engine — build/test/verify/scaffold orchestration (ADR-180). Provides the `sharpee` command; orchestrates, tsf compiles.",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "bin": {
+    "sharpee": "./cli.js"
+  },
+  "dependencies": {
+    "@sharpee/core": "^1.0.0",
+    "@sharpee/transcript-tester": "^1.0.0",
+    "fflate": "^0.8.2"
+  },
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "sharpee",
+    "devkit",
+    "build-tool"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/devkit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  }
+}

package/registry.d.ts

@@ -0,0 +1,33 @@
+export interface Registry {
+    stories: Record<string, {
+        path: string;
+    }>;
+}
+export interface RegistryEntry {
+    name: string;
+    path: string;
+    /** true if the registered path no longer exists. */
+    stale: boolean;
+}
+/** The registry file path (`~/.sharpee/devkit`; overridable via SHARPEE_DEVKIT_REGISTRY). */
+export declare function registryPath(): string;
+/** Read the registry, or an empty one if absent/unparseable. */
+export declare function readRegistry(): Registry;
+/**
+ * Upsert a name→path mapping. Resolves `location` to an absolute path; the default
+ * name is its basename. Returns the stored entry.
+ * @throws if the location does not exist.
+ */
+export declare function registerStory(location: string, name?: string): {
+    name: string;
+    path: string;
+};
+/** All registered stories, each flagged stale if its path no longer exists. */
+export declare function listStories(): RegistryEntry[];
+/**
+ * Resolve a registered name to its absolute path.
+ * @throws if the name is registered but its path no longer exists (stale, never silently skipped).
+ * @returns the path, or null if the name is not registered.
+ */
+export declare function lookupStory(name: string): string | null;
+//# sourceMappingURL=registry.d.ts.map

package/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/devkit/src/registry.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,QAAQ,CASvC;AAQD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQ7F;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvD"}

package/registry.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registryPath = registryPath;
+exports.readRegistry = readRegistry;
+exports.registerStory = registerStory;
+exports.listStories = listStories;
+exports.lookupStory = lookupStory;
+/**
+ * registry.ts — the user-level story location registry at `~/.sharpee/devkit`
+ * (ADR-180 Decision 4, amended: the verb is `register`, not `init`).
+ *
+ * A story is always referable by raw location; this registry is pure convenience —
+ * it maps a name → an absolute path so a story (anywhere, incl. other repos) can be
+ * referenced by name. Machine-level, git-ignored, rebuildable by re-running `register`.
+ *
+ * Format: { "stories": { "<name>": { "path": "<absolute path>" } } }
+ *
+ * Public interface: registryPath, readRegistry, registerStory, listStories, lookupStory.
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+/** The registry file path (`~/.sharpee/devkit`; overridable via SHARPEE_DEVKIT_REGISTRY). */
+function registryPath() {
+    return process.env.SHARPEE_DEVKIT_REGISTRY || (0, node_path_1.resolve)((0, node_os_1.homedir)(), '.sharpee', 'devkit');
+}
+/** Read the registry, or an empty one if absent/unparseable. */
+function readRegistry() {
+    const p = registryPath();
+    if (!(0, node_fs_1.existsSync)(p))
+        return { stories: {} };
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(p, 'utf8'));
+        return parsed && typeof parsed === 'object' && parsed.stories ? parsed : { stories: {} };
+    }
+    catch {
+        return { stories: {} };
+    }
+}
+function writeRegistry(reg) {
+    const p = registryPath();
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(p), { recursive: true });
+    (0, node_fs_1.writeFileSync)(p, JSON.stringify(reg, null, 2) + '\n');
+}
+/**
+ * Upsert a name→path mapping. Resolves `location` to an absolute path; the default
+ * name is its basename. Returns the stored entry.
+ * @throws if the location does not exist.
+ */
+function registerStory(location, name) {
+    const abs = (0, node_path_1.resolve)(location);
+    if (!(0, node_fs_1.existsSync)(abs))
+        throw new Error(`cannot register: path does not exist: ${abs}`);
+    const storyName = name || (0, node_path_1.basename)(abs);
+    const reg = readRegistry();
+    reg.stories[storyName] = { path: abs };
+    writeRegistry(reg);
+    return { name: storyName, path: abs };
+}
+/** All registered stories, each flagged stale if its path no longer exists. */
+function listStories() {
+    const reg = readRegistry();
+    return Object.entries(reg.stories)
+        .map(([name, { path }]) => ({ name, path, stale: !(0, node_fs_1.existsSync)(path) }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Resolve a registered name to its absolute path.
+ * @throws if the name is registered but its path no longer exists (stale, never silently skipped).
+ * @returns the path, or null if the name is not registered.
+ */
+function lookupStory(name) {
+    const entry = readRegistry().stories[name];
+    if (!entry)
+        return null;
+    if (!(0, node_fs_1.existsSync)(entry.path)) {
+        throw new Error(`registered story '${name}' points at a missing path: ${entry.path} (re-run \`sharpee register\`)`);
+    }
+    return entry.path;
+}
+//# sourceMappingURL=registry.js.map

package/registry.js.map

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

package/repo.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Ordered platform build list (build.sh PACKAGES, 479-507): `[pkgName, dirUnderPackages]`.
+ * Order is dependency order — do not re-sort.
+ */
+export declare const PLATFORM_PACKAGES: ReadonlyArray<readonly [string, string]>;
+/**
+ * esbuild `--alias:` entries for the CLI bundle (build.sh build_bundle, 587-604).
+ * Order matches build.sh so the esbuild command is byte-identical.
+ */
+export declare const BUNDLE_ALIASES: ReadonlyArray<readonly [string, string]>;
+/** Hand-written CLI bundle declarations (build.sh build_bundle, 607-619) — verbatim. */
+export declare const BUNDLE_DTS = "// Auto-generated Sharpee type declarations\nexport * from '../packages/core/dist/index';\nexport * from '../packages/if-domain/dist/index';\nexport * from '../packages/world-model/dist/index';\nexport * from '../packages/stdlib/dist/index';\nexport * from '../packages/engine/dist/index';\nexport * from '../packages/parser-en-us/dist/index';\nexport * from '../packages/lang-en-us/dist/index';\nexport * from '../packages/event-processor/dist/index';\nexport * from '../packages/text-blocks/dist/index';\nexport * from '../packages/channel-service/dist/index';\n";
+/**
+ * Walk up from `start` to the Sharpee monorepo root (the dir holding
+ * pnpm-workspace.yaml AND packages/core — the monorepo signature, so an author's
+ * coincidental pnpm workspace is not mistaken for it). Returns null if not found.
+ */
+export declare function findMonorepoRoot(start?: string): string | null;
+/**
+ * The monorepo root, or throw. Use when an operation is monorepo-only.
+ * @throws if not inside the Sharpee monorepo.
+ */
+export declare function findRepoRoot(start?: string): string;
+/**
+ * 'monorepo' when run inside the Sharpee monorepo (build platform + bundle + in-repo
+ * stories); 'standalone' when run in an author's own project (build their story via its
+ * own toolchain). The location-aware split behind `sharpee build` (ADR-180 unify).
+ */
+export declare function detectMode(start?: string): 'monorepo' | 'standalone';
+/**
+ * Resolve the `tsf` executable. Prefers the workspace-local `node_modules/.bin/tsf`
+ * (a bare `tsf` fails when tsf is only a shell alias / not on a non-interactive PATH);
+ * falls back to `tsf` on PATH. Produces identical compiler output either way.
+ */
+export declare function tsfBin(root: string): string;
+/**
+ * Resolve a story name to its directory (build.sh resolve_story_dir, 39-48):
+ * `stories/<name>` then `tutorials/<name>`. Returns absolute path or null.
+ */
+export declare function resolveStoryDir(root: string, name: string): string | null;
+/** The story version.ts path build.sh stamps (stories/<name> only — tutorials are NOT stamped). */
+export declare function storyVersionFile(root: string, name: string): string;
+export interface ResolvedStory {
+    /** Story slug (directory basename). */
+    name: string;
+    /** Absolute story directory. */
+    dir: string;
+    /** Workspace package name if the story is an in-repo workspace story; else null. */
+    pkg: string | null;
+    /** True iff dir is a direct child of <root>/stories or <root>/tutorials. */
+    inRepo: boolean;
+    /** True iff dir is under <root>/stories (build.sh stamps version.ts only for these). */
+    underStories: boolean;
+}
+/**
+ * Resolve a story given either a **path** (a directory with a package.json, tried
+ * relative to cwd then to root) or a bare **name** (stories/<name> then tutorials/<name>).
+ * Returns null if neither resolves. This is the single resolver `build` + `stampVersions`
+ * share, so path and name forms behave identically (ADR-180 Decision 4: a story is a location).
+ */
+export declare function resolveStory(root: string, nameOrPath: string): ResolvedStory | null;
+/** Read a package.json's `version` field. */
+export declare function readVersion(pkgJsonPath: string): string;
+//# sourceMappingURL=repo.d.ts.map

package/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/devkit/src/repo.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BtE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBnE,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,UAAU,yjBAWtB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAU7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAE,MAAsB,GAAG,UAAU,GAAG,YAAY,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzE;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,oFAAoF;IACpF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,YAAY,EAAE,OAAO,CAAC;CACvB;AAgBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAMnF;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD"}