@contractspec/example.lifecycle-cli 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,31 +1,32 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/lifecycle-cli/tsdown.config.js 
-ℹ entry: src/demo.ts, src/example.ts, src/index.ts, src/docs/index.ts, src/docs/lifecycle-cli.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/demo.js                             1.54 kB │ gzip: 0.77 kB
-ℹ dist/docs/lifecycle-cli.docblock.js      1.44 kB │ gzip: 0.72 kB
-ℹ dist/example.js                          0.93 kB │ gzip: 0.50 kB
-ℹ dist/index.js                            0.15 kB │ gzip: 0.11 kB
-ℹ dist/docs/index.js                       0.04 kB │ gzip: 0.06 kB
-ℹ dist/demo.js.map                         2.79 kB │ gzip: 1.18 kB
-ℹ dist/docs/lifecycle-cli.docblock.js.map  1.93 kB │ gzip: 0.90 kB
-ℹ dist/example.js.map                      1.39 kB │ gzip: 0.69 kB
-ℹ dist/example.d.ts.map                    0.13 kB │ gzip: 0.13 kB
-ℹ dist/demo.d.ts.map                       0.12 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts                        0.25 kB │ gzip: 0.17 kB
-ℹ dist/demo.d.ts                           0.16 kB │ gzip: 0.14 kB
-ℹ dist/index.d.ts                          0.13 kB │ gzip: 0.10 kB
-ℹ dist/docs/index.d.ts                     0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/lifecycle-cli.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 15 files, total: 11.01 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - tsdown:external (55%)
-  - rolldown-plugin-dts:generate (43%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=5
+Bundled 5 modules in 5ms
 
-✔ Build complete in 22676ms
+  ./demo.js                       1.73 KB  (entry point)
+  ./index.js                      4.1 KB   (entry point)
+  docs/index.js                   1.43 KB  (entry point)
+  docs/lifecycle-cli.docblock.js  1.43 KB  (entry point)
+  ./example.js                    0.93 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=5
+Bundled 5 modules in 4ms
+
+  ./demo.js                       1.72 KB  (entry point)
+  ./index.js                      4.0 KB   (entry point)
+  docs/index.js                   1.41 KB  (entry point)
+  docs/lifecycle-cli.docblock.js  1.41 KB  (entry point)
+  ./example.js                    0.92 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=5
+Bundled 5 modules in 9ms
+
+  ./demo.js                       1.72 KB  (entry point)
+  ./index.js                      4.0 KB   (entry point)
+  docs/index.js                   1.41 KB  (entry point)
+  docs/lifecycle-cli.docblock.js  1.41 KB  (entry point)
+  ./example.js                    0.92 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @contractspec/example.lifecycle-cli
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/bundle.lifecycle-managed@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.lifecycle@1.58.0
+  - @contractspec/lib.logger@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/demo.js

@@ -0,0 +1,66 @@
+// src/demo.ts
+import {
+  createLifecycleHandlers,
+  LifecycleAssessmentService
+} from "@contractspec/bundle.lifecycle-managed";
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase
+} from "@contractspec/lib.lifecycle";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runLifecycleCliDemo() {
+  const service = new LifecycleAssessmentService({
+    collector: {
+      analyticsAdapter: {
+        async fetch() {
+          return {
+            metrics: {
+              activeUsers: 32,
+              weeklyActiveUsers: 27,
+              retentionRate: 0.36,
+              monthlyRecurringRevenue: 1800,
+              customerCount: 22,
+              teamSize: 6
+            }
+          };
+        }
+      },
+      questionnaireAdapter: {
+        async fetch() {
+          return {
+            axes: {
+              product: ProductPhase.Mvp,
+              company: CompanyPhase.TinyTeam,
+              capital: CapitalPhase.Seed
+            },
+            answers: {
+              interviewCount: 28,
+              primaryPain: "Manual onboarding takes 3 hours per customer."
+            }
+          };
+        }
+      }
+    }
+  });
+  const handlers = createLifecycleHandlers(service);
+  const response = await handlers.runAssessment({
+    body: {
+      tenantId: "demo-tenant",
+      completedMilestones: ["stage0-problem-statement"]
+    }
+  });
+  logger.info("Lifecycle assessment computed", {
+    assessment: response.body.assessment,
+    topRecommendation: response.body.recommendation.actions[0],
+    libraries: response.body.libraries
+  });
+}
+export {
+  runLifecycleCliDemo
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,40 @@
+// src/docs/lifecycle-cli.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.lifecycle-cli",
+    title: "Lifecycle CLI (demo)",
+    summary: "Run a lifecycle assessment from a CLI using the lifecycle-managed bundle (no HTTP server required).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli",
+    tags: ["lifecycle", "cli", "example"],
+    body: `## What this example shows
+- How to call \`LifecycleAssessmentService\` from a Node/Bun script.
+- How to wire mock analytics + questionnaire adapters.
+
+## Run
+- Use the exported function \`runLifecycleCliDemo()\` (or call it from your own CLI wrapper).
+
+## Notes
+- Keep outputs structured; avoid \`console.log\` in production paths.
+- This example is deterministic (fixed inputs → stable output).`
+  },
+  {
+    id: "docs.examples.lifecycle-cli.usage",
+    title: "Lifecycle CLI — Usage",
+    summary: "How to run and tweak the lifecycle assessment demo.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli/usage",
+    tags: ["lifecycle", "cli", "usage"],
+    body: `## Usage
+1) Call \`runLifecycleCliDemo()\`.
+2) Adjust the mock metrics/answers to explore stage outcomes.
+
+## Guardrails
+- Avoid PII in logs.
+- Keep adapters explicit and deterministic for reproducible demos.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/docs/lifecycle-cli.docblock.js

@@ -0,0 +1,40 @@
+// src/docs/lifecycle-cli.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.lifecycle-cli",
+    title: "Lifecycle CLI (demo)",
+    summary: "Run a lifecycle assessment from a CLI using the lifecycle-managed bundle (no HTTP server required).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli",
+    tags: ["lifecycle", "cli", "example"],
+    body: `## What this example shows
+- How to call \`LifecycleAssessmentService\` from a Node/Bun script.
+- How to wire mock analytics + questionnaire adapters.
+
+## Run
+- Use the exported function \`runLifecycleCliDemo()\` (or call it from your own CLI wrapper).
+
+## Notes
+- Keep outputs structured; avoid \`console.log\` in production paths.
+- This example is deterministic (fixed inputs → stable output).`
+  },
+  {
+    id: "docs.examples.lifecycle-cli.usage",
+    title: "Lifecycle CLI — Usage",
+    summary: "How to run and tweak the lifecycle assessment demo.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli/usage",
+    tags: ["lifecycle", "cli", "usage"],
+    body: `## Usage
+1) Call \`runLifecycleCliDemo()\`.
+2) Adjust the mock metrics/answers to explore stage outcomes.
+
+## Guardrails
+- Avoid PII in logs.
+- Keep adapters explicit and deterministic for reproducible demos.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "lifecycle-cli",
+    version: "1.0.0",
+    title: "Lifecycle CLI",
+    description: "Tiny script showing how to run the lifecycle managed service from a CLI (no HTTP server required).",
+    kind: "script",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["lifecycle", "cli", "demo"]
+  },
+  docs: {
+    rootDocId: "docs.examples.lifecycle-cli",
+    usageDocId: "docs.examples.lifecycle-cli.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.lifecycle-cli",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/index.js

@@ -0,0 +1,138 @@
+// src/demo.ts
+import {
+  createLifecycleHandlers,
+  LifecycleAssessmentService
+} from "@contractspec/bundle.lifecycle-managed";
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase
+} from "@contractspec/lib.lifecycle";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
+});
+async function runLifecycleCliDemo() {
+  const service = new LifecycleAssessmentService({
+    collector: {
+      analyticsAdapter: {
+        async fetch() {
+          return {
+            metrics: {
+              activeUsers: 32,
+              weeklyActiveUsers: 27,
+              retentionRate: 0.36,
+              monthlyRecurringRevenue: 1800,
+              customerCount: 22,
+              teamSize: 6
+            }
+          };
+        }
+      },
+      questionnaireAdapter: {
+        async fetch() {
+          return {
+            axes: {
+              product: ProductPhase.Mvp,
+              company: CompanyPhase.TinyTeam,
+              capital: CapitalPhase.Seed
+            },
+            answers: {
+              interviewCount: 28,
+              primaryPain: "Manual onboarding takes 3 hours per customer."
+            }
+          };
+        }
+      }
+    }
+  });
+  const handlers = createLifecycleHandlers(service);
+  const response = await handlers.runAssessment({
+    body: {
+      tenantId: "demo-tenant",
+      completedMilestones: ["stage0-problem-statement"]
+    }
+  });
+  logger.info("Lifecycle assessment computed", {
+    assessment: response.body.assessment,
+    topRecommendation: response.body.recommendation.actions[0],
+    libraries: response.body.libraries
+  });
+}
+
+// src/docs/lifecycle-cli.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.lifecycle-cli",
+    title: "Lifecycle CLI (demo)",
+    summary: "Run a lifecycle assessment from a CLI using the lifecycle-managed bundle (no HTTP server required).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli",
+    tags: ["lifecycle", "cli", "example"],
+    body: `## What this example shows
+- How to call \`LifecycleAssessmentService\` from a Node/Bun script.
+- How to wire mock analytics + questionnaire adapters.
+
+## Run
+- Use the exported function \`runLifecycleCliDemo()\` (or call it from your own CLI wrapper).
+
+## Notes
+- Keep outputs structured; avoid \`console.log\` in production paths.
+- This example is deterministic (fixed inputs → stable output).`
+  },
+  {
+    id: "docs.examples.lifecycle-cli.usage",
+    title: "Lifecycle CLI — Usage",
+    summary: "How to run and tweak the lifecycle assessment demo.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli/usage",
+    tags: ["lifecycle", "cli", "usage"],
+    body: `## Usage
+1) Call \`runLifecycleCliDemo()\`.
+2) Adjust the mock metrics/answers to explore stage outcomes.
+
+## Guardrails
+- Avoid PII in logs.
+- Keep adapters explicit and deterministic for reproducible demos.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "lifecycle-cli",
+    version: "1.0.0",
+    title: "Lifecycle CLI",
+    description: "Tiny script showing how to run the lifecycle managed service from a CLI (no HTTP server required).",
+    kind: "script",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["lifecycle", "cli", "demo"]
+  },
+  docs: {
+    rootDocId: "docs.examples.lifecycle-cli",
+    usageDocId: "docs.examples.lifecycle-cli.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.lifecycle-cli",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  runLifecycleCliDemo,
+  example_default as example
+};

package/dist/demo.d.ts

@@ -1,5 +1,2 @@
-//#region src/demo.d.ts
-declare function runLifecycleCliDemo(): Promise<void>;
-//#endregion
-export { runLifecycleCliDemo };
+export declare function runLifecycleCliDemo(): Promise<void>;
 //# sourceMappingURL=demo.d.ts.map

package/dist/demo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"demo.d.ts","names":[],"sources":["../src/demo.ts"],"mappings":";iBAmBsB,mBAAA,CAAA,GAAuB,OAAA"}
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../src/demo.ts"],"names":[],"mappings":"AAmBA,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDzD"}

package/dist/demo.js

@@ -1,49 +1,67 @@
-import { LifecycleAssessmentService, createLifecycleHandlers } from "@contractspec/bundle.lifecycle-managed";
-import { CapitalPhase, CompanyPhase, ProductPhase } from "@contractspec/lib.lifecycle";
-import { LogLevel, Logger } from "@contractspec/lib.logger";
-
-//#region src/demo.ts
-const logger = new Logger({
-	level: process.env.NODE_ENV === "production" ? LogLevel.INFO : LogLevel.DEBUG,
-	environment: process.env.NODE_ENV || "development",
-	enableColors: process.env.NODE_ENV !== "production"
+// @bun
+// src/demo.ts
+import {
+  createLifecycleHandlers,
+  LifecycleAssessmentService
+} from "@contractspec/bundle.lifecycle-managed";
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase
+} from "@contractspec/lib.lifecycle";
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var logger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableColors: true
 });
 async function runLifecycleCliDemo() {
-	const response = await createLifecycleHandlers(new LifecycleAssessmentService({ collector: {
-		analyticsAdapter: { async fetch() {
-			return { metrics: {
-				activeUsers: 32,
-				weeklyActiveUsers: 27,
-				retentionRate: .36,
-				monthlyRecurringRevenue: 1800,
-				customerCount: 22,
-				teamSize: 6
-			} };
-		} },
-		questionnaireAdapter: { async fetch() {
-			return {
-				axes: {
-					product: ProductPhase.Mvp,
-					company: CompanyPhase.TinyTeam,
-					capital: CapitalPhase.Seed
-				},
-				answers: {
-					interviewCount: 28,
-					primaryPain: "Manual onboarding takes 3 hours per customer."
-				}
-			};
-		} }
-	} })).runAssessment({ body: {
-		tenantId: "demo-tenant",
-		completedMilestones: ["stage0-problem-statement"]
-	} });
-	logger.info("Lifecycle assessment computed", {
-		assessment: response.body.assessment,
-		topRecommendation: response.body.recommendation.actions[0],
-		libraries: response.body.libraries
-	});
+  const service = new LifecycleAssessmentService({
+    collector: {
+      analyticsAdapter: {
+        async fetch() {
+          return {
+            metrics: {
+              activeUsers: 32,
+              weeklyActiveUsers: 27,
+              retentionRate: 0.36,
+              monthlyRecurringRevenue: 1800,
+              customerCount: 22,
+              teamSize: 6
+            }
+          };
+        }
+      },
+      questionnaireAdapter: {
+        async fetch() {
+          return {
+            axes: {
+              product: ProductPhase.Mvp,
+              company: CompanyPhase.TinyTeam,
+              capital: CapitalPhase.Seed
+            },
+            answers: {
+              interviewCount: 28,
+              primaryPain: "Manual onboarding takes 3 hours per customer."
+            }
+          };
+        }
+      }
+    }
+  });
+  const handlers = createLifecycleHandlers(service);
+  const response = await handlers.runAssessment({
+    body: {
+      tenantId: "demo-tenant",
+      completedMilestones: ["stage0-problem-statement"]
+    }
+  });
+  logger.info("Lifecycle assessment computed", {
+    assessment: response.body.assessment,
+    topRecommendation: response.body.recommendation.actions[0],
+    libraries: response.body.libraries
+  });
 }
-
-//#endregion
-export { runLifecycleCliDemo };
-//# sourceMappingURL=demo.js.map
+export {
+  runLifecycleCliDemo
+};

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './lifecycle-cli.docblock';
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC"}

package/dist/docs/index.js

@@ -1 +1,41 @@
-import "./lifecycle-cli.docblock.js";
+// @bun
+// src/docs/lifecycle-cli.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.lifecycle-cli",
+    title: "Lifecycle CLI (demo)",
+    summary: "Run a lifecycle assessment from a CLI using the lifecycle-managed bundle (no HTTP server required).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli",
+    tags: ["lifecycle", "cli", "example"],
+    body: `## What this example shows
+- How to call \`LifecycleAssessmentService\` from a Node/Bun script.
+- How to wire mock analytics + questionnaire adapters.
+
+## Run
+- Use the exported function \`runLifecycleCliDemo()\` (or call it from your own CLI wrapper).
+
+## Notes
+- Keep outputs structured; avoid \`console.log\` in production paths.
+- This example is deterministic (fixed inputs \u2192 stable output).`
+  },
+  {
+    id: "docs.examples.lifecycle-cli.usage",
+    title: "Lifecycle CLI \u2014 Usage",
+    summary: "How to run and tweak the lifecycle assessment demo.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli/usage",
+    tags: ["lifecycle", "cli", "usage"],
+    body: `## Usage
+1) Call \`runLifecycleCliDemo()\`.
+2) Adjust the mock metrics/answers to explore stage outcomes.
+
+## Guardrails
+- Avoid PII in logs.
+- Keep adapters explicit and deterministic for reproducible demos.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/docs/lifecycle-cli.docblock.d.ts

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=lifecycle-cli.docblock.d.ts.map

package/dist/docs/lifecycle-cli.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-cli.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/lifecycle-cli.docblock.ts"],"names":[],"mappings":""}

package/dist/docs/lifecycle-cli.docblock.js

@@ -1,33 +1,41 @@
+// @bun
+// src/docs/lifecycle-cli.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.lifecycle-cli",
+    title: "Lifecycle CLI (demo)",
+    summary: "Run a lifecycle assessment from a CLI using the lifecycle-managed bundle (no HTTP server required).",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli",
+    tags: ["lifecycle", "cli", "example"],
+    body: `## What this example shows
+- How to call \`LifecycleAssessmentService\` from a Node/Bun script.
+- How to wire mock analytics + questionnaire adapters.
 
-//#region src/docs/lifecycle-cli.docblock.ts
-registerDocBlocks([{
-	id: "docs.examples.lifecycle-cli",
-	title: "Lifecycle CLI (demo)",
-	summary: "Run a lifecycle assessment from a CLI using the lifecycle-managed bundle (no HTTP server required).",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/examples/lifecycle-cli",
-	tags: [
-		"lifecycle",
-		"cli",
-		"example"
-	],
-	body: `## What this example shows\n- How to call \`LifecycleAssessmentService\` from a Node/Bun script.\n- How to wire mock analytics + questionnaire adapters.\n\n## Run\n- Use the exported function \`runLifecycleCliDemo()\` (or call it from your own CLI wrapper).\n\n## Notes\n- Keep outputs structured; avoid \`console.log\` in production paths.\n- This example is deterministic (fixed inputs → stable output).`
-}, {
-	id: "docs.examples.lifecycle-cli.usage",
-	title: "Lifecycle CLI — Usage",
-	summary: "How to run and tweak the lifecycle assessment demo.",
-	kind: "usage",
-	visibility: "public",
-	route: "/docs/examples/lifecycle-cli/usage",
-	tags: [
-		"lifecycle",
-		"cli",
-		"usage"
-	],
-	body: `## Usage\n1) Call \`runLifecycleCliDemo()\`.\n2) Adjust the mock metrics/answers to explore stage outcomes.\n\n## Guardrails\n- Avoid PII in logs.\n- Keep adapters explicit and deterministic for reproducible demos.`
-}]);
+## Run
+- Use the exported function \`runLifecycleCliDemo()\` (or call it from your own CLI wrapper).
 
-//#endregion
-//# sourceMappingURL=lifecycle-cli.docblock.js.map
+## Notes
+- Keep outputs structured; avoid \`console.log\` in production paths.
+- This example is deterministic (fixed inputs \u2192 stable output).`
+  },
+  {
+    id: "docs.examples.lifecycle-cli.usage",
+    title: "Lifecycle CLI \u2014 Usage",
+    summary: "How to run and tweak the lifecycle assessment demo.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/lifecycle-cli/usage",
+    tags: ["lifecycle", "cli", "usage"],
+    body: `## Usage
+1) Call \`runLifecycleCliDemo()\`.
+2) Adjust the mock metrics/answers to explore stage outcomes.
+
+## Guardrails
+- Avoid PII in logs.
+- Keep adapters explicit and deterministic for reproducible demos.`
+  }
+];
+registerDocBlocks(blocks);