Directories
¶
| Path | Synopsis |
|---|---|
|
Package adapter is sofia's Tier-1, host-interpreted plugin mechanism: a plugin.yaml `adapter:` block declares project conventions (a root key, root markers, file extensions, and named layers with path globs), and the host — not a subprocess — turns those into project-aware `layers`/`grep`/`refs` commands grouped by layer.
|
Package adapter is sofia's Tier-1, host-interpreted plugin mechanism: a plugin.yaml `adapter:` block declares project conventions (a root key, root markers, file extensions, and named layers with path globs), and the host — not a subprocess — turns those into project-aware `layers`/`grep`/`refs` commands grouped by layer. |
|
Package calllog records every invocation of a sofia-repo tool to a shared JSON-lines log so calls can be analysed and optimised later.
|
Package calllog records every invocation of a sofia-repo tool to a shared JSON-lines log so calls can be analysed and optimised later. |
|
Package cc reads Claude Code session transcripts (the JSONL files under ~/.claude/projects/<encoded-path>/<session-id>.jsonl) and turns them into compact, TOON-friendly digests.
|
Package cc reads Claude Code session transcripts (the JSONL files under ~/.claude/projects/<encoded-path>/<session-id>.jsonl) and turns them into compact, TOON-friendly digests. |
|
Package cli builds the master Cobra command tree for the `sf` binary.
|
Package cli builds the master Cobra command tree for the `sf` binary. |
|
common
|
|
|
changed
Package changed implements `sf changed` — a compact, classified summary of a git diff: per file its status, churn (+/-), category, language, and the enclosing functions/classes touched (read from git's own hunk-header function context, no file parsing).
|
Package changed implements `sf changed` — a compact, classified summary of a git diff: per file its status, churn (+/-), category, language, and the enclosing functions/classes touched (read from git's own hunk-header function context, no file parsing). |
|
code
Package code implements `sf code` — a compact structural summary of source files, without function bodies, so the agent needn't cat a whole file just to see its shape/API (where read tokens go in practice).
|
Package code implements `sf code` — a compact structural summary of source files, without function bodies, so the agent needn't cat a whole file just to see its shape/API (where read tokens go in practice). |
|
code/gocode
Package gocode is the Go backend for `sf code`: a structural summary of a Go source file (package, imports, types, func/method signatures, consts, vars) and single-symbol slicing — via the stdlib go/parser (syntax only, no type-checking), so it works on any file regardless of whether it compiles.
|
Package gocode is the Go backend for `sf code`: a structural summary of a Go source file (package, imports, types, func/method signatures, consts, vars) and single-symbol slicing — via the stdlib go/parser (syntax only, no type-checking), so it works on any file regardless of whether it compiles. |
|
code/phpcode
Package phpcode is the PHP backend for `sf code`: a structural summary of a PHP file (namespace, class/interface/trait/enum, extends/implements, attributes, enum cases, constructor deps, properties, method signatures) and single-method slicing.
|
Package phpcode is the PHP backend for `sf code`: a structural summary of a PHP file (namespace, class/interface/trait/enum, extends/implements, attributes, enum cases, constructor deps, properties, method signatures) and single-method slicing. |
|
code/tscode
Package tscode is the TypeScript/Vue backend for `sf code`.
|
Package tscode is the TypeScript/Vue backend for `sf code`. |
|
composer
Package composer implements `sf composer` — compact, TOON-first views over a tree of PHP packages described by composer.json files.
|
Package composer implements `sf composer` — compact, TOON-first views over a tree of PHP packages described by composer.json files. |
|
doctor
Package doctor implements `sf doctor` — a one-call health check of the local sf install.
|
Package doctor implements `sf doctor` — a one-call health check of the local sf install. |
|
github
Package github implements `sf github ci` — a compact view of a repo's GitHub Actions runs via the `gh` CLI, with an optional `--watch` that blocks until the latest run finishes and prints only its final status (instead of gh's verbose live stream).
|
Package github implements `sf github ci` — a compact view of a repo's GitHub Actions runs via the `gh` CLI, with an optional `--watch` that blocks until the latest run finishes and prints only its final status (instead of gh's verbose live stream). |
|
grep
Package grep implements a generic, language-agnostic TOON-emitting search across a project tree, built on the same walker + matcher + enclosing infrastructure as this toolkit's other structural tools.
|
Package grep implements a generic, language-agnostic TOON-emitting search across a project tree, built on the same walker + matcher + enclosing infrastructure as this toolkit's other structural tools. |
|
gripe
Package gripe records and lists agent complaints about sf — the one failure the call log can't capture on its own: sf exited 0 but gave the wrong thing, or the agent had to fall back to cat/rg/grep because sf couldn't do what was needed.
|
Package gripe records and lists agent complaints about sf — the one failure the call log can't capture on its own: sf exited 0 but gave the wrong thing, or the agent had to fall back to cat/rg/grep because sf couldn't do what was needed. |
|
hook
Package hook implements Claude Code hook endpoints (`sf hook pre`).
|
Package hook implements Claude Code hook endpoints (`sf hook pre`). |
|
initcmd
Package initcmd implements `sf init` — one-shot per-project onboarding that wires sf up for a project's coding agents: a managed block in AGENTS.md, the sf-context skill, the PreToolUse hook, and MCP server registration — for both Claude Code and Codex CLI, each gated on its own detection.
|
Package initcmd implements `sf init` — one-shot per-project onboarding that wires sf up for a project's coding agents: a managed block in AGENTS.md, the sf-context skill, the PreToolUse hook, and MCP server registration — for both Claude Code and Codex CLI, each gated on its own detection. |
|
packagist
Package packagist implements `sf packagist status` — per-package release health for a tree of PHP packages: the latest local git tag vs whether that tag is pushed to origin vs the latest version published on Packagist.
|
Package packagist implements `sf packagist status` — per-package release health for a tree of PHP packages: the latest local git tag vs whether that tag is pushed to origin vs the latest version published on Packagist. |
|
refs
Package refs answers "who defines/uses this symbol across the tree" in one call: a deterministic, word-boundary-matched scan (built on the same walker + matcher infrastructure as internal/common/grep) that labels every hit with its enclosing function/type — the def/use fan `sf grep <symbol>` plus opening each caller by hand would otherwise take.
|
Package refs answers "who defines/uses this symbol across the tree" in one call: a deterministic, word-boundary-matched scan (built on the same walker + matcher infrastructure as internal/common/grep) that labels every hit with its enclosing function/type — the def/use fan `sf grep <symbol>` plus opening each caller by hand would otherwise take. |
|
vue
Package vue implements `sf vue` — helpers over a Vue frontend.
|
Package vue implements `sf vue` — helpers over a Vue frontend. |
|
worktrees
Package worktrees implements `sf worktrees` — a read-only, cross-project view of git-worktree dev forks under a configured parent directory (see DefaultWww).
|
Package worktrees implements `sf worktrees` — a read-only, cross-project view of git-worktree dev forks under a configured parent directory (see DefaultWww). |
|
Package dedup implements a per-session dedup stub for token-heavy sofia tools: a repeated, byte-identical call within a short window of the same session returns a one-line stub ("already returned in call #N; --force to repeat") instead of paying for the full output again.
|
Package dedup implements a per-session dedup stub for token-heavy sofia tools: a repeated, byte-identical call within a short window of the same session returns a one-line stub ("already returned in call #N; --force to repeat") instead of paying for the full output again. |
|
Package envfile loads .env-style files, prompts interactively for missing required values, and writes them back.
|
Package envfile loads .env-style files, prompts interactively for missing required values, and writes them back. |
|
Package gitclone is the first git-clone plumbing in this repo: a small shallow-clone helper for `sf plugin install <git-url>` (and, later, `sf pack install`).
|
Package gitclone is the first git-clone plumbing in this repo: a small shallow-clone helper for `sf plugin install <git-url>` (and, later, `sf pack install`). |
|
Package gitexec is the one place in the repo that shells out to `git`.
|
Package gitexec is the one place in the repo that shells out to `git`. |
|
Package history reads the sofia call log and surfaces invocation history.
|
Package history reads the sofia call log and surfaces invocation history. |
|
Package launch implements `sf claude` — a thin, generic launcher that starts the `claude` CLI for a project.
|
Package launch implements `sf claude` — a thin, generic launcher that starts the `claude` CLI for a project. |
|
Package mcpserver exposes sofia's public-safe Context Providers to LLM coding agents over the Model Context Protocol (MCP), on the stdio transport.
|
Package mcpserver exposes sofia's public-safe Context Providers to LLM coding agents over the Model Context Protocol (MCP), on the stdio transport. |
|
Package pack implements sf's pack-authoring contract: a pack is a git repository or local directory holding a pack.yaml manifest plus the artifacts it bundles.
|
Package pack implements sf's pack-authoring contract: a pack is a git repository or local directory holding a pack.yaml manifest plus the artifacts it bundles. |
|
Package plugin implements sofia's subprocess-first plugin protocol: the host-side mechanics that let a third-party executable extend the `sf` command tree without being compiled into the binary.
|
Package plugin implements sofia's subprocess-first plugin protocol: the host-side mechanics that let a third-party executable extend the `sf` command tree without being compiled into the binary. |
|
Package version holds the sf release version so both the CLI (`sf --version`) and `sf doctor` report the same string without an import cycle between internal/cli and internal/common/doctor.
|
Package version holds the sf release version so both the CLI (`sf --version`) and `sf doctor` report the same string without an import cycle between internal/cli and internal/common/doctor. |
Click to show internal directories.
Click to hide internal directories.