@contractspec/example.lifecycle-dashboard 3.7.6 → 3.7.7

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@ $ 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=6 noBundle=false
-Bundled 6 modules in 22ms
+Bundled 6 modules in 23ms
 
   docs/index.js                         0.95 KB  (entry point)
   ./index.js                            4.0 KB   (entry point)
@@ -13,7 +13,7 @@ Bundled 6 modules in 22ms
   snippets/page.js                      1.58 KB  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=6 noBundle=false
-Bundled 6 modules in 12ms
+Bundled 6 modules in 13ms
 
   docs/index.js                         0.94 KB  (entry point)
   ./index.js                            4.0 KB   (entry point)
@@ -23,7 +23,7 @@ Bundled 6 modules in 12ms
   snippets/page.js                      1.58 KB  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=6 noBundle=false
-Bundled 6 modules in 11ms
+Bundled 6 modules in 24ms
 
   docs/index.js                         0.94 KB  (entry point)
   ./index.js                            4.0 KB   (entry point)

package/AGENTS.md

@@ -1,29 +1,52 @@
-# AI Agent Guide -- `@contractspec/example.lifecycle-dashboard`
+# AI Agent Guide — `@contractspec/example.lifecycle-dashboard`
 
 Scope: `packages/examples/lifecycle-dashboard/*`
 
-Snippet example showing how to call lifecycle-managed APIs and render a status card.
+Lifecycle dashboard example (snippet): how to call lifecycle-managed APIs and render a status card.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.contracts-spec`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
-## What This Demonstrates
+## Architecture
 
-- Lifecycle API consumption pattern
-- Status card rendering snippet
-- Minimal dependency footprint for quick integration
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/lifecycle-dashboard.feature.ts` defines a feature entrypoint.
+- `src/snippets` is part of the package's public or composition surface.
 
-## Public Exports
+## Public Surface
 
-- `.` -- root barrel
-- `./snippets/page` -- page snippet
-- `./docs`, `./example`
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/lifecycle-dashboard.docblock` resolves through `./src/docs/lifecycle-dashboard.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./lifecycle-dashboard.feature` resolves through `./src/lifecycle-dashboard.feature.ts`.
+- Export `./snippets/page` resolves through `./src/snippets/page.ts`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test --pass-with-no-tests`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/README.md

@@ -1,41 +1,67 @@
-## Lifecycle Dashboard Example (Next.js)
+# @contractspec/example.lifecycle-dashboard
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Lifecycle dashboard example (snippet): how to call lifecycle-managed APIs and render a status card.**
 
-This example shows a minimal App Router page that calls the lifecycle managed bundle via `/api/lifecycle/*` routes and renders a mobile-friendly status card.
-
-### Structure
-
-- `app/page.tsx` – client component with tabs for Stage, Actions, Libraries.
-- Expected API routes:
-  - `POST /api/lifecycle/assessments` → proxies to `LifecycleAssessmentService.runAssessment`
-  - `GET /api/lifecycle/playbooks/:stage` → proxies to `service.getStagePlaybook`
-
-### Run
-
-```bash
-cd packages/examples/lifecycle-dashboard
-bunx next dev
-```
-
-Make sure you register the API routes in your actual Next.js app; the page assumes they exist.
-
-This example is now packaged as `@contractspec/example.lifecycle-dashboard` and ships the page as a deterministic snippet:
-- `@contractspec/example.lifecycle-dashboard/snippets/page`
-
+## What This Demonstrates
 
+- Lifecycle API consumption pattern.
+- Status card rendering snippet.
+- Minimal dependency footprint for quick integration.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
+## Running Locally
 
+From `packages/examples/lifecycle-dashboard`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
+## Usage
 
+Use `@contractspec/example.lifecycle-dashboard` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
+## Architecture
 
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/lifecycle-dashboard.feature.ts` defines a feature entrypoint.
+- `src/snippets` is part of the package's public or composition surface.
 
+## Public Entry Points
 
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/lifecycle-dashboard.docblock` resolves through `./src/docs/lifecycle-dashboard.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./lifecycle-dashboard.feature` resolves through `./src/lifecycle-dashboard.feature.ts`.
+- Export `./snippets/page` resolves through `./src/snippets/page.ts`.
 
+## Local Commands
 
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
 
+## Recent Updates
 
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
 
+## Notes
 
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.

package/dist/browser/index.js

@@ -50,6 +50,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/lifecycle-dashboard.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LifecycleDashboardFeature = defineFeature({
+  meta: {
+    key: "lifecycle-dashboard",
+    version: "1.0.0",
+    title: "Lifecycle Dashboard",
+    description: "Lifecycle API usage snippet with status cards and lifecycle-managed endpoints",
+    domain: "lifecycle",
+    owners: ["@examples"],
+    tags: ["lifecycle", "dashboard", "status"],
+    stability: "experimental"
+  },
+  docs: ["docs.examples.lifecycle-dashboard"]
+});
+
 // src/snippets/page.ts
 var lifecycleDashboardNextPageSnippet = `'use client';
 
@@ -103,22 +119,6 @@ export default function LifecycleDashboardPage() {
   return null;
 }
 `;
-
-// src/lifecycle-dashboard.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LifecycleDashboardFeature = defineFeature({
-  meta: {
-    key: "lifecycle-dashboard",
-    version: "1.0.0",
-    title: "Lifecycle Dashboard",
-    description: "Lifecycle API usage snippet with status cards and lifecycle-managed endpoints",
-    domain: "lifecycle",
-    owners: ["@examples"],
-    tags: ["lifecycle", "dashboard", "status"],
-    stability: "experimental"
-  },
-  docs: ["docs.examples.lifecycle-dashboard"]
-});
 export {
   lifecycleDashboardNextPageSnippet,
   example_default as example,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { default as example } from './example';
-export * from './snippets/page';
 export * from './lifecycle-dashboard.feature';
+export * from './snippets/page';
 import './docs';

package/dist/index.js

@@ -51,6 +51,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/lifecycle-dashboard.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LifecycleDashboardFeature = defineFeature({
+  meta: {
+    key: "lifecycle-dashboard",
+    version: "1.0.0",
+    title: "Lifecycle Dashboard",
+    description: "Lifecycle API usage snippet with status cards and lifecycle-managed endpoints",
+    domain: "lifecycle",
+    owners: ["@examples"],
+    tags: ["lifecycle", "dashboard", "status"],
+    stability: "experimental"
+  },
+  docs: ["docs.examples.lifecycle-dashboard"]
+});
+
 // src/snippets/page.ts
 var lifecycleDashboardNextPageSnippet = `'use client';
 
@@ -104,22 +120,6 @@ export default function LifecycleDashboardPage() {
   return null;
 }
 `;
-
-// src/lifecycle-dashboard.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LifecycleDashboardFeature = defineFeature({
-  meta: {
-    key: "lifecycle-dashboard",
-    version: "1.0.0",
-    title: "Lifecycle Dashboard",
-    description: "Lifecycle API usage snippet with status cards and lifecycle-managed endpoints",
-    domain: "lifecycle",
-    owners: ["@examples"],
-    tags: ["lifecycle", "dashboard", "status"],
-    stability: "experimental"
-  },
-  docs: ["docs.examples.lifecycle-dashboard"]
-});
 export {
   lifecycleDashboardNextPageSnippet,
   example_default as example,

package/dist/node/index.js

@@ -50,6 +50,22 @@ var example = defineExample({
 });
 var example_default = example;
 
+// src/lifecycle-dashboard.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts-spec";
+var LifecycleDashboardFeature = defineFeature({
+  meta: {
+    key: "lifecycle-dashboard",
+    version: "1.0.0",
+    title: "Lifecycle Dashboard",
+    description: "Lifecycle API usage snippet with status cards and lifecycle-managed endpoints",
+    domain: "lifecycle",
+    owners: ["@examples"],
+    tags: ["lifecycle", "dashboard", "status"],
+    stability: "experimental"
+  },
+  docs: ["docs.examples.lifecycle-dashboard"]
+});
+
 // src/snippets/page.ts
 var lifecycleDashboardNextPageSnippet = `'use client';
 
@@ -103,22 +119,6 @@ export default function LifecycleDashboardPage() {
   return null;
 }
 `;
-
-// src/lifecycle-dashboard.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LifecycleDashboardFeature = defineFeature({
-  meta: {
-    key: "lifecycle-dashboard",
-    version: "1.0.0",
-    title: "Lifecycle Dashboard",
-    description: "Lifecycle API usage snippet with status cards and lifecycle-managed endpoints",
-    domain: "lifecycle",
-    owners: ["@examples"],
-    tags: ["lifecycle", "dashboard", "status"],
-    stability: "experimental"
-  },
-  docs: ["docs.examples.lifecycle-dashboard"]
-});
 export {
   lifecycleDashboardNextPageSnippet,
   example_default as example,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.lifecycle-dashboard",
-  "version": "3.7.6",
+  "version": "3.7.7",
   "description": "Lifecycle dashboard example (snippet): how to call lifecycle-managed APIs and render a status card.",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -57,14 +57,14 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test --pass-with-no-tests",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.7.6"
+    "@contractspec/lib.contracts-spec": "4.0.0"
   },
   "devDependencies": {
     "@contractspec/tool.typescript": "3.7.6",

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

@@ -2,17 +2,17 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const blocks: DocBlock[] = [
-  {
-    id: 'docs.examples.lifecycle-dashboard',
-    title: 'Lifecycle Dashboard (example snippet)',
-    summary:
-      'Minimal dashboard page pattern that calls lifecycle-managed API routes and renders a status card.',
-    kind: 'reference',
-    visibility: 'public',
-    route: '/docs/examples/lifecycle-dashboard',
-    tags: ['lifecycle', 'dashboard', 'example'],
-    body: `## What this example shows\n- A simple client-driven fetch to \`POST /api/lifecycle/assessments\`.\n- A card-shaped UI pattern for stage + confidence + recommendations.\n\n## Notes\n- Keep your app design-system-first (no raw HTML in application code).\n- Add explicit loading/error/empty states with accessible messaging.\n- Implement API routes in your app as thin adapters over lifecycle-managed services.`,
-  },
+	{
+		id: 'docs.examples.lifecycle-dashboard',
+		title: 'Lifecycle Dashboard (example snippet)',
+		summary:
+			'Minimal dashboard page pattern that calls lifecycle-managed API routes and renders a status card.',
+		kind: 'reference',
+		visibility: 'public',
+		route: '/docs/examples/lifecycle-dashboard',
+		tags: ['lifecycle', 'dashboard', 'example'],
+		body: `## What this example shows\n- A simple client-driven fetch to \`POST /api/lifecycle/assessments\`.\n- A card-shaped UI pattern for stage + confidence + recommendations.\n\n## Notes\n- Keep your app design-system-first (no raw HTML in application code).\n- Add explicit loading/error/empty states with accessible messaging.\n- Implement API routes in your app as thin adapters over lifecycle-managed services.`,
+	},
 ];
 
 registerDocBlocks(blocks);

package/src/example.ts

@@ -1,31 +1,31 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'lifecycle-dashboard',
-    version: '1.0.0',
-    title: 'Lifecycle Dashboard (snippet)',
-    description:
-      'A minimal dashboard page pattern: call lifecycle-managed endpoints and render a mobile-friendly status card.',
-    kind: 'blueprint',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['lifecycle', 'dashboard', 'nextjs', 'snippet'],
-  },
-  docs: {
-    rootDocId: 'docs.examples.lifecycle-dashboard',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.lifecycle-dashboard',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'lifecycle-dashboard',
+		version: '1.0.0',
+		title: 'Lifecycle Dashboard (snippet)',
+		description:
+			'A minimal dashboard page pattern: call lifecycle-managed endpoints and render a mobile-friendly status card.',
+		kind: 'blueprint',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['lifecycle', 'dashboard', 'nextjs', 'snippet'],
+	},
+	docs: {
+		rootDocId: 'docs.examples.lifecycle-dashboard',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.lifecycle-dashboard',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;

package/src/index.ts

@@ -1,4 +1,4 @@
 export { default as example } from './example';
-export * from './snippets/page';
 export * from './lifecycle-dashboard.feature';
+export * from './snippets/page';
 import './docs';

package/src/lifecycle-dashboard.feature.ts

@@ -1,17 +1,17 @@
 import { defineFeature } from '@contractspec/lib.contracts-spec';
 
 export const LifecycleDashboardFeature = defineFeature({
-  meta: {
-    key: 'lifecycle-dashboard',
-    version: '1.0.0',
-    title: 'Lifecycle Dashboard',
-    description:
-      'Lifecycle API usage snippet with status cards and lifecycle-managed endpoints',
-    domain: 'lifecycle',
-    owners: ['@examples'],
-    tags: ['lifecycle', 'dashboard', 'status'],
-    stability: 'experimental',
-  },
+	meta: {
+		key: 'lifecycle-dashboard',
+		version: '1.0.0',
+		title: 'Lifecycle Dashboard',
+		description:
+			'Lifecycle API usage snippet with status cards and lifecycle-managed endpoints',
+		domain: 'lifecycle',
+		owners: ['@examples'],
+		tags: ['lifecycle', 'dashboard', 'status'],
+		stability: 'experimental',
+	},
 
-  docs: ['docs.examples.lifecycle-dashboard'],
+	docs: ['docs.examples.lifecycle-dashboard'],
 });

package/tsconfig.json

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

package/tsdown.config.js

@@ -1,5 +1,5 @@
 import { defineConfig, moduleLibrary } from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
-  ...moduleLibrary,
+	...moduleLibrary,
 }));