agent-trajectories 0.5.9 → 0.6.1

package/README.md

@@ -21,7 +21,7 @@ A **trajectory** is the complete story of agent work on a task:
 Works with any task system: Beads, Linear, Jira, GitHub Issues, or standalone. Trajectories are a universal format—like Markdown for documentation.
 
 ### Multiple Storage Backends
-- **File system** (default) - `.trajectories/` directory, git-friendly
+- **File system** (default) - `.agentworkforce/trajectories/` directory, git-friendly
 - **SQLite** - Local indexing and search
 - **PostgreSQL/S3** - For teams and archival
 
@@ -95,17 +95,25 @@ Over time, trajectories become a searchable knowledge base:
 ### CLI
 
 ```bash
-# Install globally (trail command available directly)
+# Run without installing globally
+npx --yes agent-trajectories start "Implement auth module"
+
+# Or install globally if you prefer the short trail command
 npm install -g agent-trajectories
+trail start "Implement auth module"
 
-# Or install locally (requires npx prefix)
+# Or install locally in a project
 npm install agent-trajectories
+npx --no-install trail start "Implement auth module"
+# or
+npm exec -- trail start "Implement auth module"
 ```
 
 ```bash
 # Start tracking a task
 trail start "Implement auth module"
-# (use `npx trail start ...` if installed locally)
+# (for non-global installs, replace `trail` with
+#  `npx --yes agent-trajectories`, `npx --no-install trail`, or `npm exec -- trail`)
 
 # View current status
 trail status
@@ -145,7 +153,7 @@ Use `--discard-sources` when the compacted summary should replace the raw source
       - name: Compact trajectories
         run: |
           PR_COMMITS=$(git log ${{ github.event.pull_request.base.sha }}..${{ github.event.pull_request.head.sha }} --format=%H | paste -sd, -)
-          OUTPUT=".trajectories/compacted/pr-${{ github.event.pull_request.number }}.json"
+          OUTPUT=".agentworkforce/trajectories/compacted/pr-${{ github.event.pull_request.number }}.json"
           if [ -n "$PR_COMMITS" ]; then
             npx agent-trajectories compact --commits "$PR_COMMITS" --output "$OUTPUT" --discard-sources
           else
@@ -153,7 +161,7 @@ Use `--discard-sources` when the compacted summary should replace the raw source
           fi
       - name: Commit compacted trajectories
         run: |
-          git add .trajectories/ || true
+          git add .agentworkforce/trajectories/ || true
           git diff --cached --quiet || \
             (git commit -m "chore: compact trajectories for PR #${{ github.event.pull_request.number }}" && git push)
 ```
@@ -463,7 +471,7 @@ The client manages trajectories with persistent storage.
 ```typescript
 const client = new TrajectoryClient({
   defaultAgent: 'my-agent',    // Default agent name
-  dataDir: '.trajectories',     // Storage directory
+  dataDir: '.',                // Base directory; stores under .agentworkforce/trajectories
   autoSave: true,               // Auto-save after operations
 });
 
@@ -542,7 +550,7 @@ const t = TrajectoryBuilder.create('Task')
 This project is in early development. See [PROPOSAL-trajectories.md](./PROPOSAL-trajectories.md) for the full design document.
 
 **v1.0 (current)**
-- [x] File-based storage (`.trajectories/`)
+- [x] File-based storage (`.agentworkforce/trajectories/`)
 - [x] Core CLI commands (`start`, `decision`, `complete`, `list`, `show`, `export`)
 - [x] Agent Trace spec compliance (`.trace.json` generation)
 - [x] Multi-agent participation tracking

package/dist/{chunk-JMH3Z5BB.js → chunk-BVTUGGYW.js}

@@ -1,8 +1,157 @@
 // src/sdk/client.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync2, readFileSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { createRequire } from "module";
-import { dirname as dirname2, resolve as resolvePath } from "path";
+import { dirname as dirname3, resolve as resolvePath } from "path";
+
+// src/core/project-id.ts
+import { execFileSync } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+function resolveProjectId(explicitProjectId, options = {}) {
+  return readString(explicitProjectId) ?? readString((options.env ?? process.env).TRAJECTORIES_PROJECT) ?? resolveDefaultProjectId(options.cwd);
+}
+function resolveDefaultProjectId(cwd = process.cwd()) {
+  const packageJson = readNearestPackageJson(cwd);
+  return resolvePackageRepositoryId(packageJson) ?? resolveGitRemoteProjectId(cwd) ?? resolvePackageName(packageJson);
+}
+function normalizeRepositoryId(value) {
+  const raw = readString(value);
+  if (!raw) {
+    return void 0;
+  }
+  const withoutGitPrefix = raw.replace(/^git\+/, "");
+  const shorthand = withoutGitPrefix.match(
+    /^(?:github|gitlab|bitbucket):([^/]+\/[^/]+(?:\/[^/]+)*)$/
+  );
+  if (shorthand) {
+    return cleanRepositoryPath(shorthand[1]);
+  }
+  const ownerRepo = withoutGitPrefix.match(
+    /^([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+)$/
+  );
+  if (ownerRepo) {
+    return cleanRepositoryPath(ownerRepo[1]);
+  }
+  const sshUrlScpLike = withoutGitPrefix.match(
+    /^ssh:\/\/[^@/\s]+@[^:/\s]+:(.+)$/i
+  );
+  if (sshUrlScpLike) {
+    return cleanRepositoryPath(sshUrlScpLike[1]);
+  }
+  const scpLike = withoutGitPrefix.match(/^[^@/\s]+@[^:/\s]+:(.+)$/);
+  if (scpLike) {
+    return cleanRepositoryPath(scpLike[1]);
+  }
+  let parsed;
+  try {
+    parsed = new URL(withoutGitPrefix);
+  } catch {
+    return void 0;
+  }
+  if (!["https:", "http:", "ssh:", "git:"].includes(parsed.protocol)) {
+    return void 0;
+  }
+  return cleanRepositoryPath(parsed.pathname);
+}
+function resolvePackageRepositoryId(packageJson) {
+  if (!packageJson) {
+    return void 0;
+  }
+  const repository = packageJson.repository;
+  if (typeof repository === "string") {
+    return normalizeRepositoryId(repository);
+  }
+  if (isRepositoryObject(repository) && typeof repository.url === "string") {
+    const projectId = normalizeRepositoryId(repository.url);
+    const directory = cleanRepositoryDirectory(repository.directory);
+    return directory && projectId ? `${projectId}//${directory}` : projectId;
+  }
+  return void 0;
+}
+function resolvePackageName(packageJson) {
+  return readString(packageJson?.name);
+}
+function resolveGitRemoteProjectId(cwd) {
+  for (const remote of ["upstream", "origin"]) {
+    const remoteUrl = getGitRemoteUrl(cwd, remote);
+    if (!remoteUrl) {
+      continue;
+    }
+    const projectId = normalizeRepositoryId(remoteUrl);
+    if (projectId) {
+      return projectId;
+    }
+  }
+  return void 0;
+}
+function getGitRemoteUrl(cwd, remote) {
+  try {
+    return readString(
+      execFileSync("git", ["config", "--get", `remote.${remote}.url`], {
+        cwd,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      })
+    );
+  } catch {
+    return void 0;
+  }
+}
+function readNearestPackageJson(cwd) {
+  let current = resolve(cwd);
+  while (true) {
+    const candidate = join(current, "package.json");
+    if (existsSync(candidate)) {
+      try {
+        const parsed = JSON.parse(readFileSync(candidate, "utf-8"));
+        if (isPackageJson(parsed)) {
+          return parsed;
+        }
+      } catch {
+      }
+    }
+    const parent = dirname(current);
+    if (parent === current) {
+      return void 0;
+    }
+    current = parent;
+  }
+}
+function cleanRepositoryPath(path) {
+  const withoutQuery = path.split(/[?#]/, 1)[0] ?? "";
+  const withoutSlashes = withoutQuery.replace(/^\/+|\/+$/g, "");
+  const withoutGitSuffix = withoutSlashes.replace(/\.git$/i, "");
+  const parts = withoutGitSuffix.split("/").map((part) => part.trim()).filter(Boolean);
+  if (parts.length < 2) {
+    return void 0;
+  }
+  return parts.join("/");
+}
+function cleanRepositoryDirectory(directory) {
+  const raw = readString(directory);
+  if (!raw || raw.startsWith("/") || raw.startsWith("\\") || /^[A-Za-z]:[\\/]/.test(raw)) {
+    return void 0;
+  }
+  const parts = raw.split(/[\\/]/).map((part) => part.trim()).filter(Boolean);
+  if (parts.length === 0 || parts.some((part) => part === "." || part === "..")) {
+    return void 0;
+  }
+  return parts.join("/");
+}
+function readString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function isPackageJson(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isRepositoryObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 
 // src/core/id.ts
 import { webcrypto } from "crypto";
@@ -269,7 +418,7 @@ function createTrajectory(input) {
     chapters: [],
     commits: [],
     filesChanged: [],
-    projectId: input.projectId ?? process.cwd(),
+    projectId: input.projectId,
     tags: input.tags ?? []
   };
 }
@@ -666,7 +815,7 @@ function formatTime(isoString) {
 }
 
 // src/storage/file.ts
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import {
   mkdir,
   readFile,
@@ -677,19 +826,27 @@ import {
 } from "fs/promises";
 import {
   basename,
-  dirname,
+  dirname as dirname2,
   isAbsolute,
-  join,
+  join as join2,
   relative,
-  resolve
+  resolve as resolve2
 } from "path";
 var TRAJECTORY_FILE = "trajectory.json";
 var SUMMARY_FILE = "summary.md";
 var COMPACTION_FILE = "compaction.json";
 var LEGACY_COMPACTION_SUFFIX = ".compaction.json";
+var DEFAULT_TRAJECTORY_DATA_DIR = join2(
+  ".agentworkforce",
+  "trajectories"
+);
+var LEGACY_TRAJECTORY_DATA_DIR = ".trajectories";
+function getDefaultTrajectoryDataDir(baseDir = process.cwd()) {
+  return join2(baseDir, DEFAULT_TRAJECTORY_DATA_DIR);
+}
 function expandPath(path) {
   if (path.startsWith("~")) {
-    return join(process.env.HOME ?? "", path.slice(1));
+    return join2(process.env.HOME ?? "", path.slice(1));
   }
   return path;
 }
@@ -713,28 +870,42 @@ var FileStorage = class {
   activeDir;
   completedDir;
   lastReconcileSummary;
+  shouldMigrateLegacyDefault = false;
   constructor(baseDir) {
     this.baseDir = baseDir ?? process.cwd();
     const dataDir = process.env.TRAJECTORIES_DATA_DIR;
     if (dataDir) {
       this.trajectoriesDir = expandPath(dataDir);
     } else {
-      this.trajectoriesDir = join(this.baseDir, ".trajectories");
+      this.trajectoriesDir = getDefaultTrajectoryDataDir(this.baseDir);
+      this.shouldMigrateLegacyDefault = true;
     }
-    this.activeDir = join(this.trajectoriesDir, "active");
-    this.completedDir = join(this.trajectoriesDir, "completed");
+    this.activeDir = join2(this.trajectoriesDir, "active");
+    this.completedDir = join2(this.trajectoriesDir, "completed");
   }
   /**
    * Initialize storage directories
    */
   async initialize() {
+    await this.migrateLegacyDefaultDir();
     await mkdir(this.trajectoriesDir, { recursive: true });
     await mkdir(this.activeDir, { recursive: true });
     await mkdir(this.completedDir, { recursive: true });
     await this.migrateLegacyIndexCompactionMarkers();
-    await rm(join(this.trajectoriesDir, "index.json"), { force: true });
+    await rm(join2(this.trajectoriesDir, "index.json"), { force: true });
     await this.reconcileIndex();
   }
+  async migrateLegacyDefaultDir() {
+    if (!this.shouldMigrateLegacyDefault) {
+      return;
+    }
+    const legacyDir = join2(this.baseDir, LEGACY_TRAJECTORY_DATA_DIR);
+    if (!existsSync2(legacyDir) || existsSync2(this.trajectoriesDir)) {
+      return;
+    }
+    await mkdir(dirname2(this.trajectoriesDir), { recursive: true });
+    await rename(legacyDir, this.trajectoriesDir);
+  }
   /**
    * Scan active/ and completed/ recursively and report trajectory files
    * that can be loaded plus files that should be surfaced by doctor.
@@ -805,7 +976,7 @@ var FileStorage = class {
     return this.lastReconcileSummary;
   }
   /**
-   * Move trajectory files that fail to load into `.trajectories/invalid/`
+   * Move trajectory files that fail to load into `.agentworkforce/trajectories/invalid/`
    * so reconcile no longer scans them. Only quarantines parse and schema
    * failures — transient io_error failures are left in place because the
    * file may load fine on the next attempt.
@@ -815,7 +986,7 @@ var FileStorage = class {
    */
   async quarantineInvalid() {
     const summary = await this.reconcileIndex();
-    const targetDir = join(this.trajectoriesDir, "invalid");
+    const targetDir = join2(this.trajectoriesDir, "invalid");
     const candidates = summary.failures.filter((f) => f.reason !== "io_error");
     if (candidates.length === 0) {
       return { moved: [], targetDir };
@@ -825,7 +996,7 @@ var FileStorage = class {
     for (const failure of candidates) {
       const dest = await this.resolveQuarantineDest(failure.path, targetDir);
       try {
-        await mkdir(dirname(dest), { recursive: true });
+        await mkdir(dirname2(dest), { recursive: true });
         await rename(failure.path, dest);
         moved.push(failure);
       } catch (error) {
@@ -851,13 +1022,13 @@ var FileStorage = class {
   async resolveQuarantineDest(sourcePath, targetDir) {
     const rel = relative(this.trajectoriesDir, sourcePath);
     const safeRel = rel && !rel.startsWith("..") && !isAbsolute(rel) ? rel : basename(sourcePath);
-    let dest = join(targetDir, safeRel);
-    if (!existsSync(dest)) return dest;
+    let dest = join2(targetDir, safeRel);
+    if (!existsSync2(dest)) return dest;
     const ext = safeRel.endsWith(".json") ? ".json" : "";
     const stem = ext ? safeRel.slice(0, -ext.length) : safeRel;
     for (let i = 1; i < 1e3; i += 1) {
-      dest = join(targetDir, `${stem}.${i}${ext}`);
-      if (!existsSync(dest)) return dest;
+      dest = join2(targetDir, `${stem}.${i}${ext}`);
+      if (!existsSync2(dest)) return dest;
     }
     return dest;
   }
@@ -874,7 +1045,7 @@ var FileStorage = class {
       throw error;
     }
     for (const entry of entries) {
-      const entryPath = join(dir, entry.name);
+      const entryPath = join2(dir, entry.name);
       if (entry.isDirectory()) {
         await this.walkJsonFilesInto(entryPath, out);
       } else if (entry.isFile() && isTrajectoryJsonFile(entry.name)) {
@@ -905,20 +1076,20 @@ var FileStorage = class {
     let trajectoryDir;
     if (isCompleted) {
       const date = new Date(trajectory2.completedAt ?? trajectory2.startedAt);
-      const monthDir = join(
+      const monthDir = join2(
         this.completedDir,
         `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}`
       );
-      trajectoryDir = join(monthDir, trajectory2.id);
+      trajectoryDir = join2(monthDir, trajectory2.id);
     } else {
-      trajectoryDir = join(this.activeDir, trajectory2.id);
+      trajectoryDir = join2(this.activeDir, trajectory2.id);
     }
-    const filePath = join(trajectoryDir, TRAJECTORY_FILE);
+    const filePath = join2(trajectoryDir, TRAJECTORY_FILE);
     await this.removeTrajectoryFiles(existingPaths, filePath);
     await mkdir(trajectoryDir, { recursive: true });
     if (isCompleted) {
       const markdown = exportToMarkdown(trajectory2);
-      await writeFile(join(trajectoryDir, SUMMARY_FILE), markdown, "utf-8");
+      await writeFile(join2(trajectoryDir, SUMMARY_FILE), markdown, "utf-8");
     }
     await writeFile(filePath, JSON.stringify(trajectory2, null, 2), "utf-8");
   }
@@ -927,7 +1098,7 @@ var FileStorage = class {
    */
   async get(id) {
     for (const filePath of this.getActiveCandidatePaths(id)) {
-      if (!existsSync(filePath)) continue;
+      if (!existsSync2(filePath)) continue;
       const trajectory2 = await this.readTrajectoryOrNull(filePath);
       if (trajectory2?.id === id) {
         return trajectory2;
@@ -1132,9 +1303,9 @@ var FileStorage = class {
       return [];
     }
     return [
-      join(this.activeDir, id, TRAJECTORY_FILE),
+      join2(this.activeDir, id, TRAJECTORY_FILE),
       // Legacy layout from v0.5.x and earlier.
-      join(this.activeDir, `${id}.json`)
+      join2(this.activeDir, `${id}.json`)
     ];
   }
   async loadAllTrajectories() {
@@ -1188,7 +1359,7 @@ var FileStorage = class {
   }
   getTrajectoryIdFromPath(filePath) {
     if (basename(filePath) === TRAJECTORY_FILE) {
-      const id = basename(dirname(filePath));
+      const id = basename(dirname2(filePath));
       return isSafeTrajectoryId(id) ? id : void 0;
     }
     const name = basename(filePath);
@@ -1209,10 +1380,10 @@ var FileStorage = class {
   }
   async removeTrajectoryFile(filePath, summary) {
     if (basename(filePath) === TRAJECTORY_FILE) {
-      const trajectoryDir = dirname(filePath);
+      const trajectoryDir = dirname2(filePath);
       await this.countDirectoryTrajectoryFiles(trajectoryDir, summary);
       await this.removeFileIfExists(
-        join(dirname(trajectoryDir), `${basename(trajectoryDir)}.trace.json`),
+        join2(dirname2(trajectoryDir), `${basename(trajectoryDir)}.trace.json`),
         "trace",
         summary
       );
@@ -1238,40 +1409,40 @@ var FileStorage = class {
   }
   async countDirectoryTrajectoryFiles(trajectoryDir, summary) {
     await this.countFileIfExists(
-      join(trajectoryDir, TRAJECTORY_FILE),
+      join2(trajectoryDir, TRAJECTORY_FILE),
       "json",
       summary
     );
     await this.countFileIfExists(
-      join(trajectoryDir, SUMMARY_FILE),
+      join2(trajectoryDir, SUMMARY_FILE),
       "markdown",
       summary
     );
     await this.countFileIfExists(
-      join(trajectoryDir, `${basename(trajectoryDir)}.trace.json`),
+      join2(trajectoryDir, `${basename(trajectoryDir)}.trace.json`),
       "trace",
       summary
     );
     await this.countFileIfExists(
-      join(trajectoryDir, "trace.json"),
+      join2(trajectoryDir, "trace.json"),
       "trace",
       summary
     );
     await this.countFileIfExists(
-      join(trajectoryDir, COMPACTION_FILE),
+      join2(trajectoryDir, COMPACTION_FILE),
       "compaction",
       summary
     );
   }
   async removeFileIfExists(path, kind, summary) {
-    if (!existsSync(path)) {
+    if (!existsSync2(path)) {
       return;
     }
     await rm(path, { force: true });
     this.incrementDeleteSummary(kind, summary);
   }
   async countFileIfExists(path, kind, summary) {
-    if (existsSync(path)) {
+    if (existsSync2(path)) {
       this.incrementDeleteSummary(kind, summary);
     }
   }
@@ -1312,21 +1483,21 @@ var FileStorage = class {
   }
   getCompactionMarkerPath(filePath, id) {
     if (basename(filePath) === TRAJECTORY_FILE) {
-      return join(dirname(filePath), COMPACTION_FILE);
+      return join2(dirname2(filePath), COMPACTION_FILE);
     }
-    return join(dirname(filePath), `${id}${LEGACY_COMPACTION_SUFFIX}`);
+    return join2(dirname2(filePath), `${id}${LEGACY_COMPACTION_SUFFIX}`);
   }
   getTrajectoryIdFromCompactionMarkerPath(markerPath) {
     if (basename(markerPath) === COMPACTION_FILE) {
-      const id = basename(dirname(markerPath));
+      const id = basename(dirname2(markerPath));
       return id.startsWith("traj_") ? id : void 0;
     }
     const markerName = basename(markerPath);
     return markerName.endsWith(LEGACY_COMPACTION_SUFFIX) ? markerName.slice(0, -LEGACY_COMPACTION_SUFFIX.length) : void 0;
   }
   async migrateLegacyIndexCompactionMarkers() {
-    const indexPath = join(this.trajectoriesDir, "index.json");
-    if (!existsSync(indexPath)) {
+    const indexPath = join2(this.trajectoriesDir, "index.json");
+    if (!existsSync2(indexPath)) {
       return;
     }
     let parsed;
@@ -1352,7 +1523,7 @@ var FileStorage = class {
         if (typeof compactedInto !== "string") {
           return;
         }
-        const paths = typeof path === "string" && existsSync(path) && this.isPathInsideTrajectoriesDir(path) ? [path] : await this.findTrajectoryFilePaths(id);
+        const paths = typeof path === "string" && existsSync2(path) && this.isPathInsideTrajectoriesDir(path) ? [path] : await this.findTrajectoryFilePaths(id);
         if (paths.length === 0) return;
         const marker = {
           trajectoryId: id,
@@ -1372,7 +1543,7 @@ var FileStorage = class {
     );
   }
   isPathInsideTrajectoriesDir(path) {
-    const rel = relative(resolve(this.trajectoriesDir), resolve(path));
+    const rel = relative(resolve2(this.trajectoriesDir), resolve2(path));
     return Boolean(rel && !rel.startsWith("..") && !isAbsolute(rel));
   }
   async walkFilesInto(dir, out, predicate) {
@@ -1384,7 +1555,7 @@ var FileStorage = class {
       throw error;
     }
     for (const entry of entries) {
-      const entryPath = join(dir, entry.name);
+      const entryPath = join2(dir, entry.name);
       if (entry.isDirectory()) {
         await this.walkFilesInto(entryPath, out, predicate);
       } else if (entry.isFile() && predicate(entry.name)) {
@@ -1517,12 +1688,12 @@ function resolveTrajectoryCliInvocation() {
   try {
     const packageJsonPath = require2.resolve("agent-trajectories/package.json");
     const pkg = JSON.parse(
-      readFileSync(packageJsonPath, "utf-8")
+      readFileSync2(packageJsonPath, "utf-8")
     );
     const binEntry = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.trail ?? (pkg.name ? pkg.bin?.[pkg.name] : void 0);
     if (binEntry) {
-      const cliPath = resolvePath(dirname2(packageJsonPath), binEntry);
-      if (existsSync2(cliPath)) {
+      const cliPath = resolvePath(dirname3(packageJsonPath), binEntry);
+      if (existsSync3(cliPath)) {
         return { command: process.execPath, args: [cliPath] };
       }
     }
@@ -1567,7 +1738,7 @@ async function compactWorkflow(workflowId, options) {
   if (options?.discardSources) {
     args.push("--discard-sources");
   }
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const child = spawn(cli.command, args, {
       cwd: options?.cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -1595,7 +1766,7 @@ async function compactWorkflow(workflowId, options) {
       }
       try {
         const stdout = Buffer.concat(stdoutChunks).toString("utf-8");
-        resolve2(parseCompactWorkflowOutput(stdout));
+        resolve3(parseCompactWorkflowOutput(stdout));
       } catch (error) {
         reject(
           error instanceof Error ? error : new Error("compactWorkflow failed: unable to parse CLI output")
@@ -1822,7 +1993,7 @@ var TrajectoryClient = class {
   constructor(options = {}) {
     this.storage = options.storage ?? new FileStorage(options.dataDir);
     this.defaultAgent = options.defaultAgent ?? process.env.TRAJECTORIES_AGENT;
-    this.projectId = options.projectId ?? process.env.TRAJECTORIES_PROJECT;
+    this.projectId = resolveProjectId(options.projectId);
     this.autoSave = options.autoSave ?? true;
     this.autoCompact = normalizeAutoCompactOptions(options.autoCompact);
     this.autoCompactCwd = options.storage ? void 0 : options.dataDir;
@@ -2264,7 +2435,7 @@ function trajectory(title) {
 
 // src/core/trailers.ts
 import { execSync as execSync2 } from "child_process";
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 
 // src/core/trace.ts
 import { execSync } from "child_process";
@@ -2407,6 +2578,9 @@ export {
   exportToMarkdown,
   exportToPRSummary,
   exportToTimeline,
+  DEFAULT_TRAJECTORY_DATA_DIR,
+  LEGACY_TRAJECTORY_DATA_DIR,
+  getDefaultTrajectoryDataDir,
   FileStorage,
   compactWorkflow,
   TrajectorySession,
@@ -2420,4 +2594,4 @@ export {
   getCommitsBetween,
   getFilesChangedBetween
 };
-//# sourceMappingURL=chunk-JMH3Z5BB.js.map
+//# sourceMappingURL=chunk-BVTUGGYW.js.map