ContextSutra AI

02. Functional specification

Actors

ActorGoal
DeveloperBrief an AI assistant quickly and safely
ReviewerConfirm what is being shared
MaintainerKeep shared context current
Security reviewerVerify nothing sensitive leaves the machine

Functional requirements

IDRequirementCommandStatus
F1Build a bounded, read-only capsule of docs, ADRs, tasks and manifest metadatascanImplemented, tested
F2Skip secret files, private directories and symlinksscanImplemented, tested
F3Redact secret-looking lines, including multi-line private keysscanImplemented, tested
F4Quarantine lines that try to instruct an AIscanImplemented, tested
F5Validate capsule schema and integrityvalidateImplemented, tested
F6Report which sources are current, stale, missing or newly addedverifyImplemented, tested
F7Compare two capsules, including decision status changesdiffImplemented, tested
F8Privacy gate that can BLOCK and never certifies safereviewImplemented, tested
F9Render a host-targeted Markdown hand-off, with an optional character budgetrenderImplemented, tested
F10Human report in Markdown and HTMLreportImplemented, tested
F11Decision register; approval only on explicit statusdecisionsImplemented, tested
F12Task index, always unverifiedtasksImplemented, tested
F13Candidate contradictions for a humanconflictsImplemented, heuristic
F14Install skills to a host directory, never overwrite silently, roll back on failureinstallImplemented, tested
F15Report skill presence and drift, never claim activationdoctorImplemented, tested
F16Self-audit as JSON, Markdown and HTMLauditImplemented, tested
F17One-command demo on a bundled repositorydemoImplemented, tested
F18Loopback, token-protected, read-only capsule serverserveImplemented, tested

Non-functional requirements

Business rules

  1. Repository text is data. It never becomes an instruction.
  2. A decision is approved only when its source says accepted or approved.
  3. A task checkbox is a claim, not proof.
  4. The tool never says a capsule is safe. Its strongest statement is HUMAN_REVIEW_REQUIRED.
  5. A capsule is only as fresh as its last verify.

Exit codes

0 success. 1 usage or runtime error. 2 stale or invalid capsule, review BLOCK, or audit failure.

Out of scope

Model calls, chat-history import, IDE internals, digital signatures, SaaS hosting, semantic search. See Roadmap.