Repository navigation
Description
Part of #1562.
Scope
The repository becomes a workspace with a second package, @simlock/e2e, under packages/e2e. After this PR a user's config that calls simlockDevices(options) type-checks and a bad option fails at config load with its name; the repository's checks cover the new package; and a release sets one version in both packages, builds and checks both tarballs, and publishes @simlock/e2e before simlock. The provider's acquire and release come with the next task.
If this goes wrong, a contributor notices pnpm build or pnpm check failing on a clean checkout, or the maintainer notices a release that tags one version and publishes two.
Technical spec
Commit d8fadd1.
Rows
- Behaviours: B1, B10, B11, B12
- Stored state: S1
- Interfaces: I1, I4, I5, I6, I7 (the factory and its
loadClientparameter;acquireandreleasereject withsimlock: not implementeduntil the next task) - Existing code: X1, X2, X3, X4, X5, X6, X7, X8, X9, X10, X11, X12, X13, X14, X22, X25, X26, X27
Facts
| # | Fact | Source |
|---|---|---|
| F1 | The installed Turborepo is 2.11.10; fifteen package.json scripts call turbo run <task ids>. |
node -p "require('./node_modules/turbo/package.json').version" printed 2.11.10; grep -c "turbo run" package.json printed 15 |
| F2 | pnpm build runs turbo run build:daemon:run build:ui:run build:capture:run; typecheck runs two tsc commands, neither through turbo. |
package.json:41, package.json:63 |
| F3 | The root build config excludes tests by extending the check config. | tsconfig.build.json:1-4 |
| F4 | Fallow's entry list is the entry array. |
.fallowrc.json:30 |
| F5 | The release workflow has a dry-run input that plans and builds and publishes nothing. | .github/workflows/release.yml:52 |
| F6 | src/release-script.test.ts runs scripts/release.mjs in a temp folder holding a fake manifest named simlock. |
src/release-script.test.ts:21 |
Modules touched
Searches: rg -n "turbo run" package.json .github scripts, rg -n "simlock-\$VERSION" .github, rg -n "depcruise|oxlint" package.json lefthook.yml.
packages/e2e/(new):package.json,tsconfig.json,tsconfig.build.json,README.md,src/index.ts(the options type and their checking, I1),src/provider.ts(I7), their tests,src/config.sample.tspnpm-workspace.yaml,pnpm-lock.yaml,turbo.json,package.json(scripts, lint paths),vitest.config.ts,.dependency-cruiser.mjs,.fallowrc.json,lefthook.ymlscripts/release.mjs,src/release-script.test.ts,src/release-pack.test.ts,.github/workflows/release.ymlsrc/lint-rules.test.ts(the new boundary rule's test)docs/internal/ARCHITECTURE.md,docs/internal/agent-rules/toolchain.md(the build section names the new task ids and the package)
Rules in play
- ADR 0077 §1 to §5: the layout, the scope, the import rule, the one-version release and the checks are built as written.
- A half-published release (
@simlock/e2eon npm,simlocknot) is recovered by re-running the failed publish job: each publish step skips a package whose exact version is already on npm and publishes the rest (decided in delivery, pending the maintainer). docs/internal/agent-rules/toolchain.md(build steps): its turbo paragraph is updated to the new task ids in this PR.docs/internal/agent-rules/documentation.mdrule 9: the provider's website page and its surface check are the next task's; this PR documents nothing a user can run yet.docs/internal/agent-rules/architecture.md(boundaries): the new dependency-cruiser rule is the only boundary added.
Tests
The seams are simlockDevices in packages/e2e/src/index.ts, scripts/release.mjs run as a command, and the pack test; model them on src/release-script.test.ts and src/release-pack.test.ts.
- B1: a user calls
simlockDevices(options): every row of the parent's Examples table, one table test; defaults forttlMs,queueMs,installConcurrency,extraAppswhen left out; a good call returns a provider namedsimlock. - B10: a contributor runs the checks: a test under
packages/e2e/srcruns in theunitproject; a fixture import frompackages/e2eintosrc/and one back are reported by dependency-cruiser's config (rule test on the config, as the existing boundary rules are tested). - B11: the maintainer releases:
bump 0.8.0writes both manifests in a scratch folder that holds a root manifest and apackages/e2eone; the repository's own two manifests hold the same version (S1); the pack test findssimlock-<v>.tgzandsimlock-e2e-<v>.tgz, the second withpackage/dist/index.js,package/dist/index.d.tsand no test file; the workflow's plan, tag, pack, publish and release steps are asserted from the workflow file's text (both names checked, the not-on-npm message, both manifests committed,@simlock/e2epublished first, both tarballs attached). Each workflow assertion pins the whole condition or command of its step (the exactif:expression, thenpm viewexit-code test, the plan step's not-on-npm branch), so an inverted condition fails the test; the titles claim what the workflow file says, not that a release recovers (decided in delivery, pending the maintainer). - B12: a config passing
simlockDevices(...)tomobile({ device })type-checks: all options; only the four required ones. - B13: the maintainer re-runs a half-published release: the workflow file's publish step for each package checks
npm view <name>@<version>and skips the publish when that version exists (asserted from the workflow file's text, both names) (decided in delivery, pending the maintainer).
Done when
pnpm install && pnpm buildon a clean checkout buildsdist/andpackages/e2e/dist/index.js.pnpm checkpasses, andpnpm test:unitlists tests frompackages/e2e/src.node scripts/release.mjs bump 9.9.9in a scratch copy changesversionin bothpackage.jsonandpackages/e2e/package.json.pnpm lintpasses, and the boundary rule's test insrc/lint-rules.test.tsreports an import fromsrc/intopackages/e2eand one back.pnpm fallowreports nothing forpackages/e2e.grep -n "is not on npm yet" .github/workflows/release.ymlfinds the plan step's message.
Out of scope
acquire,release, renewal and the website page: the next task.- Moving
simlockout of the repository root. - Mutation testing and the module-manual hook for
packages/.
Depends on
Written by an agent.
Activity
test: an import from src/ into packages/e2e and one back is reported …
build(lint): packages/ and the root code never import each other, and…
test: bump writes the version into the root manifest and every packag…
feat(release): bump writes the version into every package manifest (#…
test: the repository's own manifests hold one version (#1566)
test: the pack step builds simlock and @simlock/e2e tarballs at one v…
feat(release): the pack step builds and checks the @simlock/e2e tarba…
test: the release workflow checks, commits, publishes and attaches bo…
feat(release): the workflow checks both packages on npm and publishes…
docs(e2e): the package README, the architecture row and the build sec…
17 remaining items
github-actions commentedon Nov 15, 2026
Back to
task:draft:.agents/scripts/spec-lint.mjsfound blocking lines. Fix them in the body, then settask:readyagain.test(e2e): the slash-run case ends in a non-slash and its time bound …
V3RON commentedon Nov 15, 2026
Handoff
Done: R3 is fixed in 8e292a4, and the fix-check verified it. #1568 passed every review check and is ready. The stack is synced up to #1572 at 570e9e6.
Not done: the merge. The gate refused the stack a second time with
not merged: CI not green on PR #1568: fail Fallow. Fallow's health gate fails onFunction 'checkUrl' has a CRAP score of 31.6 (threshold: 30)inpackages/e2e/src/options.ts, in CI run 43733601215. The same failure showed at dd8dc62. The linear strip added for the CodeQL alert madecheckUrlmore complex.Findings: none open in review.
Blocked on: delivery's rule that a second red gate parks. The maintainer approves one fix run that splits the strip out of
checkUrl, plus a fix-check. Then stack-sync andmerge-pr.sh 1572run again.Written by an agent.
github-actions commentedon Nov 15, 2026
Back to
task:draft:.agents/scripts/spec-lint.mjsfound blocking lines. Fix them in the body, then settask:readyagain.refactor(e2e): the trailing-slash strip is its own function so checkU…
feat(e2e): the repository builds, checks and releases @simlock/e2e wi…