# @lssm-tech/example.finance-ops-ai-workflows Deterministic finance operations AI workflow example with human review, fixed rules, and synthetic data only. ## Source and release context - Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498` - Repository: `lssm-tech/contractspec` - Declared package version: `3.0.5` - Package path: `examples/finance-ops-ai-workflows` - Manifest path: `examples/finance-ops-ai-workflows/package.json` - Manifest Git blob: `4b4c854cd2a11ae3771f733b2d36b7e233beeda4` - Manifest origin: pinned GitHub manifest fetch - Manual: [@lssm-tech/example.finance-ops-ai-workflows](https://lssm.co/docs/packages/example.finance-ops-ai-workflows/) - Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/) This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review. Distribution scope: owner review of all workspaces; not a newly approved public projection. - [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows) - [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/package.json) - [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/README.md) - [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.finance-ops-ai-workflows.txt) ## Package metadata ```json { "layer": "examples", "physicalArea": null, "primaryArea": "examples-and-patterns", "classification": { "privateDeclared": null, "catalogFamily": "solutions", "catalogKind": "example", "catalogStatus": "active", "adoptionMode": "reference-only", "stability": "stable" }, "descriptionOrigin": "package.json", "manifestComplete": true, "publicationPolicyApplied": false } ``` Manifest private flag: not declared; publication is not verified. Primary area: [Examples and implementation patterns](https://lssm.co/docs/areas/examples-and-patterns/) ## Package guide ```json { "status": "available", "sourcePath": "examples/finance-ops-ai-workflows/README.md", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/README.md", "blobSha": "c4c6136d300a63bc697be4c49dff166a03b35bce", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "origin": "README recovered byte-for-byte from pinned aggregate guide", "integrity": "exact Git blob match", "executionStatus": "not executed" } ``` The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations. # @lssm-tech/example.finance-ops-ai-workflows Finance Ops AI Workflows is a public ContractSpec template for safe, deterministic, human-reviewed AI-assisted finance operations workflows. It is designed as a credible business demo for NDconsulting / Desliance style work: DAF transition, cash management, reporting, procedures, finance process improvement, training, and AI adoption ROI. ## Product Positioning This is not a chatbot, prompt collection, SaaS app, or live integration. It demonstrates how to turn finance-ops work into explicit workflows: business input -> ContractSpec operation -> deterministic handler -> simulated AI-assisted workflow -> human review -> reviewable output -> ROI/adoption log. The value is not "make an LLM talk". The value is to frame finance work, separate deterministic rules from assisted drafting, block autonomous decisions, and leave evidence that can be tested and industrialized. ## Included Workflows - `financeOps.missionIntake.triage`: fictive DAF / finance transformation mission intake. - `financeOps.cashAging.prioritize`: fixed-date aged receivables prioritization using deterministic rules. - `financeOps.procedureDraft.create`: internal finance procedure draft with roles, steps, controls and KPIs. - `financeOps.reportingNarrative.compose`: management reporting narrative with variance helpers and no invented causes. - `financeOps.aiAdoption.logUsage`: AI adoption ROI log that tracks use cases, not intrusive employee surveillance. ## Demo Script 1. Open `/templates` and preview `Finance Ops AI Workflows`. 2. Switch between the PME recovery and reporting reset scenarios from the demo command bar. 3. Run a workflow draft, select the mission item, invoice, procedure step, reporting variance, or adoption log under discussion, and use the selected-detail panel to request changes or mark the draft ready. 4. Move through Mission intake, Cash aging, Procedure, Reporting, and Adoption ROI as an operator cockpit rather than a slide sequence. 5. Reset the replay when the presenter wants to restart the story from the same synthetic fixture. ## Interactive Preview The inline template preview is intentionally demo-grade: - Command bar with scenario switching, deterministic replay reset, draft-run controls and current workflow state. - Workflow rail for Mission intake, Cash aging, Procedure, Reporting, and Adoption ROI. - Compact lists and tables instead of oversized card grids. - Selected-detail panel for every workflow click: mission evidence, invoice follow-up, procedure control, reporting variance, or adoption recommendation. - Draft-only review actions to request changes or mark the selected workflow ready. The preview recomputes from the handlers, so it demonstrates the same deterministic contract outputs that tests and replay proof cover. The interactivity is local UI state only: it simulates review and replay, not real operational execution. ## Scope Boundaries The package uses synthetic fixtures and deterministic handlers only. It does not connect to live finance systems, does not send operational communications, and does not provide production financial, legal, tax, accounting, or investment advice. Workflow outputs keep `humanReviewRequired` set to `true`. ## Public Entry Points - `@lssm-tech/example.finance-ops-ai-workflows` - `@lssm-tech/example.finance-ops-ai-workflows/contracts` - `@lssm-tech/example.finance-ops-ai-workflows/contracts/mission-intake-triage.operation` - `@lssm-tech/example.finance-ops-ai-workflows/contracts/cash-aging-prioritization.operation` - `@lssm-tech/example.finance-ops-ai-workflows/contracts/procedure-draft.operation` - `@lssm-tech/example.finance-ops-ai-workflows/contracts/reporting-narrative.operation` - `@lssm-tech/example.finance-ops-ai-workflows/contracts/adoption-roi-log.operation` - `@lssm-tech/example.finance-ops-ai-workflows/fixtures` - `@lssm-tech/example.finance-ops-ai-workflows/handlers` - `@lssm-tech/example.finance-ops-ai-workflows/proof` - `@lssm-tech/example.finance-ops-ai-workflows/ui` ## Implementation Notes - Handlers are pure deterministic functions wrapped with `HandlerForOperationSpec`. - Structured lists are returned as JSON strings where the contract surface asks for `*Json` fields. - Fixtures are fictive and tuned for a commercial demo: PME industrielle, 85 employees, 14 M EUR revenue, RAF departure, missing reporting, cash tension and fragmented Excel/Power BI tools. - The replay proof runs all five workflows and returns a compact evidence object. ## Commands - `bun run build` - `bun run typecheck` - `bun run test` - `bun run smoke` - `bun run preflight` Declaration builds use `build:types` through the shared Bun tool; `build` runs bundle and declaration generation. Declared exports are preserved. Generated artifacts exclude test-only files; tests/typecheck remain separate gates. ## Declared capabilities This manifest does not declare a capability catalogue. Assess the package using its guide, import map and source. ## Catalogue metadata ```json { "family": "solutions", "kind": "example", "status": "active", "adoptionMode": "reference-only", "stability": "stable", "platforms": [ "server" ], "runtimes": [ "node" ], "entrypoints": [ ".", "./contracts", "./contracts/adoption-roi-log.operation", "./contracts/cash-aging-prioritization.operation", "./contracts/mission-intake-triage.operation", "./contracts/procedure-draft.operation", "./contracts/reporting-narrative.operation", "./docs", "./example", "./fixtures", "./finance-ops-ai-workflows.feature", "./handlers", "./handlers/finance-ops-ai-workflows.handlers", "./proof", "./proof/finance-ops-ai-workflows.replay", "./ui", "./ui/FinanceOpsAiWorkflowsPreview" ], "examples": [], "replacements": [], "nonAdoptableRationale": "This example is published for reference and learning, not as a reusable library dependency.", "visualTesting": { "status": "deferred", "owner": "@contractspec-core", "targetWave": "wave-3-react-packages", "rationale": "Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates." } } ``` ## Canonical imports Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference. ```json [] ``` ## Declared export entry points Scope: manifest-declared export entrypoints and catalog-declared imports. Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted. Installation status: not verified. - `@lssm-tech/example.finance-ops-ai-workflows` — subpath `.` - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/contracts` — subpath `./contracts` - `unconditional`: `./src/contracts/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/contracts/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/contracts/adoption-roi-log.operation` — subpath `./contracts/adoption-roi-log.operation` - `unconditional`: `./src/contracts/adoption-roi-log.operation.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/contracts/adoption-roi-log.operation.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/contracts/cash-aging-prioritization.operation` — subpath `./contracts/cash-aging-prioritization.operation` - `unconditional`: `./src/contracts/cash-aging-prioritization.operation.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/contracts/cash-aging-prioritization.operation.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/contracts/mission-intake-triage.operation` — subpath `./contracts/mission-intake-triage.operation` - `unconditional`: `./src/contracts/mission-intake-triage.operation.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/contracts/mission-intake-triage.operation.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/contracts/procedure-draft.operation` — subpath `./contracts/procedure-draft.operation` - `unconditional`: `./src/contracts/procedure-draft.operation.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/contracts/procedure-draft.operation.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/contracts/reporting-narrative.operation` — subpath `./contracts/reporting-narrative.operation` - `unconditional`: `./src/contracts/reporting-narrative.operation.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/contracts/reporting-narrative.operation.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/docs` — subpath `./docs` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/docs/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/example` — subpath `./example` - `unconditional`: `./src/example.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/example.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/fixtures` — subpath `./fixtures` - `unconditional`: `./src/fixtures/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/fixtures/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/finance-ops-ai-workflows.feature` — subpath `./finance-ops-ai-workflows.feature` - `unconditional`: `./src/finance-ops-ai-workflows.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/finance-ops-ai-workflows.feature.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/handlers` — subpath `./handlers` - `unconditional`: `./src/handlers/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/handlers/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/handlers/finance-ops-ai-workflows.handlers` — subpath `./handlers/finance-ops-ai-workflows.handlers` - `unconditional`: `./src/handlers/finance-ops-ai-workflows.handlers.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/handlers/finance-ops-ai-workflows.handlers.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/proof` — subpath `./proof` - `unconditional`: `./src/proof/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/proof/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/proof/finance-ops-ai-workflows.replay` — subpath `./proof/finance-ops-ai-workflows.replay` - `unconditional`: `./src/proof/finance-ops-ai-workflows.replay.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/proof/finance-ops-ai-workflows.replay.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/ui` — subpath `./ui` - `unconditional`: `./src/ui/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/ui/index.ts); verified source file. - `@lssm-tech/example.finance-ops-ai-workflows/ui/FinanceOpsAiWorkflowsPreview` — subpath `./ui/FinanceOpsAiWorkflowsPreview` - `unconditional`: `./src/ui/FinanceOpsAiWorkflowsPreview.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/finance-ops-ai-workflows/src/ui/FinanceOpsAiWorkflowsPreview.tsx); verified source file. ## Package publication metadata These are source-manifest declarations, not a registry installation check. ```json { "types": "./dist/index.d.ts", "files": [ "LICENSE", "README.md", "dist", "!**/*.test.*", "!**/*.spec.*", "!**/*.tsbuildinfo" ], "publishExports": { ".": { "types": "./dist/index.d.ts", "browser": "./dist/browser/index.js", "bun": "./dist/index.js", "node": "./dist/node/index.js", "default": "./dist/index.js" }, "./contracts": { "types": "./dist/contracts/index.d.ts", "browser": "./dist/browser/contracts/index.js", "bun": "./dist/contracts/index.js", "node": "./dist/node/contracts/index.js", "default": "./dist/contracts/index.js" }, "./contracts/adoption-roi-log.operation": { "types": "./dist/contracts/adoption-roi-log.operation.d.ts", "browser": "./dist/browser/contracts/adoption-roi-log.operation.js", "bun": "./dist/contracts/adoption-roi-log.operation.js", "node": "./dist/node/contracts/adoption-roi-log.operation.js", "default": "./dist/contracts/adoption-roi-log.operation.js" }, "./contracts/cash-aging-prioritization.operation": { "types": "./dist/contracts/cash-aging-prioritization.operation.d.ts", "browser": "./dist/browser/contracts/cash-aging-prioritization.operation.js", "bun": "./dist/contracts/cash-aging-prioritization.operation.js", "node": "./dist/node/contracts/cash-aging-prioritization.operation.js", "default": "./dist/contracts/cash-aging-prioritization.operation.js" }, "./contracts/mission-intake-triage.operation": { "types": "./dist/contracts/mission-intake-triage.operation.d.ts", "browser": "./dist/browser/contracts/mission-intake-triage.operation.js", "bun": "./dist/contracts/mission-intake-triage.operation.js", "node": "./dist/node/contracts/mission-intake-triage.operation.js", "default": "./dist/contracts/mission-intake-triage.operation.js" }, "./contracts/procedure-draft.operation": { "types": "./dist/contracts/procedure-draft.operation.d.ts", "browser": "./dist/browser/contracts/procedure-draft.operation.js", "bun": "./dist/contracts/procedure-draft.operation.js", "node": "./dist/node/contracts/procedure-draft.operation.js", "default": "./dist/contracts/procedure-draft.operation.js" }, "./contracts/reporting-narrative.operation": { "types": "./dist/contracts/reporting-narrative.operation.d.ts", "browser": "./dist/browser/contracts/reporting-narrative.operation.js", "bun": "./dist/contracts/reporting-narrative.operation.js", "node": "./dist/node/contracts/reporting-narrative.operation.js", "default": "./dist/contracts/reporting-narrative.operation.js" }, "./docs": { "types": "./dist/docs/index.d.ts", "browser": "./dist/browser/docs/index.js", "bun": "./dist/docs/index.js", "node": "./dist/node/docs/index.js", "default": "./dist/docs/index.js" }, "./example": { "types": "./dist/example.d.ts", "browser": "./dist/browser/example.js", "bun": "./dist/example.js", "node": "./dist/node/example.js", "default": "./dist/example.js" }, "./fixtures": { "types": "./dist/fixtures/index.d.ts", "browser": "./dist/browser/fixtures/index.js", "bun": "./dist/fixtures/index.js", "node": "./dist/node/fixtures/index.js", "default": "./dist/fixtures/index.js" }, "./finance-ops-ai-workflows.feature": { "types": "./dist/finance-ops-ai-workflows.feature.d.ts", "browser": "./dist/browser/finance-ops-ai-workflows.feature.js", "bun": "./dist/finance-ops-ai-workflows.feature.js", "node": "./dist/node/finance-ops-ai-workflows.feature.js", "default": "./dist/finance-ops-ai-workflows.feature.js" }, "./handlers": { "types": "./dist/handlers/index.d.ts", "browser": "./dist/browser/handlers/index.js", "bun": "./dist/handlers/index.js", "node": "./dist/node/handlers/index.js", "default": "./dist/handlers/index.js" }, "./handlers/finance-ops-ai-workflows.handlers": { "types": "./dist/handlers/finance-ops-ai-workflows.handlers.d.ts", "browser": "./dist/browser/handlers/finance-ops-ai-workflows.handlers.js", "bun": "./dist/handlers/finance-ops-ai-workflows.handlers.js", "node": "./dist/node/handlers/finance-ops-ai-workflows.handlers.js", "default": "./dist/handlers/finance-ops-ai-workflows.handlers.js" }, "./proof": { "types": "./dist/proof/index.d.ts", "browser": "./dist/browser/proof/index.js", "bun": "./dist/proof/index.js", "node": "./dist/node/proof/index.js", "default": "./dist/proof/index.js" }, "./proof/finance-ops-ai-workflows.replay": { "types": "./dist/proof/finance-ops-ai-workflows.replay.d.ts", "browser": "./dist/browser/proof/finance-ops-ai-workflows.replay.js", "bun": "./dist/proof/finance-ops-ai-workflows.replay.js", "node": "./dist/node/proof/finance-ops-ai-workflows.replay.js", "default": "./dist/proof/finance-ops-ai-workflows.replay.js" }, "./ui": { "types": "./dist/ui/index.d.ts", "browser": "./dist/browser/ui/index.js", "bun": "./dist/ui/index.js", "node": "./dist/node/ui/index.js", "default": "./dist/ui/index.js" }, "./ui/FinanceOpsAiWorkflowsPreview": { "types": "./dist/ui/FinanceOpsAiWorkflowsPreview.d.ts", "browser": "./dist/browser/ui/FinanceOpsAiWorkflowsPreview.js", "bun": "./dist/ui/FinanceOpsAiWorkflowsPreview.js", "node": "./dist/node/ui/FinanceOpsAiWorkflowsPreview.js", "default": "./dist/ui/FinanceOpsAiWorkflowsPreview.js" } } } ``` ## Dependencies Metadata status: complete pinned manifest. ### Runtime dependencies - [@lssm-tech/lib.contracts-spec](https://lssm.co/docs/packages/lib.contracts-spec/): `workspace:^` - [@lssm-tech/lib.design-system](https://lssm.co/docs/packages/lib.design-system/): `workspace:^` - [@lssm-tech/lib.schema](https://lssm.co/docs/packages/lib.schema/): `workspace:^` - `react`: `catalog:` - `react-dom`: `catalog:` ### Peer dependencies No declarations in the inspected manifest. ### Optional dependencies No declarations in the inspected manifest. ### Development dependencies - [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*` - [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*` - `@types/react`: `catalog:types` - `@types/react-dom`: `catalog:types` - `typescript`: `catalog:` ### Peer dependency metadata ```json {} ``` ### Bundled dependencies ```json null ``` ## Package scripts Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest. ```json { "build": "contractspec-bun-build build", "typecheck": "tsgo --noEmit", "test": "bun test", "smoke": "bun test src/example.smoke.test.ts", "preflight": "bun run build && bun run typecheck && bun run test && bun run smoke", "build:bundle": "contractspec-bun-build transpile", "build:types": "contractspec-bun-build types" } ``` ## Declared documentation links - [Example Finance Ops Ai Workflows documentation](https://www.npmjs.com/package/%40lssm-tech%2Fexample.finance-ops-ai-workflows) — declared link; destination not verified. ```json { "url": "https://www.npmjs.com/package/%40lssm-tech%2Fexample.finance-ops-ai-workflows", "kind": "readme" } ``` ## Existing agent-guide projection ```json { "path": "packages/apps/web-landing/public/llms-packages/example.finance-ops-ai-workflows.txt", "route": "/llms/example.finance-ops-ai-workflows", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.finance-ops-ai-workflows.txt", "blobSha": "c4c6136d300a63bc697be4c49dff166a03b35bce", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "bodyEqualsReadme": true, "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt", "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf" } ```