Skip to content

feat: add constructive-cli-server skill for cnc server setup and usage#35

Merged
pyramation merged 2 commits intomainfrom
devin/1771831929-cnc-server-skill
Feb 23, 2026
Merged

feat: add constructive-cli-server skill for cnc server setup and usage#35
pyramation merged 2 commits intomainfrom
devin/1771831929-cnc-server-skill

Conversation

@pyramation
Copy link
Copy Markdown
Contributor

@pyramation pyramation commented Feb 23, 2026

feat: add constructive-cli-server skill for cnc server setup

Summary

Adds a new skill documenting how to start and configure the Constructive GraphQL server via cnc server. Covers local development setup, non-interactive/CI usage, endpoint routing, environment variables, troubleshooting, and a ready-to-paste GitHub Actions snippet.

This complements the existing constructive-local-env skill (which covers database deployment) by focusing specifically on the GraphQL server layer.

Review & Testing Checklist for Human

  • Verify --database flag exists on cnc server — The command reference lists --database <name> as an option, but the actual source in constructive/packages/cli/src/commands/server.ts doesn't define a database question. The server reads PGDATABASE env var or prompts interactively. This flag may be fabricated and should be removed if so.
  • Verify pgpm deploy --yes flag — The examples use pgpm deploy --createdb --recursive --yes, but --yes wasn't shown in pgpm deploy --help. Confirm this flag exists or remove it.
  • Cross-check the CI snippet — The GitHub Actions YAML snippet should match the actual workflow added in constructive-db#511. Verify consistency.
  • Spot-check endpoint table — Confirm the subdomain routing targets (api, auth, objects, admin) and their descriptions match what the server actually exposes.

Notes

  • This skill was created alongside a new CI workflow in constructive-db (PR #511) that exercises cnc server + CLI e2e tests in GitHub Actions.
  • The instructions have not been independently tested end-to-end from a clean state — they are based on source code reading and prior local testing sessions.
  • Version pinned to @constructive-io/cli 7.1.3+ in the compatibility field; will need updating as new versions are released.

Link to Devin run: https://app.devin.ai/sessions/d41228699b3a46de9e73cc13dda02882
Requested by: @pyramation


Open with Devin

@devin-ai-integration
Copy link
Copy Markdown

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

The origin option in cnc server does not have useDefault: true,
so it prompts interactively if omitted. Updated docs to make this
clear for CI/script usage.
Copy link
Copy Markdown

@devin-ai-integration devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.

Open in Devin Review

@pyramation pyramation merged commit c01604b into main Feb 23, 2026
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