Skip to content

Commit c78908a

Browse files
hyperpolymathclaude
andcommitted
docs: disambiguation gate for RGTV vs Svalinn vs Rokur
Updates 0-AI-MANIFEST.a2ml with a [project-identity] + [disambiguation-gate] block that makes RGTV's distinct identity unmistakable. Three projects have been frequently conflated because RGTV's internal subdirectories are currently misnamed `svalinn-cli`, `terraform-provider-svalinn`, and `ansible-collection-svalinn`. These are legacy scaffolding, belong to RGTV, and will be renamed in a follow-up session. They do NOT make RGTV part of the Svalinn project. Key clarifications recorded: - RGTV (THIS REPO) = zero-trust credential broker for LLM agents. Agents use secrets via opaque grants without ever seeing the raw values. Top- level monorepo. Alpha status: crypto layer real, CLI/daemon/shell-integration all TODO. Not ready to replace ~/.secrets as the canonical credential store; audit completed 2026-04-10. - Svalinn = completely separate Deno HTTP container gateway. NOT part of this repo. - Rokur = Svalinn's cross-cutting secrets-management component, living at /var/mnt/eclipse/repos/stapeln/container-stack/rokur/. NOT RGTV. AI agent instructions included: the manifest tells any agent entering the repo to prompt the user for confirmation before acting. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent fde8fc2 commit c78908a

1 file changed

Lines changed: 60 additions & 1 deletion

File tree

0-AI-MANIFEST.a2ml

Lines changed: 60 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,68 @@
22
# 0-AI-MANIFEST.a2ml — Universal AI Agent Entry Point
33

44
[manifest]
5-
version = "0.2"
5+
version = "0.3"
66
format = "a2ml"
77

8+
[project-identity]
9+
name = "Reasonably Good Token Vault (RGTV)"
10+
one-line = "Zero-trust credential broker for LLM agents — agents use secrets via opaque grants without ever seeing the raw values."
11+
kind = "top-level monorepo"
12+
not-to-be-confused-with = [
13+
"Svalinn — a completely separate project (Deno HTTP gateway for verified container operations, delegates to Vörðr)",
14+
"Rokur — Svalinn's INTERNAL secrets-management component, managed via Stapeln's GUI. Rokur lives in the Svalinn orbit, NOT here.",
15+
]
16+
17+
[disambiguation-gate]
18+
# READ THIS BEFORE DOING ANY WORK IN THIS REPO.
19+
#
20+
# Three projects are frequently conflated. They are DISTINCT:
21+
#
22+
# 1. RGTV (THIS REPO)
23+
# Purpose: zero-trust credential broker so LLM agents can USE secrets
24+
# without ever SEEING them. Agents hold opaque handles/grants;
25+
# RGTV performs the privileged action and returns the result.
26+
# Scope: broker daemon, CLI, honeypot, validation, audit, deception
27+
# surfaces, multi-language bindings (Ada CLI, terraform,
28+
# ansible), zero-knowledge proxy (see docs/DESIGN-2026-03-16-
29+
# zero-knowledge-proxy.md).
30+
#
31+
# 2. Svalinn (DIFFERENT REPO: /var/mnt/eclipse/repos/svalinn)
32+
# Purpose: Deno-based HTTP edge gateway that validates container
33+
# operation requests and delegates to Vörðr. Auth, policy,
34+
# orchestration for verified containers.
35+
# Scope: NOT a secrets manager. NOT an LLM broker. Container ops only.
36+
#
37+
# 3. Rokur (LIVES IN SVALINN'S ORBIT — NOT THIS REPO)
38+
# Purpose: Svalinn's OWN internal secrets store (OAuth keys, JWT keys,
39+
# TLS certs — the credentials Svalinn itself needs to operate).
40+
# Surface: managed via Stapeln's GUI/UX.
41+
# Scope: infrastructure dependency of Svalinn, not a product.
42+
#
43+
# If you came here looking for Svalinn (container gateway): WRONG PLACE.
44+
# → go to /var/mnt/eclipse/repos/svalinn
45+
# If you came here looking for Rokur (Svalinn's secret store): WRONG PLACE.
46+
# → go to the Svalinn repo and look for its Rokur component.
47+
# If you came here for zero-trust LLM credential brokering: RIGHT PLACE.
48+
49+
# Internal subdirs named `svalinn-cli`, `terraform-provider-svalinn`, and
50+
# `ansible-collection-svalinn` are MISNAMED legacy scaffolding. They belong
51+
# to RGTV, not to the Svalinn gateway project. Rename is pending.
52+
53+
ai-agent-instructions = """
54+
Before acting on any request in this repo, CONFIRM WITH THE USER which of
55+
the three projects (RGTV / Svalinn / Rokur) they actually mean. Do not
56+
assume — the naming collision has caused real confusion. A good opening
57+
prompt:
58+
59+
"Just to confirm — you're in the RGTV repo (zero-trust credential broker
60+
for LLM agents). Did you mean RGTV, or were you looking for Svalinn (the
61+
container gateway) or Rokur (Svalinn's internal secret store)?"
62+
63+
Only proceed once the user has explicitly confirmed RGTV is the intended
64+
target. If they meant Svalinn or Rokur, redirect them to the correct repo.
65+
"""
66+
867
[canonical-locations]
968
machine-readable = ".machine_readable/"
1069
state = ".machine_readable/6a2/STATE.a2ml"

0 commit comments

Comments
 (0)