Skip to content

chore(release): npm 公開向けに package を整備#2

Merged
akihidem merged 1 commit into
mainfrom
chore/release-prep
May 11, 2026
Merged

chore(release): npm 公開向けに package を整備#2
akihidem merged 1 commit into
mainfrom
chore/release-prep

Conversation

@akihidem
Copy link
Copy Markdown
Owner

なぜ

v1.0 機能(MCP Tools/Prompts)が main 取り込み済みになり、配布できる段階に入った。これまで private: true 前提だった metadata と CLI エントリを公開向けに揃え、npm publish + GitHub public 化を実行できる状態を作るのが本 PR の目的。

何を

  • package.json: private 解除、repository/bugs/homepage/keywords/author/license/files/prepublishOnly を追加。
  • bin/cogsync.js: tsx/esmtsImportsrc/index.ts を直接起動するラッパー(#!/usr/bin/env node)。tsxdependencies へ昇格。
  • README.md: 公開向けに再構成(Install / Quickstart / MCP 登録 / Commands / 開発手順)。private 前提の記述を削除。
  • CHANGELOG.md 新設(Keep a Changelog 形式、v0.1〜v1.0)。
  • .github/workflows/ci.yml: Node 20/22 で typecheck + test
  • src/index.ts: --version1.0.0-alpha.0 に同期。

設計判断

  • ビルドステップ追加は α 中は避け、tsx/esmtsImport API で .ts を直接実行する形を採用した。stable 化のタイミングで tsc emit に乗り換える前提。
  • 配布物に src/ を含めて tarball 45.8kB(32 files)。LICENSE/CHANGELOG/README 同梱。
  • 公開直後は npm publish --tag alpha を想定。利用者は npm install -g cogsync-cli@alpha でインストール。latest は安定版で確定。

スコープ外

  • 安定版(1.0.0)昇格・latest タグ publish。
  • repo public 化・GitHub Release 作成(本 PR マージ後の別作業)。
  • tsc emit ベースの本格ビルド導入(v1.x の課題)。

検証方法

  • npm run typecheck — pass
  • npm test — 10/10 pass
  • node bin/cogsync.js --help / --version — 正常起動
  • npm pack --dry-run — 32 files / 45.8 kB、bin・src・LICENSE 同梱

依存

なぜ:
- v1.0 機能 (MCP Tools/Prompts) が main 取り込み済みになり、配布できる段階に入った。
- これまで private 前提だった metadata と CLI エントリを公開向けに揃え、npm + GitHub public へ昇格できる状態を作る。

何を:
- package.json: `private` 解除、`repository`/`bugs`/`homepage`/`keywords`/`author`/`license`/`files`/`prepublishOnly` 追加。
- bin/cogsync.js: `tsx/esm` の tsImport で src/index.ts を直接起動するラッパー (`#!/usr/bin/env node`)。tsx を runtime 依存へ昇格。
- README: 公開向けに再構成(Install / Quickstart / MCP 登録 / Commands / 開発手順)。private 表記削除。
- CHANGELOG.md: Keep a Changelog 形式で v0.1〜v1.0 を記録。
- .github/workflows/ci.yml: Node 20/22 で typecheck + test。
- src/index.ts: `--version` を 1.0.0-alpha.0 に同期。

設計判断:
- ビルドステップ追加は α 中は避け、`tsx/esm` の tsImport API で `.ts` を直接実行する形を採用。配布物に src/ を含めて size 45.8kB に収まる。
- 公開直後は `--tag alpha` での publish を想定(npm install -g cogsync-cli@alpha)。stable は実利用フィードバック後。

スコープ外:
- 安定版(1.0.0)昇格・stable npm publish。
- repo public 化・GitHub Release(PR マージ後の別作業)。

検証方法:
- npm run typecheck: pass
- npm test: 10/10 pass
- node bin/cogsync.js --help / --version: 正常起動
- npm pack --dry-run: 32 files / 45.8kB、bin・src・LICENSE 同梱を確認

依存:
- 既存 main (PR #1 マージ済み)
@akihidem akihidem merged commit b6849be into main May 11, 2026
2 checks passed
@akihidem akihidem deleted the chore/release-prep branch May 11, 2026 02:49
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