@phnx-labs/agents-cli 1.22.32 → 1.22.33

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.22.33
+
+- **Release tags are annotated with the folded changelog notes.** `scripts/release.sh` now creates `v<version>` as an annotated tag whose message is `Release <version>` plus the body of `.changelog/<version>.md` (the same notes that already become the release PR body). Agents keep writing one fragment under `.changelog/next/`; there is no separate tag-description channel. The already-published missing-tag recovery path uses the same helper with `--force`. Source: `apps/cli/scripts/release.sh`.
+
+`agents sessions --routines` once again opens the routine picker across every working directory instead of an empty current-repository session browser.
+
 ## 1.22.32
 
 - **Routines validate execution context before activation and fire once per schedule slot (RUSH-2290).** A routine selects one execution `project` plus a portable `cwd`; add/edit save proven blockers paused, durable slot and active-run claims prevent duplicate or overlapping launches, and every blocked/skipped/pre-spawn attempt remains visible without requiring a session transcript. Source: `apps/cli/src/lib/routine-context.ts`, `apps/cli/src/lib/routine-readiness.ts`, `apps/cli/src/lib/runner.ts`.

package/dist/commands/sessions-browser.js

@@ -18,7 +18,7 @@ import { discoverSessions } from '../lib/session/discover.js';
 import { gatherRemoteList } from '../lib/session/remote-list.js';
 import { resolveVersionAliasLoose } from '../lib/versions.js';
 import { AGENTS } from '../lib/agents.js';
-import { enrichTeamOrigins, safeTeamText } from '../lib/session/team-filter.js';
+import { enrichTeamOrigins, safeTeamText, shouldShowTeamSessions } from '../lib/session/team-filter.js';
 import { listBookmarks, toggleBookmark } from '../lib/session/bookmarks.js';
 import { machineId, normalizeHost } from '../lib/session/sync/config.js';
 import { buildPreview } from './sessions-picker.js';
@@ -280,7 +280,7 @@ async function fetchRawPool(f, self, local, hosts, fixedFilters = false) {
             origin: f.routine ? 'routine' : undefined,
             skill: f.skill,
             plugin: f.plugin,
-            excludeTeamOrigin: !f.teams,
+            excludeTeamOrigin: !shouldShowTeamSessions(f),
             // A team filter reaches back past the usual browse window, so the pool it
             // draws from has to as well — otherwise the newest 500 rows decide which
             // teams exist.

package/dist/commands/sessions.js

@@ -33,7 +33,7 @@ import { stringWidth, truncateToWidth, padToWidth, terminalWidth } from '../lib/
 import { inferSessionState } from '../lib/session/state.js';
 import { discoverSessions, queryIndexedSessions, countSessionsInScope, resolveSessionById, isCompleteSessionId, looksLikeSessionId, searchContentIndex, getSessionRoots, scopeToManaged } from '../lib/session/discover.js';
 import { findSessionsById, querySessions, getSessionById } from '../lib/session/db.js';
-import { filterTeamSessions, safeTeamText, groupSessionsByTeam, NO_TEAM_GROUP_KEY, } from '../lib/session/team-filter.js';
+import { filterTeamSessions, shouldShowTeamSessions, safeTeamText, groupSessionsByTeam, NO_TEAM_GROUP_KEY, } from '../lib/session/team-filter.js';
 import { parseSession } from '../lib/session/parse.js';
 import { runRemoteSessions, buildForwardedArgs, ensureWholeIndex } from '../lib/session/remote.js';
 import { formatRelativeTime, formatCompactAge, sessionAgeParts } from '../lib/session/relative-time.js';
@@ -1520,6 +1520,11 @@ export function hasNoBrowserDisqualifyingFlags(options, query) {
         !options.skill &&
         !options.plugin &&
         !options.sort &&
+        // --routine without a name owns a two-stage picker (routine -> run ->
+        // session), and a named routine owns the run-grouped overview. The generic
+        // browser can only flatten routine sessions into its ordinary row list, so
+        // routing this flag there silently bypasses both routine-specific views.
+        !options.routine &&
         !options.artifacts &&
         options.artifact === undefined &&
         // --cloud lists a provider's tasks, not the transcript index, and
@@ -2293,6 +2298,11 @@ limitSource) {
     // silently returns nothing for any team older than that — so the flag widens its
     // own scope, the way --all does, unless the caller set an explicit --limit.
     const wantsWholeTeam = !!options.inTeam;
+    // A routine is not tied to the shell's cwd: its archived sessions retain the
+    // working directory in which the scheduled agent actually ran. Scope the
+    // routine catalog across directories so invoking it from ~/.agents/.system,
+    // a project repo, or $HOME yields the same routine history.
+    const wantsWholeRoutine = !!options.routine;
     // `--limit` has a commander default, so an untouched flag still arrives as a
     // string and truthiness can't tell it from a typed one. Commander records where
     // each value came from, which is the only signal that distinguishes an explicit
@@ -2301,7 +2311,7 @@ limitSource) {
     const userSetLimit = limitSource === 'cli' || limitSource === 'env';
     const limit = wantsOverview
         ? OVERVIEW_POOL_LIMIT
-        : parseInt(userSetLimit ? options.limit : wantsWholeTeam ? String(WHOLE_TEAM_POOL_LIMIT) : DEFAULT_LIMIT, 10);
+        : parseInt(userSetLimit ? options.limit : wantsWholeTeam || wantsWholeRoutine ? String(WHOLE_TEAM_POOL_LIMIT) : DEFAULT_LIMIT, 10);
     if (toolEvidenceMode && (!Number.isSafeInteger(limit) || limit < 1 || limit > TOOL_QUERY_MAX_RESULT_SESSIONS)) {
         console.error(chalk.red(`Tool search --limit must be from 1 to ${TOOL_QUERY_MAX_RESULT_SESSIONS}.`));
         process.exitCode = 1;
@@ -2311,7 +2321,7 @@ limitSource) {
     // --since still narrows. Non-overview keeps the prior interactive-30d default.
     const since = wantsOverview
         ? options.since
-        : (options.since ?? (isInteractive && !options.all && !wantsWholeTeam ? '30d' : undefined));
+        : (options.since ?? (isInteractive && !options.all && !wantsWholeTeam && !wantsWholeRoutine ? '30d' : undefined));
     const toolSpansDevices = toolEvidenceMode
         && (options.fleet || (options.host?.length ?? 0) > 0);
     const toolSortError = toolSearchFleetSortError(options.sort, toolSpansDevices);
@@ -2335,12 +2345,12 @@ limitSource) {
             // --in-team spans directories by construction: a team's teammates run in
             // their own worktrees, so scoping to the current cwd hides most of the
             // lineage the flag exists to show.
-            all: pathFilter ? undefined : options.all || wantsWholeTeam || toolSpansDevices,
+            all: pathFilter ? undefined : options.all || wantsWholeTeam || wantsWholeRoutine || toolSpansDevices,
             cwd: process.cwd(),
             // Default overview scopes to the current repo SUBTREE (prefix match), so a
             // monorepo shows its sub-projects grouped instead of collapsing to the one
             // exact-cwd project. `--all` clears the prefix and spans the whole index.
-            cwdPrefix: pathFilter ?? (wantsOverview && !options.all && !wantsWholeTeam && !toolSpansDevices ? process.cwd() : undefined),
+            cwdPrefix: pathFilter ?? (wantsOverview && !options.all && !wantsWholeTeam && !wantsWholeRoutine && !toolSpansDevices ? process.cwd() : undefined),
             project: options.project,
             since,
             until: options.until,
@@ -2373,7 +2383,7 @@ limitSource) {
             const readOptions = {
                 ...scope,
                 limit,
-                excludeTeamOrigin: !options.teams,
+                excludeTeamOrigin: !shouldShowTeamSessions(options),
                 onProgress: tracker.onProgress,
                 includeUnmanaged: options.unmanaged,
                 onHiddenUnmanaged: (n) => { hiddenUnmanaged = n; },
@@ -2390,7 +2400,7 @@ limitSource) {
         // meta.json in ~/.agents/teams/agents whose is_team_origin flag was
         // never set (legacy rows). Keep the in-memory pass so those are still
         // enriched/hidden.
-        const { visible: visibleSessions } = filterTeamSessions(sessions, !!options.teams);
+        const { visible: visibleSessions } = filterTeamSessions(sessions, shouldShowTeamSessions(options));
         sessions = visibleSessions;
         // --in-team spans both ends of the lineage, so it can't be one SQL predicate:
         // the orchestrator matches on the scan-derived `spawnedTeam` column, while a
@@ -2458,7 +2468,7 @@ limitSource) {
         }
         // Under --in-team the visible list is one team, so the whole-index team-origin
         // count would be a non-sequitur next to it.
-        const hiddenCount = options.teams || options.inTeam
+        const hiddenCount = shouldShowTeamSessions(options) || options.inTeam
             ? 0
             : countSessionsInScope({ ...scope, onlyTeamOrigin: true });
         // A typed routine scope must apply before smart ID routing. Otherwise an ID
@@ -4607,9 +4617,9 @@ export function registerSessionsCommands(program) {
       # teammate row [<team>/<handle>]. --in-team narrows to one team's lineage.
       agents sessions --in-team redesign --teams
 
-      # Show routine-run sessions and open one by routine run id
-      agents sessions --routine --all
-      agents sessions --routine nightly-review --all
+      # Pick a routine across every directory, then open one of its run sessions
+      agents sessions --routine
+      agents sessions --routine nightly-review
       agents sessions 2026-07-21T10-30-00-000Z
 
       # Export for analysis
@@ -4657,7 +4667,7 @@ export function registerSessionsCommands(program) {
       - --first and --last are mutually exclusive.
       - A filter flag (--include/--exclude/--first/--last) without --markdown/--json defaults to --markdown output.
       - --cloud sources from Rush Cloud captured runs instead of local disk.
-      - --routine [name] shows transcripts archived from routine runs. On a TTY, omit the name to pick a routine; a name accepts exact, substring, or unambiguous typo matches. --routines is an alias. Routine rows also resolve by run id.
+      - --routine [name] spans every directory and shows transcripts archived from routine runs. On a TTY, omit the name to pick a routine; a name accepts exact, substring, or unambiguous typo matches. --routines is an alias. Routine rows also resolve by run id.
       - Without --teams, team-spawned sessions are hidden by default.
     `,
     });

package/dist/lib/session/team-filter.d.ts

@@ -44,6 +44,17 @@ export interface FilterResult {
     visible: SessionMeta[];
     hiddenCount: number;
 }
+/**
+ * Whether a listing scope must retain team-origin sessions.
+ *
+ * A routine owns every session produced during its run, including teammates and
+ * SDK-launched children. Requiring callers to add `--teams` would make a routine
+ * catalog incomplete and can make team-heavy routines appear to have no runs.
+ */
+export declare function shouldShowTeamSessions(filters: {
+    teams?: boolean;
+    routine?: boolean | string;
+}): boolean;
 /**
  * Split `sessions` into visible and hidden (team-origin) groups.
  * When `showTeams` is true every session is visible and `teamOrigin` is

package/dist/lib/session/team-filter.js

@@ -142,6 +142,16 @@ export function enrichTeamOrigins(sessions) {
         return origin ? { ...session, teamOrigin: origin } : session;
     });
 }
+/**
+ * Whether a listing scope must retain team-origin sessions.
+ *
+ * A routine owns every session produced during its run, including teammates and
+ * SDK-launched children. Requiring callers to add `--teams` would make a routine
+ * catalog incomplete and can make team-heavy routines appear to have no runs.
+ */
+export function shouldShowTeamSessions(filters) {
+    return !!filters.teams || !!filters.routine;
+}
 /**
  * Split `sessions` into visible and hidden (team-origin) groups.
  * When `showTeams` is true every session is visible and `teamOrigin` is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.22.32",
+  "version": "1.22.33",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",