npm は何をしますか?
npm レジストリやアカウントのタスクに使用します:npm whoami、パッケージの可用性確認、パッケージ予約、公開、組織チェック、認証デバッグ。
認証
- 秘密ルールには最初に
one-passwordを使用します。 - シェルツールで
opを直接実行しないでください。 - プライマリアイテム:
npm Registry - steipete - Release Automation(Molty内) - デフォルトでは
OP_SERVICE_ACCOUNT_TOKENを使用します。デスクトップのロック解除は不要です。このアイテムには、有効なレジストリセッション(registry_token)に加え、ユーザー名/パスワード/TOTP のフォールバックが含まれています。 - デスクトップ
npmjsのフォールバックは明示的にのみ使用します:--account my.1password.comを渡して、Molty が利用できずユーザーがフォールバックを希望する場合に限ります。明示的なrelease/publishリクエストは、そのロック解除プロンプトへの同意とみなします。 - 以下の場合は停止して確認します:アイテムが見つからない、アカウント/ボールトがあいまい、認証情報の形式が不正、npm がパッケージアクセスを拒否、要求されたパッケージ/バージョンがリポジトリのリリースターゲットと一致しない。
- npm 認証作業は、1 つの永続的な tmux セッション内で実行します。失敗した場合はそれを再利用します。
- npm 認証は一時的な npmrc に保存し、コマンド実行後に削除します。
- 全てのヘルパーは
scripts/npm-auth.shを共有します:まず保存されたregistry_tokenセッションを使用し、次にscripts/npm-auth-login.mjsによるレジストリログイン(新しい 6 桁の OTP を使用)を試みます。成功したフォールバックセッションは同じアイテムにキャッシュされます。フィールド抽出、レジストリログイン、キャッシュ書き込みは手動で行わないでください。 - 認証情報の選択は、正規のフィールド
id、次にpurpose、次に一意のラベルを優先します。ラベルが重複するだけの一致は拒否されます(レガシーnpmjsは同じラベルのフィールドを保持する場合があります)。 - アドホックな認証付きレジストリコマンドには、
scripts/npm-service.sh -- <npm args...>を使用します。ローカルパッケージの公開にはpublish-package.shを使用します。 - npm 11 のプロンプトパイピングは不安定です。
printf ... | npm login --auth-type=legacyは避けてください。 - npm ログインに
expectを使用することは、必要な場合を除き避けてください。ログにプロンプトがエコーされる可能性があり、間違えやすいです。 - 自動化には、ヘルパーのレジストリ API ログインパス(
npm-profileloginCouch)を優先します。 - 認証情報の形状があいまいな場合、または
npm whoamiが失敗した場合は、停止して正確なフィールドラベルや認証情報の修正を確認してください。これ以上の 1Password アイテムを探索したり、新しい tmux セッションを開始しないでください。
パッケージ公開
パッケージルートから、同じ認証 tmux セッション内で次のコマンドを実行します:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
ヘルパーは、本人確認、既存パッケージバージョンの拒否、新しい OTP を使用した公開、期限切れ OTP の 1 回再試行、レジストリへの可視性の確認、認証ファイルのクリーンアップを行います。
パッケージ予約
同じ tmux セッション内で scripts/reserve-packages.sh を使用します:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two
処理内容:
- Molty の release-automation アイテムを
op経由で 1 回読み取ります - 保存されたレジストリセッションを再利用するか、ユーザー名/パスワード/TOTP から新しく作成します
- 汎用 README 付きの
0.0.0プレースホルダーパッケージを公開します - パッケージごとの公開失敗後も処理を継続します
- ログ内のトークン/OTP を難読化します
- 一時 npmrc/作業ディレクトリをクリーンアップします
注意事項:
- npm は、既に公開された名前と類似している名前を拒否する場合があります。これは認証失敗ではなく、レジストリポリシーの結果として扱います。
- npm 11 では npm CLI のプロンプトパイピングが不安定です。スクリプト化された
npm loginよりも、ヘルパーのレジストリ API ログインパスを優先します。 - スコープ付きパッケージの場合、
npm viewはパッケージが存在していても遅延や 404 を返すことがあります。npm access get status <pkg>を確認してください。publicまたはpreviously published versionsという公開失敗メッセージは、名前が予約済みであることを意味します。