sayane 1.0.3__tar.gz

sayane-1.0.3/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,90 @@
+---
+name: Bug report
+description: Report incorrect behavior, regression, or security/privacy issue
+title: "[Bug]: "
+labels: ["type: bug", "needs: triage"]
+assignees: []
+---
+
+## 概要
+
+何が起きたかを簡潔に書く。
+
+## 再現手順
+
+1. 
+2. 
+3. 
+
+## 期待される動作
+
+本来どう動くべきかを書く。
+
+## 実際の動作
+
+実際にどう動いたかを書く。
+
+## 影響範囲
+
+- [ ] Core
+- [ ] CLI
+- [ ] Local Bridge
+- [ ] MCP Server
+- [ ] Chrome Extension
+- [ ] Adapter
+- [ ] Evaluator
+- [ ] Storage
+- [ ] Documentation
+- [ ] Security/privacy
+
+## 環境
+
+```text
+OS:
+Python:
+Node:
+Browser:
+Sayane version / commit:
+```
+
+## ログ / 出力
+
+機微情報、token、API key、private keyを含めないこと。
+
+```text
+ここにログを貼る
+```
+
+## RDE観点
+
+### 保存された要素
+
+修正後も保存すべき仕様・意味・挙動を書く。
+
+### 疑わしい逸脱
+
+この不具合がどのような意味変化、Profile汚染、policy逸脱、誤変換を引き起こし得るかを書く。
+
+### 重大な歪曲の可能性
+
+ユーザーの人格的文脈、values、policy、identityを誤って扱う可能性がある場合は明記する。
+
+## テスト方針
+
+この不具合を再発防止するためのテストを書く。
+
+- [ ] Reproduction test
+- [ ] Regression test
+- [ ] Contract test
+- [ ] Security/privacy test
+
+## Security / Privacy確認
+
+- [ ] secretがログや出力に含まれていない
+- [ ] Profile本体が意図せず変更されていない
+- [ ] Candidate Updateが承認なしにmergeされていない
+- [ ] localhost / MCP / Extension境界に影響がない
+
+## 追加情報
+
+補足があれば書く。

sayane-1.0.3/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Sayane documentation
+    url: https://github.com/zyx-corporation/sayane/tree/main/docs
+    about: Please read the design documents before opening a broad architectural issue.

sayane-1.0.3/.github/ISSUE_TEMPLATE/docs_design.md

@@ -0,0 +1,89 @@
+---
+name: Docs / design change
+description: Propose a documentation, architecture, or design principle change
+title: "[Docs/Design]: "
+labels: ["type: docs", "type: design", "needs: triage"]
+assignees: []
+---
+
+## 目的
+
+この設計変更・文書変更で達成したいことを書く。
+
+## 背景
+
+変更が必要になった理由を書く。
+
+関連文書:
+
+- `docs/architecture.md`
+- `docs/profile-ir.md`
+- `docs/mvp-scope.md`
+- `docs/security.md`
+- `docs/mcp-integration.md`
+- `docs/extraction-pipeline.md`
+- `docs/evaluation-lineage.md`
+- `docs/development-principles.md`
+- `docs/roadmap.md`
+
+## 対象文書 / 対象設計
+
+変更対象を書く。
+
+- [ ] README.md
+- [ ] README_ja.md
+- [ ] docs/architecture.md
+- [ ] docs/profile-ir.md
+- [ ] docs/mvp-scope.md
+- [ ] docs/security.md
+- [ ] docs/mcp-integration.md
+- [ ] docs/extraction-pipeline.md
+- [ ] docs/evaluation-lineage.md
+- [ ] docs/development-principles.md
+- [ ] docs/roadmap.md
+- [ ] Other: 
+
+## 提案内容
+
+変更案を書く。
+
+## 非対象範囲
+
+今回扱わない内容を書く。
+
+## RDE差異検証
+
+### 保存された要素
+
+元の議論・意図・設計思想のうち保存するものを書く。
+
+### 変換された要素
+
+表現や構造がどう変わるかを書く。
+
+### 補完された要素
+
+新たに追加する前提、説明、制約を書く。
+
+### 未解決の要素
+
+この変更でも残る問題を書く。
+
+### 逸脱リスク
+
+強すぎる主張、未検証内容、射程の縮小、実装都合の理論化などのリスクを書く。
+
+## 受け入れ条件
+
+- [ ] 文書リンクが壊れていない
+- [ ] 用語が既存docsと整合している
+- [ ] 過剰主張を避けている
+- [ ] 必要ならREADME / docs/index.mdへリンクを追加している
+- [ ] RDE観点が確認されている
+
+## テスト / 確認方針
+
+- [ ] Markdown lint
+- [ ] リンク確認
+- [ ] 既存ドキュメントとの整合性確認
+- [ ] RDEレビュー

sayane-1.0.3/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,105 @@
+---
+name: Feature request
+description: Propose a new Sayane feature or capability
+title: "[Feature]: "
+labels: ["type: feature", "needs: triage"]
+assignees: []
+---
+
+## 目的
+
+このIssueで実現したいことを簡潔に書く。
+
+## 背景
+
+なぜ必要か。どの設計文書、利用シナリオ、Phaseに関係するかを書く。
+
+関連文書:
+
+- `docs/roadmap.md`
+- `docs/mvp-scope.md`
+- `docs/development-principles.md`
+
+## 対象範囲
+
+このIssueで扱う範囲を書く。
+
+- [ ] Core
+- [ ] CLI
+- [ ] Local Bridge
+- [ ] MCP Server
+- [ ] Chrome Extension
+- [ ] Adapter
+- [ ] Evaluator
+- [ ] Storage
+- [ ] Documentation
+
+## 非対象範囲
+
+このIssueでは扱わないことを書く。
+
+## 提案内容
+
+機能案、API案、CLI案、データ構造案などを書く。
+
+```text
+例:
+sayane compile --target claude
+```
+
+## 受け入れ条件
+
+このIssueを完了とみなす条件を書く。
+
+- [ ] 
+- [ ] 
+- [ ] 
+
+## RDE観点
+
+### 保存された要素
+
+元の設計思想・文脈・制約のうち、保存すべきものを書く。
+
+### 許可された変換
+
+このIssueで許可される設計・実装上の変換を書く。
+
+### 補完される要素
+
+新たに補完される仕様・実装・文書を書く。
+
+### 未解決の要素
+
+このIssueで解決しない問題を書く。
+
+### 逸脱リスク
+
+元の意図から外れる可能性、過剰実装、過剰主張、security/privacyリスクを書く。
+
+## テスト方針
+
+TDD/test firstの観点から、先に書くべきテストを書く。
+
+- [ ] Unit test
+- [ ] Contract test
+- [ ] Regression test
+- [ ] Security/privacy test
+- [ ] Documentation check
+
+## デザインパターン
+
+適用予定のデザインパターンを書く。
+
+- [ ] Adapter
+- [ ] Strategy
+- [ ] Builder
+- [ ] Factory
+- [ ] Decorator
+- [ ] Observer
+- [ ] Repository
+- [ ] Other: 
+
+## 依存Issue / 関連Issue
+
+- 

sayane-1.0.3/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,172 @@
+# Pull Request
+
+## 関連Issue
+
+Closes #
+
+## 概要
+
+このPRで変更した内容を簡潔に書く。
+
+## 変更種別
+
+- [ ] feature
+- [ ] bug fix
+- [ ] docs / design
+- [ ] refactor
+- [ ] test
+- [ ] security / privacy
+- [ ] chore
+
+## 対象範囲
+
+- [ ] Core
+- [ ] CLI
+- [ ] Local Bridge
+- [ ] MCP Server
+- [ ] Chrome Extension
+- [ ] Adapter
+- [ ] Strategy
+- [ ] Evaluator
+- [ ] Storage
+- [ ] Documentation
+- [ ] CI / tooling
+
+## Branch first 確認
+
+- [ ] mainへ直接pushしていない
+- [ ] Issueに対応したbranchで作業している
+- [ ] branch名が目的を表している
+
+Branch:
+
+```text
+feature/<issue-number>-<short-name>
+fix/<issue-number>-<short-name>
+docs/<issue-number>-<short-name>
+refactor/<issue-number>-<short-name>
+test/<issue-number>-<short-name>
+```
+
+## TDD / test first 確認
+
+- [ ] 先に失敗するテストを書いた、または既存テストで再現した
+- [ ] 最小実装でテストを通した
+- [ ] refactor後もテストが通る
+- [ ] テスト追加が不要な場合、その理由を下に記載した
+
+テスト不要の理由:
+
+```text
+
+```
+
+## 実行したテスト
+
+```bash
+# 実行したコマンドを書く
+```
+
+## RDEレビュー
+
+### 保存された要素
+
+元Issue、既存設計、既存挙動のうち、保存されたものを書く。
+
+### 許可された変換
+
+このPRで許可された仕様・実装・文書上の変換を書く。
+
+### 推論による補完
+
+既存文書やIssueから推論して補完した内容があれば書く。
+
+### 未解決の要素
+
+このPRでは解決しない問題を書く。
+
+### 逸脱リスク
+
+以下を確認する。
+
+- [ ] 元Issueより強い主張になっていない
+- [ ] 未検証内容を実証済みとして扱っていない
+- [ ] 実装上の便宜を設計思想として正当化していない
+- [ ] Profile / Prompt IR / Lineage の意味を意図せず変えていない
+- [ ] 同一人格の完全再現を示唆していない
+- [ ] 自動mergeや自動Profile更新を導入していない、または明示承認を維持している
+
+補足:
+
+```text
+
+```
+
+## デザインパターン確認
+
+このPRで利用・追加・維持したパターンを選ぶ。
+
+- [ ] Adapter
+- [ ] Strategy
+- [ ] Builder
+- [ ] Factory
+- [ ] Decorator
+- [ ] Observer
+- [ ] Repository
+- [ ] なし
+- [ ] Other: 
+
+設計上の補足:
+
+```text
+
+```
+
+## Security / Privacy確認
+
+- [ ] secret、token、API key、private keyを含めていない
+- [ ] ログやテストfixtureに機微情報を含めていない
+- [ ] Local Bridge / MCP Server の認証境界を弱めていない
+- [ ] CORS / Origin / pairing token / read-only mode に悪影響がない
+- [ ] Candidate Updateが承認なしにProfileへmergeされない
+- [ ] Profile、values、policy、identityを危険に上書きしない
+- [ ] 該当なし
+
+## 互換性影響
+
+- [ ] 破壊的変更なし
+- [ ] 破壊的変更あり
+- [ ] schema変更あり
+- [ ] CLI変更あり
+- [ ] API変更あり
+- [ ] docs更新済み
+
+破壊的変更・schema変更の説明:
+
+```text
+
+```
+
+## ドキュメント更新
+
+- [ ] README.md
+- [ ] README_ja.md
+- [ ] docs/index.md
+- [ ] docs/architecture.md
+- [ ] docs/profile-ir.md
+- [ ] docs/mvp-scope.md
+- [ ] docs/security.md
+- [ ] docs/mcp-integration.md
+- [ ] docs/extraction-pipeline.md
+- [ ] docs/evaluation-lineage.md
+- [ ] docs/development-principles.md
+- [ ] docs/roadmap.md
+- [ ] 更新不要
+
+## レビュアーへの注記
+
+重点的に見てほしい点を書く。
+
+```text
+
+```

sayane-1.0.3/.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  python:
+    name: Python (lint & test)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install package with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Ruff lint
+        run: ruff check src tests
+
+      - name: Ruff format check
+        run: ruff format --check src tests
+
+      - name: Pytest
+        run: pytest -v
+
+      - name: Validate install scripts
+        run: bash -n scripts/install.sh
+
+      - name: Install script smoke test
+        env:
+          SAYANE_INSTALL_DIR: /tmp/sayane-install-test
+          SAYANE_BIN_DIR: /tmp/sayane-install-test/bin
+          SAYANE_SOURCE_DIR: ${{ github.workspace }}
+          SAYANE_SKIP_INIT: "1"
+          SAYANE_YES: "1"
+        run: |
+          bash scripts/install.sh
+          /tmp/sayane-install-test/bin/sayane --version
+
+  extension:
+    name: Extension (typecheck & build)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: extension
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: extension/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build

sayane-1.0.3/.github/workflows/extension-e2e.yml

@@ -0,0 +1,50 @@
+name: Extension E2E (Playwright)
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 6 * * 1"
+  pull_request:
+    branches: [main]
+    paths:
+      - "extension/**"
+      - "src/sayane/bridge/**"
+      - "examples/profiles/**"
+      - ".github/workflows/extension-e2e.yml"
+
+jobs:
+  playwright:
+    name: Extension DOM insert (Playwright)
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    defaults:
+      run:
+        working-directory: extension
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Sayane (dev)
+        run: pip install -e ".[dev]"
+        working-directory: ${{ github.workspace }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: extension/package-lock.json
+
+      - name: Install extension dependencies
+        run: npm ci
+
+      - name: Build extension
+        run: npm run build
+
+      - name: Install Playwright Chromium
+        run: npx playwright install --with-deps chromium
+
+      - name: Run Playwright E2E
+        run: npm run test:e2e

sayane-1.0.3/.github/workflows/publish-pypi.yml

@@ -0,0 +1,59 @@
+name: Publish PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Git tag to publish (e.g. v1.0.3)"
+        required: true
+        default: "v1.0.3"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Upload to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/sayane/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.tag }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Check dist
+        run: twine check dist/*
+
+      - name: Verify PyPI credentials configured
+        env:
+          PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          if [ -n "$PYPI_API_TOKEN" ]; then
+            echo "Using PYPI_API_TOKEN from the pypi environment."
+          else
+            echo "No PYPI_API_TOKEN — attempting PyPI Trusted Publishing (OIDC)."
+            echo "Configure at: https://pypi.org/manage/project/sayane/settings/publishing/"
+            echo "  Owner: zyx-corporation  Repo: sayane  Workflow: publish-pypi.yml"
+          fi
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}