@nojaja/greputil 1.0.0

package/.babelrc

@@ -0,0 +1,7 @@
+{
+    "env": {
+        "test": {
+            "plugins": ["transform-es2015-modules-commonjs"]
+        }
+    }
+}

package/.dependency-cruiser.js

@@ -0,0 +1,89 @@
+module.exports = {
+  forbidden: [
+    {
+      name: 'no-circular',
+      severity: 'error',
+      comment: '循環依存を禁止',
+      from: {},
+      to: {
+        circular: true
+      }
+    },
+    {
+      name: 'no-orphans',
+      severity: 'warn',
+      comment: '未使用ファイルを警告',
+      from: {
+        orphan: true,
+        pathNot: [
+          '(^|/)\\.[^/]+\\.(js|cjs|mjs|ts|json)$',
+          '\\.d\\.ts$',
+          '(^|/)tsconfig\\.json$',
+          '(^|/)(babel|webpack)\\.config\\.(js|cjs|mjs|ts|json)$'
+        ]
+      },
+      to: {}
+    },
+    {
+      name: 'no-deprecated-core',
+      comment: '非推奨のNode.js coreモジュールを禁止',
+      severity: 'warn',
+      from: {},
+      to: {
+        dependencyTypes: [
+          'core'
+        ],
+        path: [
+          '^(punycode|domain|constants|sys|_linklist)$'
+        ]
+      }
+    },
+    {
+      name: 'not-to-deprecated',
+      comment: '非推奨のnpmモジュールを禁止',
+      severity: 'warn',
+      from: {},
+      to: {
+        dependencyTypes: [
+          'deprecated'
+        ]
+      }
+    },
+    {
+      name: 'no-non-package-json',
+      severity: 'error',
+      comment: 'package.jsonに記載されていない依存を禁止',
+      from: {},
+      to: {
+        dependencyTypes: [
+          'npm-no-pkg',
+          'npm-unknown'
+        ]
+      }
+    }
+  ],
+  options: {
+    doNotFollow: {
+      path: 'node_modules'
+    },
+    tsPreCompilationDeps: true,
+    tsConfig: {
+      fileName: './tsconfig.json'
+    },
+    enhancedResolveOptions: {
+      exportsFields: ['exports'],
+      conditionNames: ['import', 'require', 'node', 'default']
+    },
+    reporterOptions: {
+      dot: {
+        collapsePattern: 'node_modules/[^/]+'
+      },
+      archi: {
+        collapsePattern: '^(node_modules|packages|src|lib|app|bin|test|spec)/[^/]+'
+      },
+      text: {
+        highlightFocused: true
+      }
+    }
+  }
+};

package/.eslintignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+coverage/
+*.js
+tests/
+!.eslintrc.cjs

package/.eslintrc.cjs

@@ -0,0 +1,48 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    project: './tsconfig.json'
+  },
+  plugins: ['@typescript-eslint', 'sonarjs', 'jsdoc'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:sonarjs/recommended',
+    'plugin:jsdoc/recommended'
+  ],
+  rules: {
+    'sonarjs/cognitive-complexity': ['error', 10],
+    '@typescript-eslint/no-unused-vars': ['warn'],
+    '@typescript-eslint/no-explicit-any': ['error'],
+    'jsdoc/require-jsdoc': [
+      'error',
+      {
+        require: {
+          FunctionDeclaration: true,
+          MethodDefinition: true,
+          ClassDeclaration: true,
+          ArrowFunctionExpression: false,
+          FunctionExpression: true
+        },
+        contexts: [
+          'TSInterfaceDeclaration',
+          'TSTypeAliasDeclaration'
+        ]
+      }
+    ],
+    'jsdoc/require-param': 'error',
+    'jsdoc/require-returns': 'error',
+    'jsdoc/require-param-type': 'off',
+    'jsdoc/require-returns-type': 'off',
+    'jsdoc/check-tag-names': ['error', { 
+      definedTags: ['処理名', '処理概要', '実装理由'] 
+    }]
+  },
+  env: {
+    node: true,
+    es2022: true
+  }
+};

package/.github/skills/completion-mandatory-quality-gates.md

@@ -0,0 +1,26 @@
+---
+name: completion-mandatory-quality-gates
+description: 作業完了時に必ず品質ゲートを全通過させるためのSkill。ビルド・依存関係チェック・テスト・Lintを例外なく実行し、設定変更や除外を禁止する。
+license: MIT
+compatibility: Agent Skills format (agentskills.io) および GitHub Copilot / Claude / Codex に対応
+metadata:
+  author: nojaja
+  version: "1.0.0"
+allowed-tools: Read Write Bash
+---
+
+# 作業完了時の強制品質ゲート Skill
+
+本Skillは、作業完了タイミングで必ず以下の品質ゲートを**設定変更・除外なし**で実行し、全て成功させることをエージェントに強制します。いずれかをスキップ・省略・設定変更することを禁止します。
+
+## 必須実行コマンド（順不同可、全て成功が条件）
+- `npm run build`
+- `npm run depcruise`
+- `npm run test`
+- `npm run lint`
+
+## 運用ルール
+- 各ゲートの設定を変更してはならない（閾値・対象・オプションの調整禁止）。
+- いかなる理由でも実行対象からの除外・スキップを禁止する。
+- 実行結果は成功が確認できるまで対応を継続し、失敗時は設定を変えずに修正して再実行する。
+- 作業完了の宣言は、上記4コマンドが全て成功した後のみ行うこと。

package/.github/skills/nodejs-project-quality-guardrails.md

@@ -0,0 +1,417 @@
+---
+name: nodejs-project-quality-guardrails
+description: Defines reusable quality assurance guardrails for Node.js/TypeScript projects, including testing coverage, linting, documentation, design principles, and CI gating. Use when generating or modifying project code to ensure consistent high quality.
+license: MIT
+compatibility: Designed for AI agents that support Agent Skills format (agentskills.io specification) and GitHub Copilot / Claude / Codex agents
+metadata:
+  author: nojaja
+  version: "1.0.0"
+allowed-tools: Read Write Bash
+---
+
+# Node.js/TypeScript プロジェクト 品質担保ガードレール Skill
+
+このスキルは、Node.js（TypeScript）プロジェクトの品質担保のために
+**一貫したテスト、静的解析、ドキュメント、設計ルール、CI 条件** を
+AI エージェント（GitHub Copilot / Claude / OpenAI Codex）に理解させ、
+**生成・修正・レビュー作業** に常に適用させることを目的とします。
+
+## このスキルを使うべきタイミング
+
+- 新規機能のコードを生成する際
+- 既存コードをリファクタリングする際
+- Unit テスト追加や修正書き換えを行う際
+- CI 周りの構成や静的解析指摘を修正する際
+- プロジェクト全体の品質ルールをエージェントに認識させたい場合
+- 1 つのワークスペースに複数プロジェクトがある場合は、各プロジェクトごとに本スキルで示す構成（docs/typedoc-md、src、test/unit・e2e、.dependency-cruiser.js、eslint.config.cjs、jest.unit.config.js、jest.e2e.config.js、typedoc.js など）を持たせ、プロジェクト単位で適用・監査すること
+
+---
+
+## 品質担保ルール概観
+
+### 1. 単体テスト
+- Jest + ts-jest を利用する
+- カバレッジを 80%以上 にする
+- テスト対象は unit テストが主、E2E は補助的に扱う
+- CI では `npm run test:ci` を定義し `jest --coverage` を実行する
+- coverageThreshold で 80% 未満ならエラー扱いとし必ず失敗させる
+
+### 2. ドキュメント生成
+- typedoc + typedoc-plugin-markdown を使う
+- Markdown 出力先: `docs/typedoc-md/`
+- public API のみ対象
+
+### 3. 静的解析
+- ESLint（flat-config）
+  - TypeScript, sonarjs, jsdoc 最小構成
+- dependency-cruiser を使い依存関係ルールを強制
+
+---
+
+## 実装設計原則
+
+### DI（Dependency Injection）
+- DIコンテナは使わない
+- 外部依存の差し替えは Jest のモック で対応
+
+> ⚠ DI は避けるが、外部アクセス用ラッパーの差し替えは許容（DI コンテナを使わないという意味での「DI 回避」）
+
+### 外部アクセス設計
+- ファイルI/O や外部API は必ず ラッパー経由
+- ラッパーはシングルトン & モック可能
+
+### クラス設計とインスタンス管理
+- SRP（単一責務）を最優先
+- 共通基底クラスは乱用しない
+- 明確な共有状態が必要な場合のみ Singleton を使用可
+- Singleton は状態を限定し、テストで差し替え可能にする
+
+### SOLID & フォルダ構成
+- SRP, DIP を満たす設計
+- フォルダ構成は責務が分かる形に
+
+### コードライフサイクル
+- フェールバックや後方互換・マイグレーションは考慮しない
+- 不要になったコードは コメントアウトせず完全削除
+
+### 使用言語
+- TypeScript のみ
+- 設定ファイル用途のみ `.js / .cjs` を許可
+- 作業完了条件: `npm run test` と `npm run build` が成功していること
+
+---
+
+## 成果物として必須なもの
+
+- 単体テスト（Jest + ts-jest）: カバレッジ 80%以上
+- 静的解析: ESLint / dependency-cruiser
+- API ドキュメント: typedoc → Markdown 出力
+
+---
+
+## プロジェクト構成（期待形）
+
+```
+プロジェクトフォルダ/
+├─ docs/
+│  └─ typedoc-md/              # typedoc Markdown 出力
+├─ src/                        # 本体ソース
+├─ test/
+│  ├─ unit/                    # 単体テスト（Jest）
+│  └─ e2e/                     # E2E テスト
+├─ .dependency-cruiser.js      # dependency-cruiser 設定
+├─ eslint.config.cjs           # ESLint flat-config
+├─ jest.unit.config.js         # Jest unit 設定
+├─ jest.e2e.config.js          # Jest E2E 設定
+└─ typedoc.js                  # typedoc 設定
+```
+
+---
+
+## テストカバレッジ & CI ゲート
+
+- `npm run test:ci` で `jest --coverage` を実行し、coverage 80% 未満は失敗
+- `npm run lint` で ESLint を実行し、エラーがあれば CI を失敗させる
+- `npm run depcruise` の違反があれば CI を失敗させる
+
+---
+
+## CI/品質ゲート要件
+
+1. `npm run test` が成功すること
+2. `npm run lint` がエラーを出さないこと
+3. `npm run depcruise` が違反なし
+4. `npm run build` が成功しバンドル生成されること
+
+---
+
+## ESLint ルール / 必須条件
+
+- Cognitive Complexity ≤ 10
+
+```js
+// eslint.config.cjs
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:sonarjs/recommended',
+    'plugin:jsdoc/recommended'
+  ],
+  plugins: ['sonarjs', 'jsdoc'],
+  rules: {
+    'sonarjs/cognitive-complexity': ['error', 10],
+    'no-unused-vars': ['warn'],
+    'jsdoc/require-jsdoc': [
+      'error',
+      {
+        require: {
+          FunctionDeclaration: true,
+          MethodDefinition: true,
+          ClassDeclaration: true,
+          ArrowFunctionExpression: true,
+          FunctionExpression: true
+        }
+      }
+    ],
+    'jsdoc/require-param': 'error',
+    'jsdoc/require-returns': 'error'
+  }
+};
+```
+- JSDoc コメント必須
+- JSDoc 内で param / returns を記載
+
+---
+
+## typedoc / JSDoc ガイドライン
+
+### JSDoc 必須記載項目
+1. 処理名（短いタイトル）
+2. 処理概要（何をするか）
+3. 実装理由（設計判断）
+
+### 記述方針
+- すべて日本語で記載
+- public / internal を問わず 全 function / method / class / interface に必須
+
+```ts
+/**
+ * 処理名: タスク保存
+ *
+ * 処理概要: WebView から受け取ったタスク差分を永続化する
+ *
+ * 実装理由: ユーザーの編集内容を保存し再起動時に復元するため
+ */
+function saveTasks(...) {}
+```
+
+---
+
+## dependency-cruiser ルール
+
+- レイヤー間の不適切な依存を防止するため `.dependency-cruiser.js` を用意する
+- 依存は interface / contract 経由のみ許可するなど、ルール違反時は CI で失敗させる
+
+---
+
+## テスト & 受け入れ基準
+
+### テスト要件
+- Unit Test: Jest。外部通信・I/O はすべてモック
+- E2E Test: docker-compose で起動し Playwright を使用
+
+### 機能受け入れ条件（例）
+- 入力受入: 100 行の断片データをインポートし UI で編集可能
+- 重複検出: サンプルデータで 80%以上の論理的重複を検出
+- 分解提案: 10 件中 7 件以上で適切な分割候補を提示
+- 状態抽出: 「ユーザー登録」マトリクスから主要状態遷移を自動生成
+- コラボレーション: 複数ユーザーの同時編集を競合なくマージ可能
+
+### 最終ゲート
+- `npm run test` 成功
+- `npm run lint` エラーなし
+- `npm run build` 成功
+- `dist/index.bundle.js` が生成されていること
+
+---
+
+## ルール概要 — Checklist
+
+* Unit テストカバレッジ ≥ 80%
+* ESLint エラーなし（complexity ルール含む）
+* typedoc で Markdown ドキュメント生成
+* CI で全ての品質ゲートを通過
+* 依存関係ルール違反なし
+* TypeScript のみ利用
+* 外部I/O はラッパー経由
+
+---
+
+## 活用例
+
+### 新機能生成時
+* このスキルを読み込ませ、コード生成に従わせる
+* テスト・lint・coverage を常に同一基準で生成
+
+### 既存コード修正時
+* ESLint / type errors を修正
+* テストが不足している場合は追加する
+
+### PR 修正提案時
+* ガイドライン違反を検知し改善案を提示する
+
+## 1. 品質担保のための必須ツール
+
+### 1.1 単体テスト
+- Jest + ts-jest を採用する。
+- テスト対象は unit テストが主、E2E は補助。
+- カバレッジ 80%以上を必須。`npm run test:ci` で `jest --coverage` と coverageThreshold を用いて 80% 未満は失敗させる。
+
+### 1.2 ドキュメント生成
+- typedoc + typedoc-plugin-markdown を使用。
+- 出力形式: Markdown、出力先: `docs/typedoc-md/`。
+- 対象: `src/` 配下の public API のみ。
+
+### 1.3 静的解析
+- ESLint（flat-config、TypeScript/jsdoc/sonarjs の最小構成）。
+- dependency-cruiser（レイヤー間の不正依存を検知し CI で失敗）。
+
+## 2. 実装ルール（品質担保ポリシー）
+
+### 2.1 DI（Dependency Injection）
+- DI コンテナやフレームワークは使用しない。
+- 依存の差し替えは Jest のモック機能で行う。
+- 例外: ファイル I/O、外部サービスは明示的なラッパー層を作成する。
+
+### 2.2 外部依存の扱い
+- 外部アクセスは必ずラッパー経由。
+- ラッパー要件: 単一責務、シングルトン、テスト時にモック可能。
+- DI は避けるが、ラッパーの差し替えは許容（DI コンテナ不使用の意味での DI 回避）。
+
+### 2.3 クラス設計とインスタンス管理
+- SRP（単一責務）を最優先。
+- 共通基底クラスの乱用禁止。
+- 明確な共有状態が必要な場合のみ Singleton を使用可。Singleton は状態が限定的でテストで差し替え可能であること。
+
+### 2.4 設計原則
+- SRP と DIP を常に満たす構成にする。
+- フォルダ構成で責務境界を明確にする。
+
+### 2.5 コードライフサイクル方針
+- フェールバック・後方互換・マイグレーションは考慮しない。
+- 不要コードはコメントアウトせず完全削除。
+
+### 2.6 言語・ビルド制約
+- TypeScript のみ使用。
+- `.js` / `.cjs` は設定ファイル用途のみ許可。
+- `npm run test` と `npm run build` を必ず成功させる。
+
+## 3. 成果物として必須なもの
+- 単体テスト（Jest + ts-jest、カバレッジ ≥ 80%）。
+- 静的解析（ESLint、dependency-cruiser）。
+- API ドキュメント（typedoc → Markdown 出力）。
+
+## 4. プロジェクト構成（期待形）
+
+```
+プロジェクト/
+├─ docs/
+│  └─ typedoc-md/
+├─ src/
+├─ test/
+│  ├─ unit/
+│  └─ e2e/
+├─ .dependency-cruiser.js
+├─ eslint.config.cjs
+├─ jest.unit.config.js
+├─ jest.e2e.config.js
+└─ typedoc.js
+```
+
+## 5. テストカバレッジ & CI ゲート
+- `npm run test:ci`（jest --coverage、80% 未満で失敗）。
+- `npm run lint`（ESLint エラーで失敗）。
+- `npm run depcruise`（dependency-cruiser 依存違反で失敗）。
+
+## 6. ESLint ルール（必須要件）
+
+### 方針
+- 可読性・保守性を重視。
+- 複雑度を機械的に制限。
+- ドキュメント未記載をエラー扱い。
+
+### 必須ルール
+- Cognitive Complexity ≤ 10。
+- JSDoc 必須（param / returns 必須）。
+
+```js
+// eslint.config.cjs
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:sonarjs/recommended',
+    'plugin:jsdoc/recommended'
+  ],
+  plugins: ['sonarjs', 'jsdoc'],
+  rules: {
+    'sonarjs/cognitive-complexity': ['error', 10],
+    'no-unused-vars': ['warn'],
+
+    'jsdoc/require-jsdoc': [
+      'error',
+      {
+        require: {
+          FunctionDeclaration: true,
+          MethodDefinition: true,
+          ClassDeclaration: true,
+          ArrowFunctionExpression: true,
+          FunctionExpression: true
+        }
+      }
+    ],
+    'jsdoc/require-param': 'error',
+    'jsdoc/require-returns': 'error'
+  }
+};
+```
+
+## 7. typedoc / JSDoc ルール
+
+### 基本方針
+- すべて日本語で記載。
+- public / internal を問わず全 function / method / class / interface に必須。
+
+### 必須記載項目
+1. 処理名（短いタイトル）
+2. 処理概要（何をするか）
+3. 実装理由（なぜ必要か・設計判断）
+
+```ts
+/**
+ * 処理名: タスク保存
+ *
+ * 処理概要:
+ * WebView から受け取ったタスク差分を永続化する
+ *
+ * 実装理由:
+ * ユーザーの編集内容をワークスペースに保存し、
+ * 再起動後に状態を復元する必要があるため
+ */
+function saveTasks(...) {}
+```
+
+## 8. dependency-cruiser ルール
+
+### 目的
+- レイヤー間の不適切依存を防止する。
+
+### 例
+- 依存は interface / contract 経由のみ許可。
+- 設定ファイル: `.dependency-cruiser.js`。
+- 違反時は CI 失敗。
+
+## 9. テスト & 受け入れ基準
+
+### テスト要件
+
+* Unit Test
+  * Jest
+  * 外部通信・I/O はすべてモック
+* E2E Test
+  * docker-compose で起動
+  * Playwright を使用
+
+### 機能受け入れ条件（例）
+
+* 入力受入: 100 行の断片データをインポートし、UI で編集可能。
+* 重複検出: サンプルデータで 80%以上の論理的重複を検出。
+* 分解提案: 10 件中 7 件以上で適切な分割候補を提示。
+* 状態抽出: 「ユーザー登録」マトリクスから主要状態遷移を自動生成。
+* コラボレーション: 複数ユーザーの同時編集を競合なくマージ可能。
+
+### 最終ゲート
+
+* `npm run test` 成功
+* `npm run lint` エラーなし
+* `npm run build` 成功
+* `dist/index.bundle.js` が生成されていること

package/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Publish package to GitHub Packages
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [14.x, 16.x]
+    
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+
+    - name: Test
+      run: |
+        npm ci
+        npm run test
+        
+  publish-npm:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: https://registry.npmjs.org/
+      - run: npm install -g npm@latest
+      - run: npm ci
+      - run: npm run build
+      - name: Publish to NPM with Trusted Publishing
+        run: npm publish --access public

package/.github/workflows/webpack.yml

@@ -0,0 +1,28 @@
+name: NodeJS with Webpack
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [14.x, 16.x]
+    
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+
+    - name: Test
+      run: |
+        npm ci
+        npm run test

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 nojaja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.