@arki/dot 0.2.0 → 0.4.0

package/dist/test-harness.js

@@ -1,37 +1,37 @@
 /**
- * Test harness for unit-testing DOT pips.
+ * Test harness for unit-testing DOT plugins.
  *
- * Provides `testApp` — a convenience wrapper that lets pip authors verify
+ * Provides `testApp` — a convenience wrapper that lets plugin authors verify
  * lifecycle behaviour, registration, and service publishing without dragging
  * in concrete framework dependencies.
  *
- * NOTE: `testApp` takes an erased pip array, so the compile-time wiring
+ * NOTE: `testApp` takes an erased plugin array, so the compile-time wiring
  * guard does not apply here — the kernel's runtime validation (unsatisfied
  * needs, collisions) still does. Use `defineApp(...).use(...)` chains in
  * tests that should exercise the type-level guard.
  *
  * @example
- *   import { testApp, pip } from '@arki/dot';
+ *   import { testApp, plugin } from '@arki/dot';
  *
- *   const myPip = pip({
+ *   const myPlugin = plugin({
  *     name: 'counter',
  *     boot: () => ({ counter: { value: 0 } }),
  *   });
  *
  *   it('publishes a counter service', async () => {
- *     const app = await bootTestApp<{ counter: { value: number } }>([myPip]);
+ *     const app = await bootTestApp<{ counter: { value: number } }>([myPlugin]);
  *     expect(app.services.counter.value).toBe(0);
  *     await app.dispose();
  *   });
  */
 import { defineApp } from './define-app.js';
 /**
- * Build a DOT app builder pre-populated with the given pips, ready to
+ * Build a DOT app builder pre-populated with the given plugins, ready to
  * `.configure()`, `.boot()` or `.start()` from a test.
  */
-export function testApp(pips = [], options = {}) {
+export function testApp(plugins = [], options = {}) {
     let builder = defineApp(options.name ?? 'test-app', { config: options.config });
-    for (const p of pips) {
+    for (const p of plugins) {
         builder = builder.use(p);
     }
     return builder;
@@ -40,22 +40,22 @@ export function testApp(pips = [], options = {}) {
  * Convenience: build, boot, return the running app. Caller is responsible for
  * calling `app.dispose()` when finished.
  */
-export async function bootTestApp(pips = [], options = {}) {
-    return testApp(pips, options).boot();
+export async function bootTestApp(plugins = [], options = {}) {
+    return testApp(plugins, options).boot();
 }
 /**
- * Unit-test a single pip with **typed overrides** — the compile-checked
+ * Unit-test a single plugin with **typed overrides** — the compile-checked
  * counterpart to {@link testApp}'s erased arrays.
  *
- * Each `.provide()` satisfies one of the pip's needs directly (no real
- * provider pip, no dependency chain) and removes it from the builder's
+ * Each `.provide()` satisfies one of the plugin's needs directly (no real
+ * provider plugin, no dependency chain) and removes it from the builder's
  * remaining-needs type. `boot()` only compiles once every need is covered,
  * and a fake of the wrong shape fails at the `.provide()` call site:
  *
  * ```ts
- * import { testPip } from '@arki/dot/test-harness';
+ * import { testPlugin } from '@arki/dot/test-harness';
  *
- * const app = await testPip(catalog)
+ * const app = await testPlugin(catalog)
  *   .provide(Db, fakeDb)          // token need
  *   .provide('cache', fakeKv)     // anonymous need — wire key is the alias
  *   .boot();
@@ -67,41 +67,42 @@ export async function bootTestApp(pips = [], options = {}) {
  * `service.lazy<T>()` needs accept either a plain `T` fake (the kernel
  * lifts it) or a `Lazy<T>` handle (`lazyOf(value)` is handy here).
  * Lifecycle semantics are the real kernel's — the fakes are published by a
- * synthetic first pip, so reverse-order teardown and lazy auto-dispose
+ * synthetic first plugin, so reverse-order teardown and lazy auto-dispose
  * behave exactly as in production.
  */
-export function testPip(pip, options = {}) {
+export function testPlugin(plugin, options = {}) {
     // Erasure seam — same boundary as `makeBuilder` in define-app.ts: the
     // runtime impl is untyped, the type parameters do all the guarding.
-    return makeTestPipBuilder({ pip: pip, fakes: {}, options });
+    return makeTestPluginBuilder({ plugin: plugin, fakes: {}, options });
 }
 /**
- * Erased implementation behind {@link testPip}. Mirrors `makeBuilder` in
+ * Erased implementation behind {@link testPlugin}. Mirrors `makeBuilder` in
  * `define-app.ts`: the runtime is untyped, the single cast at the return
  * is the seam, and the type parameters do all the guarding.
  */
-function makeTestPipBuilder(state) {
+function makeTestPluginBuilder(state) {
     const bootApp = async () => {
-        const pips = [];
+        const plugins = [];
         if (Object.keys(state.fakes).length > 0) {
             const fakes = { ...state.fakes };
-            pips.push({
-                name: `test:fakes(${state.pip.name})`,
+            plugins.push({
+                name: `test:fakes(${state.plugin.name})`,
                 needs: {},
+                actions: [],
                 renames: {},
                 hooks: { boot: () => fakes },
             });
         }
-        pips.push(state.pip);
-        return testApp(pips, {
-            name: state.options.name ?? `test:${state.pip.name}`,
+        plugins.push(state.plugin);
+        return testApp(plugins, {
+            name: state.options.name ?? `test:${state.plugin.name}`,
             ...(state.options.config === undefined ? {} : { config: state.options.config }),
         }).boot();
     };
     const impl = {
         provide(tokenOrKey, value) {
             const key = typeof tokenOrKey === 'string' ? tokenOrKey : tokenOrKey.key;
-            return makeTestPipBuilder({ ...state, fakes: { ...state.fakes, [key]: value } });
+            return makeTestPluginBuilder({ ...state, fakes: { ...state.fakes, [key]: value } });
         },
         async boot(..._guard) {
             return bootApp();

package/dist/test-harness.js.map

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

package/dist/timeline.d.ts

@@ -1,7 +1,7 @@
 /**
  * ASCII waterfall renderer for DOT lifecycle diagnostics.
  *
- * Given a `DotDiagnosticsSnapshot`, builds a compact per-phase, per-pip
+ * Given a `DotDiagnosticsSnapshot`, builds a compact per-phase, per-plugin
  * duration chart suitable for printing in a terminal or embedding in a
  * `dot doctor` text report. No colour, no Unicode beyond `█` so the
  * output stays clean in log aggregators and CI.
@@ -29,7 +29,7 @@ export type RenderTimelineOptions = {
     /** Maximum bar width in characters (default `50`). */
     readonly barWidth?: number;
     /**
-     * When `true`, also emit any pip's diagnostic `issues[]` underneath
+     * When `true`, also emit any plugin's diagnostic `issues[]` underneath
      * the bar so failure reasons are visible in the timeline view.
      * Default `true`.
      */

package/dist/timeline.js

@@ -1,7 +1,7 @@
 /**
  * ASCII waterfall renderer for DOT lifecycle diagnostics.
  *
- * Given a `DotDiagnosticsSnapshot`, builds a compact per-phase, per-pip
+ * Given a `DotDiagnosticsSnapshot`, builds a compact per-phase, per-plugin
  * duration chart suitable for printing in a terminal or embedding in a
  * `dot doctor` text report. No colour, no Unicode beyond `█` so the
  * output stays clean in log aggregators and CI.
@@ -60,8 +60,8 @@ export function renderTimeline(snapshot, opts = {}) {
     const title = `Timeline: ${snapshot.app.name} (state=${snapshot.app.state})`;
     lines.push(title);
     lines.push('─'.repeat(title.length));
-    // Layout: 2-space indent, 10-char pip column, 8-char duration column, then bar.
-    const PIP_COL = 12;
+    // Layout: 2-space indent, 10-char plugin column, 8-char duration column, then bar.
+    const PLUGIN_COL = 12;
     const DUR_COL = 8;
     const indent = '  ';
     let anyRendered = false;
@@ -77,9 +77,9 @@ export function renderTimeline(snapshot, opts = {}) {
             const durationMs = entry.durationMs ?? 0;
             const bar = makeBar(durationMs, maxDuration, barWidth);
             const failedMark = entry.state === 'failed' ? ' ✗' : '';
-            const pipCol = entry.pip.padEnd(PIP_COL);
+            const pluginCol = entry.plugin.padEnd(PLUGIN_COL);
             const durCol = formatDuration(durationMs).padStart(DUR_COL);
-            lines.push(`${indent}${pipCol}${durCol}  ${bar}${failedMark}`);
+            lines.push(`${indent}${pluginCol}${durCol}  ${bar}${failedMark}`);
             if (showIssues && entry.issues.length > 0) {
                 for (const issue of entry.issues) {
                     lines.push(`${indent}  └─ ${issue.code}: ${issue.message}`);

package/dist/timeline.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arki/dot",
-  "version": "0.2.0",
-  "description": "TypeScript-first application composition framework for the ARKI package family — lifecycle-aware pips, deterministic boot order, manifest/diagnostics envelopes, and an agent-native CLI. A DOT app is the sum of its pips.",
+  "version": "0.4.0",
+  "description": "TypeScript-first application composition framework for the ARKI package family — lifecycle-aware plugins, deterministic boot order, manifest/diagnostics envelopes, and an agent-native CLI. A DOT app is the sum of its plugins.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -15,8 +15,8 @@
     "arki",
     "typescript",
     "framework",
-    "pip",
-    "pips",
+    "plugin",
+    "plugins",
     "lifecycle",
     "diagnostics",
     "manifest",
@@ -31,10 +31,10 @@
       "import": "./src/index.ts",
       "default": "./dist/index.js"
     },
-    "./pip": {
-      "types": "./dist/pip.d.ts",
-      "import": "./dist/pip.js",
-      "default": "./dist/pip.js"
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
     },
     "./package.json": "./package.json",
     "./cli": {
@@ -63,7 +63,7 @@
   ],
   "dependencies": {
     "@arki/assert": "0.0.2",
-    "@arki/contracts": "0.0.2",
+    "@arki/contracts": "0.0.3",
     "@arki/log": "0.0.2",
     "@opentelemetry/api": "^1.9.0",
     "zod": "4.3.5"

package/src/cli/discover.ts

@@ -186,7 +186,7 @@ export async function loadAppFromFile(filePath: string): Promise<DiscoveredApp>
     code: DotCliErrorCode.AppInvalidExport,
     message: `Default export from ${filePath} is not a DotApp or DotAppBuilder.`,
     remediation:
-      'Export a DotApp or DotAppBuilder as the default. Example: `export default defineApp("my-app").use(pip);`',
+      'Export a DotApp or DotAppBuilder as the default. Example: `export default defineApp("my-app").use(plugin);`',
     metadata: { filePath },
   });
 }
@@ -204,7 +204,7 @@ export async function discoverApp(options: DiscoveryOptions = {}): Promise<Disco
       code: DotCliErrorCode.AppNotFound,
       message: `No DOT app file found in ${cwd}.`,
       remediation:
-        'Create `dot.config.ts` exporting your app (e.g. `export default defineApp("my-app").use(pip)`), or pass `--app <path>` to point at an existing file.',
+        'Create `dot.config.ts` exporting your app (e.g. `export default defineApp("my-app").use(plugin)`), or pass `--app <path>` to point at an existing file.',
       metadata: { cwd, searched: DEFAULT_APP_PATHS },
     });
   }

package/src/cli/error-codes.ts

@@ -21,6 +21,14 @@ export const DotCliErrorCode = {
   AppLifecycleFailed: 'DOT_CLI_E006',
   /** `dot doctor --observability` ran but no OTel SDK is registered. */
   ObservabilityNoSdk: 'DOT_CLI_E007',
+  /** Requested projection format is not registered by the app. */
+  ProjectionNotFound: 'DOT_CLI_E008',
+  /** Projection module import failed or did not export `project`. */
+  ProjectionImportFailed: 'DOT_CLI_E009',
+  /** Projection execution failed or returned non-JSON output. */
+  ProjectionExecutionFailed: 'DOT_CLI_E010',
+  /** Multiple modules claim the same projection format. */
+  ProjectionConflict: 'DOT_CLI_E011',
 } as const;
 
 export type DotCliErrorCodeValue = (typeof DotCliErrorCode)[keyof typeof DotCliErrorCode];
@@ -39,6 +47,10 @@ export const DotCliDocsAnchor: Record<DotCliErrorCodeValue, string> = {
   [DotCliErrorCode.InvalidArgs]: 'invalid-args',
   [DotCliErrorCode.AppLifecycleFailed]: 'app-lifecycle-failed',
   [DotCliErrorCode.ObservabilityNoSdk]: 'observability-no-sdk',
+  [DotCliErrorCode.ProjectionNotFound]: 'projection-not-found',
+  [DotCliErrorCode.ProjectionImportFailed]: 'projection-import-failed',
+  [DotCliErrorCode.ProjectionExecutionFailed]: 'projection-execution-failed',
+  [DotCliErrorCode.ProjectionConflict]: 'projection-conflict',
 };
 
 export function dotCliDocsUrl(code: DotCliErrorCodeValue): string {

package/src/cli/index.ts

@@ -24,7 +24,7 @@ import { createDebugLogger } from '@arki/log/debug';
 
 import type { DotApp, DotAppBuilder, DotAppConfigured } from '../define-app.js';
 import type { DiagnosticIssue } from '../diagnostics.js';
-import type { DiscoveredApp } from './discover.js';
+import type { DiscoveredApp, DiscoveryResult } from './discover.js';
 import type { DotCliEnvelope, DotCliEnvelopeStatus } from './render-explain.js';
 import { DotLifecycleError } from '../lifecycle.js';
 import { discoverApp, guards } from './discover.js';
@@ -34,6 +34,7 @@ import { probeObservability } from './observability-probe.js';
 import { renderDoctor } from './render-doctor.js';
 import { renderExplain } from './render-explain.js';
 import { renderGraph } from './render-graph.js';
+import { renderProjection } from './render-projection.js';
 
 const debugCli = createDebugLogger('arki:dot:cli');
 
@@ -58,10 +59,16 @@ Common options:
   --app <path>           Path to the app entry file (default: discovers
                          ./dot.config.ts, ./src/app.ts, or ./app.ts)
   --cwd <dir>            Working directory (default: current)
-  --graph                Emit the pip graph as Mermaid flowchart source
+  --graph                Emit the plugin graph as Mermaid flowchart source
                          instead of the standard output. explain shows
                          declaration (= boot) order; doctor shows the
                          wiring observed during boot. Composes with --json.
+  --as <format>          (explain only) Render a registered projection format.
+                         Examples: openapi, asyncapi, help-text. Composes
+                         with --json.
+  --module <specifier>   (explain --as only) Override the registered
+                         projection module for one invocation.
+  --openapi              Deprecated alias for --as openapi.
 
 \`doctor\` options:
   --observability        Also probe whether an OpenTelemetry SDK is
@@ -96,6 +103,12 @@ export type CliArgs = {
   observability?: boolean;
   /** `--graph` (honored by `explain` and `doctor`). */
   graph?: boolean;
+  /** `--as` projection format (honored by `explain` only). */
+  as?: string;
+  /** `--module` projection override (honored by `explain --as` only). */
+  module?: string;
+  /** Deprecated `--openapi` alias for `--as openapi`. */
+  openapi?: boolean;
 };
 
 /**
@@ -160,6 +173,9 @@ export function parseArgs(argv: readonly string[]): CliArgs {
         force: { type: 'boolean', default: false },
         observability: { type: 'boolean', default: false },
         graph: { type: 'boolean', default: false },
+        as: { type: 'string' },
+        module: { type: 'string' },
+        openapi: { type: 'boolean', default: false },
       },
     });
   } catch (err) {
@@ -183,6 +199,9 @@ export function parseArgs(argv: readonly string[]): CliArgs {
     force?: boolean;
     observability?: boolean;
     graph?: boolean;
+    as?: string;
+    module?: string;
+    openapi?: boolean;
   };
 
   if (values.help) command = 'help';
@@ -190,6 +209,30 @@ export function parseArgs(argv: readonly string[]): CliArgs {
 
   if (!command) command = 'help';
 
+  const projectionFormat = values.as ?? (values.openapi === true ? 'openapi' : undefined);
+
+  if (projectionFormat !== undefined && values.graph === true) {
+    throw new DotCliError({
+      code: DotCliErrorCode.InvalidArgs,
+      message: '--as/--openapi and --graph are mutually exclusive.',
+      remediation: 'Pick one output format per invocation.',
+    });
+  }
+  if (projectionFormat !== undefined && command === 'doctor') {
+    throw new DotCliError({
+      code: DotCliErrorCode.InvalidArgs,
+      message: '--as is not supported by doctor.',
+      remediation: 'Use `dot explain --as <format>` — projections render from the static manifest, no boot needed.',
+    });
+  }
+  if (values.module !== undefined && projectionFormat === undefined) {
+    throw new DotCliError({
+      code: DotCliErrorCode.InvalidArgs,
+      message: '--module requires --as <format>.',
+      remediation: 'Pass a projection format with --as, or remove --module.',
+    });
+  }
+
   let pm: CliArgs['pm'];
   if (values.pm !== undefined) {
     if (values.pm !== 'npm' && values.pm !== 'pnpm' && values.pm !== 'bun') {
@@ -215,13 +258,15 @@ export function parseArgs(argv: readonly string[]): CliArgs {
     force: values.force ?? false,
     observability: values.observability ?? false,
     graph: values.graph ?? false,
+    as: projectionFormat,
+    module: values.module,
+    openapi: values.openapi ?? false,
   };
 }
 
 /** Discovery wrapper — returns `null` for help/version commands. */
-async function loadApp(args: CliArgs): Promise<DiscoveredApp> {
-  const { app } = await discoverApp({ appPath: args.appPath, cwd: args.cwd });
-  return app;
+async function loadApp(args: CliArgs): Promise<DiscoveryResult> {
+  return discoverApp({ appPath: args.appPath, cwd: args.cwd });
 }
 
 /**
@@ -230,7 +275,16 @@ async function loadApp(args: CliArgs): Promise<DiscoveredApp> {
  */
 export async function runExplain(
   discovered: DiscoveredApp,
-  opts: { json: boolean; graph?: boolean; out?: (line: string) => void; now?: () => Date },
+  opts: {
+    json: boolean;
+    graph?: boolean;
+    as?: string;
+    module?: string;
+    appFilePath?: string;
+    openapi?: boolean;
+    out?: (line: string) => void;
+    now?: () => Date;
+  },
 ): Promise<DotCliEnvelope<unknown>> {
   let configured: DotApp<Record<string, unknown>> | DotAppConfigured<Record<string, unknown>>;
   try {
@@ -246,6 +300,18 @@ export async function runExplain(
     throw wrapLifecycleError(err, 'configure');
   }
 
+  if (opts.as !== undefined) {
+    return renderProjection(
+      {
+        manifest: configured.manifest,
+        command: 'explain',
+        format: opts.as,
+        appFilePath: opts.appFilePath ?? process.cwd(),
+        ...(opts.module === undefined ? {} : { module: opts.module }),
+      },
+      { json: opts.json, out: opts.out, now: opts.now },
+    );
+  }
   if (opts.graph === true) {
     return renderGraph(
       { manifest: configured.manifest, command: 'explain' },
@@ -265,7 +331,7 @@ type DoctorRunOptions = {
    * present. Default `false`.
    */
   observability?: boolean;
-  /** When `true`, emit the pip graph (Mermaid) instead of diagnostics. */
+  /** When `true`, emit the plugin graph (Mermaid) instead of diagnostics. */
   graph?: boolean;
 };
 
@@ -297,7 +363,7 @@ export async function runDoctor(
   }
 
   // Builder or configured seam: drive lifecycle ourselves. Boot failures fall
-  // back to the configured seam's diagnostics so per-pip issues stay
+  // back to the configured seam's diagnostics so per-plugin issues stay
   // visible.
   let configured: DotAppConfigured<Record<string, unknown>>;
   try {
@@ -314,7 +380,7 @@ export async function runDoctor(
     bootedApp = await configured.boot();
   } catch (err) {
     // Boot failed — surface diagnostics from the configured seam below.
-    // We deliberately swallow the throw so the user sees the per-pip
+    // We deliberately swallow the throw so the user sees the per-plugin
     // issues instead of an opaque wrapper error.
     bootThrew = true;
     debugCli('boot threw, falling back to configured diagnostics: %O', err);
@@ -323,7 +389,7 @@ export async function runDoctor(
   try {
     if (opts.graph === true) {
       // Post-boot manifest carries the observed wiring edges; after a boot
-      // failure it carries the edges recorded up to the failing pip.
+      // failure it carries the edges recorded up to the failing plugin.
       const manifest = bootedApp ? bootedApp.manifest : configured.manifest;
       const graphEnvelope = renderGraph(
         { manifest, command: 'doctor' },
@@ -379,8 +445,8 @@ function wrapLifecycleError(err: unknown, phase: 'configure' | 'boot'): DotCliEr
     message: `App ${phase} failed: ${message}`,
     remediation:
       phase === 'configure'
-        ? 'Check the pips registered in your app for a synchronous `configure` hook that throws or returns a Promise. Run `dot doctor` for per-pip diagnostics.'
-        : 'Run `dot doctor` to see per-pip diagnostics. The boot hook for one of your pips failed.',
+        ? 'Check the plugins registered in your app for a synchronous `configure` hook that throws or returns a Promise. Run `dot doctor` for per-plugin diagnostics.'
+        : 'Run `dot doctor` to see per-plugin diagnostics. The boot hook for one of your plugins failed.',
     metadata: { phase, underlyingCode: code },
     cause: err,
   });
@@ -488,9 +554,18 @@ export async function main(options: MainOptions): Promise<number> {
     let envelope: DotCliEnvelope<unknown>;
 
     if (args.command === 'explain') {
-      envelope = await runExplain(discovered, opts);
+      if (args.openapi === true) {
+        stderr('dot: --openapi is deprecated; use --as openapi.\n');
+      }
+      envelope = await runExplain(discovered.app, {
+        ...opts,
+        as: args.as,
+        module: args.module,
+        appFilePath: discovered.filePath,
+        openapi: args.openapi,
+      });
     } else {
-      envelope = await runDoctor(discovered, { ...opts, observability: args.observability });
+      envelope = await runDoctor(discovered.app, { ...opts, observability: args.observability });
     }
 
     return envelopeExitCode(envelope.status);
@@ -556,11 +631,14 @@ const isMainModule = await (async () => {
     /* ignore */
   }
   // Node fallback: compare argv[1]'s resolved file URL with import.meta.url.
+  // argv[1] is the bin symlink (node_modules/.bin/dot) while Node resolves
+  // import.meta.url to the real file — realpath argv[1] so they can match.
   try {
     const entry = process.argv[1];
     if (typeof entry !== 'string') return false;
     const { pathToFileURL } = await import('node:url');
-    return pathToFileURL(entry).href === import.meta.url;
+    const { realpath } = await import('node:fs/promises');
+    return pathToFileURL(await realpath(entry)).href === import.meta.url;
   } catch {
     return false;
   }

package/src/cli/new.ts

@@ -17,7 +17,7 @@
  * stripped during scaffolding so `package.json.tmpl` becomes
  * `package.json` on disk.
  *
- * Commands deferred to v1.1 (`dot add <pip>`, `dot dev`,
+ * Commands deferred to v1.1 (`dot add <plugin>`, `dot dev`,
  * `dot migrate`) are deliberately NOT surfaced here.
  */
 

package/src/cli/render-doctor.ts

@@ -2,7 +2,7 @@
  * Renderers for `dot doctor`.
  *
  * Reads a booted (or fully-failed) app's `diagnostics` snapshot and emits
- * either a JSON envelope or a human-readable per-pip status report.
+ * either a JSON envelope or a human-readable per-plugin status report.
  *
  * Envelope `status` reflects the worst severity present:
  *   - `failure` if any issue has severity `error`
@@ -27,8 +27,8 @@ function nowIso(opts: RenderOptions): string {
 }
 
 /**
- * Walk every issue carried anywhere in the snapshot (top-level + per-pip +
- * per-route + per-service + per-lifecycle entry) and pick the worst severity.
+ * Walk every issue carried anywhere in the snapshot (top-level + per-plugin +
+ * per-action + per-service + per-lifecycle entry) and pick the worst severity.
  */
 function worstSeverity(snap: DotDiagnosticsSnapshot): DotCliEnvelopeStatus {
   let hasWarning = false;
@@ -46,8 +46,8 @@ function worstSeverity(snap: DotDiagnosticsSnapshot): DotCliEnvelopeStatus {
 
   let hasError = false;
   collect(snap.issues);
-  for (const p of snap.pips) collect(p.issues);
-  for (const r of snap.routes) collect(r.issues);
+  for (const p of snap.plugins) collect(p.issues);
+  for (const action of snap.actions) collect(action.issues);
   for (const s of snap.services) collect(s.issues);
   for (const l of snap.lifecycle) collect(l.issues);
 
@@ -72,8 +72,8 @@ export function buildDoctorEnvelope(
     for (const issue of issues) errors.push(issue);
   };
   collect(source.diagnostics.issues);
-  for (const p of source.diagnostics.pips) collect(p.issues);
-  for (const r of source.diagnostics.routes) collect(r.issues);
+  for (const p of source.diagnostics.plugins) collect(p.issues);
+  for (const action of source.diagnostics.actions) collect(action.issues);
   for (const s of source.diagnostics.services) collect(s.issues);
   for (const l of source.diagnostics.lifecycle) collect(l.issues);
 
@@ -120,13 +120,13 @@ function renderTextDoctor(snap: DotDiagnosticsSnapshot, status: DotCliEnvelopeSt
   lines.push(`generatedAt: ${snap.generatedAt}`);
   lines.push('');
 
-  // Per-pip status
-  lines.push(`Pips (${snap.pips.length})`);
-  if (snap.pips.length === 0) {
+  // Per-plugin status
+  lines.push(`Plugins (${snap.plugins.length})`);
+  if (snap.plugins.length === 0) {
     lines.push('  (none)');
   } else {
-    for (const p of snap.pips) {
-      lines.push(`  ${statusIcon(p.status)} ${p.pip}`);
+    for (const p of snap.plugins) {
+      lines.push(`  ${statusIcon(p.status)} ${p.plugin}`);
       if (p.issues.length > 0) {
         lines.push(...renderIssueLines(p.issues, '    '));
       }
@@ -138,7 +138,7 @@ function renderTextDoctor(snap: DotDiagnosticsSnapshot, status: DotCliEnvelopeSt
   if (snap.services.length > 0) {
     lines.push(`Services (${snap.services.length})`);
     for (const s of snap.services) {
-      lines.push(`  ${statusIcon(s.status)} ${s.service} (pip: ${s.pip})`);
+      lines.push(`  ${statusIcon(s.status)} ${s.service} (plugin: ${s.plugin})`);
       if (s.issues.length > 0) {
         lines.push(...renderIssueLines(s.issues, '    '));
       }
@@ -146,13 +146,13 @@ function renderTextDoctor(snap: DotDiagnosticsSnapshot, status: DotCliEnvelopeSt
     lines.push('');
   }
 
-  // Routes
-  if (snap.routes.length > 0) {
-    lines.push(`Routes (${snap.routes.length})`);
-    for (const r of snap.routes) {
-      lines.push(`  ${statusIcon(r.status)} ${r.id} (pip: ${r.pip})`);
-      if (r.issues.length > 0) {
-        lines.push(...renderIssueLines(r.issues, '    '));
+  // Actions
+  if (snap.actions.length > 0) {
+    lines.push(`Actions (${snap.actions.length})`);
+    for (const action of snap.actions) {
+      lines.push(`  ${statusIcon(action.status)} ${action.binding}:${action.id} (plugin: ${action.plugin})`);
+      if (action.issues.length > 0) {
+        lines.push(...renderIssueLines(action.issues, '    '));
       }
     }
     lines.push('');
@@ -163,7 +163,7 @@ function renderTextDoctor(snap: DotDiagnosticsSnapshot, status: DotCliEnvelopeSt
   if (lifeWithIssues.length > 0) {
     lines.push(`Lifecycle issues (${lifeWithIssues.length})`);
     for (const l of lifeWithIssues) {
-      lines.push(`  ${l.pip}:${l.hook} (order=${l.order}, state=${l.state})`);
+      lines.push(`  ${l.plugin}:${l.hook} (order=${l.order}, state=${l.state})`);
       lines.push(...renderIssueLines(l.issues, '    '));
     }
     lines.push('');