Version boundary for pointers on this page: ARC source layout as of 44fbd616f, CLI arc 2.0.0-beta.28. Paths under packages/ and providers/ refer to the ARC repository (read-only reference for site authors), not to files inside this site blocklet.
Terminology
| Term | Meaning |
|---|
| AFS | Path-addressable filesystem abstraction in ARC |
| Path | Virtual address in an instance namespace (for example /modules/project/README.md) |
| Mount | Binding from a path prefix to a provider URI/instance |
Provider / AFSModule | Module that implements operations for owned paths |
| Capability / operations declaration | What ops (and features) the provider claims to support |
list | Enumerate children; best-effort options |
search | Provider-defined free-text retrieval |
query | Optional strict typed collection query at /.actions/query |
exec | Invoke an action at an executable path |
explain | Describe concept or path resolution |
| Access mode | readonly / create / append / readwrite |
| Visibility | full / meta |
| Conformance | Shared provider tests via @aigne/afs-testing |
| Instance | A concrete runtime with its own mounts and data |
Core types and ops (source pointers)
| Topic | Where in ARC |
|---|
AFSModule, AFSRoot, entry/result types | packages/core/src/type.ts |
| Dispatcher / routing | packages/core/src/afs.ts |
OperationsDeclaration, capability helpers | packages/core/src/capabilities/types.ts |
| Collection query types + strict validator | packages/core/src/capabilities/collection-query.ts |
| Error classes and codes | packages/core/src/error.ts |
| Base provider + decorators | packages/core/src/provider/ |
| JSON reference provider | providers/core/json/ |
| FS provider | providers/basic/fs/ |
| Conformance runner | packages/testing/ (runProviderTests) |
| Authoring guide | docs/guides/provider-authoring.md |
| Collection query guide | docs/guides/collection-query.md |
CLI command group
| Command | Role |
|---|
arc afs ls | List |
arc afs read | Read |
arc afs write | Write |
arc afs delete | Delete |
arc afs stat | Stat |
arc afs search | Search |
arc afs exec | Exec action |
arc afs explain | Explain |
arc afs mount … | Mount management |
Full flag reference: arc afs.
Board map
Related boards
- AUP — declarative UI model
- Web Device — static site provider over AFS paths
- arc-cli — command man pages
Error codes (quick index)
See the table on Core contract. Branch on codes such as AFS_NOT_FOUND, AFS_UNSUPPORTED, AFS_VALIDATION_ERROR, AFS_CONFLICT, AFS_READONLY, AFS_AUTH_REQUIRED.