Files
SeedPass/docs
thePR0M3TH3ANandClaude Opus 5 8653ee8006 fix(agent): validate put at the daemon boundary; state the two scope semantics (L-5, L-6, L-7)
L-7 — `put` is the only way a fingerprint enters `held`, and every later
handler joins that string onto a path (the vault it opens, the audit log it
writes). The CLI validated the format first, which is exactly why the daemon
could not rely on it: agent.ts's own header says the CLI is untrusted, and the
browser extension speaks this protocol next. `put` now requires 16 uppercase
hex, and additionally that the fingerprint actually belongs to the supplied
seed — a mismatch would unlock a vault the caller did not name and file its
audit records under the wrong profile.

Validation order matters and is now deliberate: cheap format check, then ttl,
then the seed match last, because deriving a fingerprint runs the BIP-39 KDF
and a malformed ttl should not pay for it. This keeps the existing
non-numeric-ttl test exercising the ttl path rather than short-circuiting on
the new check.

L-5 — `label_regex` is unanchored, so a token issued for `prod` also reaches
`not-prod-db`. Left as-is on purpose: Python matches with `re.search`, so
anchoring the TypeScript side alone would make one token mean two different
things depending on which implementation holds it, and would silently narrow
every token already issued. The audit asked for whichever behavior Python has,
documented and in the parity matrix — so the semantics are now stated in
--label-regex help, reported machine-readably as
capabilities().tokens.label_regex_semantics, explained at the enforcement
point, recorded in the compatibility matrix, and pinned by tests that assert
BOTH labels are visible to an unanchored token.

L-6 — the exec allowlist constrains the command word, never its arguments.
The token holder writes the argv and the child gets the secret in its
environment, so an allowlisted binary with an output-file or network flag
hands the secret straight back. Documented in the same three places rather
than changed: argument-level containment means allowlisting full argv
templates instead of command words, which is a token-format change that has to
land in both implementations together.

Tests: malformed and mismatched fingerprints refused with nothing held (path
traversal, wrong case, wrong length, trailing component); unanchored vs
anchored label_regex; capabilities reporting both semantics. Mutation-verified
— disabling either put guard turns the matching tests red.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_01Vtx94nXDmNgXEeThUZP4QN
2026-08-18 21:54:21 -04:00
..
2025-07-10 19:37:30 -04:00
2025-07-10 19:37:30 -04:00
2025-07-10 19:37:30 -04:00
2025-08-03 10:27:13 -04:00
2026-02-25 18:07:22 -05:00

SeedPass Docs

This directory contains SeedPass project documentation.

Start Here

  • dev_control_center.md (single source to decide what to do next)

Agent and Autonomy Docs

  • agent_autonomy_security_plan.md
  • policy_as_code.md
  • sync_conflict_contract.md

Core Security Docs

  • security_readiness_checklist.md
  • threat_model.md
  • crypto_key_management_review.md
  • secret_handling_local_exposure_review.md
  • auth_lock_unlock_access_review.md
  • supply_chain_release_integrity.md
  • release_verification_runbook.md
  • release_protection_policy.md
  • operational_runbooks.md
  • staged_rollout_runbook.md

Architecture and Product Docs

  • ARCHITECTURE.md
  • SPEC.md
  • typescript_web_extension_port_plan.md
  • entry_types.md
  • entry_graph.md
  • tui_v3_plan.md (active roadmap for scratch rebuild)
  • tui_v2_plan.md (legacy logic reference)
  • tui_v2_parity_checklist.md
  • tui_v2_parity_backlog.md
  • tui_v2_legacy_parity_matrix.md
  • tui_v2_ui_refresh_plan.md
  • semantic_vector_index_plan.md
  • tui_v2_cutover_decision.md
  • tui_v2_large_vault_validation.md
  • security.md
  • nostr_setup.md
  • nostr_namespace_reset.md
  • packaging.md

QA and Testing Docs

  • TEST_INVENTORY.md (central index of all tests and runners)
  • agent_testing_roadmap.md
  • ai_agent_tui_testing.md
  • agent_test_format.md
  • installer_testing.md
  • kb_scale_validation.md
  • ci-health-2026-02-19.md
  • agent-handoffs/README.md

Discoverability Commands

  • seedpass --help
  • seedpass
  • seedpass tui2
  • seedpass --legacy-tui
  • seedpass legacy
  • seedpass <group> --help
  • seedpass tui2 --help
  • seedpass tui2 --check
  • seedpass capabilities --format json
  • seedpass agent bootstrap-context