You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# AgenticFortress Agent Notes
1
+
# Agentic Secrets Agent Notes
2
2
3
3
This file is for coding agents and maintainers working in this repository. Keep user-facing onboarding short in `README.md`; put implementation, verification, and release workflow details here or in `Docs/`.
4
4
@@ -8,7 +8,7 @@ Current release metadata: `0.1.0 alpha`. This is a pre-stable product; breaking
8
8
9
9
## Product Boundary
10
10
11
-
AgenticFortress is a macOS lower-leakage secret delivery system for developer machines.
11
+
Agentic Secrets is a macOS lower-leakage secret delivery system for developer machines.
12
12
13
13
It does not make execution safe. It makes delivery of secrets explicit, narrow, approved, bounded, auditable, and lower-leakage than `.env`, shell environment, MCP configs, or plaintext provider tokens.
- Signed shim model through one `agentic-fortress-shim` binary and symlink-style invocation.
44
-
- CLI env delivery with signed/versioned dynamic command adapter packs and deterministic decision manifests.
45
-
- Local API proxy profiles with per-session localhost capability tokens.
46
-
-BWS provider split where runtime fetch is one approved secret per invocation.
43
+
- Signed shim model through one `agentic-secrets-shim` binary and symlink-style invocation.
44
+
- CLI env delivery with signed/versioned dynamic command command policy packs and deterministic decision manifests.
45
+
- Local API API session profiles with per-session localhost capability tokens.
46
+
-Bitwarden provider split where runtime fetch is one approved secret per invocation.
47
47
- Remote MCP bridge contracts with pinned upstream profile and session propagation.
48
48
- Rollback detection that locks policy use and clears remembered leases.
49
49
- Structured audit with redaction gates.
50
50
- Release gate checklist backed by executable contract tests.
51
51
52
52
Adapter packs are dynamic but not trust-by-configuration. External packs must verify under a trusted P-256 signing key, publisher allowlist, CLI allowlist, schema version, expiry, rule validation, and rollback checks before registration. Lease scope includes adapter identity, version, and hash.
53
53
54
-
Runtime policy is configurable through `AgenticFortressConfig`; the default JSON lives at `config/default.agentic-fortress.json`. Configuration covers adapter trust, delivery defaults, proxy profiles, MCP profiles, and macOS compatibility gates.
54
+
Runtime policy is configurable through `AgenticSecretsConfiguration`; the default JSON lives at `config/default.agentic-secrets.json`. Configuration covers adapter trust, delivery defaults, API session profiles, MCP profiles, and macOS compatibility gates.
55
55
56
56
## Build And Verify
57
57
58
58
Run the standard gates before presenting a production-ready change:
Then use **Diagnostics → Install Local Daemon** or **Diagnostics → Repair Local Daemon**. The app shows the app copy, helper symlinks, state directory, run directory, install manifest, LaunchAgent, and socket path before writing files. It does not read or move local secret material. If the app was launched from `build/`, open the installed copy after installation so authenticated IPC matches the installed bundle path in the manifest.
The local installer writes an install manifest with helper paths, owners, permissions, versions, SHA-256 hashes, and cdhash values. Runtime IPC authorization uses that manifest instead of requiring a Developer ID Team ID.
105
105
106
-
The core daemon serves the local control plane over a Unix domain socket. Helpers authenticate to core with the install manifest and do not read local secret material directly.
106
+
The broker daemon serves the local control plane over a Unix domain socket. Helpers authenticate to core with the install manifest and do not read local secret material directly.
107
107
108
-
On macOS Tahoe, the self-build track avoids restricted entitlements so ad-hoc signed binaries can execute normally. The core daemon stores local secret material in an owner-only encrypted file store gated by LocalAuthentication; no shared Keychain access group is required for the self-build track. Registered CLI trust metadata is protected by a device-local macOS Keychain integrity key so hand-edited registry files fail closed before any secret is resolved.
108
+
On macOS Tahoe, the self-build track avoids restricted entitlements so ad-hoc signed binaries can execute normally. The broker daemon stores local secret material in an owner-only encrypted file store gated by LocalAuthentication; no shared Keychain access group is required for the self-build track. Registered CLI trust metadata is protected by a device-local macOS Keychain integrity key so hand-edited registry files fail closed before any secret is resolved.
109
109
110
110
CLI runs may reuse scoped authorization grants after successful LocalAuthentication. The default mode is `always`; `remember-24h`, `short`, and `once` are available per run. Persistent grants are signed with a device-local macOS Keychain key and scoped to CLI name, target identity, workspace hash, config context, untrusted origin hint, provenance confidence, delivery mode, and secret alias. Short grants additionally include action class, command digest, and risk. Command policy is re-evaluated before every secret delivery, and destructive commands require fresh approval. Grants must never contain secret values.
Maintainers may remove comments, issues, pull requests, or other contributions that violate this Code of Conduct. Maintainers may also temporarily or permanently limit participation for behavior they judge inappropriate, threatening, offensive, or harmful.
28
+
29
+
Instances of abusive behavior may be reported through the repository maintainers. Security-sensitive reports should follow `SECURITY.md`.
0 commit comments