dsh-plugin-infj-pet 1.0.1 → 1.0.4

package/ASSETS-LICENSE.md

@@ -8,9 +8,13 @@ The sources, prompts and quality reports are kept in `Sage/`; `Sage/README.md`
 records the pet's stable id and provenance.
 
 `assets/sage.png` is the sprite sheet, copied unmodified from
-`Sage/final/spritesheet-extended.png` (SHA-256
-`58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1`, as recorded
-in `Sage/pet-record.json`). Everything else in `assets/` is derived from it:
+`Sage/updates/reading/final/spritesheet-reading.png` (SHA-256
+`c62020fa4b634d037e72d9fbad270494e96622603978431c3f7fdadde4a3ecdb`). It is the
+original sheet with one revision: row 4, the engine's `jumping` slot, was redrawn
+as the sage standing with an open book. A pixel comparison confirms the other ten
+rows are byte-identical to the original.
+
+Everything else in `assets/` is derived from it:
 
 | File | Derived how |
 |---|---|
@@ -18,12 +22,21 @@ in `Sage/pet-record.json`). Everything else in `assets/` is derived from it:
 | `sage.png.b64` | the same bytes, base64, for embedding in the bundle |
 | `icon.png` | head crop of the resting frame, 3× nearest-neighbour |
 | `preview.png` | one frame per animation, on a flat backdrop |
+| `provenance/` | the sheet's validation report, change audit and generation notes |
 
 **The artwork is not covered by the MIT code license.** It is released under
 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/): share and
 adapt it for non-commercial use with attribution, under the same license.
 Commercial use needs the copyright holder's permission.
 
+## Quoted text
+
+Some reading lines are short quotations from **史铁生 (Shi Tiesheng)**, each
+attributed in the interface under the line it belongs to. They are brief,
+individually attributed, and used in a non-commercial companion; the project
+claims no rights in them, and no passage is reproduced beyond those short lines.
+See the quotation table in the README for the exact lines and their sources.
+
 Attribution form:
 
 > Sage artwork — dsh-plugin-infj-pet — CC BY-NC-SA 4.0

package/CHANGELOG.md

@@ -3,55 +3,125 @@
 All notable changes to this plugin are documented here. This project follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
-
-**Artwork replaced**
-
-- The character is now **Sage**, the pixel-art INFJ pet produced with the
-  built-in image generator (`Sage/`). The hand-drawn SVG sage is gone.
-- Nine animations and sixteen head poses come from one 1536×2288 sprite sheet,
-  embedded in the bundle so the plugin makes no network request at all.
+## 1.0.4
+
+**Fix: the plugin never activated**
+
+`1.0.3` shipped a Host half that could not start. In Cordis an `inject` entry
+names a service the plugin waits for, and the entry stays pending until that name
+is provided — an object form does not mean "optional". The Host half declared
+`{ optional: ['agents'] }`, which asks for a service literally called `optional`.
+Nothing provides it, so the entry stayed pending forever and the whole plugin,
+browser half included, never loaded. DSH reported it as:
+
+```
+1 entry did not activate infj-pet (dsh-plugin-infj-pet):
+pending (waiting for service: optional)
+```
+
+The `inject` declaration is gone. The optional agents registry is read with
+`ctx.get('agents')` instead, which returns `undefined` when it is absent and
+costs only the coarse `isSubagent` hint on a recorded boundary.
+
+Guards added so this cannot come back:
+
+- a test asserts `inject` is `undefined`, with the reason in the failure path
+- a test asserts the Host half still activates and records a boundary when no
+  agents registry is present
+- the fake Cordis context no longer needs `agents`, because the plugin must not
+  ask for it
+
+**A note on why this was missed.** Forty-six of the forty-seven tests exercised
+the browser half, which was never the part failing. The Host half was tested
+against a fake context — and a fake context does not enforce the `inject` gate,
+because that gate is framework behaviour. A complete stub hid a framework-level
+failure; the new assertions target exactly that blind spot.
+
+## 1.0.3
+
+**The sage no longer paces about**
+
+- Working is a reading now. While any session is busy the sage sits with its open
+  book and turns the pages; it does not switch to a walking loop after a while,
+  and the twenty-second timer that used to trigger one is gone from the machine
+  entirely.
+- Running belongs to being carried. Drag the sage and it runs in the direction
+  you take it, facing left or right, and it turns around at the screen edge so it
+  never appears to run out of the window it is pinned to. Letting go stops it at
+  once.
+- `run-left` finally has a job: it is the inward-facing run when the sage is
+  pinned against a wall.
+
+**Drag robustness**
+
+Six bugs surfaced in the drag path while testing this, all of them fixed:
+
+- A drag origin that came back `null` from an unmeasured node poisoned every
+  distance after it; the origin is now validated and latched from the first real
+  position.
+- The drag anchor did not advance, so a reversal was measured from the original
+  grab and could not be expressed until the pointer returned past it.
+- The screen-edge turnaround tested the clamped result instead of the requested
+  distance, so pulling away from a wall flipped the facing the wrong way.
+- A pointer press now clears a stale facing, and letting go always stops the run.
+
+## 1.0.2
+
+**The reading revision**
+
+- The leap is gone. When a watched turn finishes, the sage now sits down with an
+  open book: steady stance, eye movement, a short blink and a page turn. The
+  `celebrating` state is renamed `reading` throughout — the state, its timing
+  setting and its internal flag — because that is what actually happens now.
+- The animation is a sheet revision, not new code: row 4, the engine's `jumping`
+  slot, was redrawn. A pixel comparison in the build verifies the other ten rows
+  are unchanged, and the new sheet's SHA-256 is checked against the value
+  recorded in its change audit.
+
+**Quoted lines**
+
+- Reading lines are now quotations, attributed in the interface beneath the text
+  they belong to, in a smaller and quieter line. A quoted line is never
+  presented as the sage's own.
+- Only lines that could be checked against a published source are presented as
+  quotations; one supplied line is recorded as unpublished rather than silently
+  attributed. See the quotation table in the README.
+- The bubble grew a source row and the stylesheet a quoted-line variant, so a
+  longer line wraps left-aligned instead of sitting centred like a quip.
+
+## 1.0.1
+
+First published release. `1.0.0` was consumed by npm's staged-publish pipeline —
+the upload was accepted but never finalised, and the registry then refused to
+reuse the version — so the release moved to 1.0.1 with no code change.
+
+**Artwork**
+
+- The character is **Sage**, a pixel-art INFJ pet generated with the built-in
+  image generator. One 1536×2288 sprite sheet, an 8×11 grid of 192×208 cells:
+  nine animations and sixteen head poses, embedded in the bundle so the plugin
+  makes no network request at all.
 - The sheet's SHA-256 is checked against the value recorded in its validation
   report, so the plugin cannot ship artwork that differs from what was validated.
 
-**New behaviour**
+**Behaviour**
 
 - **Keeps pace** — after twenty seconds of uninterrupted work the sage switches
-  from thinking to a walking loop, then celebrates or slumps when the run ends.
+  from thinking to a walking loop, then leaps or slumps when the run ends.
 - **Idle glances** — while resting, it looks around using the drawn head poses.
-- Display sizes are now exact integer multiples of the sprite pixels (1×, 2×, 3×),
-  which is what keeps pixel art crisp; the old fractional sizes are gone.
-
-**Build**
-
-- `lib/client.js` is generated from readable regions in `lib/src/`, so gaps
-  between source and bundle show up in review rather than in a diff of a 2 MB
-  file.
-- `tools/png.mjs` decodes the sheet without any dependency, and the broken
-  `--sprite` build path was removed.
-- `npm run check` now verifies the sheet hash, the frame boundaries, the gaze
-  coverage, the generated icon, and that the bundle matches its sources.
-- `npm run build` regenerates the index, icon, contact sheet, bundle and offline
-  preview in one pass.
-
-## 1.0.0
-
-First release of the plugin.
-
-**The companion**
-
 - Six semantic states — 静观 resting, 洞察 working, 共情 waiting, 笃定
   celebrating, 充电 sleeping, 受挫 error — each mapped to one facet of the INFJ
   description on the reference card.
-- Per-pose animation, disabled by `prefers-reduced-motion` or by the motion
-  setting.
+- Display sizes are exact integer multiples of the sprite pixels (1×, 2×, 3×),
+  which is what keeps pixel art crisp.
+- Animation follows `prefers-reduced-motion` and the motion setting.
 
 **Interaction**
 
 - Click to hear a line in character; drag to reposition with edge snapping and a
   remembered position.
-- Right-click settings: session scope, size, nap delay, palette, motion,
-  auto-tips, reset position, tuck away, and a trait explainer.
+- Right-click settings: session scope, size, nap delay, palette, motion, idle
+  glances, auto-tips, reset position, tuck away, and a trait explainer.
 - Bilingual (English / 简体中文), following the DSH language until you choose one.
 - Tuck away collapses the sage to a corner restore button.
 
@@ -67,4 +137,11 @@ First release of the plugin.
 
 - Zero runtime dependencies; the client bundle is committed, so a Git install
   needs no build step.
-- Structural checks and a behavioural test suite ship with the package.
+- 19 files, 3.4 MB packed, 4.0 MB unpacked. `lib/src/` and `assets/sage.png.b64`
+  are build inputs and stay out of the tarball; the bundle already embeds the
+  sheet.
+- `prepublishOnly` runs the structural checks and the test suite, so a broken
+  build cannot be published.
+- `lib/client.js` is generated from readable regions in `lib/src/`, and both the
+  checker and the test suite rebuild it, so the shipped bundle can never drift
+  from its sources.

package/README.md

@@ -2,6 +2,8 @@
 
 **A pixel-art INFJ companion that lives inside your DeepSeek Harness window.**
 
+**Just here to accompany Qiangwei.**
+
 一只住在 DSH 窗口里的 INFJ 贤者：陪你专注、等你决定，也陪你安静地打个盹。
 
 <p align="center">
@@ -9,7 +11,7 @@
 </p>
 
 <p align="center">
-  <img src="assets/preview.png" width="820" alt="Every animation: idle, run-right, run-left, wave, jump, failed, waiting, working, pondering">
+  <img src="assets/preview.png" width="820" alt="Every animation: idle, run-right, run-left, wave, reading, failed, waiting, working, pondering">
 </p>
 
 The sage is not a progress bar. It reads what your agents are already doing —
@@ -18,6 +20,9 @@ character. Six semantic states, drawn from a nine-animation sprite sheet where
 each pose expresses a different facet of the INFJ description on the reference
 card.
 
+While you work it sits and reads, turning its pages. It only runs when you pick
+it up.
+
 ---
 
 ## What it does
@@ -25,41 +30,64 @@ card.
 | Pose | When it appears | Trait it expresses |
 |---|---|---|
 | 静观 Observing | Nothing is running | 独处即充电 — recharged alone |
-| 洞察 Insight | At least one session is working | 先看模式，再看任务 — patterns before tasks |
-| 陪伴 Keeping pace | Work has run for 20s without a break | 理想主义的续航 — idealist stamina |
+| 阅读 Reading | At least one session is working, or a watched turn just finished | 先看模式，再看任务 — patterns before tasks |
 | 共情 Empathy | A session is waiting on your answer | 先接住情绪 — feelings first |
-| 笃定 Resolve | A turn the sage watched just finished | 低调地笃定 — quiet conviction |
 | 充电 Recharging | Idle past the nap delay | 独处即充电 — the quiet half |
 | 受挫 Setback | A turn ended in an error | 过载时向内自责 — overload turns inward |
+| 带我去哪儿 Carried | While you are dragging it | 理想主义的续航 — carried, not chasing |
 
 Around that core:
 
 - **Click** the sage and it says something in character.
 - **Drag** it anywhere; it snaps to the edge and remembers where you left it.
+- **It reads while you work** — an open book, eyes following the page, a quiet
+  page turn. It never paces about on its own.
+- **It runs only when carried** — pick it up and it runs in the direction you
+  take it, turning around at the screen edge so it never looks like it is
+  running out of the window.
 - **Right-click** for settings: session scope, size, nap delay, palette, motion,
   idle glances, auto-tips, position reset, tuck away, and a trait panel.
 - **Idle glances** — while resting, the sage looks around using the sheet's
   sixteen drawn head poses.
-- **Keeps pace** — after twenty seconds of uninterrupted work it starts walking,
-  then celebrates or slumps when the run ends.
 - Follows DSH's language, light/dark theme, and reduce-motion preference.
 - No build step to install, no runtime dependencies, no network calls, no model
   calls.
 
 This is an **in-window** companion, not an operating-system desktop overlay.
 
+### Words borrowed from 史铁生 (Shi Tiesheng)
+
+Several of the reading lines are his, and the sage is careful to say so: a
+quoted line renders its attribution directly under the text, in a smaller line,
+never as if the sage had written it.
+
+| Line | Source |
+|---|---|
+| 如果我进来，走进你独处的时间……我只是来给你的窗上装好玻璃，冬天的风就要来了。 | 史铁生 — supplied by the project owner; publication not yet identified |
+| 死是一件不必急于求成的事。 | 史铁生《我与地坛》 |
+| 太阳，他每时每刻都是夕阳也都是旭日。 | 史铁生《我与地坛》 |
+| 我常觉得这中间有着宿命的味道。 | 史铁生《我与地坛》 |
+
+Where a line could not be verified against a published source, this project says
+so rather than presenting a guess as a quotation — the first row above is
+recorded as unverified for exactly that reason. Titles are referenced for the
+remaining states; no passage is reproduced beyond the short lines listed here.
+
 ---
 
 ## Install
 
 ### 1. From npm
 
-```
+Package page: [dsh-plugin-infj-pet on npm](https://www.npmjs.com/package/dsh-plugin-infj-pet).
+
+Enter the package name in DSH's plugin installation page (sidebar → **Plugins**):
+
+```text
 dsh-plugin-infj-pet
 ```
 
-Enter that name in DSH's plugin installation page (sidebar → **Plugins**). To
-pin this release, use `dsh-plugin-infj-pet@1.0.0`.
+To pin this release, use `dsh-plugin-infj-pet@1.0.1`.
 
 ### 2. From GitHub
 
@@ -70,7 +98,7 @@ github:CN-Mg/dsh_infj_pet
 Or with a pinned tag:
 
 ```
-github:CN-Mg/dsh_infj_pet#v1.0.0
+github:CN-Mg/dsh_infj_pet#v1.0.1
 ```
 
 The committed source already contains the built client bundle, so a Git install
@@ -139,8 +167,12 @@ contract:
 - injected shares: `slots`, `sessions`, `connection`, `locale`
 - only `react` and `react-dom/client` are required from the platform module table
 
-The Host half declares no required service and registers one optional listener,
-so a Host-side change degrades the companion rather than failing the plugin.
+The Host half declares **no `inject`**, on purpose. A Cordis `inject` entry names a
+service the plugin waits for, and the entry stays pending until that service is
+provided — so an `inject` that never resolves stops the whole plugin, browser half
+included, from ever activating. The optional agents registry is read with
+`ctx.get('agents')` instead, which returns `undefined` when it is missing and
+costs only the coarse `isSubagent` hint.
 
 DSH is evolving quickly. If a future release changes the slot or store contract,
 the sage is written to fail quietly: it falls back to a non-reactive pose rather

package/assets/provenance/sage-pet-record.json

@@ -7,10 +7,11 @@
   "active_pet_id": "default",
   "verified_in_pets": true,
   "spritesheet": "assets/sage.png",
-  "sha256": "58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1",
+  "sha256": "c62020fa4b634d037e72d9fbad270494e96622603978431c3f7fdadde4a3ecdb",
   "artifact_storage": "local workspace; ChatGPT Library tools unavailable",
   "generation": "built-in imagegen",
   "quality_report": "assets/provenance/sage-validation.json",
   "visual_review": "qa/final-visual-review.json",
-  "note": "Provenance copy. The full generation workspace (prompts, frames, QA renders) is not published; see assets/provenance/sage-README.md."
+  "note": "Provenance copy. The full generation workspace (prompts, frames, QA renders) is not published; see assets/provenance/sage-README.md.",
+  "revision": "reading: row 4 (engine slot jumping) redrawn as the sage holding an open book"
 }

package/assets/provenance/sage-reading-README.md

@@ -0,0 +1,11 @@
+# Reading revision
+
+User request: "Jumping up looks too clumsy, switch to reading instead."
+
+Sage now stands steadily holding an open book, follows its pages with his eyes, blinks and gently turns an attached page. This replaces only the five frames of row 4. All other RGBA pixels are unchanged from the stored pet. Stable ID and active selection preserved.
+
+Artwork generated with built-in imagegen using the stored pet spritesheet as an identity reference. Exact production prompt: `prompt.md`.
+
+Current sprite sheet: `final/spritesheet-reading.png`. Motion previews and stills: `qa/previews/`. Official pipeline reports, explicit reading semantic override and stored-artwork verification: `qa/`.
+
+The stored Pets sprite sheet was fetched after update and verified pixel-identical to the submitted revision. Expiring URLs and temporary upload-session identities were not saved.

package/assets/provenance/sage-reading-change-audit.json

@@ -0,0 +1,22 @@
+{
+  "changed_row": 4,
+  "requested_action": "reading",
+  "engine_slot_name": "jumping",
+  "required_frame_count": 5,
+  "preserved_rows": [
+    0,
+    1,
+    2,
+    3,
+    5,
+    6,
+    7,
+    8,
+    9,
+    10
+  ],
+  "source_sha256": "3efc8fa70db42c226b3ac1baebd07dc3323f0cf697f6bf503b08552de9654963",
+  "final_sha256": "c62020fa4b634d037e72d9fbad270494e96622603978431c3f7fdadde4a3ecdb",
+  "semantic_override": "User explicitly requested reading in place of jump; the supported quality CLI minimum lift is zero for this revision. No vertical lift is expected.",
+  "all_other_rgba_pixels_unchanged": true
+}

package/assets/provenance/sage-validation.json

@@ -1,8 +1,7 @@
 {
   "ok": true,
   "file": "assets/sage.png",
-  "encoded_bytes": 1564801,
-  "sha256": "58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1",
+  "sha256": "c62020fa4b634d037e72d9fbad270494e96622603978431c3f7fdadde4a3ecdb",
   "format": "PNG",
   "mode": "RGBA",
   "columns": 8,
@@ -307,7 +306,7 @@
       "row": 4,
       "column": 0,
       "used": true,
-      "nontransparent_pixels": 8631,
+      "nontransparent_pixels": 8645,
       "opaque_chroma_key_pixels": 0,
       "chroma_fringe_pixels": 0
     },
@@ -316,7 +315,7 @@
       "row": 4,
       "column": 1,
       "used": true,
-      "nontransparent_pixels": 9126,
+      "nontransparent_pixels": 8658,
       "opaque_chroma_key_pixels": 0,
       "chroma_fringe_pixels": 0
     },
@@ -325,7 +324,7 @@
       "row": 4,
       "column": 2,
       "used": true,
-      "nontransparent_pixels": 8956,
+      "nontransparent_pixels": 8840,
       "opaque_chroma_key_pixels": 0,
       "chroma_fringe_pixels": 0
     },
@@ -334,7 +333,7 @@
       "row": 4,
       "column": 3,
       "used": true,
-      "nontransparent_pixels": 9085,
+      "nontransparent_pixels": 8676,
       "opaque_chroma_key_pixels": 0,
       "chroma_fringe_pixels": 0
     },
@@ -343,7 +342,7 @@
       "row": 4,
       "column": 4,
       "used": true,
-      "nontransparent_pixels": 8558,
+      "nontransparent_pixels": 8646,
       "opaque_chroma_key_pixels": 0,
       "chroma_fringe_pixels": 0
     },

package/assets/sage-index.json

@@ -1,6 +1,6 @@
 {
   "sheet": "sage.png",
-  "sha256": "58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1",
+  "sha256": "c62020fa4b634d037e72d9fbad270494e96622603978431c3f7fdadde4a3ecdb",
   "sheetWidth": 1536,
   "sheetHeight": 2288,
   "columns": 8,
@@ -11,10 +11,10 @@
     "width": 192,
     "height": 208,
     "art": {
-      "x": 33,
-      "y": 6,
-      "width": 125,
-      "height": 198
+      "x": 37,
+      "y": 46,
+      "width": 117,
+      "height": 158
     },
     "ground": 204
   },
@@ -218,12 +218,12 @@
       }
     },
     {
-      "state": "jump",
+      "state": "reading",
       "label": {
-        "zh": "跃起",
-        "en": "Leaping"
+        "zh": "阅读",
+        "en": "Reading"
       },
-      "fps": 8,
+      "fps": 5,
       "row": 4,
       "frames": [
         {
@@ -253,10 +253,10 @@
         }
       ],
       "art": {
-        "x": 33,
-        "y": 6,
-        "width": 125,
-        "height": 196
+        "x": 53,
+        "y": 49,
+        "width": 86,
+        "height": 155
       }
     },
     {