open-index/open-npm huggingface dataset:
npm package: @naheitsch/litelogger
Description: Simple logger that provides helpful indicators for errors and debugging.
Author: Nathaniel Heitsch
Latest version: 1.0.4

# litelogger
Simple and colorful logger that's easy on the eyes ;)

## Usage
Require at the top of your file:

`const llog = require('litelogger').init('FileName', true);`

Arguments for `.init()`:
* Name of file that will show up on all log messages. Can be null if one is not desired
* Boolean: would you like a timestamp on your log messages

![alt text](https://github.com/KingLagalot/litelogger/raw/master/example.png "LiteLogger Example")

There are four types of messages:
```
llog.warning('This is a warning');
llog.debug('This is a debug message!');
llog.info('Just wanted to let you know this info.');
llog.error('Something really bad just happened :(');

// To add a flag
llog.info('You can also add a flag', 'Im the flag');
```
Output:
```
 warning - [testclass] This is a warning
   debug - [testclass] This is a debug message!
   info  - [testclass] Just wanted to let you know this info.
   error - [testclass] Something really bad just happened :(
   info  - [testclass][I'm the flag] You can also add a flag
```

## Versions
### 1.0.1
* Filename can now be passed as null and will not appear
npm package: @nahid6970/math-wizard-example
Description: A simple math utility library for testing npm publishing.
Author: Nahid
Latest version: 1.0.0

# Math Wizard Example

A simple math utility library created for testing npm project workflows, such as creation, testing, and publishing.

## Installation

Once published, you can install this package using npm:

```bash
npm install math-wizard-example
```

## Usage

```javascript
const math = require('math-wizard-example');

console.log(math.add(5, 3)); // 8
console.log(math.subtract(10, 4)); // 6
console.log(math.multiply(2, 6)); // 12
console.log(math.divide(10, 2)); // 5
```

## Running Tests

To run the included tests, use:

```bash
npm test
```

## How to Publish to npm

1. **Create an npm account:** If you don't have one, sign up at [npmjs.com](https://www.npmjs.com/).
2. **Login via CLI:** Run `npm login` and follow the prompts.
3. **Verify `package.json`:** Ensure the `name` is unique and the `version` is correct.
4. **Publish:** Run `npm publish`.
   - *Note:* If your package name is taken, you might need to change it in `package.json` or use a scope like `@your-username/math-wizard-example` and publish with `npm publish --access public`.

## Updating your package

1. Make your changes.
2. Increment the version (e.g., `npm version patch`).
3. Run `npm publish`.

## License

MIT
npm package: @nahisaho/agent-builder
Description: Install Coreclaw Agent Skills (.github/ agents, skills, copilot-instructions) into your project
Latest version: 0.1.0

# agent-builder

> `npm install` で GitHub Copilot の Agent Skills（`.github/`）をプロジェクトに配布するパッケージ

## インストール

```bash
npm install agent-builder
```

`npm install` 実行時に `postinstall` フックが自動で `.github/` 配下のファイルをプロジェクトルートにコピーします。

### コピーされるファイル

```
.github/
├── copilot-instructions.md    # プロジェクト共通の規約
├── agents/
│   ├── harness-reviewer.md    # Harness 監査エージェント
│   └── skill-developer.md     # スキル開発エージェント
└── skills/
    ├── description-optimizer/  # description 最適化スキル
    ├── gotchas-curator/        # Gotchas 収集スキル
    ├── harness-auditor/        # Harness 7軸監査スキル
    ├── orchestrator-designer/  # AGENTS.md 設計スキル
    ├── purpose-discovery/      # Purpose Discovery スキル
    └── skill-scaffolder/       # スキル雛形生成スキル
```

## CLI

手動でファイルを再インストールしたい場合：

```bash
# .github/ を現在のディレクトリにインストール（上書き）
npx agent-builder install

# 既存ファイルを保持して新規ファイルのみ追加
npx agent-builder install --no-overwrite

# インストールされるファイルをプレビュー
npx agent-builder status
```

## 動作仕様

| シナリオ | 動作 |
|---------|------|
| `npm install agent-builder` | 自動で `.github/` をプロジェクトルートにコピー（上書き） |
| `npx agent-builder install` | 手動で `.github/` をカレントディレクトリにコピー |
| `npx agent-builder install --no-overwrite` | 既存ファイルはスキップ、新規のみ追加 |
| パッケージ自身のディレクトリ内 | 自動インストールをスキップ |
| `INIT_CWD` 未設定 | 自動インストールをスキップ |

## License

MIT
npm package: @nahisaho/musubi
Description: MUSUBI SDD Framework - Alias for @nahisaho/musubix-core
Latest version: 3.8.2

# @nahisaho/musubi

> Alias package for `@nahisaho/musubix-core`

This package is a wrapper that re-exports everything from `@nahisaho/musubix-core`.
Use this if you prefer the shorter "musubi" name.

## Installation

```bash
npm install @nahisaho/musubi
```

## Usage

### CLI

```bash
npx @nahisaho/musubi init
npx @nahisaho/musubi requirements analyze <file>
npx @nahisaho/musubi design generate <file>
```

### API

```typescript
import { EarsValidator, C4Generator } from '@nahisaho/musubi';
```

## See Also

- [@nahisaho/musubix-core](https://www.npmjs.com/package/@nahisaho/musubix-core) - Full documentation
- [MUSUBIX GitHub](https://github.com/nahisaho/MUSUBIX)
npm package: @nahisaho/musubix-deep-research
Description: Deep Research Integration - Iterative search-read-reason cycle for AI agents
Author: nahisaho
Latest version: 3.8.2

# @nahisaho/musubix-deep-research

Deep Research Integration for MUSUBIX - Iterative search-read-reason cycle for AI agents during requirements and design phases.

## Features

- 🔄 **Iterative Research Cycle**: Search → Read → Reason → Reflect loop
- 🔍 **Multi-Provider Search**: Jina AI (primary), Brave (fallback 1), DuckDuckGo (fallback 2)
- 🧠 **LM API Integration**: VS Code LM API (GitHub Copilot) for reasoning
- 📚 **Knowledge Accumulation**: Persistent knowledge base across iterations
- 💰 **Token Budget Management**: Automatic tracking and limits
- 📊 **Research Reports**: Markdown/JSON formatted reports with citations

## Installation

```bash
npm install @nahisaho/musubix-deep-research
```

## Usage

### CLI

```bash
# Start deep research
npx musubix deep-research "How to implement authentication in TypeScript?"

# With options
npx musubix deep-research "TypeScript decorators" \
  --max-iterations 5 \
  --token-budget 10000 \
  --output report.md
```

### Programmatic API

```typescript
import { ResearchEngine, ResearchConfig } from '@nahisaho/musubix-deep-research';

const config: ResearchConfig = {
  query: 'How to implement authentication in TypeScript?',
  maxIterations: 10,
  tokenBudget: 15000,
  providers: {
    jinaApiKey: process.env.JINA_API_KEY,
    braveApiKey: process.env.BRAVE_API_KEY,
  },
};

const engine = new ResearchEngine(config);
const report = await engine.research();

console.log(report.summary);
console.log(`Found ${report.findings.length} findings`);
```

## Architecture

Based on **Template Method Pattern** (ADR-v3.4.0-001):

```
ResearchEngine (Template Method)
  ├─ initialize()
  ├─ while (!shouldStop())
  │   ├─ generateQuestions()  → LMReasoning
  │   ├─ search()             → SearchProviderFactory
  │   ├─ read()               → JinaProvider.read()
  │   ├─ reason()             → LMReasoning
  │   └─ logIteration()       → TrajectoryLogger
  └─ generateReport()         → ReportGenerator
```

## Requirements

- Node.js >= 20.0.0
- npm >= 10.0.0
- VS Code with GitHub Copilot (for LM API)
- Jina AI API Key (recommended)

## License

MIT

## Documentation

- [Requirements](../../storage/specs/REQ-MUSUBIX-v3.4.0.md)
- [Design](../../storage/design/DES-DR-v3.4.0.md)
- [ADRs](../../docs/adr/)
- [Tasks](../../storage/tasks/TSK-DR-v3.4.0.md)
npm package: @nahisaho/musubix-formal-verify
Description: Formal verification tools for MUSUBIX - Z3 integration, precondition/postcondition verification, and EARS-to-SMT conversion
Author: nahisaho
Latest version: 3.8.2

# @nahisaho/musubix-formal-verify

MUSUBIX v1.7.5 Formal Verification Edition - 形式検証ツールパッケージ

## 概要

Z3ソルバー統合、事前条件/事後条件検証、EARS→SMT変換、トレーサビリティDBを提供します。

## インストール

```bash
npm install @nahisaho/musubix-formal-verify
```

## 機能

### Z3統合

```typescript
import { Z3Adapter } from '@nahisaho/musubix-formal-verify/z3';

const z3 = await Z3Adapter.create();
const result = await z3.checkSat('(declare-const x Int) (assert (> x 0))');
console.log(result); // 'sat' | 'unsat' | 'unknown'
```

### 事前条件/事後条件検証

```typescript
import { PreconditionVerifier, PostconditionVerifier } from '@nahisaho/musubix-formal-verify/verifiers';

const preVerifier = new PreconditionVerifier(z3);
const result = await preVerifier.verify({
  condition: 'amount > 0 && amount <= balance',
  variables: { amount: 'Int', balance: 'Int' }
});
```

### EARS→SMT変換

```typescript
import { EarsToSmtConverter } from '@nahisaho/musubix-formal-verify/converters';

const converter = new EarsToSmtConverter();
const smt = converter.convert('WHEN user clicks submit, THE system SHALL save the data');
```

### トレーサビリティDB

```typescript
import { TraceabilityDB, ImpactAnalyzer } from '@nahisaho/musubix-formal-verify/traceability';

const db = new TraceabilityDB('./trace.db');
await db.addLink({ source: 'REQ-001', target: 'DES-001', type: 'implements' });

const analyzer = new ImpactAnalyzer(db);
const impact = await analyzer.analyze('REQ-001');
```

## ライセンス

MIT
npm package: @nahisaho/musubix-neural-search
Description: Neural search engine with embedding-based scoring and learning-based pruning
Author: nahisaho
Latest version: 3.8.2

# @nahisaho/musubix-neural-search

Neural search engine with embedding-based scoring and learning-based pruning for MUSUBIX code synthesis.

## Features

- **Neural Scorer**: Embedding-based code and specification scoring
- **Search Engine**: Beam search and best-first search algorithms
- **Learning Module**: Online learning from search trajectories

## Installation

```bash
npm install @nahisaho/musubix-neural-search
```

## Requirements

- REQ-NS-001: Branch Scoring with neural embeddings
- REQ-NS-002: Search prioritization based on scores
- REQ-NS-003: Learning-based pruning
- REQ-NS-004: Search trajectory learning

## Architecture

```
┌─────────────────────────────────────────────────────────┐
│                   Neural Search Engine                   │
├─────────────────┬─────────────────┬────────────────────┤
│  Neural Scorer  │  Search Engine  │  Learning Module   │
├─────────────────┼─────────────────┼────────────────────┤
│ EmbeddingModel  │ BeamSearch      │ TrajectoryLog      │
│ BranchScorer    │ BestFirstSearch │ OnlineLearner      │
│ ContextEncoder  │ PruningManager  │ ModelUpdater       │
└─────────────────┴─────────────────┴────────────────────┘
```

## Usage

```typescript
import { BeamSearch, BranchScorer, OnlineLearner } from '@nahisaho/musubix-neural-search';

// Create scorer
const scorer = new BranchScorer();

// Create search
const search = new BeamSearch({ beamWidth: 5 });

// Execute search
const results = await search.search(initialState, scorer);
```

## License

MIT
npm package: @nahisaho/musubix-security
Description: Security analysis and vulnerability detection for MUSUBIX - Neuro-Symbolic AI Integration with CodeQL-equivalent capabilities
Author: nahisaho
Latest version: 3.8.2

# @nahisaho/musubix-security

MUSUBIX Security Package - セキュリティ分析と脆弱性検出

## 概要

MUSUBIXシステムにセキュリティ特化機能を提供するパッケージです。

### 主な機能

- **脆弱性スキャン**: OWASP Top 10、CWE Top 25対応
- **テイント分析**: データフロー追跡による汚染検出
- **自動修正**: LLM（VS Code LM API）+ Z3形式検証による安全な修正
- **シークレット検出**: APIキー、トークン、パスワードの検出
- **依存関係監査**: npm依存関係の脆弱性チェック
- **セキュリティインテリジェンス**: 脅威フィード統合、MITRE ATT&CK対応
- **リスク分析**: CVSS計算、予測分析、異常検出

## インストール

```bash
npm install @nahisaho/musubix-security
```

## 使用方法

### CLI

```bash
# 脆弱性スキャン
npx musubix-security scan ./src

# 自動修正
npx musubix-security fix VULN-2026-001

# 依存関係監査
npx musubix-security audit-deps

# シークレット検出
npx musubix-security detect-secrets ./src

# コンプライアンスチェック
npx musubix-security compliance --standard asvs
```

### Library API

```typescript
import { 
  VulnerabilityScanner, 
  TaintAnalyzer,
  FixPipeline,
  SecretsDetector,
  DependencyAuditor
} from '@nahisaho/musubix-security';

// 脆弱性スキャン
const scanner = new VulnerabilityScanner();
const result = await scanner.scan(['./src/**/*.ts']);

// テイント分析
const taintAnalyzer = new TaintAnalyzer();
const taintResult = await taintAnalyzer.analyze(code, 'file.ts');

// 自動修正
const fixPipeline = new FixPipeline();
const fixes = await fixPipeline.generateFix(vulnerability);
const verified = await fixPipeline.verifyFix(fixes[0]);

// セキュリティインテリジェンス (Phase 6)
import {
  ThreatIntelligence,
  AttackPatternMatcher,
  RiskScorer,
  SecurityAnalytics,
  PredictiveAnalyzer
} from '@nahisaho/musubix-security';

// 脅威インテリジェンス
const threatIntel = new ThreatIntelligence();
await threatIntel.addFeed({ id: 'feed-1', name: 'My Feed', url: 'https://...' });
const matches = threatIntel.matchCode(code);

// リスクスコアリング
const riskScorer = new RiskScorer();
const cvss = riskScorer.calculateCVSS(vulnerability);
const businessImpact = riskScorer.assessBusinessImpact(vulnerability);

// 予測分析
const predictor = new PredictiveAnalyzer();
predictor.addDataPoints([...historicalData]);
const forecast = predictor.projectRisk(30); // 30日先の予測
const anomalies = predictor.detectAnomalies();
```

## 設定

プロジェクトルートに `.musubix-security.yaml` を作成:

```yaml
version: "1.0"

scan:
  rulesets:
    - owasp-top-10
    - cwe-top-25
  severity:
    - critical
    - high
  exclude:
    - "**/node_modules/**"
    - "**/*.test.ts"

fix:
  llm:
    enabled: true
    model: "copilot"
  autoApply: false

secrets:
  entropyThreshold: 4.5
```

## トレーサビリティ

- **要件定義**: REQ-SEC-001
- **設計書**: DES-SEC-001
- **テスト**: TST-SEC-*

## ライセンス

MIT
npm package: @nahisaho/musubix-synthesis
Description: MUSUBIX synthesis - DSL-based program synthesis with PBE and rule learning
Author: nahisaho
Latest version: 3.8.2

# @nahisaho/musubix-synthesis

DSL-based program synthesis with PBE (Programming by Example) and rule learning.

## Features

- **DSL Framework**: Declarative DSL definition with operators, types, and semantics
- **PBE Synthesis**: Programming by Example using enumeration and neural guidance
- **Witness Functions**: Deductive synthesis with inverse semantics
- **Version Space**: Efficient representation of candidate programs
- **Rule Learning**: Meta-learning from successful synthesis

## Installation

```bash
npm install @nahisaho/musubix-synthesis
```

## Usage

### DSL Definition

```typescript
import { DSLBuilder } from '@nahisaho/musubix-synthesis';

const dsl = new DSLBuilder('string-transform')
  .addType('string', { kind: 'primitive' })
  .addType('int', { kind: 'primitive' })
  .addOperator('concat', ['string', 'string'], 'string', (a, b) => a + b)
  .addOperator('substring', ['string', 'int', 'int'], 'string', (s, i, j) => s.slice(i, j))
  .addOperator('length', ['string'], 'int', (s) => s.length)
  .addConstant('empty', 'string', '')
  .build();
```

### PBE Synthesis

```typescript
import { PBESynthesizer } from '@nahisaho/musubix-synthesis';

const synthesizer = new PBESynthesizer();

const result = await synthesizer.synthesize(dsl, [
  { input: 'hello', output: 'HELLO' },
  { input: 'world', output: 'WORLD' },
]);

if (result.success) {
  console.log('Synthesized program:', result.program);
}
```

### Rule Learning

```typescript
import { RuleLibrary, MetaLearner } from '@nahisaho/musubix-synthesis';

const library = new RuleLibrary();
const learner = new MetaLearner(library);

// Learn from successful synthesis
await learner.learn(result, usedRules);

// Apply learned rules for future synthesis
const rules = await library.match(newSpec);
```

## API Reference

### DSL Framework

- `DSLBuilder` - Declarative DSL definition
- `TypeSystem` - Type checking and inference
- `Semantics` - Execution semantics

### Synthesis Engine

- `PBESynthesizer` - Programming by example
- `WitnessEngine` - Deductive synthesis
- `VersionSpace` - Candidate program representation
- `Enumerator` - Exhaustive enumeration

### Rule Learning

- `RuleExtractor` - Extract rules from synthesis
- `RuleLibrary` - Store and query rules
- `MetaLearner` - Continuous rule improvement

## Requirements

| Requirement | Description |
|-------------|-------------|
| REQ-SYN-001 | DSL Definition Framework |
| REQ-SYN-002 | Witness Functions |
| REQ-SYN-003 | PBE Synthesis |
| REQ-SYN-004 | Rule Learning |

## License

MIT
npm package: @nahisaho/shikigami-bcg-mcp-server
Description: SHIKIGAMI MCP Server - Deep Research tools with search fallback mechanism
Author: nahisaho
Latest version: 1.23.0

# SHIKIGAMI MCP Server

Deep Research用のMCPサーバー。DuckDuckGo検索とJina AI Readerを使用してリアルタイムWeb検索を実行。

## インストール

```bash
cd mcp-server
npm install
npm run build
```

## ツール

### search

DuckDuckGoでバッチWeb検索を実行。

```json
{
  "query": "TypeScript best practices",
  "maxResults": 10
}
```

または複数クエリ:

```json
{
  "query": ["TypeScript best practices", "TypeScript design patterns"],
  "maxResults": 5
}
```

### visit

Webページを訪問し、内容をLLM用にクリーンなテキストとして抽出。

```json
{
  "url": "https://example.com/article",
  "goal": "主要なポイントを抽出"
}
```

または複数URL:

```json
{
  "url": ["https://example.com/1", "https://example.com/2"]
}
```

## キャッシュシステム（v1.10.0）

検索・訪問結果をキャッシュして効率化。

### キャッシュモジュール

| モジュール | 説明 |
|-----------|------|
| `FileCacheStore` | ファイルベースのキャッシュストア（LRU、TTL） |
| `QueryCacheManager` | 検索・訪問・埋め込みのキャッシュ管理 |
| `SemanticCacheMatcher` | 意味的類似クエリのキャッシュマッチング |
| `GlobalCacheStore` | ユーザー横断グローバルキャッシュ |

### 使用例

```typescript
import { getDefaultCacheManager } from './cache';

const manager = getDefaultCacheManager();

// 検索結果のキャッシュ
const cached = await manager.getSearchResult({ query: 'TypeScript' });
if (!cached.hit) {
  const results = await search('TypeScript');
  await manager.setSearchResult({ query: 'TypeScript' }, results);
}
```

## VS Code設定

`.vscode/mcp.json`:

```json
{
  "servers": {
    "shikigami": {
      "command": "node",
      "args": ["${workspaceFolder}/shikigami/mcp-server/dist/index.js"]
    }
  }
}
```

## 要件準拠

- **REQ-DR-002**: DuckDuckGo Web検索 ✅
- **REQ-CS-004**: search/visit ツール ✅
- **REQ-CACHE-001**: キャッシュシステム ✅ (v1.10.0)
- **REQ-DICT-001**: ドメイン辞書 ✅ (v1.15.0)
- **REQ-PAT-001**: 特許検索最適化 ✅ (v1.15.0)
- **REQ-ALT-001**: 代替情報源管理 ✅ (v1.15.0)
- **REQ-EXT-001**: 構造化データ抽出 ✅ (v1.15.0)
- **REQ-PAY-001**: ペイウォール検知 ✅ (v1.15.0)
- **レート制限**: 1.5秒間隔（DuckDuckGo）、1秒間隔（Jina AI）

## v1.15.0 新機能

### 検索拡張

- **ドメイン辞書**: 専門用語の同義語展開・多言語展開
- **特許検索最適化**: IPC分類コード自動推定、各特許庁向けクエリ生成

```typescript
import { enhanceSearchQuery, getPatentSearchUrls } from '@nahisaho/shikigami-bcg-mcp-server';

// クエリ拡張
const enhanced = await enhanceSearchQuery('AI導入事例');
console.log(enhanced.additionalQueries);

// 特許検索URL取得
const urls = await getPatentSearchUrls('リチウムイオン電池');
```

### 訪問拡張

- **ペイウォール検知**: 有料記事の自動検出
- **代替情報源提案**: オープンアクセス版の提案
- **構造化データ抽出**: 論文・特許からのメタデータ抽出

```typescript
import { enhanceVisit, getAlternativeSources } from '@nahisaho/shikigami-bcg-mcp-server';

// 完全な訪問拡張
const enhanced = await enhanceVisit(url, html, { isPaper: true });
console.log(enhanced.structuredData);
console.log(enhanced.alternativeSources);
```

詳細は [docs/shikigami-v115-search-enhancement.prompt.md](docs/shikigami-v115-search-enhancement.prompt.md) と [docs/shikigami-v115-visit-enhancement.prompt.md](docs/shikigami-v115-visit-enhancement.prompt.md) を参照してください。

## 検索プロバイダー

| プロバイダー | 用途 | APIキー |
|-------------|------|---------|
| DuckDuckGo | Web検索 | 不要 |
| Jina AI Reader | ページ内容抽出 | 不要 |
npm package: @nahisaho/shikigami-mcp-server
Description: SHIKIGAMI MCP Server - Deep Research tools with search fallback mechanism
Author: nahisaho
Latest version: 1.16.6

# SHIKIGAMI MCP Server

Deep Research用のMCPサーバー。DuckDuckGo検索とJina AI Readerを使用してリアルタイムWeb検索を実行。

## インストール

```bash
cd mcp-server
npm install
npm run build
```

## ツール

### search

DuckDuckGoでバッチWeb検索を実行。

```json
{
  "query": "TypeScript best practices",
  "maxResults": 10
}
```

または複数クエリ:

```json
{
  "query": ["TypeScript best practices", "TypeScript design patterns"],
  "maxResults": 5
}
```

### visit

Webページを訪問し、内容をLLM用にクリーンなテキストとして抽出。

```json
{
  "url": "https://example.com/article",
  "goal": "主要なポイントを抽出"
}
```

または複数URL:

```json
{
  "url": ["https://example.com/1", "https://example.com/2"]
}
```

## キャッシュシステム（v1.10.0）

検索・訪問結果をキャッシュして効率化。

### キャッシュモジュール

| モジュール | 説明 |
|-----------|------|
| `FileCacheStore` | ファイルベースのキャッシュストア（LRU、TTL） |
| `QueryCacheManager` | 検索・訪問・埋め込みのキャッシュ管理 |
| `SemanticCacheMatcher` | 意味的類似クエリのキャッシュマッチング |
| `GlobalCacheStore` | ユーザー横断グローバルキャッシュ |

### 使用例

```typescript
import { getDefaultCacheManager } from './cache';

const manager = getDefaultCacheManager();

// 検索結果のキャッシュ
const cached = await manager.getSearchResult({ query: 'TypeScript' });
if (!cached.hit) {
  const results = await search('TypeScript');
  await manager.setSearchResult({ query: 'TypeScript' }, results);
}
```

## VS Code設定

`.vscode/mcp.json`:

```json
{
  "servers": {
    "shikigami": {
      "command": "node",
      "args": ["${workspaceFolder}/shikigami/mcp-server/dist/index.js"]
    }
  }
}
```

## 要件準拠

- **REQ-DR-002**: DuckDuckGo Web検索 ✅
- **REQ-CS-004**: search/visit ツール ✅
- **REQ-CACHE-001**: キャッシュシステム ✅ (v1.10.0)
- **REQ-DICT-001**: ドメイン辞書 ✅ (v1.15.0)
- **REQ-PAT-001**: 特許検索最適化 ✅ (v1.15.0)
- **REQ-ALT-001**: 代替情報源管理 ✅ (v1.15.0)
- **REQ-EXT-001**: 構造化データ抽出 ✅ (v1.15.0)
- **REQ-PAY-001**: ペイウォール検知 ✅ (v1.15.0)
- **レート制限**: 1.5秒間隔（DuckDuckGo）、1秒間隔（Jina AI）

## v1.15.0 新機能

### 検索拡張

- **ドメイン辞書**: 専門用語の同義語展開・多言語展開
- **特許検索最適化**: IPC分類コード自動推定、各特許庁向けクエリ生成

```typescript
import { enhanceSearchQuery, getPatentSearchUrls } from '@nahisaho/shikigami-mcp-server';

// クエリ拡張
const enhanced = await enhanceSearchQuery('AI導入事例');
console.log(enhanced.additionalQueries);

// 特許検索URL取得
const urls = await getPatentSearchUrls('リチウムイオン電池');
```

### 訪問拡張

- **ペイウォール検知**: 有料記事の自動検出
- **代替情報源提案**: オープンアクセス版の提案
- **構造化データ抽出**: 論文・特許からのメタデータ抽出

```typescript
import { enhanceVisit, getAlternativeSources } from '@nahisaho/shikigami-mcp-server';

// 完全な訪問拡張
const enhanced = await enhanceVisit(url, html, { isPaper: true });
console.log(enhanced.structuredData);
console.log(enhanced.alternativeSources);
```

詳細は [docs/shikigami-v115-search-enhancement.prompt.md](docs/shikigami-v115-search-enhancement.prompt.md) と [docs/shikigami-v115-visit-enhancement.prompt.md](docs/shikigami-v115-visit-enhancement.prompt.md) を参照してください。

## 検索プロバイダー

| プロバイダー | 用途 | APIキー |
|-------------|------|---------|
| DuckDuckGo | Web検索 | 不要 |
| Jina AI Reader | ページ内容抽出 | 不要 |
npm package: @nahisaho/yata-scale
Description: [DEPRECATED] YATA Scale - Use @musubix/knowledge instead
Author: nahisaho
Latest version: 3.0.16
Deprecated: This package is deprecated. Please use @musubix/knowledge from MUSUBIX v3.0.0+

# @nahisaho/yata-scale

YATA Knowledge Graph Scale-up Package - Distributed graph architecture, high-performance indexing, and multi-level caching for large-scale knowledge graphs.

## Features

- **Distributed Graph Architecture**: Hash/Range/Graph-based partitioning with automatic rebalancing
- **High-Performance Indexes**: B+Tree, Full-text, Graph indexes with Bloom filters
- **Multi-Level Cache**: L1 (hot), L2 (warm), L3 (cold) with automatic promotion/demotion
- **Parallel Query Processing**: Worker pool, pipelined execution, async I/O
- **Sync & Replication**: Vector clock, conflict resolution, offline support

## Installation

```bash
npm install @nahisaho/yata-scale
```

## Quick Start

```typescript
import { createYataScale } from '@nahisaho/yata-scale';

const scale = createYataScale({
  shards: [
    { id: 'shard-0', type: 'local', path: './data/shard-0' },
    { id: 'shard-1', type: 'local', path: './data/shard-1' },
  ],
  partitionStrategy: 'hash',
  cache: {
    l1Size: 1000,
    l2Size: 10000,
  },
});

await scale.initialize();

// Add entities (auto-sharding)
await scale.addEntity({
  type: 'class',
  name: 'UserService',
  namespace: 'app.services',
});

// Distributed query
const result = await scale.query({
  entityFilters: { types: ['class'] },
  textSearch: 'Service',
});

await scale.close();
```

## Performance Targets

| Metric | Target |
|--------|--------|
| Single entity lookup | < 1ms p99 |
| Complex graph queries | < 100ms p99 |
| Read QPS | ≥ 10,000 |
| Memory (1M entities) | < 4GB |
| Max entities | 100M+ |

## License

MIT
npm package: @nahkies/openapi-code-generator
Description: Typescript client SDK and server stub generator for OpenAPI 3 specifications
Author: Michael Nahkies
Latest version: 0.22.0

# @nahkies/openapi-code-generator

[![CI/CD](https://github.com/mnahkies/openapi-code-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/mnahkies/openapi-code-generator/actions?query=branch%3Amain+event%3Apush)
[![npm](https://img.shields.io/npm/dm/%40nahkies%2Fopenapi-code-generator.svg)](https://www.npmjs.com/package/@nahkies/openapi-code-generator)

`@nahkies/openapi-code-generator` is a CLI tool that aims to generate high quality typescript client SDK's,
and API server scaffolding (routing, validation, serialization) from OpenAPI 3 specifications.

Currently, [OpenAPI 3.0.x](https://spec.openapis.org/oas/v3.0.4.html), [OpenAPI 3.1.x](https://spec.openapis.org/oas/v3.1.1.html),
and [TypeSpec](https://typespec.io/) are supported as input specifications.

<!-- toc -->

* [Documentation](#documentation)
* [Changelog](#changelog)
* [Stability](#stability)
* [More information / contributing](#more-information--contributing)

<!-- tocstop -->

## Documentation

Visit https://openapi-code-generator.nahkies.co.nz/ for detailed documentation including
quick start guides and reference material.

## Changelog

Please see the [Github releases](https://github.com/mnahkies/openapi-code-generator/releases)
for handwritten release notes, or [CHANGELOG.md](https://github.com/mnahkies/openapi-code-generator/blob/main/CHANGELOG.md) for release notes generated by lerna.

## Stability

This project is still in beta, and breaking changes are still likely to be made before moving to v1.
However, these are considered thoughtfully and we aim to minimise disruption.

In general, what is implemented works well, but there are still parts of the OpenAPI specification that
haven't been implemented, so YMMV.

## More information / contributing

Refer to top level [README.md](../../README.md) / [CONTRIBUTING.md](../../CONTRIBUTING.md)
npm package: @nahkies/typescript-axios-runtime
Description: Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-axios template
Author: Michael Nahkies
Latest version: 0.22.0

# @nahkies/typescript-axios-runtime

[![CI/CD](https://github.com/mnahkies/openapi-code-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/mnahkies/openapi-code-generator/actions?query=branch%3Amain+event%3Apush)
[![npm](https://img.shields.io/npm/dm/%40nahkies%2Ftypescript-axios-runtime.svg)](https://www.npmjs.com/package/@nahkies/typescript-axios-runtime)

This is a supporting package for code generated using [@nahkies/openapi-code-generator](https://www.npmjs.com/package/@nahkies/openapi-code-generator) using the Typescript Axios client template.

You can [read the docs](https://openapi-code-generator.nahkies.co.nz/guides/client-templates/typescript-axios) to find out more!

It's not intended by be used standalone. Similar in spirit to [tslib](https://www.npmjs.com/package/tslib)
npm package: @nahkies/typescript-express-runtime
Description: Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-express template
Author: Michael Nahkies
Latest version: 0.22.0

# @nahkies/typescript-express-runtime

[![CI/CD](https://github.com/mnahkies/openapi-code-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/mnahkies/openapi-code-generator/actions?query=branch%3Amain+event%3Apush)
[![npm](https://img.shields.io/npm/dm/%40nahkies%2Ftypescript-express-runtime.svg)](https://www.npmjs.com/package/@nahkies/typescript-express-runtime)

This is a supporting package for code generated using [@nahkies/openapi-code-generator](https://www.npmjs.com/package/@nahkies/openapi-code-generator) using the Typescript Express server stubs template.

You can [read the docs](https://openapi-code-generator.nahkies.co.nz/guides/server-templates/typescript-express) to find out more!

It's not intended by be used standalone. Similar in spirit to [tslib](https://www.npmjs.com/package/tslib)
npm package: @nahkies/typescript-fetch-runtime
Description: Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-fetch template
Author: Michael Nahkies
Latest version: 0.22.0

# @nahkies/typescript-fetch-runtime

[![CI/CD](https://github.com/mnahkies/openapi-code-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/mnahkies/openapi-code-generator/actions?query=branch%3Amain+event%3Apush)
[![npm](https://img.shields.io/npm/dm/%40nahkies%2Ftypescript-fetch-runtime.svg)](https://www.npmjs.com/package/@nahkies/typescript-fetch-runtime)

This is a supporting package for code generated using [@nahkies/openapi-code-generator](https://www.npmjs.com/package/@nahkies/openapi-code-generator) using the Typescript Fetch client template.

You can [read the docs](https://openapi-code-generator.nahkies.co.nz/guides/client-templates/typescript-fetch) to find out more!

It's not intended by be used standalone. Similar in spirit to [tslib](https://www.npmjs.com/package/tslib)
npm package: @nahkies/typescript-koa-runtime
Description: Runtime package for code generated by @nahkies/openapi-code-generator using the typescript-koa template
Author: Michael Nahkies
Latest version: 0.22.0

# @nahkies/typescript-koa-runtime

[![CI/CD](https://github.com/mnahkies/openapi-code-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/mnahkies/openapi-code-generator/actions?query=branch%3Amain+event%3Apush)
[![npm](https://img.shields.io/npm/dm/%40nahkies%2Ftypescript-koa-runtime.svg)](https://www.npmjs.com/package/@nahkies/typescript-koa-runtime)

This is a supporting package for code generated using [@nahkies/openapi-code-generator](https://www.npmjs.com/package/@nahkies/openapi-code-generator) using the Typescript Koa server stubs template.

You can [read the docs](https://openapi-code-generator.nahkies.co.nz/guides/server-templates/typescript-koa) to find out more!

It's not intended by be used standalone. Similar in spirit to [tslib](https://www.npmjs.com/package/tslib)
npm package: @nahmii/contracts-periphery
Description: External (out-of-protocol) L1 and L2 smart contracts for Nahmii 3
Author: Optimism PBC
Latest version: 3.1.2

<!-- Some pieces of Optimism docs have been retained but commented out for later analogous nahmiification -->

# Nahmii Peripheral Smart Contracts

<!--[![codecov](https://codecov.io/gh/ethereum-optimism/optimism/branch/develop/graph/badge.svg?token=0VTG7PG7YR&flag=contracts-periphery-tests)](https://codecov.io/gh/ethereum-optimism/optimism)-->
npm package: @nahmii/core-utils
Description: Core typescript utilities
Latest version: 3.0.3

<!-- Some pieces of Optimism docs have been retained but commented out for later analogous nahmiification -->

# @nahmii/core-utils

<!--[![codecov](https://codecov.io/gh/ethereum-optimism/optimism/branch/develop/graph/badge.svg?token=0VTG7PG7YR&flag=core-utils-tests)](https://codecov.io/gh/ethereum-optimism/optimism)-->

## What is this?

`@nahmii/core-utils` contains the Nahmii core utilities.

## Getting started

### Building and usage

After cloning and switching to the repository, install dependencies:

```bash
$ yarn
```

Use the following commands to build, use, test, and lint:

```bash
$ yarn build
$ yarn start
$ yarn test
$ yarn lint
```

### L2 Fees

`TxGasLimit` can be used to `encode` and `decode` the L2 Gas Limit
locally.

```typescript
import { TxGasLimit } from '@nahmii/core-utils'
import { JsonRpcProvider } from 'ethers'

const L2Provider = new JsonRpcProvider('http://127.0.0.1:8545')
const L1Provider = new JsonRpcProvider('http://127.0.0.1:9545')

const l2GasLimit = await L2Provider.send('eth_estimateExecutionGas', [tx])
const l1GasPrice = await L1Provider.getGasPrice()

const encoded = TxGasLimit.encode({
  data: '0x',
  l1GasPrice,
  l2GasLimit,
  l2GasPrice: 10000000,
})

const decoded = TxGasLimit.decode(encoded)
assert(decoded.eq(gasLimit))

const estimate = await L2Provider.estimateGas()
assert(estimate.eq(encoded))
```
npm package: @nahmii/hardhat-nvm
Description: NVM Plugin for HardHat
Latest version: 0.2.3

# @nahmii/hardhat-nvm

A plugin that brings OVM compiler support to Hardhat projects.

## Installation

```
yarn add --dev @nahmii/hardhat-nvm
```

Next, import the plugin inside your `hardhat.config.js`:

```js
// hardhat.config.js

require("@nahmii/hardhat-nvm")
```

Or if using TypeScript:

```ts
// hardhat.config.ts

import "@nahmii/hardhat-nvm"
```

## Configuration

**By default, this plugin will use OVM compiler version 0.7.6**.
Configure this plugin by adding an `ovm` field to your Hardhat config:

```js
// hardhat.config.js

require("@nahmii/hardhat-nvm")

module.exports = {
    ovm: {
        solcVersion: 'X.Y.Z' // Your version goes here.
    }
}

```

This package also has typings so it won't break your Hardhat config if you're using TypeScript.
npm package: @nahmii/message-relayer
Description: L1 to L2 Cross Domain Message Relayer
Latest version: 0.1.9

# @nahmii/message-relayer

This package contains:

1. A service for relaying messages from L2 to L1.
2. Utilities for finding these messages and relaying them.

## Installation

```
yarn add @nahmii/message-relayer
```

## Relay Utilities

### getMessagesAndProofsForL2Transaction

Finds all L2 => L1 messages sent in a given L2 transaction and generates proof for each.

#### Usage

```typescript
import { getMessagesAndProofsForL2Transaction } from '@nahmii/message-relayer'

const main = async () => {
  const l1RpcProviderUrl = 'https://layer1.endpoint'
  const l2RpcProviderUrl = 'https://layer2.endpoint'
  const l1StateCommitmentChainAddress = 'address of NVM_StateCommitmentChain from deployments page'
  const l2CrossDomainMessengerAddress = 'address of NVM_L2CrossDomainMessenger from deployments page'
  const l2TransactionHash = 'hash of the transaction with messages to relay'

  const messagePairs = await getMessagesAndProofsForL2Transaction(
    l1RpcProviderUrl,
    l2RpcProviderUrl,
    l1StateCommitmentChainAddress,
    l2CrossDomainMessengerAddress,
    l2TransactionHash
  )

  console.log(messagePairs)
  // Will log something along the lines of:
  // [
  //   {
  //     message: {
  //       target: '0x...',
  //       sender: '0x...',
  //       message: '0x...',
  //       messageNonce: 1234...
  //     },
  //     proof: {
  //       // complicated
  //     }
  //   }
  // ]

  // You can then do something along the lines of:
  // for (const { message, proof } of messagePairs) {
  //   await l1CrossDomainMessenger.relayMessage(
  //     message.target,
  //     message.sender,
  //     message.message,
  //     message.messageNonce,
  //     proof
  //   )
  // }
}

main()
```
npm package: @nahmii/sdk
Description: Tools for working with Nahmii 3
Latest version: 3.2.3

<!-- Some pieces of Optimism docs have been retained but commented out for later analogous nahmiification -->

# @nahmii/sdk

<!--[![codecov](https://codecov.io/gh/ethereum-optimism/optimism/branch/master/graph/badge.svg?token=0VTG7PG7YR&flag=sdk-tests)](https://codecov.io/gh/ethereum-optimism/optimism)-->

The `@nahmii/sdk` package provides a set of tools for interacting with Nahmii 3.

## Installation

```
npm install @nahmii/sdk
```

<!-- ## Docs

You can find auto-generated API documentation over at [sdk.optimism.io](https://sdk.optimism.io).-->

## Using the SDK

### CrossChainMessenger

The [`CrossChainMessenger`](https://github.com/nahmii/nahmii-3/blob/develop/packages/sdk/src/cross-chain-messenger.ts) class simplifies the process of moving assets and data between Ethereum and Optimism.
You can use this class to, for example, initiate a bridge operation of ERC20 tokens from Nahmii back to the base layer, accurately track when the bridge operation is ready to be finalized on base layer, and execute the finalization transaction after the challenge period has elapsed.
The `CrossChainMessenger` can handle bridge operations in either direction of ETH and any ERC20 or ERC721 compatible token.
<!-- Detailed API descriptions can be found at [sdk.optimism.io](https://sdk.optimism.io/classes/crosschainmessenger).-->
The `CrossChainMessenger` automatically connects to all relevant contracts so complex configuration is not necessary.

### L2Provider and related utilities

The Nahmii SDK includes [various utilities](https://github.com/nahmii/nahmii-3/blob/develop/packages/sdk/src/l2-provider.ts) for handling Nahmii's <!--[-->transaction fee model<!--](https://community.optimism.io/docs/developers/build/transaction-fees/)-->.
For instance, <!--[-->`estimateTotalGasCost`<!--](https://sdk.optimism.io/modules.html#estimateTotalGasCost)--> will estimate the total cost (in wei) to send at transaction on Nahmii including both the L2 execution cost and the L1 data cost.
You can also use the <!--[-->`asL2Provider`<!--](https://sdk.optimism.io/modules.html#asL2Provider)--> function to wrap an ethers Provider object into an `L2Provider` which will have all of these helper functions attached.

<!--### Other utilities

The SDK contains other useful helper functions and constants.
For a complete list, refer to the auto-generated [SDK documentation](https://sdk.optimism.io/)-->
npm package: @nahmii/token-list
Description: Nahmii token list
Latest version: 2.0.0

# @nahmii/token-list

This NPM module and GitHub repo contains the token list used in the nahmii network.

## Adding a token

To request that we add a token to the list, 
[file an issue](https://github.com/Nahmii/token-list/issues/new?assignees=&labels=token+request&template=token-request.md&title=Add+%7BTOKEN_SYMBOL%7D%3A+%7BTOKEN_NAME%7D).

### Disclaimer

Note filing an issue does not guarantee addition to this token list.
We do not review token addition requests in any particular order, and we do not
guarantee that we will review your request to add the token to the list.
npm package: @naholyr/mmdevries-uws
Description: mmdevries/uws custom fork of uWebSockets 0.14
Latest version: 2.9.12

**Important:**

Since it's possible in engine.io (3.4.2 or higher) to specify the ws module via the options this package is renamed to [eiows](https://www.npmjs.com/package/eiows).


uws is a replacement module for ws which allows, but doesn't guarantee, significant performance and memory-usage improvements. This module is specifically only compatible with Node.js.
This package is mainly meant for projects which depend on the performance of the “original uws package” in combination with Socket.IO and Express and it should work on Node 8, 10, 12, 13 and 14.

Installation:

npm install mmdevries/uws#2.9.12

or

yarn add mmdevries/uws#2.9.12


Example:

    var fs = require('fs');
    var https = require('https');
    var express = require('express');

    var ssl_options = {
        key: fs.readFileSync('server.key'),
        cert: fs.readFileSync('server.crt'),
    };

    var app = express();
    var server = https.createServer(ssl_options, app);

    server.listen(1443);

    var io = require("socket.io")(server, {
        wsEngine: 'uws',
        perMessageDeflate: {
            threshold: 32768,
            serverNoContextTakeover: false
        }
    });

    io.on("connection", function(socket) {
        console.log('Yes, you did it!');
    });


Have fun!
npm package: @nahrae/react-native-digital-ink
Description: React Native module for using Digital Ink Recognition of Google ML Kit
Author: Jin
Latest version: 1.2.11

# react-native-digital-ink

React Native module for using Digital Ink Recognition of Google ML Kit

## Installation

```sh
npm install react-native-digital-ink
```

## Usage

```js
import DigitalInk from "react-native-digital-ink";

// ....

const result = await DigitalInk.multiply(3, 7);
```

## Contributing

See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

## License

MIT
npm package: @naiable/rollup-config
Description: Use rollup like tsup, but opinionated my way.
Author: Naily Zero
Latest version: 0.2.1

# Opinionated Rollup Configuration

This is my rollup configuration for building JavaScript libraries like `tsup`.

- `TypeScript`
- `CommonJS Plugin`
- `Alias Plugin`, default configure `@` to `src/`
- `Node Resolve Plugin`
- `dts`, generate `.d.ts`、`d.mts`、`d.cts` files

By default, There will be generate 3 folder:

```bash
dist/
  ├── cjs/  # CommonJS
  ├──── index.cjs
  ├──── index.d.cts # The typing
  ├── esm/  # ES Module
  ├──── index.mts
  ├──── index.d.mts # The typing
  ├── types/  # TypeScript Declaration
  ├──── index.d.ts # The typing

```

## Usage

It very easy to use, just install and create a `rollup.config.ts` file.

```bash
npm i @naiable/rollup-config -D
```

```ts
import naiup from "@naiable/rollup-config";

export default naiup();
```
npm package: @naice/create
Description: naice前端脚手架
Author: naice
Latest version: 1.2.0

# 前端统一开发脚手架

## 使用

````sh
npx @naice/create

or

npx @naice/create [type] # h5 | react | express | lib

````


## 说明

1. h5： vite+ts+vue3 移动端开发模板
2. react： vite+ts+react 开发模板
3. express： node+express+ts 开发模板
4. lib：工具库开发模板
5. vue-component： vue组件库开发模板（coming）
6. react-component：react组件库开发模板（coming）