internal/

directory
v0.0.0-...-7cce3c2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 14, 2026 License: Apache-2.0

Directories

Path Synopsis
Package api provides the HTTP API layer for the HelixKnowledge Skill Graph System.
Package api provides the HTTP API layer for the HelixKnowledge Skill Graph System.
Package autoexpand provides LLM integration for skill drafting in the HelixKnowledge auto-growth pipeline.
Package autoexpand provides LLM integration for skill drafting in the HelixKnowledge auto-growth pipeline.
Package cache provides a Redis-backed caching layer for the HelixKnowledge skill graph system, with graceful degradation to a NoopCache when Redis is unavailable or not configured.
Package cache provides a Redis-backed caching layer for the HelixKnowledge skill graph system, with graceful degradation to a NoopCache when Redis is unavailable or not configured.
Package codeanalysis provides high-level code analysis capabilities for the HelixKnowledge system.
Package codeanalysis provides high-level code analysis capabilities for the HelixKnowledge system.
Package codegraph provides the CodeGraph MCP integration layer for the HelixKnowledge Skill Graph System.
Package codegraph provides the CodeGraph MCP integration layer for the HelixKnowledge Skill Graph System.
Package config provides configuration loading from TOML files with environment variable overrides.
Package config provides configuration loading from TOML files with environment variable overrides.
Read/write pool separation for the HelixKnowledge skill graph system.
Read/write pool separation for the HelixKnowledge skill graph system.
ingest
pipeline
Package pipeline implements the deterministic, LLM-free EXTRACT -> NORMALIZE -> map-to-models.Skill core of the ingestion pipeline (docs/research/.../DESIGN.md §2, stages 1-2, plus the "map to models.Skill" half of stage 6 CREATE).
Package pipeline implements the deterministic, LLM-free EXTRACT -> NORMALIZE -> map-to-models.Skill core of the ingestion pipeline (docs/research/.../DESIGN.md §2, stages 1-2, plus the "map to models.Skill" half of stage 6 CREATE).
source
Package source defines the addressable-origin abstraction the skill ingestion pipeline pulls raw content from (F1.1 in docs/research/.../skill_ingestion_research/TRACKED_ITEMS.md; the design is docs/research/.../DESIGN.md §1).
Package source defines the addressable-origin abstraction the skill ingestion pipeline pulls raw content from (F1.1 in docs/research/.../skill_ingestion_research/TRACKED_ITEMS.md; the design is docs/research/.../DESIGN.md §1).
Package mcp implements the Model Context Protocol server for the HelixKnowledge Skill Graph System.
Package mcp implements the Model Context Protocol server for the HelixKnowledge Skill Graph System.
Package metrics provides Prometheus instrumentation for the HelixKnowledge skill graph system.
Package metrics provides Prometheus instrumentation for the HelixKnowledge skill graph system.
Package registry provides skill registry management and health monitoring for the HelixKnowledge system.
Package registry provides skill registry management and health monitoring for the HelixKnowledge system.
Package skill provides CRUD and search operations for skills in the knowledge graph.
Package skill provides CRUD and search operations for skills in the knowledge graph.
Package skillscatalog generates a deterministic, byte-stable Markdown reference catalog for the live skill graph (a top-level README + INDEX, by-domain and by-kind grouping pages, and one detail page per skill), together with a sha256 roster fingerprint sidecar (§11.4.86) that a later layer (CLI/REST/MCP/worker/git-hook -- G126+, explicitly OUT of this package's scope) can use to detect drift and re-arm regeneration.
Package skillscatalog generates a deterministic, byte-stable Markdown reference catalog for the live skill graph (a top-level README + INDEX, by-domain and by-kind grouping pages, and one detail page per skill), together with a sha256 roster fingerprint sidecar (§11.4.86) that a later layer (CLI/REST/MCP/worker/git-hook -- G126+, explicitly OUT of this package's scope) can use to detect drift and re-arm regeneration.
Package skillsource provides CRUD and sync-status management for registered skill sources — GitHub repos, filesystem paths, and URLs that supply SKILL.md files for the source-ingestion pipeline (internal/source/github, internal/source/mapper, internal/source/skillmd).
Package skillsource provides CRUD and sync-status management for registered skill sources — GitHub repos, filesystem paths, and URLs that supply SKILL.md files for the source-ingestion pipeline (internal/source/github, internal/source/mapper, internal/source/skillmd).
source
dedup
Package dedup provides a classifier that determines whether a parsed skill is NEW (no match found), DUPLICATE (exact name match), or VARIANT (normalized name match with different content).
Package dedup provides a classifier that determines whether a parsed skill is NEW (no match found), DUPLICATE (exact name match), or VARIANT (normalized name match with different content).
github
Package github provides a minimal, hand-rolled REST client for the GitHub API, used by the skill-source ingestion pipeline (see docs/source_ingestion/WIRING_PLAN.md §3.1/§1.9 for the design this file implements) to fetch a repository's file tree, head commit SHA, and individual file contents.
Package github provides a minimal, hand-rolled REST client for the GitHub API, used by the skill-source ingestion pipeline (see docs/source_ingestion/WIRING_PLAN.md §3.1/§1.9 for the design this file implements) to fetch a repository's file tree, head commit SHA, and individual file contents.
mapper
Package mapper turns a parsed SKILL.md (internal/source/skillmd) into an in-memory models.Skill value, applying the namespacing and license-gate rules the GitHub-skills-ingestion feature requires (see docs/source_ingestion/WIRING_PLAN.md §3.4 / docs/source_ingestion/TRACKED_ITEMS.md G61 for the design this implements).
Package mapper turns a parsed SKILL.md (internal/source/skillmd) into an in-memory models.Skill value, applying the namespacing and license-gate rules the GitHub-skills-ingestion feature requires (see docs/source_ingestion/WIRING_PLAN.md §3.4 / docs/source_ingestion/TRACKED_ITEMS.md G61 for the design this implements).
skillmd
Package skillmd parses SKILL.md files — the YAML-frontmatter-plus- markdown-body format Claude Code and the broader open agent-skills ecosystem use to define a skill (see docs/source_ingestion/CATALOG.md §2 for the authoritative field table this parser implements, verified against code.claude.com/docs/en/skills 2026-07-16).
Package skillmd parses SKILL.md files — the YAML-frontmatter-plus- markdown-body format Claude Code and the broader open agent-skills ecosystem use to define a skill (see docs/source_ingestion/CATALOG.md §2 for the authoritative field table this parser implements, verified against code.claude.com/docs/en/skills 2026-07-16).
Package toon is the HelixKnowledge Skill Graph System's adapter for the Token-Oriented Object Notation (TOON) wire format (register gap G08).
Package toon is the HelixKnowledge Skill Graph System's adapter for the Token-Oriented Object Notation (TOON) wire format (register gap G08).
Package validation implements the fail-closed, NON-EXECUTING skill validation pipeline for the HelixKnowledge system (the "zero-bluff guarantee").
Package validation implements the fail-closed, NON-EXECUTING skill validation pipeline for the HelixKnowledge system (the "zero-bluff guarantee").
Package worker provides background job execution for the HelixKnowledge skill graph system.
Package worker provides background job execution for the HelixKnowledge skill graph system.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL