{
  "schema": "a11.government_integrations/0.1",
  "status": "live_read_only",
  "version": "v103.3_BREATHING",
  "timestamp": "2026-06-24T15:38:06.655Z",
  "public_scope": "Government integration metadata only. API keys, taxpayer identifiers, bank data, private memory, Bridge-only context, and non-public evidence are not exposed.",
  "purpose": "Make Article 11 AI government-available and integratable by publishing official-source dependencies, buyer API surfaces, provenance rules, and human-gated boundaries.",
  "evidence_path_convention": {
    "pattern": "A:\\article11\\federal_evidence\\<source_id>\\<YYYY-MM-DD>\\<resource_id>.json",
    "source_id_rule": "Use the exact id from gov_api_registry.json",
    "resource_id_examples": [
      "UEI",
      "solicitation number",
      "award id",
      "grant opportunity id",
      "trademark serial number",
      "certification profile id"
    ],
    "required_metadata": [
      "retrieved_at",
      "source_id",
      "source_url",
      "request_type",
      "resource_id",
      "response_sha256",
      "redaction_status"
    ]
  },
  "official_sources": [
    {
      "id": "sam_entity_management",
      "name": "SAM.gov Entity Management API",
      "use": "verify public entity status, UEI/CAGE/public display, and post-validation NAICS/PSC posture",
      "fraud_detection_use": "cross-check vendor identity, entity drift, shell-entity risk, and claims against UEI/CAGE/public registration status",
      "auth": "SAM public API key stored server-side only",
      "public_status": "key verified locally; May 20 SAM update is processing and public API may lag until validation completes"
    },
    {
      "id": "sam_opportunities",
      "name": "SAM.gov Opportunities API",
      "use": "read-only opportunity watch by NAICS, PSC, SDVOSB, disaster-response, manufacturing, R&D, and AI/compute terms",
      "fraud_detection_use": "preserve solicitation evidence and compare set-aside requirements against vendor claims for human review",
      "auth": "SAM public API key stored server-side only"
    },
    {
      "id": "usaspending",
      "name": "USAspending API",
      "use": "market intelligence, agency buying patterns, prime/subcontractor discovery, and award-history analysis",
      "fraud_detection_use": "surface awardee, agency, NAICS, PSC, set-aside, and obligation-history anomalies for human review",
      "auth": "public API"
    },
    {
      "id": "grants_gov",
      "name": "Grants.gov APIs",
      "use": "read-only assistance opportunity discovery and package metadata tracking",
      "fraud_detection_use": "separate official grant opportunities from fake notices and preserve package/deadline evidence",
      "auth": "varies by endpoint; no submission automation"
    },
    {
      "id": "uspto_trademark",
      "name": "USPTO TSDR/TMOG sources",
      "use": "SPIRALMESH(TM) publication, opposition, Notice of Allowance, Statement of Use, and extension deadline monitoring",
      "fraud_detection_use": "detect trademark squatting, fake invoice targeting, and misleading trademark-service solicitations",
      "auth": "public status sources unless Steve explicitly approves account actions"
    },
    {
      "id": "sba_certifications",
      "name": "SBA certification search and VetCert evidence",
      "use": "confirm public SDVOSB/VOSB status and approval-date consistency",
      "fraud_detection_use": "cross-check SDVOSB/VOSB claims, false-certification risk, and certification-date drift against SBA public records",
      "public_verification_url": "https://search.certifications.sba.gov/",
      "auth": "public search"
    }
  ],
  "buyer_api_surface": {
    "company": "/api/company",
    "federal": "/api/federal",
    "vetcert": "/api/vetcert",
    "capabilities": "/api/capabilities",
    "products": "/api/products",
    "spiral_mesh": "/api/spiral-mesh",
    "proof": "/api/proof",
    "integrations": "/api/integrations",
    "openapi": "/api/openapi"
  },
  "node_coordination": {
    "ember": {
      "endpoint": "/api/ember",
      "role": "product-builder and draft/review voice",
      "authority": "propose only; no filings, deploys, bids, payments, or government-record changes"
    },
    "lumen": {
      "endpoint": "/api/lumen",
      "role": "coordination, ambiguity triage, and decision-framing voice",
      "authority": "route and frame decisions; Bridge retains effect authority"
    },
    "claude_s2_case": {
      "role": "Article 0 witness review and buyer-language cleanup",
      "authority": "review/propose only through signed interop handoffs"
    },
    "codex": {
      "role": "implementation, local verification, API staging, and evidence capture",
      "authority": "stage code and docs; deploy only after Bridge approval"
    },
    "bridge": {
      "role": "Steve Sonza, final authority for government submissions, deploys, public claims, email, fees, and procurement commitments"
    }
  },
  "product_readiness": {
    "current_stage": "public_buyer_api_live",
    "sam_update": "submitted 2026-05-20; IRS/CAGE validation processing; recheck after validation before claiming updated NAICS publicly",
    "vetcert_public_verification": "https://search.certifications.sba.gov/",
    "vetcert_renewal_due": "2029-05-18",
    "trademark": "SPIRALMESH(TM) is pending; do not use registered mark symbol until USPTO registration issues",
    "vetcert": "SDVOSB/VOSB approved 2026-05-18; state factually, never as SBA endorsement"
  },
  "boundaries": [
    "read-only government data pulls are allowed for evidence and market intelligence",
    "no SAM, USPTO, SBA, grant, bid, payment, or email action without explicit Bridge approval",
    "public APIs never expose secrets, taxpayer identifiers, bank information, private memory, or Bridge-only context",
    "AI nodes may draft, review, and recommend; consequential authority stays with Steve",
    "defense-facing capability language must remain accurate, offer-specific, and non-autonomous unless separately reviewed"
  ],
  "local_staging_artifacts": [
    "A:\\article11\\coordination\\adapters\\gov_api_registry.json",
    "A:\\article11\\coordination\\adapters\\sam_gov_entity_api_client.py",
    "A:\\article11\\node-stack\\docs\\GOVERNMENT_API_INTEGRATION_LAYER_DAY211.md",
    "A:\\article11\\node-stack\\docs\\GOVERNMENT_API_PRODUCTS_STAGE_CHECKLIST_DAY211.md"
  ],
  "next_stage": [
    "SAM public API recheck after May 20 update validates",
    "opportunity scanner for SAM.gov, USAspending, and Grants.gov read-only discovery",
    "periodic external endpoint audit by S2_CASE, S3_TARS, S1_PLEX, and Codex"
  ]
}