another-mood 0.1.0__tar.gz

another_mood-0.1.0/.claude/settings.json

@@ -0,0 +1,20 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run ruff format $CLAUDE_FILE_PATHS"
+          }
+        ]
+      }
+    ]
+  },
+  "permissions": {
+    "allow": [
+      "mcp__another-mood"
+    ]
+  }
+}

another_mood-0.1.0/.devcontainer/README.md

@@ -0,0 +1,16 @@
+# Dev Container
+
+## 環境仕様
+
+- **ベースイメージ**: `mcr.microsoft.com/devcontainers/base:ubuntu`
+- **Python**: uv で管理
+- **Node.js**: npm グローバルツール用（Claude Code CLI, ast-grep）
+- **Go**: MCP Language Server のビルド用
+
+詳細は [dev-docs/contents/dev/environment.md](../dev-docs/contents/30-dev/20-environment.md) を参照。
+
+## 使い方
+
+1. VSCode で「Reopen in Container」を選択
+2. 初回は postCreateCommand で Claude Code CLI 等が自動インストールされる
+3. 動作確認は [dev-docs/contents/dev/environment.md の確認手順](../dev-docs/contents/30-dev/20-environment.md#動作確認) を参照

another_mood-0.1.0/.devcontainer/devcontainer-lock.json

@@ -0,0 +1,24 @@
+{
+  "features": {
+    "ghcr.io/devcontainers-extra/features/uv:1": {
+      "version": "1.0.2",
+      "resolved": "ghcr.io/devcontainers-extra/features/uv@sha256:1ac5b9f17a9e9e745933d0ac2ecf758e06ed3da4423cd22c94cce4d482fd2dd8",
+      "integrity": "sha256:1ac5b9f17a9e9e745933d0ac2ecf758e06ed3da4423cd22c94cce4d482fd2dd8"
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {
+      "version": "1.1.0",
+      "resolved": "ghcr.io/devcontainers/features/github-cli@sha256:d22f50b70ed75339b4eed1ba9ecde3a1791f90e88d37936517e3bace0bbad671",
+      "integrity": "sha256:d22f50b70ed75339b4eed1ba9ecde3a1791f90e88d37936517e3bace0bbad671"
+    },
+    "ghcr.io/devcontainers/features/go:1": {
+      "version": "1.3.4",
+      "resolved": "ghcr.io/devcontainers/features/go@sha256:d85e921f91b41340055bb12b325d9d551170ed04b3b832e33530bf42f167c032",
+      "integrity": "sha256:d85e921f91b41340055bb12b325d9d551170ed04b3b832e33530bf42f167c032"
+    },
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "1.7.1",
+      "resolved": "ghcr.io/devcontainers/features/node@sha256:8c0de46939b61958041700ee89e3493f3b2e4131a06dc46b4d9423427d06e5f6",
+      "integrity": "sha256:8c0de46939b61958041700ee89e3493f3b2e4131a06dc46b4d9423427d06e5f6"
+    }
+  }
+}

another_mood-0.1.0/.devcontainer/devcontainer.json

@@ -0,0 +1,41 @@
+{
+  "name": "another-mood",
+  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
+
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "ghcr.io/devcontainers/features/go:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers-extra/features/uv:1": {}
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "anthropic.claude-code",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "ms-python.debugpy",
+        "ms-python.python-env-manager",
+        "ms-vscode.makefile-tools",
+        "charliermarsh.ruff",
+        "editorconfig.editorconfig",
+        "redhat.vscode-yaml",
+        "bierner.markdown-mermaid",
+        "github.vscode-github-actions"
+      ]
+    }
+  },
+
+  "mounts": ["source=another-mood-claude-${devcontainerId},target=/home/vscode/.claude,type=volume"],
+
+  "postCreateCommand": {
+    "claude-home": "sudo chown -R vscode:vscode /home/vscode/.claude",
+    "claude-code": "npm install -g @anthropic-ai/claude-code",
+    "mcp-language-server": "go install github.com/isaacphi/mcp-language-server@latest",
+    "ast-grep": "npm install -g @ast-grep/cli",
+    "playwright-deps": "sudo apt-get update && sudo apt-get install -y fonts-noto-cjk && (npx -y playwright install chrome || true) && command -v google-chrome"
+  },
+
+  "remoteUser": "vscode"
+}

another_mood-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,13 @@
+## Summary
+
+<!-- 1-3 bullets describing what this PR changes and why -->
+
+## Test plan
+
+<!-- Bulleted markdown checklist of TODOs for testing -->
+
+## Checks
+
+- [ ] `make ci` passes locally
+- [ ] If user-visible behavior changed, `docs/reference/` (and `docs/guides.md` when relevant) are updated to match
+- [ ] If built-in resources under `src/another_mood/resources/schemas/` changed, the corresponding appendix in `docs/reference/` is in sync

another_mood-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      # Both ends of the supported range: the floor declared by
+      # requires-python, and the newest version most users will install on.
+      # setup-uv exports UV_PYTHON, which outranks the .python-version file.
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - run: uv sync --locked
+
+      - run: make ci
+
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: test-reports-py${{ matrix.python-version }}
+          path: reports/
+          retention-days: 30

another_mood-0.1.0/.github/workflows/fresh-deps.yml

@@ -0,0 +1,37 @@
+name: Fresh dependency check
+
+# Early-warning, non-blocking counterpart to ci.yml. ci.yml gates PRs against
+# the committed uv.lock; this workflow re-resolves dependencies to the latest
+# versions our constraints allow, mirroring what end users get from
+# `uv tool install` (which ignores uv.lock). It runs on a schedule so an
+# upstream release never reds an unrelated PR — failures here are a signal to
+# bump or cap a dependency before users hit the breakage.
+
+on:
+  schedule:
+    - cron: "0 0 * * 1" # Mondays 00:00 UTC
+  workflow_dispatch:
+
+jobs:
+  # The essential check: reproduce the isolated, freshly-resolved environment
+  # of `uv tool install`. Only this path exercises entry-point shim behaviour,
+  # so it catches binary-resolution bugs that ci.yml (running via `uv run` in
+  # the project .venv) cannot.
+  install-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - name: Build via the `uv tool install` resolution path
+        run: uvx --from . --refresh-package another-mood mood build showcase/starter
+
+  # Complementary: run the full test suite against the latest allowed versions
+  # to surface upstream API breakage early.
+  fresh-resolution:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - name: Resolve to the latest versions our constraints allow
+        run: uv sync --upgrade
+      - run: make ci

another_mood-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Claude Code local settings
+.claude/settings.local.json
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# Distribution / packaging
+dist/
+*.egg-info/
+
+# Unit test / coverage reports
+reports/
+.coverage
+.coverage.*
+.pytest_cache/
+
+# Virtual environments
+.venv/
+
+# Ruff
+.ruff_cache/
+
+# Type checkers
+.mypy_cache/
+.pytype/
+
+# another-mood output
+/.another-mood/
+
+# Playwright MCP session output (page snapshots, console logs, screenshots)
+/.playwright-mcp/
+
+# OS files
+.DS_Store

another_mood-0.1.0/.mcp.json

@@ -0,0 +1,31 @@
+{
+  "mcpServers": {
+    "language-server": {
+      "command": "mcp-language-server",
+      "args": [
+        "--workspace", "/workspaces/another-mood",
+        "-lsp", "pyright-langserver", "--", "--stdio"
+      ]
+    },
+    "ast-grep": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/ast-grep/ast-grep-mcp",
+        "ast-grep-server"
+      ]
+    },
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "another-mood": {
+      "command": "uv",
+      "args": ["run", "mood-mcp"]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest", "--headless"]
+    }
+  }
+}

another_mood-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.7
+    hooks:
+      - id: ruff-format
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.24.2
+    hooks:
+      - id: gitleaks

another_mood-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

another_mood-0.1.0/.vscode/extensions.json

@@ -0,0 +1,15 @@
+{
+  "recommendations": [
+    "anthropic.claude-code",
+    "ms-python.python",
+    "ms-python.vscode-pylance",
+    "ms-python.debugpy",
+    "ms-python.python-env-manager",
+    "ms-vscode.makefile-tools",
+    "charliermarsh.ruff",
+    "editorconfig.editorconfig",
+    "redhat.vscode-yaml",
+    "bierner.markdown-mermaid",
+    "github.vscode-github-actions"
+  ]
+}

another_mood-0.1.0/.vscode/mcp.json

@@ -0,0 +1,9 @@
+{
+  "servers": {
+    "another-mood": {
+      "type": "stdio",
+      "command": "uv",
+      "args": ["run", "mood-mcp"]
+    }
+  }
+}

another_mood-0.1.0/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "editor.formatOnSave": true,
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  }
+}

another_mood-0.1.0/CLAUDE.md

@@ -0,0 +1 @@
+@DEVELOPMENT.md

another_mood-0.1.0/DEVELOPMENT.md

@@ -0,0 +1,117 @@
+# Development Guide
+
+## Conventions (Must Read)
+
+### 開発ワークフロー
+
+- 各タスクは「1タスク・1 Git ブランチ」で進める
+- タスク開始時に `make ci` を実行し、開発環境・既存コードが正常な状態であることを確認する。失敗する場合は、環境の問題ならセットアップ節を、コードの問題ならタスク着手前に修正する
+- コミットメッセージ・プルリクエストは **英語**
+
+### セットアップ
+
+ツールの動作には [uv](https://docs.astral.sh/uv/) が必要。インストール後 `uv sync` で依存を解決する。
+
+このプロジェクト自身が Another Mood でドキュメントを管理している。タスク開始時には `mood build dev-docs` でドキュメントをビルドし、仕様が参照できる状態にする。起点は [.another-mood/dev-docs/output/web/index.md](.another-mood/dev-docs/output/web/index.md)。
+
+利用者向けサンプルプロジェクト群は `showcase/`（`starter` / `music` 等の各テンプレート）にある。`mood build showcase/{name}` でビルドできる。
+
+### ドキュメント
+
+ドキュメントは以下の三系統で管理する:
+
+- **`docs/`** — 利用者向けリファレンス（外部仕様の正本）。素 Markdown、英語。実装済み機能のみ。文体は簡潔だが、正確さ・網羅性は妥協しない（MCP 経由で LLM が読む UX に直結するため）
+- **`dev-docs/background/`** — 製品ビジョン、ロードマップ、タスクカタログ等の開発判断の根拠。日本語。Another Mood で管理
+- **`dev-docs/design/`** — 設計仕様。日本語。各ファイルは以下の 3 セクション構造（該当があるもののみ）:
+    - `## External Design` — 利用者から見える振る舞いの設計判断
+    - `## Internal Design` — 内部実装の設計判断
+    - `## Proposals` — 未実装機能（task に対応）
+
+`Proposals` の検討メモは、実装完了時に削除する（部分実装なら残る検討事項のみに絞る）。維持価値のある設計判断は External / Internal Design 節に移すか、code docstring やコミットメッセージで残す。
+
+設計判断の背景・理由は、判断が書かれている場所に直接書く（ADR のように別ファイルに分離しない）。`design/` 内では「## 背景: ...」セクションとして該当箇所の近傍に書き、実装済み機能ではコードの docstring かコミットメッセージで残す。
+
+理由: 仕様と理由が同じ場所にあれば、仕様の変更時に理由も自然に目に入り、更新漏れが起きにくい。別ファイルに分離すると同期コストが発生し、仕様変更で不要になった ADR の削除・更新が漏れやすい。
+
+ドキュメントを追加・削除・移動した場合、プルリクを上げる前に以下のインデックスからのリンクを確認・更新する:
+
+- [index.md](.another-mood/dev-docs/output/web/index.md) — dev-docs 全体インデックス
+- [docs/index.md](docs/index.md) — 利用者向けトップ
+- [docs/catalog.yaml](docs/catalog.yaml) — MCP 公開対象のカタログ
+- [DEVELOPMENT.md](DEVELOPMENT.md) — 開発者向けポインタ
+
+### 実装
+
+- コード内コメントは **英語**
+- ライブラリ導入は、その時点での有力なものを比較検討したうえで決定する。**選定理由はそのライブラリを使うコンポーネントの近傍（`dev-docs/design/` の対応ファイル、実装済みならコードの docstring）に残す**
+- **コードから dev-docs を参照しない**: docstring・コメントに dev-docs のパスや章名を書かない
+- docstring は API の呼び出し側に補足が必要な契約のみ（可能ならシグネチャで表現する）。コメントは将来の保守者への申し送りのみ。設計判断の背景・経緯は `dev-docs/design/` かコミットメッセージへ
+
+#### パッケージ構成と依存ルール
+
+```
+another_mood/
+├── cli.py                  # CLI エントリポイント
+├── mcp_server.py           # MCP サーバエントリポイント
+├── command.py              # CLI / MCP 共通の操作層（BuildResult 等を返す）
+├── config.py               # 設定
+├── components/             # ビジネスロジック
+│   ├── shared/             #   共通基盤
+│   ├── preprocess/         #   入力の正規化・スキーマ解釈・クエリ導出
+│   ├── composer/           #   合成: データ + クエリ → ビュー
+│   ├── generator/          #   生成: ビュー + テンプレート → Markdown
+│   ├── publish/            #   出力の書き出し
+│   ├── scaffold/           #   プロジェクト初期化・ブループリント
+│   └── docs_catalog/       #   バンドル済みドキュメントの目録
+├── pipeline/               # オーケストレーション: ステージ実行
+│   └── adapters/           #   外部ツール連携（Hugo, watchfiles）
+└── resources/              # 静的リソース
+```
+
+依存方向: `{cli, mcp_server}` → `command` → `pipeline` → `components/*` → `components/shared`
+
+#### コードスタイル
+
+- **関数型スタイルを優先**: `for` ループより内包表記、`map/filter` 等。引数・戻り値はイミュータブル型（`dict` → `Mapping`、`list` → `Sequence` 等）
+- **`Any` はなるべく使わない**: `object` 等で型安全性を保つ
+- **命名はモジュール名に合わせる**: `source` モジュールなら `is_source_file`, `build_source`
+- **関数の並び順（Newspaper style）**: 公開 API を先頭、ヘルパーを後ろ。ヘルパーはパイプライン順
+- **`@dataclass` は `frozen=True`**: `__init__` ボイラープレート削減目的、immutable がデフォルト
+- **制御フローは論理の形に合わせる**: 両枝が対等な結果を返す *対称な分岐* は `if/else`（両枝が `return` でも `else` を畳まない）。前提失敗・エラー・エッジを先頭で剥がす *非対称な bail-out* のみ guard clause（早期 `return`）。`else` とインデントは条件付き領域の境界情報なので、機能的に冗長でも残す（*explicit is better than implicit*）。`else` を機械的に除去させる pylint `no-else-return` / ruff `RET505` は採らない（RET は `select` 外）
+
+#### テスト
+
+- **カバレッジ計測対象**: `components/`。Statements + Branches トータルで 90% 以上
+- **フィクスチャ**: ファイルベース、モジュール隣接型。期待値はテストコード内に記述
+
+#### 動作確認 (`mood watch` + Playwright MCP)
+
+`showcase/` や `dev-docs/` のテンプレート変更を実機で確認するときは `mood watch <project_dir> --port <port>` でローカルプレビューを上げ、必要なら Playwright MCP でレンダリングを観る。Playwright MCP の作業ファイルはすべて `.gitignore` 済みの `.playwright-mcp/` 配下に集約する:
+
+- ページスナップショット / console ログは Playwright MCP が自動でこのディレクトリに出す
+- スクリーンショットは `browser_take_screenshot` の `filename` に `.playwright-mcp/<name>.png` を指定する (デフォルトは cwd 直下に落ちて散らかる)
+
+検証目的のスクショは再現可能なので、コミット前に削除して構わない。
+
+#### タスクの進め方
+
+非自明な機能追加・変更では、まず `dev-docs/design/` の対応ファイル `## Proposals` セクション（必要なら新規ファイル）に検討メモを書いて方針を合意してから着手する。以降の手順:
+
+1. 以下をタスクに応じた順序で進める:
+    - **showcase/ のテンプレートに入出力例を作成**
+    - **単体テストを記述**
+    - **実装**
+2. **showcase/ で動作確認**
+3. **`docs/` を同期** — ユーザに見える挙動（CLI / スキーマ / クエリ / テンプレートの仕様、内蔵リソース等）が変わった場合に `docs/reference/` 各章および必要に応じて `docs/guides.md` を更新
+4. **`Proposals` の整理** — 対応ファイルの `## Proposals` から該当の検討メモを削除（部分実装の場合は残る検討事項のみに絞る）。維持価値のある設計判断は External / Internal Design 節に移すか、コードの docstring に残す
+5. `make ci` を通してコミット → プルリク作成
+
+## Documentation (Reference)
+
+ドキュメントの閲覧先は `.another-mood/dev-docs/output/web/`。
+
+- [index.md](.another-mood/dev-docs/output/web/index.md) — 仕様・設計
+- [background/product.md](.another-mood/dev-docs/output/web/prose/10-background/10-product.md) — 製品ビジョン
+- [roadmap.md](.another-mood/dev-docs/output/web/roadmap.md) — ロードマップ
+- [tasks.md](.another-mood/dev-docs/output/web/tasks.md) — タスクカタログ
+- [dev/style-guide.md](.another-mood/dev-docs/output/web/prose/30-dev/40-style-guide.md) — 命名・自己定義の表記規約

another_mood-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kiyofumi Watanabe
+
+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.

another_mood-0.1.0/Makefile

@@ -0,0 +1,44 @@
+.PHONY: ci format-check lint typecheck test secrets build-projects format mirror-schemas stats
+
+ci: format-check lint typecheck test secrets build-projects
+
+format-check:
+	uv run ruff format --check .
+
+lint:
+	uv run ruff check .
+
+typecheck:
+	uv run pyright --warnings
+
+test:
+	uv run pytest --cov --cov-fail-under=90 --junitxml=reports/junit.xml --cov-report=xml:reports/coverage.xml --cov-report=html:reports/htmlcov
+
+secrets:
+	uv run pre-commit run gitleaks --all-files
+
+build-projects:
+	uv run mood build dev-docs
+	@for name in $$(uv run mood blueprint list --names-only); do \
+		echo "uv run mood build showcase/$$name"; \
+		uv run mood build showcase/$$name || exit 1; \
+	done
+
+format:
+	uv run ruff format .
+
+mirror-schemas:
+	cp src/another_mood/resources/schemas/*.yaml docs/reference/schemas/
+
+# Project-size overview. cloc (the de-facto line counter) is run via the
+# bundled `cloc-python`, fetched and cached by `uvx` — no system install.
+# `--vcs=git` with a path counts only git-tracked files under that area.
+STAT_AREAS = src tests
+
+stats:
+	@uvx cloc-python --vcs=git .
+	@for d in $(STAT_AREAS); do \
+		echo ""; \
+		echo "== $$d =="; \
+		uvx cloc-python --vcs=git "$$d"; \
+	done

another_mood-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: another-mood
+Version: 0.1.0
+Summary: A processor of source-based databases, keeping related documents in sync.
+Project-URL: Homepage, https://github.com/watanabe-kf1983/another-mood
+Project-URL: Repository, https://github.com/watanabe-kf1983/another-mood
+Project-URL: Issues, https://github.com/watanabe-kf1983/another-mood/issues
+Project-URL: Documentation, https://github.com/watanabe-kf1983/another-mood/tree/main/docs
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: filelock>=3.25.2
+Requires-Dist: hugo>=0.162.0
+Requires-Dist: markdown-it-py>=4.0.0
+Requires-Dist: markupsafe>=3.0.3
+Requires-Dist: mcp>=1.28.1
+Requires-Dist: minijinja>=2.21.0
+Requires-Dist: packaging>=26.0
+Requires-Dist: pydantic-settings>=2.14.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: regex>=2026.4.4
+Requires-Dist: ruamel-yaml>=0.19.1
+Requires-Dist: typer>=0.24.1
+Requires-Dist: watchdog>=6.0.0
+Description-Content-Type: text/markdown
+
+# Another Mood
+
+A processor of source-based databases, keeping related documents in sync.
+
+Requirements specifications, product catalogs, maintenance manuals, training materials — documents like these keep describing the same things in different shapes. Introduce one new thing and you have to chase the same edit through several files, miss one, and let the set drift out of sync.
+
+Another Mood keeps that set consistent. You write the data once as **sources** — YAML records and Markdown prose — alongside templates that say how pages are built from them. Edit a source, rebuild, and every page derived from it regenerates together.
+
+## Install
+
+Requires Python 3.12 or later.
+
+```bash
+pipx install another-mood
+```
+
+If you use [uv](https://docs.astral.sh/uv/), `uv tool install` takes the same argument and fetches a suitable Python for you. Either way you get the `mood` command on your PATH, along with `mood-mcp` for coding agents.
+
+## Quick start
+
+```bash
+mood init my-project
+mood build my-project
+```
+
+`mood init` scaffolds a small sample database; `mood build` turns it into Markdown and HTML under `.another-mood/my-project/`.
+
+## Documentation
+
+[User guide](https://github.com/watanabe-kf1983/another-mood/blob/main/docs/index.md) — concepts and walkthrough, per-feature reference, and how to give coding agents the same operations over MCP. It ships with the package too, so an agent can read it through the MCP server without leaving your project.

another_mood-0.1.0/README.md

@@ -0,0 +1,30 @@
+# Another Mood
+
+A processor of source-based databases, keeping related documents in sync.
+
+Requirements specifications, product catalogs, maintenance manuals, training materials — documents like these keep describing the same things in different shapes. Introduce one new thing and you have to chase the same edit through several files, miss one, and let the set drift out of sync.
+
+Another Mood keeps that set consistent. You write the data once as **sources** — YAML records and Markdown prose — alongside templates that say how pages are built from them. Edit a source, rebuild, and every page derived from it regenerates together.
+
+## Install
+
+Requires Python 3.12 or later.
+
+```bash
+pipx install another-mood
+```
+
+If you use [uv](https://docs.astral.sh/uv/), `uv tool install` takes the same argument and fetches a suitable Python for you. Either way you get the `mood` command on your PATH, along with `mood-mcp` for coding agents.
+
+## Quick start
+
+```bash
+mood init my-project
+mood build my-project
+```
+
+`mood init` scaffolds a small sample database; `mood build` turns it into Markdown and HTML under `.another-mood/my-project/`.
+
+## Documentation
+
+[User guide](https://github.com/watanabe-kf1983/another-mood/blob/main/docs/index.md) — concepts and walkthrough, per-feature reference, and how to give coding agents the same operations over MCP. It ships with the package too, so an agent can read it through the MCP server without leaving your project.