asylumwarden 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TachikomaGundam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# AsylumWarden
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Status: architecture phase. No runtime code. The npm package `asylumwarden@0.0.0`
+is a name reservation; the first functional release will be `0.1.0`.**
+
+AsylumWarden is a local, file-first control plane for multi-seat AI work. It
+keeps the plan, leases, receipts, and ledger on disk. It does not run a daemon,
+require a database, or replace the host's sandbox.
+
+- GitHub: <https://github.com/TachikomaGundam/AsylumWarden>
+- npm: `asylumwarden` (0.0.0 name reservation; no runtime code yet)
+- License: MIT
+
+## What it is
+
+- A registry of work lines and their writable / read-only / forbidden surfaces.
+- A DAG planner with cycle and dependency checks.
+- Atomic claims with owner, epoch, TTL, and heartbeat.
+- Receipt validation: commands, artifacts, read mentions, and path containment.
+- An append-only, hash-chained ledger that is tamper-evident, not tamper-proof.
+- A thin CLI and optional opencode adapter.
+
+## What it is not
+
+- Not a sandbox. Same-uid processes can still bypass declarations.
+- Not a replacement for PCB's control plane or Abathur's gates.
+- Not a required dependency of Abathur. It is an optional companion.
+- Not a daemon, scheduler service, or task database.
+
+## Design
+
+The approved architecture is in
+[`docs/architecture-handoff.md`](docs/architecture-handoff.md). The PCB pilot
+boundary is in [`docs/PILOT-PCB.md`](docs/PILOT-PCB.md). Release rules are in
+[`docs/RELEASING.md`](docs/RELEASING.md).
+
+## Boundary with Abathur
+
+Abathur does not import AsylumWarden and does not install it. AsylumWarden may
+read Abathur data, but the dependency is one-way:
+
+```text
+AsylumWarden  ---reads/obeys--->  versioned contract
+Abathur       ---does not depend on--->  AsylumWarden
+```
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "asylumwarden",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.0",
+  "private": false,
+  "description": "Local, file-first control plane for multi-seat AI work: registry, DAG, leases, receipts, ledger.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.22.1"
+  },
+  "files": [
+    "src",
+    "schemas",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TachikomaGundam/AsylumWarden.git"
+  },
+  "homepage": "https://github.com/TachikomaGundam/AsylumWarden",
+  "bugs": {
+    "url": "https://github.com/TachikomaGundam/AsylumWarden/issues"
+  }
+}