Repository navigation
0.9.38
Agent steps now stream live activity as agent-event log events, [factory] agent-event stdout lines and a RunPorts.onAgentEvent hook while Claude Code or Codex runs (#4246). Stable tags create the GitHub release from CHANGELOG.md (#4123), line budgets and knip/duplication/lint baselines can only shrink (#4124, #4125, #4126, #4051, #4052, #4053), and GitHub credentials are scoped per phase with no merge route outside land (#4120). Visual proof supports scripted steps and gif/video captures (#4054), worktree GC prunes old state backups (#4055), and factory land no longer tries to remove a direct checkout as a worktree (#4248).
All seven published @on-par packages move to 0.9.38 in lockstep.
Install or update with npm install -g @on-par/factory-cli@latest.
Added
- Agent steps stream live activity: Claude Code and Codex tool calls, skills, MCP calls, text and results appear as
agent-eventlog events,[factory] agent-event {json}stdout lines and aRunPorts.onAgentEventhook while the agent runs (#4246). - Stable tag publishes now create or update the GitHub release from CHANGELOG.md, and a drift check fails when npm latest and the GitHub latest release differ (#4123).
- Per-package line budget:
npm run loc-budgetin verify and CIstaticchecksloc-budget.json, which may only fall; raising it needs a human-appliedloc-budget:overridelabel (#4124). - Scoped per-phase GitHub credentials (App installation or fine-grained tokens) with no merge route outside land (#4120).
factory worktree gcand the pre-run auto GC prune old*.bak*,queue.bak.relaunch-*and*-relaunch.logfiles in the state root, keeping the newestworktree.stateBackupKeepper kind and anything newer thanworktree.stateBackupMaxAgeDays(#4055).npm run knipnow reports unused exports of@on-par/factory-core's entry points and test-only code (knip --production) against a shrink-onlyknip-baseline.json(#4126).npm run duplicationruns jscpd in verify and CIstaticagainst a shrink-onlyduplication-baseline.json(#4125).- Lint rule
anti-slop/no-commentsbans source comments except justified lint overrides and toolchain directives, with a shrink-only per-file baseline and a CI guard (#4053). - Lint rule
anti-slop/package-boundariesenforces the config ← core ← cli direction, a zero-dependency config, published-name cross-package imports and the ADR-0004/internaland/testingsubpath boundaries (#4052). - Lint rule
anti-slop/no-call-assertionsbans call-count assertions and mock-call reads in tests, with a shrink-only per-file baseline and a CI guard (#4051). - Visual proof: routes can declare scripted
stepsandrecord: gif|videofor before/after captures and clips; capture retries (visualProof.captureAttempts), rejects blank images and always publishes proof or an unavailable reason (#4054).
Deprecated
- Root
@on-par/factory-coreexports no in-repo consumer imports are deprecated and will be removed after one minor release: the value exports inDEPRECATED_PUBLIC_API_KEYS(packages/core/src/public-api-keys.ts), and the type-only root exports listed underproduction|types|packages/core/src/index.ts|inknip-baseline.json(#4126).
Changed
- The test suite's default worker count (npm test and scripts/verify.sh) is now os.availableParallelism() instead of a fixed 4; FACTORY_TEST_MAX_WORKERS still overrides it, including 1 for serial runs (#4035).
- npm run lint fails on unused lint-disable directives; dead directives for unrun rules are removed and audited oxlint overrides are enabled or kept with a reason and follow-up issue (#4056).
npm run duplicationnow fails only when the jscpd clone count rises aboveduplication-baseline.json; a drop passes and prints suggested lower numbers, and the percentage is informational (#4180).- Direct
mkdtemp(tmpdir())in tests is now an oxlint error (anti-slop/no-direct-tmpdir-mkdtemp), replacing the vitest guard, and a lefthook pre-commit hook runsoxlint --fixandprettier --writeon staged files (#4050). - Config defaults that core repeated as inline literals (FactoryConfigSchema defaults, resolver fallbacks, the 227 usage cap and the 0.75 watchdog stopAt) are now read from
@on-par/factory-config, which exportsdefaultBudgetanddefaultSchemaFields; effective defaults are unchanged (#3444).
Removed
@on-par/factory-coreno longer exports the unusedresolveAdrMandate, and the dead config exports and re-exports reported by knip are deleted (#4155).@on-par/factory-core/internalno longer re-exports the last 56 unused names, the unusedcreateLinearTicketWritebackis deleted, and the export-surface guard drops its allowlist sointernal.tsmust export exactly what consumers import (#3787).
Fixed
- Worktree cleanup after ship and in
factory landno longer runsgit worktree removeon a direct (in-place or container) checkout, so the "is not a working tree" warning is gone (#4248).
CLI JSON contract
CLI JSON contract
No CLI JSON contract changes
Full changelog: v0.9.37...v0.9.38