FlowmemoryAI · FlowmemoryAI · May 13, 2026
diff --git a/docs/CURRENT_STATE.md b/docs/CURRENT_STATE.md
@@ -118,6 +118,12 @@ Launch-core specifications:
 - `docs/FLOWCHAIN_TESTNET_ACCEPTANCE.md` marks private/local testnet features as implemented, in flight, missing, or later gated.
 - `docs/FLOWCHAIN_AGENT_INTEGRATION_MAP.md` maps the next-wave worktree ownership and cross-agent handoffs.
 - `docs/FLOWCHAIN_TROUBLESHOOTING.md` and `docs/FLOWCHAIN_OPERATOR_CHECKLIST.md` provide the Windows-first second-computer troubleshooting and operator checklist layer.
+- `docs/FLOWCHAIN_HQ_INTEGRATION_STATUS.md` is the live HQ issue/PR, branch
+  ownership, merge-order, and full-smoke blocker map for the full local/private
+  L1 push.
+- `docs/agent-goals/full-l1/` contains the active copy-ready full-L1 agent
+  prompts, and `infra/scripts/launch-full-l1-agents.ps1` launches those
+  dedicated worktree agents.
 - `docs/DECISIONS/rootflow-v0.md` records the V0 decision and non-goal boundaries.
 - `docs/reviews/ROOTFLOW_FLOW_MEMORY_V0_ACCEPTANCE_AUDIT.md` tracks evidence and missing work for the active launch-core goal.
 - `docs/reviews/OPEN_PR_MERGE_READINESS.md` is now historical merge-readiness evidence for PRs that have merged.
@@ -127,18 +133,24 @@ FlowChain private/local testnet snapshot:
 
 - Implemented: V0 launch-core generation and validation, no-value deterministic
   Rust devnet prototype, contract event/settlement spine, crypto V0 helpers and
-  vectors, fixture indexer/verifier, fixture-backed dashboard, hardware POC
+  vectors, fixture indexer/verifier, fixture-backed control-plane API,
+  fixture-backed dashboard, test-only bridge POC foundation, hardware POC
   simulator, Base Sepolia reader/deploy commands, guarded canary reader, and
   Windows-first root wrapper commands for prerequisite checks, init, bounded
-  start/stop, demo, smoke, export/import, and workbench dev mode.
-- In flight: native private-testnet object lifecycle, local control-plane API,
-  private-testnet object IDs and envelopes, workbench extension, optional
-  hardware operator signal fixtures, and advanced L1 research gates.
+  start/stop, demo, smoke, temporary full-smoke blocker reporting,
+  export/import, bridge mock/test, control-plane serve/smoke, and workbench dev
+  mode.
+- In flight: native private-testnet object lifecycle, live-node control-plane
+  adapters, private-testnet object IDs and signed envelopes, wallet/vault
+  support, bridge local-credit application, workbench live-state extension,
+  optional hardware operator signal fixtures, and advanced L1 research gates.
 - Missing: long-running local runtime start behavior, private genesis/config
   package beyond the deterministic devnet genesis, full native object
-  lifecycle coverage, full control-plane method coverage, full workbench entity
-  coverage, no-secret API checks, and second-computer smoke evidence for the
-  unmerged native object/control-plane/workbench surfaces.
+  lifecycle coverage, signed transaction intake, encrypted local wallet,
+  full live control-plane method coverage, full workbench entity coverage,
+  bridge local-credit smoke, no-secret API checks, and second-computer smoke
+  evidence for the unmerged native object/control-plane/workbench/bridge
+  surfaces.
 - Later gated: production L1/mainnet, public validators, tokenomics,
   production bridge, production hook deployment, audited cryptography,
   proof-circuit infrastructure, production hardware, and hosted production
@@ -165,17 +177,24 @@ FlowChain private/local testnet snapshot:
 
 ## Active GitHub Work Shape
 
-Issues #6 through #55 define the current foundation-hardening backlog. They are organized into program milestones in `docs/ISSUE_BACKLOG.md`.
+Issues #6 through #55 define the foundation-hardening backlog. GitHub milestone
+#7 and issues #99 through #108 define the current full local/private L1
+workstreams. They are organized in `docs/ISSUE_BACKLOG.md` and summarized in
+`docs/FLOWCHAIN_HQ_INTEGRATION_STATUS.md`.
 
 Closed issue notes:
 
 - #16 was closed as not planned because its scope was folded into other architecture/status issues.
 - #39 was closed; future on-chain verifier adapter work should stay gated behind accepted verifier and crypto boundaries.
+- #76, #77, and #79 are closed canary follow-ups and should not be treated as
+  active private/local testnet blockers.
 
-As of the 2026-05-13 HQ review for the private/local testnet next wave, GitHub
-shows open draft PRs #71 and #73, plus open canary follow-up issues #76 through
-#79. Local sibling worktrees contain unmerged Local Alpha work; those changes
-are useful context but are not source of truth until merged.
+As of the 2026-05-13 HQ review for the full local/private L1 push, GitHub shows
+open draft PRs #71, #73, #110, #111, #112, #113, and #114. PR #98 has merged into `main` and added the
+full-L1 agent prompt/launcher layer. Issue #78 remains open for the real
+Uniswap v4 hook path but is outside the private/local runtime critical path.
+Local sibling worktrees contain unmerged full-L1 work; those changes are useful
+context but are not source of truth until merged.
 
 Recently merged PRs:
 
@@ -188,6 +207,8 @@ Recently merged PRs:
 - #62 Dashboard V0.
 - #68 Launch-core FlowMemory V0 integration.
 - #69 Contract event spine for launch-core Flow Memory objects.
+- #97 Control-plane CORS/browser-safe endpoint fix.
+- #98 Full L1 agent goal launcher.
 
 ## Active Local Work
 
@@ -219,9 +240,9 @@ Before assigning agents, check for dirty worktrees and avoid overlapping folders
 ## Current Operator Priorities
 
 1. Keep the generated launch-core command stable in CI.
-2. Keep the new root wrapper path usable on Windows: `flowchain:prereq`, `flowchain:init`, `flowchain:start`, `flowchain:demo`, `flowchain:smoke`, `flowchain:export`, and `workbench:dev`.
+2. Keep the root wrapper path usable on Windows: `flowchain:prereq`, `flowchain:init`, `flowchain:start`, `flowchain:demo`, `flowchain:smoke`, `flowchain:full-smoke`, `flowchain:export`, `control-plane:serve`, bridge mock/test commands, and `workbench:dev`.
 3. Convert the remaining V0/local-alpha surfaces into one FlowChain private/local L1 testnet package for second-computer validation.
-4. Land the missing subsystem pieces behind the wrappers: long-running runtime behavior, control-plane serve/query coverage, native object lifecycle, and workbench entity coverage.
+4. Land the missing subsystem pieces behind the wrappers: long-running runtime behavior, wallet/signing, live control-plane query/submission coverage, native object lifecycle, bridge local-credit smoke, and workbench entity coverage.
 5. Keep the guarded Base canary reader and dashboard canary artifacts fresh when canary smoke actions change.
 6. Exercise the Base Sepolia deploy/read path on explicit testnet contract addresses only.
 7. Continue contracts hardening without production mainnet deployment or token mechanics.

diff --git a/docs/DAILY_HQ_RUNBOOK.md b/docs/DAILY_HQ_RUNBOOK.md
@@ -35,18 +35,23 @@ Morning:
 
 - Confirm GitHub open PRs and issues still match `docs/CURRENT_STATE.md` and
   `docs/ISSUE_BACKLOG.md`.
+- Confirm `docs/FLOWCHAIN_HQ_INTEGRATION_STATUS.md` matches GitHub milestone
+  #7, issues #99-#108, and open PRs.
 - Check all sibling worktrees for dirty changes before assigning agents.
 - Verify no two active agents are editing the same folder family or source-of-truth
   doc without coordination.
 - Review `docs/FLOWCHAIN_TESTNET_ACCEPTANCE.md` for rows that changed from
   missing to in flight or implemented after merges.
 - Verify root command aliases in `package.json` still match the scripts under
   `infra/scripts/flowchain-*.ps1`.
+- Verify `npm run flowchain:full-smoke -- -AllowIncomplete -SkipMergedSmoke`
+  still reports missing subsystem commands with owning issue numbers until
+  #108 is ready to pass.
 - Confirm the next assigned work extends the existing devnet, control-plane,
   crypto, dashboard, contracts, hardware, or research surface instead of adding
   a replacement system.
-- Keep production L1, tokenomics, public validator, production bridge, audited
-  cryptography, production hook, and production hardware claims blocked.
+- Keep public-chain launch, tokenomics, public validator, value-bearing bridge,
+  audited-cryptography, production hook, and production hardware claims blocked.
 
 Evening:
 
@@ -61,6 +66,8 @@ Evening:
   day, and name the first failing step.
 - Save or cite `devnet/local/smoke/flowchain-smoke-report.json` when full smoke
   runs locally.
+- Save or cite `devnet/local/smoke/flowchain-full-smoke-report.json` when the
+  full-L1 wrapper is run, even if it is expected to report blockers.
 - Require `git diff --check` in each PR summary and area tests where the touched
   area has tests.
 

diff --git a/docs/EASY_SECOND_COMPUTER_SETUP.md b/docs/EASY_SECOND_COMPUTER_SETUP.md
@@ -46,6 +46,16 @@ initializes local state, runs the deterministic local chain demo, runs the smoke
 path, exports a local bundle, runs the bridge mock, and opens the control plane
 and dashboard in separate PowerShell windows.
 
+The current installer uses the merged-surface smoke path. The full local L1
+acceptance wrapper is:
+
+```powershell
+npm run flowchain:full-smoke -- -AllowIncomplete
+```
+
+It reports the remaining subsystem blockers until issues #99 through #108 are
+finished.
+
 ## Already Cloned Setup
 
 If the repo is already cloned:

diff --git a/docs/FLOWCHAIN_AGENT_INTEGRATION_MAP.md b/docs/FLOWCHAIN_AGENT_INTEGRATION_MAP.md
@@ -25,6 +25,7 @@ or setup flow.
 | Dashboard / Workbench | `E:\FlowMemory\flowmemory-dashboard` | `apps/dashboard/` | Existing dashboard app, fixtures, styling, data model | New dashboard app, services, crypto, contracts |
 | Hardware | `E:\FlowMemory\flowmemory-hardware` | `hardware/`, `fixtures/hardware/` | Existing FlowRouter simulator and POC docs | Chain runtime, services, dashboard implementation |
 | Contracts | `E:\FlowMemory\flowmemory-contracts` | `contracts/`, `tests/` | Existing FlowPulse and registry/event skeletons | Core private L1 runtime, tokenomics, bridge |
+| Bridge | `E:\FlowMemory\flowmemory-bridge-full` | `services/bridge-relayer/`, `contracts/bridge/`, `tests/bridge/`, `fixtures/bridge/`, bridge schemas/docs | Existing bridge POC docs, relayer package, schemas, and guarded smoke boundaries | Production bridge, real-funds default paths, dashboard implementation, core runtime |
 | Research | `E:\FlowMemory\flowmemory-research` | `research/`, `docs/DECISIONS/` | Existing research gates and decisions | Implementation folders, public-chain claims |
 
 ## Current Coordination Facts
@@ -37,6 +38,15 @@ or setup flow.
 - Active sibling worktrees contain unmerged Local Alpha work for devnet object
   transitions, control-plane API, crypto object identity, hardware signal
   projection, and research gates.
+- The full-L1 launcher from PR #98 has merged into `main`. It defines
+  `docs/agent-goals/full-l1/` and starts the active `agent/full-l1-*`
+  worktrees.
+- GitHub milestone #7 tracks the full private/local L1 package. Workstream
+  issues are #99 chain, #100 crypto, #101 control plane, #102 dashboard,
+  #103 contracts, #104 bridge, #105 hardware, #106 research, #107 HQ, and
+  #108 full-smoke packaging.
+- `docs/FLOWCHAIN_HQ_INTEGRATION_STATUS.md` is the live HQ matrix for current
+  branch/PR ownership, merge order, and full-smoke blockers.
 - Unmerged worktree changes are not final source of truth. Treat them as
   in-flight context until reviewed and merged.
 - GitHub remains the source of truth for issues, pull requests, reviews, and
@@ -54,6 +64,9 @@ or setup flow.
 | Hardware | Control Plane | Optional operator signal fixture shape and trust labels. |
 | Hardware | Dashboard | Optional hardware node, alert, receipt breadcrumb, verifier digest, and NFC metadata projections. |
 | Contracts | Chain/Indexer | Optional settlement/event spine semantics and FlowPulse compatibility. |
+| Contracts | Bridge | BaseBridgeLockbox events, replay/cap/pause behavior, test-only release boundaries, and Foundry evidence. |
+| Bridge | Chain/Control Plane | BridgeObservation and BridgeCredit handoff files or API calls, replay status, and local-credit smoke output. |
+| Bridge | Dashboard | Deposit observed, credit pending/applied, withdrawal requested, and risk labels. |
 | Research | All | Gates for Process-Witness, SEAL/dependency privacy, private state, public appchain, bridge, and proof systems. |
 | HQ / Review | All | Acceptance matrix, merge order, claim guardrails, issue grouping, and second-computer setup criteria. |
 
@@ -63,10 +76,12 @@ or setup flow.
 2. Land or refresh Local Alpha devnet object lifecycle work.
 3. Land or refresh crypto object identity and vectors for the same object set.
 4. Land control-plane API on top of existing fixture/devnet outputs.
-5. Extend the existing dashboard into a private testnet workbench.
-6. Add optional hardware signal fixtures after object/API labels are stable.
-7. Keep packaging scripts and root command aliases aligned as subsystem commands land.
-8. Run the second-computer smoke path and update acceptance evidence.
+5. Harden bridge/settlement event semantics and local bridge-credit handoffs
+   after object/API labels are stable.
+6. Extend the existing dashboard into a private testnet workbench.
+7. Add optional hardware signal fixtures after object/API labels are stable.
+8. Keep packaging scripts and root command aliases aligned as subsystem commands land.
+9. Run `npm run flowchain:full-smoke` and update acceptance evidence.
 
 ## Duplicate-Work Stops
 
@@ -76,6 +91,8 @@ Stop and ask for HQ review if a PR starts adding:
 - A new dashboard or explorer outside the existing app surface.
 - A new crypto package instead of extending `crypto/`.
 - A new verifier or control-plane pipeline that bypasses current services.
+- A new bridge relayer or bridge object model that bypasses the current
+  `services/bridge-relayer/`, `contracts/bridge/`, or bridge schemas.
 - A second object model that conflicts with `schemas/flowmemory/` or crypto IDs.
 - A setup flow that competes with the second-computer setup guide.
 - Tokenomics, production bridge work, public validator onboarding, or production

diff --git a/docs/FLOWCHAIN_FULL_PRIVATE_TESTNET.md b/docs/FLOWCHAIN_FULL_PRIVATE_TESTNET.md
@@ -38,8 +38,9 @@ Status vocabulary for this milestone:
 | Devnet/runtime | `crates/flowmemory-devnet/`, `docs/LOCAL_DEVNET.md` | Implemented no-value deterministic prototype | Local Alpha work expands native object transitions and lifecycle tests. |
 | Contracts spine | `contracts/`, `tests/`, FlowPulse and registry skeletons | Implemented local/test settlement/event foundation | Contracts work should remain optional settlement/event spine. |
 | Crypto/object identity | `crypto/`, `crypto/fixtures/`, `schemas/flowmemory/` | Implemented V0 hash helpers and vectors | Local Alpha work adds object IDs for agent, model, memory, challenge, and finality objects. |
-| Indexer/verifier/control plane | `services/indexer/`, `services/verifier/`, `services/flowmemory/` | Implemented fixture-first indexer/verifier and generator | Local Alpha work adds `services/control-plane/` as the local API. |
+| Indexer/verifier/control plane | `services/indexer/`, `services/verifier/`, `services/flowmemory/`, `services/control-plane/` | Implemented fixture-first indexer/verifier, generator, and local fixture-backed API | Full-L1 work adds live-node adapters, transaction submission, bridge intake, full lifecycle smoke, and no-secret API checks. |
 | Dashboard/workbench | `apps/dashboard/` and generated dashboard fixtures | Implemented fixture-backed dashboard V0 | Workbench work should extend this app, not create a second dashboard. |
+| Bridge/test credit path | `docs/bridge/`, `contracts/bridge/`, `services/bridge-relayer/`, `fixtures/bridge/`, bridge schemas | Implemented test-only POC foundation | Full-L1 work maps mock/Base Sepolia observations into local BridgeObservation and BridgeCredit handoffs. |
 | Hardware/operator signals | `hardware/`, `fixtures/hardware/`, simulator | Implemented FlowRouter POC and simulator | Local Alpha work maps optional operator signals into private testnet views. |
 | Research gates | `research/`, `docs/DECISIONS/` | Implemented research docs and guardrails | Local Alpha research gates Process-Witness, SEAL, private state, and public L1 work. |
 
@@ -59,12 +60,14 @@ change only if the second-computer setup guide names the chosen commands.
 | Start private testnet | `npm run flowchain:start` | Implemented bounded wrapper that prepares launch-core fixtures and inspects local state. Current devnet is still CLI/demo oriented, not a long-running node. |
 | Run deterministic demo | `npm run flowchain:demo` | Implemented wrapper over the existing devnet `demo`. |
 | Run full smoke test | `npm run flowchain:smoke` | Implemented for merged surfaces: services, crypto tests/vectors, launch candidate, devnet tests, deterministic replay, dashboard build, hardware fixture, unsafe-claim scan, and no-secret export scan. Native object/control-plane coverage remains blocked on subsystem work. |
+| Run full private/local L1 smoke gate | `npm run flowchain:full-smoke` | Implemented as a temporary blocker-report wrapper for #108. It runs the merged-surface smoke unless skipped, writes `devnet/local/smoke/flowchain-full-smoke-report.json`, and exits nonzero until issues #99 through #105 land the missing subsystem command coverage. |
 | Export state | `npm run flowchain:export` | Implemented wrapper over `export-fixtures`; writes ignored export bundles under `devnet/local/export/`. |
 | Import state | `npm run flowchain:import -- --BundlePath <zip> -Force` | Implemented script path for local state restore from an exported bundle. |
 | Start local workbench | `npm run workbench:dev` | Implemented wrapper over the existing dashboard dev server. |
 | Prerequisite check | `npm run flowchain:prereq` | Implemented Windows-first prerequisite and dependency-state check. |
 | Stop private testnet | `npm run flowchain:stop` | Implemented operator-state wrapper; can reset ignored local state with `-ResetLocalState`. |
-| Start control plane | documented local API command | In flight in `services/control-plane/`; active command is `npm run control-plane:serve` in the control-plane worktree. |
+| Start control plane | `npm run control-plane:serve` | Implemented local fixture-backed API command; live-node transaction submission and full lifecycle coverage remain #101. |
+| Run bridge mock | `npm run bridge:mock` | Implemented test-only bridge observation mock; local-credit smoke remains #104. |
 
 ## Target Native Objects
 
@@ -109,17 +112,25 @@ machine can:
 15. Finalize receipts.
 16. Query all state through the documented local control-plane API.
 17. Inspect all state through the existing dashboard/workbench surface.
-18. Export and import snapshots or state bundles.
-19. Run an end-to-end smoke test proving the full flow.
-20. Re-run the same smoke test deterministically.
+18. Observe a mock or Base Sepolia test bridge deposit and apply or hand off a
+    local BridgeCredit without real-funds defaults.
+19. Export and import snapshots or state bundles.
+20. Run an end-to-end smoke test proving the full flow.
+21. Re-run the same smoke test deterministically.
 
 Current HQ/Ops completion for this pass:
 
 - The second-computer command names now exist at the repo root.
 - The commands exercise the current merged launch-core, Rust devnet,
-  dashboard, hardware simulator, export, import, and claim-guardrail surfaces.
+  control plane, bridge mock, dashboard, hardware simulator, export, import,
+  and claim-guardrail surfaces.
+- GitHub milestone #7 and issues #99 through #108 now track the full-L1
+  workstreams and final smoke gate.
+- `npm run flowchain:full-smoke` now exists as the explicit full acceptance
+  wrapper, but it is intentionally incomplete until subsystem commands land.
 - The full private object lifecycle is still owned by the chain, crypto,
-  control-plane, and dashboard workstreams named in
+  control-plane, dashboard, contracts, bridge, hardware, research, and HQ
+  workstreams named in
   `docs/FLOWCHAIN_AGENT_INTEGRATION_MAP.md`.
 
 ## Non-Goals