integration.lssm-os-state-git
Atomic Git-tracked desired state and immutable LSSM OS receipts.
@lssm-tech/integration.lssm-os-state-gitbun add @lssm-tech/integration.lssm-os-state-gitManifest 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
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
1 declarations
@lssm-tech/lib.lssm-os-runtimeworkspace:^
Read the package manual ↗
Declared capabilities
Atomic Git-tracked desired state and immutable LSSM OS receipts.
Scripts
buildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typeslint:checknode ../../../scripts/biome.cjs check .testbun testtypechecktsgo --noEmit