kami
1b58bc325e
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>
35 lines
1.7 KiB
Markdown
35 lines
1.7 KiB
Markdown
# 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).
|