Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tattoo.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Data Hydration Source Packs

TattooAPI hydrates real-world tattoo data through source packs first, then review, then canonical Convex promotion. The current rule is:
  • source data is evidence
  • reviewed candidates are promotion inputs
  • Convex canonical tables are runtime truth
  • raw exports do not rename ontology nouns

​
Current Inputs

SourceCurrent postureWhat it can affect
Google Workspace sheetsRow extraction and directory hydration are staged and verifiedStudio, ArtistProfile, source references, promotion links, law/compliance staging
Sanity managed studiosConnection registry exists, extraction is blocked until real project IDs and token aliases are configuredPortfolioAsset, Design, linked artist/studio evidence
Existing local creative packsCanary promotion is active for a small reviewed cohortPortfolioAsset, Design, creative source lineage
Ontology refinery law canariesHI/NV and CA/TX/NY/FL/WA source packs are staged/review-readyJurisdiction, law, citation, and bloodborne-pathogen requirement review inputs
Law sync diff reportsSame-cohort diffing is active for refresh detectionReview warnings for new, changed, missing, and unchanged citation units
Firecrawl, SERP, PerplexityDelayed for broad importNamed gap-filling only after reviewed cohorts exist

​
Current Counts

The current checked-in hydration reports show:
  • 71,080 Google Workspace rows extracted
  • 63,209 promotable Google directory rows
  • 28,894 expected canonical studio profiles from Google directory sync
  • 3,996 expected canonical artist profiles from Google directory sync
  • 5 promoted creative canary candidates
  • 3 Sanity managed-studio connections scaffolded
  • 0 Sanity tokens stored in reports or git
  • 27 HI/NV law-compliance canary rows in the current refresh candidate
  • 26 CA/TX/NY/FL/WA law-compliance canary rows staged from official sources

​
Promotion Rules

Google directory hydration is non-destructive:
  • non-empty incoming fields can improve canonical records
  • blank incoming values must not erase existing canonical values
  • every promoted record needs an externalSourceReference
  • every promoted record needs a canonicalPromotionLink
Sanity portfolio hydration is managed-studio only:
  • tokens live only in local env aliases such as SANITY_TOKEN_ALOHA_TATTOO
  • registry files store the alias name, not the token value
  • published Sanity records can promote only when studio and artist identities resolve
  • drafts, unresolved artists, and missing rights/consent posture stay staging-only
Law and compliance hydration is source-pack first:
  • external acquisition nodes produce official-source records and run manifests
  • the Ontology Guidance MCP can validate lane, noun, required field, and review-queue posture
  • staging uploads write source-pack files only
  • diff reports show new, changed, missing, and unchanged citation units
  • missing rows are review warnings, not deletion instructions
  • public legal advice and Convex canonical promotion remain disabled until operator approval gates exist

​
Commands

npm run inventory:google-workspace-hydration -- --write
npm run extract:google-workspace-rows -- --write
npm run generate:google-directory-hydration-snapshot
npm run convex:self-host:sync-google-directory
npm run verify:google-directory-hydration

npm run inventory:sanity-managed-connections
npm run extract:sanity-managed-portfolios -- --write
npm run generate:sanity-portfolio-review-pack
npm run convex:self-host:sync-sanity-portfolio-canary
npm run verify:sanity-managed-connections
npm run verify:sanity-portfolio-canary

npm run generate:creative-hydration-review-snapshot
npm run convex:self-host:sync-canonical-creative
npm run verify:convex-canonical-creative
Law/refinery commands are intentionally review and preview oriented: 
npm run inventory:ontology-refinery
npm run generate:ontology-refinery-review-pack
npm run generate:ontology-refinery-law-promotion-preview
npm run verify:ontology-refinery-law-promotion-preview

​
What Not To Do Yet

  • Do not broad-scrape the market into canonical Convex tables.
  • Do not promote Sanity records when artist identity is unresolved.
  • Do not expose Sanity tokens through API responses, docs, reports, or Convex.
  • Do not activate public writes or public SEO pages from staged evidence.
  • Do not treat law sync diffs as automatic legal updates.
  • Do not let external scraping apps write directly to Convex.
The deeper repo source of truth is project-context/ontology/governed-hydration-sprint.md.