Artagon Agentic Temporal Knowledge Vault

An adoption-ready Obsidian repository and deterministic Python metadata compiler for maintaining one evidence-aware knowledge source across agents, humans, semantic graphs, and research packages.

Start here

• Humans: open 00-Home/Start Here.md in Obsidian.
• Agents: read AGENTS.md, then load the smallest task-specific skill.
• Adopters: read ADOPTION.md and plugins/artagon-vault-curator/INSTALL.md.

CLI=./plugins/artagon-vault-curator/scripts/artagon-vault
$CLI --vault . status
$CLI --vault . schema-status
$CLI --vault . events-verify
$CLI --vault . compiler-plan --target all

Authoritative layers

immutable originals
canonical Markdown
versioned schema and mappings
append-only semantic event ledger

Everything else is generated from a normalized intermediate representation:

• temporal and provenance-aware JSON/JSONL;
• RDF, JSON-LD, SKOS, PROV-O, OWL-Time, SHACL, CSV, GraphML, and Neo4j projections;
• trust-aware agent memory;
• Google Open Knowledge Format-compatible bundle;
• schema.org web metadata;
• Data Commons observation adapter files;
• RO-Crate research/release metadata;
• Quartz and GitBook human views;
• exact-file manifests and an honestly scoped semantic digest.

Compiler workflow

# After editing approved canonical knowledge:
$CLI --vault . events-reconcile --actor ART-PERSON-OR-AGENT-ID --apply
$CLI --vault . compiler-build --target all --apply
$CLI --vault . compiler-audit --strict
$CLI --vault . publish --apply --strict

Canonical IDs are immutable merge keys. Titles, filenames, paths, URLs, aliases, slugs, and legacy R-numbers are not identities. Staged material and agent proposals remain untrusted until reviewed.

Skills and maintenance agents

The repo-local plugin contains twenty-one Agent Skills and ten specialized maintenance role cards. The roles cover compiler operation, temporal consistency, provenance, graph projection, human publishing, intake, MCP security, store indexing, release integrity, and adversarial review.

Third-party Obsidian, GitBook, Quartz, and LLM-wiki skills are linked under plugins/artagon-vault-curator/references/THIRD_PARTY_SKILLS.md; they are not trusted or installed automatically.

Integrity boundary

File hashes prove exact-byte integrity. The bundled semantic digest applies only to the compiler’s blank-node-free ground N-Quads and is not presented as full RDFC-1.0. Integrity does not establish epistemic truth.

Obsidian, MCP, and stores

The package includes portable Obsidian settings, a prebuilt and reproducible SQLite FTS5 index, loopback-bound examples for Neo4j, PostgreSQL/pgvector, Qdrant, and Fuseki, and a read-only MCP server with client templates for Claude, Codex, VS Code, and generic stdio clients.

pip install -e './plugins/artagon-vault-curator[mcp,stores,compiler]'
artagon-vault --vault . workspace-sync --profile research
artagon-vault --vault . workspace-sync --profile research --apply
artagon-vault --vault . store-build --target sqlite --apply
artagon-vault --vault . integration-audit --strict
artagon-vault-mcp --vault .

Read INTEGRATIONS.md before enabling external services or copying client-specific configuration.