Skip to content
ContractSpec
Start here

Package manual · integrations

·Delivery, infrastructure and runtime operations

integration.lssm-os-state-git

Atomic Git-tracked desired state and immutable LSSM OS receipts.

integrationsintegrationv2.0.4experimentalservernode
@lssm-tech/integration.lssm-os-state-git
bun add @lssm-tech/integration.lssm-os-state-git
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Atomic, Git-trackable persistence for LSSM OS desired/observed state, plans, and append-only receipts. The adapter writes canonical JSON, keeps revision history immutable, rejects revision equivocation, and uses scoped filesystem locks and atomic renames for current pointers.

Lock ownership uses an atomically created directory with a unique owner token. Claims do not expire or depend on wall-clock age: a contender cannot overlap an active owner after a clock jump or stale heartbeat, and a claimant only removes its own token. Crash residue fails closed and must be pruned during explicit offline maintenance. Data files are synced before publication and containing directories are synced after link, rename, or unlink. Directory fsync is best-effort only on filesystems that explicitly report it unsupported; file-level durability and atomic publication remain enforced there.

The adapter rejects symlink roots and symlink ancestors for all state and lock paths. Deploy it on a filesystem whose state root is writable only by the Runtime Node process; filesystem permission boundaries remain part of the operator threat model.

The configured root is data, not a credential location. Consumers decide when and how the resulting files are committed or synchronized with Git.

Relationships

THIS PACKAGEintegration.lssm-os-state-git7 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

1 declarations

Declared capabilities

Integration Lssm Os State Git

Atomic Git-tracked desired state and immutable LSSM OS receipts.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • lint:checknode ../../../scripts/biome.cjs check .
  • testbun test
  • typechecktsgo --noEmit