Skip to content

v2.6.2: any repo, safely - #10

Merged
Param-Harrison merged 1 commit into
mainfrom
release/v2.6.2
Sep 27, 2026
Merged

Param-Harrison merged 1 commit into
mainfrom
release/v2.6.2

Conversation

@Param-Harrison

Copy link
Copy Markdown
Contributor

Summary

Any repo, safely. No new features: this closes the gaps a second repo (splitbill-demo plus lwp-website) hit under one shared FACTORY_HOME, per the roadmap's v2.6.2 section.

  • Per-repo state. factory.db and workspaces/issue-N live under FACTORY_HOME/<owner>/<repo>/, not one shared FACTORY_HOME. factory doctor warns (never auto-fixes) when the pre-v2.6.2 shared factory.db/workspaces/ is still on disk.
  • resettable: true opt-in for reset/rebaseline, so a live repo can't have its issues and branches wiped by a sandbox-only config.
  • The base branch defaults to origin/HEAD, not a hard-coded "main". Skill text now says "the base branch".
  • A setup hook (.factory/config.json's setup: string[]) runs once per worktree before any stage; a failure parks the issue with the log attached.
  • Issue forms and a PR template in template/.github/, which install ships. install.sh's next-step message now says factory doctor --fix, which is what actually creates the labels those forms apply.
  • Carried over: a CI "set up your toolchain" placeholder step, a bun.lock guard so factory scan skips cleanly on a non-Bun repo, and teach/sessions.json renumbered to this roadmap.

Full detail in CHANGELOG.md, including what's explicitly not in this release (routing, concurrency, the pilot; those are v2.7+).

Plan

Roadmap: v2.6.2: any repo, safely section of the current plan. Every item (1-6) is done; see CHANGELOG for the per-item accounting, including the "carried over" items from v2.6.1's deferral list.

Gate evidence

make check: ok
  • bunx tsc --noEmit: no errors
  • bun test: 684 pass, 0 fail, 2216 expect() calls, across 68 files
  • skills-ref validate: all 7 shipped skills valid

Verify verdict

Self-verified (no separate verify-agent run for this internal release): every new structural test (per-repo path isolation, resettable refusal, base-branch defaulting, the bug.yml/feature.yml/docs.yml/PR-template shipping test, the install.sh --fix message test, the bun.lock skip, the legacy-state doctor warning) was proven with a revert-and-fail cycle — temporarily broke the corresponding fix, confirmed the test failed with a real diff, then restored it and confirmed green again.

No live agent run for this release: no stage's behavior changed here (only config surface, file layout and wording), so the v2.6.1 live Claude run stands as current evidence.

Risk and rollback

Low risk, no new features. The riskiest change is resettable defaulting to requiring explicit opt-in for reset/rebaseline — a repo that relied on the old always-allowed reset (only ever splitbill's sandbox configs) needs "resettable": true added to .factory/config.json. Rollback: revert this PR: it is additive/gating, not a data migration, so nothing needs cleanup.

🤖 Generated with Claude Code

Per-repo state (FACTORY_HOME/<owner>/<repo>/, with a doctor warning on a
leftover pre-v2.6.2 shared factory.db/workspaces), a resettable opt-in so
reset/rebaseline refuse on a live repo, the base branch defaulting to
origin/HEAD instead of a hard-coded main, a setup hook that runs once per
worktree before any stage, issue forms plus a PR template that install
ships (and install.sh now points at `doctor --fix`, which is what actually
creates the labels those forms apply), a CI toolchain placeholder step,
and a bun.lock guard so `factory scan` skips cleanly on a non-Bun repo.

No new features. This is what a second repo (splitbill-demo plus
lwp-website) needed before v2.7 adds routing.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@Param-Harrison
Param-Harrison merged commit 27db300 into main Sep 27, 2026
2 checks passed
@Param-Harrison
Param-Harrison deleted the release/v2.6.2 branch September 27, 2026 11:25
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