release: prepare 0.3.1 ux refinement

Author: tomismeta

README.md

@@ -80,7 +80,7 @@ and agents                             attention now?    actually sees     to th
 
 Focus is meant to be more legible than a smart inbox.
 
-The first `0.3.0` explainability slice keeps reasoning attached to the cards you are already acting on:
+The current `0.3.x` explainability slice keeps reasoning attached to the cards you are already acting on:
 
 - `Why now` on the active card explains why the current item outranks the rest of the queue
 - `Why next` on queued rows explains why something is staged behind the current top item

docs/RELEASE-0.3.1.md

@@ -0,0 +1,40 @@
+# paperclip-aperture 0.3.1
+
+`0.3.1` refines the new Explainable Focus surface so it feels more native inside Paperclip.
+
+## Highlights
+
+- Reworked the active `Now` card into a clearer two-lane decision surface
+- Tightened queued and ambient presentation so Focus reads more like an operator queue and less like stacked plugin cards
+- Kept explainability visible in place while reducing duplication and visual noise
+- Preserved inline actionability, including commenting on issue-backed `Now` items without leaving Focus
+
+## What Changed
+
+- the active `Now` surface now separates:
+  - decision context on the left
+  - actions and response controls on the right
+- issue-backed `Now` items keep `Comment` and `Acknowledge` on the primary surface
+- approval-backed `Now` items now use a more intentional action layout with:
+  - `Approve` and `Reject` paired together
+  - `Request revision` treated as the secondary path
+- `Next` rows were quieted and clarified to feel more like a staged queue
+- `Ambient` was simplified into a more peripheral awareness shelf
+- `Why now` / `Why next` copy and action layout were tightened to remove repetition and reduce plugin-chrome feel
+
+## Why This Matters
+
+- Focus feels more like a native Paperclip operator surface
+- the active item is easier to scan, explain, and act on without leaving context
+- explainability stays attached to the decision without reading like a diagnostics panel
+
+## Validation
+
+- `pnpm test`
+- `pnpm typecheck`
+- `pnpm build`
+- `pnpm release:check`
+- live-smoke-tested against a local Paperclip instance, including:
+  - issue-backed `Now` with inline commenting
+  - approval-backed `Now` with approve / reject / request revision
+  - queued and ambient lane inspection

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomismeta/paperclip-aperture",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "private": false,
   "description": "The live attention layer for Paperclip, powered by Aperture's deterministic attention engine.",

src/manifest.ts

@@ -3,7 +3,7 @@ import type { PaperclipPluginManifestV1 } from "@paperclipai/plugin-sdk";
 const manifest: PaperclipPluginManifestV1 = {
   id: "tomismeta.paperclip-aperture",
   apiVersion: 1,
-  version: "0.3.0",
+  version: "0.3.1",
   displayName: "Paperclip Aperture",
   description: "The live attention layer for Paperclip, powered by Aperture's deterministic attention engine.",
   author: "@tomismeta",