@dcasegr/skein 0.0.0-stage → 0.1.1

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "@dcasegr/skein",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "A deterministic WASI machine over a content-addressed graph: the node host (it loads the wasm kernel, kernel-zig built for the web target), the client, its peers, and dev tools.",
+  "type": "module",
+  "bin": {
+    "skein": "./bin/skein.js",
+    "skein-host": "./bin/skein-host.js"
+  },
+  "scripts": {
+    "skein": "bin/skein",
+    "skein-dev": "bin/skein-dev",
+    "test": "node --experimental-strip-types --no-warnings --test 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit",
+    "web:build": "node --experimental-strip-types --no-warnings web/build.ts",
+    "web:serve": "scripts/host/web.sh",
+    "web:test": "node --experimental-strip-types --no-warnings --test 'web/*.test.ts'",
+    "web:typecheck": "tsc --noEmit -p web/tsconfig.json",
+    "build": "tsc -p tsconfig.build.json",
+    "build:kernel": "cd kernel-zig && zig build web",
+    "prepack": "npm run build && npm run build:kernel"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@1sat/templates": "^0.0.43",
+    "@1sat/utils": "^0.0.42",
+    "@1sat/wallet-browser": "^0.0.102",
+    "@bsv/message-box-client": "^2.5.4",
+    "@bsv/sdk": "^2.8.6",
+    "@chainsafe/libp2p-noise": "17.0.0",
+    "@chainsafe/libp2p-yamux": "8.0.1",
+    "@ipld/dag-cbor": "^10.0.2",
+    "@ipld/dag-json": "^11.0.1",
+    "@libp2p/circuit-relay-v2": "4.2.13",
+    "@libp2p/crypto": "5.1.23",
+    "@libp2p/gossipsub": "17.1.2",
+    "@libp2p/identify": "4.1.14",
+    "@libp2p/kad-dht": "16.4.5",
+    "@libp2p/mdns": "12.0.32",
+    "@libp2p/peer-id": "6.0.15",
+    "@libp2p/ping": "3.1.13",
+    "@libp2p/tcp": "11.0.28",
+    "@libp2p/utils": "7.4.1",
+    "@libp2p/websockets": "10.1.21",
+    "@multiformats/multiaddr": "13.0.3",
+    "libp2p": "3.3.11",
+    "multiformats": "^14.0.5"
+  },
+  "devDependencies": {
+    "@1sat/connect": "^0.0.101",
+    "@types/node": "^26.6.2",
+    "buffer": "^6.0.3",
+    "esbuild": "^0.28.2",
+    "typescript": "^7.0.2"
+  },
+  "files": [
+    "dist",
+    "bin/skein.js",
+    "bin/skein-host.js",
+    "kernel-zig/web/kernel.js",
+    "kernel-zig/web/kernel.d.ts",
+    "kernel-zig/web/store.js",
+    "kernel-zig/web/worker.js",
+    "kernel-zig/web/client.js",
+    "kernel-zig/zig-out/web/skein-kernel.wasm",
+    "wasm/*.wasm",
+    "images",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "lmdb": "3.5.7"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}

package/wasm/README.md

@@ -0,0 +1,35 @@
+# wasm/
+
+The modules the kernel pins (`kernel-zig/src/programs.zig`; the wallet's
+also in `src/runtime/programs.ts`) and installs into every store
+(`skein-kernel serve`/`replay`, `skein-dev install`; `$SKEIN_WASM_DIR`
+overrides where they are read from). Each is checked against its pinned raw
+CID (CIDv1, raw, sha2-256) when it is installed.
+
+## Built here
+
+| module | source | what |
+|---|---|---|
+| `messagebox.wasm`, `frontdoor.wasm`, `resolve.wasm` | `programs/` | the boundary programs (#40) |
+| `wallet.wasm` | `programs/wallet` | the wallet app's program (#29, #79), over the SDK's `wallet` and `chain` modules |
+| `wire-probe.wasm` | `programs/test/wire-probe` | a test program, not pinned |
+
+All of these are Zig 0.16.0 and `wasm32-wasi`, over the SDK (shruggr/skein-sdk,
+a Zig package dependency by URL+hash, #75 — not a path in this tree).
+`scripts/build-programs.sh` builds them and `scripts/pin-programs.sh` rewrites
+the pins. The builds are reproducible.
+
+## Not here
+
+Apps ship their own modules in their trees (docs/APPS.md), and the install
+sends them. The shell app (shruggr/skein-shell) carries `run` and the shell
+itself: brush, coreutils and the toolset, with python's stdlib as a support
+file (#83: the kernel pins none of them; a genesis has no shell). The chat
+app (shruggr/skein-chat) carries the chat loop. The management site is
+shruggr/skein-site (`bin/site.wasm`, serving its tree with skein-sdk's
+`files`; #125). The overlay engine is
+shruggr/skein-overlay (`bin/overlay.wasm`, with its demo topic manager and
+lookup service), the chain app shruggr/skein-chain (`bin/chain.wasm`).
+
+Go `wasip1`, Rust, C and so on remain valid targets for third-party programs.
+The `skein` imports are the ABI (the SDK's `wit/skein.wit`), not a language.