@nebulacomponents/citable 0.1.0

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@nebulacomponents/citable",
+  "version": "0.1.0",
+  "description": "Production-grade SEO, AEO, and GEO agent skill with auditable detection, claim governance, evidence validation, and multi-agent installation.",
+  "keywords": [
+    "seo",
+    "aeo",
+    "geo",
+    "search-engine-optimization",
+    "answer-engine-optimization",
+    "generative-engine-optimization",
+    "ai-search",
+    "search-visibility",
+    "citation-readiness",
+    "citation-optimization",
+    "content-audit",
+    "technical-seo",
+    "structured-data",
+    "schema-org",
+    "entity-resolution",
+    "entity-seo",
+    "claim-governance",
+    "evidence-validation",
+    "content-governance",
+    "information-retrieval",
+    "search-audit",
+    "website-audit",
+    "seo-audit",
+    "ai-visibility",
+    "generative-search",
+    "answer-engines",
+    "coding-agent",
+    "agent-skill",
+    "ai-agent",
+    "claude-code",
+    "codex",
+    "cursor",
+    "gemini-cli",
+    "github-copilot",
+    "developer-tools",
+    "cli",
+    "lint",
+    "detectors",
+    "auditability",
+    "provenance"
+  ],
+  "author": "Mike Holownych - Nebula Components",
+  "type": "module",
+  "scripts": {
+    "test": "node --test --test-concurrency=1 'tests/**/*.test.js'",
+    "build:dist": "node scripts/build-dist.js",
+    "prepack": "npm run build:dist"
+  },
+  "bin": {
+    "citable": "cli/bin/citable.js"
+  },
+  "files": [
+    "cli/",
+    "dist/",
+    "src/",
+    "schemas/",
+    "skill/",
+    "scripts/build-dist.js",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.22.2"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikeholownych/citable.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mikeholownych/citable/issues"
+  },
+  "homepage": "https://github.com/mikeholownych/citable#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "js-yaml": "^5.2.1",
+    "node-html-parser": "^9.0.0"
+  }
+}

package/schemas/claim.schema.json

@@ -0,0 +1,53 @@
+{
+  "$id": "citable://schemas/claim.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Claim registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "claims" },
+    "entries": { "items": { "$ref": "#/definitions/claim" } }
+  },
+  "definitions": {
+    "claim": {
+      "type": "object",
+      "required": ["claim_id", "claim", "claim_type", "status"],
+      "properties": {
+        "claim_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "claim": { "type": "string", "minLength": 3 },
+        "claim_type": { "type": "string", "enum": ["factual", "capability", "performance", "comparative", "definitional", "commercial", "legal_regulatory", "security", "opinion", "position", "aspirational"] },
+        "entity": { "type": "string" },
+        "scope": { "type": "array", "items": { "type": "string" } },
+        "exclusions": { "type": "array", "items": { "type": "string" } },
+        "assumptions": { "type": "array", "items": { "type": "string" } },
+        "evidence": { "type": "array", "items": { "type": "string" } },
+        "external_corroboration": { "type": "array", "items": { "type": "string" } },
+        "contradictory_sources": { "type": "array", "items": { "type": "string" } },
+        "legal_status": { "type": "string", "enum": ["approved", "restricted", "prohibited", "review_required", "not_assessed"] },
+        "publication_surfaces": { "type": "array", "items": { "type": "string" } },
+        "query_coverage": { "type": "array", "items": { "type": "string" } },
+        "prompt_coverage": { "type": "array", "items": { "type": "string" } },
+        "owner": { "type": "string" },
+        "status": { "type": "string", "enum": ["candidate", "unverified", "verified", "verified_narrowed", "insufficient_evidence", "contradicted", "expired", "prohibited", "review_required", "retired"] },
+        "valid_from": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "expires": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "last_verified": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "source_location": { "type": "string" },
+        "support_assessment": {
+          "type": "object",
+          "required": ["status"],
+          "properties": {
+            "status": { "type": "string", "enum": ["directly_supported", "partially_supported", "inferred", "contradicted", "not_assessed"] },
+            "assessor": { "type": "string" },
+            "assessment_method": { "type": "string" },
+            "assessment_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+            "supporting_passages": { "type": "array", "items": { "type": "string" } },
+            "unsupported_components": { "type": "array", "items": { "type": "string" } },
+            "confidence": { "type": "string", "enum": ["confirmed", "high", "medium", "low", "unknown"] },
+            "human_review_required": { "type": "boolean" }
+          }
+        },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/common.defs.json

@@ -0,0 +1,33 @@
+{
+  "$id": "citable://schemas/common.defs.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$" },
+    "isoDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ].*)?$" },
+    "url": { "type": "string", "minLength": 1 },
+    "owner": { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "candidate", "active", "verified", "unverified", "incomplete", "blocked", "expired", "prohibited", "review_required", "deprecated", "retired"]
+    },
+    "provenance": {
+      "type": "object",
+      "properties": {
+        "created": { "$ref": "#/definitions/isoDate" },
+        "updated": { "$ref": "#/definitions/isoDate" },
+        "created_by": { "type": "string" },
+        "source": { "type": "string" }
+      }
+    },
+    "registryFile": {
+      "type": "object",
+      "required": ["version", "kind", "entries"],
+      "properties": {
+        "version": { "type": "integer", "minimum": 1 },
+        "kind": { "type": "string" },
+        "updated": { "$ref": "#/definitions/isoDate" },
+        "entries": { "type": "array" }
+      }
+    }
+  }
+}

package/schemas/competitor.schema.json

@@ -0,0 +1,28 @@
+{
+  "$id": "citable://schemas/competitor.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Competitor registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "competitors" },
+    "entries": { "items": { "$ref": "#/definitions/competitor" } }
+  },
+  "definitions": {
+    "competitor": {
+      "type": "object",
+      "required": ["competitor_id", "name", "status"],
+      "properties": {
+        "competitor_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "name": { "type": "string" },
+        "domains": { "type": "array", "items": { "type": "string" } },
+        "category": { "type": "string" },
+        "queries_contested": { "type": "array", "items": { "type": "string" } },
+        "prompts_contested": { "type": "array", "items": { "type": "string" } },
+        "observed_citations": { "type": "array", "items": { "type": "string" } },
+        "notes": { "type": "string" },
+        "status": { "$ref": "citable://schemas/common.defs.json#/definitions/status" },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/config.schema.json

@@ -0,0 +1,41 @@
+{
+  "$id": "citable://schemas/config.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Citable project config",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "version": { "type": "integer", "minimum": 1 },
+    "site": {
+      "type": "object",
+      "properties": {
+        "base_url": { "type": ["string", "null"] },
+        "built_output_dir": { "type": ["string", "null"] },
+        "source_dirs": { "type": "array", "items": { "type": "string" } },
+        "default_locale": { "type": ["string", "null"] },
+        "default_jurisdiction": { "type": ["string", "null"] }
+      }
+    },
+    "framework": {
+      "type": "object",
+      "properties": {
+        "name": { "type": ["string", "null"] },
+        "rendering_model": { "type": ["string", "null"], "enum": ["static", "ssr", "csr", "hybrid", "unknown", null] },
+        "package_manager": { "type": ["string", "null"] },
+        "build_command": { "type": ["string", "null"] },
+        "test_command": { "type": ["string", "null"] }
+      }
+    },
+    "audit": {
+      "type": "object",
+      "properties": {
+        "index_target_default": { "type": "boolean" },
+        "max_crawl_depth": { "type": "integer", "minimum": 1 },
+        "thin_content_words": { "type": "integer", "minimum": 1 },
+        "fetch_external": { "type": "boolean" },
+        "detector_overrides": { "type": "object" }
+      }
+    },
+    "thresholds": { "type": "object" }
+  }
+}

package/schemas/crawler.schema.json

@@ -0,0 +1,33 @@
+{
+  "$id": "citable://schemas/crawler.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Crawler policy registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "crawlers" },
+    "entries": { "items": { "$ref": "#/definitions/crawler" } }
+  },
+  "definitions": {
+    "crawler": {
+      "type": "object",
+      "required": ["crawler_id", "user_agent", "purpose", "decision", "status"],
+      "properties": {
+        "crawler_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "user_agent": { "type": "string", "minLength": 1 },
+        "vendor": { "type": "string" },
+        "purpose": { "type": "string", "enum": ["search_indexing", "ai_search_discovery", "user_initiated_retrieval", "model_training", "licensed_access", "partner_access"] },
+        "decision": { "type": "string", "enum": ["allow", "block", "undecided"] },
+        "decision_owner": { "type": "string" },
+        "business_rationale": { "type": "string" },
+        "legal_rationale": { "type": "string" },
+        "robots_rule": { "type": "string" },
+        "ip_validation_method": { "type": "string" },
+        "documentation_source": { "type": "string" },
+        "review_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "next_review_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "status": { "$ref": "citable://schemas/common.defs.json#/definitions/status" },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/detector-quality.schema.json

@@ -0,0 +1,39 @@
+{
+  "$id": "citable://schemas/detector-quality.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Detector quality report",
+  "type": "object",
+  "required": ["generated_at", "corpus", "detectors"],
+  "properties": {
+    "generated_at": { "type": "string" },
+    "corpus": {
+      "type": "object",
+      "properties": {
+        "positive_fixtures": { "type": "array", "items": { "type": "string" } },
+        "negative_fixtures": { "type": "array", "items": { "type": "string" } },
+        "production_sites_evaluated": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "detectors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["detector_id", "fixtures_positive", "fixtures_negative", "production_pages_evaluated", "precision", "recall"],
+        "properties": {
+          "detector_id": { "type": "string" },
+          "deterministic": { "type": "boolean" },
+          "fixtures_positive": { "type": "integer", "description": "findings produced on the seeded-defect corpus" },
+          "fixtures_negative": { "type": "integer", "description": "findings produced on the clean corpus (should be 0)" },
+          "exercised_by_fixtures": { "type": "boolean" },
+          "production_pages_evaluated": { "type": "integer" },
+          "true_positives": { "type": ["integer", "null"] },
+          "false_positives": { "type": ["integer", "null"] },
+          "false_negatives": { "type": ["integer", "null"] },
+          "precision": { "type": ["number", "null"], "description": "null = not measured; fixture counts alone do not establish precision" },
+          "recall": { "type": ["number", "null"] },
+          "known_blind_spots": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    }
+  }
+}

package/schemas/entity.schema.json

@@ -0,0 +1,39 @@
+{
+  "$id": "citable://schemas/entity.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Entity registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "entities" },
+    "entries": { "items": { "$ref": "#/definitions/entity" } }
+  },
+  "definitions": {
+    "entity": {
+      "type": "object",
+      "required": ["entity_id", "canonical_name", "entity_type", "status"],
+      "properties": {
+        "entity_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "canonical_name": { "type": "string", "minLength": 1 },
+        "entity_type": { "type": "string", "enum": ["organization", "legal_entity", "person", "author", "product_family", "product", "service", "category", "proprietary_concept", "methodology", "research_artifact", "dataset", "location", "partnership", "case_study"] },
+        "legal_name": { "type": "string" },
+        "operating_name": { "type": "string" },
+        "aliases": { "type": "array", "items": { "type": "string" } },
+        "owner_entity": { "type": "string" },
+        "canonical_url": { "type": "string" },
+        "external_identifiers": { "type": "array", "items": { "type": ["string", "object"] } },
+        "authoritative_profiles": { "type": "array", "items": { "type": "string" } },
+        "category": { "type": "string" },
+        "secondary_categories": { "type": "array", "items": { "type": "string" } },
+        "definition": { "type": "string" },
+        "exclusions": { "type": "array", "items": { "type": "string" } },
+        "relationships": { "type": "array", "items": { "type": "object", "required": ["type", "entity"], "properties": { "type": { "type": "string" }, "entity": { "type": "string" } } } },
+        "evidence": { "type": "array", "items": { "type": "string" } },
+        "schema_types": { "type": "array", "items": { "type": "string" } },
+        "status": { "$ref": "citable://schemas/common.defs.json#/definitions/status" },
+        "last_verified": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "owner": { "type": "string" },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/evidence.schema.json

@@ -0,0 +1,41 @@
+{
+  "$id": "citable://schemas/evidence.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Evidence registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "evidence" },
+    "entries": { "items": { "$ref": "#/definitions/evidence" } }
+  },
+  "definitions": {
+    "evidence": {
+      "type": "object",
+      "required": ["evidence_id", "title", "evidence_type", "verification_status"],
+      "properties": {
+        "evidence_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "title": { "type": "string", "minLength": 1 },
+        "evidence_type": { "type": "string", "enum": ["primary_documentation", "architecture_specification", "test_result", "benchmark", "dataset", "incident_analysis", "case_study", "customer_reference", "regulatory_text", "academic_paper", "third_party_article", "certification", "corporate_registration", "public_profile", "interview", "transcript"] },
+        "source": { "type": "string" },
+        "source_type": { "type": "string" },
+        "source_owner": { "type": "string" },
+        "primary_or_secondary": { "type": "string", "enum": ["primary", "secondary"] },
+        "supports_claims": { "type": "array", "items": { "type": "string" } },
+        "methodology": { "type": "string" },
+        "test_conditions": { "type": "string" },
+        "measurement_period": { "type": "string" },
+        "jurisdiction": { "type": "string" },
+        "publication_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "retrieved_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "valid_until": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "integrity_hash": { "type": "string" },
+        "access_status": { "type": "string", "enum": ["publicly_accessible", "gated", "internal", "inaccessible", "unknown"] },
+        "reuse_status": { "type": "string", "enum": ["open_license", "licensed", "no_express_reuse_license", "prohibited", "unknown"] },
+        "limitations": { "type": "array", "items": { "type": "string" } },
+        "reviewer": { "type": "string" },
+        "verification_status": { "type": "string", "enum": ["verified", "reviewed", "unverified", "stale", "revoked", "inaccessible"] },
+        "attribution": { "type": "string" },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/experiment.schema.json

@@ -0,0 +1,37 @@
+{
+  "$id": "citable://schemas/experiment.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Experiment registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "experiments" },
+    "entries": { "items": { "$ref": "#/definitions/experiment" } }
+  },
+  "definitions": {
+    "experiment": {
+      "type": "object",
+      "required": ["experiment_id", "hypothesis", "primary_metric", "status"],
+      "properties": {
+        "experiment_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "hypothesis": { "type": "string", "minLength": 10 },
+        "discipline": { "type": "array", "items": { "type": "string", "enum": ["seo", "aeo", "geo"] } },
+        "primary_metric": { "type": "string" },
+        "secondary_metrics": { "type": "array", "items": { "type": "string" } },
+        "prompt_cohort": { "type": "array", "items": { "type": "string" } },
+        "query_cohort": { "type": "array", "items": { "type": "string" } },
+        "engines": { "type": "array", "items": { "type": "string" } },
+        "control_group": { "type": "string" },
+        "baseline_window": { "type": "string" },
+        "evaluation_window": { "type": "string" },
+        "minimum_observation_window": { "type": "string" },
+        "known_confounders": { "type": "array", "items": { "type": "string" } },
+        "decision_rule": { "type": "string" },
+        "owner": { "type": "string" },
+        "result": { "type": "string" },
+        "result_confidence": { "type": "string", "enum": ["confirmed", "high", "medium", "low", "unknown"] },
+        "status": { "type": "string", "enum": ["draft", "active", "observing", "concluded", "abandoned"] },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/finding.schema.json

@@ -0,0 +1,101 @@
+{
+  "$id": "citable://schemas/finding.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Finding",
+  "type": "object",
+  "required": ["finding_id", "detector_id", "run_id", "timestamp", "discipline", "subject", "observation", "classification", "remediation", "verification", "status"],
+  "properties": {
+    "finding_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+    "detector_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+    "run_id": { "type": "string" },
+    "timestamp": { "type": "string" },
+    "discipline": { "type": "array", "minItems": 1, "items": { "type": "string", "enum": ["seo", "aeo", "geo"] } },
+    "subject": {
+      "type": "object",
+      "required": ["type", "identifier"],
+      "properties": {
+        "type": { "type": "string", "enum": ["url", "page", "source_file", "registry_entry", "site", "schema_block", "link", "crawler", "claim", "evidence", "entity", "prompt", "query", "experiment", "run"] },
+        "identifier": { "type": "string" },
+        "url": { "type": "string" },
+        "source_file": { "type": "string" },
+        "source_location": { "type": "string" },
+        "rendered_selector": { "type": "string" }
+      }
+    },
+    "observation": {
+      "type": "object",
+      "required": ["summary", "evidence"],
+      "properties": {
+        "summary": { "type": "string", "minLength": 1 },
+        "evidence": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "captured_value": {},
+        "expected_value": {}
+      }
+    },
+    "classification": {
+      "type": "object",
+      "required": ["finding_type", "severity", "confidence", "deterministic", "impact"],
+      "properties": {
+        "finding_type": { "type": "string", "enum": ["deterministic_observation", "evidence_backed_semantic_finding", "probabilistic_inference", "strategic_hypothesis", "experiment_result", "untestable_condition"] },
+        "severity": { "type": "string", "enum": ["critical", "high", "medium", "low", "informational", "experimental"] },
+        "confidence": { "type": "string", "enum": ["confirmed", "high", "medium", "low", "unknown"] },
+        "deterministic": { "type": "boolean" },
+        "impact": {
+          "type": "object",
+          "properties": {
+            "retrieval": { "$ref": "#/definitions/impactLevel" },
+            "ranking": { "$ref": "#/definitions/impactLevel" },
+            "citation": { "$ref": "#/definitions/impactLevel" },
+            "representation": { "$ref": "#/definitions/impactLevel" },
+            "legal": { "$ref": "#/definitions/impactLevel" },
+            "reputational": { "$ref": "#/definitions/impactLevel" },
+            "conversion": { "$ref": "#/definitions/impactLevel" },
+            "maintainability": { "$ref": "#/definitions/impactLevel" }
+          }
+        }
+      }
+    },
+    "reasoning": {
+      "type": "object",
+      "properties": {
+        "applicable_requirement": { "type": "string" },
+        "explanation": { "type": "string" },
+        "assumptions": { "type": "array", "items": { "type": "string" } },
+        "limitations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "remediation": {
+      "type": "object",
+      "required": ["preferred"],
+      "properties": {
+        "preferred": { "type": "string" },
+        "alternatives": { "type": "array", "items": { "type": "string" } },
+        "unsafe_shortcuts": { "type": "array", "items": { "type": "string" } },
+        "owner": { "type": ["string", "null"] },
+        "review_required": { "type": "boolean" }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "required": ["method"],
+      "properties": {
+        "method": { "type": "string" },
+        "expected_result": { "type": "string" },
+        "detector_to_rerun": { "type": "string" }
+      }
+    },
+    "status": {
+      "type": "object",
+      "required": ["state"],
+      "properties": {
+        "state": { "type": "string", "enum": ["open", "acknowledged", "in_remediation", "resolved", "accepted_risk", "false_positive"] },
+        "first_seen": { "type": "string" },
+        "last_seen": { "type": "string" },
+        "resolved_at": { "type": ["string", "null"] }
+      }
+    }
+  },
+  "definitions": {
+    "impactLevel": { "type": "string", "enum": ["none", "low", "medium", "high", "unknown"] }
+  }
+}

package/schemas/page.schema.json

@@ -0,0 +1,40 @@
+{
+  "$id": "citable://schemas/page.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Page registry",
+  "allOf": [{ "$ref": "citable://schemas/common.defs.json#/definitions/registryFile" }],
+  "properties": {
+    "kind": { "const": "pages" },
+    "entries": { "items": { "$ref": "#/definitions/page" } }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "required": ["page_id", "url", "page_type", "status"],
+      "properties": {
+        "page_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "url": { "type": "string", "minLength": 1 },
+        "canonical_url": { "type": "string" },
+        "source_files": { "type": "array", "items": { "type": "string" } },
+        "page_type": { "type": "string", "enum": ["home", "hub", "definition", "problem", "solution", "product", "service", "comparison", "recommendation", "implementation", "evidence", "case_study", "pricing", "faq", "glossary", "documentation", "policy", "about", "contact", "author", "category", "legal", "landing", "article", "other"] },
+        "primary_intent": { "type": "string" },
+        "secondary_intents": { "type": "array", "items": { "type": "string" } },
+        "target_queries": { "type": "array", "items": { "type": "string" } },
+        "target_prompts": { "type": "array", "items": { "type": "string" } },
+        "primary_entities": { "type": "array", "items": { "type": "string" } },
+        "published_claims": { "type": "array", "items": { "type": "string" } },
+        "evidence_references": { "type": "array", "items": { "type": "string" } },
+        "content_owner": { "type": "string" },
+        "factual_reviewer": { "type": "string" },
+        "lifecycle_class": { "type": "string", "enum": ["foundational", "product_capability", "regulatory", "pricing", "market_statistics", "technical_implementation", "competitive_comparison", "security_claim", "evergreen", "news", "unclassified"] },
+        "review_cadence": { "type": "string" },
+        "next_review_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },
+        "indexing_intent": { "type": "string", "enum": ["index", "noindex", "undecided"] },
+        "conversion_action": { "type": "string" },
+        "jurisdiction": { "type": "string" },
+        "status": { "$ref": "citable://schemas/common.defs.json#/definitions/status" },
+        "provenance": { "$ref": "citable://schemas/common.defs.json#/definitions/provenance" }
+      }
+    }
+  }
+}

package/schemas/project.schema.json

@@ -0,0 +1,29 @@
+{
+  "$id": "citable://schemas/project.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Project profile",
+  "type": "object",
+  "required": ["version", "initialized_at"],
+  "properties": {
+    "version": { "type": "integer" },
+    "initialized_at": { "type": "string" },
+    "repository_root": { "type": "string" },
+    "detected": {
+      "type": "object",
+      "properties": {
+        "framework": { "type": ["string", "null"] },
+        "rendering_model": { "type": ["string", "null"] },
+        "package_manager": { "type": ["string", "null"] },
+        "build_commands": { "type": "array", "items": { "type": "string" } },
+        "test_commands": { "type": "array", "items": { "type": "string" } },
+        "robots_files": { "type": "array", "items": { "type": "string" } },
+        "sitemap_sources": { "type": "array", "items": { "type": "string" } },
+        "schema_sources": { "type": "array", "items": { "type": "string" } },
+        "metadata_systems": { "type": "array", "items": { "type": "string" } },
+        "analytics": { "type": "array", "items": { "type": "string" } },
+        "content_collections": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "unresolved_assumptions": { "type": "array", "items": { "type": "string" } }
+  }
+}