repo-scoping/TODO.md

TODO — Custodian Integration Notes

These notes are for the Codex agent working in this repository. They document the current state of the Custodian State Hub integration and what to be aware of.

---

Git Push Credentials (C-17 Warning)

The Custodian consistency checker warns when local commits have not been pushed to the remote. The onboarding commit (AGENTS.md, SCOPE.md, ADR-001 workplans) is currently unpushed because Gitea HTTP credentials are not configured in this environment.

This does not block normal work, but the checker will warn at each run.

To resolve, either configure HTTP credentials:

git config credential.helper store
git push   # prompts once, then stores

Or switch the remote to SSH (if an SSH key is registered on Gitea):

git remote set-url origin git@92.205.130.254:coulomb/repo-registry.git
git push

Until resolved, the consistency checker will log C-17 and skip file write-backs. Task statuses you update in workplan files will still be visible locally; they will sync to the hub DB once the push succeeds.

---

AGENTS.md

AGENTS.md at the repo root is your primary instruction file for interacting with the Custodian State Hub. Read it at the start of each session. It documents:

• State Hub HTTP API endpoints (orient, inbox, progress logging)
• Session protocol (start / during / close)
• Workplan file convention (ADR-001 format)
• How to create new workplans and notify the hub

---

Active Workplan

workplans/RREG-WP-0004-characteristic-classification-navigation.md is the current active workplan. Start with T01 (P0: Characteristic Classification Fields) as the highest-priority item.

---

Custodian Tooling Improvements (2026-04-26)

The following improvements were made to the Custodian registration tooling as a result of onboarding this repository as the first Codex-based repo:

1. register_project.sh --codex flag — new flag skips MCP registration check (Claude Code-specific) and generates AGENTS.md from an HTTP-API-based template instead of CLAUDE.md and .claude/rules/. Future Codex repos can use:

   cd ~/the-custodian/state-hub
   make register-codex-project DOMAIN=<domain> PROJECT_PATH=/path/to/repo
   

2. agents-codex.template — new parameterised template in state-hub/scripts/project_rules/ that produces the HTTP REST session protocol for Codex agents (this file was used to generate AGENTS.md in this repo).

These changes are committed in the-custodian. If the tooling needs further refinement based on how Codex works with this integration, note it here and the custodian operator will update the templates.