Skip to content

codex: add harness home bootstrap#1704

Merged
AceHack merged 5 commits intomainfrom
claim/task-codex-home-bootstrap
May 6, 2026
Merged

codex: add harness home bootstrap#1704
AceHack merged 5 commits intomainfrom
claim/task-codex-home-bootstrap

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented May 6, 2026

Summary

  • Adds .codex/AGENTS.md as the Codex harness-specific addendum.
  • Adds .codex/CURRENT-codex.md as the compact current-state handoff surface.
  • Updates .codex/README.md and AGENTS.md to mark the Codex addendum as present.

Verification

  • bunx markdownlint-cli2 AGENTS.md .codex/README.md .codex/AGENTS.md .codex/CURRENT-codex.md
  • git diff --check

Note: full Prettier check on AGENTS.md / .codex/README.md reports pre-existing repository-wide Markdown style churn (asterisk-to-underscore/table formatting); I did not run --write to avoid unrelated rewrites.

Copilot AI review requested due to automatic review settings May 6, 2026 07:46
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 28a7d4b01a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .codex/CURRENT-codex.md Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR bootstraps a repo-native “home” for the OpenAI Codex harness by adding a Codex-specific addendum and a compact current-state handoff surface under .codex/, and wiring the universal handbook (AGENTS.md) to acknowledge the new addendum.

Changes:

  • Add .codex/AGENTS.md (Codex harness addendum) and .codex/CURRENT-codex.md (current-state handoff).
  • Update .codex/README.md to document the new files and shared-machine worktree/heartbeat discipline.
  • Add a claim file for the work and update AGENTS.md to mark the Codex addendum as present.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/claims/task-codex-home-bootstrap.md Adds a claim file for the Codex harness-home bootstrap work.
AGENTS.md Updates harness-specific files section to reflect .codex/AGENTS.md now exists and is additive.
.codex/README.md Extends .codex/ directory map and clarifies Codex bootstrap/read order + shared-machine workflow pointer.
.codex/CURRENT-codex.md Adds a compact, operational current-state handoff for Codex sessions.
.codex/AGENTS.md Adds Codex-specific addendum with read order, worktree discipline, and ownership boundary.

Comment thread .codex/README.md Outdated
AceHack added 2 commits May 6, 2026 12:33
* claim: task-codex-launchd-loop - host launchd cron for codex

* codex: add launchd loop runner

* release: task-codex-launchd-loop - opened PR #1705

* codex: harden launchd loop host path

* codex: replace launchd runner with ts heartbeat

* codex: fix ts heartbeat gitdir path

* codex: ensure ts heartbeat releases lock

* codex: recover ts heartbeat from killed ticks

* codex: enable scheduled read-only loop gate

* codex: add launchd loop health probe

* docs(codex): clarify loop isolation coordination

* fix(codex): let loop take bounded forward actions
Copilot AI review requested due to automatic review settings May 6, 2026 16:39
@chatgpt-codex-connector
Copy link
Copy Markdown

💡 Codex Review

}
log(`warning: removing stale lock; lock_age=${Math.round(ageMs / 1000)}s ttl=${Math.round(lockTtlMs / 1000)}s`);
rmSync(lockDir, { recursive: true, force: true });
mkdirSync(lockDir);

P1 Badge Keep active lock while owning process is alive

The stale-lock branch removes lockDir solely based on age, even when the PID in metadata is still alive. With this commit’s defaults (StartInterval=60s, ZETA_CODEX_LOOP_LOCK_TTL_SECONDS=120, ZETA_CODEX_LOOP_CODEX_TIMEOUT_SECONDS=300), a normal Codex run lasting over 2 minutes will have its live lock deleted by a later tick, allowing overlapping executions and concurrent writes/logging despite the script claiming non-overlap safety.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@AceHack AceHack merged commit 21e32ad into main May 6, 2026
28 checks passed
@AceHack AceHack deleted the claim/task-codex-home-bootstrap branch May 6, 2026 16:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants