Skip to content

auto-claude 1.2.0: Linear sync; harness 0.4.1: leave issues to a run - #40

Merged
unohee merged 2 commits into
mainfrom
auto-claude-linear-sync-ax-2214
Nov 13, 2026
Merged

unohee merged 2 commits into
mainfrom
auto-claude-linear-sync-ax-2214

Conversation

@unohee

@unohee unohee commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

auto-claude kept missing Linear issue updates: it read Linear once, at planning, and never wrote back.

auto-claude 1.2.0 (driver-side, via the session's linear-server MCP):

  • the planning/replan prompt lists the mapped project's open issues; milestones that resolve one start with [ID]
  • every 10 min and before finishing: new/changed issues and new comments become queue lines (max 5 per sync, max 2 follow-ups per issue)
  • start → started; merge → completed + evidence comment (or a follow-up line if the issue changed meanwhile); hold/block → comment
  • driver comments are marked [auto-claude] and ignored as changes
  • only repos with projectId/projectName in ~/.claude/linear.json sync; status shows the sync state

harness 0.4.1:

  • linear-flow neither gates nor blocks the Stop while .claude/auto-claude.on says a run owns the repo
  • only a started state counts as picking an issue up; Cancel/Duplicate drops it

Verified: scripts/ci.sh green (auto-claude 132, harness 176 tests, tsc). The read path was run live against Linear (KYTE-Portal: 8 open issues parsed, baseline then 0 appends; comments come newest first). save_issue state=started was accepted live.

Closes AX-2214

auto-claude reads and writes the repository's Linear project itself,
through the session's linear-server MCP connection:
- the planning prompt (and each replan) lists the project's open issues;
  milestones that resolve one start with its ID ("[AX-12] ...");
- every 10 min, and before the run may finish, new or changed issues and
  new comments (comments do not move updatedAt) become queue lines;
- a milestone's start moves its issues to started; its merge moves them to
  completed with an evidence comment, or queues a follow-up when the issue
  changed while it was built; a hold or block comments only;
- the driver's own comments are marked [auto-claude] and never count.
Only repos mapped to a project in ~/.claude/linear.json sync.

harness linear-flow:
- no gate and no stop block while .claude/auto-claude.on says a run owns
  the repo (written by auto-claude each tick);
- only a started state counts as picking an issue up; Cancel/Duplicate
  drops it from the Done demand.

Closes AX-2214
…untouched, adopt mid-run, no issue creation during a run

- the baseline covers every open issue up to the run's start, so comments
  written before it never queue lines; comments are scanned for the 25
  newest issues and those the run has lines for
- an issue closed while its line waits blocks the line; a closed issue is
  never moved to started, and at merge only gets the evidence comment
- the Linear baseline is read before the record's first write (start and
  resume), and a run without it adopts the project on a tick
- the evidence sha is read after a fetch; a failing sync is told once
- POLICY forbids creating issues during a run; harness refuses an
  unrequested create while a run owns the repo

Refs AX-2214
@unohee
unohee merged commit 3d9a7f5 into main Nov 13, 2026
1 check passed
@unohee
unohee deleted the auto-claude-linear-sync-ax-2214 branch November 13, 2026 15:47
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.

1 participant