24-EFT.WP.Particle.TopologyAtlas v1.0 | Appendix C — Manifest Templates and Examples (topo manifest)

Home ／ Docs-Technical WhitePaper ／ 24-EFT.WP.Particle.TopologyAtlas v1.0

Appendix C — Manifest Templates and Examples (topo manifest)

One-Sentence Goal
Define the minimal key sets, field specifications, templates, and examples for manifest.topo.* artifacts across the engineering pipeline, so published results are reproducible, auditable, comparable, and replayable.

I. Scope and Objects

1. Manifest types covered
   • manifest.topo.atlas — global atlas publication (Chs. 9–11).
   • manifest.topo.case — use-case-level publication (Ch. 15).
   • manifest.topo.search — retrieval/comparison results (Ch. 13).
   • manifest.topo.runtime — streaming runtime snapshots (Ch. 14).
   • manifest.topo.patch — incremental patch/merge records (Ch. 11).
2. Artifact references: mixed content-addressed hash:// and external uri; for binaries (e.g., D, Atlas) store metadata + data_hash only.

II. Naming, Versioning, Cross-Volume References

• Naming: manifest keys start with manifest.topo.*; schema & version fields are schema, ver.
• Version: schema = "topo-manifest", ver = "1.0.x" (semantic; major bumps may break compatibility).
• Cross-volume: time/sequencing fields tau_mono/ts and contract formats follow the companion Energy Filaments white paper (Ch. 2) and this volume’s Appendix B (C90-*).

III. Minimal Key Set (required for all)

• Identity & lineage: TraceID, producer, ts, code.ver, deps, seed.
• Data provenance: data.uri, data_hash, RefCond.
• Method policy: policy (includes τ_policy, norm, window, thresholds).
• Artifact index: artifacts (hash/uri references to D, Atlas, Γ, Inv, charts, T_ab, etc.).
• Metrics & contracts: metrics, contracts (execution outcomes with evidence).
• Signature: signature = { alg, digest, signer, key_id }.

Any field entering equations must declare unit(field) and dim(field) and pass check_dim( y − f(x) ); integer invariants must record pre/post rounding with u(x).

IV. Field Specs & Units

• Time: ts in ISO 8601; for runtime also provide window = [ t0, t1 ].
• Units/dimensions: declare under units, e.g., { "Q":"[1]", "d_B":"[τ]", "Lk":"[1]" }; dim uses SI symbols.
• Two forms: forms = { formA, formB } with delta_form and percentile fields p95/p99.
• Uncertainty: uncertainty = { u(x), U = k * u_c, nu_eff }; include coverage.

V. Templates (copy-ready)

1) Atlas Publication — manifest.topo.atlas

{

"schema": "topo-manifest",

"ver": "1.0.0",

"kind": "atlas",

"TraceID": "ta-2025-09-02-0001",

"producer": "EFT.TopologyAtlas/atlas-publisher",

"ts": "2025-09-02T10:15:00Z",

"code": { "ver": "1.3.2", "git": "hash://e3b0c442", "runtime": "py310" },

"deps": ["gudhi@3.9", "giotto-tda@0.6", "numba@0.59"],

"seed": 172001,

"data": { "uri": "s3://bucket/dataset-A", "data_hash": "hash://ab12cd..." },

"RefCond": {

"domain": "S2-orientation",

"grid": [1024, 1024],

"spacing": [1.0, 1.0],

"tau_mono": "UTC",

"norm": "L2",

"window": null

},

"policy": {

"τ_policy": "Alpha",

"persistence": { "min_lifespan": 0.02, "scale_τ": 1.0 },

"transition": { "model": "affine", "reg": 1e-3 },

"blend": { "Σψ≡1": true }

},

"artifacts": {

"Atlas": "hash://atlas-7f..",

"charts": ["hash://chart-a..", "hash://chart-b.."],

"T_ab": ["hash://tab-a-b..", "hash://tab-b-c.."],

"ψ_stats": { "sup|Σψ-1|": 7.2e-7 },

"D": "hash://pd-H0H1..",

"Inv": { "Q": 12, "Lk": 0, "Wr": 0.3 }

},

"forms": {

"formA": "clean→build→measure",

"formB": "build→simplify→measure",

"delta_form": { "d_B": 0.008, "p95": 0.011, "tol": 0.02 }

},

"units": { "Q": "[1]", "Lk": "[1]", "d_B": "[τ]" },

"metrics": {

"Δ_cyc": 8.5e-4,

"κ_cover": 0.72,

"cond_max(∂φ)": 12.4,

"coverage": 0.95

},

"contracts": [

{ "id": "C90-091", "status": "pass", "evidence": "hash://psi-check" },

{ "id": "C90-092", "status": "pass", "value": 0.00085, "tol": 0.001 },

{ "id": "C90-004", "status": "pass", "value": 0.011, "tol": 0.02 }

],

"signature": { "alg": "SHA256-RSA", "digest": "hash://sig-..", "signer": "ops@eft", "key_id": "k-2025-07" }

}

2) Use-Case Publication — manifest.topo.case

{

"schema": "topo-manifest",

"ver": "1.0.0",

"kind": "case",

"TraceID": "case-skyrmion-001",

"producer": "EFT.Case.Pipeline",

"ts": "2025-09-02T10:20:00Z",

"code": { "ver": "0.9.5", "git": "hash://acbd18.." },

"seed": 7,

"data": { "uri": "file://skx/scan-42.tiff", "data_hash": "hash://ff00aa.." },

"RefCond": { "domain": "S2-orientation", "grid": [512, 512], "spacing": [2, 2] },

"policy": { "τ_policy": "cubical", "thresholds": { "τ_pers_min": 0.03 } },

"artifacts": {

"q_map": "hash://qmap-..",

"D": "hash://pd-..",

"evidence": ["hash://slice-1..", "hash://pair-14.."],

"Inv": {

"Q": { "raw": 9.82, "rounded": 10, "u": 0.09, "U": 0.18, "coverage": 0.95 }

}

},

"forms": { "formA": "exact", "formB": "approx", "delta_form": { "Q": 0.18, "tol": 0.5 } },

"units": { "Q": "[1]" },

"metrics": { "lifespan_p50": 0.11, "lifespan_p95": 0.27 },

"contracts": [

{ "id": "C90-101", "status": "pass" },

{ "id": "C90-151", "status": "pass", "value": 0.18, "tol": 0.5 }

],

"signature": { "alg": "SHA256-Ed25519", "digest": "hash://sig-..", "signer": "lab@eft" }

}

3) Retrieval Results — manifest.topo.search

{

"schema": "topo-manifest",

"ver": "1.0.0",

"kind": "search",

"TraceID": "srch-2025-09-02-01",

"producer": "EFT.TopologySearch",

"ts": "2025-09-02T10:30:00Z",

"query": { "Z_Q": "hash://embed-q..", "norm": "cosine", "K": 50 },

"candidates": [

{ "id": "atlas#A1", "score": 0.91, "uri": "hash://atlas-A1", "d_exact": 0.12 },

{ "id": "atlas#B9", "score": 0.87, "uri": "hash://atlas-B9", "d_exact": 0.15 }

],

"metrics": { "Recall@10": 0.94, "delta_form_retr_p95": 0.02 },

"contracts": [

{ "id": "C90-131", "status": "pass", "value": 0.94, "tol": 0.9 },

{ "id": "C90-132", "status": "pass" }

],

"signature": { "alg": "SHA256-RSA", "digest": "hash://sig-.." }

}

4) Runtime Snapshot — manifest.topo.runtime

{

"schema": "topo-manifest",

"ver": "1.0.0",

"kind": "runtime",

"TraceID": "rt-2025w36-03",

"producer": "EFT.Stream.Worker",

"ts": "2025-09-02T10:45:00Z",

"window": ["2025-09-02T10:00:00Z", "2025-09-02T10:45:00Z"],

"state": { "ω(t)": "hash://wm-..", "lag_ms_p95": 820 },

"artifacts": { "K_t": "hash://complx-..", "D_t": "hash://pd-..", "Atlas_t": "hash://atlas-t.." },

"forms": { "offline_ref": "hash://pd-off..", "delta_form_rt": { "d_B": 0.026, "tol": 0.03 } },

"metrics": { "β": 0.78, "H_cache": 0.86, "drop_late": 0.0 },

"contracts": [

{ "id": "C90-141", "status": "pass", "value": 820, "tol": 1800 },

{ "id": "C90-142", "status": "pass", "value": 0.026, "tol": 0.03 }

],

"panel": { "uri": "dashboard://topo/runtime/stream-03" },

"signature": { "alg": "SHA256-Ed25519", "digest": "hash://sig-.." }

}

5) Incremental Patch — manifest.topo.patch

{

"schema": "topo-manifest",

"ver": "1.0.0",

"kind": "patch",

"TraceID": "patch-AT-0007",

"producer": "EFT.Atlas.Merger",

"ts": "2025-09-02T11:05:00Z",

"base": "hash://atlas-7f..",

"patch": ["hash://patch-01..", "hash://patch-02.."],

"merge_policy": { "conflict": "keep-both+weight", "Σψ≡1": true },

"post_merge": { "Atlas*": "hash://atlas-8a..", "Δ_cyc": 9.7e-4, "tol": 1e-3 },

"contracts": [{ "id": "C90-111", "status": "pass" }],

"signature": { "alg": "SHA256-RSA", "digest": "hash://sig-.." }

}

VI. Generation & Checks — M90-C1

• Collect metadata: TraceID / producer / ts / code.ver / deps / seed; validate RefCond (C90-002).
• Register artifacts: compute data_hash for D / Atlas / Γ / Inv and record under artifacts.
• Two forms: compute formA/B or stream/offline in parallel; emit delta_form and percentiles.
• Units & dimensions: fill units/dim and run check_dim; for integer invariants, store pre/post rounding, u/U/coverage.
• Contracts: run assert_* and attach outcomes and evidence to contracts.
• Signature: compute digest = SHA256(bytes(clean_manifest_without_signature)); sign with key_id.
• Publish: write to object storage and return uri; dashboards reference panel.uri (runtime).

VII. Compliance Gates (publication)

• Hard gates: missing required keys, failed Σ_a ψ_a ≡ 1, or non_decreasing(τ) → reject.
• Consistency gates: delta_form ≤ tol, Δ_cyc ≤ tol_cyc; failures trigger playbooks SC90-02/03/04.
• Uncertainty gate: coverage ≥ 0.95 or inflate U = k * u_c per policy.
• Rounding gate: integer invariants must satisfy C90-101 before publication.

VIII. Storage, Shards, Compression

• Large binaries: shard as *.npz / *.parquet (default 64 MiB); record parts = [{ uri, size, sha256 }].
• Compression: codec ∈ { zstd, lz4 }; declare under artifacts.meta.codec.
• Content address: all hash:// use sha256:hex; optional merkle_root for subset verification.

IX. Dashboard Mapping & SLOs

1. Map metrics to panels:
   • Δ_cyc, cond_max(∂φ) → Atlas Quality panel;
   • d_B, lifespan_p95 → Topological Stability;
   • β, H_cache, lag_ms_p95 → Runtime Health.
2. Suggested SLOs: Δ_cyc ≤ 1e-3, delta_form_p95 ≤ 0.02 * scale_τ, lag_ms_p95 ≤ 2 * τ_window.

X. Changes & Compatibility

• New minor fields go under optional; removals occur two minor versions later.
• Provide upgrade_manifest(manifest) to migrate legacy docs to 1.0.x.
• External interfaces I90-13B / I90-14B / I90-159 must consume manifests produced by this template.

Summary
This appendix specifies minimal keys, templates, and examples for manifest.topo.atlas / case / search / runtime / patch, plus the full generation → validation → signing → publication workflow. With unified RefCond / units / forms / contracts / signature structures, topological atlas artifacts remain reproducible, auditable, and integrable across teams and environments.