Skip to content

docs: npm publishing runbook + placeholder record - #11

Closed
ihistand wants to merge 1 commit into
restore-postgres-adapterfrom
docs/npm-publishing
Closed

docs: npm publishing runbook + placeholder record#11
ihistand wants to merge 1 commit into
restore-postgres-adapterfrom
docs/npm-publishing

Conversation

@ihistand

Copy link
Copy Markdown
Collaborator

Summary

Records what's already published on the npm registry under the `sqlanvil` org + how real packages will be built and published once Phase 3b/4 land.

Already on npm

Package Version Date Status
`@sqlanvil/cli` `0.0.1` 2026-05-27 placeholder (name reservation)
`@sqlanvil/core` `0.0.1` 2026-05-27 placeholder (name reservation)

Both placeholders print "not yet published" and exit non-zero. Source files were one-shot scaffolds outside the repo (now deleted) — this doc is the audit trail.

Contents

  • npm org details (free tier, public packages only)
  • Already-published placeholders (versions, dates, status)
  • Names to consider claiming later (avoid speculative grabs per npm anti-squatting policy)
  • Real-publish workflow: Bazel tarball build → `docker cp` extract → `npm publish`
  • Version policy (`0.0.x` placeholders, `0.x.y` pre-release, `1.0.0` stable)
  • Future CI automation snippet (GitHub Actions release workflow)
  • 2FA + granular access token guidance for automation

Independent of code stack

Planning doc only, no code changes. Can merge any time; doesn't block the postgres-first-class PR stack, docs site plan, or branch strategy PRs.

Test plan

  • Doc renders as markdown
  • Real publish workflow runs successfully (deferred to Phase 4)

🤖 Generated with Claude Code

Records what's already on the npm registry under the sqlanvil org and
how real packages will be published once Phase 3b/4 land.

Captures:
- npm org sqlanvil (free, public, created 2026-05-27)
- Published placeholders: @sqlanvil/cli@0.0.1, @sqlanvil/core@0.0.1
  (name reservations only — print "not yet published" and exit 1)
- Names to consider claiming later (postgres, supabase, protos,
  unscoped sqlanvil) — avoid speculative grabs (npm anti-squatting)
- Real-publish workflow via Bazel tarball + docker cp
- Version policy (0.0.x placeholders, 0.x.y pre-release, 1.0.0 stable)
- Future CI automation snippet
- 2FA + granular access token guidance

Placeholder package sources themselves were not committed — they were
one-shot scaffolds outside the repo. This doc is the audit trail.
@ihistand

ihistand commented Jun 7, 2026

Copy link
Copy Markdown
Collaborator Author

Superseded: the Postgres reintegration + Dataform→SQLAnvil rename landed on main directly, and the docs moved to the SQLAnvil/docs repo. Closing as part of #12 (stale-branch prune). The one un-migrated draft, gcp_test_project_setup.md, was migrated to SQLAnvil/docs.

@ihistand ihistand closed this Jun 7, 2026
@ihistand
ihistand deleted the docs/npm-publishing branch June 7, 2026 01:45
ihistand added a commit that referenced this pull request Jul 21, 2026
…a post_operations)

Mirrors the agent-skills SKILL.md update: delta #10 expanded with the AI/BI
framing (descriptions/columns persist as catalog comments, join targets named
in column descriptions, PK/FK via post_operations with NOT ENFORCED on
BigQuery targets, uniqueKey/uniqueKeys exclusivity, catalog artifacts, guide
link); delta #9 covers FKs; delta #11 NOT-ENFORCED flag scoped.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01W86VUf4ptKnmhxWoqgA7gb
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