Directories
¶
| Path | Synopsis |
|---|---|
|
Package agents sets up the anfra skills in the coding agents on this machine (docs/designs/agent-setup.md): a plugin through the agent's own CLI where anfra knows one, a pointer to the skills repo's README for every other agent.
|
Package agents sets up the anfra skills in the coding agents on this machine (docs/designs/agent-setup.md): a plugin through the agent's own CLI where anfra knows one, a pointer to the skills repo's README for every other agent. |
|
Package aml is the engine's work on the repo's AML as a whole: validating it, and showing its objects.
|
Package aml is the engine's work on the repo's AML as a whole: validating it, and showing its objects. |
|
Package app is the single registry of anfra operations.
|
Package app is the single registry of anfra operations. |
|
Package appserve is anfra serve's Data App component, its backend: the pages a browser opens (/apps/<path>, the appserve frontend), the Data Apps under the repo's apps/ (their tree, and the files themselves), who reads them, and live reload.
|
Package appserve is anfra serve's Data App component, its backend: the pages a browser opens (/apps/<path>, the appserve frontend), the Data Apps under the repo's apps/ (their tree, and the files themselves), who reads them, and live reload. |
|
Package attribution carries who an invocation is for, so that a log line, a span or an audit record can name them.
|
Package attribution carries who an invocation is for, so that a log line, a span or an audit record can name them. |
|
Package cliauth owns browser OAuth login and durable, machine-local credentials.
|
Package cliauth owns browser OAuth login and durable, machine-local credentials. |
|
Package clierr is the CLI's own error codes: the failures of its CLI-only commands (and of what they call), which no op has, so they're in no host's catalog (docs/implementations/cli-json.md, step 3).
|
Package clierr is the CLI's own error codes: the failures of its CLI-only commands (and of what they call), which no op has, so they're in no host's catalog (docs/implementations/cli-json.md, step 3). |
|
Package cliui owns inline terminal presentation, not authentication or storage.
|
Package cliui owns inline terminal presentation, not authentication or storage. |
|
Package cloudapi is the anfra CLI's client of anfra-cloud: the ops `anfra publish` calls, with types written here for them.
|
Package cloudapi is the anfra CLI's client of anfra-cloud: the ops `anfra publish` calls, with types written here for them. |
|
Package command is the framework anfra's commands are written in: a Def declares one, Define checks it, and the Command it makes is what every surface reads: the CLI builds its flags from it, `anfra serve` serves it as the op core.<name>, and the registry (internal/app) describes it.
|
Package command is the framework anfra's commands are written in: a Def declares one, Define checks it, and the Command it makes is what every surface reads: the CLI builds its flags from it, `anfra serve` serves it as the op core.<name>, and the registry (internal/app) describes it. |
|
catalog
Package catalog is the commands over the local search catalog: ingest builds it from the repo's context sources, search queries it, and lineage traces fields through it.
|
Package catalog is the commands over the local search catalog: ingest builds it from the repo's context sources, search queries it, and lineage traces fields through it. |
|
query
Package query is the query commands: query runs a query, query.compile compiles one to SQL, and query.validate checks one.
|
Package query is the query commands: query runs a query, query.compile compiles one to SQL, and query.validate checks one. |
|
show
Package show is the show command: an object of the repo, read from its compiled AML, by the identity the semantic catalog gives it.
|
Package show is the show command: an object of the repo, read from its compiled AML, by the identity the semantic catalog gives it. |
|
status
Package status is the commands that report on anfra itself: version, and status of the warm server and its sidecars.
|
Package status is the commands that report on anfra itself: version, and status of the warm server and its sidecars. |
|
validate
Package validate is the validate command: the repo's AML, checked.
|
Package validate is the validate command: the repo's AML, checked. |
|
Package dataperm carries the data-level permissions one invocation runs under: whether its queries are governed, and the caller attributes that row and column rules are written against.
|
Package dataperm carries the data-level permissions one invocation runs under: whether its queries are governed, and the caller attributes that row and column rules are written against. |
|
Package datasource reads a repo's data_sources.yml.
|
Package datasource reads a repo's data_sources.yml. |
|
Package envflag reads anfra's on/off environment variables.
|
Package envflag reads anfra's on/off environment variables. |
|
Package errcode is the engine's namespace, and the error codes no one domain owns: what Dispatch can fail with whatever a command does.
|
Package errcode is the engine's namespace, and the error codes no one domain owns: what Dispatch can fail with whatever a command does. |
|
Package exports is anfra's own command.ExportStore: an export's file in the system's temp directory, reached by a link that expires.
|
Package exports is anfra's own command.ExportStore: an export's file in the system's temp directory, reached by a link that expires. |
|
Package filelock takes an open file's exclusive lock, across processes.
|
Package filelock takes an open file's exclusive lock, across processes. |
|
Package home is anfra's own folder on this machine: everything anfra keeps between runs, in one place to find, mount or delete.
|
Package home is anfra's own folder on this machine: everything anfra keeps between runs, in one place to find, mount or delete. |
|
Package ingest is the catalog ingestion use-case layer: it builds the request anfra-node needs to ingest context sources into the local search catalog.
|
Package ingest is the catalog ingestion use-case layer: it builds the request anfra-node needs to ingest context sources into the local search catalog. |
|
Package logging provides the host's structured, aggregated logger.
|
Package logging provides the host's structured, aggregated logger. |
|
Package meta holds build-time metadata for the anfra binary.
|
Package meta holds build-time metadata for the anfra binary. |
|
Package motherduck is anfra's use of a person's MotherDuck account, to copy a DuckDB file there for an org to query: MotherDuck's own CLI signs them in and uploads, and MotherDuck's REST API makes the org a token of its own (docs/designs/motherduck-copy.md).
|
Package motherduck is anfra's use of a person's MotherDuck account, to copy a DuckDB file there for an org to query: MotherDuck's own CLI signs them in and uploads, and MotherDuck's REST API makes the org a token of its own (docs/designs/motherduck-copy.md). |
|
Package pretty draws a command's result in the pretty format, for a person (docs/designs/cli-pretty.md): a view built from the result's shape by the conventions, adjusted by its fields' pretty tags, then drawn for a terminal.
|
Package pretty draws a command's result in the pretty format, for a person (docs/designs/cli-pretty.md): a view built from the result's shape by the conventions, adjusted by its fields' pretty tags, then drawn for a terminal. |
|
Package publish is `anfra publish`: a local repo's files published to its org, as PUBLISH.md (anfra-cloud) describes.
|
Package publish is `anfra publish`: a local repo's files published to its org, as PUBLISH.md (anfra-cloud) describes. |
|
syncstate
Package syncstate keeps a repo folder's sync state with its orgs: the org revision its files last matched (the base), and a pull that isn't finished (the pending record).
|
Package syncstate keeps a repo folder's sync state with its orgs: the org revision its files last matched (the base), and a pull that isn't finished (the pending record). |
|
workdir
Package workdir is a repo folder as publish and pull see it: the files a publish carries, hashed into a tree, and the safe writing of a merge into them, with a backup to undo it.
|
Package workdir is a repo folder as publish and pull see it: the files a publish carries, hashed into a tree, and the safe writing of a merge into them, with a backup to undo it. |
|
Package query is the query use-case layer: it checks a (dataset, AQL) request, turns it into SQL and runs it, by loading the repo's data sources and driving the sidecars via their clients.
|
Package query is the query use-case layer: it checks a (dataset, AQL) request, turns it into SQL and runs it, by loading the repo's data sources and driving the sidecars via their clients. |
|
Package repo is a command's AML repo: where its files are read from, and the identity anfra-node keys its compile cache by.
|
Package repo is a command's AML repo: where its files are read from, and the identity anfra-node keys its compile cache by. |
|
Package repoconfig is a repo's settings file, .anfra/config.yml: committed, written by hand, and by anfra only through SetString, which changes nothing but the value it sets.
|
Package repoconfig is a repo's settings file, .anfra/config.yml: committed, written by hand, and by anfra only through SetString, which changes nothing but the value it sets. |
|
Package search is the catalog search use-case layer: it builds the request anfra-node needs to search the local catalog.
|
Package search is the catalog search use-case layer: it builds the request anfra-node needs to search the local catalog. |
|
Package sidecar is the framework anfra's sidecars are run with: the Config a host gives them, the lifecycle of one it spawns (Process), how its binary is found (Binary), and how a sidecar that does not answer is classified (Unreachable).
|
Package sidecar is the framework anfra's sidecars are run with: the Config a host gives them, the lifecycle of one it spawns (Process), how its binary is found (Binary), and how a sidecar that does not answer is classified (Unreachable). |
|
anfranode
Package anfranode is the anfra-node sidecar, the AML/AQL engine: its supervisor, which spawns one or connects to an external one, and its JSON-RPC client.
|
Package anfranode is the anfra-node sidecar, the AML/AQL engine: its supervisor, which spawns one or connects to an external one, and its JSON-RPC client. |
|
canalquery
Package canalquery is the canal-query sidecar, the SQL execution engine: its supervisor, which spawns one or connects to an external one, and its client.
|
Package canalquery is the canal-query sidecar, the SQL execution engine: its supervisor, which spawns one or connects to an external one, and its client. |
|
Package telemetry installs OpenTelemetry for the anfra CLI and `anfra serve`: the global tracer provider and W3C propagation, which the spans anfra already makes (apptracing's per op, httpkit's per request) go to.
|
Package telemetry installs OpenTelemetry for the anfra CLI and `anfra serve`: the global tracer provider and W3C propagation, which the spans anfra already makes (apptracing's per op, httpkit's per request) go to. |
|
Package update implements anfra's self-update: discover the latest GitHub release, compare it to the compiled-in version, download the binary for this platform, and atomically replace the running executable.
|
Package update implements anfra's self-update: discover the latest GitHub release, compare it to the compiled-in version, download the binary for this platform, and atomically replace the running executable. |
Click to show internal directories.
Click to hide internal directories.