Nick
3a22d99e9b
CI Pipeline / best-practices (push) Successful in 6s
Auto-label / priority-gate (pull_request) Skipped
CI Pipeline / canary (push) Successful in 34s
Auto-label / auto-label (pull_request) Successful in 3s
CI Pipeline / lint (push) Successful in 39s
CI Pipeline / documentation (push) Successful in 2s
CI Pipeline / gitea-offline (push) Successful in 15s
CI Pipeline / unit-tests (push) Failing after 54s
CI Pipeline / type-check (push) Successful in 29s
CI Pipeline / best-practices (pull_request) Successful in 3s
CI Pipeline / documentation (pull_request) Successful in 3s
CI Pipeline / gitea-offline (pull_request) Successful in 14s
CI Pipeline / lint (pull_request) Successful in 35s
CI Pipeline / required-checks (push) Successful in 1s
Spec gate (headless) / spec-gate (pull_request) Successful in 7s
CI Pipeline / type-check (pull_request) Successful in 27s
CI Pipeline / unit-tests (pull_request) Failing after 48s
CI Pipeline / canary (pull_request) Successful in 27s
CI Pipeline / required-checks (pull_request) Successful in 1s
RP10 proven (PR #279 merged, v0.56.0) — retirement per doctrine: REPLACEMENT PROVEN FIRST, RETIREMENT SECOND. Step 1 — consolidate: merged rp2-canonical-stage-model into master (zero conflicts). Master now carries the canonical stage model (ISSUE→INWARD→OUTWARD→APPLICABILITY→conditional INNOVATION→ADVERSARIAL (disposition)→SYNTHESIS→QUALIFY) plus the #161 harness. Step 2 — retire (each classified before removal): - scripts/research_backend.py: run_full_research() self-walking loop + --watch poll supervisor (SUPERSEDED, §26.6/26.7) - scripts/run_research_stage.py + scripts/run_agent_stage.py (+ its test): legacy single-stage runners (SUPERSEDED; no live imports — research_artifact references build_receipt in a docstring only) - .gitea/workflows/research-{dispatcher,stage-headless,backlog-sweep}.yml: legacy trigger paths (SUPERSEDED; trigger label stripped RP0) - prompts/research-stages/{define,outward_discovery,outward_reading}.md: split-stage templates (concepts survive as outward.md subsections) - repo-level research-pending trigger label deleted from Gitea (no issue carried it) KEPT (canonical reuse / compatibility): - research_artifact.py, research_event_relay.py, research_router.py, research_inward_context.py, research_prompt_compiler.py, research_define.py (ISSUE-gate compiler), research_task_tree.py + research_stage_executor.py (canonical authorities) - RETIRED_STAGES guard: retired names remain ONLY as the block that prevents them executing (they cannot authorize a live stage — regression-tested) - All historical evidence (research/issue-*, closed issues) preserved Docs updated: classification manifest (RETIRED entries), pipeline registry (retired-workflows section), lint-baseline shrunk 82→80 S110 / 356→352 BLE001 (deleted files carried lint debt). Regression: 1129 passed (was 1069 pre-merge — canonical pipeline tests joined), 0 henxel failures.
4.7 KiB
4.7 KiB
ResearchProcess code classification manifest (RP2/#265)
Doctrine: detection may be aggressive; deletion must be conservative.
This manifest classifies every research-execution code path. RP11/#274 EXECUTED 2026-09-09 — RP10 proven (PR #279 merged); safe paths retired:
research_backend.py (run_full_research self-walk + --watch), run_research_stage.py,
run_agent_stage.py (+ its test), the three legacy research workflows, and the
split-stage prompt templates. Retired stage names remain ONLY inside the
RETIRED_STAGES guard that blocks them.
Classifications: CURRENT | ADAPT | SUPERSEDED | COMPATIBILITY | TEST_FIXTURE | DEBUG_ONLY | UNKNOWN_PURPOSE
Canonical execution path (CURRENT)
| Path | Role | Notes |
|---|---|---|
scripts/research_task_tree.py |
canonical stage model | ISSUE→INWARD→OUTWARD→APPLICABILITY→(INNOVATION)→ADVERSARIAL→SYNTHESIS→QUALIFY; RETIRED_STAGES guard; conditional INNOVATION routing |
scripts/research_stage_executor.py |
one-stage executor | stage-trigger boundary, idempotency, placement gate wired into execute() |
scripts/research_define.py |
ISSUE gate compiler | deterministic, needs_mimo hardwired False (compat shim) |
scripts/research_inward_context.py |
INWARD context builder | deterministic + bounded MiMo flag |
scripts/research_prompt_compiler.py |
stage prompt compiler | canonical templates incl. issue.md, applicability.md |
scripts/research_event_relay.py |
event streaming | ResearchEventRelay, tool receipts |
scripts/research_artifact.py |
artifact validation | structured-artifact gate |
scripts/research_router.py |
OUTWARD routing | academic/software/web classification |
scripts/runner_evidence.py |
placement evidence | runtime hostname/runner capture + Pi rejection gate |
scripts/fake_worker.py |
TEST_FIXTURE | deterministic pipeline tests |
prompts/research-stages/*.md |
stage templates | issue.md + applicability.md added RP2 |
SUPERSEDED (retire in RP11 after RP10 proof; DO NOT DELETE NOW)
| Path | Superseded by | Classification | Evidence |
|---|---|---|---|
scripts/research_backend.py::run_full_research() |
one-stage-per-StageReady executor | RETIRED 2026-09-09 (self-walking loop, §26.6) | while stage_count < max_stages local advance loop; called by --issue CLI path and --watch loop |
scripts/research_backend.py --watch |
Gitea-authorized StageReady events | RETIRED 2026-09-09 (poll-loop supervisor, §26.7) | while True: gitea_api(...); time.sleep(POLL_INTERVAL) — deterministic reconciliation only, but watches+launches whole processes rather than single stages |
scripts/run_research_stage.py |
research_stage_executor.py |
ADAPT → verify before RP3 | single ref from one workflow |
scripts/run_agent_stage.py |
unified OUTWARD executor | UNKNOWN_PURPOSE | only self-referential test found; investigate in RP11 |
old stage names DEFINE/OUTWARD_DISCOVERY/OUTWARD_READING |
ISSUE / unified OUTWARD | COMPATIBILITY (executor returns RETIRED_STAGE; advance raises) | cannot become READY through canonical path — regression-tested |
prompts/research-stages/outward_discovery.md, outward_reading.md, define.md |
outward.md, issue.md | COMPATIBILITY (not routed by canonical compiler for new runs) | verify no dynamic selection in RP11 |
.gitea/workflows/research-dispatcher.yml, research-stage-headless.yml dispatch semantics |
StageReady → desktop executor | ADAPT | runs-on: rune-ci-desktop already correct; stage input default DEFINE must move to ISSUE |
Issues classified as disposable acceptance history (26.8)
- #245, #254, #255, #256, #260, #261, #262:
research-pendingtrigger labels removed 2026-09-08 (RP0) — no stale process can redispatch. - #263: closed+superseded with evidence note; artifacts preserved at
/mnt/workdrive/research-stage/research/issue-263/.
tui-restart-pending (legacy permission/restart mechanism)
Classification: SUPERSEDED CANDIDATE (not removed). The pending restart procedure existed to fix permission flags for the OLD research dispatch flow. The corrected canonical path does not depend on it. Verify before RP11 removal that no current hook still reads the flag file.
RP11 acceptance checklist (carried forward from handoff §26.11)
- one canonical authority per responsibility (stage model, StageReady, execution, eligibility, artifact schema, gate, persistence, TUI projection, runner placement, refinement routing)
- no production self-walking loop; no foreground sleep/poll supervisor
- no heavy-cognition path targeting the Pi
- old stage names cannot become READY (already proven: test_retired_stages_cannot_become_ready)
- one real progression issue still completes after cleanup