[raii] The bstack_raii crate

.github/workflows/check.yml

@@ -3,8 +3,12 @@ name: Check
 on:
   push:
     branches: [ master ]
+    # The nested bstack_raii crate is its own workspace and not part of the
+    # bstack package; skip these checks when only it changed.
+    paths-ignore: [ bstack_raii/** ]
   pull_request:
     branches: [ master ]
+    paths-ignore: [ bstack_raii/** ]
 
 permissions:
   contents: read

.github/workflows/devskim.yml

@@ -8,10 +8,10 @@ name: DevSkim
 on:
   push:
     branches: [ "master" ]
-    paths-ignore: ['**.md', '**/Makefile', '.gitignore', '.gitattributes', '**.toml', '**.lock']
+    paths-ignore: ['**.md', '**/Makefile', '.gitignore', '.gitattributes', '**.toml', '**.lock', 'bstack_raii/**']
   pull_request:
     branches: [ "master" ]
-    paths-ignore: ['**.md', '**/Makefile', '.gitignore', '.gitattributes', '**.toml', '**.lock']
+    paths-ignore: ['**.md', '**/Makefile', '.gitignore', '.gitattributes', '**.toml', '**.lock', 'bstack_raii/**']
 
 jobs:
   lint:

bstack_raii/Cargo.toml

@@ -0,0 +1,33 @@
+[package]
+name = "bstack_raii"
+version = "0.0.0"
+edition = "2024"
+authors = ["William Wu <williamwutq@gmail.com>", "Claude <claude@anthropic.com>"]
+license = "MIT"
+description = "Typed, RAII-style ownership and lifetime layer over the bstack allocation primitives"
+repository = "https://github.com/williamwutq/bstack"
+publish = false
+
+# This crate is developed inside the `bstack` repository but is NOT part of the
+# `bstack` package or its CI. It is its own self-contained workspace so that
+# root-level `cargo` commands in the bstack repo never descend into it. See
+# RAII.md (in the repo root) for the full design this crate implements.
+[workspace]
+members = ["derive"]
+
+[features]
+# Dev/test only: forwards bstack's fault-injection so crash-recovery tests can arm
+# a fault at a chosen `BStack` op (e.g. the clone commit's `inplace_gen`). Off by
+# default; enable with `--features fault-injection`. Also requires a debug build.
+fault-injection = ["bstack/fault-injection"]
+
+[dependencies]
+# RAII requires `alloc` + `set`; `atomic` is needed for the on-disk refcount RMW
+# (control blocks, strong/weak counters).
+bstack = { version = "=0.4", features = ["alloc", "set", "atomic"] }
+bstack_raii_derive = { path = "derive", version = "0.0.0" }
+
+# Gate for POD (plain-old-data) inline fields: any `bytemuck::Pod` type is safe
+# to store inline in an on-disk block and receives the blanket no-op BStackDrop.
+bytemuck = { version = "=1.25", features = ["derive"] }
+parking_lot = "0.12.5"