simlock seed makes and settles a kind's seed on a worker
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 18/100
- Type d'issue
- Fonctionnalité
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- typescript
- Domaine
- api, backend, cli, documentation, testing
Piste de recherche
Start with the contract manual for adding an operation, then trace component.install progress through src/daemon/server-requests.ts and the dispatcher tests in src/daemon/dispatcher-components.test.ts. The work spans the operation contract, daemon and gateway handlers, CLI, leasing, docs, and a real-device slow test; completion is defined by the listed unit, typecheck, contract-surface, website, and slow-lane commands passing.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Part of #1732.
Scope
An operator can run simlock seed <ios|android> <model> [--os] [--image-tag] [--json] on a worker to make and settle a kind's seed before anyone leases it, and the website documents it. The slow lane proves on real devices that copies of a settled seed do less work.
If this goes wrong, a user would notice simlock seed hanging past 60 minutes, an error that points at --allow-download, a refusal for a kind a lease accepts, or a gateway that tries to run it.
Technical spec
Commit fb426763.
Rows
- Behaviours: B10, B11, B12, B13
- Interfaces: I7, I8, I9 (and uses I4, I12)
- Existing code: X19, X20, X21, X22, X23, X25
Facts
| # | Fact | Source |
|---|---|---|
| F1 | Adding an operation takes the family file, OPERATIONS, the role and effect matrices, the protocol bump, daemon and gateway handlers, the admin client, error rows and errors.mdx |
src/contract/operations.ts:220 (OPERATIONS), src/contract/protocol.ts:13 (PROTOCOL_VERSION_RANGE), src/contract/operations.test.ts:64, :162 (matrices) |
| F2 | component.install's progress reaches the CLI as component-progress pushes keyed by request id |
src/daemon/server-requests.ts:532-549; src/contract/pushes.ts:85-95 |
| F3 | warm forget takes the platform as its first word |
src/cli/index.ts:25 |
| F4 | Worker-only operations answer UNSUPPORTED_IN_GATEWAY_MODE through unsupportedByDesign |
src/gateway/dispatcher.ts:268-274, :849-856 |
Modules touched
Searches: component.install, componentProgress, warm.forget, unsupportedByDesign, resolveSpec, RuntimeMissingError, PROTOCOL_VERSION_RANGE. New files: src/cli/commands/seed.ts, e2e/slow-seed-settle.test.ts. Also: src/daemon/dispatcher.ts (the handler map), src/daemon/dispatcher-options.ts and worker-composition.ts (the settler from createCore's seedSettler and leasing's resolveSeedSpec reach the handler), src/leasing/create-leasing.ts.
flowchart LR
CLI[cli/commands/seed] --> AC[simlock-client admin]
AC --> CT[contract seed.make]
CT --> DD[daemon dispatcher]
DD --> LR[leasing resolveSeedSpec]
DD --> SS[core seed-settle settle]
GW[gateway dispatcher] -.refuses.-> CT
Rules in play
- contract manual "Adding an operation" and "Protocol version": one bump in this PR.
- architecture.md rule 8: the CLI holds no decision; the daemon resolves, waits and answers.
- architecture.md rule 11: the 60-minute limit counts from arrival.
- documentation.md rule 9:
cli.mdx,errors.mdxandworker/capacity.mdxdescribesimlock seedand settling in this PR. src/instructions/index.ts: nothing tells an agent to runsimlock seed; it is an operator command.
Tests
The operation is driven through the daemon dispatcher with a fake driver and the real settler, modelled on src/daemon/dispatcher-components.test.ts; the CLI through runCli with a fake admin client, modelled on src/cli/index-catalog-components.test.ts.
- B10:
simlock seedmakes and settles a kind's seed: settled already; quick seed; no seed; another kind's settle running; this kind's background settle running; two calls for one kind; memory, disk and capacity waits; a failed make or settle; 60 minutes pass;--json - B11:
simlock seedrefuses what it cannot settle: no platform; unknown model;--image-tagwithios; a runtime not installed; iOS below 16; a gateway; an agent session; virtual devices off - B12: Ctrl-C stops the wait only: during
waiting; duringsettling;doctor --jsonafterwards - B13: on real hardware a settled seed's copy does less work: Android under a quarter, iOS under three quarters and under 0.3 cores from minute 3
Done when
pnpm test:changedpasses, with the B10 to B12 cases above.pnpm typecheckpasses.PROTOCOL_VERSION_RANGEis one higher than after #1746.pnpm test:e2e e2e/contract-surface.test.tspasses withseed.makeprobed.pnpm --dir website install && pnpm --dir website build && node website/scripts/check-openapi.mjspasses, andcli.mdx,errors.mdxandworker/capacity.mdxdescribesimlock seed,SEED_SETTLE_FAILEDand background settling.- Slow lane, on a Mac with an iOS 27 runtime and an Android SDK:
scripts/slow-e2e.sh e2e/slow-seed-settle.test.tspasses (B13).
Out of scope
- Pre-seeding from config; a
warmPool.targetsseed-only entry.
Depends on
- #1746
- #1747
- #1748
Written by an agent.
- Langage dominant
- TypeScript
- Étoiles
- 705
- Forks
- 40
- Merge moyen
- 12 h 9 min
- PR mergées (30 j)
- 376
Préparer son environnement
Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de callstackincubator/simlock
-
request:new
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
callstackincubator/simlock#1806 ·
Les mainteneurs répondent en général sous 1 jour
-
bug:new
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
callstackincubator/simlock#1780 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
task:draft
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
callstackincubator/simlock#1441 ·
Les mainteneurs répondent en général sous 1 jour
-
bug:new
Difficulté 2/5 1-3 heures Accessibilité débutants 45/100
callstackincubator/simlock#1805 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
bug:new
Difficulté 2/5 1-3 heures Accessibilité débutants 45/100
callstackincubator/simlock#1804 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de callstackincubator/simlock
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
Les mainteneurs répondent en général sous 1 jour
-
Update project links after the repository renamesPeut-être pris @JonathanTSilva l’a pris aujourd’hui. Ouverteai-generated priority: p2 size: xs type: bug
Difficulté 2/5 1-3 heures Accessibilité débutants 85/100
JonathanTSilva/jts-website#119 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
-
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
promplate/code-review#158 · 1 commentaire · 1 réaction ·
Les mainteneurs répondent en général sous 1 jour
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not existPeut-être pris @franpts2 l’a pris aujourd’hui. Ouvertedocs
Difficulté 1/5 Moins d'une heure Accessibilité débutants 90/100
Les mainteneurs répondent en général sous 3 jours