Specs, Research, and Source Families

This page closes the public coverage gap between the HELM docs site and the large internal source families in the HELM repo. It does not publish every internal note as a standalone public page; it documents the owner route for each active family and points to the public surface that carries the source truth.

Audience

Use this page if you are auditing source coverage, building against advanced HELM internals, reviewing specs/research material, or trying to find the public route for a repo family that is not a top-level navigation item.

Outcome

You should know how apps, core, modules, packs, protocols, schemas, infra, scripts, services, docs/specs, docs/research, and UI/design system material map into public docs, LLM exports, MCP, and validation gates.

Coverage Topology

flowchart TD
    subgraph Ingestion["1. Ingestion & Context Plane"]
        families["Source-family rules"]
        direct["Direct public pages"]
        hubs["Public hub pages"]
        internal["Internal/source-only classifications"]
        exports["Markdown / LLM / MCP"]
    end

    subgraph Ledger["4. Tamper-Evident Ledger Plane"]
        ledger["documentation-coverage.csv"]
        audit["Audit ledger with rationale"]
    end

    %% Operational Flow Edges
    ledger --> families
    families --> direct
    families --> hubs
    families --> internal
    direct --> exports
    hubs --> exports
    internal --> audit

    %% Premium Styling Rules
    style ledger fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
    style audit fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff

flowchart TD
    subgraph Ingestion["1. Ingestion & Context Plane"]
        families["Source-family rules"]
        direct["Direct public pages"]
        hubs["Public hub pages"]
        internal["Internal/source-only classifications"]
        exports["Markdown / LLM / MCP"]
    end

    subgraph Ledger["4. Tamper-Evident Ledger Plane"]
        ledger["documentation-coverage.csv"]
        audit["Audit ledger with rationale"]
    end

    %% Operational Flow Edges
    ledger --> families
    families --> direct
    families --> hubs
    families --> internal
    direct --> exports
    hubs --> exports
    internal --> audit

    %% Premium Styling Rules
    style ledger fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff
    style audit fill:#2f855a,stroke:#276749,stroke-width:2px,color:#fff

HELM Source Families

Public versus Source-Only

Some source rows are intentionally not standalone public pages:

• generated ownership READMEs
• migration files where the public contract is the deployment or schema guide
• CI workflow implementation details where the public contract is release, supply-chain, or validation behavior
• test fixtures where the public contract is conformance, verification, or example behavior
• private deployment inventory values and customer-specific runbooks

Those rows still need a coverage rule. The source-coverage gate fails when a row does not match a public route or an explicit classification.

Source Truth

• helm-ai-enterprise/docs/documentation-coverage.csv
• helm-ai-enterprise/scripts/check_documentation_coverage.py
• helm-ai-enterprise/scripts/check_documentation_truth.py
• helm-ai-enterprise/docs/public-docs.manifest.json
• helm-ai-kernel/docs/public-docs.manifest.json
• docs-platform/scripts/check-helm-source-coverage.ts

Troubleshooting