agent-trajectories 0.5.8 → 0.6.0

package/dist/{index-C9IcYSNQ.d.ts → index-DEr3Rs32.d.ts}

@@ -410,7 +410,7 @@ declare function compactWorkflow(workflowId: string, options?: {
 interface TrajectoryClientOptions {
     /** Storage adapter to use. Defaults to FileStorage. */
     storage?: StorageAdapter;
-    /** Base directory for file storage. Defaults to .trajectories */
+    /** Base directory for default file storage. Stores under .agentworkforce/trajectories. */
     dataDir?: string;
     /** Default agent name to use when not specified */
     defaultAgent?: string;
@@ -908,10 +908,20 @@ declare function abandonTrajectory(trajectory: Trajectory, reason?: string): Tra
 /**
  * File system storage adapter for trajectories
  *
- * Stores trajectories as JSON files in a .trajectories directory.
- * Active trajectories go in active/, completed in completed/YYYY-MM/.
+ * Stores each trajectory in its own directory under .agentworkforce/trajectories.
+ * Active trajectories go in active/<id>/, completed in completed/YYYY-MM/<id>/.
  */
 
+declare const DEFAULT_TRAJECTORY_DATA_DIR: string;
+declare const LEGACY_TRAJECTORY_DATA_DIR = ".trajectories";
+declare function getDefaultTrajectoryDataDir(baseDir?: string): string;
+interface DeleteTrajectorySummary {
+    removedTrajectories: number;
+    deletedJsonFiles: number;
+    deletedMarkdownFiles: number;
+    deletedTraceFiles: number;
+    deletedCompactionFiles: number;
+}
 /**
  * Reason a single trajectory file was skipped during reconcile.
  */
@@ -951,26 +961,26 @@ declare class FileStorage implements StorageAdapter {
     private trajectoriesDir;
     private activeDir;
     private completedDir;
-    private indexPath;
     private lastReconcileSummary?;
+    private shouldMigrateLegacyDefault;
     constructor(baseDir?: string);
     /**
      * Initialize storage directories
      */
     initialize(): Promise<void>;
+    private migrateLegacyDefaultDir;
     /**
-     * Scan active/ and completed/ recursively and add any trajectory files
-     * missing from the index. Existing entries are preserved — reconcile
-     * only adds, never removes.
+     * Scan active/ and completed/ recursively and report trajectory files
+     * that can be loaded plus files that should be surfaced by doctor.
      *
      * Handles three on-disk layouts in completed/:
      *   - flat:      completed/{id}.json         (legacy workforce data)
-     *   - monthly:   completed/YYYY-MM/{id}.json (current save() writes)
+     *   - monthly:   completed/YYYY-MM/{id}.json (legacy monthly layout)
+     *   - directory: completed/YYYY-MM/{id}/trajectory.json (current layout)
      *   - nested:    completed/.../{id}.json     (defensive — any depth)
      *
-     * Returns a ReconcileSummary so tests and CLI wrappers can observe
-     * outcomes without parsing logs. Only writes the index if anything was
-     * added.
+     * The method name is kept for callers such as `trail doctor`, but no
+     * shared index file is written.
      */
     reconcileIndex(): Promise<ReconcileSummary>;
     /**
@@ -980,7 +990,7 @@ declare class FileStorage implements StorageAdapter {
      */
     getLastReconcileSummary(): ReconcileSummary | undefined;
     /**
-     * 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.
@@ -1006,7 +1016,7 @@ declare class FileStorage implements StorageAdapter {
      */
     private resolveQuarantineDest;
     /**
-     * Recursively collect all .json file paths under `dir` into `out`.
+     * Recursively collect trajectory JSON file paths under `dir` into `out`.
      * Silently treats a missing directory as empty.
      */
     private walkJsonFilesInto;
@@ -1041,10 +1051,53 @@ declare class FileStorage implements StorageAdapter {
     search(text: string, options?: {
         limit?: number;
     }): Promise<TrajectorySummary[]>;
+    /**
+     * Mark a trajectory as compacted without writing to a shared index.
+     */
+    markCompacted(id: string, compactedInto: string): Promise<boolean>;
+    /**
+     * Mark multiple trajectories as compacted with one filesystem scan.
+     */
+    markCompactedMany(ids: string[], compactedInto: string): Promise<Set<string>>;
+    /**
+     * Return trajectory IDs that have a per-trajectory compaction marker.
+     */
+    getCompactedTrajectoryIds(): Promise<Set<string>>;
+    /**
+     * Delete a trajectory and return file counts for CLI reporting.
+     */
+    deleteWithSummary(id: string): Promise<DeleteTrajectorySummary>;
+    /**
+     * Delete multiple trajectories with one filesystem scan.
+     */
+    deleteManyWithSummary(ids: string[]): Promise<DeleteTrajectorySummary>;
     /**
      * Close storage (no-op for file storage)
      */
     close(): Promise<void>;
+    private getActiveCandidatePaths;
+    private loadAllTrajectories;
+    private listTrajectoryFiles;
+    private collectTrajectoryFiles;
+    private findTrajectoryFilePaths;
+    private findTrajectoryFilePathsForIds;
+    private getTrajectoryIdFromPath;
+    private removeTrajectoryFiles;
+    private removeTrajectoryFile;
+    private countDirectoryTrajectoryFiles;
+    private removeFileIfExists;
+    private countFileIfExists;
+    private incrementDeleteSummary;
+    private emptyDeleteSummary;
+    private listCompactionMarkerFiles;
+    private getCompactionMarkerPath;
+    private getTrajectoryIdFromCompactionMarkerPath;
+    private migrateLegacyIndexCompactionMarkers;
+    private isPathInsideTrajectoriesDir;
+    private walkFilesInto;
+    private getSortValue;
+    private toSummary;
+    private isNewerTrajectory;
     /**
      * Read a trajectory file and return a tagged result so callers can
      * distinguish missing files, malformed JSON, and schema violations.
@@ -1058,33 +1111,6 @@ declare class FileStorage implements StorageAdapter {
      * console — so nothing leaks into test output or the CLI spinner.
      */
     private readTrajectoryOrNull;
-    /**
-     * Read and parse the on-disk index.
-     *
-     * Tolerances (belt-and-braces against the read/write race):
-     *   - ENOENT: first-run, return an empty index silently.
-     *   - Empty file: a concurrent writer truncated index.json in "w" mode
-     *     right before we read. Return an empty index silently — this is
-     *     not a real corruption, just an interleaving the mutex + atomic
-     *     rename should already prevent. Logging here would be noise.
-     *   - Non-empty but malformed JSON: genuinely corrupted on disk (hand
-     *     edit, disk error, etc). Log it and return an empty index so the
-     *     caller can recover, but keep the log so the problem is visible.
-     */
-    private loadIndex;
-    private emptyIndex;
-    /**
-     * Atomic write: stage into a process-unique temp path in the same directory
-     * and then rename over the live file. `rename` is atomic on POSIX, so
-     * concurrent readers in any process either see the old complete file or
-     * the new complete file — never a half-written / zero-byte state.
-     *
-     * Callers MUST hold `withIndexLock(this.indexPath, ...)` so the in-process
-     * read-modify-write cycle stays serialized; the unique temp name also keeps
-     * parallel writers in other processes from colliding on a shared tmp path.
-     */
-    private saveIndex;
-    private updateIndex;
 }
 
 /**
@@ -1867,4 +1893,4 @@ declare function getCommitsBetween(startRef: string, endRef?: string): CommitInf
  */
 declare function getFilesChangedBetween(startRef: string, endRef?: string): string[];
 
-export { type AddChapterInput as A, addDecision as B, type Chapter as C, type Decision as D, type EventSignificance as E, FileStorage as F, addEvent as G, completeTrajectory as H, createTrajectory as I, formatTrailer as J, getCommitsBetween as K, getFilesChangedBetween as L, getTrajectoryFromCommit as M, parseTrajectoryFromMessage as N, trajectory as O, validateCompleteInput as P, validateCreateInput as Q, type Retrospective as R, StorageAdapter as S, type Trajectory as T, validateTrajectory as U, type Alternative as V, type Finding as W, type FindingCategory as X, compactWorkflow as Y, type AddEventInput as a, type AgentParticipation as b, ChapterSchema as c, type CommitInfo as d, type CompleteTrajectoryInput as e, type CreateTrajectoryInput as f, DecisionSchema as g, RetrospectiveSchema as h, type StorageConfig as i, TRAJECTORY_TRAILER_KEY as j, type TaskReference as k, type TaskSource as l, TrajectoryBuilder as m, TrajectoryClient as n, type TrajectoryClientOptions as o, TrajectoryError as p, type TrajectoryEvent as q, TrajectoryEventSchema as r, type TrajectoryEventType as s, type TrajectoryQuery as t, TrajectorySchema as u, TrajectorySession as v, type TrajectoryStatus as w, type TrajectorySummary as x, abandonTrajectory as y, addChapter as z };
+export { compactWorkflow as $, type AddChapterInput as A, addChapter as B, type Chapter as C, DEFAULT_TRAJECTORY_DATA_DIR as D, type EventSignificance as E, FileStorage as F, addDecision as G, addEvent as H, completeTrajectory as I, createTrajectory as J, formatTrailer as K, LEGACY_TRAJECTORY_DATA_DIR as L, getCommitsBetween as M, getDefaultTrajectoryDataDir as N, getFilesChangedBetween as O, getTrajectoryFromCommit as P, parseTrajectoryFromMessage as Q, type Retrospective as R, StorageAdapter as S, type Trajectory as T, trajectory as U, validateCompleteInput as V, validateCreateInput as W, validateTrajectory as X, type Alternative as Y, type Finding as Z, type FindingCategory as _, type AddEventInput as a, type AgentParticipation as b, ChapterSchema as c, type CommitInfo as d, type CompleteTrajectoryInput as e, type CreateTrajectoryInput as f, type Decision as g, DecisionSchema as h, RetrospectiveSchema as i, type StorageConfig as j, TRAJECTORY_TRAILER_KEY as k, type TaskReference as l, type TaskSource as m, TrajectoryBuilder as n, TrajectoryClient as o, type TrajectoryClientOptions as p, TrajectoryError as q, type TrajectoryEvent as r, TrajectoryEventSchema as s, type TrajectoryEventType as t, type TrajectoryQuery as u, TrajectorySchema as v, TrajectorySession as w, type TrajectoryStatus as x, type TrajectorySummary as y, abandonTrajectory as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { T as Trajectory } from './index-C9IcYSNQ.js';
-export { A as AddChapterInput, a as AddEventInput, b as AgentParticipation, C as Chapter, c as ChapterSchema, d as CommitInfo, e as CompleteTrajectoryInput, f as CreateTrajectoryInput, D as Decision, g as DecisionSchema, E as EventSignificance, F as FileStorage, R as Retrospective, h as RetrospectiveSchema, S as StorageAdapter, i as StorageConfig, j as TRAJECTORY_TRAILER_KEY, k as TaskReference, l as TaskSource, m as TrajectoryBuilder, n as TrajectoryClient, o as TrajectoryClientOptions, p as TrajectoryError, q as TrajectoryEvent, r as TrajectoryEventSchema, s as TrajectoryEventType, t as TrajectoryQuery, u as TrajectorySchema, v as TrajectorySession, w as TrajectoryStatus, x as TrajectorySummary, y as abandonTrajectory, z as addChapter, B as addDecision, G as addEvent, H as completeTrajectory, I as createTrajectory, J as formatTrailer, K as getCommitsBetween, L as getFilesChangedBetween, M as getTrajectoryFromCommit, N as parseTrajectoryFromMessage, O as trajectory, P as validateCompleteInput, Q as validateCreateInput, U as validateTrajectory } from './index-C9IcYSNQ.js';
+import { T as Trajectory } from './index-DEr3Rs32.js';
+export { A as AddChapterInput, a as AddEventInput, b as AgentParticipation, C as Chapter, c as ChapterSchema, d as CommitInfo, e as CompleteTrajectoryInput, f as CreateTrajectoryInput, D as DEFAULT_TRAJECTORY_DATA_DIR, g as Decision, h as DecisionSchema, E as EventSignificance, F as FileStorage, L as LEGACY_TRAJECTORY_DATA_DIR, R as Retrospective, i as RetrospectiveSchema, S as StorageAdapter, j as StorageConfig, k as TRAJECTORY_TRAILER_KEY, l as TaskReference, m as TaskSource, n as TrajectoryBuilder, o as TrajectoryClient, p as TrajectoryClientOptions, q as TrajectoryError, r as TrajectoryEvent, s as TrajectoryEventSchema, t as TrajectoryEventType, u as TrajectoryQuery, v as TrajectorySchema, w as TrajectorySession, x as TrajectoryStatus, y as TrajectorySummary, z as abandonTrajectory, B as addChapter, G as addDecision, H as addEvent, I as completeTrajectory, J as createTrajectory, K as formatTrailer, M as getCommitsBetween, N as getDefaultTrajectoryDataDir, O as getFilesChangedBetween, P as getTrajectoryFromCommit, Q as parseTrajectoryFromMessage, U as trajectory, V as validateCompleteInput, W as validateCreateInput, X as validateTrajectory } from './index-DEr3Rs32.js';
 import 'zod';
 
 /**

package/dist/index.js

@@ -1,7 +1,9 @@
 import {
   ChapterSchema,
+  DEFAULT_TRAJECTORY_DATA_DIR,
   DecisionSchema,
   FileStorage,
+  LEGACY_TRAJECTORY_DATA_DIR,
   RetrospectiveSchema,
   TRAJECTORY_TRAILER_KEY,
   TrajectoryBuilder,
@@ -24,6 +26,7 @@ import {
   generateChapterId,
   generateTrajectoryId,
   getCommitsBetween,
+  getDefaultTrajectoryDataDir,
   getFilesChangedBetween,
   getTrajectoryFromCommit,
   isValidChapterId,
@@ -33,11 +36,13 @@ import {
   validateCompleteInput,
   validateCreateInput,
   validateTrajectory
-} from "./chunk-WMJRBQB4.js";
+} from "./chunk-ENWKFNUD.js";
 export {
   ChapterSchema,
+  DEFAULT_TRAJECTORY_DATA_DIR,
   DecisionSchema,
   FileStorage,
+  LEGACY_TRAJECTORY_DATA_DIR,
   RetrospectiveSchema,
   TRAJECTORY_TRAILER_KEY,
   TrajectoryBuilder,
@@ -60,6 +65,7 @@ export {
   generateChapterId,
   generateTrajectoryId,
   getCommitsBetween,
+  getDefaultTrajectoryDataDir,
   getFilesChangedBetween,
   getTrajectoryFromCommit,
   isValidChapterId,

package/dist/sdk/index.d.ts

@@ -1,2 +1,2 @@
-export { A as AddChapterInput, a as AddEventInput, b as AgentParticipation, V as Alternative, C as Chapter, d as CommitInfo, e as CompleteTrajectoryInput, f as CreateTrajectoryInput, D as Decision, E as EventSignificance, F as FileStorage, W as Finding, X as FindingCategory, R as Retrospective, S as StorageAdapter, i as StorageConfig, j as TRAJECTORY_TRAILER_KEY, k as TaskReference, l as TaskSource, T as Trajectory, m as TrajectoryBuilder, n as TrajectoryClient, o as TrajectoryClientOptions, p as TrajectoryError, q as TrajectoryEvent, s as TrajectoryEventType, t as TrajectoryQuery, u as TrajectorySchema, v as TrajectorySession, w as TrajectoryStatus, x as TrajectorySummary, Y as compactWorkflow, J as formatTrailer, K as getCommitsBetween, L as getFilesChangedBetween, M as getTrajectoryFromCommit, N as parseTrajectoryFromMessage, O as trajectory, P as validateCompleteInput, Q as validateCreateInput, U as validateTrajectory } from '../index-C9IcYSNQ.js';
+export { A as AddChapterInput, a as AddEventInput, b as AgentParticipation, Y as Alternative, C as Chapter, d as CommitInfo, e as CompleteTrajectoryInput, f as CreateTrajectoryInput, g as Decision, E as EventSignificance, F as FileStorage, Z as Finding, _ as FindingCategory, R as Retrospective, S as StorageAdapter, j as StorageConfig, k as TRAJECTORY_TRAILER_KEY, l as TaskReference, m as TaskSource, T as Trajectory, n as TrajectoryBuilder, o as TrajectoryClient, p as TrajectoryClientOptions, q as TrajectoryError, r as TrajectoryEvent, t as TrajectoryEventType, u as TrajectoryQuery, v as TrajectorySchema, w as TrajectorySession, x as TrajectoryStatus, y as TrajectorySummary, $ as compactWorkflow, K as formatTrailer, M as getCommitsBetween, O as getFilesChangedBetween, P as getTrajectoryFromCommit, Q as parseTrajectoryFromMessage, U as trajectory, V as validateCompleteInput, W as validateCreateInput, X as validateTrajectory } from '../index-DEr3Rs32.js';
 import 'zod';

package/dist/sdk/index.js

@@ -16,7 +16,7 @@ import {
   validateCompleteInput,
   validateCreateInput,
   validateTrajectory
-} from "../chunk-WMJRBQB4.js";
+} from "../chunk-ENWKFNUD.js";
 export {
   FileStorage,
   TRAJECTORY_TRAILER_KEY,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-trajectories",
-  "version": "0.5.8",
+  "version": "0.6.0",
   "description": "Capture the complete train of thought of agent work as first-class artifacts",
   "type": "module",
   "main": "dist/index.js",
@@ -23,6 +23,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
+    "trail": "vite-node src/cli/index.ts",
     "test": "vitest",
     "test:run": "vitest run",
     "lint": "biome check .",
@@ -67,6 +68,7 @@
     "lint-staged": "^16.2.7",
     "tsup": "^8.5.1",
     "typescript": "^5.4.0",
+    "vite-node": "^2.1.9",
     "vitest": "^2.0.0"
   },
   "lint-staged": {