pkg/

Package cliflags holds tiny, dependency-free Cobra flag helpers shared by every tool in the repo (format aliases, etc.).

Package codectx extracts surrounding-scope context from source files without depending on a full AST.

Package emit enforces the core invariant of every token-saving sofia tool: a tool that stands in for a standard command (cat, grep, …) must never cost MORE tokens than that command would.

Package matcher scans a file line-by-line for occurrences of one or more patterns, returning hits with line/column information.

Package php reads a PHP source file and returns a structured summary of the first class/interface/trait/enum declaration it finds: namespace, FQCN, modifiers, parent/implements, public methods, constructor dependencies, and the docblock summary.

Package strdist provides small string-distance helpers for typo-tolerant CLI suggestions ("did you mean X?").

Package tokens estimates how many LLM tokens a given string costs.

Package toon implements low-level helpers for the TOON (Token-Oriented Object Notation) text format.

Package walker enumerates files in a directory tree, applying include/exclude rules.