Skip to content

docs: audit four more guides against the code - #124

Merged
pavancharak merged 1 commit into
mainfrom
docs/audit-guides-2
Oct 2, 2026
Merged

pavancharak merged 1 commit into
mainfrom
docs/audit-guides-2

Conversation

@pavancharak

Copy link
Copy Markdown
Owner

What

Page by page audit, batch 7: four guides integrators use most, checked against the code on 2026-10-02.

Real errors fixed:

  • Connect an agent: the response table said 200 means authorized with dispatch after, and that a missing connector is an approved 500. A 200 is returned only after the action ran and its Trust Record was signed; a missing connector is 503 CONNECTOR_NOT_REGISTERED. Table rewritten with 429, 502, 503, 500 EXECUTION_RECORD_INCOMPLETE and the G-84 timeout advice. The repo copy docs/connectors/CONNECTING_AN_AGENT.md had drifted with the same errors; it is now a pointer to this page (references to it still resolve).
  • Live API and demos: listed a production demo key with "*"; production keys were rebuilt on 2026-09-27 and 2026-09-30 and there is no demo key (the sandbox has one). Said no Trust Record can be fetched; executed Paytm refunds have one. Key example now scoped, not "*".
  • Write your first policy: the documented reject path (financeDirectorApproved: false) no longer rejects, because the tutorial attaches the director's approval. Replaced with vendorVerified: false, run and quoted.
  • Deploy patterns: said PARMANA_STORAGE=postgres throws; it uses the same implementation as supabase (G-57). Added DATABASE_URL and migrations, scoped agent keys, Vercel redeploy for key changes.

Not verified: which connector credentials production has today (the Vercel token here cannot read the project); the live API page states it as of the operator's 2026-09-30 check and says how to confirm.

🤖 Generated with Claude Code

Checked on 2026-10-02; tutorial 14 run again, approve and reject paths.

- Connect an agent: response table rewritten from the server (200 means
  executed; 429, 502, 503 and 500 codes; timeout advice from G-84); a
  missing connector is 503, not an approved 500; the repo copy
  docs/connectors/CONNECTING_AN_AGENT.md becomes a pointer, so there is
  one copy.
- Live API and demos: production has no demo key (keys rebuilt
  2026-09-27 and 2026-09-30); executed actions do have Trust Records;
  scoped key example instead of "*".
- Write your first policy: the documented reject recipe no longer
  rejected (the tutorial always attaches the approval); replaced with
  vendorVerified false, run and quoted.
- Deploy patterns: PARMANA_STORAGE=postgres works (same implementation
  as supabase, G-57) instead of throwing; DATABASE_URL and migrations;
  agent keys need allowed capabilities; Vercel redeploy for key changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
parmana-api-real Ready Ready Preview Oct 2, 2026 10:55am UTC
parmana-sandbox Ready Ready Preview Oct 2, 2026 10:55am UTC

@mintlify

mintlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
parmanasystems 🟢 Ready View Preview Oct 2, 2026, 10:54 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

3 active deployments
Preview – parmana-api-real — d14318bc Deployed Oct 2, 2026 by vercel[bot]
Preview – parmana-sandbox — d14318bc Deployed Oct 2, 2026 by vercel[bot]
staging - docs/site — d14318bc Deployed Oct 2, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant