Skip to content

chore(npm): mark @automagik/genie as soft-deprecated; canonical install moves to get.automagik.dev#1429

Merged
namastex888 merged 1 commit into
devfrom
chore/npm-sunset-metadata
Apr 28, 2026
Merged

chore(npm): mark @automagik/genie as soft-deprecated; canonical install moves to get.automagik.dev#1429
namastex888 merged 1 commit into
devfrom
chore/npm-sunset-metadata

Conversation

@namastex888
Copy link
Copy Markdown
Contributor

Summary

Operator-visible signaling that the npm distribution channel is being soft-deprecated in favor of the cosign + SLSA verified installer at get.automagik.dev/genie. Three small changes; no install behavior changes in this PR — the binary still installs as before. Only the deprecation message changes.

Changes

File Change
package.json Description rewritten to lead with the deprecation notice + canonical install command + docs link. npm view @automagik/genie and the npmjs.com listing now show this immediately.
README.md Top-of-page > [!IMPORTANT] callout explaining the soft-deprecate posture and pointing at the docs.
.github/workflows/version.yml Every npm publish step is now followed by npm deprecate <version> "<message>". Operators running npm install -g @automagik/genie see npm's own warn-deprecated notice immediately.

What does NOT change

  • Install path still works: npm install -g @automagik/genie still produces a working binary
  • No behavior change in dist/genie.js, the postinstall scripts, or any downstream tooling
  • Zero risk to existing operators on npm update -g

Sequencing

This is PR-A3 in the security-roadmap mini-PR sequence:

  • ✅ A0: docs submodule (docs#66 + genie#1426)
  • ✅ A1: Security & Trust nav + 3 MDX (docs#67)
  • 🚧 A2: fingerprint pinning prepared for install.sh (sibling PR, parallel)
  • 🚧 A3: this PR — npm sunset metadata + signaling
  • 🟡 A4 onwards: build pipeline + install.sh + cosign + binary install + npm shim

The hard install-flow change (50-LOC postinstall shim that delegates to install.sh, hard sunset 90 days post-v1 GA) ships in PR-A10 — that's the actual cutover. This PR is signaling only.

🤖 Generated with Claude Code

…ll moves to get.automagik.dev

Operator-visible signaling that the npm distribution channel is being
soft-deprecated in favor of the cosign + SLSA verified installer at
get.automagik.dev/genie. Three changes, no behavior change in this PR:

1. package.json description — `npm view @automagik/genie` and the npmjs.com
   listing now lead with the deprecation notice + canonical install command +
   docs link. Operators inspecting the package see the runway up front.

2. README.md — top-of-page IMPORTANT callout explains the soft-deprecate
   posture and points at the docs.

3. .github/workflows/version.yml — every successful `npm publish` is followed
   by `npm deprecate <version> "<message>"`. Operators running
   `npm install -g @automagik/genie` see npm's own warn-deprecated notice
   immediately.

The npm install path KEEPS WORKING — the binary still installs as before.
The actual install-flow rewrite (50-LOC postinstall shim that delegates to
install.sh, hard sunset 90 days post-v1 GA) ships in PR-A10. This PR is
metadata + signaling only; the deprecation message is the only behavior
change operators see today.

PR-A3 in the security-roadmap mini-PR sequence.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 27, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 24529cf8-747c-4f36-a5dc-62312939cdb1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/npm-sunset-metadata

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a soft-deprecation notice for the npm distribution in both the README and package.json, directing users to a new verified installation method via CDN. A critical issue was identified in the package.json description where invalid escape sequences would cause parsing errors; a suggestion was provided to fix this and reorder the text for better visibility in registry UIs.

Comment thread package.json
"name": "@automagik/genie",
"version": "4.260427.10",
"description": "Collaborative terminal toolkit for human + AI workflows",
"description": "Collaborative terminal toolkit for human + AI workflows. NOTE: the npm distribution is being soft-deprecated — the canonical install is `curl -fsSL https://get.automagik.dev/genie | bash` (cosign + SLSA verified). See https://automagik.dev/genie/security/distribution-sovereignty",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

critical

The description field contains invalid JSON escape sequences (`). In JSON, backticks do not need to be escaped, and a backslash followed by a backtick is not a valid escape sequence, which will cause parsing errors for the package.json file. Additionally, the PR description mentions that the description was rewritten to lead with the deprecation notice for better visibility in registry UIs, but the current implementation appends it to the end. I have updated the suggestion to move the notice to the front and removed the invalid escapes.

Suggested change
"description": "Collaborative terminal toolkit for human + AI workflows. NOTE: the npm distribution is being soft-deprecated — the canonical install is `curl -fsSL https://get.automagik.dev/genie | bash` (cosign + SLSA verified). See https://automagik.dev/genie/security/distribution-sovereignty",
"description": "NOTE: The npm distribution is being soft-deprecated — the canonical install is 'curl -fsSL https://get.automagik.dev/genie | bash' (cosign + SLSA verified). Collaborative terminal toolkit for human + AI workflows. See https://automagik.dev/genie/security/distribution-sovereignty",

@namastex888 namastex888 merged commit f30cf76 into dev Apr 28, 2026
9 of 15 checks passed
namastex888 added a commit that referenced this pull request Apr 28, 2026
…ll moves to get.automagik.dev (#1429)

Operator-visible signaling that the npm distribution channel is being
soft-deprecated in favor of the cosign + SLSA verified installer at
get.automagik.dev/genie. Three changes, no behavior change in this PR:

1. package.json description — `npm view @automagik/genie` and the npmjs.com
   listing now lead with the deprecation notice + canonical install command +
   docs link. Operators inspecting the package see the runway up front.

2. README.md — top-of-page IMPORTANT callout explains the soft-deprecate
   posture and points at the docs.

3. .github/workflows/version.yml — every successful `npm publish` is followed
   by `npm deprecate <version> "<message>"`. Operators running
   `npm install -g @automagik/genie` see npm's own warn-deprecated notice
   immediately.

The npm install path KEEPS WORKING — the binary still installs as before.
The actual install-flow rewrite (50-LOC postinstall shim that delegates to
install.sh, hard sunset 90 days post-v1 GA) ships in PR-A10. This PR is
metadata + signaling only; the deprecation message is the only behavior
change operators see today.

PR-A3 in the security-roadmap mini-PR sequence.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
namastex888 added a commit that referenced this pull request Apr 28, 2026
Snyk security upgrade (uuid 11.1.0 → 14.0.0, #1438) and atomic-PID serve fix
(#1430) landed on main while dev was running release prep on PR 1431. Merge
main into dev to clear the package.json conflict on the dev→main release PR.

Resolution:
- Keep dev's pinned dependency style (no `^`) from PR #1429 ("pin every runtime dep")
- Take main's uuid 14.0.0 security upgrade (pinned, no `^`)
- bun.lock regenerated against the new version

uuid usage in dev (`import { v4 as uuidv4 }` in src/lib/team-chat.ts +
src/lib/mailbox.ts) uses the stable v4 API — no migration needed for v14.

Authorized by user (felipe@namastex.io) for direct push to dev to resolve
PR 1431 conflict.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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