Python API Status¶
Current repository state¶
The repository currently does not contain a verified implementation of the historical skills_tree.SkillsTree Python package documented in older project material.
A repository search for the SkillsTree implementation and its methods did not identify a canonical source module or package directory on main. The current pyproject.toml exposes the skills-tree console entry point through cli.main:app, not through a skills_tree package implementation.
Therefore the historical SkillsTree.get(), SkillsTree.search(), SkillsTree.categories(), SkillsTree.get_category(), and SkillsTree.recommend() API examples are not treated as current repository capabilities.
Canonical search implementation¶
Search currently exists as a repository/web data pipeline rather than as the historical Python API:
tools/build_search_index.pyreads canonical Markdown skill files underskills/.- It produces
docs/search-index.json. .github/workflows/generate-search-index.ymlregenerates that index when skill content changes.- The generated index is intended for the static site's client-side search.
The generated corpus is governed by meta/search-index.schema.json. CI also verifies that its IDs resolve to canonical skills/<id>.md paths and that its canonical path set matches docs/api/skills.json. This makes the search artifact a validated projection rather than an independently maintained catalog. The same generated bytes are published to data/search-index.json for the installable CLI runtime, so source checkout and wheel use one search projection rather than separate indexes. The runtime loader only resolves and loads this artifact. The CLI search consumer applies the deterministic contract in meta/SEARCH_CLI_CONTRACT.md without creating another index or parser.
This is the only search implementation verified in the current repository audit.
CLI relationship¶
The current CLI in cli/main.py exposes:
recommendblueprintgoalsskillsvalidatesearch
skills-tree search is now implemented as a consumer of the canonical generated search projection. Issue #86 is implemented without creating a second indexing or ranking data source.
Evidence boundary¶
This page intentionally records the current verified state instead of preserving undocumented API claims as if they were implemented. Historical references to the former SkillsTree API should be treated as planning or legacy documentation until a concrete implementation, tests, packaging evidence, and runtime verification exist.