hersona 0.0.1__tar.gz

hersona-0.0.1/.env.example

@@ -0,0 +1,13 @@
+# hersona 環境変数サンプル
+# このファイルを .env にコピーして実際の値を設定してください
+
+# LLM プロバイダ（どれか1つ必須）
+OPENAI_API_KEY=sk-replace-me
+ANTHROPIC_API_KEY=sk-ant-replace-me
+MINIMAX_API_KEY=eyJ-replace-me
+
+# 任意: 既定プロバイダ上書き
+HERMES_PROVIDER=minimax-oauth
+
+# 任意: persona_attach_log 出力先
+HERMES_PERSONA_LOG_DIR=$HOME/.hermes/hersona

hersona-0.0.1/.github/ISSUE_TEMPLATE/attribute_request.md

@@ -0,0 +1,57 @@
+---
+about: 新規属性テンプレート追加提案 (attributes/<category>/<name>.yaml)
+title: '[ATTRIBUTE] '
+labels: attribute, needs-triage
+assignees: ''
+---
+
+## 提案属性
+
+- 属性名 (snake_case): ___
+- カテゴリ: personality / speech / archetype のいずれか
+- display_name_ja:
+- display_name_en:
+- weight_dimension: none / mild / moderate / strong のいずれか
+- typical_value_range: 例: `0.4-0.7`
+
+## 属性の根拠
+
+- 既存 25 属性で不足する理由: ___
+- アニメ・ゲーム・漫画・クリーチャーで広く見られる特性か: yes / no (理由: ___)
+- 固有名詞・特定作品への依存がないか: yes / no (理由: ___)
+
+## 想定する core_traits / catchphrases / tone
+
+v1.0 では 6 フィールド (core_traits / speech_style / second_person / sentence_endings / catchphrases / tone) が任意追加可能。`tsundere` を雛形として参考に。
+
+- core_traits (3-7 個): ___
+- speech_style (1 行散文、speech カテゴリのみ): ___
+- second_person (1 行 / 区切り、speech カテゴリのみ): ___
+- sentence_endings (3 個以上、speech カテゴリのみ): ___
+- catchphrases (3-15 個、全カテゴリ): ___
+- tone (1 行散文、全カテゴリ): ___
+
+## 互換性
+
+- compatible_archetypes (併用 OK な archetype 名リスト): ___
+- conflicts_with (排他が想定される属性名リスト): ___
+- tags (横断検索タグ): ___
+
+## examples 案 (AI エージェント活用 5 パターン)
+
+1. システムプロンプト注入: ___
+2. 強度調整 (weight=mild): ___
+3. 強度調整 (weight=strong): ___
+4. 互換性チェック (compatible_archetypes との組み合わせ): ___
+5. NG パターン (conflicts_with 該当との同時付与): ___
+
+## 想定工数
+
+- examples / core_traits 設計: N 時間
+- gen_v1_attributes.py への追記: N 時間
+- pytest 80 → 81+ への拡張: N 時間
+- 検証 (validate.py + pytest): N 分
+
+## 関連 Issue
+
+Closes # / refs #

hersona-0.0.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+about: バグ報告（YAML生成ミス・validate.py 偽陰性・schema 違反等）
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## バグの概要
+
+## 再現手順
+
+- OS:
+- Python バージョン: `python -V` の出力
+- hersona バージョン: `git describe --tags` の出力
+- 該当ファイル: `attributes/<category>/<name>.yaml` の attribute_name
+
+## 期待動作
+
+## 実際動作
+
+## 最小 YAML 再現例
+
+```yaml
+# 該当部分のみ抜粋
+```
+
+## validate.py 出力
+
+```
+python scripts/validate.py の出力（raw 貼り付け）
+```
+
+## pytest 出力 (該当テストがある場合)
+
+```
+pytest tests/test_attributes.py -k <attribute_name> の出力
+```
+
+## スクリーンショット・エラーログ
+
+## 関連 Issue
+
+Closes # / refs #

hersona-0.0.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,38 @@
+---
+about: 機能提案（attribute.schema.json 拡張・gen_v1_attributes.py 機能追加・validate.py 機能追加等）
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## 提案する機能
+
+## 課題・動機
+
+## 代替案
+
+## スキーマ影響
+
+- [ ] attribute.schema.json への影響あり（破壊的 / 非破壊的）
+- [ ] 影響なし
+- [ ] pyproject.toml への影響あり（依存追加）
+
+## 影響範囲
+
+- [ ] `attributes/<category>/<name>.yaml` (25 属性全部 or 一部)
+- [ ] `scripts/_oneoff/gen_v1_attributes.py`
+- [ ] `scripts/validate.py`
+- [ ] `tests/test_attributes.py`
+- [ ] `skills/hersona/SKILL.md` (v3.0.0)
+- [ ] `README.md` / `CONTRIBUTING.md`
+
+## 実装案
+
+## 後方互換性
+
+- 既存 25 属性 (personality 10 / speech 8 / archetype 7) の YAML データは維持されるか
+- 既存テスト 80 ケースは影響を受けるか
+
+## 関連 Issue
+
+Closes # / refs #

hersona-0.0.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,47 @@
+## 変更内容
+
+- [ ] 新規属性追加 (`attributes/<category>/<name>.yaml` を `gen_v1_attributes.py` に追記)
+- [ ] 既存属性更新 (修正内容: ____)
+- [ ] schema 拡張 (`schema/attribute.schema.json`)
+- [ ] スクリプト修正 (`scripts/____.py`)
+- [ ] ドキュメント修正 (`README.md` / `CONTRIBUTING.md` / `CHANGELOG.md` / `skills/hersona/SKILL.md`)
+- [ ] テスト追加・修正 (`tests/test_attributes.py`)
+- [ ] その他（詳細: ____）
+
+## 属性追加時のチェックリスト（`gen_v1_attributes.py` に追記する場合のみ）
+
+- [ ] `attribute_name` が `^[a-z][a-z0-9_]*$` パターンに一致
+- [ ] ファイル名と `attribute_name` が完全一致
+- [ ] カテゴリ別数量制約 (personality 10 / speech 8 / archetype 7) 維持 (Round 1 確定 25 属性)
+  - 増減させる場合は別 Issue で議論 (本 PR では 25 属性の維持を期待)
+- [ ] `attribute_category` が `personality` / `speech` / `archetype` のいずれか
+- [ ] `display_name_ja` / `display_name_en` 両方記載
+- [ ] `weight_dimension` が `none` / `mild` / `moderate` / `strong` のいずれか
+- [ ] `description_ja` / `description_en` 両方記載
+- [ ] `examples` が 1 件以上 (5 件推奨: 注入 / 強度調整 x2 / 互換性 / NG)
+- [ ] `compatible_archetypes` / `conflicts_with` の参照先属性が `attributes/` 配下に実在
+- [ ] 固有名詞・特定作品を含まない (Round 1 仕様遵守)
+- [ ] `_check_uniqueness` (attribute_name 重複) / `_check_category_counts` (数量制約) / `_check_compat_refs` (参照整合) を `gen_v1_attributes.py` 起動時チェックで担保
+- [ ] 任意 6 フィールド (`core_traits` / `speech_style` / `second_person` / `sentence_endings` / `catchphrases` / `tone`) のうち、属性カテゴリに応じて必要なものを投入
+  - personality: `core_traits` (3-7 個) + `catchphrases` (1-15 個) + `tone` (1 行)
+  - speech: `speech_style` + `second_person` + `sentence_endings` + `catchphrases` + `tone`
+  - archetype: `catchphrases` + `tone`
+- [ ] 1 コミット = 1 属性（コミットメッセージ: `feat: <attribute_name> <category> attribute (T3 / Round N)`）
+
+## 既存属性更新の場合
+
+- [ ] 更新ファイル: `attributes/<category>/<name>.yaml`
+- [ ] 更新内容（修正前 → 修正後）: ____
+- [ ] `gen_v1_attributes.py` の ATTRIBUTES リスト修正が伴っている
+- [ ] 24 残属性の量産は含まない (Round 3 でユーザー承認後に別途着手)
+
+## 検証
+
+- [ ] `python scripts/validate.py` 出力: 25 ファイル、エラー 0
+- [ ] `pytest` 出力: 80+ ケース PASS
+- [ ] `git diff --stat` の要約: ____
+- [ ] `gen_v1_attributes.py` 起動時チェック (`_check_uniqueness` / `_check_category_counts` / `_check_compat_refs`) が緑
+
+## 関連 Issue
+
+Closes #____ / refs #____

hersona-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,47 @@
+# PyPI への自動公開 (Trusted Publishing / OIDC)。
+#
+# 事前設定 (オーナーが PyPI 側で 1 回だけ実施):
+#   PyPI → Manage → Publishing → Add a new publisher
+#   owner: shiro-0x / repository: hersona / workflow: publish.yml / environment: pypi
+#
+# リリース手順: pyproject.toml の version を上げて `git tag v1.3.0 && git push --tags`
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - name: Build sdist and wheel
+        run: uv build
+      - name: Smoke test wheel in clean env
+        run: |
+          uv venv /tmp/smoke
+          uv pip install --python /tmp/smoke/bin/python dist/*.whl
+          /tmp/smoke/bin/python -c "
+          from hersona.core import render_blend, available_attributes
+          assert len(available_attributes()) >= 64
+          assert 'tsundere' in render_blend(['tsundere']).prompt
+          print('wheel smoke test OK')"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

hersona-0.0.1/.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+.venv/
+venv/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+.idea/
+.vscode/
+.claude/
+*.swp
+
+# Temporary
+*.tmp
+*.bak
+*~
+
+# Backup files (e.g. power.yaml.orig)
+*.orig
+
+# Secrets / local config
+.env
+.env.local
+.env.*.local
+
+# User-authored attributes (ROADMAP ③: ローカル＝自由 / 公開は汎用のみ)
+attributes/user/
+
+# Python caches
+__pycache__/
+*.pyc
+*.pyo
+
+# Tool caches
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.pyright_cache/

hersona-0.0.1/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- `weight_for_score(score, *, previous, thresholds, hysteresis)` public API — maps a
+  0–100 continuous score to a `WeightLevel`, with optional hysteresis (the level only
+  changes once the score crosses a threshold by ±`hysteresis`). Intended for the duet
+  emotion/affection dial.
+- `docs/PUBLIC_API.md` declaring `hersona.core.__all__` as the semver-stable public API.
+  `tests/test_public_api.py` keeps the document and `__all__` in sync automatically.
+- PyPI packaging: the wheel now bundles `attributes/` and `schema/` under `hersona/data/`
+  (resolved by `hersona/core/paths.py` for both the repo and installed layouts).
+  `.github/workflows/publish.yml` publishes to PyPI via Trusted Publishing on `v*` tags.
+  `tests/test_packaging.py` regression-tests the bundled contents.
+
+### Changed
+- pyproject: PyPI metadata (English `description` / `keywords` / `classifiers` / `urls`);
+  removed the unused `requests` dependency; the dev-only `scripts/` is excluded from the wheel.
+
+## [0.0.1] - 2026-06-13
+
+### Added
+- 64 attribute templates (personality 20 / speech 25 / archetype 9 / visual 5 / hobby 5)
+- `schema/attribute.schema.json` for attribute validation
+- `hersona` CLI (`list` / `show` / `matrix` / `blend` / `recommend` / `create` / `measure`)
+- Compatibility matrix with conflict/compatible resolution
+- Intensity scoring for speech attributes
+- Diagnostic quiz with multilingual support (en/ja)
+- `skills/hersona/SKILL.md` for Hermes Agent integration
+- MIT license for code, CC0 1.0 for attribute templates

hersona-0.0.1/CONTRIBUTING.md

@@ -0,0 +1,82 @@
+# コントリビュートガイド
+
+hersona プロジェクトへの貢献ありがとうございます。
+
+## hersona v1.0 のアーキテクチャ要約
+
+v1.0 では従来の「data/<作品>/<キャラ>.yaml 方式」は廃止し、
+LLM のシステムプロンプトに「属性テンプレート (`attributes/<category>/<name>.yaml`)」
+を直接アタッチする方式に移行しました。
+
+- セリフ集の事前収集は不要 (LLM が解釈段階で属性を発現)
+- キャラ別 YAML は不要 (ユーザーが必要属性を割り当てる)
+- 属性テンプレートの追加・改善が本リポジトリの中心作業
+
+## 開発フロー
+
+```
+属性テンプレート追加 (attribute author) → スキーマ検証 (validator) → PR レビュー
+```
+
+## 属性テンプレートの追加
+
+### 1. 配置場所の決定
+
+`attributes/<category>/<name>.yaml` に配置。`<category>` は以下 3 種:
+
+- `personality` — 性格特性 (tsundere, kuudere 等)
+- `speech` — 話し方 (keigo, archaic, kansai_ben 等)
+- `archetype` — 役割 (heroine, mentor, rival 等)
+
+`<name>` はスネークケース (例: `tsundere`, `boku_girl`)。
+
+### 2. YAML 生成
+
+`schema/attribute.schema.json` に準拠。`scripts/_oneoff/gen_v1_attributes.py`
+が既存 25 属性の雛形なので、これを参考に手作業または LLM で生成可能。
+
+各属性 YAML が持つ主要フィールド:
+
+- `attribute_category` / `attribute_name` — 配置と一致
+- `display_name_ja` / `display_name_en` — 表示名
+- `weight_dimension` — 強度軸 (mild / moderate / strong / none)
+- `typical_value_range` — 典型的な強度レンジ
+- `description_ja` / `description_en` — 説明
+- `core_traits` — 性格特性リスト (3-7 個目安)
+- `catchphrases` — 口癖リスト (任意)
+- `tone` — 1 行程度の口調説明 (任意)
+- `examples` — AI エージェント活用例 (5 パターン推奨: 注入 / 強度調整 / 互換性 / NG)
+- `compatible_archetypes` / `conflicts_with` — 他の archetype との関係
+- `tags` — 検索用タグ
+
+### 3. 検証
+
+```bash
+python scripts/validate.py
+```
+
+全 attributes/ YAML がスキーマと整合するか確認。エラーが出たら修正して再実行。
+
+### 4. コミット・PR
+
+```bash
+git add attributes/<category>/<name>.yaml
+git commit -m "feat(attributes): add <category>/<name>"
+git push origin wt/<branch>
+```
+
+PR テンプレートに従って記載。リブラがレビューしてマージ。
+
+## プルリクエスト
+
+PR テンプレートに従って記載。review 待ち。リブラが承認したらマージ。
+PR 1 件 = 1 属性追加が基本。複数追加時は事前 Issue で合意。
+
+## ライセンス方針
+
+- `attributes/` 配下のテンプレートは CC0 (public domain dedication) — `LICENSE-CC0.txt` 参照
+- 商用利用可否や LLM 出力の責任は `DISCLAIMER.md` を参照
+
+## 質問・相談
+
+GitHub Issue で。ラベル `question` を付けてください。

hersona-0.0.1/DISCLAIMER.md

@@ -0,0 +1,51 @@
+# Disclaimer
+
+## 1. Purpose
+
+This repository is a research project for **LLM persona template composition**.
+
+The `attributes/` directory ships generic personality / speech / archetype / visual /
+hobby attribute templates. These templates are designed to be combined (blended) at
+runtime to construct LLM persona configurations.
+
+## 2. Intended Use
+
+The bundled templates are intended for:
+
+- Research into modular LLM persona construction
+- Experimentation with attribute blending
+- Building production LLM systems with configurable personas
+
+The bundled templates are **not** intended to reproduce, impersonate, or derive from
+any specific copyrighted character, person, or creative work.
+
+## 3. Licensing
+
+- Code (the `hersona` package, CLI, scripts, schema): MIT
+- Attribute templates (`attributes/**/*.yaml`): CC0 1.0 (public domain dedication)
+- Documentation: CC-BY-4.0
+
+Users of this repository are responsible for ensuring their own use complies with
+applicable laws and the terms of any third-party services they integrate with.
+
+## 4. LLM Output
+
+Outputs produced by LLMs that consume the bundled templates are **not** the work of
+this project and are not endorsed, approved, or licensed by this project. The
+handling (publication, distribution, commercial use) of LLM outputs is the sole
+responsibility of the user.
+
+## 5. No Warranty
+
+This repository is provided "as is", without warranty of any kind. The authors are
+not liable for any damages arising from use of this repository.
+
+## 6. Contact
+
+To report an issue:
+- GitHub: @shiro-0x
+- Email: seren1001@example.com
+
+---
+
+Last updated: 2026-06-11

hersona-0.0.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+============
+
+Copyright (c) 2026 hersona contributors
+
+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.

hersona-0.0.1/LICENSE-CC0.txt

@@ -0,0 +1,73 @@
+Creative Commons CC0 1.0 Universal
+====================================
+
+CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
+==================================================
+
+This is a human-readable summary of the Legal Code (the full text is at
+<https://creativecommons.org/publicdomain/zero/1.0/legalcode>).
+
+No Copyright
+------------
+
+The person who associated a work with this deed has dedicated the work to
+the public domain by waiving all rights worldwide under copyright law,
+including all related and neighboring rights, to the extent allowed by law.
+
+You can copy, modify, distribute and perform the work, even for commercial
+purposes, all without asking permission.
+
+Other Rights
+------------
+
+The following rights are not affected by CC0, nor are they waived or
+dedicated:
+
+- The moral rights of the author (to the extent they exist);
+- Rights that other persons may have in the work itself (such as publicity
+  or privacy rights); and
+- Patent or trademark rights of the author.
+
+In no way are any of the above rights affected by the following:
+
+- The license of the underlying database or dataset from which the work is
+  derived; or
+- Your fair dealing or fair use rights, or other applicable copyright
+  exceptions and limitations.
+
+Notice
+------
+
+Creative Commons is not a party to this public domain dedication. While
+Creative Commons is not a party to this public license, it may apply the
+license to material it publishes; in that case, it will be the only party
+who may enforce the license.
+
+When using or citing the work, you should not imply endorsement by
+Creative Commons.
+
+==================================================
+
+Full Legal Text: https://creativecommons.org/publicdomain/zero/1.0/legalcode
+
+==================================================
+
+CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION
+ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE
+USE OF THIS DOCUMENT, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+ITS USE.
+
+==================================================
+
+Purpose in this repository
+--------------------------
+
+This LICENSE-CC0.txt applies to attribute-template metadata files
+(attributes/**/*.yaml) — i.e. the reusable "personality / speech / archetype"
+attribute catalogs. They are released to the public domain so that downstream
+projects can reuse the attribute vocabulary without attribution friction.
+
+The repository's primary LICENSE (MIT) covers the code itself
+(scripts/, schema/*.json, etc.).