Directories
¶
| Path | Synopsis |
|---|---|
|
Package agents declares the AgentAdapter interface and registers the five built-in adapters Samuel v2 ships (claude, codex, copilot, gemini, kiro).
|
Package agents declares the AgentAdapter interface and registers the five built-in adapters Samuel v2 ships (claude, codex, copilot, gemini, kiro). |
|
Package builtins embeds Samuel's built-in skill content into the binary so `samuel init` can sync it into ~/.samuel/builtins/ without network access.
|
Package builtins embeds Samuel's built-in skill content into the binary so `samuel init` can sync it into ~/.samuel/builtins/ without network access. |
|
Package commands wires the Cobra root command and every subcommand for the Samuel v2 CLI.
|
Package commands wires the Cobra root command and every subcommand for the Samuel v2 CLI. |
|
components
|
|
|
samuel
Package samuel implements Samuel's first concrete plugin: the "samuel-builtins" component.
|
Package samuel implements Samuel's first concrete plugin: the "samuel-builtins" component. |
|
Package config models samuel.toml (the user-edited project config) and samuel.lock (the machine-managed resolved-plugin lockfile).
|
Package config models samuel.toml (the user-edited project config) and samuel.lock (the machine-managed resolved-plugin lockfile). |
|
encoding
|
|
|
toon
Package toon implements a Go encoder/decoder for the subset of the TOON v3 specification that Samuel v2 actually uses for its runtime files in .samuel/run/ (task state, project snapshots, task context).
|
Package toon implements a Go encoder/decoder for the subset of the TOON v3 specification that Samuel v2 actually uses for its runtime files in .samuel/run/ (task state, project snapshots, task context). |
|
Package errors defines Samuel's structured error type used by every subsystem instead of bare errors.New / fmt.Errorf strings.
|
Package errors defines Samuel's structured error type used by every subsystem instead of bare errors.New / fmt.Errorf strings. |
|
Package lock provides a cross-process advisory file lock used to serialise mutating Samuel operations (install / uninstall / sync).
|
Package lock provides a cross-process advisory file lock used to serialise mutating Samuel operations (install / uninstall / sync). |
|
methodology
|
|
|
hooks
Package hooks implements the lifecycle-hook framework that methodologies (built-in or plugin-provided) extend the autonomous loop through.
|
Package hooks implements the lifecycle-hook framework that methodologies (built-in or plugin-provided) extend the autonomous loop through. |
|
ralph
Package ralph wires the built-in Ralph Wiggum methodology: it owns the loop driver, the default hook handlers (snapshot/progress/task context generators, the agent.invoke adapter dispatcher, and the iteration gate that delegates to pilot mode).
|
Package ralph wires the built-in Ralph Wiggum methodology: it owns the loop driver, the default hook handlers (snapshot/progress/task context generators, the agent.invoke adapter dispatcher, and the iteration gate that delegates to pilot mode). |
|
ralph/context
Package context generates the pre-computed context files Ralph hands to the agent at the start of every iteration.
|
Package context generates the pre-computed context files Ralph hands to the agent at the start of every iteration. |
|
ralph/prd
Package prd is the v2 port of samuel_v1/internal/core/auto.go + auto_tasks.go — the data model the Ralph methodology stores in .samuel/run/prd.toon.
|
Package prd is the v2 port of samuel_v1/internal/core/auto.go + auto_tasks.go — the data model the Ralph methodology stores in .samuel/run/prd.toon. |
|
ralph/templates
Package templates embeds and renders the implementation + discovery prompts Ralph hands to the agent.
|
Package templates embeds and renders the implementation + discovery prompts Ralph hands to the agent. |
|
Package orchestrator coordinates installation, detection, health checking, and uninstallation of the Plugins that make up a Samuel project.
|
Package orchestrator coordinates installation, detection, health checking, and uninstallation of the Plugins that make up a Samuel project. |
|
Package plugin defines the universal Plugin contract every installable unit in Samuel v2 satisfies: built-in framework components, text skills, WASM modules, and OCI containers.
|
Package plugin defines the universal Plugin contract every installable unit in Samuel v2 satisfies: built-in framework components, text skills, WASM modules, and OCI containers. |
|
capability
Package capability models the host resources a Samuel plugin can request and the grant flow that gates them at install time.
|
Package capability models the host resources a Samuel plugin can request and the grant flow that gates them at install time. |
|
manifest
Package manifest parses, validates, and renders samuel-plugin.toml — the on-disk descriptor every installable Samuel plugin ships at the root of its repository (or inside its OCI image).
|
Package manifest parses, validates, and renders samuel-plugin.toml — the on-disk descriptor every installable Samuel plugin ships at the root of its repository (or inside its OCI image). |
|
oci
Package oci implements the OCI-tier plugin loader: container images pulled by Podman (rootless), Podman (root), or Docker and launched on demand with a fixed mount layout and a Unix-socket bridge for the framework hooks (see internal/plugin/oci/bridge/).
|
Package oci implements the OCI-tier plugin loader: container images pulled by Podman (rootless), Podman (root), or Docker and launched on demand with a fixed mount layout and a Unix-socket bridge for the framework hooks (see internal/plugin/oci/bridge/). |
|
oci/bridge
Package bridge implements the host-side server an OCI plugin container talks to over /samuel-bridge (a Unix-domain socket bind- mounted into the container's filesystem).
|
Package bridge implements the host-side server an OCI plugin container talks to over /samuel-bridge (a Unix-domain socket bind- mounted into the container's filesystem). |
|
oci/policy
Package policy implements the OCI tier's deny-by-default network policy (PRD 0010 §Functional 4 + 5):
|
Package policy implements the OCI tier's deny-by-default network policy (PRD 0010 §Functional 4 + 5): |
|
oci/policy/proxy
Package proxy is the userspace HTTP/HTTPS proxy that enforces the OCI tier's network policy (PRD 0010 §Functional 5).
|
Package proxy is the userspace HTTP/HTTPS proxy that enforces the OCI tier's network policy (PRD 0010 §Functional 5). |
|
oci/policy/session
Package session bundles the policy.Engine + proxy.Server lifecycle the OCI sandbox path consumes.
|
Package session bundles the policy.Engine + proxy.Server lifecycle the OCI sandbox path consumes. |
|
registry
Package registry implements the plugin index protocol Samuel v2 uses to discover installable plugins.
|
Package registry implements the plugin index protocol Samuel v2 uses to discover installable plugins. |
|
semver
Package semver implements the subset of SemVer 2.0 + Cargo range syntax that Samuel v2's plugin loader needs:
|
Package semver implements the subset of SemVer 2.0 + Cargo range syntax that Samuel v2's plugin loader needs: |
|
service
Package service glues the plugin loader's parts together:
|
Package service glues the plugin loader's parts together: |
|
skill
Package skill implements the skill-tier plugin loader: a text-only Agent Skill bundle that lands as SKILL.md (+ optional scripts/, references/, assets/) under <project>/.samuel/plugins/<name>/.
|
Package skill implements the skill-tier plugin loader: a text-only Agent Skill bundle that lands as SKILL.md (+ optional scripts/, references/, assets/) under <project>/.samuel/plugins/<name>/. |
|
source
Package source materializes a plugin's source tree (manifest + files) into a local directory the loaders can read from.
|
Package source materializes a plugin's source tree (manifest + files) into a local directory the loaders can read from. |
|
verify
Package verify — production sigstore-go implementation.
|
Package verify — production sigstore-go implementation. |
|
wasm
Package wasm — Capabilities collects every resource a wasm plugin can request: filesystem mounts, environment variables, network hosts, memory cap, and per-invocation timeout.
|
Package wasm — Capabilities collects every resource a wasm plugin can request: filesystem mounts, environment variables, network hosts, memory cap, and per-invocation timeout. |
|
Package sandbox is the host-process / OCI launch surface the methodology layer calls through to invoke an agent.
|
Package sandbox is the host-process / OCI launch surface the methodology layer calls through to invoke an agent. |
|
Package sync writes per-folder AGENTS.md files describing each directory's purpose, primary languages, key files, and whether tests live there.
|
Package sync writes per-folder AGENTS.md files describing each directory's purpose, primary languages, key files, and whether tests live there. |
|
translator
|
|
|
claude
Package claude mirrors AGENTS.md files into sibling CLAUDE.md files so Claude Code (which still treats CLAUDE.md as primary) picks up the same project context that every AGENTS.md-native tool already reads.
|
Package claude mirrors AGENTS.md files into sibling CLAUDE.md files so Claude Code (which still treats CLAUDE.md as primary) picks up the same project context that every AGENTS.md-native tool already reads. |
|
Package ui is Samuel v2's human-output layer: lipgloss colour tokens plus the six-category vocabulary v1 settled on (success / error / warn / info / bold / dim) and a handful of list-and-table helpers.
|
Package ui is Samuel v2's human-output layer: lipgloss colour tokens plus the six-category vocabulary v1 settled on (success / error / warn / info / bold / dim) and a handful of list-and-table helpers. |
Click to show internal directories.
Click to hide internal directories.