internal/

Package api is the typed HTTP client for the positronick.com read API.

Package auth owns authentication for the CLI: the OAuth-style device flow against positronick.com, the on-disk credential cache, and the api.CredentialsProvider every command authenticates through.

Package cli wires the cobra command tree.

Package config resolves the CLI's configuration directory and settings.

Package install owns the SOUL.md install conventions: harness detection, the per-framework target table, the overwrite gate, and the install receipt written by install.sh.

Package mcpserver embeds an MCP (Model Context Protocol) stdio server in the positronick binary: five consolidated tools — soul_search, soul_show, soul_install, listing_search, listing_show — each a thin wrapper over the same internal packages the CLI commands use (the api client, the search ranking, the install machinery), so the two surfaces can never disagree.

Package mockapi serves a fixed positronick.com API fixture over net/http/httptest-compatible handlers, implementing the read contract (GET /api/souls, /api/souls/{slug}, /api/listings(?type=), /api/listings/{slug}) and the auth contract (device flow, /api/me, api-key/create) for the CLI's golden and e2e tests.

Package output is the single rendering, error, and exit-code authority for the CLI.

Package search ports the website's client-side fuzzy ranking to Go.

Package selfupdate implements `positronick self update`: it classifies how the binary was installed (only the installer receipt authorizes an in-place replace), talks to the GitHub releases API, verifies the downloaded archive against checksums.txt, and swaps the binary atomically.

Package version holds build metadata.