@trail-pm/cli 0.1.9 → 0.2.2

package/README.md

@@ -4,28 +4,21 @@
 
 ## Install
 
-**Recommended:** add it to your app repo, then invoke with **`npx trail`** (local install does **not** put `trail` on your shell `PATH`):
+**Recommended:** dev dependency in your app repo, then **`npx trail`**:
 
 ```bash
-npm install @trail-pm/cli
-# or: npm install -D @trail-pm/cli
+npm install -D @trail-pm/cli
 npx trail --help
-npx trail init --preset solo
+npx trail init
 ```
 
-**Global (optional):** `npm install -g @trail-pm/cli` → then **`trail`** works as a normal command.
+**Alternative:** `npm install -g @trail-pm/cli` so the `trail` binary is on your `PATH`.
 
-**Without installing:** use **`npx @trail-pm/cli <command>`** each time.
-
-Installing the package does **not** create `.trail/`; run **`npx trail init`** inside a git repo. Full guide:
-
-**https://github.com/joeydekruis/trail#installation**
+Full instructions: **https://github.com/joeydekruis/trail#installation**
 
 ## Usage
 
-```bash
-npx trail init --preset solo
-```
+Run **`npx trail init`** in a git repo; the CLI will ask for a sync preset unless you pass **`--preset`**.
 
 ## License
 

package/dist/{chunk-TDIYLUKH.js → chunk-YSTYANXJ.js}

@@ -510,8 +510,8 @@ var GitHubClient = class {
     this.token = token;
     this.baseUrl = normalizeBaseUrl(baseUrl);
   }
-  async request(method, path8, body) {
-    const url = `${this.baseUrl}${path8.startsWith("/") ? path8 : `/${path8}`}`;
+  async request(method, path9, body) {
+    const url = `${this.baseUrl}${path9.startsWith("/") ? path9 : `/${path9}`}`;
     const headers = new Headers({
       Authorization: `Bearer ${this.token}`,
       Accept: "application/vnd.github+json",
@@ -541,29 +541,29 @@ var GitHubClient = class {
       per_page: String(params.per_page),
       page: String(params.page)
     });
-    const path8 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues?${search}`;
-    const response = await this.request("GET", path8);
+    const path9 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues?${search}`;
+    const response = await this.request("GET", path9);
     return this.parseJson(response);
   }
   async getIssue(owner, repo, issueNumber) {
-    const path8 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`;
-    const response = await this.request("GET", path8);
+    const path9 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`;
+    const response = await this.request("GET", path9);
     return this.parseJson(response);
   }
   async updateIssue(owner, repo, issueNumber, patch) {
-    const path8 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`;
-    const response = await this.request("PATCH", path8, patch);
+    const path9 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`;
+    const response = await this.request("PATCH", path9, patch);
     return this.parseJson(response);
   }
   async createIssueComment(owner, repo, issueNumber, body) {
-    const path8 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}/comments`;
-    const response = await this.request("POST", path8, { body });
+    const path9 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}/comments`;
+    const response = await this.request("POST", path9, { body });
     return this.parseJson(response);
   }
   /** Create a new issue. Returns the created issue (same shape as list/get). */
   async createIssue(owner, repo, input) {
-    const path8 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues`;
-    const response = await this.request("POST", path8, {
+    const path9 = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues`;
+    const response = await this.request("POST", path9, {
       title: input.title,
       body: input.body ?? "",
       labels: input.labels ?? []
@@ -642,12 +642,64 @@ function taskToIssueUpdate(task) {
   };
 }
 
+// src/core/relevant-tasks.ts
+var NON_TERMINAL = [
+  "draft",
+  "todo",
+  "in_progress",
+  "in_review"
+];
+function isNonTerminalStatus(status) {
+  return NON_TERMINAL.includes(status);
+}
+function isActiveForRelevance(task) {
+  return isNonTerminalStatus(task.status);
+}
+function computeRelevantTaskIds(tasks) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const t of tasks) {
+    byId.set(t.id, t);
+  }
+  const relevant = /* @__PURE__ */ new Set();
+  const queue = [];
+  for (const t of tasks) {
+    if (isActiveForRelevance(t)) {
+      if (!relevant.has(t.id)) {
+        relevant.add(t.id);
+        queue.push(t.id);
+      }
+    }
+  }
+  function enqueue(id) {
+    if (relevant.has(id)) return;
+    relevant.add(id);
+    queue.push(id);
+  }
+  while (queue.length > 0) {
+    const id = queue.pop();
+    const task = byId.get(id);
+    if (!task) continue;
+    for (const d of task.depends_on) {
+      if (byId.has(d)) enqueue(d);
+    }
+    for (const b of task.blocks) {
+      if (byId.has(b)) enqueue(b);
+    }
+    if (task.parent != null && task.parent !== "" && byId.has(task.parent)) {
+      enqueue(task.parent);
+    }
+  }
+  return relevant;
+}
+
 // src/core/sync.ts
 var ISSUES_PER_PAGE = 100;
 async function pullSync(options) {
   const { client, owner, repo, tasksDir } = options;
   const now = options.now ?? /* @__PURE__ */ new Date();
+  const onProgress = options.onProgress;
   let page = 1;
+  let issuesSoFar = 0;
   for (; ; ) {
     const issues = await client.listIssues(owner, repo, {
       state: "all",
@@ -666,6 +718,13 @@ async function pullSync(options) {
       const task = issueToTask(issue, existing, now);
       writeTaskFile(filePath, task);
     }
+    issuesSoFar += issues.length;
+    onProgress?.({
+      phase: "pull",
+      page,
+      issuesInPage: issues.length,
+      issuesSoFar
+    });
     if (issues.length < ISSUES_PER_PAGE) {
       break;
     }
@@ -677,22 +736,49 @@ function isLinkedTask(task) {
 }
 async function pushSync(options) {
   const { client, owner, repo, tasks } = options;
-  for (const task of tasks) {
+  const only = options.onlyTaskIds;
+  const onProgress = options.onProgress;
+  const toPush = tasks.filter((task) => {
     if (task.status === "draft") {
-      continue;
+      return false;
+    }
+    if (!isLinkedTask(task)) {
+      return false;
     }
+    if (only !== void 0 && !only.has(task.id)) {
+      return false;
+    }
+    return true;
+  });
+  let index = 0;
+  for (const task of toPush) {
     if (!isLinkedTask(task)) {
       continue;
     }
+    index += 1;
+    onProgress?.({
+      phase: "push",
+      index,
+      total: toPush.length,
+      taskId: task.id
+    });
     const patch = taskToIssueUpdate(task);
     await client.updateIssue(owner, repo, task.github.issue_number, patch);
   }
 }
 async function fullSync(options) {
   const { client, owner, repo, tasksDir, snapshotPath, now } = options;
-  await pullSync({ client, owner, repo, tasksDir, now });
+  await pullSync({ client, owner, repo, tasksDir, now, onProgress: options.onProgress });
   const tasks = loadAllTasks(tasksDir);
-  await pushSync({ client, owner, repo, tasks });
+  const relevant = computeRelevantTaskIds(tasks);
+  await pushSync({
+    client,
+    owner,
+    repo,
+    tasks,
+    onlyTaskIds: relevant,
+    onProgress: options.onProgress
+  });
   const snapshot = compileSnapshot(tasks, now);
   writeSnapshot(snapshotPath, snapshot);
 }
@@ -1216,6 +1302,31 @@ function runInit(options) {
   console.log(`Initialized Trail project at ${root}`);
 }
 
+// src/cli/prompt-preset.ts
+import * as readline from "readline/promises";
+import { stdin, stdout } from "process";
+async function promptPresetWhenInteractive() {
+  const rl = readline.createInterface({ input: stdin, output: stdout });
+  try {
+    console.log("");
+    console.log("How should Trail sync with GitHub?");
+    console.log("  1 \u2014 Solo: you run `trail sync` when you want (typical for individual work)");
+    console.log(
+      "  2 \u2014 Collaborative: optional auto-pull before reads; good for shared repos"
+    );
+    console.log("  3 \u2014 Offline: local tasks only (no GitHub API)");
+    const raw = (await rl.question("Enter 1, 2, or 3 [1]: ")).trim();
+    const choice = raw === "" ? "1" : raw;
+    if (choice === "1") return "solo";
+    if (choice === "2") return "collaborative";
+    if (choice === "3") return "offline";
+    console.log("Unknown choice, using solo.");
+    return "solo";
+  } finally {
+    rl.close();
+  }
+}
+
 // src/cli/commands/next.ts
 async function runNext(options) {
   const { tasks } = await loadTrailReadContext(process.cwd());
@@ -1237,8 +1348,27 @@ async function runNext(options) {
 }
 
 // src/cli/commands/promote.ts
+import fs9 from "fs";
+import path8 from "path";
+
+// src/core/link-draft-issue.ts
 import fs8 from "fs";
 import path7 from "path";
+async function linkDraftToNewGitHubIssue(options) {
+  const { client, owner, repo, draft, draftFilePath, tasksDir, now } = options;
+  const issue = await client.createIssue(owner, repo, {
+    title: draft.title,
+    body: draft.description ?? "",
+    labels: draft.labels
+  });
+  const promoted = issueToTask(issue, draft, now);
+  fs8.unlinkSync(draftFilePath);
+  const newPath = path7.join(tasksDir, `${issue.number}.json`);
+  writeTaskFile(newPath, promoted);
+  return promoted;
+}
+
+// src/cli/commands/promote.ts
 async function runPromote(options) {
   const root = findTrailRoot(process.cwd());
   if (root === null) {
@@ -1250,7 +1380,7 @@ async function runPromote(options) {
     throw err;
   }
   const paths = trailPaths(root);
-  const raw = fs8.readFileSync(paths.configPath, "utf-8");
+  const raw = fs9.readFileSync(paths.configPath, "utf-8");
   const config = TrailConfigSchema.parse(JSON.parse(raw));
   if (config.sync.preset === "offline") {
     throw new Error("Cannot promote a draft in offline mode (no GitHub access).");
@@ -1273,19 +1403,19 @@ async function runPromote(options) {
   const now = /* @__PURE__ */ new Date();
   const client = new GitHubClient(tokenResult.token);
   const { owner, repo } = config.github;
-  const issue = await client.createIssue(owner, repo, {
-    title: draft.title,
-    body: draft.description || "",
-    labels: draft.labels
+  const promoted = await linkDraftToNewGitHubIssue({
+    client,
+    owner,
+    repo,
+    draft,
+    draftFilePath: resolved.filePath,
+    tasksDir: paths.tasksDir,
+    now
   });
-  const promoted = issueToTask(issue, draft, now);
-  fs8.unlinkSync(resolved.filePath);
-  const newPath = path7.join(paths.tasksDir, `${issue.number}.json`);
-  writeTaskFile(newPath, promoted);
   rebuildSnapshot(paths, now);
-  console.log(`Promoted ${draft.id} \u2192 GitHub issue #${issue.number}`);
-  console.log(`  File: ${newPath}`);
-  console.log(`  URL: ${issue.html_url}`);
+  console.log(`Promoted ${draft.id} \u2192 GitHub issue #${promoted.github?.issue_number}`);
+  console.log(`  File: ${path8.join(paths.tasksDir, `${promoted.github?.issue_number}.json`)}`);
+  console.log(`  URL: ${promoted.github?.url}`);
 }
 
 // src/cli/commands/show.ts
@@ -1336,7 +1466,28 @@ async function runStatus(options) {
 }
 
 // src/cli/commands/sync.ts
-import fs9 from "fs";
+import fs11 from "fs";
+
+// src/core/config-update.ts
+import fs10 from "fs";
+function writeLastFullSyncAt(paths, iso) {
+  const raw = fs10.readFileSync(paths.configPath, "utf-8");
+  const config = TrailConfigSchema.parse(JSON.parse(raw));
+  const next = { ...config, last_full_sync_at: iso };
+  fs10.writeFileSync(paths.configPath, `${JSON.stringify(next, null, 2)}
+`, "utf-8");
+}
+
+// src/cli/commands/sync.ts
+function logSyncProgress(p) {
+  if (p.phase === "pull") {
+    console.error(
+      `Sync: GitHub pull page ${p.page} \u2014 ${p.issuesInPage} issues (${p.issuesSoFar} total fetched so far)`
+    );
+  } else {
+    console.error(`Sync: pushing to GitHub ${p.index}/${p.total} (task ${p.taskId})`);
+  }
+}
 async function runSync(options) {
   const root = findTrailRoot(process.cwd());
   if (root === null) {
@@ -1348,7 +1499,7 @@ async function runSync(options) {
     throw err;
   }
   const paths = trailPaths(root);
-  const raw = fs9.readFileSync(paths.configPath, "utf-8");
+  const raw = fs11.readFileSync(paths.configPath, "utf-8");
   const config = TrailConfigSchema.parse(JSON.parse(raw));
   if (config.sync.preset === "offline") {
     throw new Error("Cannot sync in offline mode");
@@ -1363,19 +1514,35 @@ async function runSync(options) {
   const pullOnly = options.pull === true && options.push !== true;
   const pushOnly = options.push === true && options.pull !== true;
   if (pullOnly) {
-    await pullSync({ client, owner, repo, tasksDir });
+    await pullSync({ client, owner, repo, tasksDir, onProgress: logSyncProgress });
     return;
   }
   if (pushOnly) {
     const tasks = loadAllTasks(tasksDir);
-    await pushSync({ client, owner, repo, tasks });
+    const relevant = computeRelevantTaskIds(tasks);
+    await pushSync({
+      client,
+      owner,
+      repo,
+      tasks,
+      onlyTaskIds: relevant,
+      onProgress: logSyncProgress
+    });
     return;
   }
-  await fullSync({ client, owner, repo, tasksDir, snapshotPath });
+  await fullSync({
+    client,
+    owner,
+    repo,
+    tasksDir,
+    snapshotPath,
+    onProgress: logSyncProgress
+  });
+  writeLastFullSyncAt(paths, (/* @__PURE__ */ new Date()).toISOString());
 }
 
 // src/cli/commands/update.ts
-import fs10 from "fs";
+import fs12 from "fs";
 var STATUSES = [
   "draft",
   "todo",
@@ -1402,7 +1569,7 @@ async function runUpdate(options) {
     throw err;
   }
   const paths = trailPaths(root);
-  const raw = fs10.readFileSync(paths.configPath, "utf-8");
+  const raw = fs12.readFileSync(paths.configPath, "utf-8");
   const config = TrailConfigSchema.parse(JSON.parse(raw));
   const resolved = findTaskFileById(paths.tasksDir, options.id);
   if (resolved === null) {
@@ -1448,7 +1615,7 @@ async function runUpdate(options) {
 }
 
 // src/cli/commands/validate.ts
-import fs11 from "fs";
+import fs13 from "fs";
 async function runValidate() {
   const root = findTrailRoot(process.cwd());
   if (root === null) {
@@ -1460,7 +1627,7 @@ async function runValidate() {
     throw err;
   }
   const paths = trailPaths(root);
-  const raw = fs11.readFileSync(paths.configPath, "utf-8");
+  const raw = fs13.readFileSync(paths.configPath, "utf-8");
   TrailConfigSchema.parse(JSON.parse(raw));
   const tasks = loadAllTasks(paths.tasksDir);
   const snapshot = compileSnapshot(tasks);
@@ -1514,11 +1681,22 @@ async function runCli(argv) {
   const program = new Command();
   program.name("trail").description("GitHub-native task management CLI").version(readCliVersion());
   program.command("init").description("Initialize a Trail project in the current git repository").addOption(
-    new Option("--preset <name>", "Sync preset").choices(["solo", "collaborative", "offline"]).default("solo")
+    new Option(
+      "--preset <name>",
+      "Sync preset: solo | collaborative | offline (omit to choose in the terminal)"
+    ).choices(["solo", "collaborative", "offline"])
   ).option("--owner <name>", "GitHub repository owner (with --repo)").option("--repo <name>", "GitHub repository name (with --owner)").option("--skip-agents-md", "Do not write AGENTS.md at the repository root").action(
-    (opts) => {
+    async (opts) => {
+      let preset;
+      if (opts.preset !== void 0) {
+        preset = opts.preset;
+      } else if (process.stdin.isTTY) {
+        preset = await promptPresetWhenInteractive();
+      } else {
+        preset = "solo";
+      }
       runInit({
-        preset: opts.preset,
+        preset,
         owner: opts.owner,
         repo: opts.repo,
         skipAgentsMd: opts.skipAgentsMd === true
@@ -1602,7 +1780,7 @@ async function runCli(argv) {
     runContext({ id });
   });
   program.command("mcp").description("Run the Trail MCP server (stdio; for editor and agent integrations)").action(async () => {
-    const { runMcpServer } = await import("./run-mcp-server-HD7I5M7Z.js");
+    const { runMcpServer } = await import("./run-mcp-server-NKYRI73A.js");
     await runMcpServer();
   });
   await program.parseAsync(argv);
@@ -1621,4 +1799,4 @@ export {
   getCliFailureMessage,
   runCli
 };
-//# sourceMappingURL=chunk-TDIYLUKH.js.map
+//# sourceMappingURL=chunk-YSTYANXJ.js.map