# @lssm-tech/lib.builder-spec

Builder control-plane contracts, capabilities, and validation for ContractSpec.

## Source and release context

- Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498`
- Repository: `lssm-tech/contractspec`
- Declared package version: `2.1.4`
- Package path: `packages/domains/builder/spec`
- Manifest path: `packages/domains/builder/spec/package.json`
- Manifest Git blob: `4c5099321da517fa1f4659c518ada7ef89dfbb53`
- Manifest origin: pinned GitHub manifest fetch
- Manual: [@lssm-tech/lib.builder-spec](https://lssm.co/docs/packages/lib.builder-spec/)
- Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/)

This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review.

Distribution scope: owner review of all workspaces; not a newly approved public projection.

- [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec)
- [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/package.json)
- [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/README.md)
- [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.builder-spec.txt)

## Package metadata

```json
{
  "layer": "domains",
  "physicalArea": "builder",
  "primaryArea": "delivery-and-infrastructure",
  "classification": {
    "privateDeclared": null,
    "catalogFamily": "ui",
    "catalogKind": "library",
    "catalogStatus": "active",
    "adoptionMode": "adoptable",
    "stability": "experimental"
  },
  "descriptionOrigin": "package.json",
  "manifestComplete": true,
  "publicationPolicyApplied": false
}
```

Manifest private flag: not declared; publication is not verified.

Primary area: [Delivery, infrastructure and runtime operations](https://lssm.co/docs/areas/delivery-and-infrastructure/)

## Package guide

```json
{
  "status": "available",
  "sourcePath": "packages/domains/builder/spec/README.md",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/README.md",
  "blobSha": "18b6b99ba09ff99cde8a98eb8e9da4881dbbdedf",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "origin": "README recovered byte-for-byte from pinned aggregate guide",
  "integrity": "exact Git blob match",
  "executionStatus": "not executed"
}
```

The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations.

# @lssm-tech/lib.builder-spec

Builder's lane keys, execution plan packs and evidence bundle references use
the pure `@lssm-tech/lib.orchestration-spec/execution-lanes` declaration owner.
These remain the canonical types forwarded by execution-lanes; Builder does
not depend on the execution runtime to describe plans or evidence.

Website: https://contractspec.io

Typed Builder control-plane contracts, capabilities, operations, events, and validation for governed omnichannel authoring.

## What It Provides

`BuilderWorkspace.authorityScope` optionally records the host-verified organization,
team and workspace at creation. Legacy records omit it. The scope is evidence for
host access checks, not an execution grant or a replacement for current authority.

- Builder workspace, conversation, source, directive, blueprint, plan, preview, readiness, and export types.
- Specs-pack import, analysis, readiness, implementation-plan, task-ledger, Connect decision, apply receipt, trace, progress, alignment, verifier decision, replay, and customer-delivery-loop types for external product-intent packs.
- RoleMorph preview, surface-inspection, policy-diff, policy-variant, missing-binding repair, Workbench packet, preference snapshot/store-port, authorization summary, replay bundle, and assurance/audit evidence types for adaptive operating surfaces.
- Full Builder command/query/event surface aligned with the Builder layer spec pack.
- Capability specs for chat, voice, ingestion, fusion, planning, preview, harness, and export workflows.
- Validation helpers for runtime and host layers, including fail-closed delivery-loop evidence checks.
- Provider-neutral platform intent, planning-port, reviewed handoff, task-ledger, and separate software/operational/production readiness contracts.

## Public Entry Points

- `.` resolves through `./src/index.ts`
- `./capabilities` resolves through `./src/capabilities/index.ts`
- `./commands` resolves through `./src/commands/index.ts`
- `./events` resolves through `./src/events/index.ts`
- `./queries` resolves through `./src/queries/index.ts`
- `./types` resolves through `./src/types/index.ts`
- `./validation` resolves through `./src/validation/index.ts`

## Notes

- This package is a compatibility surface. Additive evolution is preferred.
- Connect authority, decision and plan references (`ConnectAuthorityScopeV1`, `ConnectDecisionRefV1` and the packet/plan refs) come from the Core vocabulary at `@lssm-tech/lib.contracts-spec-core/connect-references`. The spec references Connect decisions but never depends on the Connect runtime, which re-exports the same types.
- Provider routing, runtime-mode and risk vocabulary comes from `@lssm-tech/lib.provider-spec`, a qualified pure platform spec.
- Builder orchestration reuses execution-lane identifiers and harness evidence references instead of introducing a second runtime taxonomy.
- Generated-app runtime channels are out of scope here; this package models the Builder control plane only.


## Builder v2 control-plane records

`@lssm-tech/lib.builder-spec` publicly exports the Builder v2 control-plane alignment records from both the root entry point and `./types`:

- `BuilderIntentDecisionRecord` captures IntentGate ambiguity classification, selected execution lane, escalation decision, and evidence refs before Builder execution proceeds.
- `BuilderToolCapabilityManifest` captures scoped tool availability, supported operations, runtime modes, degraded/blocker state, and evidence refs without depending on a concrete MCP/runtime implementation.
- `BuilderToolActivationReceipt` records why a scoped tool was activated, the permissions actually used, produced evidence, and optional Connect review packet refs.
- `BuilderTaskLedgerEntry` maps Builder-visible task state to leased/running/blocked/completed/stale ledger entries with heartbeat, recovery-rule, and evidence refs.

`BUILDER_V2_CONTROL_PLANE_ARTIFACT_KEYS` lists the canonical artifact keys for these records.

## Contract Intelligence types

Builder-spec now includes additive Contract Intelligence types for contractization reports, portable bundle manifests, selective import decisions, and thin portfolio envelopes. These types are dry-run/advisory surfaces and preserve graph/repo-reality/adoption/replay refs instead of defining a second graph.

## Contract Intelligence contracts

`@lssm-tech/lib.builder-spec` now includes additive Contract Intelligence types for contractization reports, portable bundle manifests, import reconciliation, selective dry-run adoption, portfolio envelopes, vertical patch notes, and recurrent radar reports. These contracts are additive and dry-run oriented.

## Builder Intelligence contracts

`@lssm-tech/lib.builder-spec` now includes additive Builder Intelligence contracts for index manifests, chunks, context packets, durable memory items, trajectories, ReasoningBank-style patterns, SONA-lite routing policies, and stale-memory reports. These contracts are dry-run first: graph refs, source hashes, provenance, `path-only` redaction, review status, and rollback metadata stay authoritative while embeddings, stores, and adaptive routing remain optional later layers.

## RoleMorph preview contracts

`@lssm-tech/lib.builder-spec` includes additive RoleMorph Builder contracts for serializable role selectors, policy variants, surface summaries, inspection packets, surface diffs, safe missing-binding repair suggestions, Workbench panel packets, preference snapshots/store ports, authorization summaries, replay bundles, and branded assurance/audit evidence requirements. These contracts describe Builder preview, inspection, replay, and evidence surfaces; rendering, durable storage, provider calls, and production authorization remain in host/runtime layers.

## Builder customer-delivery-loop contracts

`@lssm-tech/lib.builder-spec` includes additive interface-first delivery-loop contracts for quote/order/acceptance/account/source refs from BillingOS, customer commitment/work/authority/policy-gate refs from CompanyOS, scoped PRD/test-spec/specs-pack artifacts, implementation plans, task ledgers, Connect/replay refs, acceptance evidence, release capsules, and customer-handoff refs. Validators keep commercial amount-like data in BillingOS refs and block execution-approved, verified, or handed-off states until required evidence exists.

These contracts are evidence/ref aggregates only: provider execution, durable storage, repository writes, app shells, and customer sends remain in host/runtime layers.

## Builder platform integration contracts

`BuilderBlueprint` can carry additive goal, operational, workload, restriction, provider-policy,
logical-architecture, economic, observability, flag/experiment, evolution, provenance, conflict,
and locked-field intent. `BuilderPlatformPlanningPort` is deliberately read-only: it validates,
compares architectures and solo/monorepo topology, obtains cost estimate status/ranges/freshness,
previews plans, and reports unsatisfiable intent. It has no credential or apply methods.

Neutral intent becomes a `PlatformHandoffPacket` only after a Connect-bound review. Packets contain
metadata-only references and a contract-first ledger across contracts, code, infrastructure,
telemetry, cost, flags, and migrations. Apply authority remains with a Connect-authorized runtime.

The compatibility and authority-boundary record is captured in
[`docs/platform-integration-connect-evidence.md`](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/docs/platform-integration-connect-evidence.md).

`PlatformHandoffPacket.digest` is Builder's canonical payload SHA-256 hex,
excluding the derived `id` and `digest` fields. Consumers should use Builder's
canonical hashing implementation instead of another domain's digest convention.
The digest proves content identity; execution still requires Connect authority.

Managed readiness requires a registered, unblocked, export-capable managed
runtime target and an active non-offline provider. Catalog capability alone
is insufficient. Rerun readiness after upgrading to refresh persisted reports;
this availability check does not replace execution authority or live qualification.

Builder company context is available through the host-owned
`builder.companyContext.resolve` query and POST
`/api/companyos/builder/context/resolve`. It accepts an owned workspace ID and
a nonempty question up to 4096 UTF-8 bytes. Missing grounding configuration
returns 503. The web BFF preserves authentication and response status; the
client treats this as a query, never a saved mutation, and does not auto-retry.
Context grants no execution authority. Provider configuration, a visible
member control and live qualification remain required before advertising it.

## Hosted preview evidence

Blueprint-only previews remain `pending` and have no fabricated hosted URL.
`BuilderPreview` records source/artifact identity and a canonical deployment
receipt reference only after host observation qualifies the target and health.
The runtime's optional `previewHost` reads host-owned deployment state; request
payloads cannot supply evidence. Ready requires the exact workspace, blueprint
version, source revision, target and artifact set, a digest-valid successful
delivery receipt with health evidence, and a recent HTTPS URL observation on an
allowed origin. Refresh invalidates previous readiness before observation and
rejects blueprint changes during IO. Observation is bounded to twenty seconds.

This bridge does not grant deployment authority. Concrete provider provisioning,
live observation adapters and their production qualification remain required.

Snapshot and preview reads also revalidate stored canonical receipt material and
blueprint version. Legacy ready records, missing receipts, changed blueprints,
tampered digests and stale observations project as pending with no hosted URL;
this does not rewrite stored records or require a blanket data migration.

## Candidate request and status contracts

`BuilderCandidateState` and `BuilderCandidateStateSchema` describe review,
approval, queue, execution and evidence states without granting authority.
Queued/running states require a canonical operation reference; success also
requires receipt and artifact references. Existing plan operations retain their
capabilities, while the runtime requires host-verified actor scope and the exact
reviewed plan/blueprint digest before delegating to an authority-backed service.

The explicit `./control-plane/constants`, execution approval/rejection command
and trace-query leaves own the existing declarative ControlPlane operations used
by Company projections. Historical ContractSpec imports retain identical schema
and operation objects, keys, wire shapes and admin policy. Declarations grant no
approval or execution authority; trusted runtime policy enforcement is unchanged.

## Product-intent contracts

`@lssm-tech/lib.builder-spec/product-intent` and `./product-intent/<leaf>` own the
product-intent schemas (evidence, insights, findings, tickets, patch intents,
impact reports, task packs, wireframes), `ProductIntentSpec`,
`ProductIntentRegistry` and the port-driven `ProductIntentRuntime`. Legacy
`@lssm-tech/lib.contracts-spec/product-intent` imports forward to the same
instances.

The `control-plane/policies/controlPlaneMessaging.policy` entry owns the existing
version 2.0.0 messaging safety policy. Its blocked, assisted and autonomous rules
are unchanged; contracts-spec forwards the same policy object.


## Declared capabilities

### Lib Builder Spec

Capability ID: `package.lssm.tech.lib.builder.spec`

Builder control-plane contracts, capabilities, and validation for ContractSpec.

Use cases:

- Adopt builder control-plane contracts, capabilities, and validation for contractspec

Constraints:

```json
{
  "platforms": [
    "server"
  ],
  "runtimes": [
    "node"
  ],
  "avoidWhen": [
    "The @lssm-tech/lib.builder-spec package constraints do not match the target runtime or platform."
  ],
  "requires": [
    "TypeScript"
  ]
}
```

Other capability declarations:

```json
{
  "status": "active",
  "aliases": [
    "contractspec",
    "builder",
    "omnichannel",
    "contracts",
    "typescript",
    "lib",
    "spec"
  ],
  "pythonEquivalents": [],
  "alternatives": [],
  "relationships": [],
  "resolutionPriority": 50
}
```

Capability imports:

```json
[
  {
    "from": "@lssm-tech/lib.builder-spec",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/capabilities",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/commands",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/events",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/queries",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/types",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/validation",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/contract-patch-intent",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/contract-spec-patch",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/evidence",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/findings",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/impact-report",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/insights",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/opportunity-brief",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/problems",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/registry",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/runtime",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/spec",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/task-pack",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/tickets",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/types",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.builder-spec/product-intent/ui-wireframe",
    "symbols": []
  }
]
```

## Catalogue metadata

```json
{
  "family": "ui",
  "kind": "library",
  "status": "active",
  "adoptionMode": "adoptable",
  "stability": "experimental",
  "platforms": [
    "server"
  ],
  "runtimes": [
    "node"
  ],
  "entrypoints": [
    ".",
    "./capabilities",
    "./commands",
    "./events",
    "./queries",
    "./types",
    "./validation",
    "./product-intent/contract-patch-intent",
    "./product-intent/contract-spec-patch",
    "./product-intent/evidence",
    "./product-intent/findings",
    "./product-intent/impact-report",
    "./product-intent",
    "./product-intent/insights",
    "./product-intent/opportunity-brief",
    "./product-intent/problems",
    "./product-intent/registry",
    "./product-intent/runtime",
    "./product-intent/spec",
    "./product-intent/task-pack",
    "./product-intent/tickets",
    "./product-intent/types",
    "./product-intent/ui-wireframe",
    "./control-plane/policies/controlPlaneMessaging.policy"
  ],
  "examples": [],
  "replacements": []
}
```

## Canonical imports

Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference.

```json
[
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/capabilities",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/commands",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/events",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/queries",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/types",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/validation",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/contract-patch-intent",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/contract-spec-patch",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/evidence",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/findings",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/impact-report",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/insights",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/opportunity-brief",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/problems",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/registry",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/runtime",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/spec",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/task-pack",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/tickets",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/types",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.builder.spec",
    "from": "@lssm-tech/lib.builder-spec/product-intent/ui-wireframe",
    "symbols": []
  }
]
```

## Declared export entry points

Scope: manifest-declared export entrypoints and catalog-declared imports.

Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted.

Installation status: not verified.

- `@lssm-tech/lib.builder-spec` — subpath `.`
  - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/capabilities` — subpath `./capabilities`
  - `unconditional`: `./src/capabilities/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/capabilities/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/commands` — subpath `./commands`
  - `unconditional`: `./src/commands/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/commands/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/events` — subpath `./events`
  - `unconditional`: `./src/events/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/events/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/queries` — subpath `./queries`
  - `unconditional`: `./src/queries/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/queries/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/types` — subpath `./types`
  - `unconditional`: `./src/types/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/types/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/validation` — subpath `./validation`
  - `unconditional`: `./src/validation/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/validation/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/control-plane/constants` — subpath `./control-plane/constants`
  - `unconditional`: `./src/control-plane/constants.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/control-plane/constants.ts); verified source file.

- `@lssm-tech/lib.builder-spec/control-plane/commands/controlPlaneExecutionApprove.command` — subpath `./control-plane/commands/controlPlaneExecutionApprove.command`
  - `unconditional`: `./src/control-plane/commands/controlPlaneExecutionApprove.command.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/control-plane/commands/controlPlaneExecutionApprove.command.ts); verified source file.

- `@lssm-tech/lib.builder-spec/control-plane/commands/controlPlaneExecutionReject.command` — subpath `./control-plane/commands/controlPlaneExecutionReject.command`
  - `unconditional`: `./src/control-plane/commands/controlPlaneExecutionReject.command.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/control-plane/commands/controlPlaneExecutionReject.command.ts); verified source file.

- `@lssm-tech/lib.builder-spec/control-plane/queries/controlPlaneTraceGet.query` — subpath `./control-plane/queries/controlPlaneTraceGet.query`
  - `unconditional`: `./src/control-plane/queries/controlPlaneTraceGet.query.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/control-plane/queries/controlPlaneTraceGet.query.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/contract-patch-intent` — subpath `./product-intent/contract-patch-intent`
  - `unconditional`: `./src/product-intent/contract-patch-intent.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/contract-patch-intent.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/contract-spec-patch` — subpath `./product-intent/contract-spec-patch`
  - `unconditional`: `./src/product-intent/contract-spec-patch.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/contract-spec-patch.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/evidence` — subpath `./product-intent/evidence`
  - `unconditional`: `./src/product-intent/evidence.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/evidence.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/findings` — subpath `./product-intent/findings`
  - `unconditional`: `./src/product-intent/findings.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/findings.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/impact-report` — subpath `./product-intent/impact-report`
  - `unconditional`: `./src/product-intent/impact-report.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/impact-report.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent` — subpath `./product-intent`
  - `unconditional`: `./src/product-intent/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/index.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/insights` — subpath `./product-intent/insights`
  - `unconditional`: `./src/product-intent/insights.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/insights.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/opportunity-brief` — subpath `./product-intent/opportunity-brief`
  - `unconditional`: `./src/product-intent/opportunity-brief.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/opportunity-brief.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/problems` — subpath `./product-intent/problems`
  - `unconditional`: `./src/product-intent/problems.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/problems.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/registry` — subpath `./product-intent/registry`
  - `unconditional`: `./src/product-intent/registry.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/registry.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/runtime` — subpath `./product-intent/runtime`
  - `unconditional`: `./src/product-intent/runtime.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/runtime.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/spec` — subpath `./product-intent/spec`
  - `unconditional`: `./src/product-intent/spec.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/spec.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/task-pack` — subpath `./product-intent/task-pack`
  - `unconditional`: `./src/product-intent/task-pack.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/task-pack.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/tickets` — subpath `./product-intent/tickets`
  - `unconditional`: `./src/product-intent/tickets.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/tickets.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/types` — subpath `./product-intent/types`
  - `unconditional`: `./src/product-intent/types.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/types.ts); verified source file.

- `@lssm-tech/lib.builder-spec/product-intent/ui-wireframe` — subpath `./product-intent/ui-wireframe`
  - `unconditional`: `./src/product-intent/ui-wireframe.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/product-intent/ui-wireframe.ts); verified source file.

- `@lssm-tech/lib.builder-spec/control-plane/policies/controlPlaneMessaging.policy` — subpath `./control-plane/policies/controlPlaneMessaging.policy`
  - `unconditional`: `./src/control-plane/policies/controlPlaneMessaging.policy.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/domains/builder/spec/src/control-plane/policies/controlPlaneMessaging.policy.ts); verified source file.

## Package publication metadata

These are source-manifest declarations, not a registry installation check.

```json
{
  "types": "./dist/index.d.ts",
  "files": [
    "dist",
    "README.md"
  ],
  "publishExports": {
    ".": {
      "types": "./dist/index.d.ts",
      "browser": "./dist/browser/index.js",
      "bun": "./dist/index.js",
      "node": "./dist/node/index.js",
      "default": "./dist/index.js"
    },
    "./capabilities": {
      "types": "./dist/capabilities/index.d.ts",
      "browser": "./dist/browser/capabilities/index.js",
      "bun": "./dist/capabilities/index.js",
      "node": "./dist/node/capabilities/index.js",
      "default": "./dist/capabilities/index.js"
    },
    "./commands": {
      "types": "./dist/commands/index.d.ts",
      "browser": "./dist/browser/commands/index.js",
      "bun": "./dist/commands/index.js",
      "node": "./dist/node/commands/index.js",
      "default": "./dist/commands/index.js"
    },
    "./events": {
      "types": "./dist/events/index.d.ts",
      "browser": "./dist/browser/events/index.js",
      "bun": "./dist/events/index.js",
      "node": "./dist/node/events/index.js",
      "default": "./dist/events/index.js"
    },
    "./queries": {
      "types": "./dist/queries/index.d.ts",
      "browser": "./dist/browser/queries/index.js",
      "bun": "./dist/queries/index.js",
      "node": "./dist/node/queries/index.js",
      "default": "./dist/queries/index.js"
    },
    "./types": {
      "types": "./dist/types/index.d.ts",
      "browser": "./dist/browser/types/index.js",
      "bun": "./dist/types/index.js",
      "node": "./dist/node/types/index.js",
      "default": "./dist/types/index.js"
    },
    "./validation": {
      "types": "./dist/validation/index.d.ts",
      "browser": "./dist/browser/validation/index.js",
      "bun": "./dist/validation/index.js",
      "node": "./dist/node/validation/index.js",
      "default": "./dist/validation/index.js"
    },
    "./control-plane/constants": {
      "types": "./dist/control-plane/constants.d.ts",
      "browser": "./dist/browser/control-plane/constants.js",
      "bun": "./dist/control-plane/constants.js",
      "node": "./dist/node/control-plane/constants.js",
      "default": "./dist/control-plane/constants.js"
    },
    "./control-plane/commands/controlPlaneExecutionApprove.command": {
      "types": "./dist/control-plane/commands/controlPlaneExecutionApprove.command.d.ts",
      "browser": "./dist/browser/control-plane/commands/controlPlaneExecutionApprove.command.js",
      "bun": "./dist/control-plane/commands/controlPlaneExecutionApprove.command.js",
      "node": "./dist/node/control-plane/commands/controlPlaneExecutionApprove.command.js",
      "default": "./dist/control-plane/commands/controlPlaneExecutionApprove.command.js"
    },
    "./control-plane/commands/controlPlaneExecutionReject.command": {
      "types": "./dist/control-plane/commands/controlPlaneExecutionReject.command.d.ts",
      "browser": "./dist/browser/control-plane/commands/controlPlaneExecutionReject.command.js",
      "bun": "./dist/control-plane/commands/controlPlaneExecutionReject.command.js",
      "node": "./dist/node/control-plane/commands/controlPlaneExecutionReject.command.js",
      "default": "./dist/control-plane/commands/controlPlaneExecutionReject.command.js"
    },
    "./control-plane/queries/controlPlaneTraceGet.query": {
      "types": "./dist/control-plane/queries/controlPlaneTraceGet.query.d.ts",
      "browser": "./dist/browser/control-plane/queries/controlPlaneTraceGet.query.js",
      "bun": "./dist/control-plane/queries/controlPlaneTraceGet.query.js",
      "node": "./dist/node/control-plane/queries/controlPlaneTraceGet.query.js",
      "default": "./dist/control-plane/queries/controlPlaneTraceGet.query.js"
    },
    "./product-intent/contract-patch-intent": {
      "types": "./dist/product-intent/contract-patch-intent.d.ts",
      "browser": "./dist/browser/product-intent/contract-patch-intent.js",
      "bun": "./dist/product-intent/contract-patch-intent.js",
      "node": "./dist/node/product-intent/contract-patch-intent.js",
      "default": "./dist/product-intent/contract-patch-intent.js"
    },
    "./product-intent/contract-spec-patch": {
      "types": "./dist/product-intent/contract-spec-patch.d.ts",
      "browser": "./dist/browser/product-intent/contract-spec-patch.js",
      "bun": "./dist/product-intent/contract-spec-patch.js",
      "node": "./dist/node/product-intent/contract-spec-patch.js",
      "default": "./dist/product-intent/contract-spec-patch.js"
    },
    "./product-intent/evidence": {
      "types": "./dist/product-intent/evidence.d.ts",
      "browser": "./dist/browser/product-intent/evidence.js",
      "bun": "./dist/product-intent/evidence.js",
      "node": "./dist/node/product-intent/evidence.js",
      "default": "./dist/product-intent/evidence.js"
    },
    "./product-intent/findings": {
      "types": "./dist/product-intent/findings.d.ts",
      "browser": "./dist/browser/product-intent/findings.js",
      "bun": "./dist/product-intent/findings.js",
      "node": "./dist/node/product-intent/findings.js",
      "default": "./dist/product-intent/findings.js"
    },
    "./product-intent/impact-report": {
      "types": "./dist/product-intent/impact-report.d.ts",
      "browser": "./dist/browser/product-intent/impact-report.js",
      "bun": "./dist/product-intent/impact-report.js",
      "node": "./dist/node/product-intent/impact-report.js",
      "default": "./dist/product-intent/impact-report.js"
    },
    "./product-intent": {
      "types": "./dist/product-intent/index.d.ts",
      "browser": "./dist/browser/product-intent/index.js",
      "bun": "./dist/product-intent/index.js",
      "node": "./dist/node/product-intent/index.js",
      "default": "./dist/product-intent/index.js"
    },
    "./product-intent/insights": {
      "types": "./dist/product-intent/insights.d.ts",
      "browser": "./dist/browser/product-intent/insights.js",
      "bun": "./dist/product-intent/insights.js",
      "node": "./dist/node/product-intent/insights.js",
      "default": "./dist/product-intent/insights.js"
    },
    "./product-intent/opportunity-brief": {
      "types": "./dist/product-intent/opportunity-brief.d.ts",
      "browser": "./dist/browser/product-intent/opportunity-brief.js",
      "bun": "./dist/product-intent/opportunity-brief.js",
      "node": "./dist/node/product-intent/opportunity-brief.js",
      "default": "./dist/product-intent/opportunity-brief.js"
    },
    "./product-intent/problems": {
      "types": "./dist/product-intent/problems.d.ts",
      "browser": "./dist/browser/product-intent/problems.js",
      "bun": "./dist/product-intent/problems.js",
      "node": "./dist/node/product-intent/problems.js",
      "default": "./dist/product-intent/problems.js"
    },
    "./product-intent/registry": {
      "types": "./dist/product-intent/registry.d.ts",
      "browser": "./dist/browser/product-intent/registry.js",
      "bun": "./dist/product-intent/registry.js",
      "node": "./dist/node/product-intent/registry.js",
      "default": "./dist/product-intent/registry.js"
    },
    "./product-intent/runtime": {
      "types": "./dist/product-intent/runtime.d.ts",
      "browser": "./dist/browser/product-intent/runtime.js",
      "bun": "./dist/product-intent/runtime.js",
      "node": "./dist/node/product-intent/runtime.js",
      "default": "./dist/product-intent/runtime.js"
    },
    "./product-intent/spec": {
      "types": "./dist/product-intent/spec.d.ts",
      "browser": "./dist/browser/product-intent/spec.js",
      "bun": "./dist/product-intent/spec.js",
      "node": "./dist/node/product-intent/spec.js",
      "default": "./dist/product-intent/spec.js"
    },
    "./product-intent/task-pack": {
      "types": "./dist/product-intent/task-pack.d.ts",
      "browser": "./dist/browser/product-intent/task-pack.js",
      "bun": "./dist/product-intent/task-pack.js",
      "node": "./dist/node/product-intent/task-pack.js",
      "default": "./dist/product-intent/task-pack.js"
    },
    "./product-intent/tickets": {
      "types": "./dist/product-intent/tickets.d.ts",
      "browser": "./dist/browser/product-intent/tickets.js",
      "bun": "./dist/product-intent/tickets.js",
      "node": "./dist/node/product-intent/tickets.js",
      "default": "./dist/product-intent/tickets.js"
    },
    "./product-intent/types": {
      "types": "./dist/product-intent/types.d.ts",
      "browser": "./dist/browser/product-intent/types.js",
      "bun": "./dist/product-intent/types.js",
      "node": "./dist/node/product-intent/types.js",
      "default": "./dist/product-intent/types.js"
    },
    "./product-intent/ui-wireframe": {
      "types": "./dist/product-intent/ui-wireframe.d.ts",
      "browser": "./dist/browser/product-intent/ui-wireframe.js",
      "bun": "./dist/product-intent/ui-wireframe.js",
      "node": "./dist/node/product-intent/ui-wireframe.js",
      "default": "./dist/product-intent/ui-wireframe.js"
    },
    "./control-plane/policies/controlPlaneMessaging.policy": {
      "types": "./dist/control-plane/policies/controlPlaneMessaging.policy.d.ts",
      "browser": "./dist/browser/control-plane/policies/controlPlaneMessaging.policy.js",
      "bun": "./dist/control-plane/policies/controlPlaneMessaging.policy.js",
      "node": "./dist/node/control-plane/policies/controlPlaneMessaging.policy.js",
      "default": "./dist/control-plane/policies/controlPlaneMessaging.policy.js"
    }
  }
}
```

## Dependencies

Metadata status: complete pinned manifest.

### Runtime dependencies

- [@lssm-tech/lib.contracts-runtime-kernel](https://lssm.co/docs/packages/lib.contracts-runtime-kernel/): `workspace:^`
- [@lssm-tech/lib.contracts-spec-core](https://lssm.co/docs/packages/lib.contracts-spec-core/): `workspace:^`
- [@lssm-tech/lib.lssm-os-spec](https://lssm.co/docs/packages/lib.lssm-os-spec/): `workspace:^`
- [@lssm-tech/lib.orchestration-spec](https://lssm.co/docs/packages/lib.orchestration-spec/): `workspace:^`
- [@lssm-tech/lib.provider-spec](https://lssm.co/docs/packages/lib.provider-spec/): `workspace:^`
- [@lssm-tech/lib.schema](https://lssm.co/docs/packages/lib.schema/): `workspace:^`
- `zod`: `catalog:`

### Peer dependencies

No declarations in the inspected manifest.

### Optional dependencies

No declarations in the inspected manifest.

### Development dependencies

- [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*`
- [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*`
- `typescript`: `catalog:`

### Peer dependency metadata

```json
{}
```

### Bundled dependencies

```json
null
```

## Package scripts

Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest.

```json
{
  "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
  "publish:pkg:canary": "bun publish:pkg --tag canary",
  "build": "contractspec-bun-build build",
  "build:bundle": "contractspec-bun-build transpile",
  "build:types": "contractspec-bun-build types",
  "dev": "contractspec-bun-build dev",
  "clean": "rimraf dist .turbo",
  "lint": "bun lint:fix",
  "lint:fix": "node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .",
  "lint:check": "node ../../../../scripts/biome.cjs check .",
  "test": "bun test",
  "prebuild": "contractspec-bun-build prebuild",
  "typecheck": "tsgo --noEmit"
}
```

## Declared documentation links

- [Lib Builder Spec documentation](https://www.npmjs.com/package/%40lssm-tech%2Flib.builder-spec) — declared link; destination not verified.

```json
{
  "url": "https://www.npmjs.com/package/%40lssm-tech%2Flib.builder-spec",
  "kind": "readme"
}
```

## Existing agent-guide projection

```json
{
  "path": "packages/apps/web-landing/public/llms-packages/lib.builder-spec.txt",
  "route": "/llms/lib.builder-spec",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.builder-spec.txt",
  "blobSha": "18b6b99ba09ff99cde8a98eb8e9da4881dbbdedf",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "bodyEqualsReadme": true,
  "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt",
  "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf"
}
```