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_idsrefer to listed sources; - any claim other than
unknowncites at least one source; - an
observedclaim cannot rest only on sources that were not processed; - spans may only cite the claim's own sources;
nonecannot be combined with other test surfaces;supersedes_revisionrequiresproject_idand must be lower thanrevision.