@mean-weasel/lineage 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.7
+
+- Add a claim-aware lineage task queue for per-image iteration and re-roll work, including task instructions, comments, cancellation, and human override controls.
+- Add visible agent/task state in the lineage canvas and side panel so humans can see when a task is pending, locked, or actively claimed.
+- Add QA seed guardrails that distinguish basic SVG placeholder media from the Swissifier rich PNG demo seed.
+- Add deterministic rich-seed verification and browser coverage to fail when QA is pointed at the wrong seed or invisible placeholder previews.
+
+## 0.1.6
+
+- Add per-image re-roll attempt history with stack inspection, previous-attempt selection, and promotion back to the current/top attempt.
+- Add CLI and agent-facing re-roll commands for marking, listing, planning, importing, and cancelling one job per target image.
+- Package public-safe Swissifier re-roll PNG fixtures and manifest metadata so the demo canvas shows multi-attempt nodes out of the box.
+- Harden project switching, lineage workspace fallback, and backend attempt invariants around re-roll histories.
+
 ## 0.1.5
 
 - Add graph orientation controls for lineage views and CLI flows, including browser coverage for orientation behavior.

package/README.md

@@ -68,6 +68,37 @@ lineage link-child --project demo-project --root <root-asset-id> --child <child-
 lineage agent release --claim-token "$LINEAGE_CLAIM_TOKEN" --json
 ```
 
+`lineage link-child` creates a new visible descendant in the lineage graph. Do
+not use it for re-rolls.
+
+For re-roll work, mark the target, have the agent plan/import one replacement
+attempt, and cancel only when the request should be abandoned:
+
+```bash
+lineage reroll mark --project demo-project --root <root-asset-id> --target <target-asset-id> --notes "Fix distorted text" --confirm-write --json
+lineage reroll list --project demo-project --root <root-asset-id> --json
+lineage reroll plan --project demo-project --root <root-asset-id> --target <target-asset-id> --prompt "Regenerate with clean readable text" --json
+lineage reroll import --project demo-project --job-id <job-id> --file <.asset-scratch-file> --confirm-write --json
+lineage reroll cancel --project demo-project --root <root-asset-id> --target <target-asset-id> --confirm-write --json
+```
+
+`lineage reroll import` updates the target node's current attempt and should
+not add a visible child edge.
+
+Lineage task queue commands expose the same work as explicit tasks that agents
+can inspect, claim, start, comment on, and cancel:
+
+```bash
+lineage tasks list --project demo-project --root <root-asset-id> --json
+lineage tasks inspect --project demo-project --task <task-id> --json
+lineage tasks claim --project demo-project --task <task-id> --agent-name "Task worker" --json
+lineage tasks start --project demo-project --task <task-id> --claim-token "$LINEAGE_CLAIM_TOKEN" --json
+lineage tasks comment --project demo-project --task <task-id> --message "Blocked on source art review." --json
+lineage tasks cancel --project demo-project --task <task-id> --confirm-write --override --json
+lineage tasks instructions --project demo-project --task <task-id> --instructions "Preserve palette; replace unreadable text." --json
+lineage tasks override --project demo-project --task <task-id> --reason "Human is reassigning the work." --instructions "Use the updated brief." --json
+```
+
 The app-created claim-aware handoff packet includes the same token export,
 heartbeat, inspect, and write commands. Raw claim tokens are not shown in the
 read-only Agents view.
@@ -155,11 +186,13 @@ Source checkouts and installed packages include a synthetic public demo catalog
 
 If you create a real `demo-project/assets/catalog.json`, that root project catalog overrides the packaged fixture. The fixture keeps S3-shaped metadata for realistic catalog structure, but default previews are generated local SVG data URLs and do not call storage.
 
-Lineage also includes a lightweight Swissifier rich-demo manifest at `fixtures/demo-project/lineage/swissifier-rich-demo.json`. The manifest stores only synthetic metadata, checksums, graph edges, layout positions, and selected next-variation bases. It does not include generated PNG media or any local SQLite state.
+Lineage also includes a lightweight Swissifier rich-demo manifest at `fixtures/demo-project/lineage/swissifier-rich-demo.json`. The manifest stores only synthetic metadata, checksums, graph edges, layout positions, and selected next-variation bases. It does not include local SQLite state.
+
+The package intentionally includes three public-safe synthetic Swissifier re-roll PNG fixtures in `fixtures/demo-project/lineage/swissifier-rerolls/`. They are the only generated PNG media committed with the rich demo, and each file is pinned in the manifest by filename, SHA-256, size, content type, prompt, and demo generation job id so public-readiness and package-smoke checks can prove the fixture is hermetic.
 
 To hydrate the Swissifier demo with real images, use the Demo seed menu's Swissifier `Download media` control. Lineage downloads `swissifier-rich-demo-v1.tar.gz` from the [v0.1.2 GitHub release](https://github.com/mean-weasel/lineage/releases/tag/v0.1.2), verifies the archive checksum, safely unpacks the PNGs into local scratch storage, and then verifies each PNG checksum before loading the rich demo.
 
-Future rich-demo media packs should follow the same split: commit only the lightweight manifest changes, attach the generated media archive to the GitHub release for the app version that first references that archive, then pin the public release URL, archive size, and SHA-256 in the manifest. If a later app release reuses an unchanged media pack, keep the manifest pointed at the original release asset instead of duplicating the archive.
+Future rich-demo media packs should follow the same split unless a small synthetic media exception is explicitly documented and manifest-pinned like the packaged re-roll PNGs: commit lightweight manifest changes, attach generated media archives to the GitHub release for the app version that first references them, then pin the public release URL, archive size, and SHA-256 in the manifest. If a later app release reuses an unchanged media pack, keep the manifest pointed at the original release asset instead of duplicating the archive.
 
 For manual verification or offline restore, the expected archive checksum is: