@mean-weasel/lineage 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.6
4
+
5
+ - Add per-image re-roll attempt history with stack inspection, previous-attempt selection, and promotion back to the current/top attempt.
6
+ - Add CLI and agent-facing re-roll commands for marking, listing, planning, importing, and cancelling one job per target image.
7
+ - Package public-safe Swissifier re-roll PNG fixtures and manifest metadata so the demo canvas shows multi-attempt nodes out of the box.
8
+ - Harden project switching, lineage workspace fallback, and backend attempt invariants around re-roll histories.
9
+
10
+ ## 0.1.5
11
+
12
+ - Add graph orientation controls for lineage views and CLI flows, including browser coverage for orientation behavior.
13
+ - Improve agent claim visibility with workspace/content occupancy badges, claim lifecycle controls, and release claim smoke coverage.
14
+ - Harden lineage claim enforcement for explicit child workspaces and `project_channel` claims so scoped claims cannot authorize broader writes.
15
+ - Make local startup helpers durable with tmux-backed Makefile commands.
16
+
3
17
  ## 0.1.4
4
18
 
5
19
  - Implement target-scoped agent claims for lineage and content-post agent writes, including claim lifecycle CLI/API commands, heartbeat/release/revoke/transfer controls, and token-redacted read APIs.
package/README.md CHANGED
@@ -54,6 +54,12 @@ lineage agent claim --project demo-project --scope lineage_workspace --target de
54
54
  export LINEAGE_CLAIM_TOKEN='claim_abc.secret_xyz'
55
55
  ```
56
56
 
57
+ Agents can inspect the current lineage graph without a claim:
58
+
59
+ ```bash
60
+ lineage agent graph --project demo-project --root <root-asset-id> --json
61
+ ```
62
+
57
63
  Keep the claim fresh and pass it to mutating commands:
58
64
 
59
65
  ```bash
@@ -62,6 +68,17 @@ lineage link-child --project demo-project --root <root-asset-id> --child <child-
62
68
  lineage agent release --claim-token "$LINEAGE_CLAIM_TOKEN" --json
63
69
  ```
64
70
 
71
+ For re-roll work, mark the target, have the agent plan/import one replacement
72
+ attempt, and cancel only when the request should be abandoned:
73
+
74
+ ```bash
75
+ lineage reroll mark --project demo-project --root <root-asset-id> --target <target-asset-id> --notes "Fix distorted text" --confirm-write --json
76
+ lineage reroll list --project demo-project --root <root-asset-id> --json
77
+ lineage reroll plan --project demo-project --root <root-asset-id> --target <target-asset-id> --prompt "Regenerate with clean readable text" --json
78
+ lineage reroll import --project demo-project --job-id <job-id> --file <.asset-scratch-file> --confirm-write --json
79
+ lineage reroll cancel --project demo-project --root <root-asset-id> --target <target-asset-id> --confirm-write --json
80
+ ```
81
+
65
82
  The app-created claim-aware handoff packet includes the same token export,
66
83
  heartbeat, inspect, and write commands. Raw claim tokens are not shown in the
67
84
  read-only Agents view.
@@ -127,12 +144,13 @@ For local release validation:
127
144
 
128
145
  ```bash
129
146
  npm run release:dry-run -- --tag next
147
+ npm run release:claim-smoke -- --package @mean-weasel/lineage@next
130
148
  npm run release:next
131
149
  npm run release:dry-run -- --tag latest
132
150
  npm run release:latest
133
151
  ```
134
152
 
135
- The release script verifies package metadata, changelog version coverage, public-readiness scans, install smoke, browser smoke, audit, and package contents before publishing. GitHub Actions runs CI on pull requests and `main`; publishing is manual through the Release workflow.
153
+ The release script verifies package metadata, changelog version coverage, public-readiness scans, install smoke, browser smoke, audit, and package contents before publishing. Promotion also installs the candidate package and runs a claim lifecycle smoke that creates a target claim, proves missing-token writes fail, proves matching-token writes succeed, verifies read surfaces do not expose the raw token, and proves release invalidates the token. GitHub Actions runs CI on pull requests and `main`; publishing is manual through the Release workflow.
136
154
 
137
155
  Use the Release workflow operations this way:
138
156
 
@@ -148,11 +166,13 @@ Source checkouts and installed packages include a synthetic public demo catalog
148
166
 
149
167
  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.
150
168
 
151
- 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.
169
+ 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.
170
+
171
+ 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.
152
172
 
153
173
  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.
154
174
 
155
- 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.
175
+ 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.
156
176
 
157
177
  For manual verification or offline restore, the expected archive checksum is:
158
178