Canonical Facts & Calc Usage Guide

{
  "id": "canonical-facts",
  "numericId": "E827",
  "path": "/internal/canonical-facts/",
  "filePath": "internal/canonical-facts.mdx",
  "title": "Canonical Facts & Calc Usage Guide",
  "quality": 50,
  "readerImportance": 12,
  "researchImportance": 15,
  "tacticalValue": null,
  "contentFormat": "article",
  "tractability": null,
  "neglectedness": null,
  "uncertainty": null,
  "causalLevel": null,
  "lastUpdated": "2026-03-13",
  "dateCreated": "2026-02-20",
  "llmSummary": null,
  "description": "Strategy and conventions for using the F (fact) and Calc (computed value) components across wiki pages — when to make a number a fact, how to use showDate for temporal claims, and scaling guidelines.",
  "ratings": {
    "novelty": 3,
    "rigor": 6,
    "actionability": 8,
    "completeness": 7
  },
  "category": "internal",
  "subcategory": "style-guides",
  "clusters": [
    "ai-safety"
  ],
  "metrics": {
    "wordCount": 1046,
    "tableCount": 4,
    "diagramCount": 0,
    "internalLinks": 1,
    "externalLinks": 0,
    "footnoteCount": 0,
    "bulletRatio": 0.23,
    "sectionCount": 24,
    "hasOverview": false,
    "structuralScore": 9
  },
  "suggestedQuality": 60,
  "updateFrequency": 90,
  "evergreen": true,
  "wordCount": 1046,
  "unconvertedLinks": [],
  "unconvertedLinkCount": 0,
  "convertedLinkCount": 0,
  "backlinkCount": 2,
  "hallucinationRisk": {
    "level": "medium",
    "score": 60,
    "factors": [
      "no-citations",
      "few-external-sources"
    ]
  },
  "entityType": "internal",
  "redundancy": {
    "maxSimilarity": 18,
    "similarPages": [
      {
        "id": "data-system-authority",
        "title": "Data System Authority Rules",
        "path": "/internal/data-system-authority/",
        "similarity": 18
      },
      {
        "id": "structured-data-architecture",
        "title": "Knowledge Base Architecture",
        "path": "/internal/structured-data-architecture/",
        "similarity": 15
      },
      {
        "id": "fact-system-strategy",
        "title": "Fact System Strategy",
        "path": "/internal/fact-system-strategy/",
        "similarity": 14
      },
      {
        "id": "knowledge-graph-ontology",
        "title": "Knowledge Graph Ontology: Design & Implementation Status",
        "path": "/internal/knowledge-graph-ontology/",
        "similarity": 14
      },
      {
        "id": "citation-architecture",
        "title": "Citation Architecture: Current State & Unified Proposal",
        "path": "/internal/citation-architecture/",
        "similarity": 12
      }
    ]
  },
  "changeHistory": [
    {
      "date": "2026-02-18",
      "branch": "claude/fact-hash-ids-UETLf",
      "title": "Migrate fact IDs from human-readable to hash-based",
      "summary": "Migrated all canonical fact IDs from human-readable slugs (e.g., `revenue-arr-2025`) to 8-char random hex hashes (e.g., `55d88868`), matching the pattern used by resources. Updated all YAML files, MDX references, build scripts, tests, LLM prompts, and documentation.",
      "model": "opus-4-6",
      "duration": "~45min"
    },
    {
      "date": "2026-02-17",
      "branch": "claude/clarify-calc-usage-SMCaw",
      "title": "Canonical facts & Calc usage guide",
      "summary": "Created an internal style guide page documenting the strategy for using `<F>` and `<Calc>` components — when numbers should be facts (3-tier decision framework), `<F>` vs `<Calc>` roles, YAML structure, and scaling plan. Added `showDate` prop to the `<F>` component for rendering temporal claims inline (e.g., \"300,000+ (as of 2025)\"). Added nav entry and CLAUDE.md reference."
    }
  ],
  "coverage": {
    "passing": 3,
    "total": 13,
    "targets": {
      "tables": 4,
      "diagrams": 0,
      "internalLinks": 8,
      "externalLinks": 5,
      "footnotes": 3,
      "references": 3
    },
    "actuals": {
      "tables": 4,
      "diagrams": 0,
      "internalLinks": 1,
      "externalLinks": 0,
      "footnotes": 0,
      "references": 0,
      "quotesWithQuotes": 0,
      "quotesTotal": 0,
      "accuracyChecked": 0,
      "accuracyTotal": 0
    },
    "items": {
      "llmSummary": "red",
      "schedule": "green",
      "entity": "red",
      "editHistory": "green",
      "overview": "red",
      "tables": "green",
      "diagrams": "red",
      "internalLinks": "amber",
      "externalLinks": "red",
      "footnotes": "red",
      "references": "red",
      "quotes": "red",
      "accuracy": "red"
    },
    "editHistoryCount": 2,
    "ratingsString": "N:3 R:6 A:8 C:7"
  },
  "readerRank": 573,
  "researchRank": 522,
  "recommendedScore": 127.38
}

No external links