Finished project Python CLI · HTML capsule MIT

SHIVA ArticleMap

A self-contained reference implementation for deterministic scientific release bundling. One Python package, one YAML schema, three CLI verbs — ship, verify, capsule — and a self-contained HTML capsule application with the entire source code embedded. Adapter-ready for Sigstore, Rekor, OpenTimestamps, and PAR2 redundancy.

Launch capsule → The three verbs → What ships offline

Package

articlemap_shiva

Schema

articlemap.yaml + JSON Schema

CLI verbs

ship · verify · capsule

Architecture

agents · engines · frameworks · core

Demo release

build/AM-2026-001

SHIVA memory

shiva_registry/

01 — Three verbs

ship.
verify.
capsule.

Each verb is a complete, scripted contract. Same inputs → same outputs, byte for byte.

# ship — turn a workspace into a sealed release
python -m articlemap_shiva ship \
  --article-id AM-2026-001 \
  --src examples/demo_workspace \
  --out build

# verify — recompute every hash, every signature, every Merkle root
python -m articlemap_shiva verify \
  --input build/AM-2026-001

# capsule — emit a self-contained HTML viewer with the full source embedded
python -m articlemap_shiva capsule \
  --project-root . \
  --release build/AM-2026-001 \
  --out build/articlemap_shiva_capsule.html
    

02 — Live, fully implemented, offline

No internet required.

The whole pipeline runs locally. External providers are pluggable via swap-in adapters; everything else is in the package.

Canonicalization

Deterministic ordering so the same workspace produces the same bytes.

Schema validation

Every input checked against the published articlemap.schema.json.

File hashing

SHA-256 per file. Listed in the manifest with its byte-size and path.

Merkle roots

Bottom-up tree across the manifest. Single root in the signed seal.

DSSE signing + verification

Ed25519 envelopes around the manifest. Self-verifiable with the public key.

Local transparency log

Rekor-style checkpoint + verification, without needing a public log server.

Local timestamp receipts

OpenTimestamps-style receipts emitted and verified locally.

Deterministic zip

Same inputs → byte-identical zip. No timestamps in the archive metadata.

HTML capsule generation

Single-file viewer with the entire src/ tree embedded and indexable.

Adapter-ready

Pluggable providers for higher-trust modes.

Native PAR2 generation if par2 is installed locally. External Sigstore / Rekor / OpenTimestamps providers via provider swap, when you do want public anchoring.

03 — Project map

Where things live.

src/articlemap_shiva/agents

Orchestration agents

src/articlemap_shiva/engines

Deterministic engines

src/articlemap_shiva/frameworks

Structural frameworks

src/articlemap_shiva/core

Types and helpers

examples/demo_workspace

Sample input

build/AM-2026-001

Demo shipped release

← All capsules TraceProof →

ship.verify.capsule.