Skip to content

chore: advance the four task lists against what landed - #87

Merged
retr0h merged 1 commit into
mainfrom
chore/advance-task-lists
Aug 16, 2026
Merged

chore: advance the four task lists against what landed#87
retr0h merged 1 commit into
mainfrom
chore/advance-task-lists

Conversation

@retr0h

@retr0h retr0h commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

Works the task lists for all four in-flight changes against what is now true, following the keystone landing in osapi-io/osapi#450.

What the conversion closed

osapi was the only repository with neither a root CONTRIBUTING.md nor an AGENTS.md. That single task blocked four others across three changes, all now checked:

Change Task
standardize-repository-layout 4.5 — convert osapi
specify-agent-tool-invocation 2.1 — osapi AGENTS.md
specify-go-code-standards 2.5 — CLAUDE.md drops Code Standards
specify-documentation-homes 3.6 — three-way duplication resolved
specify-documentation-homes 4.4 — design records noted in CONTRIBUTING.md

What verification found

Five verification tasks asserted things nobody had checked. Four pass and are now recorded with their evidence: required files present in all seven repositories, no docs/contributing.md or docs/development.md anywhere, all three deprecated repositories archived, and the react module already taking react_dir as configuration (6a.1/6a.2 were done and unticked).

One failed. specs/LICENSE was not byte-identical — it carried MIT License rather than The MIT License and a different line wrap. This PR replaces it with the canonical copy.

What stays open, and why

Four tasks keep their reason instead of their tick:

  • specify-agent-tool-invocation 3.2osapi's generate recipe invokes redocly, declared nowhere. Not a one-line fix: mise supplies 2.46.1 against 2.19.1 on the developer's path, and the two quote YAML scalars differently, so the committed combined spec and both generated SDKs change the first time anyone runs just generate. Nothing in CI runs generate, so the drift is invisible until someone does.
  • specify-go-code-standards 3.4 — three hand-written mocks remain (gohai, osapi-orchestrator, osapi). Two of the three repositories declare no mocking library, so this needs a decision, not a regeneration.
  • specify-go-code-standards 3.6gohai and osapi-orchestrator point at the capability and restate it. Removing the restatements reverses a choice made deliberately at conversion time.
  • standardize-repository-layout 5.2/5.3/7.6go is 1.25 in .mise.toml and stable in every workflow, across all five Go repositories. They agree today and diverge when 1.26 ships. The requirement's own logic points at go = "latest" locally rather than pinning CI, which changes the toolchain every developer builds with.

Task 6.1 dropped

osapi-io-taskfiles is archived and cannot be pushed to. Of the two ways out the task named, the archived state is accepted as the deprecation signal — GitHub already marks it read-only, which is the half of the requirement a reader sees.

just test passes (10/10).

🤖 Generated with Claude Code

osapi's conversion (osapi-io/osapi#450) closes the task that blocked
three other changes: it was the only repository with neither a root
CONTRIBUTING.md nor an AGENTS.md.

Verification found five things the task lists asserted but nobody had
checked. Four now pass: the required files, the absent docs/contributing
and docs/development, the archived deprecated repositories, and the
react module already taking its directory as configuration. One did
not -- specs/LICENSE carried a differently titled and wrapped variant,
replaced here with the canonical copy.

Four remain open with the reason recorded rather than the box ticked:
redocly is invoked but undeclared, three mocks are hand-written, go is
pinned locally and floating in CI, and the export_test.go audit has not
been done.

Task 6.1 is dropped: osapi-io-taskfiles is archived and cannot be
pushed to, and the archived state is accepted as the deprecation signal.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Thank you for contributing to this project! 😊🕹️

@retr0h
retr0h merged commit 18c00d7 into main Aug 16, 2026
6 checks passed
@retr0h
retr0h deleted the chore/advance-task-lists branch August 16, 2026 15:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant