Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

Merge remote-tracking branch 'origin/dev' into fix/issue-825-storage-layout-v2

Alfredo Lopezd6a8ecb861a3
diff --cc docs/README.md
index b5cbba95d,d60084a68..312256884
--- a/docs/README.md
+++ b/docs/README.md
@@@ -46,26 -47,43 +47,44 @@@ say so. [Design records](#design-record
## How-to guides
- | Doc | Description |
- | ----------------------------------------------------------------------------- | ---------------------------------------------------------- |
- | [Connect Telegram](how-to/connect-telegram.md) | Minikube env or CRD channel path |
- | [Connect Slack](how-to/connect-slack.md) | Slack app scopes, request URL, conversation verification |
- | [Connect Microsoft Teams](how-to/connect-teams.md) | Teams CLI bot registration, endpoint, conversation verify |
- | [Configure approvals](how-to/configure-approvals.md) | Human-in-the-loop tool gates |
- | [Add an MCP server](how-to/add-mcp-server.md) | Dev-mode JSON or CRD allowlist path |
- | [LLM providers overview](llm-providers/README.md) | Which providers are supported and how they fit together |
- | [Configure LLM providers](deploy/llm-providers.md) | Credentials, model allowlist, per-session selector |
- | [Add an LLM provider](llm-providers/adding-a-provider.md) | Data-only vs driver-based integration paths |
- | [Desktop setup & updates](how-to/desktop-setup-and-updates.md) | Environments, invitation setup, updates |
- | [Member invitations on self-hosted](how-to/member-invitations-self-hosted.md) | Hosted mode zero-config emails vs running your own service |
- | [Track usage & set budgets](how-to/token-budgets-and-usage.md) | Enable budgets, scope, block vs warn |
- | [Connect to the registry](how-to/connect-to-registry.md) | Self-hosted registry connect flow |
- | [Publish a plugin](how-to/publish-plugin-to-registry.md) | Publish under your org with an `efrk_` key |
- | [Shared & global files](how-to/shared-and-global-files.md) | Team workspaces (SFS) and the brokered drive (GFS) |
- | [Minikube full stack](deploy/minikube.md) | Local Kubernetes platform |
- | [Production notes](deploy/production.md) | Checklist and in-repo deploy assets |
- | [Host PVC layout upgrade](deploy/host-pvc-layout-upgrade.md) | Upgrading stateless Hosts from v0.10.x / v0.11.x |
- | [WorkflowRecipes operations](deploy/workflow-recipes-guide.md) | Recipe ops, RBAC, debugging |
+ | Doc | Description |
+ | ----------------------------------------------------------------------------- | -------------------------------------------------------------- |
+ | [Connect Telegram](how-to/connect-telegram.md) | Minikube env or CRD channel path |
+ | [Connect Slack](how-to/connect-slack.md) | Slack app scopes, request URL, conversation verification |
+ | [Connect Microsoft Teams](how-to/connect-teams.md) | Teams CLI bot registration, endpoint, conversation verify |
+ | [Configure approvals](how-to/configure-approvals.md) | Human-in-the-loop tool gates |
+ | [Add an MCP server](how-to/add-mcp-server.md) | Dev-mode JSON, CRD, or Control UI path |
+ | [Desktop setup & updates](how-to/desktop-setup-and-updates.md) | Environments, invitation setup, updates |
+ | [Member invitations on self-hosted](how-to/member-invitations-self-hosted.md) | Hosted mode zero-config emails vs running your own service |
+ | [Track usage & set budgets](how-to/token-budgets-and-usage.md) | Enable budgets, scope, block vs warn |
+ | [Connect to the registry](how-to/connect-to-registry.md) | Self-hosted registry connect flow |
+ | [Publish a plugin](how-to/publish-plugin-to-registry.md) | Publish under your org with an `efrk_` key |
+ | [Shared & global files](how-to/shared-and-global-files.md) | Team workspaces (SFS) and the brokered drive (EvenDrive / GFS) |
+
+ ## LLM providers
+
+ | Doc | Description |
+ | --------------------------------------------------------- | ---------------------------------------------------------------------- |
+ | [LLM providers overview](llm-providers/README.md) | The 24 providers, mental model, support matrix, request flow, fallback |
+ | [Configure LLM providers](deploy/llm-providers.md) | Operator guide: credentials, Vertex/Bedrock/Azure, allowlist, selector |
+ | [Add an LLM provider](llm-providers/adding-a-provider.md) | Data-only vs driver-based integration paths |
+
+ ## Deploy & operate
+
+ | Doc | Description |
+ | -------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+ | [Minikube full stack](deploy/minikube.md) | In-depth reference for the local platform |
+ | [Production notes](deploy/production.md) | Checklist and in-repo deploy assets |
+ | [WorkflowRecipes operations](deploy/workflow-recipes-guide.md) | Recipe ops, RBAC, debugging |
+ | **Upgrade notes** | |
+ | [Workflow output PVC upgrade](deploy/workflow-output-pvc-upgrade.md) | Per-recipe output PVC ownership change |
+ | [Plugin Workload SDK upgrade](deploy/plugin-workload-sdk-upgrade.md) | promptBridge / clientNotifications rollout order and migration |
++| [Host PVC layout upgrade](deploy/host-pvc-layout-upgrade.md) | Upgrading stateless Hosts from v0.10.x / v0.11.x |
+ | **Runbooks** | |
+ | [GFS permission store](deploy/gfs-permission-store.md) | `gfs_controller` DB credential: provisioning, rotation, recovery |
+ | [Password work ownership recovery](how-to/password-work-ownership-recovery.md) | Recover the bcrypt work-bounding singleton |
+ | [MCP secret rollback permits](how-to/control-api-mcp-secret-rollback-permits.md) | Short-lived permits for the legacy MCP secret rollback path |
+ | [GFS large-file downloads](operations/gfs-large-file-host-downloads.md) | GFS admission limits vs visual model input |
## Reference
@@@ -76,13 -94,44 +95,45 @@@
| [llms.txt](llms.txt) | Machine-readable doc map for coding agents |
| Service READMEs | One-line map per component in the root [README components list](../README.md#docs-and-components) |
- ## Testing
-
- | Doc | Description |
- | --------------------------------------------------------------------------- | -------------------------------------- |
- | [E2E guide](testing/e2e-guide.md) | Cluster E2E suites, approvals, desktop |
- | [Custom coordinator E2E gates](testing/custom-coordinator-e2e-gates.md) | Gates for custom coordinator images |
- | [Desktop observation smoke test](testing/desktop-observation-smoke-test.md) | Desktop surface smoke check |
+ ## Architecture deep dives
+
+ Design-level explanations of specific subsystems. Read the overview first.
+
+ | Doc | Description |
+ | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+ | [Diagrams](architecture/diagrams/) | Excalidraw sources |
+ | [Stateless agent invariants](architecture/stateless-invariants.md) | Guardrails for the suspend/wake agent lifecycle |
++| [Host storage layout](architecture/host-storage-layout.md) | Workspace PVC layout, merge init, database failures, rollback rule |
+ | [HCC readiness flows](architecture/hcc-readiness-flows.md) | Probe vs data-path readiness in host-context-controller |
+ | [Live entity-change semantics](architecture/live-entity-change-consumer-semantics.md) | Latest-state convergence contract for live UI updates |
+ | [Governed tracing](architecture/governed-tracing.md) | Control-plane evidence of what agents, admins, controllers did |
+ | [Administrative rate limits](architecture/administrative-rate-limits.md) | Control API quotas and how the UIs handle throttling |
+ | [GFS desktop operator parity](architecture/gfs-desktop-operator-parity.md) | Initial Desktop identity as EvenDrive operator on self-hosted |
+ | [Registry pull secrets: self-provisioning](architecture/registry-pull-secret-self-provisioning.md) | How a self-hosted install provisions its registry image-pull Secret |
+ | [Registry pull secrets: recipe workloads](architecture/registry-pull-secret-recipe-workloads.md) | Extending that pull Secret to WorkflowRecipe workloads |
+ | [Codex subscription transport contract](architecture/codex-subscription-transport-contract.md) | Wire contract for the `codex-subscription` provider |
+ | [Grok subscription transport contract](architecture/grok-subscription-transport-contract.md) | Wire contract and flags for `grok-subscription` |
+ | [WorkflowRecipe naming](architecture/workflow-recipe-naming.md) | Generated resource-name rules |
+
+ ## Testing & contributor runbooks
+
+ Contributor-facing. Most assume a local development cluster and the lanes in
+ [`CONTRIBUTING.md`](../CONTRIBUTING.md).
+
+ | Doc | Description |
+ | ------------------------------------------------------------------------------------ | --------------------------------------------------- |
+ | [E2E guide](testing/e2e-guide.md) | Cluster E2E suites, approvals, desktop |
+ | [Minikube T0/T1/T2 runbook](testing/minikube-t2-runbook.md) | The validation-lane contract |
+ | [Custom coordinator E2E gates](testing/custom-coordinator-e2e-gates.md) | Gates for custom coordinator images |
+ | [Desktop observation smoke test](testing/desktop-observation-smoke-test.md) | Desktop surface smoke check |
+ | [Control UI headful journeys](testing/control-ui-headful-journeys.md) | Optional Playwright QA recorder for Control UI |
+ | [Desktop headful journeys](testing/desktop-headful-journeys.md) | Optional Playwright QA recorder for the Desktop App |
+ | [Codex subscription validation](testing/codex-subscription-validation.md) | Evidence lanes for `codex-subscription` |
+ | [Grok subscription validation](testing/grok-subscription-validation.md) | Evidence lanes for `grok-subscription` image input |
+ | [Workflow NetworkPolicy regressions](testing/workflow-network-policy-regressions.md) | Ownership rules learned from workflow policy bugs |
+ | [Stateless idle calibration](testing/stateless-idle-calibration.md) | Measuring the stateless time-to-idle |
+ | [Local measurements](testing/local-measurements.md) | Running benchmarks through the intake gate |
+ | [CodeQL rate-limiting dispositions](how-to/codeql-js-missing-rate-limiting.md) | Audited dispositions for `js/missing-rate-limiting` |
## For coding agents