Files
correx/core/config/AGENTS.md
T
kami 1b58bc325e wip(freestyle/acr): grounding & edit-tool fixes + ACR-compiler experiment
This branch's uncommitted WIP, committed together (entangled at file level).
Distinct pieces of work:

Freestyle QA fixes (this session):
- FileEditTool: pre-validate replace anchor in validateRequest — reject a
  missing/ambiguous target BEFORE the approval gate, mirroring read/write's
  file-not-found / read-before-write pre-checks. Shared not-found/ambiguous
  messages between validate and execute so they can't drift.
- PlanGrounder: add `scanned` flag; when no RepoMapComputedEvent was recorded,
  repoMapPaths is "unknown" not "empty workspace" — skip scope grounding
  (which proves a path ABSENT) so real paths (apps/server/**) aren't falsely
  rejected. Build-manifest check still runs.
- FreestyleDriver: wire scanned=(repoMap!=null); on plan rejection emit a
  session-terminal WorkflowFailedEvent so a rejected run reads FAILED, not the
  COMPLETED-lie (last verdict was the planning-phase WorkflowCompleted).
- ServerModule: resolve project-memory workspace root from the session's bound
  workspace (sessionWorkspaceRoot) instead of boot-static pm.repoRoot(), fixing
  the workspace-binding divergence (correx vs empty scratch dir). Retire tracked
  in Vikunja #266.
- LaunchRegistrationRaceTest: join registered jobs before asserting launchCount
  — computeIfAbsent returns the Job immediately but the fire-and-forget launch
  body lagged awaitAll (the 49-vs-50 flake).

ACR concept-compiler experiment (pre-existing WIP on this branch):
- ExecutionPlanCompiler/Model/PlanLinter, #264 needs-seam (sessionArtifacts),
  LSP diagnostics subsystem (LspDiagnosticEvents/Runner/Lsp4j), BootWorkspace,
  config surface, workflow prompts/schemas, orchestrator advance-don't-rerun.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-19 01:20:37 +04:00

1.8 KiB

core/config — AGENTS.md

Purpose

TOML configuration loading and live-reload: defines CorrexConfig (the top-level config shape), operator/project profiles, agent instructions, and read/write helpers.

Ownership

CORREX kernel team. Config schema changes affect all consumers — coordinate with apps/server and apps/cli.

Local Contracts

  • CorrexConfig — top-level @Serializable config data class.
  • ConfigHolder — mutable live config reference, updated on reload.
  • ConfigLoader — reads TOML from disk; CorrexConfigWriter writes it back.
  • EditableConfig — partial config for live patch operations (used by the TUI config editor).
  • OperatorProfile — operator-level persona and behavior settings.
  • ProjectProfile / ProjectProfileLoader / ProjectProfileWriter — project-scoped profile; loaded at session bind time.
  • AgentInstructions / AgentInstructionsLoader — per-role prompt fragments loaded from config.

Work Guidance

  • Config is read from disk; it is not event-sourced. Do not add event/state/reducer structures here.
  • ConfigHolder is the shared mutable reference injected into consumers. Never read the file directly in domain code — always go through ConfigHolder.
  • CorrexConfigWriter regenerates TOML from the in-memory model; round-tripping loses comments by design.
  • [git] is opt-in server transport configuration (enabled, remote, base_branch, optional author); it is off by default.
  • [orchestration].review_loop_max_cycles bounds review→rework cycles before recovery escalation; default 3.
  • ModelConfig.contextSize defaults to 24,576 tokens; explicit context_size remains the operator override for smaller local-model windows.

Verification

./gradlew :core:config:test --rerun-tasks

Child DOX Index

No child AGENTS.md (leaf module).