simlock seed makes and settles a kind's seed on a worker
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 18/100
- issue の種類
- 機能追加
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- typescript
- 領域
- api, backend, cli, documentation, testing
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
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.
- 主要言語
- TypeScript
- スター
- 705
- フォーク
- 40
- 平均マージ
- 12時間 9分
- マージ済み PR(30日)
- 376
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
callstackincubator/simlock のほかの issue
-
request:new
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
callstackincubator/simlock#1806 ·
メンテナーはふだん 1 日以内に返信
-
bug:new
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
callstackincubator/simlock#1780 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
task:draft
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
callstackincubator/simlock#1441 ·
メンテナーはふだん 1 日以内に返信
-
bug:new
難易度 2/5 1〜3時間 初心者へのやさしさ 45/100
callstackincubator/simlock#1805 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
bug:new
難易度 2/5 1〜3時間 初心者へのやさしさ 45/100
callstackincubator/simlock#1804 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
callstackincubator/simlock の issue をすべて見る
似ている issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
Update project links after the repository renames対応中かも @JonathanTSilva が今日担当しました。 オープンai-generated priority: p2 size: xs type: bug
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
JonathanTSilva/jts-website#119 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
promplate/code-review#158 · コメント 1 件 · リアクション 1 件 ·
メンテナーはふだん 1 日以内に返信
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not exist対応中かも @franpts2 が今日担当しました。 オープンdocs
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
メンテナーはふだん 3 日以内に返信