@mean-weasel/lineage 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.11
+
+- Add `--asset-root` / `LINEAGE_ASSET_ROOT` so installed Lineage packages can use external project catalogs and local media independently from the SQLite path.
+- Show the active asset root in CLI startup, `db info`, and Settings alongside the active SQLite identity.
+- Extend the packed-tarball smoke to prove an unrelated npm consumer can start Lineage and export a real external-project selection packet.
+
+## 0.1.10
+
+- Fix `lineage db info` so installed CLI checks use the same stable/dev runtime SQLite defaults as `lineage start`.
+
 ## 0.1.9
 
 - Add runtime identity diagnostics in Settings so operators can see the active channel, version, Git SHA when available, SQLite path, and database counts.

package/README.md

@@ -38,9 +38,16 @@ lineage-dev start
 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`:
 
 ```bash
-lineage start --port 6123 --db ~/.lineage/lineage.sqlite
+lineage start --port 6123 --db ~/.lineage/lineage.sqlite --asset-root /absolute/path/to/asset-repo
 ```
 
+`--db` selects the SQLite state file. `--asset-root` (or
+`LINEAGE_ASSET_ROOT`) independently selects the external repository root that
+contains `<project>/assets/catalog.json` and `.asset-scratch` media. Keep these
+arguments explicit when Lineage is installed as a dependency of another repo;
+the installed package directory remains responsible only for bundled code,
+web assets, and public demo fixtures.
+
 ## Runtime Channels and SQLite
 
 Lineage treats app code channels and local SQLite data as separate concerns:
@@ -89,7 +96,9 @@ Agents can also export the current active workspace selection as a durable JSON
 packet for downstream tools such as GrowthOps:
 
 ```bash
-lineage selection packet --project demo-project --channel linkedin --campaign 2026-07-launch --out ./lineage-selection-packet.json --json
+lineage selection packet --project demo-project --channel linkedin --campaign 2026-07-launch \
+  --db /absolute/path/to/lineage.sqlite --asset-root /absolute/path/to/asset-repo \
+  --out ./lineage-selection-packet.json --json
 ```
 
 The packet is schema-versioned as `lineage.selection_packet.v1` and includes the

package/dist/cli/lineage-dev.js

@@ -289,7 +289,7 @@ function isPackageRoot(path) {
     return false;
   }
 }
-function resolveRepoRoot() {
+function resolvePackageRoot() {
   const moduleDir = dirname2(fileURLToPath(import.meta.url));
   const candidates = [
     process.env.LINEAGE_REPO_ROOT,
@@ -301,7 +301,12 @@ function resolveRepoRoot() {
   if (!root) throw new Error("Unable to locate Lineage package root");
   return root;
 }
-var repoRoot = resolveRepoRoot();
+var packageRoot = resolvePackageRoot();
+var repoRoot = resolve2(process.env.LINEAGE_ASSET_ROOT || packageRoot);
+function setLineageAssetRoot(path) {
+  repoRoot = resolve2(path || packageRoot);
+  return repoRoot;
+}
 var defaultProject = "demo-project";
 var defaultProduct = process.env.LINEAGE_DEFAULT_PRODUCT || defaultProject;
 var publicFallbackBucket = "lineage-demo-assets";
@@ -326,7 +331,7 @@ function catalogPath(project = defaultProject) {
   return join3(repoRoot, cleanProject(project), "assets", "catalog.json");
 }
 function fixtureCatalogPath(project = defaultProject) {
-  return join3(repoRoot, "fixtures", cleanProject(project), "assets", "catalog.json");
+  return join3(packageRoot, "fixtures", cleanProject(project), "assets", "catalog.json");
 }
 function resolvedCatalogPath(project = defaultProject) {
   const path = catalogPath(project);
@@ -588,7 +593,7 @@ function nowIso() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function lineageDbPath() {
-  return process.env.LINEAGE_DB || join4(repoRoot, ".lineage", "asset-lineage.sqlite");
+  return process.env.LINEAGE_DB || join4(packageRoot, ".lineage", "asset-lineage.sqlite");
 }
 function lineageDb() {
   mkdirSync3(join4(lineageDbPath(), ".."), { recursive: true });
@@ -3601,7 +3606,7 @@ import { join as join6 } from "node:path";
 var require3 = createRequire2(import.meta.url);
 function packageInfo() {
   try {
-    const info = JSON.parse(readFileSync3(join6(repoRoot, "package.json"), "utf8"));
+    const info = JSON.parse(readFileSync3(join6(packageRoot, "package.json"), "utf8"));
     return { name: info.name || "@mean-weasel/lineage", version: info.version || "0.0.0" };
   } catch {
     return { name: "@mean-weasel/lineage", version: "0.0.0" };
@@ -3617,8 +3622,8 @@ function normalizeRuntimeChannel(value) {
 function gitSha() {
   const envSha = process.env.LINEAGE_GIT_SHA || process.env.GITHUB_SHA;
   if (envSha) return envSha.slice(0, 40);
-  if (!existsSync6(join6(repoRoot, ".git"))) return void 0;
-  const result = spawnSync2("git", ["rev-parse", "--short=12", "HEAD"], { cwd: repoRoot, encoding: "utf8" });
+  if (!existsSync6(join6(packageRoot, ".git"))) return void 0;
+  const result = spawnSync2("git", ["rev-parse", "--short=12", "HEAD"], { cwd: packageRoot, encoding: "utf8" });
   return result.status === 0 ? result.stdout.trim() || void 0 : void 0;
 }
 function tableExists(database, table) {
@@ -3651,6 +3656,7 @@ function getLineageRuntimeInfo(options = {}) {
     }
   }
   return {
+    asset_root: repoRoot,
     channel: normalizeRuntimeChannel(options.channel || process.env.LINEAGE_CHANNEL || process.env.LINEAGE_RELEASE_CHANNEL),
     database: databaseInfo,
     fetchedAt: nowIso(),
@@ -3666,12 +3672,12 @@ var signalExitCodes = {
   SIGINT: 130,
   SIGTERM: 143
 };
-function packageRoot() {
+function packageRoot2() {
   return resolve5(dirname3(fileURLToPath2(import.meta.url)), "..", "..");
 }
 function packageVersion() {
   try {
-    const packageInfo2 = JSON.parse(readFileSync4(join7(packageRoot(), "package.json"), "utf8"));
+    const packageInfo2 = JSON.parse(readFileSync4(join7(packageRoot2(), "package.json"), "utf8"));
     return packageInfo2.version || "0.0.0";
   } catch {
     return "0.0.0";
@@ -3705,25 +3711,36 @@ function readOptions(args, name) {
   return values;
 }
 function resolveStartOptions(config, args) {
-  const runtimeDir = dataRoot(config.displayName);
   const rawPort = readOption(args, "--port") || process.env.PORT || String(config.defaultPort);
   const port = Number(rawPort);
   if (!Number.isInteger(port) || port < 1 || port > 65535) {
     throw new Error(`Invalid port: ${rawPort}`);
   }
   return {
-    dbPath: readOption(args, "--db") || process.env.LINEAGE_DB || join7(runtimeDir, `${config.binName}.sqlite`),
+    assetRoot: resolveCliAssetRoot(args),
+    dbPath: resolveCliDbPath(config, args),
     host: readOption(args, "--host") || process.env.HOST || config.defaultHost,
     json: args.includes("--json"),
     open: args.includes("--open"),
     port
   };
 }
+function resolveCliAssetRoot(args) {
+  return resolve5(readOption(args, "--asset-root") || process.env.LINEAGE_ASSET_ROOT || packageRoot);
+}
+function configureCliAssetRoot(args) {
+  const assetRoot = resolveCliAssetRoot(args);
+  process.env.LINEAGE_ASSET_ROOT = assetRoot;
+  return setLineageAssetRoot(assetRoot);
+}
+function resolveCliDbPath(config, args) {
+  return readOption(args, "--db") || process.env.LINEAGE_DB || join7(dataRoot(config.displayName), `${config.binName}.sqlite`);
+}
 function formatLineageHelp(config) {
   return `${config.binName} ${packageVersion()}
 
 Usage:
-  ${config.binName} start [--port <port>] [--host <host>] [--db <path>] [--open] [--json]
+  ${config.binName} start [--port <port>] [--host <host>] [--db <path>] [--asset-root <path>] [--open] [--json]
   ${config.binName} next [--project <project>] [--root <asset-id>] [--db <path>] [--json]
   ${config.binName} brief [--project <project>] [--root <asset-id>] [--db <path>] [--json]
   ${config.binName} inspect --asset-id <asset-id> [--project <project>] [--db <path>] [--json]
@@ -3756,6 +3773,9 @@ Usage:
 
 ${config.displayName} runs the bundled Lineage server for the ${config.channel} channel.
 
+Asset catalogs and local media default to the installed package root. Pass
+--asset-root <path> or LINEAGE_ASSET_ROOT to use an external project root.
+
 Variation vs re-roll:
   link-child creates a new visible child variation edge.
   reroll mark -> reroll plan -> reroll import updates the same node with a new attempt.`;
@@ -3782,6 +3802,7 @@ function positionalArgs(args) {
   return values;
 }
 function resolveDataCommandOptions(args) {
+  configureCliAssetRoot(args);
   const positions = positionalArgs(args);
   const options = {
     assetId: readOption(args, "--asset-id") || positions[0],
@@ -4028,8 +4049,9 @@ function printDataResult(command, result, json) {
   console.log(String(result));
 }
 function runLineageDbCommand(config, command, args) {
-  const dbPath = readOption(args, "--db");
-  if (dbPath) process.env.LINEAGE_DB = dbPath;
+  configureCliAssetRoot(args);
+  const dbPath = resolveCliDbPath(config, args);
+  process.env.LINEAGE_DB = dbPath;
   if (command === "info") return getLineageRuntimeInfo({ channel: config.channel, dbPath });
   throw new Error(`Unknown db command: ${command}`);
 }
@@ -4044,6 +4066,7 @@ function printDbResult(command, result, json) {
     console.log(`Version: ${runtime.version}`);
     if (runtime.git_sha) console.log(`Git: ${runtime.git_sha}`);
     if (runtime.node_env) console.log(`Node env: ${runtime.node_env}`);
+    console.log(`Assets: ${runtime.asset_root}`);
     console.log(`SQLite: ${runtime.database.path}`);
     console.log(`Exists: ${runtime.database.exists ? "yes" : "no"}`);
     if (runtime.database.size_bytes !== void 0) console.log(`Size: ${runtime.database.size_bytes} bytes`);
@@ -4056,6 +4079,7 @@ function printDbResult(command, result, json) {
   console.log(String(result));
 }
 function runLineageAgentCommand(command, args) {
+  configureCliAssetRoot(args);
   const dbPath = readOption(args, "--db");
   if (dbPath) process.env.LINEAGE_DB = dbPath;
   const project = readOption(args, "--project") || process.env.LINEAGE_DEFAULT_PRODUCT || defaultProduct;
@@ -4181,7 +4205,7 @@ function start(config, args) {
     else console.error(`${config.binName}: ${message}`);
     process.exit(1);
   }
-  const serverPath = join7(packageRoot(), "dist", "server.js");
+  const serverPath = join7(packageRoot2(), "dist", "server.js");
   if (!existsSync7(serverPath)) {
     const message = `Missing bundled server at ${serverPath}. Run npm run build before using ${config.binName} start from a source checkout.`;
     if (options.json) console.error(JSON.stringify({ ok: false, error: message }, null, 2));
@@ -4191,16 +4215,18 @@ function start(config, args) {
   mkdirSync4(dirname3(options.dbPath), { recursive: true });
   const url = `http://${options.host}:${options.port}`;
   if (options.json) {
-    console.log(JSON.stringify({ channel: config.channel, dbPath: options.dbPath, host: options.host, port: options.port, status: "starting", url }, null, 2));
+    console.log(JSON.stringify({ assetRoot: options.assetRoot, channel: config.channel, dbPath: options.dbPath, host: options.host, port: options.port, status: "starting", url }, null, 2));
   } else {
     console.log(`${config.displayName} starting at ${url}`);
     console.log(`SQLite: ${options.dbPath}`);
+    console.log(`Assets: ${options.assetRoot}`);
   }
   if (options.open) openBrowser(url);
   const child = spawn(process.execPath, [serverPath], {
     env: {
       ...process.env,
       HOST: options.host,
+      LINEAGE_ASSET_ROOT: options.assetRoot,
       LINEAGE_CHANNEL: config.channel,
       LINEAGE_DB: options.dbPath,
       NODE_ENV: "production",