compile-api

Compile Fusion API Database

Invocation: Claude Code /fusion:compile-api; Codex $fusion:compile-api.

1. Resolve scripts/compile_fusion_api.py from this active SKILL.md to an absolute path. NEVER use a plugin-root environment variable.

2. Run:

   ["python3", "<absolute-compile_fusion_api.py>"]
   

   Needs network access to api.github.com (commit and file listing) and raw.githubusercontent.com (the stub files themselves), and to no other host: github.com is only the source string recorded in the database. The default output is the user cache (~/.cache/fusion-api-db/fusion-api.db), which query-api prefers over the database bundled with the plugin — a recompile takes effect immediately, no plugin reinstall.

3. Options, only when the user asks for them:

   • --ref <git-ref> compiles a specific ref of the reference repo (default main).
   • --source <dir> parses a local directory of adsk/*.py stubs instead of downloading. It resolves no ref, so the two options are refused together (usage error, exit 2) rather than --ref being ignored; a user asking for both wants a download of that ref.
   • --output <path> writes elsewhere. Refreshing the plugin's bundled copy (authoring checkout of this plugin only) → --output <plugin>/skills/query-api/data/fusion-api.db, then commit the result.

4. Report the script's final line on stdout (path, symbol count, member count) and the compiling <source>@<commit> line stderr opens with, as the source record. Every path emits that line: a download names the reference repo, the resolved commit, and the ref that was requested (compiling <repo>@<sha> (requested ref '<ref>')), a --source compile names the local directory and local in place of a commit. Report the requested ref as well as the commit — the resolved commit alone cannot be checked against the ref the user named. Relay every warning: line on stderr too: one kind reports how many statements used a construct the compiler does not index, and one kind reports a warning Python raised while parsing a named stub. Non-zero exit → relay stderr as-is and stop.

The script rebuilds the whole database from scratch; there is no incremental mode. It compiles into a staging file next to the output and replaces the output only after every stub has parsed and the result has been checked to be non-empty, so a compile that fails partway leaves the existing database in place. A compile that succeeds still discards the previous contents — anything hand-edited into that database is lost.