chore(release): npm 公開向けに package を整備#2
Merged
Merged
Conversation
なぜ: - 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
added a commit
that referenced
this pull request
Jul 2, 2026
cogsync 本体 v0.3 §9 E5（繰延で deep 中の割り込み 3.8→0 回/週、代償の handback 遅延は平均 16 分）の実装翻訳 #2。凍結仕様: docs/BRIEF-notify-defer.md - notify/defer.ts: DeferQueue（enqueue は同 key を後着 vars で置換しつつ queuedAt は 初回時刻を保持／drainDue は「境界越えで全件送信・maxDeferMin 超過で安全弁送信・24h TTL 超で破棄」）、 isDeferralActive（保護フェーズ×新鮮のみ true・config 壊れても Array ガードで false）、 buildDeliveries（2 件以上は deferred_digest 1 通に集約）。時刻は全て now 注入 - 繰延対象は戦略系のみ（weekly_pace_exceeded / snowball_detected）。時間クリティカル系 （limit/burn）・中断が目的の deepwork_cap・pomodoro/運用系は即時のまま - watch: drain→fired/cooldown 登録→advice→enqueue の順。fired/cooldown は「送信時」登録 （投入時に登録すると TTL 破棄された通知が永久に消える）。キューは state.json に永続化 - config: notify.deferDuringPhases（既定 design/implement）・maxDeferMin（既定 60） - cogsync status に保留件数（--json は deferredCount）。desktop に deferred_digest テンプレ - 配送はイベントベース（deep 中に発火したものを境界で振り返る）。条件解消の追い出しは advise が 1 tick 1 件のため単独観測不能→意味論として固定・陳腐化は安全弁で上限 検品: builder=Opus(Sonnet がセッション上限で落ち引き取り)→L0 108 テスト緑+typecheck ＋watch --once で enqueue/drain 両パスを実機スモーク→codex review 2round （queuedAt リセットで安全弁死・config クラッシュ面・README 重複を裁定反映）→VERDICT: PASS Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
なぜ
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/esmのtsImportでsrc/index.tsを直接起動するラッパー（#!/usr/bin/env node）。tsxをdependenciesへ昇格。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:--versionを1.0.0-alpha.0に同期。設計判断
tsx/esmのtsImportAPI で.tsを直接実行する形を採用した。stable 化のタイミングでtscemit に乗り換える前提。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。tscemit ベースの本格ビルド導入（v1.x の課題）。検証方法
npm run typecheck— passnpm test— 10/10 passnode bin/cogsync.js --help/--version— 正常起動npm pack --dry-run— 32 files / 45.8 kB、bin・src・LICENSE 同梱依存