agent-ecosystem/src/features
777genius 2dcd5cb6a8 perf: align ps process-table cache TTL with the 2s consumer window
The runtime process table is read through a module-level executor cache (1s TTL)
but its consumers rebuild on a 2s snapshot-cache cadence and fire constantly during
a launch (every team file change invalidates a per-team snapshot). A 1s table TTL
is shorter than the 2s read cadence, so 'ps -ax' was re-spawned on essentially every
consumer rebuild for no freshness benefit -- a top main-thread cost in the warm
launch profile (~5-8%). Raise the table TTL to 2s to match the consumer window so
the spawn coalesces to at most once per consumer cycle.

Safe: liveness is identity-matched (team+agent+command), not bare-PID, and OpenCode
host cleanup re-validates each PID against live state before killing, so a ~2s-stale
table cannot cause a wrong liveness verdict or an unsafe kill -- it only widens an
already-tolerated display-staleness window by ~1s. No test asserts the TTL value.
2026-05-30 14:29:21 +03:00
..
agent-attachments refactor(agent-attachments): use agent image mime types directly 2026-05-26 23:44:40 +03:00
agent-graph fix(team): reconcile provisioned-but-not-alive bootstrap state 2026-05-27 12:16:41 +03:00
anthropic-runtime-profile fix(team): align Anthropic effort UI fallback 2026-05-19 21:27:50 +03:00
codex-account fix(codex-account): keep account snapshots fresh 2026-05-26 23:44:40 +03:00
codex-model-catalog feat: prefer orchestrator codex model catalog 2026-04-28 20:13:03 +03:00
codex-runtime-installer fix(ci): stabilize runtime release checks 2026-05-22 00:55:29 +03:00
codex-runtime-profile feat(team): expand opencode review and release support 2026-04-24 12:05:54 +03:00
localization fix: show OpenCode inventory fallback as available 2026-05-27 23:00:32 +03:00
member-log-stream fix(member-log-stream): simplify member logs view 2026-05-27 21:53:27 +03:00
member-work-sync fix(member-work-sync): recover stale nudge payload conflicts 2026-05-25 14:34:14 +03:00
recent-projects fix(recent-projects): guard context-scoped refreshes 2026-05-26 17:56:10 +03:00
running-teams feat(i18n): add localization foundation 2026-05-24 15:37:24 +03:00
runtime-provider-management fix(opencode): wire junction diagnostics on dev 2026-05-28 13:12:02 +03:00
team-runtime-lanes fix(team): reconcile provisioned-but-not-alive bootstrap state 2026-05-27 12:16:41 +03:00
tmux-installer perf: align ps process-table cache TTL with the 2s consumer window 2026-05-30 14:29:21 +03:00
workspace-trust fix(workspace-trust): canonicalize git worktree trust roots 2026-05-25 21:30:56 +03:00
CLAUDE.md fix(team): harden opencode delivery recovery 2026-05-14 15:11:40 +03:00
README.md fix(team): harden opencode delivery recovery 2026-05-14 15:11:40 +03:00

Features

This directory contains the canonical home for medium and large feature slices.

Before creating or refactoring a feature, read:

Reference examples:

  • recent-projects - full cross-process feature with contracts, core, main, preload, renderer, and focused tests
  • agent-graph - thin feature with core/domain and renderer integration only
  • codex-model-catalog and team-runtime-lanes - process-limited features that omit renderer or preload layers when they do not own those boundaries

Use src/features/<feature-name>/ by default when the work introduces:

  • a new use case or business policy
  • transport wiring
  • more than one process boundary
  • more than one adapter or provider

Feature-local docs should answer navigation questions:

  • which shape the feature uses
  • which entrypoints are public
  • where new adapters, rules, bridges, or renderer surfaces belong
  • what tests protect the behavior
  • which local files are the best examples for future changes

Do not duplicate architecture rules in feature folders. Keep the standard centralized in ../../docs/FEATURE_ARCHITECTURE_STANDARD.md.

Rule of thumb:

  • recent-projects is the full slice example with process-aware outer layers
  • agent-graph is the thin slice example built around core/ plus renderer/