# @lssm-tech/integration.lssm-os-provider-railway

Railway provider adapter for governed LSSM OS infrastructure execution.

## Source and release context

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

## Package metadata

```json
{
  "layer": "integrations",
  "physicalArea": null,
  "primaryArea": "delivery-and-infrastructure",
  "classification": {
    "privateDeclared": null,
    "catalogFamily": "integrations",
    "catalogKind": "integration",
    "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/integrations/lssm-os-provider-railway/README.md",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-provider-railway/README.md",
  "blobSha": "02c487ae8405ee96465492840d0792d959147ee7",
  "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.

# Railway provider for LSSM OS

This package adapts the authoritative LSSM OS `ProviderExecutionPort` to one
injected Railway execution surface. An adapter instance exclusively owns either
the Railway provider API or Railway TypeScript IaC; dual ownership fails closed.

The `./runtime-node` export directly implements `ProviderLifecyclePortV1` over
closed, secret-free, digest-bound V2 commands. It binds one injected ownership
driver (`provider_api` or `railway_iac`), reserves the exact execution fence,
persists exact V2 receipts, and replays only independently verified durable
results. It never loads the legacy `ProviderExecutionPort`, and Railway IaC
cannot claim ownership of the provider feature-flag registry.

It supports complete, paginated discovery/import of workspaces, projects,
environments, services, databases, volumes, buckets, variable references,
domains, deployments, metrics, usage, and the separate project/workspace feature
flag registries. Mutation is allowlisted by resource family and ownership mode.

Idempotency and fencing are delegated to an injected durable atomic state port.
Receipts bind the exact plan, effect, Connect decision and attestation, fence,
provider observation, and evidence. Timeouts abort the driver call and remain a
durable indeterminate outcome; retries cannot silently duplicate an unsettled
effect. The deadline scheduler and trusted UTC clock are injected for deterministic
testing while production defaults use a monotonic system scheduler.

Secrets are references only. Billing reports are explicit `actual`, `estimated`,
or `unavailable` claims, each backed by provider evidence. Compensation requires
the exact prior apply observation. Partial-create cleanup is restricted to handles
reported by the failed current step.

The `./conformance` entrypoint shapes an offline verifier target whose replay and
fence decisions use the verifier oracle's read-only observation boundary. `./testing`
exports sanitized fakes and fixtures. Neither entrypoint performs a live Railway
call or claims live-provider qualification. `bun run test:pack` stages governed
workspace dependency ranges, installs the real tarball with npm, and imports every
public subpath in clean Node and Bun consumers.

Drift compares resource and flag state independently of evidence-reference IDs.
A new observation reference alone is not a configuration change. Returned evidence
references still identify the current discovery pages; receipts and their integrity
checks remain unchanged. Resource properties, status, flag versions and rules
continue to participate in drift detection.

Packed-consumer checks do not run dependency lifecycle hooks in the source
workspace. They stage already-built artifacts, apply published export maps in
the staging directory, and install the resulting archives with scripts disabled.


## Declared capabilities

### Integration Lssm Os Provider Railway

Capability ID: `package.lssm.tech.integration.lssm.os.provider.railway`

Railway provider adapter for governed LSSM OS infrastructure execution.

Use cases:

- Adopt railway provider adapter for governed lssm os infrastructure execution

Constraints:

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

Other capability declarations:

```json
{
  "status": "active",
  "aliases": [
    "integration",
    "lssm",
    "provider",
    "railway"
  ],
  "pythonEquivalents": [],
  "alternatives": [],
  "relationships": [],
  "resolutionPriority": 50
}
```

Capability imports:

```json
[
  {
    "from": "@lssm-tech/integration.lssm-os-provider-railway",
    "symbols": []
  },
  {
    "from": "@lssm-tech/integration.lssm-os-provider-railway/conformance",
    "symbols": []
  },
  {
    "from": "@lssm-tech/integration.lssm-os-provider-railway/runtime-node",
    "symbols": []
  },
  {
    "from": "@lssm-tech/integration.lssm-os-provider-railway/testing",
    "symbols": []
  }
]
```

## Catalogue metadata

```json
{
  "family": "integrations",
  "kind": "integration",
  "status": "active",
  "adoptionMode": "adoptable",
  "stability": "experimental",
  "platforms": [
    "server"
  ],
  "runtimes": [
    "bun",
    "node"
  ],
  "entrypoints": [
    ".",
    "./conformance",
    "./runtime-node",
    "./testing"
  ],
  "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.integration.lssm.os.provider.railway",
    "from": "@lssm-tech/integration.lssm-os-provider-railway",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.integration.lssm.os.provider.railway",
    "from": "@lssm-tech/integration.lssm-os-provider-railway/conformance",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.integration.lssm.os.provider.railway",
    "from": "@lssm-tech/integration.lssm-os-provider-railway/runtime-node",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.integration.lssm.os.provider.railway",
    "from": "@lssm-tech/integration.lssm-os-provider-railway/testing",
    "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/integration.lssm-os-provider-railway` — subpath `.`
  - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-provider-railway/src/index.ts); verified source file.

- `@lssm-tech/integration.lssm-os-provider-railway/conformance` — subpath `./conformance`
  - `unconditional`: `./src/conformance.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-provider-railway/src/conformance.ts); verified source file.

- `@lssm-tech/integration.lssm-os-provider-railway/runtime-node` — subpath `./runtime-node`
  - `unconditional`: `./src/runtime-node.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-provider-railway/src/runtime-node.ts); verified source file.

- `@lssm-tech/integration.lssm-os-provider-railway/testing` — subpath `./testing`
  - `unconditional`: `./src/testing.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-provider-railway/src/testing.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",
    "!dist/**/*.test.*",
    "README.md"
  ],
  "publishExports": {
    ".": {
      "types": "./dist/index.d.ts",
      "bun": "./dist/index.js",
      "node": "./dist/node/index.js",
      "default": "./dist/index.js"
    },
    "./conformance": {
      "types": "./dist/conformance.d.ts",
      "bun": "./dist/conformance.js",
      "node": "./dist/node/conformance.js",
      "default": "./dist/conformance.js"
    },
    "./runtime-node": {
      "types": "./dist/runtime-node.d.ts",
      "bun": "./dist/runtime-node.js",
      "node": "./dist/node/runtime-node.js",
      "default": "./dist/runtime-node.js"
    },
    "./testing": {
      "types": "./dist/testing.d.ts",
      "bun": "./dist/testing.js",
      "node": "./dist/node/testing.js",
      "default": "./dist/testing.js"
    }
  }
}
```

## Dependencies

Metadata status: complete pinned manifest.

### Runtime dependencies

- [@lssm-tech/lib.lssm-os-provider-conformance](https://lssm.co/docs/packages/lib.lssm-os-provider-conformance/): `workspace:^`
- [@lssm-tech/lib.lssm-os-runtime](https://lssm.co/docs/packages/lib.lssm-os-runtime/): `workspace:^`

### Peer dependencies

No declarations in the inspected manifest.

### Optional dependencies

No declarations in the inspected manifest.

### Development dependencies

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

### Peer dependency metadata

```json
{}
```

### Bundled dependencies

```json
null
```

## Package scripts

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

```json
{
  "build": "bun run build:bundle && bun run build:types",
  "build:bundle": "bun scripts/build-public-bundles.ts",
  "build:types": "contractspec-bun-build types",
  "lint:check": "node ../../../scripts/biome.cjs check .",
  "test": "bun test",
  "test:pack": "bun scripts/test-packed-exports.ts",
  "typecheck": "tsgo --noEmit"
}
```

## Declared documentation links

- [Integration Lssm Os Provider Railway documentation](https://www.npmjs.com/package/%40lssm-tech%2Fintegration.lssm-os-provider-railway) — declared link; destination not verified.

```json
{
  "url": "https://www.npmjs.com/package/%40lssm-tech%2Fintegration.lssm-os-provider-railway",
  "kind": "readme"
}
```

## Existing agent-guide projection

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