Skip to content
Documentation navigation +
implemented

IntakeSpec 1.0.0

Schema: https://www.alivehealthtech.com/schemas/intakespec/1.0.0.json (uv run alive schema intakespec). Every project evaluation starts from a confirmed IntakeSpec.

Field Required Meaning
schema_version yes Always "1.0.0".
intake_id yes Lowercase kebab-case id, 3–63 characters.
project_id, revision, supersedes_revision no Assigned by Alive when stored. Omit in drafts.
project_title, summary yes Plain-language description.
development_stage yes concept, defined_concept, prototype, working_product, deployed, unknown.
input_sources[] yes What was actually received: source_id, kind, reference, access_mode, processing_status, optional sha256, notes.
intervention yes category, objective, target_users, setting, primary_workflow, implemented_capabilities, proposed_capabilities.
claims[] yes (may be empty) claim_id, statement, status (observed, user_declared, inferred, unknown), source_ids, spans.
evaluation_goals[] yes What you want to learn.
available_test_surfaces[] no none, mock, staging_url, openapi, test_sdk, repo_manifest, browser_demo, device_stream, fhir_sandbox.
unknowns[], constraints[] no Open questions and limits.
privacy yes data_policy, research_sharing (default off), production_access_approved (always false), external_model_processing_approved, retention_days.

A span points to where a claim is grounded: {source_id, locator: {page, line_start, line_end, path, selector}, quote}. Quotes are at most 300 characters.

Rules beyond the schema

Alive also enforces rules JSON Schema cannot express. A document that breaks one is rejected with INTAKE_INVALID and the path of each problem:

  • source ids are unique; every claim's source_ids refer to listed sources;
  • any claim other than unknown cites at least one source;
  • an observed claim cannot rest only on sources that were not processed;
  • spans may only cite the claim's own sources;
  • none cannot be combined with other test surfaces;
  • supersedes_revision requires project_id and must be lower than revision.