mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-02-28 06:22:45 -08:00
docs: refresh architecture and development docs
Update docs content to match current launcher/plugin/runtime structure and fix stale home demo media assets with cache-busted URLs plus poster refresh. Add supporting backlog/subagent tracking records and docs asset regression coverage.
This commit is contained in:
@@ -0,0 +1,32 @@
|
||||
# Agent: `codex-architecture-doc-refresh-20260223T033941Z-d6se`
|
||||
|
||||
- alias: `codex-architecture-doc-refresh`
|
||||
- mission: `Review current runtime/module architecture and update docs/architecture.md content to match real code paths.`
|
||||
- status: `handoff`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-23T03:39:41Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
- [2026-02-23T03:44:17Z] handoff: architecture docs refreshed to match current codebase structure/runtime ownership; docs build passed; ready for user review.
|
||||
- [2026-02-23T03:44:17Z] test: `bun run docs:build` passed.
|
||||
- [2026-02-23T03:44:17Z] progress: updated `docs/architecture.md` sections for project structure, service layer, renderer layering, lifecycle, composition conventions, and extension rules; mermaid blocks left unchanged.
|
||||
- [2026-02-23T03:39:41Z] intent: refresh `docs/architecture.md` using direct repo evidence; keep diagrams untouched per user request.
|
||||
- [2026-02-23T03:39:41Z] progress: loaded `docs/subagents/INDEX.md`, `docs/subagents/collaboration.md`, current `docs/architecture.md`, and source tree inventory.
|
||||
|
||||
## Files Touched
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `docs/subagents/agents/codex-architecture-doc-refresh-20260223T033941Z-d6se.md`
|
||||
- `backlog/tasks/task-113 - Refresh-architecture-doc-content-to-match-current-codebase.md`
|
||||
- `docs/architecture.md`
|
||||
|
||||
## Assumptions
|
||||
- User wants content accuracy only; mermaid/flow diagrams intentionally left as-is.
|
||||
- Existing uncommitted guardrail-removal changes are separate work; avoid touching those files.
|
||||
|
||||
## Open Questions / Blockers
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
- Await user follow-up; if requested, apply same drift pass to other docs pages (`docs/development.md`, `docs/mining-workflow.md`).
|
||||
@@ -0,0 +1,31 @@
|
||||
# Agent: `codex-development-docs-review-20260223T034520Z-2ebb`
|
||||
|
||||
- alias: `codex-development-docs-review`
|
||||
- mission: `Review codebase and refresh docs/development.md to match current project state.`
|
||||
- status: `done`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-23T03:46:06Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
- [2026-02-23T03:49:16Z] handoff: refreshed `docs/development.md` for current setup/build/test/env workflow; validated with `bun run docs:build`; updated backlog ticket + subagent bookkeeping.
|
||||
- [2026-02-23T03:48:30Z] test: `bun run docs:build` passed after docs edits (VitePress chunk-size warning only).
|
||||
- [2026-02-23T03:47:40Z] progress: fixed setup drift (`pnpm` -> `bun`, added submodule init), aligned testing section with CI lanes, corrected subtitle test placeholder wording, expanded env vars to active launcher/runtime overrides.
|
||||
- [2026-02-23T03:46:06Z] intent: initialize subagent+backlog bookkeeping, then audit `docs/development.md` against actual scripts/tests/runtime layout before editing docs.
|
||||
|
||||
## Files Touched
|
||||
- `docs/subagents/agents/codex-development-docs-review-20260223T034520Z-2ebb.md`
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `backlog/tasks/task-114 - Refresh-development-doc-content-to-match-current-codebase.md`
|
||||
- `docs/development.md`
|
||||
|
||||
## Assumptions
|
||||
- `Backlog.md` is managed via `backlog/` markdown files in this repo; create a new task ticket for this request.
|
||||
- Existing dirty worktree entries are from prior sessions; avoid touching unrelated lines/files.
|
||||
|
||||
## Open Questions / Blockers
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
- Await user review/follow-up scope.
|
||||
@@ -0,0 +1,39 @@
|
||||
# Agent: `codex-docs-video-thumb-cache-20260223T033929Z-k8p2`
|
||||
|
||||
- alias: `codex-docs-video-thumb-cache`
|
||||
- mission: `Fix docs landing page demo video thumbnail staleness after direct asset replacement`
|
||||
- status: `handoff`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-23T03:40:48Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work
|
||||
- [2026-02-23T03:40:48Z] intent: confirm root cause for stale docs video thumbnail and apply minimal cache-busting/docs fix.
|
||||
- [2026-02-23T03:40:48Z] plan: touch `docs/index.md`; add regression coverage if lightweight; validate with docs build/targeted test.
|
||||
- [2026-02-23T03:40:48Z] assumption: stale thumbnail caused by static poster/source URLs reusing identical path after direct file replacement.
|
||||
- [2026-02-23T03:42:25Z] progress: added failing regression test `docs/index.assets.test.ts` asserting shared cache-busting token across demo media URLs.
|
||||
- [2026-02-23T03:42:58Z] progress: generated fresh poster from `docs/public/assets/minecard.webm` (`minecard-poster.jpg`) and wired docs video block to shared `demoAssetVersion` tokenized URLs.
|
||||
- [2026-02-23T03:43:20Z] test: `bun test docs/index.assets.test.ts` passes (1/1).
|
||||
- [2026-02-23T03:43:35Z] test: `bun run docs:build` passes.
|
||||
- [2026-02-23T03:43:55Z] handoff: TASK-112 marked Done with implementation notes and validation commands.
|
||||
- [2026-02-23T03:44:04Z] progress: regenerated `minecard-poster.jpg` from `minecard.webm` at exactly `00:00:12` and bumped `demoAssetVersion` to `20260223-2` to force refresh.
|
||||
- [2026-02-23T03:44:04Z] test: reran `bun test docs/index.assets.test.ts` (pass).
|
||||
|
||||
## Files Touched
|
||||
- `docs/subagents/agents/codex-docs-video-thumb-cache-20260223T033929Z-k8p2.md`
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `backlog/tasks/task-112 - Fix-docs-demo-video-thumbnail-cache-staleness.md`
|
||||
- `docs/index.assets.test.ts`
|
||||
- `docs/index.md`
|
||||
- `docs/public/assets/minecard-poster.jpg`
|
||||
|
||||
## Assumptions
|
||||
- Browser/CDN cache can keep prior media when URL path remains unchanged.
|
||||
- Docs home video section in `docs/index.md` is the only requested scope.
|
||||
|
||||
## Open Questions / Blockers
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
- Share fix summary and ask user to hard-refresh docs page once (`Cmd+Shift+R`) to bypass local cache.
|
||||
@@ -0,0 +1,46 @@
|
||||
# Agent: `opencode-remove-maint-guardrails-20260223T033715Z-2a53`
|
||||
|
||||
- alias: `opencode-remove-maint-guardrails`
|
||||
- mission: `Remove Maintainability Guardrails docs section and associated guardrail code/commands.`
|
||||
- status: `handoff`
|
||||
- branch: `main`
|
||||
- started_at: `2026-02-23T03:37:39Z`
|
||||
- heartbeat_minutes: `5`
|
||||
|
||||
## Current Work (newest first)
|
||||
|
||||
- [2026-02-23T03:40:20Z] handoff: completed TASK-111; removed docs section, package scripts, CI guardrail step, and runtime-cycle/fan-in script code + fixtures; validation (`bun run tsc --noEmit`, `bun run docs:build`) passed.
|
||||
- [2026-02-23T03:40:03Z] progress: removed `## Maintainability Guardrails` from `docs/development.md`, deleted `check:main-fanin*` and `check:runtime-cycles*` scripts from `package.json`, removed CI fail-fast guardrails step, and deleted associated scripts/fixtures under `scripts/`.
|
||||
- [2026-02-23T03:37:39Z] intent: initialized session, linked backlog task TASK-111, and preparing scoped removal pass for maintainability guardrails docs and related code.
|
||||
- [2026-02-23T03:37:39Z] assumptions: removal target is explicit "Maintainability Guardrails" section and direct command/code references tied to it.
|
||||
|
||||
## Files Touched
|
||||
|
||||
- `docs/subagents/INDEX.md`
|
||||
- `docs/subagents/collaboration.md`
|
||||
- `docs/subagents/agents/opencode-remove-maint-guardrails-20260223T033715Z-2a53.md`
|
||||
- `backlog/tasks/task-111 - Remove-Maintainability-Guardrails-docs-section-and-related-guardrail-code.md` (via Backlog MCP)
|
||||
- `docs/development.md`
|
||||
- `package.json`
|
||||
- `.github/workflows/ci.yml`
|
||||
- `scripts/check-main-runtime-fanin.ts` (deleted)
|
||||
- `scripts/check-runtime-cycles.ts` (deleted)
|
||||
- `scripts/check-runtime-cycles.test.ts` (deleted)
|
||||
- `scripts/fixtures/runtime-cycles/acyclic/entry.ts` (deleted)
|
||||
- `scripts/fixtures/runtime-cycles/acyclic/feature.ts` (deleted)
|
||||
- `scripts/fixtures/runtime-cycles/acyclic/utils/index.ts` (deleted)
|
||||
- `scripts/fixtures/runtime-cycles/cyclic/module-a.ts` (deleted)
|
||||
- `scripts/fixtures/runtime-cycles/cyclic/module-b.ts` (deleted)
|
||||
- `scripts/fixtures/runtime-cycles/cyclic/nested/index.ts` (deleted)
|
||||
|
||||
## Assumptions
|
||||
|
||||
- Request targets current docs page section shown in screenshot and associated command/code paths, not unrelated guardrails.
|
||||
|
||||
## Open Questions / Blockers
|
||||
|
||||
- None.
|
||||
|
||||
## Next Step
|
||||
|
||||
- Await user follow-up (optional commit/changelog pass if requested).
|
||||
Reference in New Issue
Block a user