@guardsmith/cli 0.2.1 → 0.3.0

package/README.ja.md

@@ -0,0 +1,102 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/novexar/Guardsmith/main/assets/logo.png" width="96" alt="GuardSmith logo">
+</p>
+
+<h1 align="center">@guardsmith/cli</h1>
+
+<p align="center">
+  すべてのリポジトリに同じ AI 開発標準を配り、守られているかを<b>機械検証</b>する。<br>
+  <a href="https://github.com/novexar/Guardsmith">GuardSmith</a> の <code>guard</code> コマンド。
+</p>
+
+<p align="center">
+  <a href="https://github.com/novexar/Guardsmith/blob/main/packages/cli/README.md">English</a> | 日本語
+</p>
+
+---
+
+GuardSmith は AI 開発標準(`CLAUDE.md`・agents・skills)を、ESLint がコードスタイルを
+扱うのと同じ方法——**配布できる config + linter**——で扱います。本パッケージはその CLI です。
+
+Node.js 20+ が必要です。
+
+## インストール
+
+```bash
+npx @guardsmith/cli <command>      # 単発実行
+# または
+pnpm add -D @guardsmith/cli        # PJ ごとに導入。以後: pnpm guard <command>
+```
+
+## クイックスタート
+
+```bash
+# 新規プロジェクト — 標準マスターから展開
+# (CLAUDE.md・agents・skills・docs・Docker ローカル CI・デザイン仕様)
+npx @guardsmith/cli new my-project
+
+# 既存プロジェクト — ポリシーファイルのみ生成
+npx @guardsmith/cli init
+
+# 検証 (exit 1 = 違反あり: 未初期化テンプレ、
+# 契約見出しの破壊、資格情報の混入、drift など)
+npx @guardsmith/cli lint
+
+# 標準マスターからの乖離(drift)を表示し、復元する
+npx @guardsmith/cli sync           # dry-run
+npx @guardsmith/cli sync --write   # 復元(PJ 固有セクションは保全)
+
+# ルールの説明 / バージョン表示
+npx @guardsmith/cli explain claude-md/thin-diff
+npx @guardsmith/cli version
+```
+
+`guard new` の後は Claude Code でプロジェクトを開いてください — 同梱の `init-project`
+スキルがインタビューを行い、テンプレートを具体化します。初期化が本当に完了すると
+`guard lint` が PASS します。
+
+## ポリシーの要点
+
+```yaml
+# guard.policy.yaml
+version: 1
+target: claude-code
+extends:
+  - github:novexar/guardsmith//presets/baseline.yaml@v0.5.1 # tag pinning is mandatory
+  # Projects with a frontend also add:
+  # - github:novexar/guardsmith//presets/frontend.yaml@v0.5.1
+rules: [] # add or override (redefining an id overrides it)
+exemptions: [] # time-boxed waivers: reason + approved_by + expires required
+```
+
+`extends` は OSS baseline → private 組織 overlay → PJ ごとのポリシー、と合成されます。
+private リポジトリは `GITHUB_TOKEN` 環境変数で取得されるため、組織固有ルールが
+GitHub の外に出ることはありません。期限切れの例外(exemption)は error として表面化します
+— 黙って永久に免除されることはありません。
+
+## CI での強制
+
+[GuardSmith Lint Action](https://github.com/marketplace/actions/guardsmith-lint) を
+workflow に 1 行追加:
+
+```yaml
+- uses: novexar/Guardsmith@v0.5.1
+```
+
+違反した PR はサマリコメントと SARIF レポート付きで失敗します。閉域網などの環境では
+[GitHub Releases](https://github.com/novexar/Guardsmith/releases) に添付された
+自己完結バンドルのみで実行できます(`source: release` / `node guard.mjs`)—
+npm レジストリへのアクセスは不要です。
+
+## ドキュメント
+
+- はじめに・コンセプト: https://github.com/novexar/Guardsmith
+- 3層ポリシー設計: https://github.com/novexar/Guardsmith/blob/main/docs/LAYERING.ja.md
+- 標準更新への追随(リリースごとのチェックリスト): https://github.com/novexar/Guardsmith/tree/main/docs/migration
+
+## ライセンス
+
+Apache-2.0
+
+サードパーティライセンス: 依存パッケージは npm 経由で各自のライセンスに従います。
+オフライン用リリースバンドルには `THIRD-PARTY-NOTICES.md` を同梱しています。

package/README.md

@@ -0,0 +1,102 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/novexar/Guardsmith/main/assets/logo.png" width="96" alt="GuardSmith logo">
+</p>
+
+<h1 align="center">@guardsmith/cli</h1>
+
+<p align="center">
+  Ship the same AI coding standards to every repository — and <b>machine-verify</b> they are followed.<br>
+  The <code>guard</code> command of <a href="https://github.com/novexar/Guardsmith">GuardSmith</a>.
+</p>
+
+<p align="center">
+  English | <a href="https://github.com/novexar/Guardsmith/blob/main/packages/cli/README.ja.md">日本語</a>
+</p>
+
+---
+
+GuardSmith treats AI development standards (`CLAUDE.md`, agents, skills) the way ESLint
+treats code style: **a distributable config plus a linter**. This package provides the CLI.
+
+Requires Node.js 20+.
+
+## Install
+
+```bash
+npx @guardsmith/cli <command>      # one-off
+# or
+pnpm add -D @guardsmith/cli        # per project, then: pnpm guard <command>
+```
+
+## Quick start
+
+```bash
+# New project — scaffold from the standards master
+# (CLAUDE.md, agents, skills, docs, Docker-based local CI, design spec)
+npx @guardsmith/cli new my-project
+
+# Existing project — generate the policy file only
+npx @guardsmith/cli init
+
+# Verify (exit 1 = violations found: uninitialized templates,
+# broken contract headings, leaked credentials, drift, ...)
+npx @guardsmith/cli lint
+
+# Show drift against the standards master, then repair it
+npx @guardsmith/cli sync           # dry-run
+npx @guardsmith/cli sync --write   # restore (project-owned sections are preserved)
+
+# Explain a rule / show versions
+npx @guardsmith/cli explain claude-md/thin-diff
+npx @guardsmith/cli version
+```
+
+After `guard new`, open the project with Claude Code — the bundled `init-project` skill
+interviews you and concretizes the templates. `guard lint` passes once initialization
+is genuinely complete.
+
+## Policy in a nutshell
+
+```yaml
+# guard.policy.yaml
+version: 1
+target: claude-code
+extends:
+  - github:novexar/guardsmith//presets/baseline.yaml@v0.5.1 # tag pinning is mandatory
+  # Projects with a frontend also add:
+  # - github:novexar/guardsmith//presets/frontend.yaml@v0.5.1
+rules: [] # add or override (redefining an id overrides it)
+exemptions: [] # time-boxed waivers: reason + approved_by + expires required
+```
+
+`extends` composes OSS baseline → private organization overlay → per-project policy.
+Private repositories are fetched with the `GITHUB_TOKEN` environment variable, so
+organization-specific rules never leave your GitHub. Expired exemptions surface as
+errors — nothing is waived silently forever.
+
+## CI enforcement
+
+Add one line to your workflow using the
+[GuardSmith Lint Action](https://github.com/marketplace/actions/guardsmith-lint):
+
+```yaml
+- uses: novexar/Guardsmith@v0.5.1
+```
+
+Violating PRs fail with a summary comment and a SARIF report. Air-gapped environments can
+run entirely from the self-contained bundle attached to
+[GitHub Releases](https://github.com/novexar/Guardsmith/releases) (`source: release` /
+`node guard.mjs`) — no npm registry access required.
+
+## Documentation
+
+- Getting started & concepts: https://github.com/novexar/Guardsmith
+- 3-layer policy design: https://github.com/novexar/Guardsmith/blob/main/docs/LAYERING.md
+- Upgrading standards (per-release checklist): https://github.com/novexar/Guardsmith/tree/main/docs/migration
+
+## License
+
+Apache-2.0
+
+Third-party licenses: dependencies carry their own licenses via npm; the offline release
+bundle ships with a `THIRD-PARTY-NOTICES.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guardsmith/cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "GuardSmith CLI — the guard binary (init / lint / sync / new / explain)",
   "license": "Apache-2.0",
   "repository": {
@@ -19,6 +19,6 @@
     "bin"
   ],
   "dependencies": {
-    "@guardsmith/core": "^0.2.1"
+    "@guardsmith/core": "^0.3.0"
   }
 }