Files

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.7 KiB

Raw Permalink Blame History

examples/ — AGENTS.md

Purpose

Reference configurations and workflow definitions that demonstrate how to use CORREX. These are runnable examples, not documentation prose.

Ownership

Kept in sync with the features they exercise. When a kernel contract changes (tool names, config keys, stage shape), update affected examples.

Local Contracts

workflows/ — TOML workflow definitions (decompose→gather→report, role_pipeline, review_loop, etc.) plus a prompts/ subdirectory for prompt text files referenced by those workflows. These are the canonical examples for the [tools.research] config and freestyle/plan workflows.
configs/ — currently empty; reserved for example correx.toml server configs.
plugins/ — currently empty; reserved for example plugin descriptors.
stages/ — currently empty; reserved for example stage definitions.

Each TOML file in workflows/ is a valid workflow loadable by the server. Keep them working against the current kernel API.

Work Guidance

Add a new workflow example when a major new workflow type ships.
Prompts referenced by TOML files go in workflows/prompts/.
Freestyle architect prompts specify stage constraints, boundaries, and verification goals; they do not prescribe an exact resulting file list when the authoritative intent leaves implementation details open.
Freestyle discovery emits a structured comprehension brief; the analyst emits the addressable dod artifact used as the fixed implementation/review rubric.
Do not add configs/plugins/stages stubs speculatively — populate when there is real content.

Verification

None yet.

Child DOX Index

No child AGENTS.md (leaf directory).

1.7 KiB Raw Permalink Blame History