feat(agents): publish recorded repository scope (#1701, slice 3)

[decode2]

Linked issue

Refs #1701

PR type

• New feature (type:feature)

Summary

• Publish recorded canonical host/child/registered-worktree roots, common-directory clone hashes, resolution time/source and explicit unknowns.
• Reuse existing resolver, task ownership and durable registry; bound derived snapshots and avoid Git probes on stable heartbeats/token updates.
• Preserve legacy activity headers, optional metadata fallback and exact omission counts.

Changes

Surface	Change
lib/orchestrator-scope.ts	Bounded derived cache, canonical clone correlation and literal-path safeguards.
Presence/discovery modules	Optional bounded scope; malformed/legacy fallback; no authority.
extensions/gentle-agents.ts	Publication/rendering and membership/session invalidation.
Scope/discovery/agent tests	Real Git fixtures, associations, compatibility, omissions and lifecycle.
Activity docs and ODD	Sources, limits, evidence and rollback.

Verification

• Meaningful RED/GREEN for host/child scope and Unicode-twin repository collision.
• Final scope/presence/discovery/agents suite: 197 passed, 0 failed.
• Type ratchet: 186 recorded diagnostics, no regressions, not clean compilation.
• Runtime modules: 8 match; diff whitespace check passed.
• Actual public Pi SDK integration: two isolated sessions, real registered tools, aliases, both host roots, distinct clone hashes, rename and session replacement.
• One injected in-memory child adapter verified delegated scope; child execution remained simulated.
• 1,000 stable projections: zero additional resolver calls or Git processes.
• All 15 resolver-normalized Unicode separators independently tested at input/output/sidecar boundaries; unknown rather than wrong identity.
• Local deterministic provider only, zero outbound/paid calls; temporary runtimes/fixtures disposed and removed.
• Native assessment: medium, runtime large writer, under budget; writer self-verification stands; additional read-only spot check performed.
• Full CI/platform checks pending; interactive TUI and native Windows were not exercised locally.

Contributor checklist

• Approved issue referenced, exactly one type label.
• Tests/docs with behavior, Conventional Commits, no AI attribution.
• No shell/skill changes; shellcheck/skill-load checks N/A.
• Raw common-directory paths and remote URLs not published. Recorded scope never grants admission, messaging or delivery authority.

Chain context

Field	Value
Strategy / position	Stacked PRs / 3
Base / dependency	feat/1701-session-subject-scope, #1715
Starts at	20d265aa
Ends with	Bounded recorded repository/worktree scope
Follow-up	Bounded continuation beyond first eight facts; #1702 metadata/parallel consultations and owner-only decisions.
Review budget	369 changed lines / 400
Rollback	Scope helper, optional projection/rendering and tests/docs; earlier identity/labels/activity/transport remain.

main
 └── #1714 Recognizable discovery
      └── #1715 Subject aliases
           └── 📍 This PR: recorded repository scope
                └── Next: continuation / consultations

No #1701 closure yet. Eight-child/eight-registered-root and byte bounds expose exact omissions, not a complete global writer inventory. Historical registered entries describe recorded context, not current/exclusive ownership. Different clone hashes or paths do not prove absence of shared external artifacts. Unicode paths requiring the existing spelling resolver's normalization remain unknown instead of being rewritten into another directory. No merge, auto-merge, push to main or runtime reload.

Summary by CodeRabbit

• New Features
  • Orchestrator activity and listings now include repository details for the host workspace, child tasks, and registered worktrees, including clone information when available.
  • Scope results indicate when information is incomplete and how many entries were omitted. Unresolved or unsafe paths are reported as unknown, while session and workspace details remain available.
  • Repository details refresh when the active worktree changes; existing sidecars remain compatible.
• Documentation
  • Updated guidance on repository scope, coverage limits, and how recorded workspace information is represented.

[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: b5c3377f-eec8-46dd-8e4a-334ff952dc45

📥 Commits

Reviewing files that changed from the base of the PR and between 1cbfe01 and 19a1f5e.

📒 Files selected for processing (9)

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

 ____________________________
< Try...catch me if you can. >
 ----------------------------
  \
   \   (\__/)
       (•ㅅ•)
       / 　 づ

✨ 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.}