trajectories 0.0.0 → 0.1.2

package/ops/linux/install-systemd-user.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+set -euo pipefail
+umask 077
+WRITE_ONLY=0
+ENABLE_NOW=0
+usage() { echo 'Usage: install-systemd-user.sh [--write-only | --enable-now] (default: --write-only)'; }
+for arg in "$@"; do
+  case "$arg" in
+    --write-only) WRITE_ONLY=1 ;;
+    --enable-now) ENABLE_NOW=1 ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown option: $arg" >&2; usage >&2; exit 2 ;;
+  esac
+done
+[[ "$WRITE_ONLY" != 1 || "$ENABLE_NOW" != 1 ]] || { echo 'Use --write-only or --enable-now, not both.' >&2; exit 2; }
+PACKAGE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+ENV_FILE="${TRAJECTORIES_ENV_FILE:-${LEDGER_ENV_FILE:-${XDG_CONFIG_HOME:-$HOME/.config}/ledger/daemon.env}}"
+if [[ -f "$ENV_FILE" ]]; then
+  set -a
+  # shellcheck disable=SC1090
+  source "$ENV_FILE"
+  set +a
+fi
+DEFAULT_WORKERS=2
+source "$PACKAGE_DIR/ops/sync-settings.sh"
+UNIT_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/systemd/user"
+UNIT="$UNIT_DIR/archeism-trajectories.service"
+TIMER="$UNIT_DIR/archeism-trajectories.timer"
+mkdir -p "$UNIT_DIR" "$DATA_DIR"
+# Operate only on the Trajectories units. An existing Ledger writer must be
+# stopped explicitly by its owner before enabling a replacement on the same DB.
+systemctl --user disable --now archeism-trajectories.service >/dev/null 2>&1 || true
+systemctl --user disable --now archeism-trajectories.timer >/dev/null 2>&1 || true
+systemd_quote() {
+  local value="${1//\\/\\\\}"
+  value="${value//\"/\\\"}"
+  value="${value//%/%%}"
+  printf '"%s"' "$value"
+}
+{
+  cat <<EOF
+[Unit]
+Description=Trajectories bounded local history sync
+After=default.target
+
+[Service]
+Type=oneshot
+EOF
+  # WorkingDirectory consumes a path value, not ExecStart's quoted argv syntax.
+  printf 'WorkingDirectory=%s\n' "${PACKAGE_DIR//%/%%}"
+  printf 'Environment=%s\n' "$(systemd_quote "PATH=$(dirname "$BUN_BIN"):/usr/local/bin:/usr/bin:/bin")"
+  # The retained sync engine reads this compatibility marker.
+  echo 'Environment=LEDGER_SCHEDULER=1'
+  printf 'ExecStart='
+  for value in "$BUN_BIN" run "$CLI_PATH" "${SYNC_ARGS[@]}"; do
+    systemd_quote "${value//\$/\$\$}"; printf ' '
+  done
+  cat <<'EOF'
+
+Restart=no
+TimeoutStartSec=150
+TimeoutStopSec=5
+MemoryHigh=768M
+MemoryMax=1G
+MemorySwapMax=256M
+CPUQuota=50%
+CPUWeight=10
+TasksMax=16
+Nice=10
+IOSchedulingClass=idle
+NoNewPrivileges=true
+PrivateTmp=true
+OOMPolicy=stop
+EOF
+} > "$UNIT"
+cat > "$TIMER" <<'EOF'
+[Unit]
+Description=Run Trajectories bounded sync periodically
+
+[Timer]
+OnBootSec=5min
+OnUnitInactiveSec=15min
+RandomizedDelaySec=60
+Persistent=true
+Unit=archeism-trajectories.service
+
+[Install]
+WantedBy=timers.target
+EOF
+chmod 600 "$UNIT" "$TIMER"
+systemctl --user daemon-reload
+if [[ "$ENABLE_NOW" == 1 ]]; then
+  systemctl --user enable --now archeism-trajectories.timer
+  echo 'Trajectories timer installed: archeism-trajectories.timer'
+else
+  echo "Trajectories unit and timer written (not enabled): $TIMER"
+  echo 'Inspect the units, run one manual bounded sync, then enable the timer:'
+  echo '  systemctl --user cat archeism-trajectories.service archeism-trajectories.timer'
+  printf '  %q run %q' "$BUN_BIN" "$CLI_PATH"
+  printf ' %q' "${SYNC_ARGS[@]}"; printf '\n'
+  echo '  systemctl --user enable --now archeism-trajectories.timer'
+fi
+echo "Database: $DB_PATH"

package/ops/macos/install-launchd.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+set -euo pipefail
+umask 077
+if [[ $# -gt 0 ]]; then
+  [[ $# == 1 && ( "$1" == --help || "$1" == -h ) ]] || { echo 'Usage: install-launchd.sh' >&2; exit 2; }
+  echo 'Usage: install-launchd.sh (writes and enables the bounded 15-minute job)'
+  exit 0
+fi
+PACKAGE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+DEFAULT_WORKERS=1
+source "$PACKAGE_DIR/ops/sync-settings.sh"
+LOG_DIR="${TRAJECTORIES_LOG_DIR:-${LEDGER_LOG_DIR:-$DATA_DIR/logs}}"
+LABEL='com.archeism.trajectories'
+PLIST="$HOME/Library/LaunchAgents/$LABEL.plist"
+case "$PACKAGE_DIR" in
+  "$HOME"/Documents|"$HOME"/Documents/*|"$HOME"/Desktop|"$HOME"/Desktop/*|"$HOME"/Downloads|"$HOME"/Downloads/*)
+    echo "Warning: macOS privacy controls may block launchd access to $PACKAGE_DIR." >&2
+    echo 'Install from a stable checkout outside Documents, Desktop, or Downloads (for example ~/workspace/oh-my-ai); do not change privacy policy.' >&2 ;;
+esac
+mkdir -p "$(dirname "$PLIST")" "$DATA_DIR" "$LOG_DIR"
+chmod 700 "$DATA_DIR" "$LOG_DIR"
+for LOG_FILE in "$LOG_DIR/trajectories.stdout.log" "$LOG_DIR/trajectories.stderr.log"; do
+  [[ ! -L "$LOG_FILE" && ( ! -e "$LOG_FILE" || -f "$LOG_FILE" ) ]] || { echo "Refusing non-regular or symlink log file: $LOG_FILE" >&2; exit 1; }
+  [[ ! -f "$LOG_FILE" ]] || chmod 600 "$LOG_FILE"
+  : >> "$LOG_FILE"
+done
+xml() {
+  local value="${1//&/\&}"
+  value="${value//</\&lt;}"
+  value="${value//>/\&gt;}"
+  printf '%s' "$value"
+}
+{
+  cat <<EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>$LABEL</string>
+  <key>ProgramArguments</key><array>
+EOF
+  for value in "$BUN_BIN" run "$CLI_PATH" "${SYNC_ARGS[@]}"; do printf '    <string>%s</string>\n' "$(xml "$value")"; done
+  cat <<EOF
+  </array>
+  <key>EnvironmentVariables</key><dict><key>LEDGER_SCHEDULER</key><string>1</string></dict>
+  <key>WorkingDirectory</key><string>$(xml "$PACKAGE_DIR")</string>
+  <key>RunAtLoad</key><true/>
+  <key>StartInterval</key><integer>900</integer>
+  <key>Umask</key><integer>63</integer>
+  <key>ProcessType</key><string>Background</string>
+  <key>LowPriorityIO</key><true/>
+  <key>Nice</key><integer>10</integer>
+  <key>ThrottleInterval</key><integer>60</integer>
+  <key>ExitTimeOut</key><integer>5</integer>
+  <key>HardResourceLimits</key><dict>
+    <key>CPU</key><integer>150</integer>
+    <key>NumberOfProcesses</key><integer>256</integer>
+    <key>ResidentSetSize</key><integer>1073741824</integer>
+  </dict>
+  <key>StandardOutPath</key><string>$(xml "$LOG_DIR/trajectories.stdout.log")</string>
+  <key>StandardErrorPath</key><string>$(xml "$LOG_DIR/trajectories.stderr.log")</string>
+</dict></plist>
+EOF
+} > "$PLIST"
+chmod 600 "$PLIST"
+plutil -lint "$PLIST" >/dev/null
+DOMAIN="gui/$(id -u)"
+launchctl bootout "$DOMAIN/$LABEL" 2>/dev/null || true
+launchctl enable "$DOMAIN/$LABEL"
+# RunAtLoad starts once; a kickstart -k would kill that first bounded pass.
+launchctl bootstrap "$DOMAIN" "$PLIST"
+echo "Trajectories service installed: $LABEL"
+echo "Database: $DB_PATH"

package/ops/sync-settings.sh

@@ -0,0 +1,37 @@
+# Shared settings for OS-supervised bounded lexical sync. Source from installers.
+# The search DB keeps Ledger's existing default; it is separate from managed
+# session snapshots. New environment names win; old names remain compatible.
+BUN_BIN="${TRAJECTORIES_BUN:-${LEDGER_BUN:-$(command -v bun)}}"
+[[ -x "$BUN_BIN" ]] || { echo 'Bun executable not found; set TRAJECTORIES_BUN.' >&2; exit 1; }
+CLI_PATH="$PACKAGE_DIR/src/cli.ts"
+[[ -f "$CLI_PATH" ]] || CLI_PATH="$PACKAGE_DIR/dist/cli.js"
+[[ -f "$CLI_PATH" ]] || { echo "Trajectories CLI not found: $CLI_PATH" >&2; exit 1; }
+[[ -f "$PACKAGE_DIR/dist/index.js" ]] || {
+  printf 'Build Trajectories before installation: bun run --cwd %q build\n' "$PACKAGE_DIR" >&2
+  exit 1
+}
+DATA_DIR="${TRAJECTORIES_DATA_DIR:-${LEDGER_DATA_DIR:-${XDG_DATA_HOME:-$HOME/.local/share}/ledger}}"
+DB_PATH="${TRAJECTORIES_DB:-${LEDGER_DB:-$DATA_DIR/ledger.sqlite}}"
+SOURCES="${TRAJECTORIES_SOURCES:-${LEDGER_SOURCES:-claude-code,codex,cursor,pi,omp,hermes,openclaw,letta-code,opencode,droid,deepagents,openhands,gemini-cli,copilot-cli,grok,kimi,cline,fx}}"
+LIMIT="${TRAJECTORIES_LIMIT:-${LEDGER_LIMIT:-1000}}"
+SESSION_BUDGET="${TRAJECTORIES_SESSION_BUDGET:-${LEDGER_SESSION_BUDGET:-25}}"
+SOURCE_BYTE_BUDGET="${TRAJECTORIES_SOURCE_BYTE_BUDGET:-${LEDGER_SOURCE_BYTE_BUDGET:-67108864}}"
+WALL_MS="${TRAJECTORIES_WALL_MS:-${LEDGER_WALL_MS:-120000}}"
+RETRY_BUDGET="${TRAJECTORIES_RETRY_BUDGET:-${LEDGER_RETRY_BUDGET:-3}}"
+ATTEMPTS_PER_SESSION="${TRAJECTORIES_ATTEMPTS_PER_SESSION:-${LEDGER_ATTEMPTS_PER_SESSION:-8}}"
+READ_BYTES_PER_SECOND="${TRAJECTORIES_READ_BYTES_PER_SECOND:-${LEDGER_READ_BYTES_PER_SECOND:-8388608}}"
+WORKER_MS="${TRAJECTORIES_WORKER_MS:-${LEDGER_WORKER_MS:-30000}}"
+WORKERS="${TRAJECTORIES_WORKERS:-${LEDGER_WORKERS:-$DEFAULT_WORKERS}}"
+FRESH_SESSION_BUDGET="${TRAJECTORIES_FRESH_SESSION_BUDGET:-${LEDGER_FRESH_SESSION_BUDGET:-5}}"
+FRESH_WINDOW_MS="${TRAJECTORIES_FRESH_WINDOW_MS:-${LEDGER_FRESH_WINDOW_MS:-3600000}}"
+SYNC_CHUNK_BYTES="${TRAJECTORIES_SYNC_CHUNK_BYTES:-${LEDGER_SYNC_CHUNK_BYTES:-1048576}}"
+PRESSURE_MODE="${TRAJECTORIES_PRESSURE_MODE:-${LEDGER_PRESSURE_MODE:-auto}}"
+MAINTENANCE_MS="${TRAJECTORIES_MAINTENANCE_MS:-${LEDGER_MAINTENANCE_MS:-5000}}"
+FTS_MERGE_PAGES="${TRAJECTORIES_FTS_MERGE_PAGES:-${LEDGER_FTS_MERGE_PAGES:-64}}"
+SYNC_ARGS=(sync --db "$DB_PATH" --sources "$SOURCES" --limit "$LIMIT" --robot
+  --session-budget "$SESSION_BUDGET" --source-byte-budget "$SOURCE_BYTE_BUDGET"
+  --wall-ms "$WALL_MS" --retry-budget "$RETRY_BUDGET" --attempts-per-session "$ATTEMPTS_PER_SESSION"
+  --read-bytes-per-second "$READ_BYTES_PER_SECOND" --worker-ms "$WORKER_MS" --workers "$WORKERS"
+  --fresh-session-budget "$FRESH_SESSION_BUDGET" --fresh-window-ms "$FRESH_WINDOW_MS"
+  --sync-chunk-bytes "$SYNC_CHUNK_BYTES" --pressure "$PRESSURE_MODE"
+  --maintenance-ms "$MAINTENANCE_MS" --fts-merge-pages "$FTS_MERGE_PAGES")

package/package.json

@@ -1,8 +1,24 @@
 {
   "name": "trajectories",
-  "version": "0.0.0",
-  "description": "Cross-harness agent session trajectories: read, search, convert and switch coding-agent sessions between harnesses. Placeholder — first release in progress. See `trajector`.",
-  "license": "MIT",
-  "main": "index.js",
-  "files": ["index.js", "README.md"]
+  "version": "0.1.2",
+  "description": "Portable coding-agent sessions: read, search, convert, and continue across harnesses.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "engines": { "node": ">=22.13.0", "bun": ">=1.4.2" },
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "bin": { "trajectories": "./dist/cli.js" },
+  "files": ["dist", "docs", "legacy/src", "legacy/bin", "legacy/scripts", "legacy/NOTICE.md", "ops", "skills", "README.md", "CHANGELOG.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && bun build src/index.ts --target node --format esm --outfile dist/index.js && bun build src/normalization-runtime.ts --target bun --format esm --outfile dist/normalization-runtime.js && bun build src/cli.ts --target bun --format esm --external onnxruntime-node --define TRAJECTORIES_BUNDLED_CLI=true --outfile dist/cli.js && bun scripts/build-assets.ts",
+    "build:native": "bun run build && bun scripts/build-native.ts",
+    "test": "bun test ./test/*.test.ts",
+    "verify": "bun run build && tsc -p tsconfig.legacy.json && bun run test && bun test ./legacy/tests",
+    "test:native": "bun scripts/check-native.ts",
+    "test:package": "bun run build && bun test ./smoke/package.test.ts && bun run test:native"
+  },
+  "dependencies": { "@letta-ai/trajectory": "0.4.3" },
+  "optionalDependencies": { "onnxruntime-node": "^1.29.0" },
+  "devDependencies": { "@types/node": "^22.20.1", "@types/bun": "1.3.14", "typescript": "^5.9.3" },
+  "repository": { "type": "git", "url": "git+https://github.com/archeism/oh-my-ai.git", "directory": "packages/trajectories" },
+  "publishConfig": { "access": "public" }
 }

package/skills/trajectories/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: trajectories
+description: >-
+  Search and inspect coding-agent history across native harnesses, find past
+  conversations and tool calls, inspect recent activity, and prepare portable
+  session history with the Trajectories CLI. Successor to the Ledger agent skill.
+---
+
+# Trajectories
+
+Use the `trajectories` CLI for cross-harness history and portable sessions. The
+conversion SDK works in Node; the CLI requires Bun. Native execution stays in the
+harness. Conversion does not start an agent, execute tools, or move workspace files.
+
+## Search and recent activity
+
+```bash
+trajectories search "database migration" --source codex --limit 5 --robot --output-version 2
+trajectories recent --limit 5 --robot
+trajectories show codex:NATIVE_SESSION_ID --robot
+trajectories status --json
+trajectories scan --sources codex,claude-code --robot
+```
+
+The portable wrappers in `scripts/` prefer an installed `trajectories` command and
+otherwise use `dist/cli.js` from the package containing this skill. They resolve
+skill symlinks, work outside the checkout, and forward arguments without composing
+a shell command. Copying the skill without its package requires an installed CLI.
+
+```bash
+bash scripts/trajectories_search.sh "database migration" --output-version 2 --json
+bash scripts/trajectories_recent.sh --limit 5 --source codex
+```
+
+Wrappers add `--robot`; they preserve the v1 search format unless the caller opts
+into v2. Database precedence belongs to the CLI: explicit `--db PATH` or `--db=PATH`,
+then nonempty `TRAJECTORIES_DB`, then `LEDGER_DB`, then the existing
+`${XDG_DATA_HOME:-$HOME/.local/share}/ledger/ledger.sqlite`. This keeps the original
+Ledger index. For an older Mac Application Support or checkout-local database,
+select its absolute path explicitly and verify `status --json` before writing.
+Neither the wrappers nor the read commands move or initialize an existing store.
+
+### Read robot output accurately
+
+- Keep stdout and stderr separate. Stdout is JSONL, or JSON with `--json`; human
+  progress and v1 fallback warnings use stderr. Nonzero exit means failure.
+- New agents should use `search --robot --output-version 2`. Its first JSONL row is
+  `search_meta`, including when there are zero hits. With `--json`, the shape is
+  `{search_meta,hits}`. V1 emits hits only, a bare array with `--json`, or empty stdout
+  for zero hits; `recent --json` remains an array.
+- `count_precision: "lower_bound"` means the result count is bounded by `--limit`.
+  Inspect `requested_search_mode`, `search_mode`, `fallback_reason`, and `widened`
+  before calling a result exact, semantic, or complete.
+- Search snippets are excerpts with match markers, not complete transcripts.
+  Session fields include source, title, cwd, timestamps, model and record count.
+  Proven parentage appears as `parent_session_id`, `parent_title`, nickname and role;
+  null means unknown. Search v2 adds `match_type` for title/lexical/semantic/widened hits.
+- Plain multiword lexical queries are contiguous phrases. Use explicit FTS
+  operators such as `eval AND practice` for terms anywhere in a record.
+
+`--semantic` and `--hybrid` use stored embeddings. Missing vectors can fall back
+to lexical search; check the reported mode. `models pull` downloads the optional
+local model. Reads do not generate embeddings or migrate the database.
+
+`status --json` reports schema and counts, tombstones, source coverage and
+normalization diagnostics. Null coverage/diagnostics means an older store cannot
+provide that evidence; an empty current array means no observations/findings.
+`scan --robot` starts with `scan_outcomes`; missing, unreadable, wrong-shape or
+failed source roots remain explicit instead of appearing as successful empty scans.
+
+## Bounded indexing
+
+```bash
+trajectories sync --robot
+```
+
+Use periodic bounded `sync` for unattended ingestion. It exposes fresh/backlog
+lanes, configured/effective budgets, pressure, pending work and worker counts.
+`pending_budget`, `pending_retry`, `pending_pressure` and `wall_budget_exceeded`
+are resumable outcomes, not proof that ingestion finished. Do not disable pressure
+control or replace scheduled sync with `build`/`watch` merely to speed up backfill.
+
+`watch` is a foreground option with append checkpoints and periodic reconciliation;
+it does not apply the same catch-up budgets as `sync`. Historical always-on watching
+contributed to host I/O saturation. Install service definitions deliberately and
+verify bounded progress and resource limits on the target host.
+
+`delete ID --reason TEXT` records a tombstone, hides the session and refuses future
+reimport. `--hard` also removes stored records; `delete --list` reads the audit rows.
+Native files remain unchanged. Missing files and rescans do not imply deletion.
+
+## Portable session history
+
+```bash
+trajectories read /absolute/native/session.jsonl --from cc
+trajectories import /absolute/native/session.jsonl --from cc --session SESSION_ID --intent-id IMPORT_INTENT --cwd /absolute/workspace
+trajectories sessions
+trajectories session SESSION_ID
+trajectories show SESSION_ID --store /absolute/session-store
+trajectories index --store /absolute/session-store --robot
+trajectories show managed:SESSION_ID --robot
+trajectories switch SESSION_ID --to pi --out /absolute/new-directory --expected-head HEAD --intent-id PREPARE_INTENT
+```
+
+Stop the source before starting the prepared target. Read the export's diagnostics
+and native import/resume argument vectors; preserve each command's cwd. After the
+target completes, import its full native history with `--session ID`, the returned
+`--expected-head HEAD`, `--binding-id BINDING`, and a new `--intent-id IMPORT_INTENT`.
+Reuse the exact session, intent, parent and input on retries. A prepared binding
+advances the managed head; it never starts a harness. Stale or incomplete
+transitions fail rather than replacing the latest history. Native runtime caches,
+pending approvals, credentials, tools,
+filesystem state and opaque reasoning state are not portable through transcripts.
+
+Managed-session storage is selected by `--store`, `TRAJECTORIES_HOME`, or XDG data
+home/trajectories. `TRAJECTORIES_HOME` is a session-store path, not a package checkout
+or search database. Original native transcripts and conversion diagnostics remain
+evidence; normalized records do not provide raw archival retention for every
+historical session merely because `source_path` still points at it.
+
+`sessions` returns an ID-ordered page; continue with `--cursor` and choose the
+page size with `--limit`. For version 1 managed stores, stop native and Workflow
+writers, then use `trajectories migrate OLD_STORE --out NEW_STORE --writers-stopped`.
+The destination must be fresh; successful migration retains `migration.json` with
+session, head, capture and prepared binding mappings. Apply those mappings to
+caller state before resuming against the new store. Preserve the old source and
+any failed partial destination.
+
+`index --store` adds only each managed session's accepted complete history to the
+same lexical search DB, under a stable `managed:SESSION_ID`. Re-run after import;
+scheduled native `sync` does not do this. A harness switch replaces that indexed
+head. Each logical session has its own log; staged captures are not indexed.
+`show --store` reads the complete accepted log without initializing a search DB; `show` with
+an indexed id uses the read-only database. Managed search/recent rows use
+`source: managed`; records keep their original `source_type`, native-session id
+and prepared binding id. Indexed robot output labels its Ledger projection and
+points to `managed_log_path`. Use `show --store` for central record ids, complete
+payloads and origin. Search snippets are excerpts.

package/skills/trajectories/scripts/trajectories_recent.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Prefer the installed command when this skill is copied outside the package.
+# The CLI owns database resolution: --db > TRAJECTORIES_DB > LEDGER_DB >
+# the existing XDG data home/ledger/ledger.sqlite. Do not resolve a second DB here.
+if command -v trajectories >/dev/null 2>&1; then
+  exec trajectories recent "$@" --robot
+fi
+
+# Follow skill/script symlinks so the packaged fallback also works after deployment.
+SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+while [ -h "$SCRIPT_SOURCE" ]; do
+  SCRIPT_DIRECTORY="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+  SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+  [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SCRIPT_DIRECTORY/$SCRIPT_SOURCE"
+done
+SCRIPT_DIRECTORY="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+PACKAGE_ROOT="$(cd "$SCRIPT_DIRECTORY/../../.." && pwd)"
+CLI_BIN="$PACKAGE_ROOT/dist/cli.js"
+if [ ! -f "$CLI_BIN" ]; then
+  echo '{"error":{"code":"CLI_NOT_FOUND","message":"Install trajectories or build the package containing this skill."}}' >&2
+  exit 1
+fi
+
+exec bun "$CLI_BIN" recent "$@" --robot

package/skills/trajectories/scripts/trajectories_search.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Prefer the installed command when this skill is copied outside the package.
+# The CLI owns database resolution: --db > TRAJECTORIES_DB > LEDGER_DB >
+# the existing XDG data home/ledger/ledger.sqlite. Do not resolve a second DB here.
+if command -v trajectories >/dev/null 2>&1; then
+  exec trajectories search "$@" --robot
+fi
+
+# Follow skill/script symlinks so the packaged fallback also works after deployment.
+SCRIPT_SOURCE="${BASH_SOURCE[0]}"
+while [ -h "$SCRIPT_SOURCE" ]; do
+  SCRIPT_DIRECTORY="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+  SCRIPT_SOURCE="$(readlink "$SCRIPT_SOURCE")"
+  [[ "$SCRIPT_SOURCE" != /* ]] && SCRIPT_SOURCE="$SCRIPT_DIRECTORY/$SCRIPT_SOURCE"
+done
+SCRIPT_DIRECTORY="$(cd -P "$(dirname "$SCRIPT_SOURCE")" && pwd)"
+PACKAGE_ROOT="$(cd "$SCRIPT_DIRECTORY/../../.." && pwd)"
+CLI_BIN="$PACKAGE_ROOT/dist/cli.js"
+if [ ! -f "$CLI_BIN" ]; then
+  echo '{"error":{"code":"CLI_NOT_FOUND","message":"Install trajectories or build the package containing this skill."}}' >&2
+  exit 1
+fi
+
+exec bun "$CLI_BIN" search "$@" --robot

package/index.js

@@ -1 +0,0 @@
-module.exports = {};