WIP: docs(cli): propose bounded task discovery (HOMEIT-472) #104

Draft
morten-olsen wants to merge 1 commit from feat/7a472fa0-task-discovery into main
Owner

Summary

Task discovery currently emits 1.41 MB for Home IT's 463 tasks; even an open/self/20 filter emits 117 KB. This design proposes an explicit bounded path while preserving existing machine JSON.

list --summary + existing filters -> <=8 KiB summary page + count/cursor
selected GUID + get --field description -> <=8 KiB exact text page

This PR contains the proposal only. HOMEIT-472 expressly reserves implementation/default-contract approval. It compares interfaces, specifies access/count/cursor semantics, selected-text paging, built-in guidance, acceptance across Claude Code/Codex/Pi, and the cumulative production-code budget. It does not apply HOMEIT-456's cancelled paging draft or change PR102.

Evidence

  • Before: Read-only live CLI measurements: 463 tasks/367 closed/1,414,945 bytes; filtered 20 tasks/117,048 bytes; largest description 52,951 bytes. Deployment v0.57.2 ready 1/1.
  • Proposed sizing: Offline model: live summaries at most 7,842 bytes/page; 500-task escaping/Unicode fixture at most 7,952; selected long text reconstructed exactly. Model/script attached to the task. This is sizing evidence, not server/CLI/runtime acceptance.
  • Prettier and diff whitespace checks pass. Exact-head PR pipeline 729 and push pipeline 730 are SUCCESS at 12a2304795; all eight Forgejo statuses passed. Quality: 1,084 passed, two skipped. Docs, deployment tooling and both image builds passed. No production code changed; no new runtime acceptance claimed.

Merge danger

Door: two-way; documentation only.

Blast radius: app

Keep this PR in draft pending the implementation scope/budget decision. Main pushes update a draft release, so this handoff does not authorize merging or publication.

Rollback and verification

  • Roll back: revert the document commit; no data or runtime behavior changes.
  • Verify after rollout: no rollout included. Future implementation must verify actual CLI byte bounds, all three runtimes, rendered guidance, paired image digests, mirror/Argo revision and original Moxie symptom.
  • Reviewers: Morten for the reserved scope/budget decision and proposed built-in instruction changes. Software Engineer retains implementation and delivery after approval.
## Summary Task discovery currently emits 1.41 MB for Home IT's 463 tasks; even an open/self/20 filter emits 117 KB. This design proposes an explicit bounded path while preserving existing machine JSON. ```text list --summary + existing filters -> <=8 KiB summary page + count/cursor selected GUID + get --field description -> <=8 KiB exact text page ``` This PR contains the proposal only. HOMEIT-472 expressly reserves implementation/default-contract approval. It compares interfaces, specifies access/count/cursor semantics, selected-text paging, built-in guidance, acceptance across Claude Code/Codex/Pi, and the cumulative production-code budget. It does not apply HOMEIT-456's cancelled paging draft or change PR102. ## Evidence - **Before:** Read-only live CLI measurements: 463 tasks/367 closed/1,414,945 bytes; filtered 20 tasks/117,048 bytes; largest description 52,951 bytes. Deployment v0.57.2 ready 1/1. - **Proposed sizing:** Offline model: live summaries at most 7,842 bytes/page; 500-task escaping/Unicode fixture at most 7,952; selected long text reconstructed exactly. Model/script attached to the task. This is sizing evidence, not server/CLI/runtime acceptance. - Prettier and diff whitespace checks pass. Exact-head PR [pipeline 729](https://woodpecker.olsen.cloud/repos/32/pipeline/729) and push [pipeline 730](https://woodpecker.olsen.cloud/repos/32/pipeline/730) are SUCCESS at 12a2304795401d27ba4b1bb6f6cbbcf46736a42a; all eight Forgejo statuses passed. Quality: 1,084 passed, two skipped. Docs, deployment tooling and both image builds passed. No production code changed; no new runtime acceptance claimed. ## Merge danger **Door:** two-way; documentation only. **Blast radius:** app Keep this PR in draft pending the implementation scope/budget decision. Main pushes update a draft release, so this handoff does not authorize merging or publication. ## Rollback and verification - **Roll back:** revert the document commit; no data or runtime behavior changes. - **Verify after rollout:** no rollout included. Future implementation must verify actual CLI byte bounds, all three runtimes, rendered guidance, paired image digests, mirror/Argo revision and original Moxie symptom. - **Reviewers:** Morten for the reserved scope/budget decision and proposed built-in instruction changes. Software Engineer retains implementation and delivery after approval.
docs(cli): propose bounded task discovery for HOMEIT-472
All checks were successful
ci/woodpecker/pr/deploy-tools Pipeline was successful
ci/woodpecker/push/deploy-tools Pipeline was successful
ci/woodpecker/pr/image-agent Pipeline was successful
ci/woodpecker/pr/quality Pipeline was successful
ci/woodpecker/push/quality Pipeline was successful
ci/woodpecker/pr/docs Pipeline was successful
ci/woodpecker/push/docs Pipeline was successful
ci/woodpecker/pr/image Pipeline was successful
12a2304795
All checks were successful
ci/woodpecker/pr/deploy-tools Pipeline was successful
ci/woodpecker/push/deploy-tools Pipeline was successful
ci/woodpecker/pr/image-agent Pipeline was successful
ci/woodpecker/pr/quality Pipeline was successful
ci/woodpecker/push/quality Pipeline was successful
ci/woodpecker/pr/docs Pipeline was successful
ci/woodpecker/push/docs Pipeline was successful
ci/woodpecker/pr/image Pipeline was successful
This pull request is marked as a work in progress.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'feat/7a472fa0-task-discovery:feat/7a472fa0-task-discovery'
git switch 'feat/7a472fa0-task-discovery'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'main'
git merge --no-ff 'feat/7a472fa0-task-discovery'
git switch 'feat/7a472fa0-task-discovery'
git rebase 'main'
git switch 'main'
git merge --ff-only 'feat/7a472fa0-task-discovery'
git switch 'feat/7a472fa0-task-discovery'
git rebase 'main'
git switch 'main'
git merge --no-ff 'feat/7a472fa0-task-discovery'
git switch 'main'
git merge --squash 'feat/7a472fa0-task-discovery'
git switch 'main'
git merge --ff-only 'feat/7a472fa0-task-discovery'
git switch 'main'
git merge 'feat/7a472fa0-task-discovery'
git push origin 'main'
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
ai/mission-control!104
No description provided.