# info.description
Read-only public APIs for identity, site status, task routing, and the Witness archive.

# paths./.well-known/agent.json.get.summary
Read the public agent discovery contract.

# paths./llms.txt.get.summary
Read the concise AI/tool operating brief.

# paths./schemas/public-task.schema.json.get.summary
Read the JSON Schema for safe public task packets.

# paths./schemas/public-task.schema.json.get.responses.200.description
JSON Schema for public task handoff packets.

# paths./api/capabilities.get.summary
List public site capabilities and safe entry points.

# paths./api/compatibility.get.summary
Read the compatibility map for future public tools.

# paths./api/protocol.get.summary
Read the canonical public task operating protocol.

# paths./api/release.get.summary
Read deployment and public contract proof for the current release.

# paths./api/autonomy.get.summary
Read the bounded autonomy control plane.

# paths./api/autonomy/action-plan.get.summary
Prepare a safe autonomy action plan without executing it.

# paths./api/autonomy/action-plan.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/autonomy/decision.get.summary
Classify a public task into a safe autonomy lane.

# paths./api/autonomy/decision.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/autonomy/evaluation.get.summary
Score the live autonomy layer and name its current boundary.

# paths./api/autonomy/evaluation.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/autonomy/loop.get.summary
Read the complete bounded autonomy loop for a public request.

# paths./api/autonomy/loop.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/autonomy/mission.get.summary
Read one compact autonomy mission-control snapshot.

# paths./api/autonomy/mission.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/autonomy/receipts.get.summary
Read the public autonomy receipt contract.

# paths./api/autonomy/runbook.get.summary
Read the bounded autonomy recovery runbook.

# paths./api/autonomy/runbook.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/autonomy/state.get.summary
Read the compact autonomy state snapshot and next safe action.

# paths./api/autonomy/state.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/me.get.summary
Read Mahesh's public machine-readable identity.

# paths./api/task-router.get.summary
Resolve a public visitor or tool task into a safe route.

# paths./api/task-router.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/task-packet.get.summary
Return a schema-shaped public task packet for safe tool handoff.

# paths./api/task-packet.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/vasuki/skills.get.summary
Resolve a visitor request into an allowed Vasuki skill.

# paths./api/vasuki/skills.get.parameters[].description
Optional public task or Witness question to route.

# paths./api/witness.get.summary
Read the machine-readable Witness archive.

# paths./api/witness.get.parameters[].description
Send the archive ETag to receive 304 when unchanged.

# paths./api/witness.get.responses.304.description
Witness archive is unchanged for the supplied ETag.

# paths./api/witness/resolve.get.summary
Resolve a Witness-specific question into the best public next step.

# paths./api/witness/resolve.get.parameters[].description
Optional public task or Witness question to route.

# tags[].description
Bounded autonomy, guardrails, and approval boundaries.

# tags[].description
Public identity and interface information.

# tags[].description
Public Vasuki skill registry and resolver.

# x-operating-protocol.purpose
Give future pages, APIs, assistants, and automations one safe lifecycle for public tasks.

# x-operating-protocol.phases[].goal
Understand the public rules and available interfaces.

# x-operating-protocol.phases[].goal
Resolve the visitor or tool request into one canonical task route.

# x-operating-protocol.phases[].goal
Convert the request into a reusable packet before another tool continues it.

# x-operating-protocol.phases[].goal
Use the domain resolver only after the general task route is clear.

# x-operating-protocol.phases[].requiredOutput
reader path, agent context, or builder direction

# x-operating-protocol.phases[].goal
Check that the result stays public, useful, and traceable.

# x-operating-protocol.extensionRule
Add new public capability by updating the route registry, capability manifest, compatibility map, task schema, and tests together.

# x-task-execution-policy.purpose
Tell future tools what can be answered automatically, what should guide a human, and what must stop.

# x-task-execution-policy.modes[].rule
Answer or route with public site data only.

# x-task-execution-policy.modes[].rule
Give a next step, page, prompt, or collaboration direction without taking action for the visitor.

# x-task-execution-policy.modes[].rule
Stop before sending, publishing, editing, buying, logging in, deploying, or contacting someone.

# x-task-execution-policy.modes[].rule
Do not infer or request secrets, credentials, phone numbers, addresses, private identity data, or unpublished facts.

# x-autonomy-control-plane.target
99.99% routine public-task autonomy with explicit human approval before external actions.

# x-autonomy-control-plane.purpose
Let Vasuki and future tools observe, route, draft, verify, and prepare tasks while keeping sensitive or external actions approval-gated.

# x-autonomy-control-plane.serviceLevel.objective
Keep public-read autonomy useful, measurable, and safe even when production is stale, integrations are unavailable, or owner approval is required.

# x-autonomy-control-plane.serviceLevel.targets.publicContract
8/8 verifier checks passing before trust

# x-autonomy-control-plane.serviceLevel.targets.publicTaskCoverage
route, packet, decide, plan, verify, receipt

# x-autonomy-control-plane.serviceLevel.targets.ownerBoundary
zero unsupervised writes or external side effects

# x-autonomy-control-plane.serviceLevel.proceedWhen[]
release freshness is proven or the action is read-only against current live behavior

# x-autonomy-control-plane.serviceLevel.waitWhen[]
production is stale for behavior that depends on the latest commit

# x-autonomy-control-plane.serviceLevel.waitWhen[]
receipt durability or rollback evidence is missing

# x-autonomy-control-plane.serviceLevel.stopWhen[]
request asks for secrets, credentials, private facts, payment, login, phone, or address

# x-autonomy-control-plane.serviceLevel.stopWhen[]
request would publish, deploy, send, buy, delete, or mutate state without owner approval

# x-autonomy-control-plane.serviceLevel.stopWhen[]
verifier fails for the public surface being used

# x-autonomy-control-plane.autonomyLevel.meaning
The site can answer public questions, route tasks, assemble packets, and draft next actions; it must stop before sending, publishing, logging in, deploying, buying, or touching private data.

# x-autonomy-control-plane.autonomyLevel.nextCondition
Only promote scheduled routines after monitoring, audit receipts, rollback paths, and owner controls are live.

# x-autonomy-control-plane.maturity[].capability
Human visitors and software can discover Mahesh, the site purpose, and public routes.

# x-autonomy-control-plane.maturity[].capability
Vasuki can route public questions into the right page, API, or reading path.

# x-autonomy-control-plane.maturity[].capability
The site can plan, decide, self-check, and prepare safe next actions without executing risky work.

# x-autonomy-control-plane.maturity[].capability
Scheduled public-read routines can run with visible heartbeat, receipts, and rollback rules.

# x-autonomy-control-plane.maturity[].capability
Write, publish, deploy, or outbound actions stay locked until owner controls and durable receipts exist.

# x-autonomy-control-plane.loop[].output
public site state, deploy status, available APIs

# x-autonomy-control-plane.loop[].output
human-readable answer, draft, or safe next step

# x-autonomy-control-plane.loop[].output
owner decision before external side effects

# x-autonomy-control-plane.actionPlan.purpose
Turn a classified request into an evidence-backed plan with approval, rollback, and verification steps before anything changes.

# x-autonomy-control-plane.loopState.purpose
Show the full observe, decide, plan, verify, and receipt loop for a request without executing external side effects.

# x-autonomy-control-plane.mission.purpose
Give people, Vasuki, and future tools one command surface for state, lane, proof, release freshness, and the next safe move.

# x-autonomy-control-plane.decision.purpose
Classify any public request into the safest lane: run, guide, queue for owner approval, or block.

# x-autonomy-control-plane.heartbeat.cadence
daily public-read heartbeat from Vercel cron, plus on-demand GET checks

# x-autonomy-control-plane.heartbeat.purpose
Let the website emit a safe operating pulse without changing content, sending messages, or touching private data.

# x-autonomy-control-plane.receipts.purpose
Publish the receipt shape and latest public-safe owner-approved write receipts: intent, evidence, approval, result, and verification.

# x-autonomy-control-plane.receipts.currentMode
active for owner-approved publish flows; durable when Redis is configured, memory-only during local fallback

# x-autonomy-control-plane.receipts.storage.fallback
process memory for local and unconfigured runs

# x-autonomy-control-plane.receipts.storage.publicPayload
receipt metadata only; no private request bodies, tokens, or drafts

# x-autonomy-control-plane.runbook.purpose
Give Vasuki and future monitors a safe diagnose, contain, recover, verify, and receipt plan without self-deploying or touching secrets.

# x-autonomy-control-plane.selfCheck.cadence
safe to run on demand; future scheduled checks must remain public-read only

# x-autonomy-control-plane.selfCheck.purpose
Let the site report whether its public autonomy contract is wired, bounded, and ready for future monitored routines.

# x-autonomy-control-plane.selfCheck.passCondition
All public read surfaces are discoverable, risky actions remain approval-gated, and unresolved gaps are named instead of hidden.

# x-autonomy-control-plane.evaluation.purpose
Score the live autonomy layer honestly: what is operational, what is approval-gated, and what remains future work.

# x-autonomy-control-plane.evaluation.passCondition
Advanced only means public-read autonomy with explicit boundaries; it does not claim unsupervised 99.99% execution.

# x-autonomy-control-plane.state.purpose
Give Vasuki, monitors, and future agents one compact state object before they continue, wait, refuse, or ask for owner approval.

# x-autonomy-control-plane.upgradePath[]
Keep monitored scheduled routines public-read only and visible through the heartbeat.

# x-autonomy-control-plane.upgradePath[]
Turn the receipt contract into durable owner-visible receipts for every proposed write.

# x-autonomy-control-plane.upgradePath[]
Add rollback and post-action verification before allowing any publish routine.

# x-autonomy-control-plane.upgradePath[]
Keep private data, credentials, payments, login, and outbound messages outside autonomous mode.