@contractspec/lib.workflow-composer 3.7.5 → 3.7.7

package/README.md

@@ -1,57 +1,65 @@
 # @contractspec/lib.workflow-composer
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
-Compose base `WorkflowSpec` definitions with tenant-, role-, and device-scoped extensions.
+**Tenant-aware workflow composition helpers for ContractSpec.**
 
-This package is designed for deterministic workflow personalization without duplicating core specs.
+## What It Provides
 
-## Highlights
+- **Layer**: lib.
+- **Consumers**: bundles.
+- Related ContractSpec packages include `@contractspec/lib.ai-providers`, `@contractspec/lib.contracts-spec`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/lib.ai-providers`, `@contractspec/lib.contracts-spec`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
-- Deterministic extension merge ordering with stable tie-breaking.
-- Strict extension validation for anchors, transition endpoints, and duplicate injected step IDs.
-- Safe hidden-step handling with entry-step protections.
-- Metadata and annotations merge support on composed workflow outputs.
-- Post-composition validation using `validateWorkflowSpec` from `@contractspec/lib.contracts-spec/workflow`.
+## Installation
+
+`npm install @contractspec/lib.workflow-composer`
+
+or
+
+`bun add @contractspec/lib.workflow-composer`
 
 ## Usage
 
-```ts
-import { WorkflowComposer, approvalStepTemplate } from '@contractspec/lib.workflow-composer';
-
-const composer = new WorkflowComposer();
-
-composer.register({
-  workflow: 'billing.invoiceApproval',
-  tenantId: 'acme',
-  priority: 10,
-  metadata: {
-    tenant: 'acme',
-  },
-  annotations: {
-    source: 'tenant-extension',
-  },
-  customSteps: [
-    {
-      after: 'validate-invoice',
-      inject: approvalStepTemplate({
-        id: 'acme-legal-review',
-        label: 'Legal Review (ACME)',
-        description: 'Tenant-specific compliance step.',
-      }),
-      transitionTo: 'final-approval',
-    },
-  ],
-});
-
-const runtimeSpec = composer.compose({
-  base: BaseInvoiceWorkflow,
-  tenantId: 'acme',
-});
-```
+Import the root entrypoint from `@contractspec/lib.workflow-composer`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/composer.test.ts` is part of the package's public or composition surface.
+- `src/composer.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/injector.ts` is part of the package's public or composition surface.
+- `src/merger.ts` is part of the package's public or composition surface.
+- `src/templates.ts` is part of the package's public or composition surface.
+- `src/types.ts` is shared public type definitions.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.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.
+- Add AI provider ranking system with ranking-driven model selection.
+- Upgrade dependencies.
 
 ## Notes
 
-- Extensions are additive and validated before application.
-- Composition throws with explicit error codes/messages when extension constraints are violated.
-- Runtime behavior remains controlled by `@contractspec/lib.contracts-spec/workflow` runner and validation.
+- Workflow composition must stay tenant-isolated — no cross-tenant data leakage.
+- Depends on contracts-spec — keep aligned with contract definitions.

package/dist/browser/index.js

@@ -1,17 +1,6 @@
-// src/templates.ts
-function approvalStepTemplate(options) {
-  return {
-    id: options.id,
-    label: options.label,
-    type: options.type ?? "human",
-    description: options.description ?? "Tenant-specific approval",
-    action: options.action,
-    guard: options.guardExpression ? {
-      type: "expression",
-      value: options.guardExpression
-    } : undefined
-  };
-}
+// src/composer.ts
+import { satisfies } from "compare-versions";
+
 // src/injector.ts
 import {
   validateWorkflowSpec
@@ -206,8 +195,6 @@ function mergeRecords(base, patch) {
     ...patch ?? {}
   };
 }
-// src/composer.ts
-import { satisfies } from "compare-versions";
 
 // src/merger.ts
 function mergeExtensions(extensions) {
@@ -266,6 +253,20 @@ function matches(params, extension) {
   }
   return true;
 }
+// src/templates.ts
+function approvalStepTemplate(options) {
+  return {
+    id: options.id,
+    label: options.label,
+    type: options.type ?? "human",
+    description: options.description ?? "Tenant-specific approval",
+    action: options.action,
+    guard: options.guardExpression ? {
+      type: "expression",
+      value: options.guardExpression
+    } : undefined
+  };
+}
 export {
   validateExtension,
   mergeExtensions,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export * from './types';
-export * from './templates';
-export * from './injector';
 export * from './composer';
-export * from './validator';
+export * from './injector';
 export * from './merger';
+export * from './templates';
+export * from './types';
+export * from './validator';

package/dist/index.js

@@ -1,18 +1,7 @@
 // @bun
-// src/templates.ts
-function approvalStepTemplate(options) {
-  return {
-    id: options.id,
-    label: options.label,
-    type: options.type ?? "human",
-    description: options.description ?? "Tenant-specific approval",
-    action: options.action,
-    guard: options.guardExpression ? {
-      type: "expression",
-      value: options.guardExpression
-    } : undefined
-  };
-}
+// src/composer.ts
+import { satisfies } from "compare-versions";
+
 // src/injector.ts
 import {
   validateWorkflowSpec
@@ -207,8 +196,6 @@ function mergeRecords(base, patch) {
     ...patch ?? {}
   };
 }
-// src/composer.ts
-import { satisfies } from "compare-versions";
 
 // src/merger.ts
 function mergeExtensions(extensions) {
@@ -267,6 +254,20 @@ function matches(params, extension) {
   }
   return true;
 }
+// src/templates.ts
+function approvalStepTemplate(options) {
+  return {
+    id: options.id,
+    label: options.label,
+    type: options.type ?? "human",
+    description: options.description ?? "Tenant-specific approval",
+    action: options.action,
+    guard: options.guardExpression ? {
+      type: "expression",
+      value: options.guardExpression
+    } : undefined
+  };
+}
 export {
   validateExtension,
   mergeExtensions,

package/dist/node/index.js

@@ -1,17 +1,6 @@
-// src/templates.ts
-function approvalStepTemplate(options) {
-  return {
-    id: options.id,
-    label: options.label,
-    type: options.type ?? "human",
-    description: options.description ?? "Tenant-specific approval",
-    action: options.action,
-    guard: options.guardExpression ? {
-      type: "expression",
-      value: options.guardExpression
-    } : undefined
-  };
-}
+// src/composer.ts
+import { satisfies } from "compare-versions";
+
 // src/injector.ts
 import {
   validateWorkflowSpec
@@ -206,8 +195,6 @@ function mergeRecords(base, patch) {
     ...patch ?? {}
   };
 }
-// src/composer.ts
-import { satisfies } from "compare-versions";
 
 // src/merger.ts
 function mergeExtensions(extensions) {
@@ -266,6 +253,20 @@ function matches(params, extension) {
   }
   return true;
 }
+// src/templates.ts
+function approvalStepTemplate(options) {
+  return {
+    id: options.id,
+    label: options.label,
+    type: options.type ?? "human",
+    description: options.description ?? "Tenant-specific approval",
+    action: options.action,
+    guard: options.guardExpression ? {
+      type: "expression",
+      value: options.guardExpression
+    } : undefined
+  };
+}
 export {
   validateExtension,
   mergeExtensions,

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-import type { Step, StepModelHints, WorkflowSpec } from '@contractspec/lib.contracts-spec/workflow';
 import type { ModelSelector } from '@contractspec/lib.ai-providers/selector-types';
+import type { Step, StepModelHints, WorkflowSpec } from '@contractspec/lib.contracts-spec/workflow';
 /**
  * Context provided to operation executors during workflow step execution.
  * Includes an optional ranking-driven model selector for AI-powered steps.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.workflow-composer",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "description": "Tenant-aware workflow composition helpers for ContractSpec.",
   "keywords": [
     "contractspec",
@@ -24,21 +24,21 @@
     "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.5",
-    "@contractspec/lib.ai-providers": "3.7.5",
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.ai-providers": "3.7.6",
     "compare-versions": "^6.1.1"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "exports": {
     ".": {