dsh-plugin-infj-pet 0.0.0-stage → 1.0.0

package/ASSETS-LICENSE.md

@@ -0,0 +1,42 @@
+# Asset license
+
+## Artwork
+
+The character is **Sage**, a pixel-art INFJ sage generated with a built-in image
+generator from the INFJ Advocate reference card supplied by the project owner.
+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:
+
+| File | Derived how |
+|---|---|
+| `sage-index.json` | frame rectangles and gaze cells measured from the sheet |
+| `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 |
+
+**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.
+
+Attribution form:
+
+> Sage artwork — dsh-plugin-infj-pet — CC BY-NC-SA 4.0
+
+## Fonts
+
+No font is bundled. Every text surface uses the operating system's UI font stack
+(`system-ui` and the platform CJK faces), so nothing is downloaded at runtime and
+no font license travels with this package.
+
+## Personality-type notice
+
+INFJ and the Advocate / Counselor labels are popular-psychology vocabulary, not a
+clinical instrument. This plugin is a decorative companion inspired by the
+described traits; it does not assess, score, or diagnose anyone, and it is not
+affiliated with or endorsed by any personality-assessment publisher.

package/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+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.
+- 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**
+
+- **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.
+- **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.
+
+**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.
+- Bilingual (English / 简体中文), following the DSH language until you choose one.
+- Tuck away collapses the sage to a corner restore button.
+
+**Behaviour guarantees**
+
+- Celebration requires an observed rising edge of work, so an idle Host, a
+  reconnect, or a vanished session never produces a false win.
+- Subagent sessions are counted separately and never inflate your own workload.
+- A missing slot registry or store hook degrades to a static companion instead of
+  throwing into the session.
+
+**Packaging**
+
+- 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.

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 CN-Mg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The MIT license above covers the source code in this repository.
+
+The artwork in `assets/` and the character geometry in `lib/art.js` are licensed
+separately under CC BY-NC-SA 4.0. See ASSETS-LICENSE.md.

package/PROVENANCE.md

@@ -0,0 +1,44 @@
+# Sage
+
+Created and verified in Pets. Stable ID: pet_6ac7958fa51c8191bc6827eb0881645b.
+
+User request: create an animated pet based on the attached INFJ Advocate cartoon reference. The name Sage was inferred. The original angular green-robed elder identity, swept white hair, long white beard and dot eyes were preserved. Thin wand omitted for readable animation.
+
+Final transparent v2 sheet: `final/spritesheet-extended.png`, 1536x2288, 73 populated frames. Nine animation states and sixteen gaze directions. The pet has been added to the collection and can be selected in Pets.
+
+Artwork generated with built-in imagegen. Production prompts and revisions are in `prompts/`, inputs and identity references in `references/`, source strips in `decoded/`, and checks plus motion previews in `qa/`. Artifacts are stored locally because ChatGPT Library tools were unavailable. No temporary upload sessions or expiring download links are persisted as pet identity.
+
+The bundled structural and quality gates, Pets preflight, three isolated cardinal reviews and independent final visual review pass. Subtle intermediate tilts and minor wrap head-pose differences remain documented warnings; repaired torso widths and ground registration are steady. Jump peak lift is 44px and landing differs from idle baseline by 1px.
+
+Final byte SHA256: `58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1`.
+
+- [x] Getting Sage ready.
+- [x] Imagining Sage's main look.
+- [x] Picturing Sage's poses.
+- [x] Hatching Sage.
+
+---
+
+## What is published, and what is not
+
+The full generation workspace that produced this sheet is about 130 MB: source
+strips, per-frame decodes, QA renders, motion previews, and a vendored ffmpeg
+used by the preview tooling. None of that is needed to build or run the plugin,
+so it is not published here.
+
+Checked in instead, under ssets/provenance/:
+
+| File | Why it is kept |
+|---|---|
+| `sage-validation.json` | the sheet's structural report: grid, per-cell pixel counts, SHA-256 |
+| `sage-pet-record.json` | the pet's stable id, description and declared sheet hash |
+| `sage-README.md` | the generation summary as originally written |
+| `sage-base-prompt.md` | the production prompt for the character's main look |
+
+`tools/build-sage-index.mjs` reads that report and refuses to build when
+`assets/sage.png` does not hash to the value recorded in it, so the published
+artwork is provably the artwork that was validated.
+
+The workspace itself stays on the machine that generated it. If you need to
+reproduce it, the prompts under the original `Sage/prompts/` are the starting
+point; they are not part of this repository.

package/README.md

@@ -1,3 +1,256 @@
-# Temporary Holding Version
+# INFJ Sage · 贤者桌宠
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**A pixel-art INFJ companion that lives inside your DeepSeek Harness window.**
+
+一只住在 DSH 窗口里的 INFJ 贤者：陪你专注、等你决定，也陪你安静地打个盹。
+
+<p align="center">
+  <img src="assets/icon.png" width="120" alt="INFJ Sage icon">
+</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">
+</p>
+
+The sage is not a progress bar. It reads what your agents are already doing —
+working, waiting on you, resting — and answers with a small, quiet reaction in
+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.
+
+---
+
+## What it does
+
+| 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 |
+| 共情 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 |
+
+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.
+- **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.
+
+---
+
+## Install
+
+### 1. From npm
+
+```
+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`.
+
+### 2. From GitHub
+
+```
+github:CN-Mg/dsh_infj_pet
+```
+
+Or with a pinned tag:
+
+```
+github:CN-Mg/dsh_infj_pet#v1.0.0
+```
+
+The committed source already contains the built client bundle, so a Git install
+needs no build step.
+
+### 3. From a local folder
+
+Point the installer at the absolute path of this directory, or pack it first:
+
+```sh
+npm pack --ignore-scripts --pack-destination artifacts
+```
+
+After enabling the plugin, **fully quit DSH and reopen it**. Closing the window
+may not quit the application, and the browser bundle is only picked up on boot.
+
+To remove it: disable the row on the Plugins page, then uninstall the package.
+
+---
+
+## Using it
+
+- **Click** — a line of dialogue, different each time.
+- **Drag** — reposition; release near a side and it snaps to that edge.
+- **Right-click** — settings and pose preview.
+- **Keyboard** — `Tab` to the sage, `Enter`/`Space` to poke, `Esc` to close.
+- **Session scope** — *All sessions* counts ordinary sessions on the current
+  Host; *This session* follows only the one you are looking at. Child (subagent)
+  sessions are never counted as your sessions, so a delegated burst does not look
+  like your own work.
+- **Nap delay** — how long the sage stays quiet before it dozes off.
+- **Size** — 1×, 2×, or 3× the sprite's own pixels. Every size is a whole-number
+  multiple, because pixel art resampled at a fractional scale turns to mush.
+
+### Completion is never guessed
+
+The celebratory leap fires only on a **falling edge of work the sage actually
+watched running**. A page that loads into an already-idle Host, a dropped
+connection, or a session that simply disappears never produces a celebration.
+Cancelled and failed turns are not successes.
+
+---
+
+## Privacy and runtime boundaries
+
+- Reads session **identity and status** only — never message content, tool
+  arguments, or transcripts.
+- Makes **no model calls**, opens **no ports**, sends **no telemetry**, and
+  answers **no approvals** on your behalf.
+- Uses DSH's existing authenticated connection.
+- The sprite sheet is embedded in the bundle, so the plugin issues **no network
+  request at all**.
+- Preferences live in `localStorage` under `dsh-plugin-infj-pet:v1`.
+- Writes only to its own DOM nodes and to one `<style>` element it owns.
+- Does not modify DSH itself, and replaces no official component.
+
+---
+
+## Compatibility
+
+Developed against **DSH Desktop 0.2.x** using the documented client plugin
+contract:
+
+- client bundle registered through `window.__ModuleLoader__.load({ id, factory })`
+- one `shell.overlay` slot occupant (`id: infj-pet`, `order: 92`)
+- 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.
+
+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
+than throwing into your session.
+
+---
+
+## Development
+
+Requires Node.js 20 or newer. There are no dependencies to install.
+
+```sh
+npm run verify      # structural checks plus 43 tests
+npm test            # the test suite alone
+npm run check       # manifest, sheet, icon, bundle-drift and locale checks
+npm run build       # regenerate the index, icons, bundle and offline preview
+```
+
+### How the artwork is wired
+
+The character is one PNG sprite sheet: `assets/sage.png`, 1536×2288, an 8×11
+grid of 192×208 cells. Rows 0–8 are animations, rows 9–10 are sixteen head poses
+for gaze. Nothing about that layout is written down twice:
+
+```
+assets/provenance/sage-validation.json   the sheet's own validation report
+        │
+        ├─ tools/build-sage-index.mjs ─→ assets/sage-index.json   frames + gaze cells
+        │                                assets/sage.png.b64      payload for the bundle
+        ├─ tools/build-icons.mjs      ─→ assets/icon.png          plugin-manager icon
+        │                                assets/preview.png       the contact sheet above
+        └─ tools/build-bundle.mjs     ─→ lib/client.js            the shipped bundle
+```
+
+`tools/build-sage-index.mjs` measures the sheet with `tools/png.mjs` — a
+dependency-free PNG reader — and refuses to run if the file's SHA-256 does not
+match the hash recorded in the validation report. That is how the plugin proves
+it is shipping the artwork that was actually validated. The 130 MB generation
+workspace is not published; [PROVENANCE.md](PROVENANCE.md) says what is kept
+instead and why.
+
+### The bundle is generated
+
+`lib/client.js` cannot use ES imports at runtime; the browser module loader
+expects one self-contained lazy-CJS factory. So the bundle is assembled from
+plain-text regions in `lib/src/`:
+
+```
+lib/src/order.json      the concatenation order
+lib/src/header.mjs      bundle header and loader registration
+lib/src/constants.mjs   sizes, traits, dialogue, UI strings
+lib/src/helpers.mjs     clamp/pick/locale/store/viewport utilities
+lib/src/statePlan.mjs   semantic state -> sprite animation, and the timings
+lib/src/artwork.mjs     sheet lookup, gaze maths, frame geometry (templated)
+lib/src/sprite.mjs      motion policy and the frame ticker
+lib/src/behaviour.mjs   pure projection and the transition machine
+lib/src/styles.mjs      the stylesheet and generated keyframes
+lib/src/fallback.mjs    direct-mount path when the slot registry is absent
+lib/src/preferences.mjs persisted preference reader
+lib/src/componentHeader.mjs, companionHead.mjs, companionBody.mjs, panel.mjs
+lib/src/plugin.mjs      the Cordis plugin export
+```
+
+Edit those, then run `npm run bundle`. `tests/bundle.test.mjs` rebuilds the
+bundle and fails when `lib/client.js` disagrees with its sources, so the
+committed file can never drift.
+
+### Other layout
+
+```
+lib/index.js       Host half: read-only turn-boundary listener
+cordis.patch.yml   inserts exactly one plugin row
+locale/            plugin-manager title and description
+assets/            the sheet, its index, the icon, the contact sheet
+assets/provenance/ the validation report the build checks the sheet against
+PROVENANCE.md      what artwork provenance is published, and what is not
+tools/             generators, checker, preview builder, PNG reader
+tests/             Node test-runner suite with a small React harness
+```
+
+`tools/sage_contact.py` and `tools/sage_measure.py` rasterise the sheet for
+review outside DSH; they need Pillow and are development aids only.
+
+### Design notes
+
+- **Fail soft.** A missing slot registry falls back to a direct DOM mount; a
+  store hook that throws leaves a static but present companion.
+- **Never invent success.** The machine requires an observed rising edge before a
+  falling edge can celebrate.
+- **One artwork source.** Frames, gaze cells, the icon and the bundle are all
+  derived from the sheet, and every derivation is re-checked in CI.
+- **Integer pixels only.** Every frame offset and scale factor is a whole number,
+  asserted by a test, because that is what keeps the drawing crisp.
+- **Own your nodes.** No global mutation beyond the plugin's own style element
+  and its namespaced storage key.
+
+---
+
+## Credits and licenses
+
+- **Code:** [MIT](LICENSE).
+- **Artwork:** [CC BY-NC-SA 4.0](ASSETS-LICENSE.md) — share and adapt
+  non-commercially with attribution; separate from the code license.
+- The character was generated with a built-in image generator from the supplied
+  INFJ reference card; `Sage/README.md` records the pet's provenance and stable
+  id, and `Sage/prompts/` holds the production prompts.
+- No fonts are bundled; all text uses the platform UI font stack.
+- INFJ and *Advocate* / *Counselor* are popular-psychology vocabulary, not a
+  clinical instrument. This plugin is decorative, assesses no one, and is
+  affiliated with no personality-assessment publisher.
+
+This is a personal project, not an official DeepSeek product. It does not
+represent DeepSeek's views or endorsement.

package/assets/provenance/sage-README.md

@@ -0,0 +1,18 @@
+# Sage
+
+Created and verified in Pets. Stable ID: pet_6ac7958fa51c8191bc6827eb0881645b.
+
+User request: create an animated pet based on the attached INFJ Advocate cartoon reference. The name Sage was inferred. The original angular green-robed elder identity, swept white hair, long white beard and dot eyes were preserved. Thin wand omitted for readable animation.
+
+Final transparent v2 sheet: `final/spritesheet-extended.png`, 1536x2288, 73 populated frames. Nine animation states and sixteen gaze directions. The pet has been added to the collection and can be selected in Pets.
+
+Artwork generated with built-in imagegen. Production prompts and revisions are in `prompts/`, inputs and identity references in `references/`, source strips in `decoded/`, and checks plus motion previews in `qa/`. Artifacts are stored locally because ChatGPT Library tools were unavailable. No temporary upload sessions or expiring download links are persisted as pet identity.
+
+The bundled structural and quality gates, Pets preflight, three isolated cardinal reviews and independent final visual review pass. Subtle intermediate tilts and minor wrap head-pose differences remain documented warnings; repaired torso widths and ground registration are steady. Jump peak lift is 44px and landing differs from idle baseline by 1px.
+
+Final byte SHA256: `58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1`.
+
+- [x] Getting Sage ready.
+- [x] Imagining Sage's main look.
+- [x] Picturing Sage's poses.
+- [x] Hatching Sage.

package/assets/provenance/sage-base-prompt.md

@@ -0,0 +1,7 @@
+Create one clean full-body reference sprite for ChatGPT pet Sage.
+
+Pet identity: INFJ Advocate elder from user reference. Compact angular polygon cartoon; warm peach face, short swept white hair, long white beard, olive and light green robes, teal lapel trim, teal boots. Gentle thoughtful expressions, visible dark green dot eyes and angular nose. Keep robe symmetrical and omit thin wand for readable uncluttered animation. Head and beard naturally lead gaze with torso and feet anchored..
+Style: Pet-safe sprite: compact full-body mascot, readable in a 192x208 cell, clear silhouette, simple face, stable palette/materials, and crisp edges for chroma-key extraction. Style `flat-vector`: Flat vector-style mascot with simple geometric forms, crisp color areas, clean outline, and minimal shading.
+
+
+Place a single centered pose on a perfectly flat pure user-selected #FF00FF chroma-key background. Keep the full pet visible, compact, readable at 192x208, and easy to animate. Preserve approved reference identity cues. No scenery, text, borders, checkerboard transparency, shadows, glows, detached effects, or extra props. Keep #FF00FF and close colors out of the pet, props, highlights, and effects.

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

@@ -0,0 +1,16 @@
+{
+  "pet_id": "pet_6ac7958fa51c8191bc6827eb0881645b",
+  "name": "Sage",
+  "description": "A gentle INFJ sage in green robes, with a white beard and a thoughtful heart.",
+  "is_custom": true,
+  "is_active": false,
+  "active_pet_id": "default",
+  "verified_in_pets": true,
+  "spritesheet": "assets/sage.png",
+  "sha256": "58deaf03132eee98634d101661682c1faf45906186bea30e7aa0f951f32631d1",
+  "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."
+}