Skip to content

docs(plans): full project review and APS work item tracking#13

Merged
joshuaboys merged 1 commit intomainfrom
docs/omo-project-review
Mar 13, 2026
Merged

docs(plans): full project review and APS work item tracking#13
joshuaboys merged 1 commit intomainfrom
docs/omo-project-review

Conversation

@joshuaboys
Copy link
Owner

Summary

  • Full project review document at plans/reviews-omo-review.md covering architecture, code quality, test coverage, CI/CD, and APS plan accuracy
  • 10 new APS work items (CORE-014..020, CLI-013..015) created from review findings, prioritized P0–P3
  • Fixed stale plan statuses: MCP-001 marked complete, M6 milestone updated

Review Highlights

Area Finding
Build/Test/Types/Lint ✅ All passing (39/39 tests)
Test coverage ⚠️ 11.2% overall — CLI has 0 command tests
Architecture Monolithic parser file (2,074 lines) needs splitting before M6
Package boundaries findCallers() duplicated in CLI + MCP, BUILTIN_METHODS misplaced in CLI
Kindling caching Scaffolded but not wired into analysis pipeline
Plan accuracy MCP-001 was complete but listed as Planned

Files Changed

  • plans/reviews-omo-review.md — New review document (397 lines)
  • plans/index.aps.md — Updated milestones, resequenced What's Next queue
  • plans/modules/distil-core.aps.md — 7 new tasks (CORE-014..020)
  • plans/modules/distil-cli.aps.md — 3 new tasks (CLI-013..015)
  • plans/modules/distil-mcp.aps.md — MCP-001 status → Complete

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fe80ef0b26

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a comprehensive project review document and updates APS planning artifacts to reflect the review findings and current project status (especially around MCP progress and new prioritized work items).

Changes:

  • Introduces plans/reviews-omo-review.md with an architecture/test/CI/plan-accuracy review and prioritized recommendations.
  • Adds new APS work items to core/cli plans (CORE-014..020, CLI-013..015) derived from the review.
  • Updates milestone/module status tracking in the APS index and marks MCP-001 as complete.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
plans/reviews-omo-review.md New review write-up covering architecture, quality, test coverage, CI/CD, and APS accuracy.
plans/index.aps.md Updates M6 MCP milestone status and resequences the “What’s Next” queue with priorities.
plans/modules/distil-core.aps.md Adds CORE-014..020 work items to track refactors/tests/docs from the review.
plans/modules/distil-cli.aps.md Adds CLI-013..015 work items (command tests, command extraction, empty-catch fix).
plans/modules/distil-mcp.aps.md Updates MCP module status and marks MCP-001 as complete with a completion note.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

joshuaboys added a commit that referenced this pull request Mar 13, 2026
Reconcile MCP completion status: mark MCP-002, MCP-003, MCP-004 as
complete in module plan and index. Fix dependency versions (tree-sitter
^0.22.4, MCP SDK ^1.12.1), CI pipeline description (Node 20+22, no
lint step), and milestone numbering table to match canonical index.
Clarify M2 Kindling integration as scaffolded-not-wired.
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d9e5765bb7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

| 2 | CORE-014 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |
| 3 | CORE-015 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |
| 4 | CORE-016 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |
| 5 | CORE-021 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |

Choose a reason for hiding this comment

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

P2 Badge Add a CORE-021 task definition before queuing it

This queue entry introduces CORE-021 as ready work, but there is no corresponding CORE-021 task in plans/modules/distil-core.aps.md (the module task list ends at CORE-020 in this commit). That leaves the top-level roadmap pointing to an undefined item, so readers cannot find scope, dependencies, or validation details for a prioritized P1 task.

Useful? React with 👍 / 👎.

Reconcile MCP completion status: mark MCP-002, MCP-003, MCP-004 as
complete in module plan and index. Fix dependency versions (tree-sitter
^0.22.4, MCP SDK ^1.12.1), CI pipeline description (Node 20+22, no
lint step), and milestone numbering table to match canonical index.
Clarify M2 Kindling integration as scaffolded-not-wired.
@joshuaboys joshuaboys force-pushed the docs/omo-project-review branch from d9e5765 to 0e1bd85 Compare March 13, 2026 13:12
@joshuaboys joshuaboys merged commit dc10f78 into main Mar 13, 2026
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review


P2 Badge Remove unresolved conflict markers from review doc

This review document was committed with unresolved merge markers in the health dashboard/CI sections, which leaves mutually inconsistent statements (for example, conflicting CI matrix and lint-step descriptions) in the same artifact. That makes the audit unreliable for downstream planning because readers cannot tell which branch content is authoritative.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

| 2 | CORE-014 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |
| 3 | CORE-015 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |
| 4 | CORE-016 | [core](modules/distil-core.aps.md) | core | @aneki | Ready | P1 |
<<<<<<< HEAD

Choose a reason for hiding this comment

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

P1 Badge Resolve merge conflict artifacts in APS work queue

The What's Next table still includes raw conflict markers (<<<<<<<, |||||||, =======, >>>>>>>) and both sides of the merge, so the roadmap now contains contradictory queue entries and statuses in one document. This breaks the APS file as a single source of truth for prioritization and can mislead any planning/reporting step that reads this table.

Useful? React with 👍 / 👎.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants