mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-02-27 18:22:41 -08:00
refactor(config): slim resolver facade and expand regression lanes
Collapse src/config/resolve.ts into an orchestrated pipeline over domain modules, wire launcher regression coverage into test scripts, and sync backlog/subagent tracking artifacts for completed TASK-74/TASK-96/TASK-98 follow-up planning.
This commit is contained in:
@@ -43,3 +43,4 @@ Read first. Keep concise.
|
||||
| `codex-task74-launcher-tests-20260221T201635Z-10i6` | `codex-task74-launcher-tests` | `Implement TASK-74 launcher regression tests for config discovery + command branching end-to-end` | `done` | `docs/subagents/agents/codex-task74-launcher-tests-20260221T201635Z-10i6.md` | `2026-02-21T20:20:52Z` |
|
||||
| `opencode-task76-anki-workflows-20260221T201659Z-r4p1` | `opencode-task76-anki-workflows` | `Execute TASK-76 decompose anki-integration orchestrator into workflow services via plan-first workflow` | `done` | `docs/subagents/agents/opencode-task76-anki-workflows-20260221T201659Z-r4p1.md` | `2026-02-21T21:17:28Z` |
|
||||
| `opencode-task76-doc-boundaries-20260221T203558Z-h7q4` | `opencode-task76-doc-boundaries` | `Update Anki integration docs with post-decomposition ownership boundaries for TASK-76` | `done` | `docs/subagents/agents/opencode-task76-doc-boundaries-20260221T203558Z-h7q4.md` | `2026-02-21T20:36:55Z` |
|
||||
| `codex-docs-unpushed-review-20260221T213707Z-lyej` | `codex-docs-unpushed-review` | `Review unpushed commits for docs drift; patch docs to reflect current code/state` | `in_progress` | `docs/subagents/agents/codex-docs-unpushed-review-20260221T213707Z-lyej.md` | `2026-02-21T21:37:07Z` |
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# Agent Session: codex-docs-unpushed-review-20260221T213707Z-lyej
|
||||
|
||||
- alias: `codex-docs-unpushed-review`
|
||||
- mission: `Review unpushed commits for docs drift; patch docs to reflect current code/state`
|
||||
- status: `in_progress`
|
||||
- started_utc: `2026-02-21T21:37:07Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Intent
|
||||
|
||||
- audit `origin/main..HEAD` commit set
|
||||
- compare code/runtime/test-script changes against user-facing docs
|
||||
- patch stale docs only; avoid unrelated code churn
|
||||
|
||||
## Planned Files
|
||||
|
||||
- `docs/development.md` (verify test lane + build guidance)
|
||||
- `docs/architecture.md` (verify runtime composer/domain registry narrative)
|
||||
- `docs/configuration.md` (verify config discovery semantics if needed)
|
||||
- `docs/launcher-script.md` (verify launcher test coverage + mpv socket behavior)
|
||||
- `docs/subagents/INDEX.md` (own row heartbeat/status only)
|
||||
- `docs/subagents/collaboration.md` (cross-agent notes/conflicts)
|
||||
|
||||
## Assumptions
|
||||
|
||||
- scope = unpushed commits (`origin/main..HEAD`) + doc drift for current working state
|
||||
- Backlog MCP not initialized (`backlog://init-required`); no enforceable ticket link in this run
|
||||
- existing dirty workspace includes other agents/user edits; do not revert or normalize unrelated files
|
||||
|
||||
## Log
|
||||
|
||||
- `2026-02-21T21:37:07Z` start; loaded subagent index/collaboration/backlog state; collecting unpushed commit/doc impact matrix.
|
||||
@@ -8,6 +8,8 @@
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
- [2026-02-21T07:16:33Z] handoff: added cleanup backlog set TASK-96..TASK-101 with implementation steps, AC, DoD, and dependency chain.
|
||||
- [2026-02-21T07:15:00Z] intent: user requested backlog build-out; creating follow-on cleanup tasks with implementation steps and completion goals.
|
||||
- [2026-02-21T06:25:27Z] handoff: review complete; no blocking/important defects found in refactor + launcher-workflow enforcement diff; targeted guardrails/tests passed.
|
||||
- [2026-02-21T06:25:27Z] test: `bun run check:main-fanin` and `bun run test:core:dist` passed on current tree.
|
||||
- [2026-02-21T06:24:30Z] progress: audited diffs in `.github/workflows/{ci,release}.yml`, `scripts/verify-generated-launcher.sh`, docs/task updates; validated launcher verifier behavior.
|
||||
@@ -22,6 +24,18 @@
|
||||
- `docs/development.md` (reviewed)
|
||||
- `docs/installation.md` (reviewed)
|
||||
- `backlog/tasks/task-85 - Refactor-large-files-for-maintainability-and-readability.md` (reviewed)
|
||||
- `backlog/tasks/task-96 - Split-config-resolve-into-domain-modules.md` (planned)
|
||||
- `backlog/tasks/task-97 - Normalize-runtime-composer-contracts.md` (planned)
|
||||
- `backlog/tasks/task-98 - Shift-core-tests-to-source-level-and-trim-dist-coupling.md` (planned)
|
||||
- `backlog/tasks/task-99 - Expand-maintainability-guardrails-and-runtime-cycle-checks.md` (planned)
|
||||
- `backlog/tasks/task-100 - Run-post-refactor-dead-code-prune-and-cleanup.md` (planned)
|
||||
- `backlog/tasks/task-101 - Consolidate-architecture-docs-and-archive-task-noise.md` (planned)
|
||||
- `backlog/tasks/task-96 - Split-config-resolve-into-domain-modules.md` (added)
|
||||
- `backlog/tasks/task-97 - Normalize-runtime-composer-contracts.md` (added)
|
||||
- `backlog/tasks/task-98 - Shift-core-tests-to-source-level-and-trim-dist-coupling.md` (added)
|
||||
- `backlog/tasks/task-99 - Expand-maintainability-guardrails-and-runtime-cycle-checks.md` (added)
|
||||
- `backlog/tasks/task-100 - Run-post-refactor-dead-code-prune-and-cleanup.md` (added)
|
||||
- `backlog/tasks/task-101 - Consolidate-architecture-docs-and-archive-task-noise.md` (added)
|
||||
|
||||
## Assumptions
|
||||
- User asks for review only; no code changes requested.
|
||||
@@ -31,4 +45,4 @@
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
- Await user direction (fixes optional; no required corrections identified).
|
||||
- Await prioritization/execution order from user.
|
||||
|
||||
@@ -0,0 +1,51 @@
|
||||
# Agent Log: codex-task74-launcher-tests-20260221T201635Z-10i6
|
||||
|
||||
- alias: `codex-task74-launcher-tests`
|
||||
- mission: `Implement TASK-74 launcher regression tests for config discovery + command branching end-to-end`
|
||||
- status: `done`
|
||||
- last_update_utc: `2026-02-21T20:20:52Z`
|
||||
|
||||
## Intent
|
||||
|
||||
- add launcher regression coverage for config discovery matrix + command branching paths
|
||||
- keep tests deterministic via fs/process/spawn mocks; no external process deps
|
||||
- wire tests into existing launcher/core test workflow
|
||||
|
||||
## Planned Files
|
||||
|
||||
- `launcher/main.ts`
|
||||
- `launcher/main.test.ts` (new)
|
||||
- `launcher/config.test.ts` (extend if needed)
|
||||
- `package.json` (only if test command wiring needed)
|
||||
- `backlog/tasks/task-74 - Add-launcher-regression-tests-for-config-discovery-and-command-branching.md` (status/checklists evidence)
|
||||
|
||||
## Assumptions
|
||||
|
||||
- existing test runner: `bun test`
|
||||
- task expects launcher tests in repo test gates (likely `test:launcher`)
|
||||
- no behavior change needed unless tests expose branch gaps
|
||||
|
||||
## Progress
|
||||
|
||||
- `2026-02-21T20:16:35Z` started; protocol + task context loaded
|
||||
- `2026-02-21T20:19:30Z` added `launcher/main.test.ts` regression suite (config discovery + command branching via child-process harness + fake app binary capture)
|
||||
- `2026-02-21T20:20:02Z` wired launcher tests into scripts (`test:launcher:src`, `test:launcher`) and included launcher tests in `test:core:src`
|
||||
- `2026-02-21T20:20:20Z` documented launcher test command in `docs/launcher-script.md`
|
||||
- `2026-02-21T20:20:52Z` verification complete:
|
||||
- `bun run test:launcher`
|
||||
- `bun run test:core:src`
|
||||
- both green
|
||||
|
||||
## Files Touched
|
||||
|
||||
- `launcher/main.test.ts` (new)
|
||||
- `package.json`
|
||||
- `docs/launcher-script.md`
|
||||
- `backlog/tasks/task-74 - Add-launcher-regression-tests-for-config-discovery-and-command-branching.md`
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/agents/codex-task74-launcher-tests-20260221T201635Z-10i6.md`
|
||||
|
||||
## Handoff
|
||||
|
||||
- task status moved to `Done` in backlog markdown with AC/DoD checked
|
||||
- no blockers
|
||||
@@ -0,0 +1,35 @@
|
||||
# Agent: `codex-task96-config-resolve-20260221T110058Z-k7m2`
|
||||
|
||||
- alias: `codex-task96-config-resolve`
|
||||
- mission: `Execute TASK-96 by splitting src/config/resolve.ts into domain modules without behavior drift`
|
||||
- status: `done`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-21T11:00:58Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
|
||||
- [2026-02-21T20:10:43Z] complete: reduced `src/config/resolve.ts` to 33 LOC orchestration facade over extracted domain modules; updated config test scripts to include resolve seam tests in src+dist lanes; ran required gates (`build`, `test:config:dist`, `check:file-budgets`) all green.
|
||||
- [2026-02-21T20:10:43Z] backlog: finalized `TASK-96` as Done with AC/DoD checked and metrics evidence (LOC 1414 -> 33; budget over-limit files 18 -> 17).
|
||||
- [2026-02-21T11:00:58Z] intent: load TASK-96 from Backlog MCP, draft execution plan with writing-plans skill, execute with executing-plans skill, no commit.
|
||||
- [2026-02-21T11:00:58Z] context: read subagent index/collaboration + prior opencode TASK-96 planning handoff.
|
||||
|
||||
## Files Touched
|
||||
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `docs/subagents/agents/codex-task96-config-resolve-20260221T110058Z-k7m2.md`
|
||||
- `src/config/resolve.ts`
|
||||
- `package.json`
|
||||
|
||||
## Assumptions
|
||||
|
||||
- User request grants consent to execute TASK-96 on current branch and run required verification gates.
|
||||
|
||||
## Open Questions / Blockers
|
||||
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
|
||||
- Handoff complete; await user review or next task.
|
||||
@@ -0,0 +1,43 @@
|
||||
# Agent: `opencode-task76-anki-workflows-20260221T201659Z-r4p1`
|
||||
|
||||
- alias: `opencode-task76-anki-workflows`
|
||||
- mission: `Execute TASK-76 decompose anki-integration orchestrator into workflow services end-to-end without commit`
|
||||
- status: `done`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-21T20:16:59Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
|
||||
- [2026-02-21T21:17:28Z] test: reran `bun run build && node --test dist/anki-integration.test.js dist/anki-integration/note-update-workflow.test.js dist/anki-integration/field-grouping-workflow.test.js` and `bun run build && bun run test:core:dist`; all pass.
|
||||
- [2026-02-21T21:16:18Z] handoff: TASK-76 complete; extracted note-update and field-grouping workflow services, added workflow seam tests, updated Anki ownership docs, verified build + anki suites + core dist gate, and marked backlog task Done.
|
||||
- [2026-02-21T20:40:00Z] progress: implemented `NoteUpdateWorkflow` and `FieldGroupingWorkflow` extraction; rewired `AnkiIntegration` to delegate `processNewCard` and grouping handlers.
|
||||
- [2026-02-21T20:30:00Z] progress: created TASK-76 execution plan and moved backlog task to In Progress with baseline metrics.
|
||||
- [2026-02-21T20:16:59Z] intent: load Backlog TASK-76 context, draft plan via writing-plans skill, execute via executing-plans with parallel subagents when safe.
|
||||
|
||||
## Files Touched
|
||||
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/agents/opencode-task76-anki-workflows-20260221T201659Z-r4p1.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `docs/plans/2026-02-21-task-76-anki-workflow-services-plan.md`
|
||||
- `src/anki-integration.ts`
|
||||
- `src/anki-integration/note-update-workflow.ts`
|
||||
- `src/anki-integration/note-update-workflow.test.ts`
|
||||
- `src/anki-integration/field-grouping-workflow.ts`
|
||||
- `src/anki-integration/field-grouping-workflow.test.ts`
|
||||
- `docs/anki-integration.md`
|
||||
- `backlog/tasks/task-76 - Decompose-anki-integration-orchestrator-into-workflow-services.md` (via MCP edits)
|
||||
|
||||
## Assumptions
|
||||
|
||||
- Backlog MCP is initialized and TASK-76 exists.
|
||||
- Existing in-flight changes in repo are unrelated unless overlap found in `src/anki-integration.ts` and `src/anki-integration/*`.
|
||||
|
||||
## Open Questions / Blockers
|
||||
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
|
||||
- Await user review or follow-up requests (no commit performed).
|
||||
@@ -0,0 +1,34 @@
|
||||
# Agent: `opencode-task76-doc-boundaries-20260221T203558Z-h7q4`
|
||||
|
||||
- alias: `opencode-task76-doc-boundaries`
|
||||
- mission: `Update Anki integration docs with post-decomposition ownership boundaries for TASK-76`
|
||||
- status: `done`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-21T20:35:58Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
|
||||
- [2026-02-21T20:35:58Z] intent: update `docs/anki-integration.md` with concise ownership boundaries for facade/workflows/collaborators after TASK-76 decomposition.
|
||||
- [2026-02-21T20:36:55Z] progress: added ownership-boundary section in `docs/anki-integration.md` covering facade, note-update workflow, field-grouping workflow, and existing collaborators.
|
||||
- [2026-02-21T20:36:55Z] handoff: docs-only change complete; no tests run per request.
|
||||
|
||||
## Files Touched
|
||||
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `docs/subagents/agents/opencode-task76-doc-boundaries-20260221T203558Z-h7q4.md`
|
||||
- `docs/anki-integration.md`
|
||||
|
||||
## Assumptions
|
||||
|
||||
- TASK-76 remains the source of truth for this documentation update.
|
||||
- Requested scope is docs-only; no source-code behavior changes.
|
||||
|
||||
## Open Questions / Blockers
|
||||
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
|
||||
- Await user review; adjust wording if they want tighter or more code-facing phrasing.
|
||||
@@ -0,0 +1,30 @@
|
||||
# Agent: `opencode-task96-config-resolve-20260221T094119Z-mbfo`
|
||||
|
||||
- alias: `opencode-task96-config-resolve`
|
||||
- mission: `Execute TASK-96 by splitting src/config/resolve.ts into domain modules without behavior drift`
|
||||
- status: `planning`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-21T09:41:19Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
|
||||
- [2026-02-21T09:41:19Z] intent: load TASK-96 from Backlog MCP, draft implementation plan via writing-plans skill, then execute via executing-plans skill (no commit).
|
||||
- [2026-02-21T09:41:19Z] progress: read workflow overview + subagent protocol docs; creating session record and index row before code edits.
|
||||
|
||||
## Files Touched
|
||||
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/agents/opencode-task96-config-resolve-20260221T094119Z-mbfo.md`
|
||||
|
||||
## Assumptions
|
||||
|
||||
- User request to execute TASK-96 implies consent to edit current branch state and run required verification commands.
|
||||
|
||||
## Open Questions / Blockers
|
||||
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
|
||||
- Load TASK-96 code context and write plan file under `docs/plans/`.
|
||||
@@ -48,3 +48,4 @@ Shared notes. Append-only.
|
||||
- [2026-02-21T20:16:59Z] [opencode-task76-anki-workflows-20260221T201659Z-r4p1|opencode-task76-anki-workflows] starting TASK-76 via Backlog MCP + writing-plans/executing-plans; likely scope `src/anki-integration.ts` + new `src/anki-integration/*` workflow services, with overlap checks before edits.
|
||||
- [2026-02-21T20:35:58Z] [opencode-task76-doc-boundaries-20260221T203558Z-h7q4|opencode-task76-doc-boundaries] overlap note: TASK-76 already has an active planning agent; this pass is docs-only (`docs/anki-integration.md`) to capture ownership boundaries after workflow decomposition.
|
||||
- [2026-02-21T21:16:18Z] [opencode-task76-anki-workflows-20260221T201659Z-r4p1|opencode-task76-anki-workflows] completed TASK-76: extracted `note-update-workflow` + `field-grouping-workflow` services, delegated facade hotpaths in `src/anki-integration.ts`, added focused workflow seam tests, docs ownership boundaries updated, `bun run build && bun run test:core:dist` green, and backlog TASK-76 marked Done.
|
||||
- [2026-02-21T21:37:07Z] [codex-docs-unpushed-review-20260221T213707Z-lyej|codex-docs-unpushed-review] starting docs-drift audit for unpushed commits (`origin/main..HEAD`); scope docs alignment only, no behavior/code rewrites.
|
||||
|
||||
Reference in New Issue
Block a user