{"source":{"repository":"lssm-tech/contractspec","commit":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","workspaceAuthority":"package.json workspaces.packages","workspacePatterns":["packages/foundation/*","packages/platform/*/*","packages/domains/*/*","examples/*","packages/tools/*","packages/integrations/*","packages/bundles/*","packages/apps/*","apps/contractspec","apps/cursor-marketplace","apps/spec-driven-development","packages/apps/jetbrains-contractspec/bridge","scripts"],"aggregateGuidePath":"packages/apps/web-landing/public/llms-full.txt","aggregateGuideBlobSha":"691b1d33efee24c440598b9106c81432f56aafaf","distributionScope":"owner review of all workspaces; not a newly approved public projection"},"areas":[{"slug":"core-contracts","title":"Core contracts and features","shortDescription":"Define the behavior, references and composition rules that other parts of a product can share.","questions":["Where should a command, query or event be declared?","Which package owns portable models and which supplies registries?","How does a feature connect related contracts?"],"tasks":["Model one operation and its outcomes","Group operations into a capability and feature","Find the canonical owner behind a compatibility import"],"packageNames":["@lssm-tech/lib.contracts","@lssm-tech/lib.contracts-library","@lssm-tech/lib.contracts-spec","@lssm-tech/lib.contracts-spec-core","@lssm-tech/lib.contracts-transformers","@lssm-tech/lib.contractspec-catalog"],"entryPoints":[{"packageName":"@lssm-tech/lib.contracts-spec-core","reason":"Begin with portable operation, event, capability and feature definitions when authoring a reusable contract.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","exportPaths":["./operations","./events","./capabilities","./features"]},{"packageName":"@lssm-tech/lib.contracts-spec","reason":"Use the compatibility distribution to understand existing consumers and forwarding paths in this source snapshot.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-spec-compat/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-spec-compat/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.contracts-library","reason":"Inspect the maintained documentation, review and platform contract families for complete source examples.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"schemas-and-results","reason":"Inputs, outputs and outcomes need explicit models before a handler or transport can validate them."}],"relationships":[{"areaSlug":"runtime-adapters","reason":"Registries, handlers and adapters turn declarations into an executed request."},{"areaSlug":"app-composition","reason":"Features become useful product capabilities when a host supplies their dependencies."}],"sections":[{"id":"section-1","title":"Choose the layer that matches the job","body":"Portable Core owns operation metadata and the existing defineCommand, defineQuery, defineEvent and defineCapability constructors. It also owns feature composition, versioned references and documentation references. Start here to describe a reusable domain boundary. The compatibility package forwards established paths to canonical owners; it remains useful when reading older consumers. A registry, renderer, provider implementation or installed product capability is a separate part of the composition. The current README describes this ownership extraction as staged, so follow the selected release context when deciding what a consumer can adopt.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"]},{"id":"section-2","title":"Write the contract before the transport","body":"Describe one concrete action or read: its key, version, input, output, error outcomes and declared policy. Identify any emitted event and its relationship to the operation. Put related operations behind a capability, then use a feature to describe the larger composition and its dependencies. Keep documentation close to the definition and reference it explicitly. The source docs.generate operation is a useful complete specimen because its operation, capability requirement and colocated DocBlock can be inspected together.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"]},{"id":"section-3","title":"Preserve identity while navigating the repository","body":"The same contract may be reachable through a canonical leaf and a historical forwarding path. Compare the selected package export maps before creating a second declaration or duplicating a registry. Treat document revision, operation version and package version as separate identifiers. When a contract changes, inspect its callers, event consumers, presentation bindings and examples. A renamed source folder is an ownership change; it should not silently become a new semantic operation or erase an existing versioned reference.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"]}],"taskGuide":[{"title":"Trace one complete operation","body":"Open the definition and record its exact key/version, input and output model, policy and event references. Follow the implementation registration into a runtime package, then the host adapter. This establishes which parts are declarative and which part handles a real request.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"]},{"title":"Extend a feature deliberately","body":"List the operation, event, capability and presentation references that the feature actually needs. Reuse their canonical identities and keep optional dependencies visible. Compare a nearby maintained feature rather than guessing a new reference shape.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"]},{"title":"Check the consumer boundary","body":"Choose the package and subpath available in the intended release, inspect its forwarding relationship, and run the owning project’s existing validation in that environment. Record the result separately from the fact that a source declaration exists.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"]}],"referenceLinks":[{"label":"@lssm-tech/lib.contracts-spec-core package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/package.json"},{"label":"@lssm-tech/lib.contracts-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-spec-compat/package.json"},{"label":"@lssm-tech/lib.contracts-library package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/package.json"},{"label":"contracts-spec source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"},{"label":"docsGenerate.command.ts","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/foundation/contracts-spec/README.md"],"sourcePaths":["packages/platform/delivery/contracts-library/src/docs/commands/docsGenerate.command.ts"],"packageMetadataPaths":["packages/foundation/contracts-spec/package.json","packages/platform/delivery/contracts-spec-compat/package.json","packages/platform/delivery/contracts-library/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":406,"packageCount":6},{"slug":"schemas-and-results","title":"Schemas, types and results","shortDescription":"Make input, output, serialization and failure behavior explicit across the boundaries your product exposes.","questions":["How do Zod, JSON Schema and GraphQL representations relate?","Where do standard results and errors live?","Which types are runtime validation and which are compile-time helpers?"],"tasks":["Define a reusable input/output model","Inspect a schema projection","Represent a failure without inventing another result envelope"],"packageNames":["@lssm-tech/lib.schema","@lssm-tech/lib.utils-typescript"],"entryPoints":[{"packageName":"@lssm-tech/lib.schema","reason":"Use schema models and the existing Zod, JSON Schema, GraphQL and entity surfaces.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","exportPaths":[".","./SchemaModel","./EnumType","./JsonSchemaType","./GraphQLSchemaType"]},{"packageName":"@lssm-tech/lib.contracts-spec-core","reason":"Use canonical result and query primitives shared by contracts and adapters.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md","exportPaths":["./results","./query"]},{"packageName":"@lssm-tech/lib.utils-typescript","reason":"Use existing utility types for compile-time transformations without confusing them with runtime validation.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/utils-typescript/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/utils-typescript/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"A schema becomes meaningful at an operation, event, entity or presentation boundary."}],"relationships":[{"areaSlug":"runtime-adapters","reason":"Adapters must preserve the validated input and canonical result semantics."},{"areaSlug":"forms-and-data","reason":"Forms and import/export workflows consume these shared schema models."}],"sections":[{"id":"section-1","title":"Choose a representation intentionally","body":"The schema package provides SchemaModel, field/scalar/enum helpers, entity definitions and explicit projection surfaces for Zod, JSON Schema and GraphQL. Pick the model that the consuming contract already uses, then inspect how its selected transport obtains a wire schema. TypeScript utility types serve a different purpose: they help code describe transformed values at compile time. They do not establish that an incoming request satisfies the same rules. Keep the runtime validation boundary visible in the operation or adapter you are integrating.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"]},{"id":"section-2","title":"Understand projection differences","body":"A schema projection may change the representation while preserving domain meaning. EnumType is a concrete example: domain strings remain unchanged in Zod and JSON Schema, while GraphQL requires valid enum identifiers. The documented projection replaces invalid characters, prefixes unsuitable leading forms and rejects resulting name collisions. Parsing and serialization map the wire name back to the domain value. Review such rules before sharing enums between REST, GraphQL, stored records and UI selections; matching labels alone are insufficient.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"]},{"id":"section-3","title":"Use one result vocabulary","body":"Portable Core exposes results, standard outcomes, normalization and compatibility helpers alongside query envelopes. Read these definitions before wrapping a successful value or error in a new application-specific shape. A field-validation failure, policy denial, unavailable provider and handler failure are different situations for a caller. Preserve their declared meaning through the adapter and the user interface. Keep sensitive implementation details out of a public error while retaining a safe correlation path for diagnostics.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"]}],"taskGuide":[{"title":"Inspect both directions","body":"Follow one input from its schema to transport parsing, then follow one output back through serialization. Include an absent field, an invalid value and an enum value that needs wire-name conversion in your review of the existing tests.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"]},{"title":"Compare the actual exported leaf","body":"Open the package export map and the selected schema implementation. Check whether the consumer needs the root, entity, or individual projection entry. Use the same canonical model rather than creating parallel definitions for each transport.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"]},{"title":"Exercise a meaningful mismatch","body":"Use the owning project’s schema tests to examine how rejected input becomes a declared result. Add a case only when it resolves a real integration risk, such as a projection collision or an error shape that a client cannot interpret.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.schema package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/package.json"},{"label":"@lssm-tech/lib.contracts-spec-core package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/package.json"},{"label":"@lssm-tech/lib.utils-typescript package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/utils-typescript/package.json"},{"label":"schema source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/schema/README.md"},{"label":"contracts-spec source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-spec/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/foundation/schema/README.md","packages/foundation/contracts-spec/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/foundation/schema/package.json","packages/foundation/contracts-spec/package.json","packages/foundation/utils-typescript/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":393,"packageCount":2},{"slug":"runtime-adapters","title":"Handlers, runtimes and transports","shortDescription":"Connect declared operations to supplied handlers, client state and the transport your application actually runs.","questions":["What belongs in the portable runtime kernel?","Which adapter matches my REST, GraphQL or MCP host?","Where are approvals and authenticated context enforced?"],"tasks":["Trace an operation from request to handler","Choose a host-specific adapter","Preserve query envelopes and approval evidence"],"packageNames":["@lssm-tech/lib.contracts-runtime-client-react","@lssm-tech/lib.contracts-runtime-core","@lssm-tech/lib.contracts-runtime-kernel","@lssm-tech/lib.contracts-runtime-server-graphql","@lssm-tech/lib.contracts-runtime-server-mcp","@lssm-tech/lib.contracts-runtime-server-rest","@lssm-tech/lib.graphql-core","@lssm-tech/lib.graphql-federation","@lssm-tech/lib.graphql-prisma"],"entryPoints":[{"packageName":"@lssm-tech/lib.contracts-runtime-kernel","reason":"Start with the framework-neutral engine, canonical registries and caller-supplied runtime ports.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","exportPaths":[".","./policy","./redaction"]},{"packageName":"@lssm-tech/lib.contracts-runtime-server-rest","reason":"Inspect the REST adapter matching your framework and its request/context handling.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md","exportPaths":["./rest-generic","./rest-next-app","./rest-express"]},{"packageName":"@lssm-tech/lib.contracts-runtime-server-mcp","reason":"Use the existing contract-to-MCP adapter when exposing a selected operation registry to tools.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-mcp/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-mcp/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.contracts-runtime-client-react","reason":"Locate the React consumer integration for the shared query/cache runtime.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"The operation definition fixes the input, outcome and policy the runtime must preserve."},{"areaSlug":"schemas-and-results","reason":"Validation and serialization must match at both sides of the request."}],"relationships":[{"areaSlug":"identity-and-access","reason":"The host constructs trusted request authority."},{"areaSlug":"governance-and-approvals","reason":"Required approval evidence belongs in the execution context."},{"areaSlug":"observability-and-testing","reason":"Instrument and qualify the complete boundary, including denials."}],"sections":[{"id":"section-1","title":"Separate reusable runtime from host composition","body":"The runtime kernel owns the shared engine and registry identities while accepting storage, transport, approval, policy and audit responsibilities through supplied ports. Host/environment wiring and concrete providers live above that foundation. Select the server adapter by the application framework and transport, then inspect the client adapter that consumes it. REST, GraphQL and MCP are related projections of selected contracts; registering a contract does not by itself establish an authenticated endpoint or a configured handler.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"]},{"id":"section-2","title":"Follow the request context","body":"The REST README documents createFetchHandler with an asynchronous-capable context factory and an approvalReceipt adapter. Approval evidence is kept outside operation input and is passed to the common handler context. Required approvals are checked before handler invocation by the shared registry. Parameterized REST routes decode path values and make them authoritative over conflicting query/body fields. These details matter when replacing a handwritten endpoint: preserving the public input shape also requires preserving trusted context and precedence rules.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"]},{"id":"section-3","title":"Keep query behavior consistent","body":"REST requests rebuild the canonical QueryEnvelope, including supported search, filter, sort, pagination and consistency metadata. That metadata is separate from flat business input. The documented client deliberately avoids sending client cache policy by default because cache key material may contain tenant or user identifiers that would enter URL logs. Inspect caching, invalidation and offline behavior at the kernel/client boundary instead of hiding those concerns inside each handler. A transport success must still produce the expected canonical result.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"]}],"taskGuide":[{"title":"Choose one vertical slice","body":"Select a query and a command already declared in source. Identify their registry bindings, handler context, adapter entry and consumer call. Start with the smallest actual host composition that exercises these pieces together.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"]},{"title":"Inspect the negative path","body":"Trace invalid input, missing trusted identity, required-but-missing approval and an unavailable handler/provider. The relevant question is whether execution stops at the correct boundary and returns a result the caller can handle.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"]},{"title":"Qualify the selected environment","body":"Use the host’s existing test and build setup for the exact runtime and package versions. Record separately whether you checked source, local handler execution, the transport boundary or a deployed endpoint; those observations answer different questions.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.contracts-runtime-kernel package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/package.json"},{"label":"@lssm-tech/lib.contracts-runtime-server-rest package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/package.json"},{"label":"@lssm-tech/lib.contracts-runtime-server-mcp package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-mcp/package.json"},{"label":"@lssm-tech/lib.contracts-runtime-client-react package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-client-react/package.json"},{"label":"contracts-runtime-kernel source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/foundation/contracts-runtime-kernel/README.md"},{"label":"contracts-runtime-server-rest source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-rest/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/foundation/contracts-runtime-kernel/README.md","packages/platform/delivery/contracts-runtime-server-rest/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/foundation/contracts-runtime-kernel/package.json","packages/platform/delivery/contracts-runtime-server-rest/package.json","packages/platform/delivery/contracts-runtime-server-mcp/package.json","packages/platform/delivery/contracts-runtime-client-react/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":386,"packageCount":9},{"slug":"ui-and-presentations","title":"Interfaces, presentations and design","shortDescription":"Compose contract-driven views, role-aware operating surfaces and shared design primitives for web and native hosts.","questions":["Do I need a presentation renderer, a design component or a complete surface?","How are resolved preferences passed into UI?","Where do role-aware actions and feature hubs belong?"],"tasks":["Choose a rendering layer","Compose a RoleMorph surface","Keep adaptation and capability availability visible"],"packageNames":["@lssm-tech/app.storybook","@lssm-tech/integration.storybook","@lssm-tech/integration.voice-input-native","@lssm-tech/integration.voice-input-web","@lssm-tech/lib.accessibility","@lssm-tech/lib.cockpit-kit","@lssm-tech/lib.cockpit-kit-native","@lssm-tech/lib.cockpit-kit-web","@lssm-tech/lib.design-catalog","@lssm-tech/lib.design-system","@lssm-tech/lib.overlay-engine","@lssm-tech/lib.personalization","@lssm-tech/lib.personalized-presentation","@lssm-tech/lib.presentation-runtime-core","@lssm-tech/lib.presentation-runtime-next","@lssm-tech/lib.presentation-runtime-react","@lssm-tech/lib.presentation-runtime-react-native","@lssm-tech/lib.surface-runtime","@lssm-tech/lib.translation-runtime","@lssm-tech/lib.ui-kit","@lssm-tech/lib.ui-kit-core","@lssm-tech/lib.ui-kit-web","@lssm-tech/lib.ui-link","@lssm-tech/module.design-studio","@lssm-tech/module.operating-cockpit","@lssm-tech/tool.icon-gen"],"entryPoints":[{"packageName":"@lssm-tech/lib.presentation-runtime-core","reason":"Use presentation transforms, adaptive defaults and bundler helpers shared across renderers.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","exportPaths":[".","./adaptive-experience"]},{"packageName":"@lssm-tech/lib.presentation-runtime-react","reason":"Use the React rendering and workflow-facing presentation layer.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-react/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-react/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.surface-runtime","reason":"Inspect surface specs, planners, RoleMorph, feature hubs and React integration.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md","exportPaths":[".","./feature-hubs"]},{"packageName":"@lssm-tech/lib.design-system","reason":"Use the shared design-system component surface for product UI composition.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/design-system/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/design-system/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Presentation descriptors refer to behavior and data contracts."},{"areaSlug":"identity-and-access","reason":"A role-aware view must receive trusted actor and policy context."}],"relationships":[{"areaSlug":"forms-and-data","reason":"Tables and forms need schema-aware state and validation."},{"areaSlug":"app-composition","reason":"The host chooses the design pack, route and available capabilities."},{"areaSlug":"examples-and-patterns","reason":"Data-grid and RoleMorph examples make the boundaries inspectable."}],"sections":[{"id":"section-1","title":"Choose the smallest useful UI layer","body":"PresentationRuntimeCore supplies shared transforms and defaults; React, Next and React Native packages supply host-specific rendering. The design-system and UI-kit packages provide reusable visual components. SurfaceRuntime adds surface composition, planners, overrides and role-aware resolution. Select the layer that matches the work: a table renderer does not require adopting an entire operating shell. Check the chosen package’s exact export and platform conditions before copying a component import from another host.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"]},{"id":"section-2","title":"Resolve adaptation before rendering","body":"The adaptive-experience entry maps a ResolvedAdaptiveExperience into DataView defaults such as view type, density, data depth and page size. The caller supplies already-resolved preferences, supported behavior, signals, constraints and overrides. Keep this resolution visible so an interface can explain why it changed. RoleMorph then provides a reusable way to resolve operating surfaces for different human or AI actors. An action’s visual presence should reflect the selected policy and capability state, while the execution boundary independently enforces that state.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"]},{"id":"section-3","title":"Treat feature composition as a lifecycle","body":"SurfaceRuntime’s feature-hub implementation validates and composes independent manifests. Installation is read-only; start is the explicit effect boundary. Calls must match declared capability, operation, port and policy. An allowed decision with obligations still requires fulfilled obligations and durable evidence. Optional missing ports degrade dependent capabilities, and teardown has defined compensation behavior. This makes lifecycle state a meaningful part of product UI: distinguish installed, available, started, degraded and unavailable behavior instead of rendering every registered item as usable.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"]}],"taskGuide":[{"title":"Map the host and renderer","body":"Identify web versus native, the selected presentation package, design primitives and product shell. Use the documented bundler helper for that host where applicable, then inspect a maintained view that uses the same layer.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"]},{"title":"Trace one role-aware action","body":"Follow the actor/context input through surface resolution to the visible action, then to the operation’s authorization path. Compare at least an allowed actor, a denied actor and a missing optional capability in the relevant fixture.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"]},{"title":"Check the interaction itself","body":"Review keyboard access, focus, empty/error states and responsive layout alongside the contract behavior. A source-registered component or preview is useful evidence of an available implementation, but the selected browser/native experience still needs its own qualification.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.presentation-runtime-core package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/package.json"},{"label":"@lssm-tech/lib.presentation-runtime-react package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-react/package.json"},{"label":"@lssm-tech/lib.surface-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/package.json"},{"label":"@lssm-tech/lib.design-system package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/design-system/package.json"},{"label":"presentation-runtime-core source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/presentation-runtime-core/README.md"},{"label":"surface-runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/surface-runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/ui/presentation-runtime-core/README.md","packages/platform/ui/surface-runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/ui/presentation-runtime-core/package.json","packages/platform/ui/presentation-runtime-react/package.json","packages/platform/ui/surface-runtime/package.json","packages/platform/ui/design-system/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":379,"packageCount":26},{"slug":"forms-and-data","title":"Forms, data views and data exchange","shortDescription":"Collect structured input, present records, and plan governed import/export flows using shared models and explicit host ports.","questions":["Which package owns form lifecycle versus form UI?","How do immutable form publications relate to responses?","Where can I preview a mapping before applying it?"],"tasks":["Compose a form respondent and management surface","Inspect a schema-based import preview","Bind persistence and data-rights responsibilities"],"packageNames":["@lssm-tech/integration.crdt-loro","@lssm-tech/integration.governed-data-postgres","@lssm-tech/integration.governed-product-data-postgres","@lssm-tech/lib.data-exchange-client","@lssm-tech/lib.data-exchange-core","@lssm-tech/lib.data-exchange-server","@lssm-tech/lib.exporter","@lssm-tech/lib.files","@lssm-tech/lib.forms-runtime","@lssm-tech/module.forms"],"entryPoints":[{"packageName":"@lssm-tech/lib.forms-runtime","reason":"Use the canonical caller-port form lifecycle, document compiler and validation helpers.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","exportPaths":[".","./contracts/platform-compiler"]},{"packageName":"@lssm-tech/module.forms","reason":"Choose reusable builder, respondent, results and administration composition for the host.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","exportPaths":["./builder","./respondent","./administration"]},{"packageName":"@lssm-tech/lib.data-exchange-core","reason":"Start with codecs, mapping, plans and preview contracts before binding a transport or store.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md","exportPaths":[".","./mapping","./plans","./preview"]}],"foundationalPrerequisites":[{"areaSlug":"schemas-and-results","reason":"Form documents and mappings rely on the selected schema model."},{"areaSlug":"identity-and-access","reason":"Management and response sessions require distinct trusted scopes."}],"relationships":[{"areaSlug":"ui-and-presentations","reason":"Renderers display the selected form/data-view state."},{"areaSlug":"integrations-and-providers","reason":"Concrete stores, delivery and external data sources implement supplied ports."},{"areaSlug":"governance-and-approvals","reason":"Consent and approval evidence affect publication, sharing and downstream effects."}],"sections":[{"id":"section-1","title":"Choose lifecycle and UI separately","body":"FormsRuntime owns management, immutable publication, submission, consent, deterministic navigation, idempotency and document validation. ModuleForms keeps reusable builder, respondent, results and administration behavior. A product host supplies authenticated creator authority, storage, delivery providers, public routing, branding and feature flags. This split helps when embedding a form in an existing product: reuse the lifecycle and selected UI without assuming the package owns your tenant identity or deployment.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"]},{"id":"section-2","title":"Read the published form’s requirements","body":"Forms capabilities are organized into independently gated milestones. A document requiring a disabled milestone is rejected at publication. Verification, AI follow-up, distributed request defense, secrets and outbox delivery are optional host ports until the selected publication policy requires them. Responses remain bound to immutable revisions. When adapting an example, inspect the enabled milestone, required ports, locale fallback and response-session scope together; a working authoring screen alone does not show that a particular published document can accept valid responses.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"]},{"id":"section-3","title":"Preview interchange before applying changes","body":"DataExchangeCore provides CSV, JSON and XML codecs, normalized record batches, SchemaModel mapping/coercion and import/export plans. Its preview and reconciliation surfaces allow a caller to inspect differences before choosing an effectful delivery path. Governed projection contracts carry sharing, consent, residency, retention and revocation responsibilities. Recovery dispatches deliberately contain narrower, receiver-specific references than central queue records. Keep source values and scheduler internals out of an unrelated product’s recovery message.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"]}],"taskGuide":[{"title":"Select one data path","body":"For a form, trace document creation through publication and response storage. For import/export, trace decode, schema mapping, validation and preview. Record where trusted actor scope and the selected schema enter that path.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"]},{"title":"Supply the required ports","body":"Inspect the exact publication or exchange requirements before wiring storage, verification, delivery or AI adapters. Use a deterministic local adapter for a source walkthrough, then qualify the intended durable adapter separately.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"]},{"title":"Review replay and recovery","body":"Use an existing fixture to examine duplicate submission, stale revision, denied scope and a bounded retry. Confirm that a preview, queued delivery, accepted response and completed external effect remain visibly different states.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.forms-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/package.json"},{"label":"@lssm-tech/module.forms package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/package.json"},{"label":"@lssm-tech/lib.data-exchange-core package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/package.json"},{"label":"forms-runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/forms-runtime/README.md"},{"label":"forms source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/ui/forms/README.md"},{"label":"data-exchange-core source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/data-exchange-core/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/delivery/forms-runtime/README.md","packages/platform/ui/forms/README.md","packages/platform/delivery/data-exchange-core/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/delivery/forms-runtime/package.json","packages/platform/ui/forms/package.json","packages/platform/delivery/data-exchange-core/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":358,"packageCount":10},{"slug":"agents-and-context","title":"Agents, execution and context","shortDescription":"Build agent behavior from explicit tools, bounded execution, qualified models and provenance-aware context.","questions":["What belongs in AgentProtocol versus the AI Agent runtime?","How does an agent receive verified context?","Which host supplies execution, storage and approvals?"],"tasks":["Inspect an agent run boundary","Assemble a bounded context packet","Trace cancellation, delegation and tool approval"],"packageNames":["@lssm-tech/app.agent-host","@lssm-tech/integration.agent-durable-store","@lssm-tech/integration.agent-sandbox","@lssm-tech/integration.harness-runtime","@lssm-tech/lib.agent-collaboration","@lssm-tech/lib.agent-protocol-spec","@lssm-tech/lib.ai-agent","@lssm-tech/lib.context-storage","@lssm-tech/lib.execution-lanes","@lssm-tech/lib.harness","@lssm-tech/lib.mobile-control","@lssm-tech/lib.runtime-sandbox","@lssm-tech/lib.voice","@lssm-tech/module.agent-fleet","@lssm-tech/module.ai-chat","@lssm-tech/module.context-storage","@lssm-tech/module.execution-console"],"entryPoints":[{"packageName":"@lssm-tech/lib.agent-protocol-spec","reason":"Start with wire contracts, runtime capabilities and validation vocabulary shared by agent hosts.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-protocol-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-protocol-spec/README.md","exportPaths":[".","./help","./runtime-adapters"]},{"packageName":"@lssm-tech/lib.ai-agent","reason":"Use the canonical runtime, task-tree, context compiler, approval and tool orchestration surfaces.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","exportPaths":[".","./agent/runner","./agent/task-tree"]},{"packageName":"@lssm-tech/lib.context-storage","reason":"Locate context-pack/snapshot contracts and in-memory or supplied storage primitives.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","exportPaths":[".","./store","./in-memory-store"]},{"packageName":"@lssm-tech/lib.harness","reason":"Inspect the reusable execution harness and its declared environment boundaries.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/harness/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/harness/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Tools and agent lifecycle operations need exact contracts."},{"areaSlug":"identity-and-access","reason":"Agent principals and delegated subjects must be constructed by a trusted host."}],"relationships":[{"areaSlug":"knowledge-and-retrieval","reason":"Retrieval supplies evidence that the context compiler can classify and budget."},{"areaSlug":"governance-and-approvals","reason":"A plan or model response does not issue its own authority."},{"areaSlug":"integrations-and-providers","reason":"The selected model/provider route has separate capability and qualification evidence."}],"sections":[{"id":"section-1","title":"Select protocol and execution responsibilities","body":"AgentProtocol owns shared wire models and deterministic validation; AI Agent supplies runtime orchestration, task trees, tools, sessions and approvals. Existing lifecycle declarations and registry helpers are explicit surfaces. A host supplies the actual model route, storage, tool execution and authority. This distinction is useful when embedding an agent in an existing application: first identify the operation it may perform and the environment it may use, then select the runtime pieces needed to carry that behavior.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"]},{"id":"section-2","title":"Compile context with provenance","body":"The context compiler accepts classified sources, tracks digests and provenance, enforces budgets and required inputs, and separates evidence from instruction authority. Protocol V1 runs require the qualified model route and verified compiled context described by the source. Treat retrieved documents as data with known scope and freshness. ContextStorage adds pack and snapshot storage primitives; it does not automatically make every stored document appropriate for every run. Preserve the snapshot and source identity when a run is resumed or reviewed.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"]},{"id":"section-3","title":"Bound the run and its delegated tools","body":"The runner/task-tree surfaces preserve cancellation and failure propagation. The runtime also supports bounded epochs and explicit delegation constraints over selected history, tool subsets, budgets, timeouts and evidence. Approvals remain independent of an agent’s own plan. A practical integration should show which context was supplied, which tool was requested, why it was permitted, and what result or uncertainty returned. Keep model output, proposed action, authorized invocation and durable outcome as separate observations.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"]}],"taskGuide":[{"title":"Start with one declared tool","body":"Choose one existing operation and expose it through the intended registry or MCP boundary. Inspect its input, outcomes, scope and approval requirements before giving the agent a wider tool collection.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"]},{"title":"Trace the context packet","body":"Follow a source through retrieval/classification, compilation, snapshot storage and run admission. Check what happens when a required source is absent, expired, over budget or bound to the wrong scope.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"]},{"title":"Inspect interruption and uncertainty","body":"Use the owning fixture to examine cancellation, tool failure and a help/escalation request. Record the model/provider and execution environment in evidence; source support for a runtime adapter is not evidence of a successful run on it.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"]}],"referenceLinks":[{"label":"@lssm-tech/lib.agent-protocol-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-protocol-spec/package.json"},{"label":"@lssm-tech/lib.ai-agent package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/package.json"},{"label":"@lssm-tech/lib.context-storage package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/package.json"},{"label":"@lssm-tech/lib.harness package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/harness/package.json"},{"label":"ai-agent source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/README.md"},{"label":"context-storage source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md"},{"label":"compiler.ts","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/ai-agent/src/context/compiler.ts"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/agents/ai-agent/README.md","packages/platform/agents/context-storage/README.md"],"sourcePaths":["packages/platform/agents/ai-agent/src/context/compiler.ts"],"packageMetadataPaths":["packages/platform/agents/agent-protocol-spec/package.json","packages/platform/agents/ai-agent/package.json","packages/platform/agents/context-storage/package.json","packages/platform/agents/harness/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":378,"packageCount":17},{"slug":"knowledge-and-retrieval","title":"Knowledge, retrieval and evidence","shortDescription":"Turn authorized source material into retrievable, cited context while preserving its source, scope and freshness.","questions":["What is a knowledge space versus a vector-store collection?","How does ingestion become usable evidence?","Which provider and access boundaries does a knowledge host supply?"],"tasks":["Trace ingestion through retrieval","Choose a static or vector retriever","Attach citations and source-policy context to an answer"],"packageNames":["@lssm-tech/integration.provider-embedding","@lssm-tech/integration.provider-vector-store","@lssm-tech/lib.knowledge"],"entryPoints":[{"packageName":"@lssm-tech/lib.knowledge","reason":"Use ingestion, retrieval, query, access and knowledge-runtime composition primitives.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","exportPaths":[".","./access","./access/guard"]},{"packageName":"@lssm-tech/integration.provider-embedding","reason":"Inspect the concrete embedding provider boundary selected by an ingestion host.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/provider-embedding/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/provider-embedding/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/integration.provider-vector-store","reason":"Inspect the concrete vector-store adapter used by indexing and retrieval.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/provider-vector-store/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/provider-vector-store/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.context-storage","reason":"Store the selected pack or snapshot when the caller needs a durable context identity.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"schemas-and-results","reason":"Source records, queries and evidence references must keep their declared shapes."},{"areaSlug":"identity-and-access","reason":"Knowledge selection must use trusted tenant, actor and purpose context."}],"relationships":[{"areaSlug":"agents-and-context","reason":"Retrieved content becomes classified input to a bounded agent context."},{"areaSlug":"intelligence-and-research","reason":"Research runtimes supply versioned evidence and suppression policy."},{"areaSlug":"integrations-and-providers","reason":"Embedding, storage, LLM and connector implementations are selected separately."}],"sections":[{"id":"section-1","title":"Choose the workflow, then the provider","body":"The knowledge package contains static and vector retrieval, document processing, embeddings/indexing orchestration and retrieval-augmented queries. Its runtime convenience layer can compose ingest, retrieve and answer using supplied embedding, vector-store and LLM providers. Start with the space and namespace that express the intended source scope. Choose a static retriever for a deterministic source walkthrough or small fixture; choose vector retrieval when the application supplies a suitable indexed store and ingestion lifecycle. Neither choice removes access-policy responsibilities.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"]},{"id":"section-2","title":"Keep the source and retrieval layers connected","body":"The package exposes source-management operations and named knowledge spaces, including support FAQs, uploaded documents and Product Canon. Ingestion produces searchable material; retrieval selects material relevant to a query. Preserve original source identity, version and evidence locators through that transformation so a caller can inspect what supports an answer. Connector readiness manifests are useful for understanding supported composition paths, but the source explicitly distinguishes those manifests from live provider calls and production writes.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"]},{"id":"section-3","title":"Bind access and context before answering","body":"KnowledgeAccessGuard and grounding helpers provide the boundaries for scope-aware retrieval. The query result should remain connected to its allowed sources and citations. An agent context compiler can then enforce required inputs, trust classes and budgets. Avoid treating a retrieved passage as a new instruction authority or as permission to mutate a system. For knowledge mutations, the package separately documents dry runs, approval, idempotency, audit evidence and outbound-send gates; those checks belong to the selected mutation flow.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"]}],"taskGuide":[{"title":"Trace one source document","body":"Identify its knowledge space, namespace, source policy and original evidence location. Follow processing and indexing into a retrieval result, then check whether the answer preserves a useful citation back to the selected source.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"]},{"title":"Compare retrieval modes","body":"Use a static fixture to understand expected relevant passages and denied scope. Then inspect the equivalent vector-backed composition: provider selection, collection, ingestion revision and query behavior. Keep storage and model configuration explicit.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"]},{"title":"Review a stale or removed source","body":"Inspect the owning workflow’s behavior when source content changes, access is revoked or a required item is missing. The appropriate outcome may be reindexing, exclusion or an unavailable-context result rather than an apparently complete answer.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"]}],"referenceLinks":[{"label":"@lssm-tech/lib.knowledge package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/package.json"},{"label":"@lssm-tech/integration.provider-embedding package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/provider-embedding/package.json"},{"label":"@lssm-tech/integration.provider-vector-store package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/provider-vector-store/package.json"},{"label":"@lssm-tech/lib.context-storage package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/context-storage/package.json"},{"label":"knowledge source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/README.md"},{"label":"guard.ts","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/access/guard.ts"},{"label":"context-evidence.ts","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/knowledge/src/grounding/context-evidence.ts"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/agents/knowledge/README.md"],"sourcePaths":["packages/platform/agents/knowledge/src/access/guard.ts","packages/platform/agents/knowledge/src/grounding/context-evidence.ts"],"packageMetadataPaths":["packages/platform/agents/knowledge/package.json","packages/integrations/provider-embedding/package.json","packages/integrations/provider-vector-store/package.json","packages/platform/agents/context-storage/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":382,"packageCount":3},{"slug":"workflows-and-automation","title":"Workflows, jobs and automation","shortDescription":"Compose repeatable work with explicit state, persistence, branching and operation-execution responsibilities.","questions":["Do I need workflow composition, a scheduler or a product module?","How are extensions applied without breaking the graph?","Where are state and effect execution supplied?"],"tasks":["Compose an existing workflow","Inspect retries and state transitions","Choose a supplied persistence or scheduler boundary"],"packageNames":["@lssm-tech/bundle.self-improving-system","@lssm-tech/integration.eve","@lssm-tech/integration.self-improving-system-transport","@lssm-tech/integration.workflow-devkit","@lssm-tech/lib.bus","@lssm-tech/lib.jobs","@lssm-tech/lib.orchestration-spec","@lssm-tech/lib.self-improving-system-runtime","@lssm-tech/lib.sop-runtime","@lssm-tech/lib.workflow-composer","@lssm-tech/module.self-improving-system","@lssm-tech/module.workflow-orchestration"],"entryPoints":[{"packageName":"@lssm-tech/lib.workflow-composer","reason":"Use the workflow registry, composition/validation and supplied-authority runner surfaces.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md","exportPaths":[".","./workflow/runner","./workflow/state","./workflow/validation"]},{"packageName":"@lssm-tech/module.workflow-orchestration","reason":"Inspect reusable boards, DAG/composer views, instance lifecycle and approval composition.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/workflow-orchestration/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/workflow-orchestration/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.jobs","reason":"Inspect the shared job scheduling/execution abstractions used by a host.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/jobs/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/jobs/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.sop-runtime","reason":"Explore the source runtime for living operating procedures and their generation context.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/sop-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/sop-runtime/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"A step refers to a known operation or event, with its declared outcomes."},{"areaSlug":"governance-and-approvals","reason":"Branching and planning must preserve the effect authority of each step."}],"relationships":[{"areaSlug":"agents-and-context","reason":"Agents can propose or perform bounded work inside a declared workflow."},{"areaSlug":"delivery-and-infrastructure","reason":"Durable workers and execution environments implement operational concerns."},{"areaSlug":"company-and-work","reason":"Product workflows often project or update shared Work state."}],"sections":[{"id":"section-1","title":"Choose composition before scheduling","body":"WorkflowComposer supplies tenant-aware composition, validation, a runner, state and persistence adapters. Its runner requires supplied operation execution and state persistence. A provider-specific scheduler belongs at a different boundary. The workflow-orchestration module adds reusable product-facing views and lifecycle/approval behavior. Start by deciding whether your task is to describe a graph, execute selected steps, schedule work durably, or present an operator view; that decision identifies which package to open first.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"]},{"id":"section-2","title":"Keep graph changes deterministic","body":"The maintained composer applies extensions in stable priority order, rejects duplicate injected step IDs and invalid anchors, and checks hidden-step overlays so they do not orphan the remaining graph. Metadata and annotations are merged into the composed result. These details matter when adding a tenant or product extension: inspect the resulting graph and its references, not just the added step. Keep step identity stable enough for state, traces and operator actions to refer to the same work.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"]},{"id":"section-3","title":"Make execution and persistence visible","body":"The canonical leaves include workflow context, SLA monitoring and SDK error conversion as well as validation and shared task validators. Choose the state store and operation executor the host actually supplies. A saved plan, a running instance, a retried step and a completed external effect are different states. Capture outcomes and failure paths at the point where callbacks or adapters return. For automation that can improve or regenerate itself, use the separate governed proposal and promotion lifecycle rather than replacing an active workflow silently.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"]}],"taskGuide":[{"title":"Follow an existing graph","body":"Record the entry, operation references, branch conditions and terminal outcomes. Inspect one extension and compare the composed graph to its base. Check which registry and source version resolve each step.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"]},{"title":"Select state and execution adapters","body":"Begin with the maintained memory/file or supplied adapter appropriate to the example. Identify the durable store and scheduler needed for the intended host before claiming restart or retry guarantees.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"]},{"title":"Review interruption and recovery","body":"Use existing tests or fixtures to inspect a failed step, repeated delivery and cancelled instance. Confirm that persisted state and returned results explain what happened and that retry behavior belongs to an explicit host/runtime contract.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.workflow-composer package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/package.json"},{"label":"@lssm-tech/module.workflow-orchestration package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/workflow-orchestration/package.json"},{"label":"@lssm-tech/lib.jobs package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/jobs/package.json"},{"label":"@lssm-tech/lib.sop-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/sop-runtime/package.json"},{"label":"workflow-composer source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/workflow-composer/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/delivery/workflow-composer/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/delivery/workflow-composer/package.json","packages/platform/governance/workflow-orchestration/package.json","packages/platform/delivery/jobs/package.json","packages/platform/governance/sop-runtime/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":375,"packageCount":12},{"slug":"identity-and-access","title":"Identity, access and subject context","shortDescription":"Carry trusted actor and tenant context through product requests, agent actions and shared runtime projections.","questions":["Which layer authenticates a person and which projects authority?","How does subject context reach server-rendered UI?","How do provisioning and delegation remain scoped?"],"tasks":["Trace authenticated subject construction","Inspect an access projection","Separate identity-provider integration from domain contracts"],"packageNames":["@lssm-tech/integration.authos-better-auth","@lssm-tech/lib.authos-runtime","@lssm-tech/lib.authos-spec","@lssm-tech/lib.crypto-utils","@lssm-tech/lib.identity-rbac","@lssm-tech/module.auth-os"],"entryPoints":[{"packageName":"@lssm-tech/lib.authos-spec","reason":"Start with the identity, authentication, federation and account-surface contracts.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/spec/README.md","exportPaths":[".","./ecosystem","./ecosystem-catalog"]},{"packageName":"@lssm-tech/lib.authos-runtime","reason":"Use subject providers, SSR scope and deterministic security/provisioning projections.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md","exportPaths":["./subject","./ssr","./product-access"]},{"packageName":"@lssm-tech/integration.authos-better-auth","reason":"Inspect the concrete Better Auth integration used by the selected host.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/authos-better-auth/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/authos-better-auth/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.identity-rbac","reason":"Locate reusable role and permission composition already used by domain modules.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/identity-rbac/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/identity-rbac/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"An operation must describe the authority context its host needs."}],"relationships":[{"areaSlug":"governance-and-approvals","reason":"Identity is one input to a policy or approval decision."},{"areaSlug":"ui-and-presentations","reason":"Role-aware presentation consumes resolved subject and policy state."},{"areaSlug":"personal-and-learning","reason":"Personal data and delegated household actions need subject-specific scope."}],"sections":[{"id":"section-1","title":"Separate authentication from projection","body":"AuthOS spec declares identity and security-gated account behavior. AuthOS runtime converts those contracts into projections for RBAC, RoleMorph, personalization, redaction and other consumers. The README explicitly places authentication, database access and provider execution outside those pure projections. A concrete integration such as authos-better-auth and the product host perform that work. When adopting this area, trace where a verified session becomes a trusted subject before using an access projection in an API or interface.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"]},{"id":"section-2","title":"Keep context request-scoped","body":"The SSR entry binds the shared server-only subject scope with runWithSubject, cached reads and nested/concurrent request isolation. Subject construction stays with AuthOS; the lower propagation port does not decide policy. Subject providers can use a resolver and optional tenant-scoped cache, and malformed or failed resolution returns a denied/missing result. This separation helps prevent a convenient UI context from becoming an accidental cross-request authority source. Inspect cache keys and request lifetime alongside the subject shape.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"]},{"id":"section-3","title":"Model provisioning as receipts and state","body":"The provisioning reducer consumes redacted, idempotent receipts covering identity, entitlements, product-local membership, activation and revocation. It avoids activating a partially provisioned product and detects scope/idempotency conflicts. Rebuild and retry behavior therefore belongs to a recorded lifecycle rather than an unchecked sequence of provider calls. The domain-command helper can produce governance-bearing local events while retaining canExecute false plans. Host execution must still resolve the required provider, database and approval boundaries.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"]}],"taskGuide":[{"title":"Trace one authenticated request","body":"Identify the identity provider, session verifier, subject factory, tenant/workspace selection and operation context. Keep user-supplied identifiers separate from the values the host has verified.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"]},{"title":"Inspect the missing-authority case","body":"Follow an absent session, malformed subject, revoked membership or mismatched workspace through the same path. Check that both the UI projection and the execution boundary express the expected unavailable or denied state.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"]},{"title":"Review a provisioning retry","body":"Use the existing receipt/reducer flow to see whether a repeated step resumes safely and whether partial activation stays visible. Bind the selected product membership and entitlement to the exact subject instead of treating organization membership as universal product access.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.authos-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/spec/package.json"},{"label":"@lssm-tech/lib.authos-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/package.json"},{"label":"@lssm-tech/integration.authos-better-auth package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/authos-better-auth/package.json"},{"label":"@lssm-tech/lib.identity-rbac package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/identity-rbac/package.json"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/identity/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/identity/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/identity/spec/package.json","packages/domains/identity/runtime/package.json","packages/integrations/authos-better-auth/package.json","packages/domains/identity/identity-rbac/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":366,"packageCount":6},{"slug":"governance-and-approvals","title":"Governance, decisions and approvals","shortDescription":"Resolve policy and review decisions into explicit evidence before consequential work is allowed to proceed.","questions":["What is a decision trace versus an execution permit?","How does Connect bind a decision to the exact work?","Where do human review and obligations enter the flow?"],"tasks":["Inspect a digest-bound permit","Evaluate a decision graph","Connect a review queue to a protected operation"],"packageNames":["@lssm-tech/lib.assurance-spec","@lssm-tech/lib.contractspec-connect","@lssm-tech/lib.decision-runtime","@lssm-tech/lib.economic-evidence","@lssm-tech/lib.feature-flags","@lssm-tech/module.audit-trail","@lssm-tech/module.editions","@lssm-tech/module.governance-suite","@lssm-tech/module.human-review","@lssm-tech/module.review-queue"],"entryPoints":[{"packageName":"@lssm-tech/lib.contractspec-connect","reason":"Use the existing packet authority and durable, signed decision boundaries.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","exportPaths":[".","./authority","./ports"]},{"packageName":"@lssm-tech/lib.decision-runtime","reason":"Use deterministic predicates and decision-graph evaluation/conversion.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md","exportPaths":[".","./form-decision-graph"]},{"packageName":"@lssm-tech/module.human-review","reason":"Inspect reusable human-review composition around governed work.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/human-review/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/human-review/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/module.review-queue","reason":"Locate review queue, assignment and decision-facing composition.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/review-queue/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/review-queue/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"identity-and-access","reason":"A decision must use trusted actor, scope and current entitlement."},{"areaSlug":"core-contracts","reason":"The proposed action and its required approval must be named precisely."}],"relationships":[{"areaSlug":"workflows-and-automation","reason":"The selected branch can reference a permitted workflow operation."},{"areaSlug":"delivery-and-infrastructure","reason":"Execution verifies the permit against the exact plan and current state."},{"areaSlug":"billing-and-finance","reason":"Financial handoffs require their own explicit authorization and evidence."}],"sections":[{"id":"section-1","title":"Match the decision to the proposed work","body":"Connect issues and verifies context, plan, mutation, diff and promotion decisions bound to digests. Production hosts use durable-required mode with injected receipt storage and signing. The README describes a permit as usable only after its receipt has been stored and exact read-back matches. Verification at the point of use checks freshness, scope and integrity. This gives a concrete integration rule: changing the target, plan or relevant context requires the corresponding decision binding to be reassessed.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"]},{"id":"section-2","title":"Use decisions for branching, then enforce effects","body":"DecisionRuntime evaluates shared predicates and immutable decision graphs without evaluating creator-authored code. It validates before execution, bounds complexity and traces, pins subgraphs by revision/digest, and produces replayable results. Form conversion lives in a dedicated adapter. Workflow conversion only admits exact outcome-operation revisions in the server-controlled allowlist; the workflow/product runtime still owns effect execution and authorization. Keep a graph evaluation trace available to explain why a branch was selected.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"]},{"id":"section-3","title":"Make human review useful","body":"HumanReview, ReviewQueue and the governance modules provide product composition around assignment, escalation and review outcomes. Present the exact proposed action, its scope, material changes and supporting evidence. A review record should identify the decision it produced and the work it applies to. Keep obligations visible: an allow decision can still require a host to fulfill conditions or persist evidence before an action is eligible. A button label or a previously granted role is not a replacement for that current decision.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"]}],"taskGuide":[{"title":"Inspect a protected action","body":"Follow its approval requirement, trusted actor/context and decision request. Locate the receipt store/signature ports and the point at which the executor re-reads or verifies the resulting permit.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"]},{"title":"Trace a changed proposal","body":"Compare the approved target with a changed input, stale plan or different scope. Use the maintained validation path to see which binding invalidates the old receipt and which review must be repeated.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"]},{"title":"Check the operator experience","body":"Review how pending, denied, expired, superseded and completed decisions appear in the queue. Link the operator back to the exact evidence and outcome rather than collapsing every non-success state into a generic failure.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.contractspec-connect package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/package.json"},{"label":"@lssm-tech/lib.decision-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/package.json"},{"label":"@lssm-tech/module.human-review package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/human-review/package.json"},{"label":"@lssm-tech/module.review-queue package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/review-queue/package.json"},{"label":"contractspec-connect source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/contractspec-connect/README.md"},{"label":"decision-runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/decision-runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/governance/contractspec-connect/README.md","packages/platform/governance/decision-runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/governance/contractspec-connect/package.json","packages/platform/governance/decision-runtime/package.json","packages/platform/governance/human-review/package.json","packages/platform/governance/review-queue/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":360,"packageCount":10},{"slug":"communication-and-notifications","title":"Communication and notifications","shortDescription":"Compose messaging, delivery, channels and notifications around scoped journals and current send authority.","questions":["Which layer is the protocol, runtime, reusable UI or host?","What changes between a message draft and an authorized send?","How do provider events become durable communication records?"],"tasks":["Embed a communication surface","Trace provider ingestion and delivery","Choose live versus preview data deliberately"],"packageNames":["@lssm-tech/app.communicationos-api","@lssm-tech/app.communicationos-desktop","@lssm-tech/app.communicationos-discord-worker","@lssm-tech/app.communicationos-mcp","@lssm-tech/app.communicationos-mobile","@lssm-tech/app.communicationos-realtime","@lssm-tech/app.communicationos-web","@lssm-tech/app.communicationos-worker","@lssm-tech/bundle.communication-os","@lssm-tech/integration.communication-channel-core","@lssm-tech/integration.communication-channel-discord","@lssm-tech/integration.communication-channel-email","@lssm-tech/integration.communication-channel-slack","@lssm-tech/integration.communication-channel-sms","@lssm-tech/integration.communication-channel-telegram","@lssm-tech/integration.communication-os-agent","@lssm-tech/integration.communication-os-client","@lssm-tech/integration.communication-os-host-auth","@lssm-tech/integration.communication-os-persistence","@lssm-tech/integration.communication-os-realtime-ticket","@lssm-tech/integration.communication-os-runtime","@lssm-tech/lib.communication-runtime","@lssm-tech/lib.communication-spec","@lssm-tech/lib.email","@lssm-tech/lib.notification","@lssm-tech/module.communication-os","@lssm-tech/module.notifications"],"entryPoints":[{"packageName":"@lssm-tech/lib.communication-spec","reason":"Inspect the canonical messaging and governance contracts before selecting a channel.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/spec/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.communication-runtime","reason":"Use journal, projection, delivery and authority logic with supplied persistence/provider ports.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","exportPaths":[".","./delivery-intent","./command-inbox"]},{"packageName":"@lssm-tech/module.communication-os","reason":"Choose reusable routes, contextual slots and communication UI composition.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/integration.communication-channel-core","reason":"Inspect the shared concrete channel integration boundary before selecting Discord, email, Slack, SMS or Telegram.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/communication-channel-core/package.json","readmeUrl":null,"exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"identity-and-access","reason":"Membership, tenant scope and principal identity determine permitted communication."},{"areaSlug":"core-contracts","reason":"Provider events and message actions need stable semantic contracts."}],"relationships":[{"areaSlug":"company-and-work","reason":"Conversations can create handoffs, support cases and work proposals."},{"areaSlug":"integrations-and-providers","reason":"Channel SDKs, credentials and external delivery live in adapters."},{"areaSlug":"agents-and-context","reason":"Agents participate through explicit grants and approved tool behavior."}],"sections":[{"id":"section-1","title":"Start with the three-layer boundary","body":"CommunicationSpec and CommunicationRuntime define the protocol, journal, projections and authority behavior. ModuleCommunicationOS provides reusable product UI. Apps and bundles choose deployment, identity, transport and provider configuration. This makes the communication hub usable both inside another product and as a standalone host. Select the package by the job you are doing, then follow the host-specific binding; importing the visual module alone does not connect a live account or create a durable delivery system.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"]},{"id":"section-2","title":"Keep journal truth separate from external delivery","body":"The runtime maintains scope-isolated append-only journal behavior and deterministic projections. Typed provider ingestion can retain non-message events as their own journal records instead of fabricating messages. Send checks apply to the current human, agent or system principal. The documented default remains legacy_draft_only; membership_grants mode requires current membership and auditable, revocable grants from the host. Inspect delivery intent, eligibility, queue acceptance and retry evidence as separate transitions so the product can explain whether a message was drafted, accepted or actually delivered.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"]},{"id":"section-3","title":"Choose honest UI data modes","body":"The communication landing surface accepts an explicit dataMode. Deterministic examples keep preview behavior, while authenticated managed routes use live projections. Live mode derives counts from the supplied workspace projection and removes synthetic-data disclosure. Keep the same distinction in a new host: a preview should teach the interaction, while a live screen must reflect the selected workspace and current authority. Capability-gated actions, pending outbox work and meeting threads should remain inspectable from the interface.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"]}],"taskGuide":[{"title":"Trace one inbound item","body":"Follow the provider event through normalization, scope validation and append-only journal storage into the room/space projection. Inspect whether a non-message event retains its correct kind and evidence.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"]},{"title":"Trace one outbound draft","body":"Identify the principal, room membership, grant and selected channel. Follow the transition through current send checks, provider queue acceptance and delivery evidence, including an ambiguous or retried outcome.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"]},{"title":"Embed the appropriate surface","body":"Choose the reusable module route or slot and supply the host’s actual projection and data mode. Review denied membership, disconnected channel and pending delivery states before treating the resulting screen as a live communication workflow.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.communication-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/spec/package.json"},{"label":"@lssm-tech/lib.communication-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/package.json"},{"label":"@lssm-tech/module.communication-os package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/package.json"},{"label":"@lssm-tech/integration.communication-channel-core package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/communication-channel-core/package.json"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/runtime/README.md"},{"label":"module source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/communication/module/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/communication/runtime/README.md","packages/domains/communication/module/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/communication/spec/package.json","packages/domains/communication/runtime/package.json","packages/domains/communication/module/package.json","packages/integrations/communication-channel-core/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":374,"packageCount":27},{"slug":"billing-and-finance","title":"Billing, finance and economic evidence","shortDescription":"Model commercial lifecycles, exact money and reviewable financial handoffs with provider and country boundaries kept explicit.","questions":["Where do country-neutral billing contracts stop?","How do billing facts become a FinanceOS handoff?","Which operations require a concrete adapter and approval?"],"tasks":["Inspect quote-to-cash state","Trace an economic-evidence correction","Prepare a governed posting handoff"],"packageNames":["@lssm-tech/lib.billing-france","@lssm-tech/lib.billing-runtime","@lssm-tech/lib.billing-spec","@lssm-tech/lib.cost-tracking","@lssm-tech/lib.crypto-payments-spec","@lssm-tech/lib.finance-ops-spec","@lssm-tech/lib.finance-os-runtime","@lssm-tech/lib.metering","@lssm-tech/module.billing-os","@lssm-tech/module.finance-os"],"entryPoints":[{"packageName":"@lssm-tech/lib.billing-spec","reason":"Begin with country-neutral quote-to-cash contracts, lifecycle evidence and operation descriptions.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","exportPaths":[".","./billing-os"]},{"packageName":"@lssm-tech/lib.billing-runtime","reason":"Use deterministic lifecycle projections, supplied persistence ports and economic-truth helpers.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","exportPaths":[".","./truth","./ports"]},{"packageName":"@lssm-tech/lib.finance-os-runtime","reason":"Inspect exact-money, budget, posting and consolidation projections.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md","exportPaths":["./money","./posting","./handoff"]},{"packageName":"@lssm-tech/lib.billing-france","reason":"Inspect the separate France-specific package when a selected composition needs that country layer.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/billing-france/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/billing-france/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"schemas-and-results","reason":"Money, currency, scale and evidence must retain exact representations."},{"areaSlug":"governance-and-approvals","reason":"Consequential financial handoffs need current, bound approval."}],"relationships":[{"areaSlug":"integrations-and-providers","reason":"Payment, invoicing and banking providers supply external effects."},{"areaSlug":"observability-and-testing","reason":"Financial evidence must be correlatable without exposing sensitive payloads."},{"areaSlug":"company-and-work","reason":"Operating views consume billing and finance projections without duplicating their truth."}],"sections":[{"id":"section-1","title":"Choose the correct domain boundary","body":"BillingSpec models commercial parties, catalog/pricing, quotes, orders, invoices, credit notes, payments, reconciliation and related evidence. BillingRuntime supplies deterministic projections over those contracts with an injected tax-calculation port and backend-neutral persistence interfaces. The separate country package and provider integrations handle their specific responsibilities. Start by identifying the exact lifecycle and jurisdictional composition required by the host; a country-neutral operation declaration is not proof of configured production invoicing or payment execution.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"]},{"id":"section-2","title":"Preserve economic history","body":"The billing truth surface normalizes facts into an append-only evidence lifecycle with revision and idempotency checks. Corrections supersede earlier facts while retaining history. FinanceOS validates exact money, entity/tenant isolation, balanced postings, segregation of duties and budget freshness. Consequential work becomes a digest-bound handoff for host approval and execution. This division makes an accounting review reproducible: the reviewer can follow the original fact, its correction lineage and the proposed posting instead of trusting a mutable total.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"]},{"id":"section-3","title":"Respect unit and execution constraints","body":"Finance consolidation is holding-bound and homogeneous in currency and scale. Mixed units need governed conversion evidence and are denied by default in the documented runtime. BillingRuntime defines invoice, credit-note, event-log and invoice-chain ports rather than selecting a database or payment provider. Keep a proposed handoff, an authorized action and a confirmed external effect distinct in product copy and telemetry. Adapter qualification should address replay and ambiguous provider outcomes as well as the successful path.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"]}],"taskGuide":[{"title":"Trace one commercial transition","body":"Start with a quote or invoice reference and follow the declared operation, lifecycle projection and evidence event. Identify the exact money representation, tenant/company scope and persistence port involved.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"]},{"title":"Inspect a correction and handoff","body":"Follow a superseding correction into the resulting finance proposal. Check balanced units, required evidence and the Connect authorization reference before considering the handoff eligible for a host executor.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"]},{"title":"Choose the external boundary","body":"Locate the country and provider adapter used by the intended product. Review its credential, submission, reconciliation and failure responsibilities separately from the portable runtime; qualify that composition in its owning environment.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.billing-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/package.json"},{"label":"@lssm-tech/lib.billing-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/package.json"},{"label":"@lssm-tech/lib.finance-os-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/package.json"},{"label":"@lssm-tech/lib.billing-france package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/billing-france/package.json"},{"label":"spec source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/spec/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/billing/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/finance/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/billing/spec/README.md","packages/domains/billing/runtime/README.md","packages/domains/finance/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/billing/spec/package.json","packages/domains/billing/runtime/package.json","packages/domains/finance/runtime/package.json","packages/domains/billing/billing-france/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":361,"packageCount":10},{"slug":"company-and-work","title":"Company, work and service operations","shortDescription":"Connect operating goals, shared work, planning, meetings and support through their canonical domain boundaries.","questions":["Which package owns tasks and project state?","How do CompanyOS projections use shared work?","How can support and meeting workflows hand off work without copying another domain?"],"tasks":["Trace an operating proposal into Work","Inspect a meeting or support handoff","Keep product projections separate from durable domain state"],"packageNames":["@lssm-tech/app.meeting-effect-worker","@lssm-tech/app.meeting-intake-worker","@lssm-tech/app.organization-planning-host","@lssm-tech/app.supportos-api","@lssm-tech/app.supportos-desktop","@lssm-tech/app.supportos-web","@lssm-tech/app.supportos-worker","@lssm-tech/integration.company-intelligence-postgres","@lssm-tech/integration.customer-support-postgres","@lssm-tech/integration.meeting-effect-worker-postgres-http","@lssm-tech/integration.meeting-intake-worker-postgres-http","@lssm-tech/integration.opa-calendar-bridge","@lssm-tech/integration.opa-meeting-context-bridge","@lssm-tech/integration.opa-notification-bridge","@lssm-tech/integration.opa-personalization-bridge","@lssm-tech/integration.supportos-worker-managed","@lssm-tech/integration.work-durable-store","@lssm-tech/lib.companyos-runtime","@lssm-tech/lib.companyos-spec","@lssm-tech/lib.customer-support-conformance","@lssm-tech/lib.customer-support-runtime","@lssm-tech/lib.customer-support-spec","@lssm-tech/lib.organization-planning-react","@lssm-tech/lib.organization-planning-runtime","@lssm-tech/lib.organization-planning-spec","@lssm-tech/lib.support-bot","@lssm-tech/lib.supportos-worker-runtime","@lssm-tech/lib.work-runtime","@lssm-tech/lib.work-spec","@lssm-tech/module.company-metrics","@lssm-tech/module.companyos","@lssm-tech/module.customer-support","@lssm-tech/module.executive-intelligence","@lssm-tech/module.organization-planning","@lssm-tech/module.work-management","@lssm-tech/opa-booking-react"],"entryPoints":[{"packageName":"@lssm-tech/lib.work-runtime","reason":"Start with immutable Work events, recurrence, sync conflict handling and durable-store ports.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","exportPaths":[".","./reducer","./outbox-dispatch","./task-status"]},{"packageName":"@lssm-tech/lib.companyos-runtime","reason":"Use CompanyOS authority, operating-loop, graph and outcome projections over shared references.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","exportPaths":[".","./authority","./company-intelligence-graph"]},{"packageName":"@lssm-tech/lib.organization-planning-runtime","reason":"Inspect OPA planning/meeting services and their current authority and consent boundaries.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.customer-support-runtime","reason":"Inspect SupportOS lifecycle, case concurrency, routing and reference-based ecosystem handoffs.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Each domain declares the operation and event identity it owns."},{"areaSlug":"identity-and-access","reason":"Work and service operations are scoped to the current subject and workspace."}],"relationships":[{"areaSlug":"communication-and-notifications","reason":"Communication owns message bodies and delivery used by these workflows."},{"areaSlug":"forms-and-data","reason":"Forms owns submitted answers and verification evidence."},{"areaSlug":"app-composition","reason":"A product bundle composes these domains into an integrated operating experience."}],"sections":[{"id":"section-1","title":"Follow the owner of durable state","body":"WorkRuntime is the shared owner for task/project reducers and persistence ports. It consumes immutable events, checks revision order, expands recurrence and resolves sync authority/conflicts. CompanyOS runtime uses Work references for operating reviews and graph projections. Keep that direction when adding a feature: a dashboard or assistant should reference the canonical task rather than maintaining a parallel mutable task copy. Concrete PostgreSQL, queue, realtime and connector behavior belongs to the selected integrations and host.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"]},{"id":"section-2","title":"Understand domain-specific handoffs","body":"CompanyOS adds authority explanations, autonomy classification, operator inbox routing and evidence-backed outcome projections. OPA contributes profile and meeting-workspace behavior, while SupportOS contributes case lifecycle, routing and service operations. Support routing can evaluate candidate projections deterministically, but assignment remains a separate governed effect. Message bodies stay with CommunicationOS and form answers with Forms. A cross-domain handoff should therefore name the exact referenced work or operation and the evidence needed by its receiving owner.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"]},{"id":"section-3","title":"Inspect retries and active capabilities","body":"Work outbox delivery uses leased, destination-specific records and fenced acknowledgements; current source requires the exact delivery attempt for settlement. OPA distinguishes its operation catalog, partial handler map and installed registry. Saving an automation policy does not itself activate background execution. These distinctions are useful product states, not implementation trivia: an operator needs to know whether a proposal exists, a handler is installed, delivery is pending or an external effect completed. Preserve that vocabulary in a composed product.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"]}],"taskGuide":[{"title":"Trace one work item","body":"Open its contract and follow event reduction, revision checks, storage and the projection used by the UI. Compare a repeated command and a conflicting update using the owning runtime’s existing tests or fixtures.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"]},{"title":"Follow one domain handoff","body":"Choose a support-to-work or meeting-to-work path. Identify which domain owns the original record, which references cross the boundary and where authority is rechecked before the receiving action.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"]},{"title":"Inspect the composed availability","body":"Check the bundle’s installed modules, handlers, required ports and selected capabilities. Show proposals, queued actions and completed effects separately, then link an operator to the evidence or recovery path relevant to that exact state.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.work-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/package.json"},{"label":"@lssm-tech/lib.companyos-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/package.json"},{"label":"@lssm-tech/lib.organization-planning-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/package.json"},{"label":"@lssm-tech/lib.customer-support-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/package.json"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/work/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/company/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/organization-planning/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/customer-support/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/work/runtime/README.md","packages/domains/company/runtime/README.md","packages/domains/organization-planning/runtime/README.md","packages/domains/customer-support/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/work/runtime/package.json","packages/domains/company/runtime/package.json","packages/domains/organization-planning/runtime/package.json","packages/domains/customer-support/runtime/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":374,"packageCount":36},{"slug":"intelligence-and-research","title":"Intelligence, research and applications","shortDescription":"Manage discovered sources, evidence-backed facts and candidate-authorized application work through explicit lifecycle boundaries.","questions":["How do discovered sources become eligible facts?","What makes a research result traceable?","Where does a candidate authorize an application effect?"],"tasks":["Follow source qualification and revalidation","Inspect an evidence-bearing knowledge projection","Trace a candidate application through approval and reconciliation"],"packageNames":["@lssm-tech/app.job-application-api","@lssm-tech/app.job-application-cli","@lssm-tech/app.job-application-console","@lssm-tech/app.job-application-mcp","@lssm-tech/app.job-application-worker","@lssm-tech/app.osint-api","@lssm-tech/app.osint-cli","@lssm-tech/app.osint-console","@lssm-tech/app.osint-mcp","@lssm-tech/app.osint-worker","@lssm-tech/bundle.job-application","@lssm-tech/bundle.osint","@lssm-tech/integration.job-application-browser","@lssm-tech/integration.job-application-effects-dependencies-railway","@lssm-tech/integration.job-application-effects-managed","@lssm-tech/integration.job-application-email","@lssm-tech/integration.job-application-managed-runtime","@lssm-tech/integration.job-application-store","@lssm-tech/integration.job-application-transport","@lssm-tech/integration.job-application-webhook-resend-managed","@lssm-tech/integration.job-sources","@lssm-tech/integration.osint-managed-runtime","@lssm-tech/integration.osint-store","@lssm-tech/integration.osint-transport","@lssm-tech/lib.founder-intelligence-runtime","@lssm-tech/lib.founder-intelligence-spec","@lssm-tech/lib.job-application-runtime","@lssm-tech/lib.job-source-runtime","@lssm-tech/lib.opportunity-runtime","@lssm-tech/lib.opportunity-spec","@lssm-tech/lib.osint-runtime","@lssm-tech/lib.osint-spec","@lssm-tech/lib.talent-spec","@lssm-tech/module.community-intelligence","@lssm-tech/module.founder-intelligence","@lssm-tech/module.job-application","@lssm-tech/module.osint","@lssm-tech/module.talent"],"entryPoints":[{"packageName":"@lssm-tech/lib.osint-spec","reason":"Start with the source, policy and evidence contract vocabulary for OSINT.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/spec/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.osint-runtime","reason":"Use source lifecycle, ingestion, qualification and scoped evidence projection logic.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.job-application-runtime","reason":"Inspect candidate-private lifecycle, headless orchestration and effect-fencing responsibilities.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md","exportPaths":[".","./headless","./contracts"]},{"packageName":"@lssm-tech/lib.opportunity-spec","reason":"Inspect the opportunity domain’s declared models and references before composing an opportunity workflow.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/spec/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"identity-and-access","reason":"Actor, candidate, purpose and grant scope are inputs to each effect and read."},{"areaSlug":"knowledge-and-retrieval","reason":"Searchable knowledge is a derived aid with source/evidence bindings."}],"relationships":[{"areaSlug":"integrations-and-providers","reason":"Web access, browser, email, storage and transport adapters execute selected external work."},{"areaSlug":"company-and-work","reason":"Company and talent workflows consume eligible research through explicit references."},{"areaSlug":"governance-and-approvals","reason":"Human decisions and current authority constrain consequential application actions."}],"sections":[{"id":"section-1","title":"Treat research as a source lifecycle","body":"OSINT runtime separates source discovery, qualification, ingestion and revalidation. Its documented behavior applies scoped policy, idempotent receipts, suppression filtering and evidence-backed assertions before projecting eligible facts into knowledge. Start with the source manifest and the policy that makes the source usable for the selected purpose. A recently discovered URL and an eligible, versioned evidence source are different states; preserve that difference in both the interface and downstream agent context.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"]},{"id":"section-2","title":"Keep evidence and replay attached","body":"Lifecycle mutations are revision-fenced and produce append-only receipts tied to the resulting source manifest. Lease and request bindings let durable workers resume interrupted work and recognize a committed transition. Knowledge projections retain source versions, evidence locators, grant references, purpose and index generation. Query receipts bind returned facts back to evidence and policy decisions. This provides a concrete review path: inspect the assertion, its selected source revision and the authority under which it entered the result set.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"]},{"id":"section-3","title":"Separate application planning from effects","body":"JobApplicationRuntime owns candidate-authorized lifecycle, field proposals, effect fences and replay. Its headless entry provides orchestration without requiring a UI module. The documented default is confirmation for each application; unsupported interactive challenges have no automatic bypass. Browser sessions, email, credentials, persistence and runtime execution remain injected boundaries. The candidate-private contracts and deletion-worker semantics make consent and recovery part of the same lifecycle instead of an afterthought in a connector.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"]}],"taskGuide":[{"title":"Inspect a source-backed fact","body":"Follow discovery to qualification and ingestion, then inspect the fact’s source version, evidence locator and permitted purpose. Check how suppression, revalidation and source changes affect later retrieval.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"]},{"title":"Trace an application proposal","body":"Locate the candidate scope, proposed field values and evidence, confirmation step and exact reserved effect. Identify the selected browser/email provider boundary before interpreting a proposal as a submitted application.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"]},{"title":"Review ambiguous completion","body":"Inspect how a timed-out external action is reconciled using its existing receipt or fence. Verify the owning source’s deletion and retention flow separately from ordinary retry behavior; a repeated click should not be assumed to mean a safe repeat effect.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.osint-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/spec/package.json"},{"label":"@lssm-tech/lib.osint-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/package.json"},{"label":"@lssm-tech/lib.job-application-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/package.json"},{"label":"@lssm-tech/lib.opportunity-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/opportunity/spec/package.json"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/osint/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/job-application/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/osint/runtime/README.md","packages/domains/job-application/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/osint/spec/package.json","packages/domains/osint/runtime/package.json","packages/domains/job-application/runtime/package.json","packages/domains/opportunity/spec/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":364,"packageCount":38},{"slug":"content-and-growth","title":"Content, growth and creator operations","shortDescription":"Move from source-grounded drafts and optimization reports to reviewed publishing, measurement and commercial lifecycle evidence.","questions":["Which package drafts content and which can publish it?","What invalidates an editorial approval?","How do creator earnings and growth rewards preserve evidence?"],"tasks":["Inspect a generated content draft","Trace editorial review and publication","Follow attribution or creator settlement evidence"],"packageNames":["@lssm-tech/app.marketing-operations","@lssm-tech/app.video-studio","@lssm-tech/bundle.creator-platform","@lssm-tech/bundle.marketing-operations","@lssm-tech/integration.creator-persistence","@lssm-tech/integration.editorial-publishing","@lssm-tech/integration.growth-dub","@lssm-tech/integration.growth-payments","@lssm-tech/integration.growth-persistence","@lssm-tech/integration.social-tracking-runtime","@lssm-tech/lib.advertising-runtime","@lssm-tech/lib.analytics","@lssm-tech/lib.content-analysis-runtime","@lssm-tech/lib.content-analysis-spec","@lssm-tech/lib.content-gen","@lssm-tech/lib.creative-intelligence-runtime","@lssm-tech/lib.creative-intelligence-spec","@lssm-tech/lib.creator-operations-runtime","@lssm-tech/lib.creator-operations-spec","@lssm-tech/lib.growth-runtime","@lssm-tech/lib.growth-spec","@lssm-tech/lib.image-gen","@lssm-tech/lib.video-gen","@lssm-tech/module.content-generation","@lssm-tech/module.creator-operations","@lssm-tech/module.editorial","@lssm-tech/module.growth-os","@lssm-tech/module.marketing-evolution","@lssm-tech/module.social-analytics","@lssm-tech/module.social-media"],"entryPoints":[{"packageName":"@lssm-tech/lib.content-gen","reason":"Use blog, email, social and marketing draft generators plus optimization reports.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","exportPaths":[".","./generators","./geo","./geographic"]},{"packageName":"@lssm-tech/lib.growth-runtime","reason":"Inspect referral/reward lifecycle and optional marketing/editorial execution over supplied ports.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","exportPaths":[".","./marketing"]},{"packageName":"@lssm-tech/lib.creator-operations-runtime","reason":"Use creator campaign, agreement, submission and settlement lifecycle composition.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.content-analysis-runtime","reason":"Inspect content analysis behavior separately from generation and publication.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/runtime/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Drafts, observations and publication actions need distinct contracts."},{"areaSlug":"governance-and-approvals","reason":"A publishing decision must bind the content actually reviewed."}],"relationships":[{"areaSlug":"integrations-and-providers","reason":"Social, publishing, advertising and payment adapters own provider-specific effects."},{"areaSlug":"billing-and-finance","reason":"Commercial rewards and settlements need exact money and evidence."},{"areaSlug":"observability-and-testing","reason":"Measurements and attribution require explicit provenance and limits."}],"sections":[{"id":"section-1","title":"Start with a draft or analysis goal","body":"ContentGen provides separate generators for formats such as blog, email and social posts. Its documented social flow parses model JSON and discards invalid channels, unsafe links or malformed content before a caller can approve publication. The geo and geographic surfaces address generative-engine optimization and local-market adaptation respectively; they return reports. Select the format and analysis task first, then inspect the model/provider input and the reviewable output rather than assuming a generated text is ready for an external account.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"]},{"id":"section-2","title":"Bind publishing to the exact reviewed content","body":"GrowthRuntime’s marketing entry includes editorial services and source-aware measurement with host-supplied authorization, durable compare-and-swap storage, provider, clock and IDs. Provider effects are unavailable by default. Edits invalidate previous approval and scheduling, reviews bind to a content digest, and removing a published item requires a separate withdrawal flow. Concurrent reservations and ambiguous outcomes make reconciliation a first-class path. A product should therefore distinguish draft, approved, scheduled, dispatched and confirmed publication states.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"]},{"id":"section-3","title":"Preserve commercial lifecycle facts","body":"Growth attribution selects a prioritized winner and applies consent, identity, approval and maturity boundaries before reward/payout transitions. CreatorOperations adds immutable accepted agreements, submission review, cumulative accrual and settlement orchestration. Its source represents money with explicit currency and scale and retains reservations when provider outcomes are unknown. Corrections should preserve the evidence and accepted terms they supersede. Keep a campaign estimate, earned balance, payout proposal and confirmed settlement separate when building reporting or an agent tool.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"]}],"taskGuide":[{"title":"Trace a single content item","body":"Choose one generator or analysis surface and inspect its validated output. Locate the publication operation and provider separately, then identify the content digest and evidence the reviewer sees.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"]},{"title":"Inspect an editorial change","body":"Change the proposed content in the owning fixture and follow how approval/scheduling state is invalidated. Review the path for uncertain publication and an explicit withdrawal of content already confirmed live.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"]},{"title":"Follow one commercial result","body":"Trace an attribution or submission observation through the deterministic lifecycle into a reward or settlement proposal. Keep source evidence, unit conversion, authorization and provider confirmation visible to the host and operator.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.content-gen package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/package.json"},{"label":"@lssm-tech/lib.growth-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/package.json"},{"label":"@lssm-tech/lib.creator-operations-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/package.json"},{"label":"@lssm-tech/lib.content-analysis-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/runtime/package.json"},{"label":"content-gen source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/content/content-gen/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/growth/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/creator/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/content/content-gen/README.md","packages/domains/growth/runtime/README.md","packages/domains/creator/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/content/content-gen/package.json","packages/domains/growth/runtime/package.json","packages/domains/creator/runtime/package.json","packages/domains/content/runtime/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":366,"packageCount":30},{"slug":"personal-and-learning","title":"Personal workflows, learning and progress","shortDescription":"Compose subject-controlled personal workflows and learning experiences with explicit consent, replay and progress semantics.","questions":["How is personal authority bound to a command?","Which runtime owns learning progress or gamification?","How are private records kept separate from organization views?"],"tasks":["Trace a personal command and receipt","Adapt a learning journey","Inspect progress, consent and revocation behavior"],"packageNames":["@lssm-tech/app.personalos-api","@lssm-tech/app.personalos-desktop","@lssm-tech/app.personalos-mobile","@lssm-tech/app.personalos-web","@lssm-tech/app.personalos-worker","@lssm-tech/bundle.personal-os","@lssm-tech/integration.personal-os-authos","@lssm-tech/integration.personal-os-state-postgres","@lssm-tech/lib.gamification-runtime","@lssm-tech/lib.gamification-spec","@lssm-tech/lib.personal-finance-runtime","@lssm-tech/lib.personal-finance-spec","@lssm-tech/lib.personal-health-runtime","@lssm-tech/lib.personal-health-spec","@lssm-tech/lib.personal-os-runtime","@lssm-tech/lib.personal-os-spec","@lssm-tech/module.gamification","@lssm-tech/module.learning-journey","@lssm-tech/module.personal-community","@lssm-tech/module.personal-experience","@lssm-tech/module.personal-finance","@lssm-tech/module.personal-founder-support","@lssm-tech/module.personal-goals","@lssm-tech/module.personal-health","@lssm-tech/module.personal-household","@lssm-tech/module.personal-learning","@lssm-tech/module.personal-life-admin","@lssm-tech/module.personal-operations","@lssm-tech/module.personal-productivity"],"entryPoints":[{"packageName":"@lssm-tech/lib.personal-os-runtime","reason":"Use subject-bound authorization, command builders, replay and rights projections.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","exportPaths":[".","./authority","./command-envelope"]},{"packageName":"@lssm-tech/module.learning-journey","reason":"Explore onboarding, drills, coaching and progress adapters.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","exportPaths":[".","./engines"]},{"packageName":"@lssm-tech/lib.gamification-runtime","reason":"Inspect deterministic campaign, activity, XP, streak and replay behavior.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.personal-health-runtime","reason":"Inspect strict consent, normalization, sync and evidence boundaries for health-domain data.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"identity-and-access","reason":"Personal actions need an exact trusted subject and delegated scope."},{"areaSlug":"schemas-and-results","reason":"Progress and personal records must preserve explicit units, time and provenance."}],"relationships":[{"areaSlug":"forms-and-data","reason":"Personal inputs and consent-bearing records often enter through forms or exchanges."},{"areaSlug":"agents-and-context","reason":"Assistive agents receive only the selected, authorized personal context."},{"areaSlug":"app-composition","reason":"The product host supplies encrypted persistence, providers and usable journeys."}],"sections":[{"id":"section-1","title":"Bind a personal action to its subject","body":"PersonalOS runtime supplies pure authority, autonomy, immutable-event replay and rights primitives. Hosts provide verified identity, clocks, encryption, audit, durable stores and effects. The documented transaction seam binds the command, receipt, event, encrypted snapshot, idempotency result and outbox together. Browser-safe command builders accept exact host-supplied context and preserve the declared policy. Constructing a household delegation or a personal plan does not authorize the new command through its own proposed state.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"]},{"id":"section-2","title":"Choose learning and progress responsibilities","body":"LearningJourney provides onboarding, drills, coaching and adaptive journey composition. Existing progress adapters preserve the Date-bearing journey state when crossing into the storage-neutral GamificationRuntime. Gamification evaluates explicit activities, cadence slots, streaks, capped XP and replay using supplied timestamps and participant references. Keep these semantics visible when migrating a learning product: converting storage shapes should not silently change timezone, rounding, recurrence or the meaning of a completed lesson.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"]},{"id":"section-3","title":"Preserve privacy and source meaning","body":"Personal domain packages include household, productivity, finance and health responsibilities. Their source scopes should guide what a composed product may expose. The health runtime, for example, requires explicit consent and preserves units, timestamps, source provenance and paginated sync checkpoints; conflicting provider observations remain separate evidence. Such behavior is a data-lifecycle contract, not a clinical interpretation. Product and agent projections should reveal only what the exact subject and current grant permit, including after revocation or a changed connection.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"]}],"taskGuide":[{"title":"Trace one personal journey","body":"Follow a plan, household or consent action from trusted subject input through command construction, transaction and projection. Identify which records support retry and which data is visible to another actor.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"]},{"title":"Inspect progress conversion","body":"Choose an existing learning journey and follow its progress through serialization and the gamification adapter. Compare recurrence boundaries and repeated activities in the maintained tests before changing the stored representation.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"]},{"title":"Review a withdrawn grant","body":"Inspect the rights and consent path when a participant revokes access or a source connection changes. Check that derived projections, assistant context and queued work use the new authority state rather than a previously cached permission.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.personal-os-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/package.json"},{"label":"@lssm-tech/module.learning-journey package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/package.json"},{"label":"@lssm-tech/lib.gamification-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/package.json"},{"label":"@lssm-tech/lib.personal-health-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/package.json"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-agency/runtime/README.md"},{"label":"module source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/learning/module/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/gamification/runtime/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/personal-health/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/domains/personal-agency/runtime/README.md","packages/domains/learning/module/README.md","packages/domains/gamification/runtime/README.md","packages/domains/personal-health/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/domains/personal-agency/runtime/package.json","packages/domains/learning/module/package.json","packages/domains/gamification/runtime/package.json","packages/domains/personal-health/runtime/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":358,"packageCount":29},{"slug":"integrations-and-providers","title":"Integrations and provider selection","shortDescription":"Choose concrete external capabilities through provider-neutral contracts, explicit connections and observable runtime bindings.","questions":["Where is the portable interface for a provider capability?","How do connection credentials differ from runtime mode?","What makes a provider supported for a particular operation?"],"tasks":["Find a capability-level provider contract","Choose the matching concrete integration","Inspect connection, readiness and receipt behavior"],"packageNames":["@lssm-tech/app.alpic-mcp","@lssm-tech/app.notion-mcp","@lssm-tech/app.provider-ranking-mcp","@lssm-tech/app.teams-mcp","@lssm-tech/bundle.alpic","@lssm-tech/integration.app-store-connect","@lssm-tech/integration.builder-telegram","@lssm-tech/integration.builder-voice","@lssm-tech/integration.builder-whatsapp","@lssm-tech/integration.example-generator","@lssm-tech/integration.fake-outbox-adapter","@lssm-tech/integration.google-play-developer","@lssm-tech/integration.integration-topology-evidence-postgres","@lssm-tech/integration.provider-analytics","@lssm-tech/integration.provider-attio","@lssm-tech/integration.provider-calendar","@lssm-tech/integration.provider-claude-code","@lssm-tech/integration.provider-clay","@lssm-tech/integration.provider-codex","@lssm-tech/integration.provider-company-metrics","@lssm-tech/integration.provider-copilot","@lssm-tech/integration.provider-customer-support","@lssm-tech/integration.provider-database","@lssm-tech/integration.provider-einvoicing","@lssm-tech/integration.provider-email","@lssm-tech/integration.provider-gemini","@lssm-tech/integration.provider-github","@lssm-tech/integration.provider-google-ads","@lssm-tech/integration.provider-health","@lssm-tech/integration.provider-higgsfield","@lssm-tech/integration.provider-instagram","@lssm-tech/integration.provider-linkedin","@lssm-tech/integration.provider-llm","@lssm-tech/integration.provider-local-model","@lssm-tech/integration.provider-meeting-recorder","@lssm-tech/integration.provider-messaging","@lssm-tech/integration.provider-meta-ads","@lssm-tech/integration.provider-openbanking","@lssm-tech/integration.provider-opencode-go","@lssm-tech/integration.provider-payments","@lssm-tech/integration.provider-pioneer-ai","@lssm-tech/integration.provider-project-management","@lssm-tech/integration.provider-reclaim","@lssm-tech/integration.provider-sms","@lssm-tech/integration.provider-storage","@lssm-tech/integration.provider-stt","@lssm-tech/integration.provider-tiktok","@lssm-tech/integration.provider-voice","@lssm-tech/integration.provider-web-access","@lssm-tech/integration.provider-x","@lssm-tech/integration.provider-youtube","@lssm-tech/integration.providers-impls","@lssm-tech/lib.ai-providers","@lssm-tech/lib.contracts-integrations","@lssm-tech/lib.provider-ranking","@lssm-tech/lib.provider-runtime","@lssm-tech/lib.provider-spec","@lssm-tech/module.alpic","@lssm-tech/module.integration-hub","@lssm-tech/module.provider-ranking"],"entryPoints":[{"packageName":"@lssm-tech/lib.contracts-integrations","reason":"Start with integration specs, connections, secrets, provider interfaces and runtime/health contracts.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.provider-spec","reason":"Inspect routing, runtime-target, observation, execution-receipt and comparison contracts.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","exportPaths":[".","./types","./validation"]},{"packageName":"@lssm-tech/lib.provider-runtime","reason":"Use runtime-target, routing and receipt normalization shared by provider hosts.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/module.integration-hub","reason":"Inspect reusable integration-management composition for a selected product.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/integration-hub/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/integration-hub/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"The consumer needs a declared capability and operation boundary."},{"areaSlug":"identity-and-access","reason":"A connection is usable only in its current trusted scope."}],"relationships":[{"areaSlug":"agents-and-context","reason":"Agent model/tool routes consume explicit provider capabilities."},{"areaSlug":"delivery-and-infrastructure","reason":"Execution targets and infrastructure providers have their own operational ports."},{"areaSlug":"communication-and-notifications","reason":"Communication channels add domain-specific delivery and authority rules."}],"sections":[{"id":"section-1","title":"Begin with a capability, not a vendor name","body":"ContractsIntegrations defines provider-agnostic specifications, connections, authentication/transport, secret resolution, health and capability interfaces such as LLM, embeddings, email, vector stores and storage. The provider integration packages implement concrete boundaries. Start from the operation your product needs, find its capability contract, then inspect the adapter that claims that exact surface. A provider package name or a registered catalog record does not establish that every provider product feature is supported or enabled for an account.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"]},{"id":"section-2","title":"Keep execution mode separate from credentials","body":"ProviderSpec describes runtime targets, routing policies, leases, receipts, observations and comparison evidence. ProviderRuntime normalizes those records for host use. The README distinguishes managed/local/hybrid runtime targets from credential ownership modes such as BYOK, ephemeral or none. Preserve that distinction in configuration and UI so a credential selection does not silently choose an execution location. Redact credential-like resolver fields before logging while retaining non-secret mode and capability information needed for diagnosis.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"]},{"id":"section-3","title":"Inspect the whole connection lifecycle","body":"A useful integration guide should follow connection creation, required scopes/capabilities, secret references, readiness, one operation and its returned receipt. Reconnection, revoked access, rate limits, stale health and ambiguous effects belong to the same story. Provider observations can inform routing and budget decisions, but source metadata still needs the host’s current evidence. For capabilities such as meeting capture or external publication, domain consent and current authorization remain prerequisites even when the provider SDK is available.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"]}],"taskGuide":[{"title":"Select the exact interface","body":"Read the consumer’s provider contract and list the methods or capability references it needs. Open the matching integration package export map and README rather than importing a broad implementation bundle by default.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"]},{"title":"Bind a scoped connection","body":"Identify the credential owner, runtime target, secret resolver and required permissions. Follow how the product checks readiness and handles a missing capability or disconnected account before offering an action.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"]},{"title":"Inspect a provider result","body":"Trace the adapter response into the normalized receipt and domain outcome. Use the owning fixture for denial, throttling and uncertain completion, then qualify real provider behavior in the intended environment before advertising it as available.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.contracts-integrations package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/package.json"},{"label":"@lssm-tech/lib.provider-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/package.json"},{"label":"@lssm-tech/lib.provider-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/package.json"},{"label":"@lssm-tech/module.integration-hub package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/integration-hub/package.json"},{"label":"contracts-integrations source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-integrations/README.md"},{"label":"provider-spec source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-spec/README.md"},{"label":"provider-runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/delivery/contracts-integrations/README.md","packages/platform/agents/provider-spec/README.md","packages/platform/agents/provider-runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/delivery/contracts-integrations/package.json","packages/platform/agents/provider-spec/package.json","packages/platform/agents/provider-runtime/package.json","packages/platform/delivery/integration-hub/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":361,"packageCount":60},{"slug":"delivery-and-infrastructure","title":"Delivery, infrastructure and runtime operations","shortDescription":"Connect source intent, governed plans and provider execution through exact revisions, receipts and recoverable operational state.","questions":["What does LSSM OS planning own and what does a provider execute?","How are source changes admitted before mutation?","Which evidence supports deployment or recovery?"],"tasks":["Trace a desired-state plan","Inspect a Connect-bound execution","Choose a concrete state and infrastructure provider"],"packageNames":["@lssm-tech/action.validation","@lssm-tech/action.version","@lssm-tech/app.action-drift","@lssm-tech/app.action-pr","@lssm-tech/app.contractspec-ci-controller","@lssm-tech/bundle.lifecycle-managed","@lssm-tech/bundle.product-intent","@lssm-tech/integration.lssm-os-cache-redis","@lssm-tech/integration.lssm-os-ingress-mqtt","@lssm-tech/integration.lssm-os-operation-client","@lssm-tech/integration.lssm-os-provider-docker","@lssm-tech/integration.lssm-os-provider-gcp","@lssm-tech/integration.lssm-os-provider-github","@lssm-tech/integration.lssm-os-provider-neon","@lssm-tech/integration.lssm-os-provider-railway","@lssm-tech/integration.lssm-os-provider-resend","@lssm-tech/integration.lssm-os-provider-supabase","@lssm-tech/integration.lssm-os-provider-vercel","@lssm-tech/integration.lssm-os-queue-gcp","@lssm-tech/integration.lssm-os-queue-rabbitmq","@lssm-tech/integration.lssm-os-queue-sqs","@lssm-tech/integration.lssm-os-state-git","@lssm-tech/integration.lssm-os-state-postgres","@lssm-tech/integration.lssm-os-state-sqlite","@lssm-tech/integration.runtime","@lssm-tech/integration.runtime-hybrid","@lssm-tech/integration.runtime-local","@lssm-tech/integration.runtime-managed","@lssm-tech/lib.app-submission-readiness-runtime","@lssm-tech/lib.builder-runtime","@lssm-tech/lib.builder-spec","@lssm-tech/lib.evolution","@lssm-tech/lib.infra-ops-spec","@lssm-tech/lib.lifecycle","@lssm-tech/lib.lssm-os-provider-conformance","@lssm-tech/lib.lssm-os-runtime","@lssm-tech/lib.lssm-os-spec","@lssm-tech/lib.product-intent-utils","@lssm-tech/lib.progressive-delivery","@lssm-tech/module.app-submission-readiness","@lssm-tech/module.builder-workbench","@lssm-tech/module.lifecycle-advisor","@lssm-tech/module.lifecycle-core","@lssm-tech/module.lssm-os-control-plane","@lssm-tech/module.mobile-review","@lssm-tech/module.product-intent-core"],"entryPoints":[{"packageName":"@lssm-tech/lib.lssm-os-spec","reason":"Inspect canonical delivery, runtime and execution contract families.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-spec/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.lssm-os-runtime","reason":"Use deterministic planning/execution, authorization verification and injected runtime-node ports.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","exportPaths":["./planning","./execution","./ports","./runtime-node"]},{"packageName":"@lssm-tech/lib.infra-ops-spec","reason":"Start with infrastructure intent, deployment, incident and evidence contracts.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","exportPaths":[".","./types","./validation"]},{"packageName":"@lssm-tech/lib.builder-runtime","reason":"Inspect source ingestion, readiness, planning and governed patch boundaries.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"governance-and-approvals","reason":"Execution uses authority bound to the exact work and current context."},{"areaSlug":"observability-and-testing","reason":"Operational claims need source- and environment-bound evidence."}],"relationships":[{"areaSlug":"integrations-and-providers","reason":"Concrete cloud, queue, state and ingress adapters implement supplied ports."},{"areaSlug":"app-composition","reason":"The selected host connects these capabilities into an actual product."},{"areaSlug":"tooling-and-agent-delivery","reason":"CLI and delivery workflows produce reviewable source changes and artifacts."}],"sections":[{"id":"section-1","title":"Start with desired and observed state","body":"LSSMOSRuntime compiles desired and observed revisions into canonical plans and binds them to digests. It verifies current Connect authorization before idempotent execution under fenced leases. Drift, reconciliation, rollback, decommission and replay have explicit surfaces. Plan cost records distinguish exact, ranged, stale and unavailable information; uncertain cost can add an economic review requirement. Start by inspecting the inputs and resulting plan, so a reviewer can tell precisely what would change and what evidence is missing.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"]},{"id":"section-2","title":"Keep contracts, execution and providers connected","body":"InfraOpsSpec models environments, targets, services, deployments, incidents, readiness, budgets and evidence references. It supplies contracts and validation, while concrete infrastructure effects remain with provider integrations. RuntimeNode execution similarly receives dispatch authority, operation state, provider receipts, router and clock ports. An exact receipt replay and a new provider effect have different paths. Select the actual state backend and provider adapter for the host rather than inferring a deployment capability from the existence of an infrastructure operation.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"]},{"id":"section-3","title":"Admit source mutations deliberately","body":"BuilderRuntime supports ingestion, deterministic extraction/chunking, readiness, planning and replay. Its governed patch path validates repository-relative edits against approved scope; the workspace adapter must still enforce filesystem isolation, symlink and preimage checks. Trusted authority enters separately from untrusted request payloads. This creates a useful review sequence: inspect source context, proposed changes, admitted paths, quality evidence and permission, then execute through the selected host boundary. Generated plans and previews remain reviewable artifacts until that boundary runs.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"]}],"taskGuide":[{"title":"Inspect one plan and its dependencies","body":"Follow the selected source/desired revision, observed state, target, costs and evidence into the plan digest. Identify which unknowns require review and which provider capabilities the plan expects.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"]},{"title":"Trace the execution receipt","body":"Locate authority verification, lease/attempt binding, provider dispatch, receipt append/read-back and completion. Review interrupted and ambiguous cases before claiming repeatability or recovery for a particular adapter.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"]},{"title":"Qualify the intended channel","body":"Use the owning delivery plan and tests for the exact runtime/provider/state combination. Keep source support, local conformance, clean package consumption and deployed operation as distinct evidence when documenting availability or an upgrade path.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.lssm-os-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-spec/package.json"},{"label":"@lssm-tech/lib.lssm-os-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/package.json"},{"label":"@lssm-tech/lib.infra-ops-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/package.json"},{"label":"@lssm-tech/lib.builder-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/package.json"},{"label":"lssm-os-runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/governance/lssm-os-runtime/README.md"},{"label":"infra-ops-spec source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/infra-ops-spec/README.md"},{"label":"runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/runtime/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/governance/lssm-os-runtime/README.md","packages/platform/delivery/infra-ops-spec/README.md","packages/domains/builder/runtime/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/governance/lssm-os-spec/package.json","packages/platform/governance/lssm-os-runtime/package.json","packages/platform/delivery/infra-ops-spec/package.json","packages/domains/builder/runtime/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":359,"packageCount":46},{"slug":"tooling-and-agent-delivery","title":"CLI, authoring and agent tooling","shortDescription":"Navigate the command host, source analysis, documentation generators and native agent-pack delivery used to work on ContractSpec projects.","questions":["Which package owns a CLI command?","How are optional command packs discovered?","Where do docs, skills and editor integrations get their context?"],"tasks":["Find the owner of a command","Inspect static analysis and generated output","Choose a native coding-agent configuration target"],"packageNames":["@lssm-tech/agentpack.contractspec","@lssm-tech/agentpacks","@lssm-tech/app.cli-contractspec","@lssm-tech/app.cli-database","@lssm-tech/app.cli-databases","@lssm-tech/app.cursor-marketplace","@lssm-tech/app.registry-packs","@lssm-tech/app.registry-server","@lssm-tech/biome-config","@lssm-tech/bundle.workspace","@lssm-tech/integration.cli-contractspec-ai","@lssm-tech/integration.cli-contractspec-builder","@lssm-tech/integration.cli-contractspec-design","@lssm-tech/integration.cli-contractspec-examples","@lssm-tech/integration.workspace-ai","@lssm-tech/jetbrains-contractspec-bridge","@lssm-tech/lib.cli-runtime","@lssm-tech/lib.plugins","@lssm-tech/lib.source-extractors","@lssm-tech/lib.typescript-runtime","@lssm-tech/module.workspace","@lssm-tech/repo-scripts","@lssm-tech/tool.bun","@lssm-tech/tool.contracts-mcp-gen","@lssm-tech/tool.contractspec-drizzle-gen","@lssm-tech/tool.create-contractspec-plugin","@lssm-tech/tool.docs-generator","@lssm-tech/tool.i18n-dead-key-pruner","@lssm-tech/tool.tsdown","@lssm-tech/tool.typescript","@lssm-tech/tools.contractspec-codemods","@lssm-tech/tools.eslint-plugin-i18n","@lssm-tech/tools.eslint-plugin-no-implicit-sensitivefields","contractspec","spec-driven-development","vscode-contractspec"],"entryPoints":[{"packageName":"@lssm-tech/lib.cli-runtime","reason":"Use deterministic command-pack discovery, host ports and canonical workspace analysis/rendering leaves.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","exportPaths":[".","./command-pack-discovery","./host-program"]},{"packageName":"@lssm-tech/app.cli-contractspec","reason":"Inspect the actual CLI application that composes commands for users.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-contractspec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-contractspec/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/agentpacks","reason":"Explore pack loading, target-specific configuration, skills and plugin export.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/tool.docs-generator","reason":"Inspect the Markdown/registry-to-reference-index generation stage.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Authoring commands operate on declared specs and their source conventions."},{"areaSlug":"agents-and-context","reason":"Coding tools need scoped context and explicit instruction authority."}],"relationships":[{"areaSlug":"delivery-and-infrastructure","reason":"Source changes and generated artifacts enter existing quality/release workflows."},{"areaSlug":"examples-and-patterns","reason":"Command and editor flows should point to maintained examples."},{"areaSlug":"observability-and-testing","reason":"Diagnostics and checks should name the exact artifact or source they assessed."}],"sections":[{"id":"section-1","title":"Find the command’s owner","body":"CliRuntime supplies host construction and command-pack discovery. The documented discovery scope is the consumer’s direct dependencies and optionalDependencies whose package metadata declares a command pack. Include/exclude configuration selects packs, exclusion wins, and package-name ordering is deterministic. Selected packs are loaded before registration; conflicts are rejected before a pack changes the Commander program. Use this model to locate an optional AI, builder, design or examples command rather than assuming every command lives in the main CLI application.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"]},{"id":"section-2","title":"Distinguish the generation stages","body":"Workspace analysis owns source scanning, static diagnostics, semantic diff and Markdown/DocBlock rendering. The docs-generator tool is a separate stage that combines existing generated Markdown with the seeded registry to make a reference index. README-to-LLMS generation is another projection in web-landing. When documentation looks inconsistent, trace the particular producer and its inputs instead of rerunning an unrelated build. Preserve source paths and versions so diagnostics can lead an editor or agent to the real owner.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"]},{"id":"section-3","title":"Choose the coding-tool target explicitly","body":"Agentpacks merges configuration into host-specific rules, hooks, skills and other outputs for supported coding tools. Skills can include references and scripts; they should stay focused on a task and fetch version-appropriate context. The documented generate --diff path uses a non-writing overlay and reports drift. Successful writing generation has an additional RTK refresh behavior, so select the intended mode deliberately. Editor bridges and native plugin exports remain separate delivery surfaces whose supported features and versions need inspection.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"]}],"taskGuide":[{"title":"Trace one CLI action","body":"Open the application entry and its command-pack declaration, then locate the owning implementation. Check whether the action reads, writes generated artifacts or requests a governed mutation before putting it into an automated workflow.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"]},{"title":"Follow a generated document","body":"Identify the authored spec/DocBlock or README, the producer, its output path and the loader that consumes it. Record which stage is stale and which dependencies should invalidate it.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"]},{"title":"Prepare a coding-agent context path","body":"Choose the installed host target and a focused skill. Link its required package/version references and example sources; keep retrieved evidence separate from trusted instructions and inspect the generated diff before applying configuration changes.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"]}],"referenceLinks":[{"label":"@lssm-tech/lib.cli-runtime package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/package.json"},{"label":"@lssm-tech/app.cli-contractspec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-contractspec/package.json"},{"label":"@lssm-tech/agentpacks package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/package.json"},{"label":"@lssm-tech/tool.docs-generator package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/package.json"},{"label":"cli-runtime source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/cli-runtime/README.md"},{"label":"agentpacks source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/agentpacks/README.md"},{"label":"generate.ts","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/tools/docs-generator/src/generate.ts"},{"label":"generate-llms-full.mjs","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/scripts/generate-llms-full.mjs"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/delivery/cli-runtime/README.md","packages/tools/agentpacks/README.md"],"sourcePaths":["packages/tools/docs-generator/src/generate.ts","packages/apps/web-landing/scripts/generate-llms-full.mjs"],"packageMetadataPaths":["packages/platform/delivery/cli-runtime/package.json","packages/apps/cli-contractspec/package.json","packages/tools/agentpacks/package.json","packages/tools/docs-generator/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":373,"packageCount":36},{"slug":"observability-and-testing","title":"Observability, testing and qualification","shortDescription":"Follow behavior across boundaries and distinguish declared support from evidence that a selected composition works.","questions":["Where do signal declarations differ from telemetry emission?","How does trace context cross asynchronous boundaries?","Which test proves the behavior I am claiming?"],"tasks":["Instrument one request path","Inspect privacy-safe evidence","Choose a meaningful qualification boundary"],"packageNames":["@lssm-tech/lib.agent-evals","@lssm-tech/lib.agent-runtime-conformance","@lssm-tech/lib.logger","@lssm-tech/lib.observability","@lssm-tech/lib.observability-spec","@lssm-tech/lib.testing","@lssm-tech/lib.testing-helpers","@lssm-tech/tool.test-redaction-rules"],"entryPoints":[{"packageName":"@lssm-tech/lib.observability","reason":"Use vendor-neutral instrumentation, signals and evidence-facing surfaces.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","exportPaths":[".","./logging","./metrics"]},{"packageName":"@lssm-tech/lib.observability-spec","reason":"Inspect declarative observability contracts before binding a backend.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.testing","reason":"Locate contract-aware testing utilities, generators, recorders and adapters.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/lib.agent-evals","reason":"Inspect the agent evaluation package for the selected agent task and environment.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-evals/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-evals/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Expected input, result and error behavior defines the test boundary."},{"areaSlug":"runtime-adapters","reason":"Instrumentation and assertions must follow the actual handler/transport path."}],"relationships":[{"areaSlug":"agents-and-context","reason":"Agent evaluations need a bound model, context and tool environment."},{"areaSlug":"delivery-and-infrastructure","reason":"Source-bound quality evidence participates in release decisions."},{"areaSlug":"governance-and-approvals","reason":"Evidence records support a decision but do not issue authority themselves."}],"sections":[{"id":"section-1","title":"Choose the boundary to observe","body":"The observability package provides OpenTelemetry-oriented primitives with vendor-neutral signal and error-reporting ports. Its canonical signal/evidence declarations validate supplied observations; emission, persistence and backend selection belong to the instrumentation facade and host. Start with one operation and the question you need to answer: latency, failure cause, denied authority, queue delay or provider outcome. Emit identifiers and safe evidence references that let an operator correlate those events without copying the full business payload.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"]},{"id":"section-2","title":"Preserve context and privacy","body":"The source documents W3C trace carrier helpers across HTTP, queues, jobs, webhooks and MCP. It also describes default privacy filtering and bounded dispatch that isolates exporter outages from business work. Inspect the exact carrier boundary and its validation rather than manually concatenating trace headers. Keep operational trace state distinct from durable domain evidence: a missing telemetry event should not be interpreted as proof that a business effect did or did not happen.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"]},{"id":"section-3","title":"Match the test to the claim","body":"Testing utilities include contract-aware runners, recording and generation surfaces; conformance and agent-evaluation packages provide other targeted checks. Select a check that can falsify the behavior being documented. Static source inspection can show a declared operation; a handler fixture can demonstrate a local result; a transport test can qualify encoding and context; a clean package consumer can reveal distribution problems. Provider-backed and deployed evidence require their own environment and should not be inferred from those earlier checks.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"]}],"taskGuide":[{"title":"Trace a successful and denied request","body":"Follow correlation from the caller through the adapter, handler and any queued/provider work. Compare a valid request with a policy or validation denial and inspect which safe identifiers remain available for diagnosis.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"]},{"title":"Choose one concrete regression","body":"Use the owning package’s existing fixture or test surface for the failure you are addressing: replay, wrong scope, schema mismatch, provider timeout or translation/context drift. Avoid a check that merely restates the implementation.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"]},{"title":"Record what the result establishes","body":"Attach the source revision, package/environment context, command or test identity and observed outcome. Keep unexecuted source examples and source-present APIs labeled accordingly, so a later release or product page can make a defensible availability claim.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/lib.observability package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/package.json"},{"label":"@lssm-tech/lib.observability-spec package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/package.json"},{"label":"@lssm-tech/lib.testing package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/package.json"},{"label":"@lssm-tech/lib.agent-evals package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-evals/package.json"},{"label":"observability source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability/README.md"},{"label":"testing source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/testing/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/platform/delivery/observability/README.md","packages/platform/delivery/testing/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/platform/delivery/observability/package.json","packages/platform/delivery/observability-spec/package.json","packages/platform/delivery/testing/package.json","packages/platform/agents/agent-evals/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":369,"packageCount":8},{"slug":"app-composition","title":"Application composition and product hosts","shortDescription":"Assemble reusable modules, runtimes and integrations into an actual product with owned routes, authority and operational dependencies.","questions":["What belongs in a module, bundle and app?","How does LSSM OS compose the reusable pieces?","Where is the product’s installed capability and journey coverage recorded?"],"tasks":["Trace a product route to its module owner","Inspect the host’s required ports","Read a composition-specific experience coverage report"],"packageNames":["@lssm-tech/app.api-application-monolith","@lssm-tech/app.api-founder-suite-monolith","@lssm-tech/app.api-library","@lssm-tech/app.lssm-ecosystem-web","@lssm-tech/app.managed-companyos-mcp","@lssm-tech/app.mobile-monolith","@lssm-tech/app.web-application-monolith","@lssm-tech/app.web-founder-suite-monolith","@lssm-tech/app.web-landing","@lssm-tech/app.worker-application-monolith","@lssm-tech/app.worker-data-transmission-realtime","@lssm-tech/bundle.founder-suite","@lssm-tech/bundle.library","@lssm-tech/bundle.managed-companyos","@lssm-tech/bundle.marketing"],"entryPoints":[{"packageName":"@lssm-tech/bundle.managed-companyos","reason":"Inspect shared product composition, feature hubs, shell and experience-coverage surfaces.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md","exportPaths":[".","./feature-hubs","./experience-coverage"]},{"packageName":"@lssm-tech/bundle.founder-suite","reason":"Inspect the selected founder-suite bundle and the product/domain components it composes.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/founder-suite/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/founder-suite/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/app.web-application-monolith","reason":"Locate web routes and host-bound UI/server composition for the integrated application.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-application-monolith/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-application-monolith/README.md","exportPaths":[]},{"packageName":"@lssm-tech/app.api-application-monolith","reason":"Locate the API host that binds operations to application authority and concrete services.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/api-application-monolith/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/api-application-monolith/README.md","exportPaths":[]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Composition connects exact capabilities, operations and references."},{"areaSlug":"runtime-adapters","reason":"Each host must select and configure an execution/delivery boundary."}],"relationships":[{"areaSlug":"ui-and-presentations","reason":"Design packs, feature hubs and role-aware views become product UI here."},{"areaSlug":"delivery-and-infrastructure","reason":"Providers, workers, secrets and durable state are operational host responsibilities."},{"areaSlug":"company-and-work","reason":"CompanyOS is one composed domain within the broader integrated product."}],"sections":[{"id":"section-1","title":"Choose a canonical owner for each layer","body":"Reusable modules own their domain feature behavior and surfaces. Bundles compose approved modules and libraries for a product. Apps bind that composition to routes, authenticated requests, providers and deployment. The managed CompanyOS bundle illustrates this split: it consumes module-owned Integration, Auth, Agent, Workflow, CommunicationOS and CompanyOS hubs while keeping product route aliases. Keep modules canonical when adding another product so a new app does not require copying their implementation or making a lower layer import an app.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"]},{"id":"section-2","title":"Supply the product’s real dependencies","body":"The managed bundle keeps provider SDKs, raw credentials, databases, schedulers and topology with the host. Its public composition surfaces use redacted references and explicit ownership modes. A product’s usable capability therefore depends on the selected modules, installed handlers, ports, authority and configuration together. Document those requirements per workflow and deployment. LSSM OS names the integrated product relationship; CompanyOS remains a specific domain and composition name where the source uses it.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"]},{"id":"section-3","title":"Measure the selected product experience","body":"The bundle’s experience-coverage surface provides a governed journey manifest and product-health projection. Its README describes explicit productIds filtering that recomputes the denominator for the selected product set and rejects empty/unknown scopes. Status comes from evidence gates; a route or fixture rendering alone does not count as implementation. Use this existing product-oriented evidence alongside package reference docs. An administrator needs to know which journey is available in their composition and what blocks it, not merely how many source packages exist.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"]}],"taskGuide":[{"title":"Trace one visitor or operator journey","body":"Start at a real route and follow its bundle, canonical module, operation/handler and concrete ports. Identify where the host constructs trusted subject/workspace scope and which feature flags apply.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"]},{"title":"Inspect composition availability","body":"Read the installed capability/handler and experience-coverage information for the selected product. Distinguish preview data, an inactive background loop, a pending provider connection and a ready live workflow.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"]},{"title":"Reuse a module in another host","body":"Choose the public module or bundle entry, supply its documented dependencies and keep product-specific routing and copy in the host. Qualify that new composition independently and link users to its deployment-specific setup and recovery guidance.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/bundle.managed-companyos package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/package.json"},{"label":"@lssm-tech/bundle.founder-suite package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/founder-suite/package.json"},{"label":"@lssm-tech/app.web-application-monolith package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-application-monolith/package.json"},{"label":"@lssm-tech/app.api-application-monolith package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/api-application-monolith/package.json"},{"label":"managed-companyos source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/bundles/managed-companyos/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["packages/bundles/managed-companyos/README.md"],"sourcePaths":[],"packageMetadataPaths":["packages/bundles/managed-companyos/package.json","packages/bundles/founder-suite/package.json","packages/apps/web-application-monolith/package.json","packages/apps/api-application-monolith/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":378,"packageCount":15},{"slug":"examples-and-patterns","title":"Examples and implementation patterns","shortDescription":"Learn from maintained source and fixtures, then adapt the smallest pattern that demonstrates the behavior you need.","questions":["Which example teaches my task?","Is this a source walkthrough, fixture or rich preview?","What must change when moving the example into my product?"],"tasks":["Follow a minimal operation end to end","Inspect a table or governed-agent pattern","Reproduce and adapt an example in the intended environment"],"packageNames":["@lssm-tech/example.agent-application-foundation","@lssm-tech/example.agent-console","@lssm-tech/example.agent-workflow-command-center","@lssm-tech/example.ai-chat-assistant","@lssm-tech/example.ai-support-bot","@lssm-tech/example.analytics-dashboard","@lssm-tech/example.app-submission-readiness-mobile-proof","@lssm-tech/example.authos-command-center","@lssm-tech/example.authos-user-relation-graph","@lssm-tech/example.billingos-france-sme","@lssm-tech/example.calendar-google","@lssm-tech/example.communication-os","@lssm-tech/example.companyos-ai-os-proofs","@lssm-tech/example.companyos-ai-solutions-engineer-poc","@lssm-tech/example.companyos-communicationos-operating-cockpit","@lssm-tech/example.companyos-gtm-learning-loop-conformance","@lssm-tech/example.companyos-knowledge-graph","@lssm-tech/example.companyos-product-engineering-loop","@lssm-tech/example.companyos-voiceops-workbench","@lssm-tech/example.content-generation","@lssm-tech/example.contract-graph","@lssm-tech/example.creator-platform-ai-native","@lssm-tech/example.creator-platform-foundation","@lssm-tech/example.crm-pipeline","@lssm-tech/example.data-fetching-ecosystem","@lssm-tech/example.data-grid-showcase","@lssm-tech/example.draft-and-send-agent","@lssm-tech/example.email-gmail","@lssm-tech/example.feature-hub-composition","@lssm-tech/example.finance-ops-ai-workflows","@lssm-tech/example.form-showcase","@lssm-tech/example.gamification-campaign","@lssm-tech/example.graph-showcase","@lssm-tech/example.gtm-provider-recipes","@lssm-tech/example.harness-lab","@lssm-tech/example.in-app-docs","@lssm-tech/example.integration-hub","@lssm-tech/example.integration-paypal","@lssm-tech/example.integration-posthog","@lssm-tech/example.integration-stripe","@lssm-tech/example.integration-supabase","@lssm-tech/example.kb-update-pipeline","@lssm-tech/example.knowledge-canon","@lssm-tech/example.learning-journey-ambient-coach","@lssm-tech/example.learning-journey-crm-onboarding","@lssm-tech/example.learning-journey-duo-drills","@lssm-tech/example.learning-journey-managed-onboarding","@lssm-tech/example.learning-journey-platform-tour","@lssm-tech/example.learning-journey-quest-challenges","@lssm-tech/example.learning-journey-registry","@lssm-tech/example.learning-journey-studio-onboarding","@lssm-tech/example.learning-journey-ui-coaching","@lssm-tech/example.learning-journey-ui-gamified","@lssm-tech/example.learning-journey-ui-onboarding","@lssm-tech/example.learning-journey-ui-shared","@lssm-tech/example.learning-patterns","@lssm-tech/example.lifecycle-cli","@lssm-tech/example.lifecycle-dashboard","@lssm-tech/example.locale-jurisdiction-gate","@lssm-tech/example.managed-companyos-contract-editions","@lssm-tech/example.marketplace","@lssm-tech/example.meeting-recorder-providers","@lssm-tech/example.messaging-agent-actions","@lssm-tech/example.messaging-app","@lssm-tech/example.minimal","@lssm-tech/example.openbanking-powens","@lssm-tech/example.opencode-cli","@lssm-tech/example.organization-planning-agenda","@lssm-tech/example.osint-proof","@lssm-tech/example.personalization","@lssm-tech/example.pipeline-reality-router-reference","@lssm-tech/example.pocket-family-office","@lssm-tech/example.policy-safe-knowledge-assistant","@lssm-tech/example.product-intent","@lssm-tech/example.project-management-sync","@lssm-tech/example.saas-boilerplate","@lssm-tech/example.service-business-os","@lssm-tech/example.shim-delete-ci","@lssm-tech/example.special-ops-cockpit","@lssm-tech/example.team-hub","@lssm-tech/example.versioned-knowledge-base","@lssm-tech/example.video-api-showcase","@lssm-tech/example.video-docs-terminal","@lssm-tech/example.video-marketing-clip","@lssm-tech/example.visualization-showcase","@lssm-tech/example.voice-providers","@lssm-tech/example.voiceops-operating-graph","@lssm-tech/example.wealth-snapshot","@lssm-tech/example.workflow-system","@lssm-tech/lib.example-shared-ui","@lssm-tech/module.examples"],"entryPoints":[{"packageName":"@lssm-tech/module.examples","reason":"Use catalog-only discovery, then load runtime/host ports when a rich preview is needed.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","exportPaths":["./catalog","./runtime"]},{"packageName":"@lssm-tech/example.minimal","reason":"Start with the maintained user-contract source and its small feature/handler structure.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md","exportPaths":[".","./contracts/user","./example"]},{"packageName":"@lssm-tech/example.data-grid-showcase","reason":"Inspect the maintained table showcase and its declared source surfaces.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/data-grid-showcase/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/data-grid-showcase/README.md","exportPaths":["."]},{"packageName":"@lssm-tech/example.policy-safe-knowledge-assistant","reason":"Explore the source pattern for knowledge retrieval combined with policy boundaries.","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/policy-safe-knowledge-assistant/package.json","readmeUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/policy-safe-knowledge-assistant/README.md","exportPaths":["."]}],"foundationalPrerequisites":[{"areaSlug":"core-contracts","reason":"Recognize the contract, handler and adapter responsibilities in an example."},{"areaSlug":"runtime-adapters","reason":"Know which host and execution path the example actually uses."}],"relationships":[{"areaSlug":"ui-and-presentations","reason":"Table, RoleMorph and other UI examples illuminate rendering boundaries."},{"areaSlug":"agents-and-context","reason":"Agent examples need context, provider and tool evidence of their own."},{"areaSlug":"observability-and-testing","reason":"A source example becomes qualified only through checks appropriate to its claims."}],"sections":[{"id":"section-1","title":"Choose by the behavior you need","body":"Begin with a concrete job: define a first operation, inspect an approval boundary, render a data grid, retrieve knowledge safely or compose a feature. The minimal package exposes a user contract, feature, example entry and handler-oriented source. DataGridShowcase is the registry’s canonical table showcase. Other examples cover agent, integration, workflow and domain scenarios. Read the declared surfaces and prerequisites before choosing; a broad registry helps discovery, while a focused walkthrough should explain the important decisions and failure cases.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"]},{"id":"section-2","title":"Use the catalog without loading every runtime","body":"The examples module provides metadata-only catalog discovery and a separate runtime surface for rich template previews. Apps render specific examples through named host ports rather than directly importing example packages across the layer boundary. Rich UI is loaded only where the package exposes the appropriate surface. This separation makes a catalog card, source link, runtime fixture and interactive preview distinct deliverables. The 91 example-directory workspaces in the package inventory also include registry/shared/test support, so they are not 91 independently qualified product demos.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"]},{"id":"section-3","title":"Adapt an evidence-bearing pattern","body":"For each selected example, identify the exact contract, handler, adapter, data source and host behavior. List what remains supplied by the surrounding product: identity, persistence, provider credentials, authority, UI shell or background execution. Preserve useful negative cases such as invalid input, denied scope or missing provider. Source presence establishes an inspectable pattern; it does not establish public package installation, an executed fixture, a successful provider call or production readiness. Keep those evidence states visible when publishing an example page.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"]}],"taskGuide":[{"title":"Read the smallest complete slice","body":"Open the example’s declared entry and feature, follow one operation into its handler, and identify the selected transport or UI. Compare its manifest to the actual available files before copying a capability claim.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"]},{"title":"Reproduce within the declared scope","body":"Use the example package’s actual scripts and prerequisites from its package reference. Record the source/package versions and which checks ran. Keep external-provider and deployment qualification separate from local deterministic behavior.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"]},{"title":"Adapt one boundary at a time","body":"Replace the fixture’s store, authority, provider or host with your intended implementation while retaining the contract behavior and relevant negative cases. Link the resulting product guide to the source pattern and state the additional dependencies you introduced.","sourceUrls":["https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md","https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"]}],"referenceLinks":[{"label":"@lssm-tech/module.examples package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/package.json"},{"label":"@lssm-tech/example.minimal package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/package.json"},{"label":"@lssm-tech/example.data-grid-showcase package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/data-grid-showcase/package.json"},{"label":"@lssm-tech/example.policy-safe-knowledge-assistant package reference","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/policy-safe-knowledge-assistant/package.json"},{"label":"registry source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md"},{"label":"minimal source guide","url":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md"}],"inspection":{"sourceRef":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","basis":"Pinned package export/catalog metadata, selected source README passages, and the additional implementation files listed here.","readmePaths":["examples/registry/README.md","examples/minimal/README.md"],"sourcePaths":[],"packageMetadataPaths":["examples/registry/package.json","examples/minimal/package.json","examples/data-grid-showcase/package.json","examples/policy-safe-knowledge-assistant/package.json"],"limits":"Source documentation and declared surfaces were inspected. Installation, package builds, runtime fixtures, provider calls, and deployed-product availability were not qualified by this area guide."},"guideWordCount":401,"packageCount":91}]}