repo.work.assign_missing_identifiers

source: repo-manager
reason: deterministic projection registration

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 1116572@bnt-lap001
Assistant-Session: 8ba9bb93-a72a-4883-b189-2499cce5c400
This commit is contained in:
repo-manager 2026-09-04 01:52:06 +02:00
parent 813fee41b0
commit 0aab793a3a
8 changed files with 67 additions and 0 deletions

View file

@ -9,6 +9,7 @@ owner: worsch
topic_slug: fluid-core
created: "2026-09-04"
updated: "2026-09-04"
state_hub_workstream_id: "b5c231e1-9d06-5772-95a7-01cc0bf62051"
---
# Bootstrap State Hub integration
@ -21,6 +22,7 @@ Core framework for fluid interfaces to provide adaptive robust systems capabilit
id: FLUID-WP-0001-T01
status: todo
priority: high
state_hub_task_id: "f106ac45-c90b-5115-a0de-e986839b19f9"
```
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
@ -32,6 +34,7 @@ Replace generated placeholders with repo-specific facts where needed.
id: FLUID-WP-0001-T02
status: todo
priority: high
state_hub_task_id: "1e3f26fe-4a1a-5f96-8dd6-962dd844402e"
```
Identify the repo's install, test, lint, build, and run commands. Add or refine
@ -44,6 +47,7 @@ changes confidently.
id: FLUID-WP-0001-T03
status: todo
priority: medium
state_hub_task_id: "2428db4a-c6ad-547d-acf3-9163ea17ae20"
```
Create the first implementation workplan for the repository's most important

View file

@ -15,6 +15,7 @@ related_repos:
- fluid-telegram
- fluid-x
- fluid-substack
state_hub_workstream_id: "bd8c4140-9c82-500b-a52b-13f275411289"
---
# FLUID-WP-0002 - Foundations and the wire contract
@ -32,6 +33,7 @@ Reference: `spec/FluidHypothesisRevisionSchema.md`, `spec/ArchitectureBlueprint.
id: FLUID-WP-0002-T01
status: done
priority: high
state_hub_task_id: "bf47b3dd-9ca0-5ce2-9d9d-22dabab5f89c"
```
Go module, directory tree per the plan, `INTENT.md` declaring the wire-contract
@ -43,6 +45,7 @@ boundary and the four invariants this repo defends hardest.
id: FLUID-WP-0002-T02
status: todo
priority: high
state_hub_task_id: "5cf83eeb-819f-5972-a660-aa9f5345355f"
```
JSON Schema for `fluid_pressure`, `fluid_hypothesis`, `fluid_revision`,
@ -56,6 +59,7 @@ the interop surface, per its §1.
id: FLUID-WP-0002-T03
status: todo
priority: high
state_hub_task_id: "da22bde0-5138-56db-a26d-f63a3195d6ed"
```
JSON Schema for the revision descriptor (Blueprint §36) and the routing policy
@ -68,6 +72,7 @@ readable without any fluid-core code.
id: FLUID-WP-0002-T04
status: todo
priority: high
state_hub_task_id: "ba9933b2-0b92-55c4-96b0-b46c955e25a6"
```
Generate Go types into `internal/contract/` from `schemas/`. Hand-written record
@ -79,6 +84,7 @@ types are prohibited — drift between spec and implementation must fail CI.
id: FLUID-WP-0002-T05
status: todo
priority: high
state_hub_task_id: "f835faf7-98f4-514f-937d-83b86b4b44a5"
```
Extract the YAML examples embedded in the spec documents and validate them
@ -91,6 +97,7 @@ build breaks.
id: FLUID-WP-0002-T06
status: todo
priority: medium
state_hub_task_id: "2b0e42e0-c6ff-534e-8de4-3ff333af9e78"
```
Makefile, GitHub Actions (build, vet, test, schema validation), and the
@ -102,6 +109,7 @@ identifier prefix helpers from schema doc §16: `H- R- E- P- BR- D- EV- F- C-`.
id: FLUID-WP-0002-T07
status: todo
priority: medium
state_hub_task_id: "83b10a34-08e3-5ceb-81f4-f148a3d87183"
```
ADRs for: Go as the implementation language; out-of-process attachment; the

View file

@ -13,6 +13,7 @@ planning_priority: high
planning_order: 2
depends_on:
- FLUID-WP-0002
state_hub_workstream_id: "d9ce8eae-cd6f-5c43-a20b-eee8cc89b172"
---
# FLUID-WP-0003 - Deterministic data plane
@ -27,6 +28,7 @@ above it is dead.
id: FLUID-WP-0003-T01
status: todo
priority: high
state_hub_task_id: "0dac6ab6-f3e4-5234-bb3c-2393558d8590"
```
Transport termination, correlation IDs, coarse rate limiting, request size and
@ -38,6 +40,7 @@ shape limits. Blueprint §5.1 — the gateway must not invent interface semantic
id: FLUID-WP-0003-T02
status: todo
priority: high
state_hub_task_id: "6d8333ac-1bad-59a4-943d-b83819c8127a"
```
The §5.2 precedence chain: explicit revision, bound client contract, experiment
@ -50,6 +53,7 @@ without an auditable reason is a defect.
id: FLUID-WP-0003-T03
status: todo
priority: high
state_hub_task_id: "1f042c4f-9e3f-50fa-985c-e4f2ebb3b38a"
```
Map a resolved revision to an adapter upstream. Reject unpublished, failed,
@ -62,6 +66,7 @@ read from routing policy the router does not author.
id: FLUID-WP-0003-T04
status: todo
priority: high
state_hub_task_id: "70bae578-d3e3-5a00-b5cd-4c363bc5b473"
```
OpenAPI 3.1 request and response validation (§5.4). The contract digest is part
@ -73,6 +78,7 @@ of the revision artifact and is content-addressed.
id: FLUID-WP-0003-T05
status: todo
priority: high
state_hub_task_id: "0d62a681-3154-50af-894a-98b35db7b040"
```
Timeout, retry, circuit breaker, error mapping, tenant propagation (§5.6). The
@ -85,6 +91,7 @@ language-agnostic promise is kept.
id: FLUID-WP-0003-T06
status: todo
priority: medium
state_hub_task_id: "cc3c2a03-b24c-51de-b695-8aa9bfae85ab"
```
Structured errors carrying a FLUID correlation reference, leaking no backend
@ -96,6 +103,7 @@ detail (§5.7).
id: FLUID-WP-0003-T07
status: todo
priority: high
state_hub_task_id: "e10a5011-cb7e-5f1c-9a0d-0cfd2d535d13"
```
Fire-and-forget emission. Blueprint §34.2 is a hard invariant: telemetry
@ -107,6 +115,7 @@ backpressure must never block or slow a request. Test it under a stalled sink.
id: FLUID-WP-0003-T08
status: todo
priority: high
state_hub_task_id: "1773c7bf-9400-576e-9e74-aa210f08e0c4"
```
Append-only event storage, SQLite for development and Postgres-ready. Mutable
@ -118,6 +127,7 @@ summaries exist only as derived views (§26).
id: FLUID-WP-0003-T09
status: todo
priority: high
state_hub_task_id: "23d70a60-14bf-525e-a712-1d3a14111f62"
```
Bind every revision to an `InterfaceEvolutionIntent` version (§27), so audit can
@ -130,6 +140,7 @@ was made.
id: FLUID-WP-0003-T10
status: todo
priority: medium
state_hub_task_id: "ad7d83d7-a088-5ea4-94e7-fa5be49897b9"
```
`fluid revision create|publish|list`, `fluid intent show`, `fluid events tail`.

View file

@ -13,6 +13,7 @@ planning_priority: high
planning_order: 3
depends_on:
- FLUID-WP-0003
state_hub_workstream_id: "2221f88d-ffc5-5e22-80c2-d67a1b17f8ba"
---
# FLUID-WP-0004 - Publication and control APIs
@ -27,6 +28,7 @@ bypass.
id: FLUID-WP-0004-T01
status: todo
priority: high
state_hub_task_id: "74bf29c7-b8a6-5a18-bfc7-94641d12564b"
```
Blueprint §35: SOURCE, BUILD, CONTRACT CHECK, TEST, SECURITY CHECK, POLICY
@ -38,6 +40,7 @@ CHECK, SIGN, PUBLISH, ROUTE. Each stage emits an audit event.
id: FLUID-WP-0004-T02
status: todo
priority: high
state_hub_task_id: "9449aa0b-3c73-56d5-8768-df94b26f0282"
```
The router accepts only signed or otherwise authenticated published revision
@ -50,6 +53,7 @@ tested.
id: FLUID-WP-0004-T03
status: todo
priority: high
state_hub_task_id: "ba302369-3243-57ac-a34a-9a0a29002ac5"
```
Blueprint §44.1: create, verify, publish, set state, query lineage.
@ -60,6 +64,7 @@ Blueprint §44.1: create, verify, publish, set state, query lineage.
id: FLUID-WP-0004-T04
status: todo
priority: medium
state_hub_task_id: "27c597da-4f58-5a0d-b70e-8ba0749d9002"
```
Blueprint §44.5: read active intent, read historical intent, validate a
@ -72,6 +77,7 @@ governed — the API records a proposal, it does not enact one.
id: FLUID-WP-0004-T05
status: todo
priority: high
state_hub_task_id: "b2f96c6c-2c37-5892-bafd-ab9eb2c3f8c2"
```
Blueprint §28.2. Allowed adaptation class, permitted operational mode,
@ -86,6 +92,7 @@ policy.
id: FLUID-WP-0004-T06
status: todo
priority: medium
state_hub_task_id: "70cc234b-9570-5c51-8620-1a7d32b9a25c"
```
Blueprint §47 made mechanical: generated artifacts are an untrusted candidate

View file

@ -13,6 +13,7 @@ planning_priority: high
planning_order: 4
depends_on:
- FLUID-WP-0004
state_hub_workstream_id: "06661687-9a1b-5f11-b900-7b086c9c2975"
---
# FLUID-WP-0005 - FLUID Insight
@ -26,6 +27,7 @@ model inference anywhere in this workplan.
id: FLUID-WP-0005-T01
status: todo
priority: high
state_hub_task_id: "0c074022-031b-5049-832f-1fa8b1ff8b4f"
```
Request, error, sequence, adoption and explicit-feedback events into one
@ -37,6 +39,7 @@ normalized interaction event (Blueprint §6.1).
id: FLUID-WP-0005-T02
status: todo
priority: high
state_hub_task_id: "13086f4a-217c-5999-a039-90f5d84fb53b"
```
Field exclusion, pseudonymization, tenant isolation, retention, cohort minimum
@ -49,6 +52,7 @@ FLUID learns about the interface, not about people.
id: FLUID-WP-0005-T03
status: todo
priority: medium
state_hub_task_id: "815765d4-8d20-5c6f-87ac-e085778cd58c"
```
Coarse, stable, comparable over time (§6.3). Resist granularity: cohorts should
@ -60,6 +64,7 @@ not be more specific than the analysis requires.
id: FLUID-WP-0005-T04
status: todo
priority: high
state_hub_task_id: "27726efa-e054-56c2-a6b8-3cce8f2e85e7"
```
Recurring call-sequence detection (§6.4) — the signal that makes FLUID more than
@ -71,6 +76,7 @@ error counting.
id: FLUID-WP-0005-T05
status: todo
priority: high
state_hub_task_id: "d2e4f2df-809f-5817-9b74-e1533f8f71d9"
```
The ten pressure classes from §6.5. Classification retains evidence references
@ -82,6 +88,7 @@ in every case.
id: FLUID-WP-0005-T06
status: todo
priority: high
state_hub_task_id: "50bd30a6-ae29-5e2b-9618-a3efe6a362b3"
```
Deduplication, aggregation, frequency, severity, confidence, and the §9
@ -94,6 +101,7 @@ deserves adaptation.
id: FLUID-WP-0005-T07
status: todo
priority: high
state_hub_task_id: "ebecef59-2ff8-59c0-8cff-cde53030d0c8"
```
Blueprint §18: primary metrics, guardrails, secondary and learning metrics kept
@ -105,6 +113,7 @@ distinct. Baseline and measurement window are retained, never recomputed.
id: FLUID-WP-0005-T08
status: todo
priority: medium
state_hub_task_id: "48f6bbce-2ae8-5b72-8fdc-e962c6ea1f54"
```
API Standards §15. Accepted over the wire, stored as evidence, and never
@ -116,6 +125,7 @@ treated as authority to change anything.
id: FLUID-WP-0005-T09
status: todo
priority: medium
state_hub_task_id: "ba413808-346b-5026-bfce-aec0eae0c410"
```
Blueprint §44.2 plus `fluid pressure list|show|dismiss`, `fluid cohort list`,

View file

@ -13,6 +13,7 @@ planning_priority: high
planning_order: 5
depends_on:
- FLUID-WP-0005
state_hub_workstream_id: "b7096155-2641-5df2-857b-13d4240e7e3f"
---
# FLUID-WP-0006 - FLUID Science
@ -27,6 +28,7 @@ proving this loop works cleanly and safely, not autonomous coding.
id: FLUID-WP-0006-T01
status: todo
priority: high
state_hub_task_id: "93dd0a6d-3f46-5da5-857d-e0bd49c356db"
```
Schema doc §2: DRAFT, READY, PRIORITIZED, DESIGNING, EXPERIMENTING, EVALUATING,
@ -40,6 +42,7 @@ collapsing them into one narrative destroys criticism and auditability.
id: FLUID-WP-0006-T02
status: todo
priority: medium
state_hub_task_id: "81f6a22f-929e-5c94-bc61-f4e06ad7de16"
```
Rival explanations of one pressure coexist (schema doc §6). Preserving
@ -51,6 +54,7 @@ uncertainty is a feature.
id: FLUID-WP-0006-T03
status: todo
priority: medium
state_hub_task_id: "0050d3e4-cc5c-5e1d-9d29-d14bace0e1cf"
```
Blueprint §44.3: create, compare, prioritize, attach candidate, record outcome.
@ -61,6 +65,7 @@ Blueprint §44.3: create, compare, prioritize, attach candidate, record outcome.
id: FLUID-WP-0006-T04
status: todo
priority: high
state_hub_task_id: "36391a67-6a3e-54c9-afc5-181e0b968f85"
```
Blueprint §16. Declares hypothesis, control, candidate, cohorts, allocation,
@ -74,6 +79,7 @@ Experiments are interruptible.
id: FLUID-WP-0006-T05
status: todo
priority: medium
state_hub_task_id: "2c2a1ff5-f908-565f-ae5b-c0eb469e6482"
```
Blueprint §44.4: create, start, change bounded allocation, stop, record metrics,
@ -85,6 +91,7 @@ finalize.
id: FLUID-WP-0006-T06
status: todo
priority: high
state_hub_task_id: "7223f795-a005-5fe0-9abb-45e4803a3091"
```
Wire the fitness engine to experiments. Success criteria may not be changed
@ -96,6 +103,7 @@ after results are visible without recording the amendment (§18).
id: FLUID-WP-0006-T07
status: todo
priority: high
state_hub_task_id: "59188ee2-81e6-5331-a0f6-673b7daf871e"
```
PROMOTE, EXPAND_EXPERIMENT, RETAIN_AS_OPTION, MODIFY, REVERT, ABANDON, DEFER
@ -107,6 +115,7 @@ recorded as decisions with an authorizing actor (§19). Human authority only.
id: FLUID-WP-0006-T08
status: todo
priority: high
state_hub_task_id: "8eb2e90c-6c65-5ef5-be19-d42c2b091d8c"
```
Every transition above as a `fluid_event` (schema doc §15). FLUID evolution is
@ -118,6 +127,7 @@ itself a system behavior that must remain reconstructable.
id: FLUID-WP-0006-T09
status: todo
priority: high
state_hub_task_id: "7dd49f06-9cc7-5791-abfb-33b27649ba8a"
```
`fluid audit trace <revision>` reconstructs pressure, hypothesis, revision,

View file

@ -13,6 +13,7 @@ planning_priority: high
planning_order: 6
depends_on:
- FLUID-WP-0006
state_hub_workstream_id: "124d88bf-5573-5f58-8883-1efd5f6a603b"
---
# FLUID-WP-0007 - Conformance and self-validation
@ -26,6 +27,7 @@ here runs in CI with no human steps and no external services.
id: FLUID-WP-0007-T01
status: todo
priority: high
state_hub_task_id: "95b8d512-698c-5201-8f8d-18ff0a658f2c"
```
`examples/echo-interface` — two revisions, R-1 deliberately inefficient
@ -38,6 +40,7 @@ reproduction of the Blueprint §33 worked example.
id: FLUID-WP-0007-T02
status: todo
priority: high
state_hub_task_id: "71724683-78be-568c-bcd4-12df97e53941"
```
The seven requirements of API Standards §36, asserted as tests rather than
@ -49,6 +52,7 @@ claimed in a README.
id: FLUID-WP-0007-T03
status: todo
priority: high
state_hub_task_id: "0ac5c378-038c-5c76-b082-d4868f9bb12b"
```
The mechanically checkable subset of Blueprint §55. Invariant 2 (evolution can
@ -61,6 +65,7 @@ until verified) matter most and get dedicated tests.
id: FLUID-WP-0007-T04
status: todo
priority: high
state_hub_task_id: "7af0c88f-a00e-5cad-9fb6-2a297ecfd8b3"
```
Blueprint §34. Kill the control plane, the evidence store and the telemetry
@ -73,6 +78,7 @@ configuration each time.
id: FLUID-WP-0007-T05
status: todo
priority: high
state_hub_task_id: "45f70116-04f4-5150-9275-2c8023389dc9"
```
The full §50 vertical slice automated: two revisions, a 90/10 experiment,
@ -84,6 +90,7 @@ fitness comparison, promotion, complete audit trail.
id: FLUID-WP-0007-T06
status: todo
priority: medium
state_hub_task_id: "29ce43f9-17e5-5798-a3f3-051af97224ce"
```
`docs/integration-guide.md` — how to put an existing API of any stack behind

View file

@ -17,6 +17,7 @@ related_repos:
- fluid-telegram
- helix-forge
- hall-of-helix
state_hub_workstream_id: "291005a5-d474-5c94-8abd-819f682dde9f"
---
# FLUID-WP-0008 - Handover to fluid-telegram
@ -35,6 +36,7 @@ in the `fluid-telegram` repository.
id: FLUID-WP-0008-T01
status: todo
priority: high
state_hub_task_id: "e3d08f93-836e-56a8-ae20-4acc699e85ef"
```
Fill the template for `helix-forge-telegram-publishing`. Parent intent is
@ -49,6 +51,7 @@ entities, change membership, or touch credentials.
id: FLUID-WP-0008-T02
status: todo
priority: high
state_hub_task_id: "9896fee4-c20c-5f49-8428-37c7e221b8cb"
```
**Human step.** Register the HelixForge bot via BotFather (Canon BOT-01). Store
@ -62,6 +65,7 @@ Blueprint §28.1 runtime identity.
id: FLUID-WP-0008-T03
status: todo
priority: high
state_hub_task_id: "bb02bf5b-9d85-5c0d-8b88-9dd67694fb97"
```
**Human step.** Create a private test channel first, then the public
@ -75,6 +79,7 @@ published publicly.
id: FLUID-WP-0008-T04
status: todo
priority: high
state_hub_task_id: "00b2de31-8f84-5478-9489-fedfabf4cd84"
```
`POST /v1/hall-entries` (idempotent on entry id) and
@ -86,6 +91,7 @@ priority: high
id: FLUID-WP-0008-T05
status: todo
priority: high
state_hub_task_id: "24804694-1581-5d83-a5d4-db46e5af5070"
```
Map a `hall-of-helix/entries/*.md` file to a Telegram post. The adapter is a
@ -99,6 +105,7 @@ error mapping.
id: FLUID-WP-0008-T06
status: todo
priority: high
state_hub_task_id: "231d114a-5f36-53cb-ae81-508566b37d4a"
```
Subscriber classes and agent consumers as cohorts. Redaction rules that keep
@ -110,6 +117,7 @@ Telegram user identity (Canon ID-01) out of the evidence store entirely.
id: FLUID-WP-0008-T07
status: todo
priority: high
state_hub_task_id: "93569266-d282-5c0d-ac72-acbc704d18fd"
```
Telegram's 4096-character message limit against long-form entries is the first
@ -124,6 +132,7 @@ highest-value place to start.
id: FLUID-WP-0008-T08
status: todo
priority: high
state_hub_task_id: "befd476e-3465-51cd-a850-e006d653f322"
```
R-2 and R-3 implement H-A and H-B. Run the experiment on real subscriber
@ -136,6 +145,7 @@ reconstructs the whole chain. This is the §50 slice on a real workload.
id: FLUID-WP-0008-T09
status: todo
priority: medium
state_hub_task_id: "be0da67f-67d2-5c0d-bd19-0235310b053e"
```
Token rotation, channel admin recovery, rollback to R-1, and the assembled