feat(agents): paginate published task and workspace metadata

[decode2]

Linked issue

Refs #1701 (approved). No automatic closure: actual SDK continuation acceptance and final issue audit remain pending.

Stack

Unit 4; incorporates after #1720. Previous: #1714 → #1715 → #1720 → this PR. Base feat/1701-repository-scope. Further consultation units will stack here.

PR type

• New feature (type:feature)

Summary

• Continue owned task summaries and recorded registered-workspace paths past eight through the existing orchestrator_list tool.
• Read private, bounded, activation/snapshot-pinned projections without Git probes, model calls, child launches or receiver wakeups.
• Keep continuation stable during private activity changes; reject genuinely changed public catalogs, wrong peers, replacements and tampered cursors.

Changes

Path	Change
lib/orchestrator-catalog.ts	Detached whitelist, bounded snapshot validation and opaque paging
lib/orchestrator-presence.ts	Private sibling storage and publisher-owned cleanup; unchanged schema-1 headers
lib/orchestrator-discovery.ts, extensions/gentle-agents.ts	Optional recipient/cursor lookup using existing owned task and registry sources
tests/orchestrator-catalog.test.ts, tests/gentle-agents.test.ts	Bounds, private-stream continuation, source changes, invalid storage and registered-tool coverage
docs/gentle-agents-activity.md, odd/tasks/agent-coordination.md	Contract, provenance, acceptance gaps and evidence

Test plan

• Meaningful RED: private-only activity advanced the legacy generation and lost continuation (196 pass, 1 fail). GREEN after correction: 197 pass.
• node --experimental-strip-types --test tests/orchestrator-catalog.test.ts tests/orchestrator-presence.test.ts tests/orchestrator-discovery.test.ts tests/gentle-agents.test.ts (197/197).
• node scripts/check-types.mjs (186 baseline diagnostics, no regressions; not clean compilation).
• node scripts/build-runtime-modules.mjs --check (8 modules match).
• git diff HEAD --check.
• Native behavior review review-657ff6e298bd22b3: approved and acknowledged/burned; one non-blocking catalog-write-isolation advisory is later work.
• Actual SDK continuation execution: deferred to a separate acceptance unit; attempted adapter command failed MODULE_NOT_FOUND. No interactive TUI or native Windows proof claimed.

Limits

64 KiB per snapshot, 64 tasks plus 64 registered paths, eight of each per page, at most eight pages, exact omitted counts. Additional recorded paths are not freshly resolved Git identities or an exclusive/global writer inventory. No threads, prompts, results, conversations, credentials or authority enter the catalog.

Contributor checklist

• Approved issue linked nonclosing; exactly one selected type label.
• Behavior tests and docs included; conventional commits without attribution trailers.
• Shellcheck and changed-skill checks not applicable (no shell or skill changes).
• Remote required checks, pending after publication.

No merge, auto-merge or runtime reload is authorized.

Summary by CodeRabbit

• New Features
  • Orchestrator listings now include recorded task and workspace metadata, with cursor-based pagination for larger catalogs.
  • Catalog pages are bounded and tied to the selected session and catalog snapshot. If catalog data or a cursor is unavailable or invalid, existing headers and activity remain visible.
  • Registered worktree roots are included in published catalog metadata.
• Bug Fixes
  • Catalog continuation tokens remain valid when private activity changes, but are rejected when the public catalog changes.

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

• Configuration used: Repository UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 8ed68dcf-d598-419f-80ed-8765305f29a1

📥 Commits

Reviewing files that changed from the base of the PR and between 9f597f2 and 22926f9.

📒 Files selected for processing (8)

• docs/gentle-agents-activity.md
• extensions/gentle-agents.ts
• lib/orchestrator-catalog.ts
• lib/orchestrator-discovery.ts
• lib/orchestrator-presence.ts
• odd/tasks/agent-coordination.md
• tests/gentle-agents.test.ts
• tests/orchestrator-catalog.test.ts

 ___________________________________
< Not your grandma's code reviewer. >
 -----------------------------------
  \
   \   \
        \ /\
        ( )
      .( o ).

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}