@mean-weasel/lineage 0.1.22 → 0.1.23

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## Unreleased
+
+## 0.1.23
+
+- Make missing Codex CLI failures explain how to restore `PATH`, verify `npx` and Codex prerequisites explicitly, and gate releases on compatibility with the independently published plugin installer.
+- Add a reusable Lineage showcase cover and refine its presentation without browser text-selection artifacts.
+- Show absolute local paths in asset details while preserving safe relative paths in persisted lineage data.
+- Add the public documentation hub, freshness checks, CI routing, and GitHub Pages deployment workflow.
+- Refresh vulnerable transitive dependencies for `brace-expansion`, `postcss`, and `nanoid`.
+
 ## 0.1.22
 
 - Harden the landing page, README, and packaged manual dogfood guide with fail-fast first-run commands that complete the post-initialization runtime, profile, database, and service identity gate.

package/MANUAL_INSTALL_DOGFOOD.md

@@ -72,6 +72,7 @@ Record the prerequisites and registry selection:
 ```bash
 run_lineage_dogfood node --version
 run_lineage_dogfood npm --version
+run_lineage_dogfood npx --version
 run_lineage_dogfood codex --version
 run_lineage_dogfood npm view @mean-weasel/lineage dist-tags version engines --json
 ```

package/README.md

@@ -59,14 +59,17 @@ Before installing anything, verify the tools used by the path you choose:
 ```bash
 node --version
 npm --version
+npx --version
 make --version
 ```
 
-Lineage requires Node.js 22.22.0 or newer and npm. Make is required only for
-the documented `make` shortcuts. A real Codex installation is optional for the
-app, but required to install and activate the Codex plugin; verify that
-additional prerequisite with `codex --version` before following the plugin
-step.
+Lineage requires Node.js 22.22.0 or newer and npm, including the accompanying
+`npx` command used by the plugin installer. Make is required only for the
+documented `make` shortcuts. A real Codex installation is optional for the app,
+but required to install and activate the Codex plugin; verify that additional
+prerequisite with `codex --version` in the same shell before following the
+plugin step. If either command is missing, restore its executable directory on
+`PATH` before installing.
 
 On the minimum supported Node 22 line, foreground startup can print one
 `ExperimentalWarning` for Node's built-in SQLite module before the healthy

package/dist/cli/lineage-dev.js

@@ -4,7 +4,7 @@
 import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { homedir as homedir2, platform as platform2 } from "node:os";
-import { dirname as dirname6, join as join10, resolve as resolve8 } from "node:path";
+import { dirname as dirname6, join as join10, resolve as resolve9 } from "node:path";
 import { spawn } from "node:child_process";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
@@ -2810,7 +2810,7 @@ function validateAgentClaimForWrite(fields) {
 }
 
 // src/server/assetLineage.ts
-import { join as join7 } from "node:path";
+import { isAbsolute as isAbsolute2, join as join7, resolve as resolve5 } from "node:path";
 
 // src/server/assetLineageSelection.ts
 function selectedRows(database, project, root) {
@@ -3515,6 +3515,11 @@ function collectAssets(project, source) {
   }
   return assets;
 }
+function absoluteLocalPath(localPath) {
+  if (!localPath) return void 0;
+  if (isAbsolute2(localPath)) return localPath;
+  return resolve5(repoRoot, ".asset-scratch", localPath);
+}
 function upsertProject(database, project) {
   const timestamp = nowIso();
   database.prepare(`
@@ -3929,6 +3934,7 @@ function getLineageSnapshot(project, assetId) {
     const lineageTasks = lineageTasksByNode.get(row.asset_id);
     return {
       ...node,
+      absolute_path: absoluteLocalPath(row.local_path),
       attempt_count: attempts.length,
       current_attempt: currentAttempt,
       is_latest: !childIds.has(row.asset_id),
@@ -4361,7 +4367,7 @@ function linkSelectedLineageChild(project, fields) {
 
 // src/server/generationReceipts.ts
 import { existsSync as existsSync8, realpathSync as realpathSync2, statSync as statSync4 } from "node:fs";
-import { relative as relative3, resolve as resolve5 } from "node:path";
+import { relative as relative3, resolve as resolve6 } from "node:path";
 import { randomUUID as randomUUID3 } from "node:crypto";
 
 // src/shared/generationOutputManifest.ts
@@ -4896,8 +4902,8 @@ function isPathInside(child, parent) {
   return Boolean(rel) && !rel.startsWith("..") && !rel.startsWith("/");
 }
 function scratchCandidate(file) {
-  const scratchRoot = resolve5(repoRoot, ".asset-scratch");
-  const candidate = file.startsWith(".asset-scratch/") || resolve5(file).startsWith(scratchRoot) ? resolve5(repoRoot, file) : resolve5(scratchRoot, file);
+  const scratchRoot = resolve6(repoRoot, ".asset-scratch");
+  const candidate = file.startsWith(".asset-scratch/") || resolve6(file).startsWith(scratchRoot) ? resolve6(repoRoot, file) : resolve6(scratchRoot, file);
   if (!isPathInside(candidate, scratchRoot)) throw new GenerationReceiptError(`Import file must be under .asset-scratch: ${file}`);
   return { candidate, scratchRoot };
 }
@@ -5152,7 +5158,7 @@ function importImageRerollOutput(project = defaultProject, fields) {
 // src/server/lineageSelectionPacket.ts
 import { createHash as createHash5 } from "node:crypto";
 import { existsSync as existsSync9, statSync as statSync5 } from "node:fs";
-import { isAbsolute as isAbsolute2, resolve as resolve6 } from "node:path";
+import { isAbsolute as isAbsolute3, resolve as resolve7 } from "node:path";
 var LineageSelectionPacketError = class extends Error {
   constructor(message, warnings = [], errors = [], diagnostics = []) {
     super(message);
@@ -5198,10 +5204,10 @@ function resolveWorkspace(project, options) {
 }
 function resolveLocalReference(reference) {
   if (!reference) return void 0;
-  if (isAbsolute2(reference)) return reference;
-  const repoRelative = resolve6(repoRoot, reference);
+  if (isAbsolute3(reference)) return reference;
+  const repoRelative = resolve7(repoRoot, reference);
   if (existsSync9(repoRelative)) return repoRelative;
-  return resolve6(repoRoot, ".asset-scratch", reference);
+  return resolve7(repoRoot, ".asset-scratch", reference);
 }
 function fileSize(path) {
   if (!path || !existsSync9(path)) return void 0;
@@ -5656,7 +5662,7 @@ function getLineageSelectionPacket(project, options = {}) {
 import { createHash as createHash6 } from "node:crypto";
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { existsSync as existsSync10, lstatSync as lstatSync3, readFileSync as readFileSync5, readdirSync as readdirSync3, readlinkSync, realpathSync as realpathSync3, statSync as statSync6 } from "node:fs";
-import { dirname as dirname5, isAbsolute as isAbsolute3, join as join9, resolve as resolve7 } from "node:path";
+import { dirname as dirname5, isAbsolute as isAbsolute4, join as join9, resolve as resolve8 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/shared/runtimeInfoTypes.ts
@@ -5675,7 +5681,7 @@ function isLineagePackageRoot(root) {
 }
 function executingCodeRoot() {
   const moduleDirectory = dirname5(fileURLToPath2(import.meta.url));
-  const candidates = [resolve7(moduleDirectory, "../.."), resolve7(moduleDirectory, "..")];
+  const candidates = [resolve8(moduleDirectory, "../.."), resolve8(moduleDirectory, "..")];
   const root = candidates.find(isLineagePackageRoot);
   if (!root) throw new Error(`Unable to derive Lineage code root from executing module ${fileURLToPath2(import.meta.url)}`);
   return canonicalRoot(root);
@@ -5688,7 +5694,7 @@ function canonicalRoot(root) {
   try {
     return realpathSync3(root);
   } catch {
-    return resolve7(root);
+    return resolve8(root);
   }
 }
 function packageInfo(root = codeRoot) {
@@ -5788,7 +5794,7 @@ function readInstallReceipt(path, errors) {
     return void 0;
   }
   let receipt;
-  const receiptPath = resolve7(path);
+  const receiptPath = resolve8(path);
   try {
     receipt = JSON.parse(readFileSync5(receiptPath, "utf8"));
   } catch (error) {
@@ -5796,7 +5802,7 @@ function readInstallReceipt(path, errors) {
     return void 0;
   }
   if (receipt.schema_version !== lineageRuntimeInstallSchemaVersion) errors.push(`Unsupported runtime install receipt schema: ${String(receipt.schema_version)}`);
-  if (!isAbsolute3(receipt.package_root || "")) errors.push("Runtime install receipt package_root must be absolute");
+  if (!isAbsolute4(receipt.package_root || "")) errors.push("Runtime install receipt package_root must be absolute");
   if (!receipt.package_integrity?.startsWith("sha512-")) errors.push("Runtime install receipt package integrity is invalid");
   if (receipt.package_source !== "registry" && receipt.package_source !== "local") errors.push("Runtime install receipt package source is invalid");
   if (typeof receipt.package_spec !== "string" || !receipt.package_spec) errors.push("Runtime install receipt package spec is invalid");
@@ -6074,7 +6080,7 @@ var signalExitCodes = {
   SIGTERM: 143
 };
 function packageRoot2() {
-  return resolve8(dirname6(fileURLToPath3(import.meta.url)), "..", "..");
+  return resolve9(dirname6(fileURLToPath3(import.meta.url)), "..", "..");
 }
 function packageVersion() {
   try {
@@ -6113,7 +6119,7 @@ function readOptions(args, name) {
 }
 function readJsonFile(path, label) {
   try {
-    return JSON.parse(readFileSync6(resolve8(path), "utf8"));
+    return JSON.parse(readFileSync6(resolve9(path), "utf8"));
   } catch (error) {
     throw new Error(`${label} must be a readable JSON file: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
   }
@@ -6157,7 +6163,7 @@ function resolveStartOptions(config, args) {
   };
 }
 function resolveCliAssetRoot(args) {
-  return resolve8(readOption(args, "--asset-root") || process.env.LINEAGE_ASSET_ROOT || packageRoot);
+  return resolve9(readOption(args, "--asset-root") || process.env.LINEAGE_ASSET_ROOT || packageRoot);
 }
 function configureCliAssetRoot(args) {
   const assetRoot = resolveCliAssetRoot(args);
@@ -6189,10 +6195,10 @@ function prepareCliProfile(config, args) {
   if (hasOption(args, "--db")) throw new Error("A named profile cannot be combined with --db");
   if (hasOption(args, "--asset-root")) throw new Error("A named profile cannot be combined with --asset-root");
   const profile = resolveLineageProfile(selector);
-  if (process.env.LINEAGE_DB && resolve8(process.env.LINEAGE_DB) !== profile.database_path) {
+  if (process.env.LINEAGE_DB && resolve9(process.env.LINEAGE_DB) !== profile.database_path) {
     throw new Error(`Profile ${profile.profile_id} database_path conflicts with LINEAGE_DB`);
   }
-  if (process.env.LINEAGE_ASSET_ROOT && resolve8(process.env.LINEAGE_ASSET_ROOT) !== profile.asset_root) {
+  if (process.env.LINEAGE_ASSET_ROOT && resolve9(process.env.LINEAGE_ASSET_ROOT) !== profile.asset_root) {
     throw new Error(`Profile ${profile.profile_id} asset_root conflicts with LINEAGE_ASSET_ROOT`);
   }
   assertProfileChannel(profile, config.channel);
@@ -6293,7 +6299,7 @@ function lineageServiceIdentityErrors(runtime, expected) {
   if (runtime.channel !== expected.channel) errors.push(`channel ${runtime.channel} != ${expected.channel}`);
   if (!runtime.code?.verified) errors.push("service code identity is not verified");
   if (runtime.code?.fingerprint !== expected.code_fingerprint) errors.push(`code fingerprint ${runtime.code?.fingerprint || "missing"} != ${expected.code_fingerprint}`);
-  if (resolve8(runtime.database.path) !== resolve8(expected.database_path)) errors.push(`database ${runtime.database.path} != ${expected.database_path}`);
+  if (resolve9(runtime.database.path) !== resolve9(expected.database_path)) errors.push(`database ${runtime.database.path} != ${expected.database_path}`);
   if (runtime.service?.instance_id !== expected.instance_id) errors.push(`service instance ${runtime.service?.instance_id || "missing"} != ${expected.instance_id}`);
   if (runtime.service?.launcher_pid !== expected.launcher_pid) errors.push(`launcher pid ${runtime.service?.launcher_pid || "missing"} != ${expected.launcher_pid}`);
   if (expected.profile) {
@@ -6388,7 +6394,7 @@ function runLineageDataCommand(command, args) {
     });
     const out = readOption(args, "--out");
     if (out) {
-      const outPath = resolve8(out);
+      const outPath = resolve9(out);
       mkdirSync6(dirname6(outPath), { recursive: true });
       writeFileSync4(outPath, `${JSON.stringify(packet, null, 2)}
 `);