Skip to content

docs(harness): mark Phase 1 complete + estimate-vs-actual retrospective - #3658

Merged
PattaraS merged 1 commit into
omnigent-ai:mainfrom
PattaraS:docs-harness-registry-phase1-retro
Jul 31, 2026
Merged

docs(harness): mark Phase 1 complete + estimate-vs-actual retrospective#3658
PattaraS merged 1 commit into
omnigent-ai:mainfrom
PattaraS:docs-harness-registry-phase1-retro

Conversation

@PattaraS

Copy link
Copy Markdown
Contributor

Related issue

N/A — housekeeping for the modular native-harness registry workstream (designs/harness-modular-registry-proposal.md).

Summary

Phase 1 of the refactor is complete (10 PRs, 2026-07-28 → 07-31). The design doc had accumulated drift over the stack — still reading "Phase 0 landed, 1.1–1.3 in review" and projecting ~2.5–3.5 calendar months. This brings it in line with what actually shipped:

  • Status / subtotal / effort summary / bottom line: forward-looking → Phase 1 complete, Phase 2 next.
  • Ledger: 1.8 (refactor(harness): fork_history + shell-tool capability axes; derive gating (PR 1.8) #3648) landed; 1.4 marked descoped with rationale (CLI-subcommand collapse is a local readability win, not a dispatch hub the seam must own; nothing in Phase 2 depends on it); the 1.7 opencode-e2e follow-up (test(e2e): fold opencode host e2e onto shared agent-name constant #3656) recorded; per-PR merge dates added.
  • Calibration → Phase 1 retrospective: estimate (~20–29 eng-days) vs. actual (10 PRs over 4 focused calendar days); the real cost centers enumerated per PR (test-shape churn + review-caught behavior bugs — the 1.2 commit-boundary defect, 1.5b-ii ordering bug, 1.7 magic-string regression, 1.8 reversed-spelling regression); the correct runner re-scope; the two intentional test-pinned behavior deltas (qwen error label, antigravity relay); and the recurring uv.lock-rewrite / full-suite-only-flake operational friction.

The plan tables (scope/dependencies) are left as the stable target; only the status, ledger, and estimate-vs-actual narrative changed.

Test Plan

Doc-only. pre-commit (whitespace/newline/merge-conflict/line-ending checks) passes.

Demo

N/A — documentation.

Type of change

  • Bug fix
  • Feature
  • UI / frontend change
  • Refactor / chore
  • Docs
  • Test / CI
  • Breaking change

Test coverage

  • Unit tests added / updated
  • Integration tests added / updated
  • E2E tests added / updated
  • Manual verification completed
  • Existing tests cover this change
  • Not applicable

Coverage notes

Documentation-only change to a design doc; no code paths affected, so no test coverage applies.

…ospective

Phase 1 of the modular native-harness registry refactor landed (10 PRs,
2026-07-28 → 07-31). Bring the design doc in line with what actually shipped:

- Status header, Phase 1 subtotal, effort summary, and bottom line updated from
  forward-looking ('1.1–1.3 in review') to Phase 1 complete / Phase 2 next.
- Ledger: 1.8 (omnigent-ai#3648) landed; 1.4 marked descoped (with rationale); the 1.7
  opencode-e2e follow-up (omnigent-ai#3656) recorded; per-PR merge dates added.
- Calibration rewritten as a Phase 1 retrospective: estimate (~20–29 eng-days)
  vs. actual (10 PRs / 4 calendar days), the real cost centers (test-shape churn
  + review-caught behavior bugs, enumerated per PR), the correct runner re-scope,
  the two intentional behavior deltas (qwen label, antigravity relay), and the
  recurring uv.lock / full-suite-only-flake operational friction.

Doc-only; no code change.

Co-authored-by: Isaac
Signed-off-by: Pat Sukprasert <pattara.sk127@gmail.com>
Copilot AI review requested due to automatic review settings July 31, 2026 06:10

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@github-actions github-actions Bot added the size/M Pull request size: M label Jul 31, 2026
@PattaraS
PattaraS merged commit 36b6515 into omnigent-ai:main Jul 31, 2026
55 checks passed
@github-actions github-actions Bot added the no-doc-update Merged PR does not need a docs update label Jul 31, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🏷️ Doc impact: no-doc-update

The change only updates an internal design proposal doc (designs/harness-modular-registry-proposal.md) with status/retrospective notes, altering no user-facing surface, integration, or built-in policy.

Auto-classified on merge. Set the label manually before merging to override. · run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-doc-update Merged PR does not need a docs update size/M Pull request size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants