feat: Multi-agent Phase 2 — directives resolve user context from execution

[chubes4]

Summary

Phase 2 of multi-agent support (#560). Directives now resolve user_id from execution context so each agent's files (SOUL.md, MEMORY.md, etc.) are read from the correct per-user directory.

Changes

7 files changed, 31 insertions, 9 deletions

Pipeline path

• RunFlowAbility — propagates flow's user_id to job record and engine snapshot
• AIStep — extracts user_id from engine snapshot into the payload passed to directives

Chat path

• ChatOrchestrator — threads user_id through options into loop_context
• All three callers (processChat, processContinue, processPing) pass user_id

Directives

• CoreMemoryFilesDirective — resolves user_id from $payload, passes to DirectoryManager::get_agent_directory()
• MemoryFilesReader::read() — accepts $user_id param (default 0 for backward compat)
• PipelineMemoryFilesDirective / FlowMemoryFilesDirective — pass user_id through to MemoryFilesReader

Data flow

Pipeline:  Flow (user_id) → RunFlowAbility → engine snapshot → AIStep → payload → Directives
Chat:      ChatOrchestrator (user_id) → options → loop_context → payload → Directives
System:    SystemAgent → user_id=0 (global, no agent scoping)

Backward Compatibility

All user_id parameters default to 0 — existing single-agent installs get the legacy shared agent directory with zero configuration changes.

Refs

Closes #565
Parent: #560

[github-actions]

Homeboy Results — data-machine

❌ lint (changed files only)

❌ test

• PHPCS: LINT SUMMARY: 233 errors, 199 warnings
• Fixable: 176 | Files with issues: 109 of 346

Top violations

  WordPress.Arrays.ArrayDeclarationSpacing.ArrayItemNoNewLine    93
  WordPress.DB.PreparedSQL.NotPrepared                       73
  Generic.CodeAnalysis.UnusedFunctionParameter.Found         36
  Generic.Formatting.MultipleStatementAlignment.NotSameWarning    35
  WordPress.Arrays.MultipleStatementAlignment.DoubleArrowNotAligned    35

- PHPStan: PHPSTAN SUMMARY: 135 errors at level 5 - BUILD FAILED: PHPUnit tests

❌ audit

---

Homeboy Action v1 — homeboy 0.53.0