@contractspec/example.lifecycle-cli 0.0.0-canary-20260113170453

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@contractspec/example.lifecycle-cli",
+  "version": "0.0.0-canary-20260113170453",
+  "description": "Lifecycle CLI demo (example): run lifecycle assessment without an HTTP server.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./demo": "./dist/demo.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/lifecycle-cli.docblock": "./dist/docs/lifecycle-cli.docblock.js",
+    "./example": "./dist/example.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/bundle.lifecycle-managed": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.lifecycle": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.logger": "0.0.0-canary-20260113170453"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113170453",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113170453",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./demo": "./dist/demo.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/lifecycle-cli.docblock": "./dist/docs/lifecycle-cli.docblock.js",
+      "./example": "./dist/example.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/lifecycle-cli"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/demo.ts

@@ -0,0 +1,69 @@
+import {
+  createLifecycleHandlers,
+  LifecycleAssessmentService,
+} from '@contractspec/bundle.lifecycle-managed';
+import {
+  CapitalPhase,
+  CompanyPhase,
+  ProductPhase,
+} from '@contractspec/lib.lifecycle';
+import { Logger, LogLevel } from '@contractspec/lib.logger';
+import type { LoggerConfig } from '@contractspec/lib.logger/types';
+
+const logger = new Logger({
+  level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+  environment:
+    (process.env.NODE_ENV as LoggerConfig['environment']) || 'development',
+  enableColors: process.env.NODE_ENV !== 'production',
+});
+
+export async function runLifecycleCliDemo(): Promise<void> {
+  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,
+  });
+}

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './lifecycle-cli.docblock';

package/src/docs/lifecycle-cli.docblock.ts

@@ -0,0 +1,28 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    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.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/example.ts

@@ -0,0 +1,32 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+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 },
+  },
+});
+
+export default example;

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './demo';
+export { default as example } from './example';
+import './docs';

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}
+
+