@contractspec/example.lifecycle-cli 1.56.1 → 1.58.0

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);

package/dist/example.d.ts

@@ -1,7 +1,3 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/example.d.ts
-declare const example: _contractspec_lib_contracts0.ExampleSpec;
-//#endregion
-export { example as default };
+declare const example: import("@contractspec/lib.contracts").ExampleSpec;
+export default example;
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA2BJ,4BAAA,CA3BW"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,OAAO,mDA2BX,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/example.js

@@ -1,45 +1,34 @@
+// @bun
+// src/example.ts
 import { defineExample } from "@contractspec/lib.contracts";
-
-//#region src/example.ts
-const 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 = 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;
-
-//#endregion
-export { example_default as default };
-//# sourceMappingURL=example.js.map
+export {
+  example_default as default
+};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
-import { runLifecycleCliDemo } from "./demo.js";
-import example from "./example.js";
-export { example, runLifecycleCliDemo };
+export * from './demo';
+export { default as example } from './example';
+import './docs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,QAAQ,CAAC"}

package/dist/index.js

@@ -1,5 +1,139 @@
-import { runLifecycleCliDemo } from "./demo.js";
-import example_default from "./example.js";
-import "./docs/index.js";
+// @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 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 { example_default as example, runLifecycleCliDemo };
+// 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);
+// 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/node/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/node/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/node/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/node/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/node/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
+};