@bluelibs/runner-dev 6.2.0 → 6.4.0

package/README.md

@@ -21,6 +21,9 @@ npm install -g @bluelibs/runner-dev
 npx @bluelibs/runner-dev
 ```
 
+For local `AGENTS.md`-style workflows, this repo now extracts Runner skills from `@bluelibs/runner` into `.agents/skills` via `npm-skills` on `postinstall`.
+Runner-Dev also publishes its own skill from `skills/core`; keep `README.md`, `skills/core/SKILL.md`, and `skills/core/references/readmes/COMPACT_GUIDE.md` aligned when those docs change. The docs UI now includes a topology view for blast-radius and resource mindmap exploration.
+
 ```ts
 import { r } from "@bluelibs/runner";
 import { dev } from "@bluelibs/runner-dev";
@@ -41,6 +44,7 @@ const app = r
 ## What you get
 
 - Fully-featured UI with AI assistance to explore your app, call tasks, emit events, diagnostics, logs and more.
+- Static catalog export via `exportDocs(app, { output?, overwrite? })` for a standalone frozen docs site under `./runner-dev-catalog` by default.
 - Overview tables across UI sections now include sortable and searchable columns (`ID`, `Title`, `Description`, `Used By`) with per-element usage counters.
 - Overview tables now include `Visibility` (`Public`/`Private`) derived from Runner resource `isolate()` boundaries.
 - Introspector: programmatic API to inspect tasks, hooks, resources, events, middleware, and diagnostics (including file paths, contents)
@@ -49,7 +53,7 @@ const app = r
 - Resource introspection includes `subtree` governance summaries (middleware attachment counts and validator counts per branch).
 - Resource introspection indicates whether a resource exposes a `cooldown()` hook for shutdown lifecycle.
 - Isolation wildcard rules are clickable in the docs UI and open a modal showing matched resources with inline filtering when lists are large.
-- Event introspection includes `transactional`, `parallel`, optional `eventLane { laneId, orderingKey, metadata }`, and optional `rpcLane { laneId }`.
+- Event introspection includes `transactional`, `parallel`, optional `eventLane { laneId }`, and optional `rpcLane { laneId }`.
 - Task introspection includes optional `rpcLane { laneId }`.
 - Tag pages distinguish between directly tagged elements and tag handlers (elements that depend on the tag id).
 - Live: in-memory logs and event emissions
@@ -84,12 +88,19 @@ const app = r
 
 ## Runner 6.2 Migration Notes
 
-- Built-in async contexts now include `asyncContexts.tenant`, and `IAsyncContext` officially exposes safe probe helpers via `tryUse()` and `has()`.
-- Built-in task middleware such as `cache`, `concurrency`, and `rateLimit` can partition internal state per tenant via `tenantScope`.
+- Built-in async contexts in 6.2 use `asyncContexts.tenant`; in Runner 6.3 they were renamed to `asyncContexts.identity`.
+- Built-in task middleware such as `cache`, `concurrency`, and `rateLimit` can partition internal state via `tenantScope` in 6.2, and via `identityScope` from 6.3 onward.
 - Lazy resource initialization now fails fast once shutdown begins; runner-dev will surface the new typed shutdown errors through normal error introspection.
 - Subtree middleware conflicts now fail fast inside Runner instead of remaining a post-compose diagnostic concern.
 - The internal framework root is now described as the synthetic framework root, with clearer internal `runner` and `system` namespace resources.
 
+## Runner 6.3 Migration Notes
+
+- Built-in identity moved from `asyncContexts.tenant` to `asyncContexts.identity`, and identity-aware middleware now uses `identityScope`.
+- Hook introspection now resolves selector-based targets such as `subtreeOf(...)` and predicates through Runner's store API instead of relying on raw `hook.on` shapes.
+- Event Lane routing now comes from `r.eventLane(...).applyTo([...])` instead of `tags.eventLane`, and Event Lane topology profiles use `consume: [{ lane, hooks?: { only } }]`.
+- Runner now supports `run(app, { signal })`, `run(app, { identity })`, and `runtime.dispose({ force: true })`; runner-dev remains compatible with those lifecycle additions while avoiding deprecated lane-tag assumptions.
+
 ## Table of Contents
 
 - [Quickstart Guide](#quickstart)
@@ -97,8 +108,8 @@ const app = r
 - [CLI Tooling & Scaffolding](#cli-usage-direct)
 - [Live Telemetry & Correlation](#live-telemetry)
 - [Hot-Swapping Debugging System](#hot-swapping-debugging-system)
-- [GraphQL API Examples](#example-queries)
-- [API Reference](API_REFERENCE.md)
+- [GraphQL API Examples](#graphql-api-examples)
+- [API Reference](readmes/API_REFERENCE.md)
 - [Contributing & Local Dev](CONTRIBUTING.md)
 
 ## Quickstart
@@ -135,6 +146,87 @@ Inside the UI, you can:
 - Inspect live logs and event emissions in real-time.
 - View and edit files directly via the browser.
 
+### Static Catalog Export
+
+If you want the visual docs without running the project server, you can export a standalone static catalog directly from a built Runner app.
+
+The recommended setup is a tiny script plus an npm command.
+
+Create `scripts/export-docs.ts`:
+
+```ts
+// scripts/export-docs.ts
+import { exportDocs } from "@bluelibs/runner-dev";
+import { app } from "../src/app";
+
+await exportDocs(app);
+// Optional custom destination:
+await exportDocs(app, {
+  output: "./artifacts/runner-dev-catalog",
+  overwrite: true,
+});
+```
+
+Add a package script:
+
+```json
+{
+  "scripts": {
+    "docs:export": "tsx scripts/export-docs.ts"
+  }
+}
+```
+
+Then run:
+
+```bash
+npm run docs:export
+```
+
+What gets written:
+
+- `./runner-dev-catalog/index.html`
+- `./runner-dev-catalog/snapshot.json`
+- a standalone `index.html` with the docs payload, CSS, JS, and favicon embedded for direct opening
+
+Output behavior:
+
+- `exportDocs(app)` writes to `./runner-dev-catalog` by default
+- the default `./runner-dev-catalog` destination is treated as a dedicated export folder and can be regenerated safely
+- custom directories are protected by default; pass `overwrite: true` if you intentionally want to replace an existing non-empty directory
+- `index.html` is standalone and can be opened directly over `file://`
+- `snapshot.json` is still written as an auxiliary artifact for inspection, debugging, and snapshot-backed MCP, but the standalone HTML does not depend on it at runtime
+
+What the exported catalog includes:
+
+- overview
+- topology
+- tasks, resources, events, hooks, and middlewares
+- tags, errors, async contexts, diagnostics, and markdown docs
+
+What it intentionally does not include:
+
+- live telemetry
+- GraphQL server endpoints
+- task or event execution
+- swap or eval actions
+- file-saving mutations
+
+`exportDocs()` uses Runner's real dry-run path under the hood. In other words, it effectively does a `run(app, { dryRun: true })`, builds the in-memory docs snapshot from that composed Runner store, and emits a frozen catalog. It is not source-only static analysis, which is important both for accuracy and for understanding what code paths still participate during export.
+
+This also works well as a CI artifact:
+
+- generate the catalog during CI
+- upload `./runner-dev-catalog` or `./artifacts/runner-dev-catalog` as a build artifact
+- inspect the visual docs after the pipeline finishes without starting the app again
+
+For local package work inside this repository, `npm run play:export` is the same idea wired to the reference commerce app used by `npm run play`:
+
+```bash
+npm run play:export
+npm run play:export -- ./my-export-dir
+```
+
 Add it as an Model Context Protocol Server (for AIs) via normal socket:
 
 ```json
@@ -155,6 +247,23 @@ Add it as an Model Context Protocol Server (for AIs) via normal socket:
 
 Then start your app as usual. The Dev GraphQL server will be available at http://localhost:1337/graphql.
 
+For a frozen exported catalog, you can point MCP at the generated snapshot instead of a live endpoint:
+
+```json
+{
+  "mcpServers": {
+    "mcp-graphql": {
+      "description": "MCP Server for an exported Runner Dev snapshot",
+      "command": "npx",
+      "args": ["@bluelibs/runner-dev", "mcp"],
+      "env": {
+        "SNAPSHOT_FILE": "./runner-dev-catalog/snapshot.json"
+      }
+    }
+  }
+}
+```
+
 ### CLI usage (MCP server)
 
 After installing, you can start the MCP server from this package via stdio.
@@ -163,20 +272,22 @@ Using npx:
 
 ```bash
 ENDPOINT=http://localhost:1337/graphql npx -y @bluelibs/runner-dev mcp
+SNAPSHOT_FILE=./runner-dev-catalog/snapshot.json npx -y @bluelibs/runner-dev mcp
 ```
 
 Optional environment variables:
 
+- `SNAPSHOT_FILE=./runner-dev-catalog/snapshot.json` to serve MCP from an exported static snapshot instead of a live endpoint
 - `ALLOW_MUTATIONS=true` to enable `graphql.mutation`
 - `HEADERS='{"Authorization":"Bearer token"}'` to pass extra headers
 
 Available tools once connected:
 
-- `graphql.query` — run read-only queries
-- `graphql.mutation` — run mutations (requires `ALLOW_MUTATIONS=true`)
+- `graphql.query` — run read-only queries against the live endpoint or snapshot
+- `graphql.mutation` — run mutations (requires `ALLOW_MUTATIONS=true`, live endpoint only)
 - `graphql.introspect` — fetch schema
-- `graphql.ping` — reachability check
-- `project.overview` — dynamic Markdown overview aggregated from the API
+- `graphql.ping` — source check for the configured endpoint or snapshot
+- `project.overview` — dynamic Markdown overview aggregated from the configured source
 
 ### CLI usage (direct)
 
@@ -188,6 +299,14 @@ Prerequisites:
 - Alternatively, you can run queries in a new **dry‑run mode** with a TypeScript entry file (no server required).
 - Build this package (or install it) so the binary is available.
 
+Programmatic export is available even when you do not want a live server:
+
+```ts
+import { exportDocs } from "@bluelibs/runner-dev";
+
+await exportDocs(app);
+```
+
 Help:
 
 ```bash
@@ -222,10 +341,10 @@ Examples:
 
 ```bash
 # Create and auto-install dependencies, then run tests
-new my-awesome-app --install --run-tests
+runner-dev new my-awesome-app --install --run-tests
 
 # Create and start the dev server immediately (blocks)
-new my-awesome-app --install --run
+runner-dev new my-awesome-app --install --run
 ```
 
 Scaffold artifacts (resource | task | event | tag | taskMiddleware | resourceMiddleware):
@@ -374,7 +493,7 @@ Precedence:
 
 ## GraphQL API Examples
 
-For a full list of types and fields, see the [API Reference](API_REFERENCE.md).
+For a full list of types and fields, see the [API Reference](readmes/API_REFERENCE.md).
 
 ### Explore tasks and dependencies deeply
 

package/dist/cli/generators/initUtils.js

@@ -35,7 +35,7 @@ async function writeFile(filePath, content) {
     await promises_1.default.writeFile(filePath, content, { encoding: "utf8" });
 }
 async function writeGitignore(targetDir) {
-    const content = `node_modules\n.dist\ndist\n.env\n\n`;
+    const content = `node_modules\n.env\ndist\n.agents/skills\n\n`;
     await writeFile(path_1.default.join(targetDir, ".gitignore"), content);
 }
 async function runCommand(cmd, args, cwd) {

package/dist/cli/generators/initUtils.js.map

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

package/dist/cli/generators/scaffold/templates/README.md.js

@@ -4,7 +4,7 @@ exports.readme = readme;
 function readme(projectName) {
     return `# ${projectName}
 
-Generated by \`runner-dev new\` for Runner 6.2.
+Generated by \`runner-dev new\` for Runner 6.3.
 
 ## Quick start
 
@@ -12,28 +12,41 @@ Generated by \`runner-dev new\` for Runner 6.2.
    - npm install
 2. Start the dev server:
    - npm run dev
+3. Run the smoke checks:
+   - npm run qa
 
 The server starts on http://localhost:1337
 
+On install, the \`postinstall\` script runs \`npm-skills extract --skip-production --override\` via \`npm run skills:extract\`. The \`--skip-production\` flag keeps production installs clean while still extracting skills for local development.
+
 - GraphQL endpoint: http://localhost:1337/graphql (how to query your guts and live telemetry)
 - Voyager UI: http://localhost:1337/voyager (how the guts of your app look like)
 - Project docs: http://localhost:1337/docs (beautiful docs with live telemetry and easy task and event dispatching)
 
-## Runner 6.2 notes
+## Runner 6.3 notes
 
 - Runtime task and resource ids are structural, so user resource segments stay in canonical ids.
 - \`resource.subtree(...)\` can compose multiple policies with an array.
 - Built-in async context accessors support safe probes via \`tryUse()\` and \`has()\`.
-- Built-in task middleware such as \`cache\`, \`concurrency\`, and \`rateLimit\` can partition state per tenant via \`tenantScope\`.
+- Built-in async identity now lives at \`asyncContexts.identity\`, and identity-aware middleware uses \`identityScope\`.
+- Event Lane routing is defined with \`r.eventLane(...).applyTo([...])\`, and topology consume entries use \`{ lane, hooks?: { only } }\`.
 - Subtree middleware conflicts now fail fast instead of silently deferring to local middleware.
 
 ## Scripts
 
-- dev: Run with tsx watch (TypeScript ESM)
+- dev: Run with tsx watch
 - build: Type-check and emit to dist
 - start: Run built app
 - test: Run Vitest once
 - test:watch: Run Vitest in watch mode
+- qa: Run the minimal verification flow (\`build\` + \`test\`)
+- skills:extract: Refresh extracted skills from installed packages
+
+## Project layout
+
+- \`src/app.ts\`: exported root Runner resource definition
+- \`src/main.ts\`: executable entry point for local development
+- \`src/app.test.ts\`: runtime smoke test
 
 ## Useful CLI commands
 

package/dist/cli/generators/scaffold/templates/README.md.js.map

@@ -1 +1 @@
-{"version":3,"file":"README.md.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/README.md.ts"],"names":[],"mappings":";;AAAA,wBA4CC;AA5CD,SAAgB,MAAM,CAAC,WAAmB;IACxC,OAAO,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CxB,CAAC;AACF,CAAC"}
+{"version":3,"file":"README.md.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/README.md.ts"],"names":[],"mappings":";;AAAA,wBAyDC;AAzDD,SAAgB,MAAM,CAAC,WAAmB;IACxC,OAAO,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDxB,CAAC;AACF,CAAC"}

package/dist/cli/generators/scaffold/templates/index.d.ts

@@ -1,5 +1,6 @@
 export { packageJson } from "./package.json";
 export { tsconfig } from "./tsconfig.json";
+export { appTs } from "./src/app.ts";
 export { mainTs } from "./src/main.ts";
-export { mainTest } from "./src/main.test.ts";
+export { appTest } from "./src/app.test.ts";
 export { readme } from "./README.md";

package/dist/cli/generators/scaffold/templates/index.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readme = exports.mainTest = exports.mainTs = exports.tsconfig = exports.packageJson = void 0;
+exports.readme = exports.appTest = exports.mainTs = exports.appTs = exports.tsconfig = exports.packageJson = void 0;
 var package_json_1 = require("./package.json");
 Object.defineProperty(exports, "packageJson", { enumerable: true, get: function () { return package_json_1.packageJson; } });
 var tsconfig_json_1 = require("./tsconfig.json");
 Object.defineProperty(exports, "tsconfig", { enumerable: true, get: function () { return tsconfig_json_1.tsconfig; } });
+var app_ts_1 = require("./src/app.ts");
+Object.defineProperty(exports, "appTs", { enumerable: true, get: function () { return app_ts_1.appTs; } });
 var main_ts_1 = require("./src/main.ts");
 Object.defineProperty(exports, "mainTs", { enumerable: true, get: function () { return main_ts_1.mainTs; } });
-var main_test_ts_1 = require("./src/main.test.ts");
-Object.defineProperty(exports, "mainTest", { enumerable: true, get: function () { return main_test_ts_1.mainTest; } });
+var app_test_ts_1 = require("./src/app.test.ts");
+Object.defineProperty(exports, "appTest", { enumerable: true, get: function () { return app_test_ts_1.appTest; } });
 var README_md_1 = require("./README.md");
 Object.defineProperty(exports, "readme", { enumerable: true, get: function () { return README_md_1.readme; } });
 //# sourceMappingURL=index.js.map

package/dist/cli/generators/scaffold/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/index.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA2C;AAAlC,yGAAA,QAAQ,OAAA;AACjB,yCAAuC;AAA9B,iGAAA,MAAM,OAAA;AACf,mDAA8C;AAArC,wGAAA,QAAQ,OAAA;AACjB,yCAAqC;AAA5B,mGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/index.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA2C;AAAlC,yGAAA,QAAQ,OAAA;AACjB,uCAAqC;AAA5B,+FAAA,KAAK,OAAA;AACd,yCAAuC;AAA9B,iGAAA,MAAM,OAAA;AACf,iDAA4C;AAAnC,sGAAA,OAAO,OAAA;AAChB,yCAAqC;AAA5B,mGAAA,MAAM,OAAA"}

package/dist/cli/generators/scaffold/templates/package.json.d.ts

@@ -9,13 +9,18 @@ export declare function packageJson(projectName: string): {
         readonly build: "tsc -p tsconfig.json";
         readonly test: "vitest run";
         readonly "test:watch": "vitest";
+        readonly qa: "npm run build && npm run test";
         readonly "schema:sdl": "runner-dev schema sdl";
+        readonly "skills:extract": "npm-skills extract --skip-production --override";
+        readonly postinstall: "npm run skills:extract";
     };
     readonly dependencies: {
-        readonly "@bluelibs/runner": "^6.2.0";
+        readonly "@bluelibs/runner": "^6.4.0";
+        readonly "npm-skills": "^0.5.0";
     };
     readonly devDependencies: {
-        readonly "@bluelibs/runner-dev": "^6.2.0";
+        readonly "@bluelibs/runner-dev": "^6.4.0";
+        readonly "@types/node": "^20.0.0";
         readonly typescript: "^5.6.3";
         readonly tsx: "^4.20.5";
         readonly vitest: "^3.2.4";

package/dist/cli/generators/scaffold/templates/package.json.js

@@ -13,13 +13,18 @@ function packageJson(projectName) {
             build: "tsc -p tsconfig.json",
             test: "vitest run",
             "test:watch": "vitest",
+            qa: "npm run build && npm run test",
             "schema:sdl": "runner-dev schema sdl",
+            "skills:extract": "npm-skills extract --skip-production --override",
+            postinstall: "npm run skills:extract",
         },
         dependencies: {
-            "@bluelibs/runner": "^6.2.0",
+            "@bluelibs/runner": "^6.4.0",
+            "npm-skills": "^0.5.0",
         },
         devDependencies: {
-            "@bluelibs/runner-dev": "^6.2.0",
+            "@bluelibs/runner-dev": "^6.4.0",
+            "@types/node": "^20.0.0",
             typescript: "^5.6.3",
             tsx: "^4.20.5",
             vitest: "^3.2.4",

package/dist/cli/generators/scaffold/templates/package.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"package.json.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/package.json.ts"],"names":[],"mappings":";;AAAA,kCAwBC;AAxBD,SAAgB,WAAW,CAAC,WAAmB;IAC7C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP,GAAG,EAAE,uBAAuB;YAC5B,KAAK,EAAE,wCAAwC;YAC/C,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,YAAY;YAClB,YAAY,EAAE,QAAQ;YACtB,YAAY,EAAE,uBAAuB;SACtC;QACD,YAAY,EAAE;YACZ,kBAAkB,EAAE,QAAQ;SAC7B;QACD,eAAe,EAAE;YACf,sBAAsB,EAAE,QAAQ;YAChC,UAAU,EAAE,QAAQ;YACpB,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,QAAQ;SACjB;KACO,CAAC;AACb,CAAC"}
+{"version":3,"file":"package.json.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/package.json.ts"],"names":[],"mappings":";;AAAA,kCA6BC;AA7BD,SAAgB,WAAW,CAAC,WAAmB;IAC7C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE;YACP,GAAG,EAAE,uBAAuB;YAC5B,KAAK,EAAE,wCAAwC;YAC/C,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,YAAY;YAClB,YAAY,EAAE,QAAQ;YACtB,EAAE,EAAE,+BAA+B;YACnC,YAAY,EAAE,uBAAuB;YACrC,gBAAgB,EAAE,iDAAiD;YACnE,WAAW,EAAE,wBAAwB;SACtC;QACD,YAAY,EAAE;YACZ,kBAAkB,EAAE,QAAQ;YAC5B,YAAY,EAAE,QAAQ;SACvB;QACD,eAAe,EAAE;YACf,sBAAsB,EAAE,QAAQ;YAChC,aAAa,EAAE,SAAS;YACxB,UAAU,EAAE,QAAQ;YACpB,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,QAAQ;SACjB;KACO,CAAC;AACb,CAAC"}

package/dist/cli/generators/scaffold/templates/src/app.test.ts.d.ts

@@ -0,0 +1 @@
+export declare function appTest(): string;

package/dist/cli/generators/scaffold/templates/src/app.test.ts.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appTest = appTest;
+function appTest() {
+    return `import { resources, run } from '@bluelibs/runner';
+import { afterEach, describe, expect, it } from 'vitest';
+import { app } from './app';
+
+const runtimes: Array<{ dispose: () => Promise<void> }> = [];
+
+afterEach(async () => {
+  while (runtimes.length > 0) {
+    await runtimes.pop()?.dispose();
+  }
+});
+
+describe('app', () => {
+  it('boots the runtime and exposes the dev docs endpoint', async () => {
+    const runtime = await run(app);
+    runtimes.push(runtime);
+    const store = await runtime.getResourceValue(resources.store);
+
+    expect(runtime).toBeDefined();
+    expect(store).toBe(runtime.store);
+  });
+});
+`;
+}
+//# sourceMappingURL=app.test.ts.js.map

package/dist/cli/generators/scaffold/templates/src/app.test.ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.test.ts.js","sourceRoot":"","sources":["../../../../../../src/cli/generators/scaffold/templates/src/app.test.ts.ts"],"names":[],"mappings":";;AAAA,0BAwBC;AAxBD,SAAgB,OAAO;IACrB,OAAO;;;;;;;;;;;;;;;;;;;;;;CAsBR,CAAC;AACF,CAAC"}

package/dist/cli/generators/scaffold/templates/src/app.ts.d.ts

@@ -0,0 +1 @@
+export declare function appTs(projectName: string): string;

package/dist/cli/generators/scaffold/templates/src/app.ts.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appTs = appTs;
+function appTs(projectName) {
+    return `import { r } from '@bluelibs/runner';
+import { dev } from '@bluelibs/runner-dev';
+
+export const app = r.resource('${projectName}')
+  .register([
+    dev.with({ port: 1337 }),
+  ])
+  .build();
+`;
+}
+//# sourceMappingURL=app.ts.js.map

package/dist/cli/generators/scaffold/templates/src/app.ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.ts.js","sourceRoot":"","sources":["../../../../../../src/cli/generators/scaffold/templates/src/app.ts.ts"],"names":[],"mappings":";;AAAA,sBAUC;AAVD,SAAgB,KAAK,CAAC,WAAmB;IACvC,OAAO;;;iCAGwB,WAAW;;;;;CAK3C,CAAC;AACF,CAAC"}

package/dist/cli/generators/scaffold/templates/src/main.ts.js

@@ -2,19 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mainTs = mainTs;
 function mainTs(projectName) {
-    return `import { r, run } from '@bluelibs/runner';
-import { dev } from '@bluelibs/runner-dev';
-
-// Minimal Runner 6.2 app using a root resource and runner-dev's dev resource
-const app = r.resource('${projectName}')
-  .register([
-    dev.with({ port: 1337 }),
-  ])
-  .build();
+    return `import { run } from '@bluelibs/runner';
+import { app } from './app';
 
 run(app)
   .then(({ logger }) => {
-    logger.info('Runner app started on http://localhost:1337');
+    logger.info('${projectName} is running!');
   })
   .catch((err) => {
     // eslint-disable-next-line no-console

package/dist/cli/generators/scaffold/templates/src/main.ts.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.ts.js","sourceRoot":"","sources":["../../../../../../src/cli/generators/scaffold/templates/src/main.ts.ts"],"names":[],"mappings":";;AAAA,wBAqBC;AArBD,SAAgB,MAAM,CAAC,WAAmB;IACxC,OAAO;;;;0BAIiB,WAAW;;;;;;;;;;;;;;;CAepC,CAAC;AACF,CAAC"}
+{"version":3,"file":"main.ts.js","sourceRoot":"","sources":["../../../../../../src/cli/generators/scaffold/templates/src/main.ts.ts"],"names":[],"mappings":";;AAAA,wBAcC;AAdD,SAAgB,MAAM,CAAC,WAAmB;IACxC,OAAO;;;;;mBAKU,WAAW;;;;;;;CAO7B,CAAC;AACF,CAAC"}

package/dist/cli/generators/scaffold/templates/tsconfig.json.d.ts

@@ -1,9 +1,10 @@
 export declare function tsconfig(): {
     readonly compilerOptions: {
         readonly target: "ESNext";
-        readonly module: "Node16";
-        readonly moduleResolution: "node16";
+        readonly module: "CommonJS";
+        readonly moduleResolution: "node";
         readonly strict: true;
+        readonly types: readonly ["node"];
         readonly esModuleInterop: true;
         readonly forceConsistentCasingInFileNames: true;
         readonly declaration: true;
@@ -14,4 +15,5 @@ export declare function tsconfig(): {
         readonly lib: readonly ["ESNext"];
     };
     readonly include: readonly ["src"];
+    readonly exclude: readonly ["src/**/*.test.ts"];
 };

package/dist/cli/generators/scaffold/templates/tsconfig.json.js

@@ -5,9 +5,10 @@ function tsconfig() {
     return {
         compilerOptions: {
             target: "ESNext",
-            module: "Node16",
-            moduleResolution: "node16",
+            module: "CommonJS",
+            moduleResolution: "node",
             strict: true,
+            types: ["node"],
             esModuleInterop: true,
             forceConsistentCasingInFileNames: true,
             declaration: true,
@@ -18,6 +19,7 @@ function tsconfig() {
             lib: ["ESNext"],
         },
         include: ["src"],
+        exclude: ["src/**/*.test.ts"],
     };
 }
 //# sourceMappingURL=tsconfig.json.js.map

package/dist/cli/generators/scaffold/templates/tsconfig.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"tsconfig.json.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/tsconfig.json.ts"],"names":[],"mappings":";;AAAA,4BAkBC;AAlBD,SAAgB,QAAQ;IACtB,OAAO;QACL,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,gCAAgC,EAAE,IAAI;YACtC,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,GAAG,EAAE,CAAC,QAAQ,CAAC;SAChB;QACD,OAAO,EAAE,CAAC,KAAK,CAAC;KACR,CAAC;AACb,CAAC"}
+{"version":3,"file":"tsconfig.json.js","sourceRoot":"","sources":["../../../../../src/cli/generators/scaffold/templates/tsconfig.json.ts"],"names":[],"mappings":";;AAAA,4BAoBC;AApBD,SAAgB,QAAQ;IACtB,OAAO;QACL,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,MAAM;YACxB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,eAAe,EAAE,IAAI;YACrB,gCAAgC,EAAE,IAAI;YACtC,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,IAAI;YACvB,GAAG,EAAE,CAAC,QAAQ,CAAC;SAChB;QACD,OAAO,EAAE,CAAC,KAAK,CAAC;QAChB,OAAO,EAAE,CAAC,kBAAkB,CAAC;KACrB,CAAC;AACb,CAAC"}

package/dist/cli/generators/scaffold.js

@@ -37,8 +37,9 @@ async function scaffold(opts) {
     await (0, initUtils_1.writeJson)(path_1.default.join(targetDir, "package.json"), templates.packageJson(projectName));
     await (0, initUtils_1.writeJson)(path_1.default.join(targetDir, "tsconfig.json"), templates.tsconfig());
     await (0, initUtils_1.ensureDir)(path_1.default.join(targetDir, "src"));
+    await (0, initUtils_1.writeFile)(path_1.default.join(targetDir, "src", "app.ts"), templates.appTs(projectName));
     await (0, initUtils_1.writeFile)(path_1.default.join(targetDir, "src", "main.ts"), templates.mainTs(projectName));
-    await (0, initUtils_1.writeFile)(path_1.default.join(targetDir, "src", "main.test.ts"), templates.mainTest());
+    await (0, initUtils_1.writeFile)(path_1.default.join(targetDir, "src", "app.test.ts"), templates.appTest());
     await (0, initUtils_1.writeFile)(path_1.default.join(targetDir, "README.md"), templates.readme(projectName));
     await (0, initUtils_1.writeGitignore)(targetDir);
 }

package/dist/cli/generators/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/generators/scaffold.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,4BA0BC;AAnCD,gDAAwB;AACxB,2CAA8E;AAC9E,gEAAkD;AAO3C,KAAK,UAAU,QAAQ,CAAC,IAAqB;IAClD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAExC,+CAA+C;IAE/C,yBAAyB;IACzB,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CACnC,CAAC;IACF,MAAM,IAAA,qBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE7E,MAAM,IAAA,qBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EACtC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,EAC3C,SAAS,CAAC,QAAQ,EAAE,CACrB,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,IAAA,0BAAc,EAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/generators/scaffold.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,4BA8BC;AAvCD,gDAAwB;AACxB,2CAA8E;AAC9E,gEAAkD;AAO3C,KAAK,UAAU,QAAQ,CAAC,IAAqB;IAClD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAExC,+CAA+C;IAE/C,yBAAyB;IACzB,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CACnC,CAAC;IACF,MAAM,IAAA,qBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE7E,MAAM,IAAA,qBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,EACrC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,CAC7B,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EACtC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,EAC1C,SAAS,CAAC,OAAO,EAAE,CACpB,CAAC;IACF,MAAM,IAAA,qBAAS,EACb,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,IAAA,0BAAc,EAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/docs/packageDocs.d.ts

@@ -0,0 +1,16 @@
+export declare const RUNNER_FRAMEWORK_COMPACT_DOC_PATHS: readonly ["readmes/COMPACT_GUIDE.md"];
+export declare const RUNNER_FRAMEWORK_COMPLETE_DOC_PATHS: readonly ["readmes/FULL_GUIDE.md"];
+export declare class PackageDocNotFoundError extends Error {
+    readonly attemptedPaths: string[];
+    constructor(packageName: string, docPaths: readonly string[], attemptedPaths: string[]);
+}
+export declare function readPackageDoc(packageName: string, docPath?: string): Promise<{
+    packageName: string;
+    filePath: string;
+    content: string;
+}>;
+export declare function readFirstAvailablePackageDoc(packageName: string, docPaths: string[]): Promise<{
+    packageName: string;
+    filePath: string;
+    content: string;
+}>;