@agentprojectcontext/apx 1.75.0 → 1.76.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.75.0",
+  "version": "1.76.0",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/src/core/runtime-skills/apx-task/SKILL.md

@@ -17,6 +17,10 @@ apx task add "Demo for tester X" --project iacrmar --agent reviewer --tag demo -
 
 # List (defaults to open)
 apx task list --project iacrmar
+apx task list --all                          # every registered project, each row labelled
+apx task list --all --status blocked         # what is stuck, everywhere
+apx task list --all --updated-since 2026-08-01T00:00:00Z   # what moved
+apx task list --project iacrmar --status in_review
 apx task list --project iacrmar --state all
 apx task list --project iacrmar --state done
 apx task list --project iacrmar --tag urgent

package/src/core/stores/tasks.js

@@ -167,6 +167,20 @@ export function createTask(storagePath, fields) {
   return getTask(storagePath, id);
 }
 
+/**
+ * Newest first, with `id` as a tiebreak.
+ *
+ * The tiebreak is not cosmetic: nowIso() strips milliseconds, so every task
+ * created within the same SECOND shares a created_at — which is the norm when a
+ * routine files several at once. Without a second key the order of those rows
+ * is whatever the sort happened to do, and a list that reshuffles between two
+ * identical calls is worse than one that is merely arbitrary.
+ */
+function byNewest(a, b) {
+  const t = (b.created_at || "").localeCompare(a.created_at || "");
+  return t !== 0 ? t : String(b.id || "").localeCompare(String(a.id || ""));
+}
+
 /** List tasks with optional filters. */
 export function listTasks(storagePath, opts = {}) {
   const events = readAllEvents(storagePath);
@@ -190,13 +204,68 @@ export function listTasks(storagePath, opts = {}) {
   if (opts.due_after) {
     out = out.filter((t) => t.due && t.due >= opts.due_after);
   }
-  out.sort((a, b) => (b.created_at || "").localeCompare(a.created_at || ""));
+  // Workflow sub-status of an OPEN task (pending/running/in_review/blocked).
+  // Orthogonal to `state` — "what is blocked right now" is a different question
+  // from "what is open".
+  if (opts.status) {
+    out = out.filter((t) => t.status === opts.status);
+  }
+  // Everything touched since a moment. The cheapest way to ask "what moved?".
+  if (opts.updated_since) {
+    out = out.filter((t) => (t.updated_at || t.created_at || "") >= opts.updated_since);
+  }
+  out.sort(byNewest);
   if (opts.limit && Number.isFinite(opts.limit)) {
     out = out.slice(0, opts.limit);
   }
   return out;
 }
 
+/**
+ * The same query, folded across every registered project.
+ *
+ * Lives in core rather than in the daemon route because the CLI, the HTTP API
+ * and the panel all need it, and AGENTS.md rule 8 puts a shared operation in
+ * one home with the surfaces as adapters. The caller supplies the project list
+ * so this stays free of daemon and config imports.
+ *
+ * A project whose task log is unreadable is SKIPPED, not fatal: one corrupt
+ * JSONL file must not blank out the cross-project view. Skipped ids are
+ * returned so a surface can say so instead of quietly showing less.
+ *
+ * @param {{id: any, name?: string, path?: string, storagePath: string}[]} projects
+ * @param {object} opts  Same filters as listTasks, plus `limit` applied AFTER
+ *                       the merge (a per-project limit would silently favour
+ *                       whichever project sorts first).
+ * @returns {{ tasks: object[], skipped: {id: any, error: string}[] }}
+ */
+export function listTasksAcrossProjects(projects, opts = {}) {
+  const { limit, ...perProject } = opts || {};
+  const tasks = [];
+  const skipped = [];
+
+  for (const entry of projects || []) {
+    if (!entry?.storagePath) continue;
+    try {
+      for (const t of listTasks(entry.storagePath, perProject)) {
+        tasks.push({
+          ...t,
+          project_id: entry.id,
+          project_name: entry.name || entry.path || String(entry.id),
+        });
+      }
+    } catch (e) {
+      skipped.push({ id: entry.id, error: e?.message || String(e) });
+    }
+  }
+
+  tasks.sort(byNewest);
+  return {
+    tasks: Number.isFinite(limit) && limit > 0 ? tasks.slice(0, limit) : tasks,
+    skipped,
+  };
+}
+
 /** Get a single task by id or by id prefix (≥ 3 chars, must be unique). */
 export function getTask(storagePath, idOrPrefix) {
   if (!idOrPrefix || typeof idOrPrefix !== "string") return null;

package/src/host/daemon/api/tasks.js

@@ -1,5 +1,8 @@
-// Per-project tasks (TODOs). Backed by core/stores/tasks.js (JSONL event log).
-//   GET    /projects/:pid/tasks                  ?state=open|done|dropped|all&tag=X&agent=Y&due_before=ISO&limit=N
+// Tasks (TODOs). Backed by core/stores/tasks.js (JSONL event log).
+//   GET    /tasks                                cross-project; same filters, plus ?offset
+//   GET    /projects/:pid/tasks                  ?state=open|done|dropped|all&tag=X&agent=Y
+//                                                &due_before=ISO&due_after=ISO&limit=N
+//                                                &status=pending|running|in_review|blocked&updated_since=ISO
 //   POST   /projects/:pid/tasks                  { title, body?, tags?, due?, agent?, source?, meta? }
 //   GET    /projects/:pid/tasks/:id              (id or prefix)
 //   PATCH  /projects/:pid/tasks/:id              { patch: {...} }
@@ -9,6 +12,7 @@
 import {
   createTask,
   listTasks,
+  listTasksAcrossProjects,
   getTask,
   patchTask,
   doneTask,
@@ -25,21 +29,36 @@ export function register(app, { project, projects }) {
   // envelope. Paginated via ?limit & ?offset; with no limit, data is the full
   // set as one page.
   app.get("/tasks", (req, res) => {
-    const state = req.query.state || "open";
-    const out = [];
+    const { state, tag, agent, due_before, due_after, status, updated_since } = req.query;
+
+    // Resolve the registered projects to what core needs, dropping any the
+    // manager can no longer open.
+    const entries = [];
     for (const entry of projects.list()) {
       const p = projects.get(entry.id);
-      if (!p) continue;
-      let tasks = [];
-      try {
-        tasks = listTasks(p.storagePath, {
-          state: state === "all" ? undefined : state,
-        });
-      } catch { /* skip project */ }
-      for (const t of tasks) out.push({ ...t, project_id: entry.id, project_name: entry.name || entry.path });
+      if (!p?.storagePath) continue;
+      entries.push({
+        id: entry.id,
+        name: entry.name || entry.path,
+        path: entry.path,
+        storagePath: p.storagePath,
+      });
     }
-    out.sort((a, b) => (b.created_at || "").localeCompare(a.created_at || ""));
-    res.json(pageEnvelope(out, req.query));
+
+    const { tasks, skipped } = listTasksAcrossProjects(entries, {
+      state: state === "all" ? undefined : (state || "open"),
+      tag: tag || undefined,
+      agent: agent || undefined,
+      due_before: due_before || undefined,
+      due_after: due_after || undefined,
+      status: status || undefined,
+      updated_since: updated_since || undefined,
+    });
+
+    const envelope = pageEnvelope(tasks, req.query);
+    // Say when a project could not be read rather than quietly showing less.
+    if (skipped.length) envelope.meta = { ...(envelope.meta || {}), skipped };
+    res.json(envelope);
   });
 
   // Per-project tasks. Returns a { meta, data } envelope; with no ?limit the
@@ -47,13 +66,15 @@ export function register(app, { project, projects }) {
   app.get("/projects/:pid/tasks", (req, res) => {
     const p = project(req, res);
     if (!p) return;
-    const { state, tag, agent, due_before, due_after } = req.query;
+    const { state, tag, agent, due_before, due_after, status, updated_since } = req.query;
     const all = listTasks(p.storagePath, {
       state: state || undefined,
       tag: tag || undefined,
       agent: agent || undefined,
       due_before: due_before || undefined,
       due_after: due_after || undefined,
+      status: status || undefined,
+      updated_since: updated_since || undefined,
     });
     res.json(pageEnvelope(all, req.query));
   });

package/src/interfaces/cli/commands/task.js

@@ -1,7 +1,8 @@
 // apx task — per-project TODO list. Backed by /projects/:pid/tasks.
 //
 //   apx task add "<title>" [--project X] [--body Y] [--tag t] [--due 2026-05-30] [--agent A]
-//   apx task list          [--project X] [--state open|done|dropped|all] [--tag X] [--agent Y] [--due-before ISO] [--limit N]
+//   apx task list          [--all | --project X] [--state ...] [--status ...] [--tag X] [--agent Y]
+//                          [--due-before ISO] [--due-after ISO] [--updated-since ISO] [--limit N]
 //   apx task show <id>     [--project X]
 //   apx task done <id>     [--project X] [--by name]
 //   apx task drop <id>     [--project X] [--by name]
@@ -18,7 +19,7 @@ import { resolveProjectId } from "./project.js";
 // ── Usage strings (also used by index.js help topics) ────────────────────────
 export const TASK_USAGE = {
   add:    'apx task add "<title>" [--project X] [--body Y] [--tag t]... [--due 2026-05-30] [--agent A]',
-  list:   "apx task list [--project X] [--state open|done|dropped|all] [--tag X] [--agent Y] [--due-before ISO] [--limit N]",
+  list:   "apx task list [--all | --project X] [--state open|done|dropped|all] [--status pending|running|in_review|blocked] [--tag X] [--agent Y] [--due-before ISO] [--due-after ISO] [--updated-since ISO] [--limit N]",
   show:   "apx task show <id> [--project X]",
   done:   "apx task done <id> [--project X] [--by name]",
   drop:   "apx task drop <id> [--project X] [--by name]",
@@ -44,14 +45,20 @@ function shortTs(iso) {
   return String(iso).replace(/T/, " ").replace(/Z$/, "").slice(0, 16);
 }
 
-function renderTable(rows) {
+function renderTable(rows, { showProject = false } = {}) {
   if (!rows.length) {
     console.log("(no tasks)");
     return;
   }
-  const idW = Math.max(...rows.map((r) => r.id.length), 4);
+  const idW = Math.max(...rows.map((r) => String(r.id).length), 4);
+  const projW = showProject
+    ? Math.min(Math.max(...rows.map((r) => String(r.project_name || "").length), 7), 20)
+    : 0;
+  const proj = (t) => (showProject ? String(t.project_name || "").slice(0, projW).padEnd(projW) + "  " : "");
+
   console.log(
     "ID".padEnd(idW) + "  " +
+    (showProject ? "PROJECT".padEnd(projW) + "  " : "") +
     "STATE".padEnd(7) + "  " +
     "DUE".padEnd(10) + "  " +
     "TAGS".padEnd(18) + "  " +
@@ -61,7 +68,8 @@ function renderTable(rows) {
     const tags = (t.tags || []).join(",").slice(0, 18).padEnd(18);
     const title = (t.title || "").slice(0, 60);
     console.log(
-      t.id.padEnd(idW) + "  " +
+      String(t.id).padEnd(idW) + "  " +
+      proj(t) +
       (t.state || "open").padEnd(7) + "  " +
       (t.due || "—").padEnd(10) + "  " +
       tags + "  " +
@@ -105,17 +113,40 @@ export async function cmdTaskAdd(args) {
 }
 
 // ── list ──────────────────────────────────────────────────────────────────────
+// The list endpoints answer with a { meta, data } envelope. Older callers here
+// treated the response as a bare array, which made `apx task list` print
+// "(no tasks)" no matter what — the rows were sitting in `.data`.
+function unwrap(res) {
+  if (Array.isArray(res)) return { rows: res, meta: null };
+  return { rows: Array.isArray(res?.data) ? res.data : [], meta: res?.meta || null };
+}
+
 export async function cmdTaskList(args) {
-  const pid = await resolveProjectId(args?.flags?.project);
   const params = new URLSearchParams();
-  if (args.flags?.state)          params.set("state", args.flags.state);
-  if (args.flags?.tag)            params.set("tag", args.flags.tag);
-  if (args.flags?.agent)          params.set("agent", args.flags.agent);
-  if (args.flags?.["due-before"]) params.set("due_before", args.flags["due-before"]);
-  if (args.flags?.limit)          params.set("limit", String(args.flags.limit));
+  if (args.flags?.state)             params.set("state", args.flags.state);
+  if (args.flags?.tag)               params.set("tag", args.flags.tag);
+  if (args.flags?.agent)             params.set("agent", args.flags.agent);
+  if (args.flags?.status)            params.set("status", args.flags.status);
+  if (args.flags?.["due-before"])    params.set("due_before", args.flags["due-before"]);
+  if (args.flags?.["due-after"])     params.set("due_after", args.flags["due-after"]);
+  if (args.flags?.["updated-since"]) params.set("updated_since", args.flags["updated-since"]);
+  if (args.flags?.limit)             params.set("limit", String(args.flags.limit));
   const qs = params.toString();
-  const rows = await http.get(`/projects/${pid}/tasks${qs ? "?" + qs : ""}`);
-  renderTable(rows);
+
+  // --all folds every registered project into one list, each row carrying the
+  // project it came from. Without it, behaviour is exactly as before.
+  const all = !!args.flags?.all;
+  const path = all
+    ? `/tasks${qs ? "?" + qs : ""}`
+    : `/projects/${await resolveProjectId(args?.flags?.project)}/tasks${qs ? "?" + qs : ""}`;
+
+  const { rows, meta } = unwrap(await http.get(path));
+  renderTable(rows, { showProject: all });
+
+  // A project whose task log could not be read is reported, never swallowed.
+  for (const s of meta?.skipped || []) {
+    console.error(`warning: project #${s.id} skipped — ${s.error}`);
+  }
 }
 
 // ── show ──────────────────────────────────────────────────────────────────────

package/src/interfaces/cli/index.js

@@ -1666,10 +1666,16 @@ const HELP_TOPICS = new Map(Object.entries({
       ["reopen <id>", "Reopen a done or dropped task."],
       ["patch | edit <id>", "Edit fields on an existing task."],
     ],
-    options: [["--project <name|id|path>", "Pin command to a specific project."]],
+    options: [
+      ["--project <name|id|path>", "Pin command to a specific project."],
+      ["--all", "list: fold every registered project into one list, each row labelled."],
+      ["--status <s>", "list: workflow sub-status — pending | running | in_review | blocked."],
+      ["--updated-since <ISO>", "list: only what moved since that moment."],
+    ],
     examples: [
       "apx task add \"Ship release notes\" --tag release --due 2026-06-01",
       "apx task list --state open --tag release",
+      "apx task list --all --status blocked",
       "apx task done t_abc123",
     ],
   }),