# v13 Reconciliation Note

This release treats the uploaded `v12(2)` archive as the canonical app source, retains its added TypeScript declaration shims, restores the release-gating config files from the prior hardened v12 package, and bumps the deployable artifact to `13.0.0`.

# Ultimate Merge Report — MultiSig Treasury + Voting Dapp

## Executive summary

This release merges the four uploaded Quantum Field Tezos packages into a single deployable dapp package:

- **v8 wallet package** is the canonical base because it already includes the production chain adapter, unified console, React reference console, SDKs, wiring package, contracts, schemas, docs, tests, and expanded governance surfaces.
- **v6 final package** contributed the legacy governance app/data modules and the `reference/` surface that were not present in v8.
- **v7 unified console** was already substantially folded into v8 and is preserved through the v8 console, `docs/V7_UNIFIED_CONSOLE.md`, and related UI modules.
- **standalone treasury wiring** is normalized into `wiring/` and aligned with the top-level MIT package metadata.

The new top-level entry is:

```txt
/ultimate/
```

It is a unified static dapp shell that exposes the complete treasury and voting suite in one operator-grade surface:

```txt
Ultimate Console
├── Unified console          /console/
├── Treasury execution       /treasury/
├── Governance voting        /governance-pro/
├── Portfolio monitor        /portfolio/
├── React reference console  /react-console/
└── Architecture reference   /reference/
```

## What changed

### 1. One canonical package

The merged release is now named:

```json
{
  "name": "qf-ultimate-multisig-treasury-voting-dapp",
  "version": "9.0.0"
}
```

### 2. New ultimate app shell

Added:

```txt
ultimate/index.html
```

This shell gives operators a single high-polish cockpit across treasury, voting, portfolio, and reference surfaces while preserving each existing implementation surface intact.

### 3. v6-only assets preserved

Added:

```txt
legacy/governance-v6/index.html
legacy/governance-v6/js/governance-app.js
legacy/governance-v6/js/governance-data.js
reference/index.html
reference/integration.md
reference/treasury-console.jsx
```

### 4. Publication metadata hardened

- Updated top-level `package.json` to the merged product name and version.
- Updated `manifest.webmanifest` to describe the merged PWA.
- Updated `_headers` so the ultimate shell can frame same-origin internal surfaces.
- Normalized support email remnants in HTML surfaces to `security@quantumfieldinc.com`.
- Normalized `wiring/package.json` license/private flags to match the top-level public package.

## Operator model

The final dapp separates governance, authorization, and execution cleanly:

1. **Governance intent** originates in Snapshot/Etherlink voting.
2. **Mandate evidence** is visible to treasury signers before approval.
3. **Treasury proposal** is created under policy, role, tier, and timelock rules.
4. **BLS/tz4 signature shares** are collected and aggregated.
5. **Execution** is broadcast only after quorum and policy gates pass.
6. **Receipts** preserve auditability across proposal, signer, vote, and chain records.

## Production gating checklist

Before production broadcast, configure and verify:

- Tezos RPC and TzKT endpoints for the target network.
- Etherlink RPC, Snapshot space, and Snapshot Hub/Sequencer settings.
- Treasury contract address, registry address, and signer set.
- Policy file, tier thresholds, blocked contracts, timelocks, and emergency pause settings.
- Wallet provider settings for Beacon, Octez Connect, Web3Auth, or institutional custody rails.
- Independent review of contracts, key management, browser security posture, and CSP headers.

## Recommended launch path

```bash
npm install
npm run check
npm run test
npm run build
npm run preview
```

Static preview without Node build:

```bash
python3 -m http.server 8080
# open http://localhost:8080/ultimate/
```