spec: edge asset cache rulings R1, R2
Summary
Records Paul's two rulings: instances get an off switch only, and asset bytes count as usage like any other response.
1 file changed,
+9
−17
docs/superpowers/specs/2026-10-24-edge-asset-cache-design.md+9 −17
CI passed — run details
CI log
=== gate ===
.amadan/test-gate.sh
=== launchctx (1 s)
ok amadan.net/carlos/platform.git/launchctx 0.012s
? amadan.net/carlos/platform.git/launchctx/controlname [no test files]
? amadan.net/carlos/platform.git/launchctx/wireid [no test files]
=== vet (2 s)
=== gofmt (1 s)
gofmt -l .: clean
=== rest (150 s)
? github.com/carlosframework/platform/cmd/changelog [no test files]
ok github.com/carlosframework/platform/cmd/console 4.115s
ok github.com/carlosframework/platform/cmd/moveprobe 11.999s
ok github.com/carlosframework/platform/cmd/zddprobe 0.719s
ok github.com/carlosframework/platform/internal/activator 60.121s
ok github.com/carlosframework/platform/internal/agentsock 0.060s
ok github.com/carlosframework/platform/internal/alerting 0.006s
ok github.com/carlosframework/platform/internal/analytics 0.059s
ok github.com/carlosframework/platform/internal/appconfig 3.282s
ok github.com/carlosframework/platform/internal/apperr 0.114s
ok github.com/carlosframework/platform/internal/applog 0.194s
ok github.com/carlosframework/platform/internal/awsinv 0.005s
ok github.com/carlosframework/platform/internal/boxchoice 0.005s
ok github.com/carlosframework/platform/internal/boxid 1.191s
? github.com/carlosframework/platform/internal/boxid/boxidtest [no test files]
? github.com/carlosframework/platform/internal/boxid/internal/signtest [no test files]
ok github.com/carlosframework/platform/internal/boxvolumes 0.012s
ok github.com/carlosframework/platform/internal/caps 0.016s
ok github.com/carlosframework/platform/internal/certwarm 0.002s
ok github.com/carlosframework/platform/internal/cgroup 0.752s
ok github.com/carlosframework/platform/internal/changelog 0.554s
ok github.com/carlosframework/platform/internal/claimactivation 1.338s
ok github.com/carlosframework/platform/internal/clamd 0.061s
? github.com/carlosframework/platform/internal/cliflag [no test files]
? github.com/carlosframework/platform/internal/controlname [no test files]
? github.com/carlosframework/platform/internal/controlsock [no test files]
ok github.com/carlosframework/platform/internal/dbdoor 7.693s
ok github.com/carlosframework/platform/internal/dbdoor/dbdoortest 0.012s
ok github.com/carlosframework/platform/internal/dbquery 0.012s
ok github.com/carlosframework/platform/internal/dbreads 2.102s
? github.com/carlosframework/platform/internal/dbreads/dbreadstest [no test files]
ok github.com/carlosframework/platform/internal/dbverify 0.004s
ok github.com/carlosframework/platform/internal/dnsrec 0.004s
ok github.com/carlosframework/platform/internal/docsite 0.015s
ok github.com/carlosframework/platform/internal/domains 3.105s
ok github.com/carlosframework/platform/internal/doorkey 0.008s
ok github.com/carlosframework/platform/internal/economics 0.005s
ok github.com/carlosframework/platform/internal/edge 45.878s
? github.com/carlosframework/platform/internal/edgeproof [no test files]
ok github.com/carlosframework/platform/internal/edgesfile 0.012s
ok github.com/carlosframework/platform/internal/fleetapi 0.168s
ok github.com/carlosframework/platform/internal/gate 2.075s
ok github.com/carlosframework/platform/internal/genselect 0.031s
ok github.com/carlosframework/platform/internal/geo 0.038s
ok github.com/carlosframework/platform/internal/geoip 0.048s
ok github.com/carlosframework/platform/internal/historyreadback 0.315s
ok github.com/carlosframework/platform/internal/host 147.010s
ok github.com/carlosframework/platform/internal/hostactors 6.689s
ok github.com/carlosframework/platform/internal/hostactors/awsmembership 0.005s
ok github.com/carlosframework/platform/internal/hostbox 3.271s
ok github.com/carlosframework/platform/internal/hostclaim 1.021s
ok github.com/carlosframework/platform/internal/hostenv 0.014s
ok github.com/carlosframework/platform/internal/hostevidence 0.009s
ok github.com/carlosframework/platform/internal/hostexec 5.725s
ok github.com/carlosframework/platform/internal/hostfence 0.046s
ok github.com/carlosframework/platform/internal/hostfiles 10.269s
ok github.com/carlosframework/platform/internal/hostfloor 0.022s
ok github.com/carlosframework/platform/internal/hostguard 1.036s
ok github.com/carlosframework/platform/internal/hostops 2.367s
? github.com/carlosframework/platform/internal/hostops/fencerelease [no test files]
ok github.com/carlosframework/platform/internal/hostops/internal/fencerelease 0.004s
ok github.com/carlosframework/platform/internal/hostquarantine 0.004s
ok github.com/carlosframework/platform/internal/hostrelocate 0.617s
ok github.com/carlosframework/platform/internal/hostresolve 0.170s
ok github.com/carlosframework/platform/internal/hostwrite 0.002s
ok github.com/carlosframework/platform/internal/infraview 0.002s
ok github.com/carlosframework/platform/internal/instancectl 5.250s
ok github.com/carlosframework/platform/internal/instanceexec 2.834s
ok github.com/carlosframework/platform/internal/instancefs 0.012s
ok github.com/carlosframework/platform/internal/instancekey 0.003s
ok github.com/carlosframework/platform/internal/instanceupdates 0.021s
ok github.com/carlosframework/platform/internal/layout 2.027s
ok github.com/carlosframework/platform/internal/lbhealth 0.007s
ok github.com/carlosframework/platform/internal/lease 10.280s
ok github.com/carlosframework/platform/internal/lease/leasetest 0.559s
ok github.com/carlosframework/platform/internal/ledger 0.017s
ok github.com/carlosframework/platform/internal/mail 0.239s
ok github.com/carlosframework/platform/internal/maintenance 0.090s
ok github.com/carlosframework/platform/internal/maintenanceexec 5.680s
ok github.com/carlosframework/platform/internal/maintenanceguard 0.079s
ok github.com/carlosframework/platform/internal/metrics 0.006s
ok github.com/carlosframework/platform/internal/moves 22.496s
ok github.com/carlosframework/platform/internal/moves/archive 1.303s
ok github.com/carlosframework/platform/internal/objstore 0.309s
ok github.com/carlosframework/platform/internal/ops 0.211s
ok github.com/carlosframework/platform/internal/park 0.270s
ok github.com/carlosframework/platform/internal/plans 0.006s
ok github.com/carlosframework/platform/internal/privatefile 0.005s
ok github.com/carlosframework/platform/internal/provision 16.790s
ok github.com/carlosframework/platform/internal/publicrelease 0.007s
? github.com/carlosframework/platform/internal/regionname [no test files]
ok github.com/carlosframework/platform/internal/registry 5.629s
ok github.com/carlosframework/platform/internal/relay 7.239s
ok github.com/carlosframework/platform/internal/release 27.248s
ok github.com/carlosframework/platform/internal/rollout 3.819s
ok github.com/carlosframework/platform/internal/rolloutwords 0.004s
ok github.com/carlosframework/platform/internal/rootaws 0.007s
ok github.com/carlosframework/platform/internal/rootparticipation 0.068s
ok github.com/carlosframework/platform/internal/rootstate 0.028s
ok github.com/carlosframework/platform/internal/runs 0.570s
ok github.com/carlosframework/platform/internal/s3compat 0.005s
ok github.com/carlosframework/platform/internal/safefile 0.006s
ok github.com/carlosframework/platform/internal/schedule 2.752s
ok github.com/carlosframework/platform/internal/seeds 0.019s
ok github.com/carlosframework/platform/internal/sim/engines 2.954s
ok github.com/carlosframework/platform/internal/sim/hostlife 14.139s
ok github.com/carlosframework/platform/internal/sim/litestreamfacts 3.489s
ok github.com/carlosframework/platform/internal/status 0.070s
ok github.com/carlosframework/platform/internal/steering 0.006s
ok github.com/carlosframework/platform/internal/stopevidence 0.229s
ok github.com/carlosframework/platform/internal/svcrole 0.004s
ok github.com/carlosframework/platform/internal/telemetry 0.005s
ok github.com/carlosframework/platform/internal/termfence 0.004s
ok github.com/carlosframework/platform/internal/tunnelclient 0.005s
ok github.com/carlosframework/platform/internal/unixdial 0.004s
ok github.com/carlosframework/platform/internal/updatewords 0.006s
ok github.com/carlosframework/platform/internal/usage 0.007s
ok github.com/carlosframework/platform/internal/version 0.002s
ok github.com/carlosframework/platform/internal/vet 1.689s
=== internal_console@0 (87 s)
ok github.com/carlosframework/platform/internal/console 84.613s
=== internal_console@1 (46 s)
ok github.com/carlosframework/platform/internal/console 43.412s
=== internal_console@2 (42 s)
ok github.com/carlosframework/platform/internal/console 40.137s
=== internal_console@3 (42 s)
ok github.com/carlosframework/platform/internal/console 40.326s
=== internal_console@4 (45 s)
ok github.com/carlosframework/platform/internal/console 42.742s
=== internal_console@5 (42 s)
ok github.com/carlosframework/platform/internal/console 40.009s
=== internal_console@6 (38 s)
ok github.com/carlosframework/platform/internal/console 35.618s
=== internal_console@7 (48 s)
ok github.com/carlosframework/platform/internal/console 45.634s
=== root@0 (112 s)
ok github.com/carlosframework/platform 110.074s
=== root@1 (86 s)
ok github.com/carlosframework/platform 83.920s
=== root@2 (94 s)
ok github.com/carlosframework/platform 92.085s
=== cross ===
--- shard 0 of 5 ---
cross-compiling darwin/arm64
--- shard 1 of 5 ---
cross-compiling darwin/amd64
--- shard 2 of 5 ---
cross-compiling linux/arm64
linux/arm64 carlos binary: 50528418 bytes (ceiling 52000000)
--- shard 3 of 5 ---
cross-compiling windows/amd64
--- shard 4 of 5 ---
cross-compiling windows/arm64
=== minio-contract ===
minio contract: arm64, minio RELEASE.2025-09-07T16-13-09Z, mc RELEASE.2025-08-13T08-35-41Z
minio: cached, digest verified
mc: cached, digest verified
minio healthy on 127.0.0.1:20999
Added `local` successfully.
Bucket created successfully `local/contract-bucket`.
Bucket created successfully `local/denied-bucket`.
Created policy `contract-only` successfully.
Added user `scopeduser` successfully.
Attached Policies: [contract-only]
To User: scopeduser
buckets and scoped user ready
=== RUN TestDeliveredContractMinio
=== RUN TestDeliveredContractMinio/put
=== RUN TestDeliveredContractMinio/get_round-trips_the_body
=== RUN TestDeliveredContractMinio/list_shows_the_key
=== RUN TestDeliveredContractMinio/head_and_list_agree_on_the_version
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_its_own_object
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_its_own_object/not_by_PutObjectTagging
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_its_own_object/and_not_by_x-amz-tagging_on_upload
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/not_by_CreateMultipartUpload
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/not_by_CopyObject_with_a_REPLACE_tagging_directive
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/but_multipart_itself_is_allowed
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/and_copy_itself_is_allowed
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/a_POST-policy_forged_tag_with_a_matching_version_is_still_not_a_verdict
=== RUN TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/and_an_ordinary_tagged-with-something-else_upload_is_allowed
=== RUN TestDeliveredContractMinio/delete_removes_it
=== RUN TestDeliveredContractMinio/cross-bucket_denial
--- PASS: TestDeliveredContractMinio (0.03s)
--- PASS: TestDeliveredContractMinio/put (0.00s)
--- PASS: TestDeliveredContractMinio/get_round-trips_the_body (0.00s)
--- PASS: TestDeliveredContractMinio/list_shows_the_key (0.00s)
--- PASS: TestDeliveredContractMinio/head_and_list_agree_on_the_version (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_its_own_object (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_its_own_object/not_by_PutObjectTagging (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_its_own_object/and_not_by_x-amz-tagging_on_upload (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route (0.02s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/not_by_CreateMultipartUpload (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/not_by_CopyObject_with_a_REPLACE_tagging_directive (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/but_multipart_itself_is_allowed (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/and_copy_itself_is_allowed (0.01s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/a_POST-policy_forged_tag_with_a_matching_version_is_still_not_a_verdict (0.00s)
--- PASS: TestDeliveredContractMinio/the_app_cannot_tag_by_any_other_route/and_an_ordinary_tagged-with-something-else_upload_is_allowed (0.00s)
--- PASS: TestDeliveredContractMinio/delete_removes_it (0.00s)
--- PASS: TestDeliveredContractMinio/cross-bucket_denial (0.00s)
PASS
ok github.com/carlosframework/platform/internal/objstore 0.031s
=== RUN TestT4StorageProbeMinio
2026/10/24 17:44:03 moves: T4: STORE: list: operation error S3: ListObjectsV2, https response error StatusCode: 403, RequestID: 18E1882AB9230F0B, HostID: 7c420053e0fbcd7f41653fdd92ffa2802c903d05303b1aa15adc2e8bb65d183f, api error SignatureDoesNotMatch: The request signature we calculated does not match the signature you provided. Check your key and signing method.
--- PASS: TestT4StorageProbeMinio (0.01s)
PASS
ok github.com/carlosframework/platform/internal/host 0.023s
=== RUN TestS3StoreMinioContract
=== RUN TestS3StoreMinioContract/conditional_get_and_etag_listing
=== RUN TestS3StoreMinioContract/bump_through_every_mutation_path
--- PASS: TestS3StoreMinioContract (0.03s)
--- PASS: TestS3StoreMinioContract/conditional_get_and_etag_listing (0.01s)
--- PASS: TestS3StoreMinioContract/bump_through_every_mutation_path (0.02s)
PASS
ok github.com/carlosframework/platform/internal/release 0.036s
Bucket created successfully `local/dbf-deploy`.
Bucket created successfully `local/dbf-data-ie`.
Bucket created successfully `local/dbf-data-uk`.
local/dbf-deploy versioning is enabled
Created policy `dbf-console` successfully.
Created policy `dbf-ukbox` successfully.
Added user `dbfconsole` successfully.
Added user `dbfukbox` successfully.
Attached Policies: [dbf-console]
To User: dbfconsole
Attached Policies: [dbf-ukbox]
To User: dbfukbox
=== RUN TestDBForwardMinio
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000000 txid.db=0000000000000001
2026/10/24 17:44:06 INFO ltx file uploaded system=store db=source.db replica=file level=0 minTXID=0000000000000001 maxTXID=0000000000000001 size=720
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000001 txid.db=0000000000000001
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000001 txid.db=0000000000000002
2026/10/24 17:44:06 INFO ltx file uploaded system=store db=source.db replica=file level=0 minTXID=0000000000000002 maxTXID=0000000000000002 size=370
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000002 txid.db=0000000000000002
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000002 txid.db=0000000000000003
2026/10/24 17:44:06 INFO ltx file uploaded system=store db=source.db replica=file level=0 minTXID=0000000000000003 maxTXID=0000000000000003 size=454
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000003 txid.db=0000000000000003
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000000 txid.db=0000000000000001
2026/10/24 17:44:06 INFO ltx file uploaded system=store db=source.db replica=file level=0 minTXID=0000000000000001 maxTXID=0000000000000001 size=720
2026/10/24 17:44:06 INFO replica sync system=store db=source.db replica=file txid.replica=0000000000000001 txid.db=0000000000000001
2026/10/24 17:44:06 console: CARLOS_SECRETS_PUBKEY is unset, so no region outside the home can be chosen automatically
2026/10/24 17:44:06 console: could not notify member@example.com of a CLI token issue: keymail: lookup member@example.com: keymail: GET /api/federation/lookup?addr=member%40example.com&from=console%40127.0.0.1%3A32775: could not determine target mailbox
agent.go:135: dbreads: dbr_yor2nlxozdfla3bzntkd242v5q: planned 3 files (1544 bytes) and restored to 3 in 13ms
agent.go:135: dbreads: dbr_yor2nlxozdfla3bzntkd242v5q: output 5 bytes in 1 confirmed chunks in 2ms
2026/10/24 17:44:07 console: db read dbr_yor2nlxozdfla3bzntkd242v5q: relayed 1 chunks (102 bytes) in 1.009s, ended done
agent.go:135: dbreads: dbr_wowvokgmarymwozwonw3f3n6ou: planned 1 files (720 bytes) and restored to 1 in 10ms
agent.go:135: dbreads: dbr_wowvokgmarymwozwonw3f3n6ou: output 5 bytes in 1 confirmed chunks in 1ms
2026/10/24 17:44:08 console: db read dbr_wowvokgmarymwozwonw3f3n6ou: relayed 1 chunks (102 bytes) in 1.005s, ended done
agent.go:135: dbreads: dbr_sxsqlqcwjaaoy65kwhazfvf3py: planned 3 files (1544 bytes) and held through 3 in 14ms
agent.go:135: dbreads: dbr_sxsqlqcwjaaoy65kwhazfvf3py: output 1544 bytes in 1 confirmed chunks in 1ms
2026/10/24 17:44:09 console: db read dbr_sxsqlqcwjaaoy65kwhazfvf3py: relayed 1 chunks (1641 bytes) in 1.006s, ended done
=== RUN TestDBForwardMinio/by_disconnect
=== NAME TestDBForwardMinio
agent.go:135: dbreads: dbr_p4iklqvoykf2ylkefhvsrxajya: planned 3 files (1544 bytes) and restored to 3 in 13ms
2026/10/24 17:44:09 console: db read dbr_p4iklqvoykf2ylkefhvsrxajya: relayed 0 chunks (0 bytes) in 35ms, ended client gone
agent.go:135: dbreads: dbr_p4iklqvoykf2ylkefhvsrxajya: output 5 bytes in 1 confirmed chunks in 105ms
=== RUN TestDBForwardMinio/by_timeout
=== NAME TestDBForwardMinio
agent.go:135: dbreads: dbr_cnsnzv6pnv6ldqkmuy4zbcbqhe: planned 3 files (1544 bytes) and restored to 3 in 12ms
2026/10/24 17:44:29 console: db read dbr_cnsnzv6pnv6ldqkmuy4zbcbqhe: relayed 0 chunks (0 bytes) in 19.203s, ended no-result
agent.go:135: dbreads: dbr_cnsnzv6pnv6ldqkmuy4zbcbqhe: output 5 bytes in 1 confirmed chunks in 19.171s
--- PASS: TestDBForwardMinio (22.68s)
--- PASS: TestDBForwardMinio/by_disconnect (0.25s)
--- PASS: TestDBForwardMinio/by_timeout (19.31s)
PASS
ok github.com/carlosframework/platform/internal/console 22.699s
minio contract: PASS
diff --git a/docs/superpowers/specs/2026-10-24-edge-asset-cache-design.md b/docs/superpowers/specs/2026-10-24-edge-asset-cache-design.md| index c591e165f..aa5a40a21 100644 |
| --- a/docs/superpowers/specs/2026-10-24-edge-asset-cache-design.md |
| +++ b/docs/superpowers/specs/2026-10-24-edge-asset-cache-design.md |
| @@ -1,6 +1,6 @@ |
| # Edge asset cache: versioned build assets served from every edge |
| -Branch `edge-asset-cache`. Status: rev 2, 2026-10-24, builder check folded in; two questions for Paul (§13). |
| +Branch `edge-asset-cache`. Status: rev 2, 2026-10-24, builder check folded in; rulings R1 and R2 (§13). Awaiting Paul's approval, then Astra review. |
| Related: media roadmap (`2026-09-07-media-platform-roadmap-design.md`), |
| which this does not amend; #368 (the shared cache stores 206 responses). |
| @@ -146,7 +146,7 @@ beside `gate` and `steering`) and `carlos instances update <host> |
| --assets=off|on`. It reaches the route row through `RouteFor` and |
| `convergeOwned` like `Steering` and `Gate`. Use: an instance whose traffic |
| must always reach the app, or a quick off switch while debugging. |
| -(My call; see Q1.) |
| +(R1.) |
| ### 3.3 When a route catches nothing |
| @@ -426,7 +426,7 @@ bytes out, attributed by the published account and app, by whichever edge |
| served it. Today the sending edge of a backhaul records nothing and the |
| home records the hop (`usagemeter.go:43-45`); for caught paths the serving |
| edge records instead, and a fill's backhaul is recorded once, not twice. |
| -Asset bytes are not free bandwidth. (My call; see Q2.) |
| +Asset bytes are not free bandwidth. (R2.) |
| ## 9. Provider boundary |
| @@ -512,21 +512,12 @@ Then, on dev: an asset requested through the far region's edge is a |
| for it, and a 5 MiB bundle is served gzip-compressed from the far edge. |
| On flagship, the same from a small box with the disk figures recorded. |
| -## 13. Questions for Paul |
| +## 13. Rulings (Paul, 2026-10-24) |
| -Q1 and Q2 below are the only ones the builder check left that change |
| -what gets built. Everything else it raised is folded in and marked |
| -**(astra BN)**. |
| - |
| -1. **Instance-level declarations.** v1 lets the release declare the paths |
| - and lets an instance only switch catching off (§3.2). Should an |
| - instance also be able to declare paths of its own? It would mean a |
| - second source of paths to merge with the release's, and a reason for |
| - the record to carry a list. Recommendation: off switch only in v1. |
| -2. **Usage.** v1 counts every asset hit and fill as the app's request and |
| - bytes out, on whichever edge served it (§8). Should edge-served asset |
| - bytes count against plan caps exactly like other responses, or be |
| - cheaper or free? Recommendation: count them the same in v1. |
| +- **R1. Instance off switch only.** Paths come from the release; an |
| + instance can switch catching off and cannot declare paths (§3.2). |
| +- **R2. Asset bytes count the same.** Every hit and fill is the app's |
| + request and bytes out, against plan caps like any other response (§8). |
| ## 14. Review log |
| @@ -539,3 +530,4 @@ what gets built. Everything else it raised is folded in and marked |
| paths; B6 marked fills bypass the home's LRU and meter; B8 `assets_at` |
| stamp and record-view bound; B9 import gate excluded. Purge status no |
| longer claims a far-edge acknowledgement it has no channel for. |
| + Rulings R1 and R2 recorded. |