# @lssm-tech/lib.contractspec-catalog

Versioned, machine-readable ContractSpec package and capability catalog.

## Source and release context

- Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498`
- Repository: `lssm-tech/contractspec`
- Declared package version: `2.0.5`
- Package path: `packages/platform/delivery/contractspec-catalog`
- Manifest path: `packages/platform/delivery/contractspec-catalog/package.json`
- Manifest Git blob: `8c832876658c4c37759d359108ab98544d4b7032`
- Manifest origin: pinned GitHub manifest fetch
- Manual: [@lssm-tech/lib.contractspec-catalog](https://lssm.co/docs/packages/lib.contractspec-catalog/)
- 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/platform/delivery/contractspec-catalog)
- [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/package.json)
- [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/README.md)
- [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.contractspec-catalog.txt)

## Package metadata

```json
{
  "layer": "platform",
  "physicalArea": "delivery",
  "primaryArea": "core-contracts",
  "classification": {
    "privateDeclared": null,
    "catalogFamily": "contracts",
    "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: [Core contracts and features](https://lssm.co/docs/areas/core-contracts/)

## Package guide

```json
{
  "status": "available",
  "sourcePath": "packages/platform/delivery/contractspec-catalog/README.md",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/README.md",
  "blobSha": "e8bca5d3e500736649b2ccce3e8a20004667ccad",
  "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.contractspec-catalog`

Machine-readable package and capability metadata for ContractSpec consumers,
including repositories that cannot inspect the ContractSpec source repository.
The package has no dependency on the ContractSpec CLI or workspace bundle.

## Current coverage

The bundled `catalog.json` covers the exact repository publishable-package
inventory used by the release pipeline. It remains explicit about registry
reconciliation: prepared artifacts keep `contractSpecCatalogStatus.registryReconciled`
false; the signed release receipt records subsequent registry inventory parity.
Publishable packages use restricted `@lssm-tech/*` GitHub Packages and
public `@lssm/*` npmjs projections. Public catalog JSON and compiled copies are
regenerated together with valid content hashes and legacy indexes during staging.
Consumers can inspect `sourceEvidence`, registry
integrity, and this status instead of guessing completeness or treating
workspace source as public availability.

## Library usage

```ts
import {
  contractSpecCatalog,
  getContractSpecCatalog,
} from "@lssm-tech/lib.contractspec-catalog";

console.log(contractSpecCatalog.contentHash);
const mutableCopy = getContractSpecCatalog();
```


The raw document is also exported as
`@lssm-tech/lib.contractspec-catalog/catalog.json`.

## Export command

Print the bundled document to standard output:

```sh
bunx --package @lssm-tech/lib.contractspec-catalog contractspec-catalog export
```


Write it to the conventional consumer path:

```sh
bunx --package @lssm-tech/lib.contractspec-catalog contractspec-catalog export \
  --output .contractspec/adoption/catalog.json
```


Use `--compact` for a single-line JSON document. Writing to a file creates its
parent directory and replaces that explicitly selected file.

The command supports Node and Bun, including executable symlinks. Importing
`@lssm-tech/lib.contractspec-catalog/bin/export` stays silent and exposes
`runCatalogExport` and `parseExportArguments` for explicit programmatic calls.

## Canonical generation

The existing workspace generator normalizes partial capability constraints with
canonical schema defaults before calculating catalog identity. Explicit fields
remain unchanged; absent constraint metadata retains the existing inferred
platform/runtime and TypeScript requirement. Generation continues to validate
references and the complete content hash. It does not claim registry availability
or grant runtime authority.

## Reviewed local build workflow

The Catalog build can use an exact reviewed fixture binding for its existing
generator and canonical builder. The binding is derived from current source,
workspace manifests, task configuration, parser provenance and complete native
supplier identities. Its only self exclusion is
`contractspec.development.qualityTasks.build`; changing other inputs invalidates
the saved binding. A private candidate's binding is never a live-source receipt.

Windows x64 and Linux x64 supplier profiles are selected by the actual process
platform and architecture. Their immutable source review precedes independent
full native supplier and executable resolution checks. Caller options,
environment paths and a successful inspection do not grant review authority.
Unsupported profiles reject. The Catalog task passes only the already owned
`TMPDIR` resource through Turbo's strict environment; its existing
`SOURCE_DATE_EPOCH` hash input stays unchanged.

Execution requires the existing explicit runtime authorization and an idle
serial lane. Writes remain bounded to the Catalog's generated artifacts,
manifest, transaction/parser temporary namespace and retained task-local RTK
diagnostics. Foreign files, aliases, unexpected transient state and supplier
changes reject. This contributor workflow does not claim registry publication,
runtime/provider authority or final campaign acceptance. Current live producer,
packed consumers, release and resulting-tree checks remain separate gates.

Executable installation locations are task identity, separate from the fixed
source-reviewed native tuple, tool hashes and complete supplier payload. Resolve
the sole current explicit PATH candidate and require regular literal executable
paths with reviewed bytes. A same-byte relocation requires a fresh task binding;
the old binding stays invalid. Multiple candidates, selected aliases, broken
PATH ancestor aliases, changed bytes and foreign tuples reject. Unused existing
PATH directory aliases grant no executable authority and remain compatible.
Windows case-only executable candidates resolve through the native filesystem
API to their canonical saved paths; POSIX case stays exact. Never use an inspected
hash or caller-selected receipt as source authority.


## Declared capabilities

### Lib Contractspec Catalog

Capability ID: `package.lssm.tech.lib.contractspec.catalog`

Versioned, machine-readable ContractSpec package and capability catalog.

Use cases:

- Adopt versioned, machine-readable contractspec package and capability catalog

Constraints:

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

Other capability declarations:

```json
{
  "status": "active",
  "aliases": [
    "contractspec",
    "catalog",
    "capabilities",
    "adoption",
    "agents",
    "lib"
  ],
  "pythonEquivalents": [],
  "alternatives": [],
  "relationships": [],
  "resolutionPriority": 50
}
```

Capability imports:

```json
[
  {
    "from": "@lssm-tech/lib.contractspec-catalog",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contractspec-catalog/catalog.json",
    "symbols": []
  }
]
```

## Catalogue metadata

```json
{
  "family": "contracts",
  "kind": "library",
  "status": "active",
  "adoptionMode": "adoptable",
  "stability": "experimental",
  "platforms": [
    "server"
  ],
  "runtimes": [
    "node"
  ],
  "entrypoints": [
    ".",
    "./catalog.json"
  ],
  "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.contractspec.catalog",
    "from": "@lssm-tech/lib.contractspec-catalog",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contractspec.catalog",
    "from": "@lssm-tech/lib.contractspec-catalog/catalog.json",
    "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.contractspec-catalog` — subpath `.`
  - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/src/index.ts); verified source file.

- `@lssm-tech/lib.contractspec-catalog/bin/export` — subpath `./bin/export`
  - `unconditional`: `./src/bin/export.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/src/bin/export.ts); verified source file.

- `@lssm-tech/lib.contractspec-catalog/catalog.json` — subpath `./catalog.json`
  - `unconditional`: `./catalog.json` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/catalog.json); verified source file.

- `@lssm-tech/lib.contractspec-catalog/adoption-catalog` — subpath `./adoption-catalog`
  - `unconditional`: `./src/adoption-catalog/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contractspec-catalog/src/adoption-catalog/index.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",
    "catalog.json",
    "README.md"
  ],
  "publishExports": {
    ".": {
      "types": "./dist/index.d.ts",
      "bun": "./dist/index.js",
      "node": "./dist/node/index.js",
      "default": "./dist/index.js"
    },
    "./bin/export": {
      "types": "./dist/bin/export.d.ts",
      "bun": "./dist/bin/export.js",
      "node": "./dist/node/bin/export.js",
      "default": "./dist/bin/export.js"
    },
    "./catalog.json": "./catalog.json",
    "./adoption-catalog": {
      "types": "./dist/adoption-catalog/index.d.ts",
      "bun": "./dist/adoption-catalog/index.js",
      "node": "./dist/node/adoption-catalog/index.js",
      "default": "./dist/adoption-catalog/index.js"
    }
  }
}
```

## Dependencies

Metadata status: complete pinned manifest.

### Runtime dependencies

- [@lssm-tech/lib.crypto-utils](https://lssm.co/docs/packages/lib.crypto-utils/): `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
{
  "build": "bun run prebuild && contractspec-bun-build build",
  "build:bundle": "contractspec-bun-build transpile",
  "build:types": "contractspec-bun-build types",
  "lint:check": "node ../../../../scripts/biome.cjs check .",
  "prebuild": "bun ../../../../scripts/build-adoption-catalog.ts",
  "test": "bun test",
  "typecheck": "tsgo --noEmit"
}
```

## Declared documentation links

- [Lib Contractspec Catalog documentation](https://www.npmjs.com/package/%40lssm-tech%2Flib.contractspec-catalog) — declared link; destination not verified.

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

## Existing agent-guide projection

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