simlock seed makes and settles a kind's seed on a worker
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 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 分钟
- 30 天内合并 PR
- 376
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 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 个 reaction ·
维护者通常 1 天内回复
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not exist可能已有人在做 @franpts2 今天认领。 未关闭docs
难度 1/5 1 小时以内 新手友好度 90/100
维护者通常 3 天内回复