@flyingrobots/graft 0.8.0 → 0.9.0

package/docs/MCP.md

@@ -52,14 +52,18 @@ npx @flyingrobots/graft daemon
 ```
 
 Daemon sessions start `unbound`. Once a client is connected to the
-daemon MCP surface, repository-scoped work follows this control-plane
-flow:
+daemon MCP surface, repository-scoped work normally follows this
+agent-facing flow:
 
-1. `workspace_authorize` with the target `cwd`
-2. `workspace_bind` with the target `cwd`
+1. `workspace_open` with the target `cwd`
+2. optionally `workspace_list_opened` to inspect opened paths and the
+   active workspace
 3. then call repository-scoped tools such as `safe_read`, `graft_since`,
    or `code_show`
 
+`workspace_authorize` and `workspace_bind` remain available as lower-level
+daemon control-plane tools.
+
 ## Key Tool Groups
 - **Bounded Reads**: `safe_read`, `file_outline`, `read_range`, `changed_since`
 - **Governed Edits**: `graft_edit`
@@ -68,7 +72,8 @@ flow:
 - **Structural Metrics**: `graft_churn`, `graft_difficulty`
 - **Precision**: `code_show`, `code_find`, `code_refs`
 - **Activity & Footing**: `activity_view`, `causal_status`, `causal_attach`, `doctor`
-- **Daemon Control Plane**: `workspace_authorizations`, `workspace_authorize`, `workspace_bind`, `workspace_status`, `workspace_rebind`, `workspace_revoke`, `daemon_status`, `daemon_repos`, `daemon_sessions`, `daemon_monitors`, `monitor_*`
+- **Workspace Routing**: `workspace_open`, `workspace_list_opened`, `workspace_status`
+- **Daemon Control Plane**: `workspace_authorizations`, `workspace_authorize`, `workspace_bind`, `workspace_rebind`, `workspace_revoke`, `daemon_status`, `daemon_repos`, `daemon_sessions`, `daemon_monitors`, `monitor_*`
 
 ## Current Truth
 - MCP is the primary agent surface.

package/docs/SETUP.md

@@ -98,6 +98,8 @@ Daemon control-plane inspection now exists through MCP tools:
 - `monitor_stop`
 - `workspace_authorizations`
 - `workspace_authorize`
+- `workspace_open`
+- `workspace_list_opened`
 - `workspace_bind`
 - `workspace_status`
 - `workspace_rebind`
@@ -120,10 +122,14 @@ Practical daemon-backed MCP first-use sequence:
 
 1. configure your MCP client with `graft serve --runtime daemon`
 2. let the bridge auto-start the daemon, or start `npx @flyingrobots/graft daemon`
-3. call `workspace_authorize` with the target `cwd`
-4. call `workspace_bind` with the target `cwd`
+3. call `workspace_open` with the target `cwd`
+4. optionally call `workspace_list_opened` to inspect opened paths and the
+   active workspace
 5. then use repository-scoped tools such as `safe_read` or `graft_map`
 
+Use `workspace_authorize` plus `workspace_bind` when you need direct
+operator control over daemon authorization and binding state.
+
 ### MCP runtime selection
 
 Repo-local stdio is the default and remains the simplest path:
@@ -157,8 +163,7 @@ Use repo-local stdio when you want one MCP server bound directly to the
 current checkout. Use daemon-backed stdio when you want daemon-only
 capabilities such as shared worker pools, persistent monitors, and
 daemon control-plane inspection. Daemon-backed sessions start unbound;
-repository-scoped tools require `workspace_authorize` and
-`workspace_bind`.
+repository-scoped tools normally begin with `workspace_open`.
 
 ### One-step bootstrap
 
@@ -399,8 +404,9 @@ If your client doesn't support `npx`, install globally and use:
 
 This section shows the repo-local stdio path. If you connect through
 `graft daemon` instead, the MCP session starts `unbound` and needs
-`workspace_authorize` plus `workspace_bind` before repository-scoped
-tool calls.
+`workspace_open` before repository-scoped tool calls. The lower-level
+`workspace_authorize` and `workspace_bind` tools remain available for
+operator control-plane workflows.
 
 ## Claude Code Hooks
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyingrobots/graft",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Context governor and between-commit activity surface for coding agents",
   "type": "module",
   "packageManager": "pnpm@10.30.0",
@@ -46,11 +46,15 @@
     "test:watch": "vitest",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
+    "schema:structural-history:check": "tsx scripts/check-structural-history-schema-artifacts.ts && tsx scripts/check-structural-history-echo-package.ts",
     "pack:check": "pnpm pack --dry-run",
     "guard:agent-worktrees": "tsx scripts/check-agent-worktree-hygiene.ts",
     "security:check": "tsx scripts/check-release-security.ts",
     "release:surface-gate": "vitest run --run test/unit/release/package-library-surface.test.ts test/unit/release/three-surface-capability-posture.test.ts",
-    "release:check": "pnpm guard:agent-worktrees && pnpm lint && pnpm typecheck && pnpm release:surface-gate && pnpm test && pnpm security:check && pnpm pack:check"
+    "release:check": "pnpm guard:agent-worktrees && pnpm schema:structural-history:check && pnpm lint && pnpm typecheck && pnpm release:surface-gate && pnpm test && pnpm security:check && pnpm pack:check",
+    "gh:issues": "bash scripts/gh-issues.sh bootstrap",
+    "gh-issues": "bash scripts/gh-issues.sh bootstrap",
+    "gh-issues:check": "bash scripts/gh-issues-check.sh"
   },
   "engines": {
     "node": ">=20.11.0"
@@ -111,10 +115,12 @@
     "onlyBuiltDependencies": [],
     "overrides": {
       "vite": "^8.0.5",
+      "brace-expansion": "5.0.6",
       "hono": "4.12.18",
       "fast-uri": "3.1.2",
       "ip-address": "10.2.0",
-      "postcss": "8.5.12"
+      "postcss": "8.5.12",
+      "qs": "6.15.2"
     }
   }
 }