CinvanaAI
← All projects

Library · Data & provenance

Atlas Domain Pack SDK

Define an Atlas domain pack and catch broken definitions and references before a database import.

Repository: CinvanaAI/atlas-domain-pack-sdk

Recorded synthetic example. Source with a complete offline example.

See the idea in action.

The original pack passes; the changed template reports its unknown checkpoint.

Example input
The seven-file Research Notes example and a copy with missing_checkpoint.v 1.
Captured result
{
  "valid_pack": {
    "pack_name": "research_notes",
    "passed": true,
    "files": {
      "pack_manifest.json": {
        "valid": 1,
        "errors": []
      },
      "node_types.json": {
        "valid": 2,
        "errors": []
      },
      "edge_types.json": {
        "valid": 2,
        "errors": []
      },
      "procedures.json": {
        "valid": 1,
        "errors": []
      },
      "checkpoints.json": {
        "valid": 1,
        "errors": []
      },
      "packet_templates.json": {
        "valid": 1,
        "errors": []
      },
      "seed_data.json": {
        "valid": 2,
        "errors": []
      }
    },
    "warnings": [],
    "errors": []
  },
  "rejected_edits": {
    "unknown_checkpoint": {
      "pack_name": "research_notes",
      "passed": false,
      "files": {
        "pack_manifest.json": {
          "valid": 1,
          "errors": []
        },
        "node_types.json": {
          "valid": 2,
          "errors": []
        },
        "edge_types.json": {
          "valid": 2,
          "errors": []
        },
        "procedures.json": {
          "valid": 1,
          "errors": []
        },
        "checkpoints.json": {
          "valid": 1,
          "errors": []
        },
        "packet_templates.json": {
          "valid": 1,
          "errors": [
            "research_claim: references unknown checkpoint 'missing_checkpoint.v1'."
          ]
        },
        "seed_data.json": {
          "valid": 2,
          "errors": []
        }
      },
      "warnings": [],
      "errors": [
        "packet_templates.json: research_claim: references unknown checkpoint 'missing_checkpoint.v1'."
      ]
    },
    "missing_checkpoint_file": {
      "pack_name": "research_notes",
      "passed": false,
      "files": {
        "pack_manifest.json": {
          "valid": 1,
          "errors": []
        },
        "node_types.json": {
          "valid": 2,
          "errors": []
        },
        "edge_types.json": {
          "valid": 2,
          "errors": []
        },
        "procedures.json": {
          "valid": 1,
          "errors": []
        },
        "packet_templates.json": {
          "valid": 1,
          "errors": [
            "research_claim: references unknown checkpoint 'verify_evidence_link.v1'."
          ]
        },
        "seed_data.json": {
          "valid": 2,
          "errors": []
        }
      },
      "warnings": [],
      "errors": [
        "packet_templates.json: research_claim: references unknown checkpoint 'verify_evidence_link.v1'."
      ]
    },
    "non_object_definition": {
      "pack_name": "research_notes",
      "passed": false,
      "files": {
        "pack_manifest.json": {
          "valid": 1,
          "errors": []
        },
        "node_types.json": {
          "valid": 0,
          "errors": [
            "definitions must be an array of objects"
          ]
        },
        "edge_types.json": {
          "valid": 2,
          "errors": []
        },
        "procedures.json": {
          "valid": 1,
          "errors": []
        },
        "checkpoints.json": {
          "valid": 1,
          "errors": []
        },
        "packet_templates.json": {
          "valid": 1,
          "errors": []
        },
        "seed_data.json": {
          "valid": 2,
          "errors": []
        }
      },
      "warnings": [
        "seed_data.json: node 'Research Atlas' has type 'research_domain' not defined in node_types.json",
        "seed_data.json: node 'Research Notes' has type 'research_domain' not defined in node_types.json"
      ],
      "errors": [
        "node_types.json: definitions must be an array of objects"
      ]
    }
  }
}

Try the example.

From the repository root, follow the dependency requirements in the README. This example uses supplied synthetic material.

python -m pip install -e .
python -m examples.walkthrough

The original pack passes; the changed template reports its unknown checkpoint.

Complete setup and instructions ↗

The interesting part.

Fast structural and cross-file validation without kernel state or a database.

Focused extraction

Where it came from.

Domain-pack authoring and validation boundary from Atlas Kernel.

Packages the contract and validator for authors and CI without a database runtime.

Atlas Kernel retains its own validator; the smaller package is not a required replacement dependency.

Source ↗

Follow the family: Atlas kernel and domain-pack authoring

  • Extracted fromAtlas Kernel

    See the integrated setting from which this independently useful mechanism was separated. The full kernel retains the validator and stays self-contained.

    Source ↗