whetstone_DSL/docs/AGENT_HANDOFF_2026-03-08_cross_project_targeting.md

Agent Handoff - 2026-03-08 - Cross-Project Target Grounding (GR-027)

Scope

This handoff captures work completed on the open gap GR-027 (cross-project task targeting mismatch) in Whetstone taskitem generation/validation.

Problem Addressed

Cross-repo orchestration specs were producing Whetstone-internal targetFiles (editor/src/..., tools/mcp/...) even when the workspace was set to /home/bill/Documents and the spec explicitly targeted external repos.

What Was Implemented

1) Generator/Queue cross-project mismatch detection

File: editor/src/mcp/RegisterArchitectIntakeTools.h

• Added cross-project repo signal detection from normalized requirements.
• Added cross-project fallback target grounding when strict execution contract is enabled and targetFiles are otherwise missing.
• Added queue blocker cross_project_target_mismatch when cross-project intent is detected but generated targets are internal-only.
• Added blocker metadata mapping for cross_project_target_mismatch to gap class cross_project_targeting_gap and remediation hints.

2) Validator mismatch classification

File: editor/src/mcp/RegisterValidationTools.h

• Extended whetstone_validate_taskitem schema with optional expected_project_roots.
• Added cross-project mismatch detection in validation results.
• Added gap class mapping cross_project_targeting_gap and recommended tool routing for that class.

3) Semantic artifact-file injection into pipeline

File: tools/mcp/run_sprint_taskitem_pipeline.sh

• Extended semantic requirement injection to derive requirement entries from contract required_artifacts backtick paths.
• Injected normalized requirements like explicit target file: cad_orchestrator/models.py.

4) Path extraction/normalization hardening

File: editor/src/mcp/RegisterArchitectIntakeTools.h

• Added normalization helpers for path-like tokens (including absolute /home/bill/Documents/... inputs).
• Added extraction of inline path tokens beyond code-fenced/backticked fragments.

5) Per-task target scoping for requirement-slice tasks

File: editor/src/mcp/RegisterArchitectIntakeTools.h

• Added task-level scoping so tasks titled Requirement Slice semantic-artifact-file-* receive only their corresponding single target file.
• Non-slice tasks currently keep the broader target set.

6) Tests updated

Files:

• editor/tests/step615_test.cpp

• editor/tests/step682_test.cpp

• Added focused checks for cross-project target grounding and validation mismatch classification.

Key Validation Runs

A) Cross-project roadmap run

• Run: logs/taskitem_runs/constcad_ecosystem_roadmap_20260308_093527
• Result: no internal default fallback; targetFiles grounded to cross-project targets.

B) SPRINT-005 run (pre file-level injection)

• Run: logs/taskitem_runs/sprint_005_execution_spec_whetstone_20260308_093527
• Result: repo-level targets (README-level grounding).

C) SPRINT-005 run (after file-level semantic injection)

• Run: logs/taskitem_runs/sprint_005_execution_spec_whetstone_20260308_101705
• Result: concrete cross-project files propagated into targetFiles.

D) SPRINT-005 run (after per-task scoping)

• Run: logs/taskitem_runs/sprint_005_execution_spec_whetstone_20260308_103102
• Result:
  • Requirement Slice semantic-artifact-file-* tasks have single-file targetFiles.
  • Composite/review tasks still carry broader file lists.

Current Status

• GR-027 core mismatch is addressed in generation, queue gating, and validation classification.
• Cross-project explicit file grounding is now present for hard specs that include artifact paths.
• Requirement-slice tasks are now narrowly scoped.

Suggested Next Steps

1. Scope non-slice tasks (Intake Foundation, Execution Readiness, Architect Review) into smaller deterministic file groups.
2. Add/refresh dedicated regression tests for:
   • queue blocker cross_project_target_mismatch
   • per-task single-file scoping behavior for semantic artifact slices.
3. Update docs/generator_readiness_gap_registry_2026-02-26.md to set GR-027 from open to partial or done after final acceptance criteria decision.