Skip to content

docs(forest-runtime): schema CREATE privilege + version-pinned npm info - #20

Merged
Scra3 merged 1 commit into
mainfrom
docs/forest-runtime-schema-privileges
Jul 29, 2026
Merged

docs(forest-runtime): schema CREATE privilege + version-pinned npm info#20
Scra3 merged 1 commit into
mainfrom
docs/forest-runtime-schema-privileges

Conversation

@Scra3

@Scra3 Scra3 commented Jul 29, 2026

Copy link
Copy Markdown
Member

Addresses two review comments left on #18 (they targeted forest-runtime.mdx, which the #18 rebase moved out of that PR — the text now lives on main via #19).

  • Schema privileges — creating the dedicated forest schema requires the CREATE privilege on the database; a role with table rights in an existing schema can't create one, so agent.start() would fail. Documented the fallback: an administrator pre-creates the schema and grants access — the executor probes pg_namespace before creating (see schema-migrations.ts), so schema-level privileges are then enough.
  • npm info version — bare npm info @forestadmin/agent peerDependencies answers for latest, whose executor pin may differ from the agent you run; now npm info @forestadmin/agent@<your-agent-version> peerDependencies.

🤖 Generated with Claude Code

Note

Document CREATE privilege requirement and version-pinned npm query for forest-runtime

  • Updates peer dependency install guidance in forest-runtime.mdx to query npm using @forestadmin/agent@<your-agent-version> peerDependencies, clarifying that npm defaults to latest if no version is specified.
  • Adds a paragraph in the Note block documenting that the executor needs CREATE privilege to create the dedicated forest Postgres schema, that existence is checked before creation, and that schema-level privileges suffice if the schema is pre-created.

Macroscope summarized e0906fb.

… in npm info

Review feedback: creating the dedicated schema needs database-level CREATE, so
document the pre-created-schema fallback (the executor probes pg_namespace before
creating, so schema-level privileges suffice then). Also query peerDependencies
for the installed agent version — bare 'npm info' answers for latest, whose
executor pin may differ.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
forest 🟢 Ready View Preview Jul 29, 2026, 8:54 AM

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

@Scra3
Scra3 merged commit fff3dfe into main Jul 29, 2026
2 checks passed
@mintlify

mintlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
forest 🟡 Building Jul 29, 2026, 8:53 AM

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

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