@webpresso/plugin-claude 0.0.8 → 0.0.9

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Webpresso agent-kit Claude Code plugin: blueprints, skills, hooks, MCP server",
-    "version": "0.0.8"
+    "version": "0.0.9"
   },
   "plugins": [
     {
@@ -17,5 +17,5 @@
       "keywords": ["agent", "blueprint", "claude-code", "skills", "mcp"]
     }
   ],
-  "version": "0.0.8"
+  "version": "0.0.9"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-kit",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Webpresso agent-kit: blueprints, skills, lore commit protocol, tech-debt lifecycle",
   "author": {
     "name": "Webpresso",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/plugin-claude",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "private": false,
   "description": "Claude Code plugin adapter for Webpresso agent-kit skills, commands, and MCP runtime.",
   "homepage": "https://github.com/webpresso/app#readme",

package/plugin-skill-ownership.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "host": "claude",
   "packageName": "@webpresso/plugin-claude",
-  "packageVersion": "0.0.8",
+  "packageVersion": "0.0.9",
   "runtimeDirs": [".claude/skills"],
   "skills": {
     "ai-deslop": {
@@ -90,7 +90,7 @@
       "digest": "sha256:22533e26549b60494f042b5f4d7c97abf2019fc0a60697f84a395fa48ef0147f"
     },
     "tooling-friction": {
-      "digest": "sha256:92cc6825c222ad3f8dfe43c4a83a28e59f7a4d0179c886e276246f36670d3d0e"
+      "digest": "sha256:12a24fc747e3481aa857ace38993cd0324686ba70ffec115ff1a1955bd5999bc"
     },
     "tph": {
       "digest": "sha256:bed3684a850651534f315d355cdeae50d951c429817df0f105cccdb7f4e1561b"
@@ -99,7 +99,7 @@
       "digest": "sha256:137a063d5e286934b92b1d87397b7183f8ea6c564cddc3bb7e6cde5f3f306aaf"
     },
     "verify": {
-      "digest": "sha256:7f431a63e611c9f47d5edf87a889d4527658d2dd0c68f9dffd0924c1cd0dd028"
+      "digest": "sha256:10ea1c2c1436be23721e4510fe73194f835828510e6a8995e93b84f80351fc4a"
     }
   }
 }

package/skills/tooling-friction/SKILL.md

@@ -23,7 +23,7 @@ Optional post-land **product signal** for MCP/CLI/hooks/CI pain so Webpresso too
 | ---------------------------------------------------- | -------------------------------------------------- |
 | Structured friction tips after land-ish success      | Code bugs (`/investigate` → `/fix`)                |
 | Optional promote to tech-debt (`--category tooling`) | Blueprint claim corrections (`blueprints/errata/`) |
-| Local planning-state JSON (gitignored)               | Human DX audits (`/devex-review`)                  |
+| Repo-scoped desktop-state JSON (outside worktrees)   | Human DX audits (`/devex-review`)                  |
 | Soft bookend from `/verify` Phase 7                  | Required PR section, finalize/merge blockers       |
 
 ## When
@@ -44,13 +44,28 @@ Optional post-land **product signal** for MCP/CLI/hooks/CI pain so Webpresso too
 1. **Recall only** — do not re-ingest full CI logs or transcripts.
 2. If zero medium+ findings → stop: `skipped: no tooling friction`.
 3. Emit **1–3** findings (hard cap 8 for schema headroom; prefer ≤3).
-4. Write JSON to:
+4. Write JSON to the central, repo-scoped desktop state surface:
 
    ```text
-   .agent/planning/state/tooling-friction/YYYY-MM-DD-<slug|pr|session>.json
+   <state-root>/<repo-key>/tooling-friction/YYYY-MM-DD-<slug|pr|session>.json
    ```
 
-   Create parent dirs as needed. Path is under the durable planning **state** surface (see `Agents.md`). `.agent/` is gitignored — **never** `git add` captures.
+   Ask the read-only MCP resolver for the exact path, then use that returned
+   absolute path for the write:
+
+   ```text
+   wp_tooling_friction_path({"file":"YYYY-MM-DD-<slug|pr|session>.json"})
+   ```
+
+   The resolver is backed directly by
+   `getSurfacePath("tooling-friction/<file>", "repo", <project-cwd>)`. For
+   human CLI use, the equivalent read-only projection is
+   `wp tooling-friction path --file <file>`. The capture is shared by that
+   repository's worktrees but never written to any checkout. Create parent
+   dirs as needed. If the returned path already exists, choose a unique
+   session/HHMM suffix rather than overwriting it. If the surface cannot be
+   resolved or written, report `tooling-friction: skipped: no state surface`
+   and stop; never fall back to a worktree or `.agent/` path.
 
 5. Optional `--promote` or severity `high`/`critical`:  
    `wp tech-debt new "<short title>" --severity <s> --category tooling --status accepted`  
@@ -61,7 +76,10 @@ Optional post-land **product signal** for MCP/CLI/hooks/CI pain so Webpresso too
 
 ## Store path (SSOT)
 
-`.agent/planning/state/tooling-friction/*.json` — planning `state/`, not a new top-level under `planning/`.
+`wp_tooling_friction_path({"file":"<file>"})` (or the human CLI projection
+`wp tooling-friction path --file <file>`) — a read-only projection of
+`getSurfacePath("tooling-friction/<file>", "repo", <project-cwd>)`, the
+repo-scoped desktop state surface, not a path inside `planning/` or a worktree.
 
 ## Schema v1
 
@@ -112,10 +130,12 @@ Optional post-land **product signal** for MCP/CLI/hooks/CI pain so Webpresso too
 ### Limits
 
 - findings: prefer ≤3 (schema max 8)
+- finding `id`: `tf-` followed by 4–40 lowercase letters, digits, or hyphens
+- finding `tool`: ≤80 characters
 - `symptom` / `suggested_fix`: ≤280 chars
 - `notes`: ≤400 chars
 - `evidence_refs`: ≤5 items × ≤200 chars (run ids, receipt names, `pr:N` — **not** log bodies)
-- `token_waste` bands: none &lt;1k · low 1–5k · medium 5–20k · high &gt;20k or multi-retry (estimate only)
+- `token_waste` bands: `none` <1k · `low` 1–5k · `medium` 5–20k · `high` >20k or multi-retry (estimate only)
 
 ## Few-shot tips
 
@@ -139,7 +159,7 @@ Optional post-land **product signal** for MCP/CLI/hooks/CI pain so Webpresso too
 4. No inventing tips on smooth runs
 5. No timeout-as-fix suggestions
 6. No blueprint errata misuse
-7. No committing `.agent/` captures
+7. No committing desktop-state captures
 8. No auto-open GitHub issues per tip
 
 ## Integration
@@ -151,7 +171,7 @@ Optional post-land **product signal** for MCP/CLI/hooks/CI pain so Webpresso too
 ## Output (agent reply)
 
 ```text
-tooling-friction: wrote .agent/planning/state/tooling-friction/<file>.json
+tooling-friction: wrote desktop state <state-root>/<repo-key>/tooling-friction/<file>.json
 findings: 2 (high=1, medium=1)
 promoted: none | tech-debt/...
 ```

package/skills/verify/SKILL.md

@@ -355,6 +355,8 @@ When catalog assets or generated instruction surfaces changed, include public-pa
 If any required check is missing, the correct result is **not done yet**, not a softer claim.
 
 **Tooling friction (optional):** if this session burned medium+ tokens on MCP/CLI/hooks/CI
-gates (not product code), run `/tooling-friction` once and write tips under
-`.agent/planning/state/tooling-friction/`. Skip when the path was smooth. Never
-blocks land — see the `tooling-friction` skill.
+gates (not product code), run `/tooling-friction` once and resolve its capture
+destination with `wp_tooling_friction_path({"file":"<file>"})` (human CLI:
+`wp tooling-friction path --file <file>`). Skip when the path was smooth. If
+the surface cannot be resolved or written, report the skip and never fall
+back to a worktree path. Never blocks land — see the `tooling-friction` skill.