From 98b2177accc598152cd8a1be0cc7a05aca17c7d8 Mon Sep 17 00:00:00 2001
From: tegwick <bernd.worsch@gmail.com>
Date: Mon, 22 Jun 2026 23:35:05 +0200
Subject: [PATCH] Complete State Hub bootstrap workplans (WP-0001)

- Review integration files; fill SCOPE where templated
- Document dev workflow in stack-and-commands.md
- Seed WP-0002 implementation workplan; mark bootstrap finished
- Hub sync via fix-consistency
---
 .claude/rules/stack-and-commands.md           | 20 ++++++-------
 .../BINECT-WP-0001-statehub-bootstrap.md      | 17 ++++++++---
 ...INECT-WP-0002-sdk-publication-readiness.md | 28 +++++++++++++++++++
 3 files changed, 49 insertions(+), 16 deletions(-)
 create mode 100644 workplans/BINECT-WP-0002-sdk-publication-readiness.md

diff --git a/.claude/rules/stack-and-commands.md b/.claude/rules/stack-and-commands.md
index dc53ac6..58c5988 100644
--- a/.claude/rules/stack-and-commands.md
+++ b/.claude/rules/stack-and-commands.md
@@ -1,19 +1,15 @@
 ## Stack
 
-<!-- TODO: Fill in language, frameworks, and key dependencies -->
-- **Language:**
-- **Key deps:**
+- **Language:** TypeScript (ESM)
+- **Key deps:** Vitest; publishes `@binect/js`
 
 ## Dev Commands
 
 ```bash
-# TODO: Fill in the standard commands for this repo
-
-# Install dependencies
-
-# Run tests
-
-# Lint / type check
-
-# Build / package (if applicable)
+npm install
+npm run build
+npm test
+npm run test:e2e
+npm run typecheck
+npm run clean
 ```
diff --git a/workplans/BINECT-WP-0001-statehub-bootstrap.md b/workplans/BINECT-WP-0001-statehub-bootstrap.md
index 71820de..32c8ff0 100644
--- a/workplans/BINECT-WP-0001-statehub-bootstrap.md
+++ b/workplans/BINECT-WP-0001-statehub-bootstrap.md
@@ -4,7 +4,7 @@ type: workplan
 title: "Bootstrap State Hub integration"
 domain: communication
 repo: binect-js
-status: ready
+status: finished
 owner: codex
 topic_slug: communication
 created: "2026-06-22"
@@ -20,11 +20,14 @@ JavaScript/TypeScript wrapper for the Binect REST API.
 
 ```task
 id: BINECT-WP-0001-T01
-status: todo
+status: done
 priority: high
 state_hub_task_id: "502743ee-7774-4a06-8287-b8a68527e76f"
+
 ```
 
+Result 2026-06-22: Integration files reviewed.
+
 Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
 Replace generated placeholders with repo-specific facts where needed.
 
@@ -32,11 +35,14 @@ Replace generated placeholders with repo-specific facts where needed.
 
 ```task
 id: BINECT-WP-0001-T02
-status: todo
+status: done
 priority: high
 state_hub_task_id: "a98ca0fe-3c7c-4886-a530-62a68ca32c7e"
+
 ```
 
+Result 2026-06-22: Documented npm/vitest workflow.
+
 Identify the repo's install, test, lint, build, and run commands. Add or refine
 those commands in the agent instructions so future coding sessions can verify
 changes confidently.
@@ -45,11 +51,14 @@ changes confidently.
 
 ```task
 id: BINECT-WP-0001-T03
-status: todo
+status: done
 priority: medium
 state_hub_task_id: "9a099aee-b374-4af4-af3b-52a2f9b1b649"
+
 ```
 
+Result 2026-06-22: Created BINECT-WP-0002.
+
 Create the first implementation workplan for the repository's most important
 next change. After workplan file updates, run from `~/state-hub`:
 
diff --git a/workplans/BINECT-WP-0002-sdk-publication-readiness.md b/workplans/BINECT-WP-0002-sdk-publication-readiness.md
new file mode 100644
index 0000000..6fe360c
--- /dev/null
+++ b/workplans/BINECT-WP-0002-sdk-publication-readiness.md
@@ -0,0 +1,28 @@
+---
+id: BINECT-WP-0002
+type: workplan
+title: "SDK publication and consumer validation"
+domain: communication
+repo: binect-js
+status: ready
+owner: codex
+topic_slug: communication
+created: "2026-06-22"
+updated: "2026-06-22"
+state_hub_workstream_id: "e98363de-fe52-43a3-82be-df0b1a213593"
+---
+
+# SDK publication and consumer validation
+
+Prepare `@binect/js` for npm publication and validate the Explorer against live API flows.
+
+## Publication readiness checklist
+
+```task
+id: BINECT-WP-0002-T01
+status: todo
+priority: high
+state_hub_task_id: "6aa6e1f6-decb-46fa-900e-62519383e971"
+```
+
+Verify build output, types, e2e tests, and document npm publish + consumer install path in README.