wwxd 0.1.0__tar.gz

wwxd-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "wwxd",
+  "description": "The wwxd skill for building and querying cited knowledge wikis of a person's thinking.",
+  "owner": {
+    "name": "MSliwa01",
+    "url": "https://github.com/MSliwa01"
+  },
+  "plugins": [
+    {
+      "name": "wwxd",
+      "source": "./",
+      "description": "What would X do? Build and query cited knowledge wikis of a person's talks, podcasts and essays."
+    }
+  ]
+}

wwxd-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "wwxd",
+  "description": "What would X do? Build and query cited knowledge wikis of a person's talks, podcasts and essays.",
+  "author": {
+    "name": "MSliwa01",
+    "url": "https://github.com/MSliwa01"
+  },
+  "homepage": "https://github.com/MSliwa01/wwxd",
+  "repository": "https://github.com/MSliwa01/wwxd",
+  "license": "MIT",
+  "keywords": ["knowledge-base", "wiki", "transcripts", "podcasts", "youtube", "citations"]
+}

wwxd-0.1.0/.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,22 @@
+---
+name: Bug
+about: Something in the CLI or the skill doesn't work
+labels: bug
+---
+
+**What you ran**
+
+```
+wwxd ...
+```
+
+**What happened** (paste the output)
+
+**What you expected**
+
+**Output of `wwxd doctor`**
+
+```
+```
+
+**OS and how you installed wwxd** (plugin, uv tool, pip)

wwxd-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

wwxd-0.1.0/.github/ISSUE_TEMPLATE/opt-out.md

@@ -0,0 +1,11 @@
+---
+name: Remove a recipe (opt-out)
+about: You, or someone you represent, want an example recipe removed
+labels: opt-out
+---
+
+**Which recipe** (for example `src/wwxd/examples/hormozi`)
+
+**Your relation to the person**
+
+We remove recipes on request, without debate. See ETHICS.md.

wwxd-0.1.0/.github/ISSUE_TEMPLATE/recipe.md

@@ -0,0 +1,13 @@
+---
+name: New example recipe
+about: Suggest a person or group to add under src/wwxd/examples
+labels: recipe
+---
+
+**Who** (name, and what they're worth learning from)
+
+**Their own sources** (YouTube channels, podcast feeds, blog or essay index pages)
+
+**Why first-hand material is enough** (long-form talks, essays, interviews where they speak at length)
+
+Recipes ship source lists only, never content. See ETHICS.md.

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

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        include:
+          - os: macos-latest
+            python-version: "3.12"
+          - os: windows-latest
+            python-version: "3.12"
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: ${{ matrix.python-version }}  # sets UV_PYTHON, which overrides .python-version
+      - run: uv sync --locked --group dev
+      - run: uv run --group dev pytest -q
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+      - run: uv build
+      - name: Check the wheel ships the skill, examples and templates
+        run: |
+          files=$(unzip -Z1 dist/*.whl)
+          missing=0
+          for f in wwxd/skill/SKILL.md wwxd/skill/references/format.md wwxd/examples/yc/vault.yaml \
+                   $(cd src && find wwxd/templates -type f | sort); do
+            grep -qxF "$f" <<< "$files" || { echo "::error::missing from wheel: $f"; missing=1; }
+          done
+          exit $missing
+      - name: Install the skill from the wheel
+        run: |
+          cd "$(mktemp -d)"
+          uvx --from "$GITHUB_WORKSPACE"/dist/*.whl wwxd install-skill --project
+          test -f .claude/skills/wwxd/references/format.md

wwxd-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+      - name: Check the tag matches the package version
+        run: |
+          version=$(uv version --short)
+          if [ "v$version" != "$GITHUB_REF_NAME" ]; then
+            echo "::error::tag $GITHUB_REF_NAME does not match version $version in pyproject.toml"
+            exit 1
+          fi
+      - run: uv run --locked --group dev pytest -q
+      - run: uv build
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/wwxd/
+    permissions:
+      id-token: write  # trusted publishing, no API token
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

wwxd-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+.pytest_cache/
+.env
+vaults/
+bench/results/

wwxd-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

wwxd-0.1.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.1.0 (2026-10-11)
+
+First release.
+
+- Build a vault from YouTube videos, podcast feeds, articles and local files:
+  `discover`, curate with `approve` and `reject`, `fetch`. Captions first, then
+  transcripts published in podcast feeds, then local Whisper (`wwxd[whisper]`).
+- A Claude Code skill compiles each source into a tree of cited wiki pages and
+  answers "what would X do?" as plain advice with the sources listed underneath.
+  It also covers group vaults, thinking pages (how a person decides), panels of
+  several people, and keeping a vault current with `update`.
+- `wwxd lint` checks every quote against the raw transcripts. `wwxd voice` checks
+  who said each quote by voice (`wwxd[voice]`).
+- `wwxd estimate` prices compiling and asking per model before you spend anything.
+- `wwxd health`, `timeline`, `digest`, `search`, `status`, `doctor`.
+- `wwxd bench` runs blind comparisons with any agent as the answerer or the judge.
+  Results are in `bench/RESULTS.md`.
+- Install as a Claude Code plugin (`/plugin marketplace add MSliwa01/wwxd`) or with
+  `wwxd install-skill`.

wwxd-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,107 @@
+# Contributing
+
+Thanks for helping. The most useful contributions, roughly in order:
+
+1. **Gold sets** for the example vaults (`bench/gold/`): questions tied to specific public sources, including `expect: abstain` questions.
+2. **Bench results**: tree vs. flat, prompt and skill variants. Open a PR with the numbers and the setup.
+3. **Fetchers** for new source types.
+4. **Example recipes** (`src/wwxd/examples/<name>/vault.yaml`): source configs only, never content. Prefer people with lots of first-hand, long-form, publicly available material.
+
+## Dev setup
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run wwxd --help
+```
+
+The vault grammar lives in `skills/wwxd/references/format.md`. If you change it,
+change `src/wwxd/lint.py` and the tests in the same PR.
+
+## Fetcher plugins
+
+A fetcher turns an approved source into a raw doc. Plugins are ordinary Python
+packages that register under the `wwxd.fetchers` entry point:
+
+```toml
+# your plugin's pyproject.toml
+[project.entry-points."wwxd.fetchers"]
+epub = "wwxd_epub:fetch"
+```
+
+```python
+# wwxd_epub.py
+import datetime as dt
+from pathlib import Path
+
+from wwxd.rawdoc import RawDoc
+
+
+def fetch(source, vault, **options):
+    if source.type != "file" or not source.url.endswith(".epub"):
+        return None  # not mine; let other fetchers try
+    text = my_epub_to_text(Path(source.url))
+    return RawDoc(
+        meta={
+            "id": source.id,
+            "type": "file",
+            "url": source.url,
+            "title": source.title,
+            "date": source.date,
+            "transcript": "file",
+            "expected_speakers": source.expected_speakers,
+            "fetched": dt.date.today().isoformat(),
+        },
+        body=text,
+    )
+```
+
+Plugins run before the built-in fetchers. Only fetch content the user is allowed
+to access. Plugins that pull from piracy sites won't be accepted into this repo
+or linked from it.
+
+## Ground rules
+
+- Never commit vault content (`vaults/` is gitignored).
+- Keep the CLI deterministic; judgment belongs in the skill.
+- Every claim in a vault must stay checkable against `raw/`.
+
+## Releasing
+
+`.github/workflows/release.yml` publishes to PyPI with trusted publishing, so the repo
+holds no PyPI token.
+
+One-time setup:
+
+1. On pypi.org, open [Publishing](https://pypi.org/manage/account/publishing/) in your
+   account and add a pending GitHub publisher with these values.
+
+   | Field | Value |
+   |---|---|
+   | PyPI project name | `wwxd` |
+   | Owner | `MSliwa01` |
+   | Repository name | `wwxd` |
+   | Workflow name | `release.yml` |
+   | Environment name | `pypi` |
+
+2. On GitHub, create an environment named `pypi` (Settings > Environments). Add
+   yourself as a required reviewer if you want to approve each upload.
+
+The first upload turns the pending publisher into a regular one.
+
+To cut a release:
+
+1. Set the new version in `pyproject.toml` and `src/wwxd/__init__.py` (a test fails
+   if they differ), then run `uv lock`.
+2. Merge to `main` and wait for CI to pass.
+3. Tag the merge commit and push the tag.
+
+   ```bash
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+
+The workflow checks that the tag matches the version, runs the tests, builds and
+uploads. PyPI rejects a version it already has, so fix a bad release with a new
+version, not a moved tag. The Claude Code plugin has no version of its own and
+tracks `main`.

wwxd-0.1.0/ETHICS.md

@@ -0,0 +1,36 @@
+# Ethics
+
+wwxd is for learning from what people have said and written in public. It turns
+their talks, podcasts and essays into a wiki where every quote points back to its
+source. Use it in that spirit.
+
+## Rules
+
+- **Cite your sources.** Every answer must show where the person said what it
+  claims. When the sources don't cover a question, the answer says so, and any
+  extrapolation is marked as the agent's, not the person's. Keep the citations
+  when you share an answer.
+- **Don't impersonate.** A vault answer is a cited summary of someone's public
+  positions. Never present it as the real person speaking, endorsing something or
+  giving advice. Don't use a vault to write posts, messages or reviews in their
+  name.
+- **Public people, public material.** Build vaults of people who publish their
+  thinking, from material they chose to make public. Don't build vaults of private
+  individuals, such as a coworker, a former partner or a neighbor. Don't add
+  leaked recordings, private messages or paywalled content you haven't paid for.
+- **Respect platform terms and copyright.** wwxd fetches public captions, articles
+  and podcast audio for your own use. You are responsible for following the terms
+  of the sites you fetch from and for respecting copyright. This repo ships source
+  configs, never content.
+- **Don't publish what you can't share.** A vault holds full transcripts and long
+  quotes. Keep it private unless you have the right to share that material.
+
+## Opt-out
+
+The example recipes in `src/wwxd/examples/` name real people. If you are one of
+them, or represent one of them, and want your recipe removed,
+[open an issue](https://github.com/MSliwa01/wwxd/issues/new) with the recipe name.
+We remove the recipe and don't add it back. You don't need to give a reason.
+
+Removing a recipe doesn't delete vaults that people already built on their own
+machines, because wwxd keeps no central copy.

wwxd-0.1.0/LICENSE

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