@mean-weasel/lineage 0.1.2 → 0.1.3

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,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.1.3
4
+
5
+ - Add a managed Swissifier rich-demo media download flow that verifies the release archive and restored PNG checksums before loading the demo.
6
+ - Add durable local startup helpers and default Lineage CLI hosts for `lineage.localhost` and `lineage-dev.localhost`.
7
+ - Ship the lightweight Swissifier fixture manifest while keeping generated demo media outside git and package contents.
8
+
3
9
  ## 0.1.2
4
10
 
5
11
  - Fix packaged Lineage handoff commands so copied `next`, `inspect`, and `link-child` commands run through the published package.
package/README.md CHANGED
@@ -34,12 +34,26 @@ lineage start
34
34
  lineage-dev start
35
35
  ```
36
36
 
37
- By default, `lineage start` listens on `127.0.0.1:5197` and stores SQLite state in a stable Lineage runtime directory. `lineage-dev start` listens on `127.0.0.1:5198` and uses a separate development SQLite file. Override those defaults with `--port`, `--host`, `--db`, or `LINEAGE_HOME`:
37
+ By default, `lineage start` listens on `lineage.localhost:5197` and stores SQLite state in a stable Lineage runtime directory. `lineage-dev start` listens on `lineage-dev.localhost:5198` and uses a separate development SQLite file. Override those defaults with `--port`, `--host`, `--db`, or `LINEAGE_HOME`:
38
38
 
39
39
  ```bash
40
40
  lineage start --port 6123 --db ~/.lineage/lineage.sqlite
41
41
  ```
42
42
 
43
+ ## Codex Plugin
44
+
45
+ The versioned Codex plugin lives in `plugins/lineage-codex-plugin`. Install the
46
+ plugin that matches the resolved `@mean-weasel/lineage` package version with:
47
+
48
+ ```bash
49
+ npx @mean-weasel/lineage-plugin-installer install --channel latest
50
+ ```
51
+
52
+ The installer verifies the plugin artifact checksum and rejects plugin manifests
53
+ whose version or `lineage.version` does not exactly match the resolved Lineage
54
+ package version. The plugin artifact and installer package are released from
55
+ this public repository.
56
+
43
57
  ## Local Development
44
58
 
45
59
  ```bash
@@ -50,6 +64,23 @@ npm run ci
50
64
 
51
65
  `npm run dev` starts the local development server from source. `npm run ci` runs the full local verification gate.
52
66
 
67
+ ## Command Shortcuts
68
+
69
+ The root `Makefile` provides memorable wrappers for common setup, startup, and
70
+ verification commands. Run `make` or `make help` to list the available targets.
71
+
72
+ ```bash
73
+ make install-prod
74
+ make install-plugin-prod
75
+ make start-prod
76
+ make check
77
+ make smoke
78
+ ```
79
+
80
+ The Makefile is only a convenience layer. npm scripts, the packaged CLIs, and
81
+ GitHub release workflows remain the source of truth for build, test, and release
82
+ behavior.
83
+
53
84
  ## Release Checks
54
85
 
55
86
  Use `next` for candidate builds and `latest` for the stable public channel. Check the current local, npm, and workflow state with:
@@ -83,6 +114,20 @@ Source checkouts and installed packages include a synthetic public demo catalog
83
114
 
84
115
  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.
85
116
 
117
+ 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.
118
+
119
+ 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.
120
+
121
+ For manual verification or offline restore, the expected archive checksum is:
122
+
123
+ ```sh
124
+ shasum -a 256 swissifier-rich-demo-v1.tar.gz
125
+ ```
126
+
127
+ `24edc5307d0932ddc8a151c6a8c1001a08c45075e3ae198082038c44519be0de`
128
+
129
+ The previous manual path remains available: unpack the media pack yourself, set `LINEAGE_SWISSIFIER_MEDIA_DIR` to that folder, then use the Demo seed menu to restore media and load Swissifier.
130
+
86
131
  ## Data And Privacy
87
132
 
88
133
  Lineage stores local workspace state in a SQLite database on your machine. Public fixtures are synthetic and must not contain private names, credentials, presigned URLs, real customer content, private campaign data, or real media. Keep private catalogs and media outside public package fixtures.
@@ -1222,7 +1222,7 @@ function resolveStartOptions(config, args) {
1222
1222
  }
1223
1223
  return {
1224
1224
  dbPath: readOption(args, "--db") || process.env.LINEAGE_DB || join5(runtimeDir, `${config.binName}.sqlite`),
1225
- host: readOption(args, "--host") || process.env.HOST || "127.0.0.1",
1225
+ host: readOption(args, "--host") || process.env.HOST || config.defaultHost,
1226
1226
  json: args.includes("--json"),
1227
1227
  open: args.includes("--open"),
1228
1228
  port
@@ -1409,5 +1409,5 @@ function runLineageCli(config, args = process.argv.slice(2)) {
1409
1409
  }
1410
1410
 
1411
1411
  // src/cli/lineage-dev.ts
1412
- runLineageCli({ binName: "lineage-dev", channel: "development", defaultPort: 5198, displayName: "Lineage Dev" });
1412
+ runLineageCli({ binName: "lineage-dev", channel: "development", defaultHost: "lineage-dev.localhost", defaultPort: 5198, displayName: "Lineage Dev" });
1413
1413
  //# sourceMappingURL=lineage-dev.js.map