llm-wiki-plus 2.2.0__py3-none-any.whl

llm_wiki_plus-2.2.0.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: llm-wiki-plus
+Version: 2.2.0
+Summary: Karpathy-style LLM wiki from your Claude Code, Codex CLI, Cursor, and Obsidian sessions
+Author-email: Alexander Makarov <4ellendger@gmail.com>, Pratiyush <pratiyush1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/AlexanderMakarov/llm-wiki
+Project-URL: Documentation, https://github.com/AlexanderMakarov/llm-wiki/tree/main/docs
+Project-URL: Repository, https://github.com/AlexanderMakarov/llm-wiki
+Project-URL: Issues, https://github.com/AlexanderMakarov/llm-wiki/issues
+Project-URL: Changelog, https://github.com/AlexanderMakarov/llm-wiki/blob/main/CHANGELOG.md
+Project-URL: Releases, https://github.com/AlexanderMakarov/llm-wiki/releases
+Keywords: llm-wiki,karpathy,knowledge-base,claude-code,codex-cli,cursor,obsidian,session-history,static-site,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Framework :: Pytest
+Classifier: Typing :: Typed
+Classifier: Natural Language :: English
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown>=3.9
+Provides-Extra: highlight
+Provides-Extra: graph
+Requires-Dist: graphifyy>=0.4.20; extra == "graph"
+Provides-Extra: add
+Requires-Dist: trafilatura>=2.0.0; extra == "add"
+Requires-Dist: markitdown[docx,pdf,pptx,xlsx]>=0.1.2; extra == "add"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.2; extra == "dev"
+Requires-Dist: ruff>=0.15.11; extra == "dev"
+Provides-Extra: e2e
+Requires-Dist: pytest>=8.4.2; extra == "e2e"
+Requires-Dist: pytest-playwright>=0.7.1; extra == "e2e"
+Requires-Dist: pytest-bdd>=8.1.0; extra == "e2e"
+Requires-Dist: pytest-html>=4.2.0; extra == "e2e"
+Requires-Dist: Pillow>=10.0; extra == "e2e"
+Provides-Extra: all
+Requires-Dist: graphifyy>=0.4.20; extra == "all"
+Dynamic: license-file
+
+# llmwiki
+
+Your coding-agent sessions, compiled into a local wiki you can search, graph, and open as plain files.
+
+[Live demo](https://alexandermakarov.github.io/llm-wiki/) · [Karpathy's LLM Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/)
+[![Version](https://img.shields.io/badge/version-v2.2.0-10B981.svg)](CHANGELOG.md)
+[![CI](https://github.com/AlexanderMakarov/llm-wiki/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/AlexanderMakarov/llm-wiki/actions/workflows/ci.yml)
+[![Link check](https://github.com/AlexanderMakarov/llm-wiki/actions/workflows/link-check.yml/badge.svg?branch=main)](https://github.com/AlexanderMakarov/llm-wiki/actions/workflows/link-check.yml)
+[![Wiki checks](https://github.com/AlexanderMakarov/llm-wiki/actions/workflows/wiki-checks.yml/badge.svg?branch=main)](https://github.com/AlexanderMakarov/llm-wiki/actions/workflows/wiki-checks.yml)
+
+llmwiki turns transcripts from Claude Code, Codex, Cursor, OpenClaw and others into redacted markdown, then builds a static site: session browser, topic graph, candidate review, MCP tools. Your data stays in a vault outside git. Nothing has to be running to read the site — open `site/index.html`.
+
+## What you get
+
+- **A searchable static site** — sessions, projects, topics, graph, analytics. Dark mode, Cmd+K search, syntax highlighting. Open the files; there is no server.
+- **A knowledge layer** — `synth` writes source summaries and harvests entity/concept *candidates*. You review those on `/candidates.html` and apply decisions with `llmwiki candidates apply`. That review is a real gate, not an optional extra.
+- **Exports agents can read** — `llms.txt`, `llms-full.txt`, JSON-LD, sitemap, RSS, plus an MCP server.
+- **Your data never lands in git.** Transcripts, wiki pages and the built site live in a vault directory you choose. This repository is code plus a public [demo](demo/).
+
+Page kinds and where each field comes from: [docs/reference/page-kinds.md](docs/reference/page-kinds.md). Every screen: [docs/reference/ui.md](docs/reference/ui.md).
+
+## Install
+
+Requires **Python ≥ 3.12** (CI verifies **3.12** only; newer interpreters are installable but not matrix-tested). Runtime dependency is `markdown` only.
+
+```bash
+pip install llm-wiki-plus
+# or: brew install AlexanderMakarov/tap/llmwiki
+llmwiki init --vault ~/llmwiki-vault
+```
+
+Point a gitignored `config.json` at the vault so later commands need no `--vault`:
+
+```json
+{
+  "vault": { "default_path": "/home/USER/llmwiki-vault" }
+}
+```
+
+From a clone, `./setup.sh` installs the package and reports which agents it can see. The clone itself is not a vault — bare `llmwiki init` / `sync` / `build` against this repository are refused; name `--vault` or `demo`.
+
+**Agent commands** (slash commands and skills) ship inside the package. After install:
+
+```bash
+llmwiki install-agent-kit --dest ~/.claude
+```
+
+That is what a Homebrew or pip user runs so `/wiki-sync` and friends work from *their* project, not from this repository. See [docs/reference/cli.md](docs/reference/cli.md).
+
+The install also drops a small `.llmwiki-agent-kit.json` manifest in `--dest`, recording which files it wrote and their checksums. It is safe — and useful — to commit alongside `.claude/commands/`: it is what lets a later upgrade recognise its own files and remove ones it has retired, while leaving anything you wrote or edited alone.
+
+## The loop
+
+```text
+sync / add  →  synth  →  review candidates  →  build  →  open site/index.html
+```
+
+```bash
+llmwiki sync                         # new transcripts → vault/raw/sessions/
+llmwiki add notes.md                 # optional: drop a document into raw/docs/
+llmwiki synth                        # source pages + harvest candidates
+# open vault/site/candidates.html, set decisions, paste the printed command
+llmwiki build                        # vault/wiki/ → vault/site/
+```
+
+`synth` does not rebuild the site. `build` does. `candidates apply` rebuilds after a successful batch so `/candidates.html` matches the wiki (`--no-rebuild` skips that). Candidate review is the human gate: a row starts with no decision, Apply assembles `llmwiki candidates apply --vault … --actions '…'`, and only that command writes the wiki.
+
+One-shot: `llmwiki all --graph-engine builtin` runs the whole loop — sync → synth → build → graph → lint. Opt out of a stage with `--no-sync`, `--no-synth`, `--skip-graph`, or `--skip-lint`.
+
+## Agents
+
+One row per agent. **Supplies sessions** = `llmwiki sync` can read its transcript store. **Reads the wiki** = slash commands / MCP after `install-agent-kit` (any MCP client can also call `python3 -m llmwiki.mcp`). **Core** adapters run on a default `sync` when their store exists; **contrib** adapters need `--adapter <name>` or `adapters.<name>.enabled` in config.
+
+| Agent | Supplies sessions | Reads the wiki | Core or contrib |
+|---|---|---|---|
+| Claude Code | `~/.claude/projects/*/*.jsonl` | slash commands, MCP | core (`claude_code`) |
+| Codex CLI | `~/.codex/sessions/` | `AGENTS.md` workflow, MCP | core (`codex_cli`) |
+| ChatGPT | contrib store | MCP | contrib (`chatgpt`) |
+| Copilot Chat | VS Code workspaceStorage | MCP | contrib (`copilot_chat`) |
+| Copilot CLI | `~/.copilot/session-state/` | MCP | contrib (`copilot_cli`) |
+| Cursor IDE | workspaceStorage | MCP | contrib (`cursor`) |
+| Cursor CLI | `~/.cursor/chats/` | MCP | contrib (`cursor_cli`) |
+| Gemini CLI | `~/.gemini/` | MCP | contrib (`gemini_cli`) |
+| Obsidian | markdown vault intake | wikilinks in the vault | contrib (`obsidian`) |
+| OpenCode | shared OpenClaw schema | MCP | contrib (`opencode`) |
+| OpenClaw | `~/.openclaw/agents/*/sessions/` | MCP | contrib (`openclaw`) |
+
+```bash
+llmwiki adapters --wide
+llmwiki sync --adapter openclaw
+```
+
+## Configuration
+
+Shipped defaults: [`examples/sessions_config.json`](examples/sessions_config.json). Personal overrides: gitignored `config.json` at the clone root, merged on top. Full keys: [docs/configuration.md](docs/configuration.md).
+
+Skip projects or dates with a `.llmwikiignore` next to the vault (one path or glob per line).
+
+## Documentation
+
+| Topic | Link |
+|---|---|
+| Hub | [docs/index.md](docs/index.md) |
+| Install + first vault | [docs/getting-started.md](docs/getting-started.md) |
+| Page kinds | [docs/reference/page-kinds.md](docs/reference/page-kinds.md) |
+| CLI | [docs/reference/cli.md](docs/reference/cli.md) |
+| Site UI | [docs/reference/ui.md](docs/reference/ui.md) |
+| Architecture | [docs/architecture.md](docs/architecture.md) |
+| Upgrading | [docs/UPGRADING.md](docs/UPGRADING.md) |
+| GitHub Pages | [docs/deploy/github-pages.md](docs/deploy/github-pages.md) |
+
+This repository's `CLAUDE.md` and `AGENTS.md` are for people changing llmwiki itself. Vault workflows for users live in the installed agent kit.
+
+## Acknowledgements
+
+- [Andrej Karpathy](https://twitter.com/karpathy) — [LLM Wiki idea](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
+- [Pratiyush](https://github.com/Pratiyush/llm-wiki) — upstream this work extends
+
+## License
+
+[MIT](LICENSE) © Alexander Makarov; based on upstream [Pratiyush/llm-wiki](https://github.com/Pratiyush/llm-wiki)

llm_wiki_plus-2.2.0.dist-info/RECORD

@@ -0,0 +1,169 @@
+llm_wiki_plus-2.2.0.dist-info/licenses/LICENSE,sha256=t1Tu0mlN93X-rNAFrgN1PHCXGhWIRzg27VlpFDxj-gI,1066
+llmwiki/__init__.py,sha256=ka6YxrECQ7S44Tws4SiNvyP7C8XlSizf0YW_XbgVWxs,2792
+llmwiki/__main__.py,sha256=7Yg-c7vpPTno1WRjPWM8_pvyL0LAO30fBKAFmwXNono,142
+llmwiki/_frontmatter.py,sha256=gyFeF0Mi0aOFm8LSxqEx00tXUlqHPrBk2-UeW_g23gE,6557
+llmwiki/_system_pages.py,sha256=mB3MwS0v1YWTzwrFTOMqZ2ebuWUAqJK1pa2jyNmGCUM,2840
+llmwiki/adapter_config.py,sha256=ICvYHrkwUcIuk6B-FS1oUPQcVFFqHvMNNJ1SoHe_Tvc,4135
+llmwiki/add_doc.py,sha256=9Whyz7zaqMmccmwNn4fkhgSRiaBBIkHHww3xUrHrCqw,43080
+llmwiki/agent_label.py,sha256=9nQ7xSykJ_E4oIhjjAJD-kwvlGn8sRaqkSk9kE-XFeA,3962
+llmwiki/automation_install.py,sha256=XutQsIjQAttdtCluqQYr84lhDJll2bqgGrc_4Rod_A4,21450
+llmwiki/automation_plan.py,sha256=16FbNDE3LlL1IH9WGlk5Ir58OTI0NSSPMM90Jck0si8,7801
+llmwiki/automation_status.py,sha256=JCbmdOZMtwSS8fhimh72s73XUzpwwmz4pDdukcvZu_A,1531
+llmwiki/backlinks.py,sha256=NuKGrFqTR5Zx1xla9iP1_EbstN_vmMYpvsEKj5qt3YA,7620
+llmwiki/build.py,sha256=j5xdXV3CQR_EewTrY-pZfN59eJdK5hM3w-UbwT1ncM4,146408
+llmwiki/cache.py,sha256=VrPubgm1vD83um4fK8h_bQcLfbHFATd24u0bWT9UjI8,12958
+llmwiki/candidates.py,sha256=JsgNYDdIOO5pUihSDcbF1tNnO_Zfkyt6D6mnIaoIqmY,39550
+llmwiki/candidates_harvest.py,sha256=gT0JYBmeulrIPd5UFGgIi1E0gewMf7BpL_9FhtyXA8o,20314
+llmwiki/candidates_site.py,sha256=kB68w0aCatMByN47zZQY9zH4g1yDTH-g_TBfjePvRxg,32642
+llmwiki/categories.py,sha256=jq8O814Pvxx9KKe6jjtqtfWwgGRaVqPWDZdFs3TRM40,4633
+llmwiki/changelog_timeline.py,sha256=QJ0HIGP2WtkzKDYAZMfyrsEQ5taE0OX99MHW2ZOzadA,16179
+llmwiki/claude_path.py,sha256=mX5vARHohKC8f82y0QHhTok8Do_ACuuQiw0hie4QqRw,1949
+llmwiki/cli.py,sha256=49ZcISPFXbr9z0G9GhLp-i28n7yYWqO2Gqeif46b6p8,147521
+llmwiki/completion.py,sha256=N-Ld0DNZvzGjkoP-HzOQeZC9UMNEJ0qgNd95mhwzhug,5968
+llmwiki/confidence.py,sha256=OdVWaQqMnK5MDSVDl40JSSEv4X4LzkRXtYBTW5ajQfg,5351
+llmwiki/config_schedule.py,sha256=0xUTe8TnPjut-RzkbiJap1SqimYwIJvXlQk89qidfIU,5278
+llmwiki/configure_sources.py,sha256=3TwhCI3cstBhLlv7UGWG6WB6hrYrwZ76CSAwjPrE6zc,13380
+llmwiki/context_md.py,sha256=IaxWauSD8o7pf4JVJ2b5UrIp6_k74bbkJU2qHPVgINE,6581
+llmwiki/convert.py,sha256=YNuTg_3tnwUucsw1MEstTeo0iwoFwAIpOixQzSp1bug,92833
+llmwiki/cron_spec.py,sha256=DfJ_B6-mbPUZ2JEiwrN-XrIa6MEakORZBPTNxzgVYBE,21196
+llmwiki/docs_pages.py,sha256=ZtslLq0ScVTbFziOd7meHaZT1PHLMTUcsWlWHffJF5Q,30550
+llmwiki/exporters.py,sha256=nHFkznpbd87Pq18ib4nLacqohxUYpgrS6bduNrcTS_o,20662
+llmwiki/format_numbers.py,sha256=QxWIWWV84eEFMjBz6vxooZwEWWneZG5dz89f_99jfro,806
+llmwiki/freshness.py,sha256=vFiKNVzAEb7M6vbdeqWbhcv1wpgMQqkPKas7SJjn0eg,5152
+llmwiki/graph.py,sha256=oWGMujpoDcePWMW99ngHZsmIr9m85a0QEEncV6Tqo50,33103
+llmwiki/graphify_bridge.py,sha256=NjTb3G1ekl8gpHLyvF30ycm_uEnKkznUPWjQTCGYnew,20701
+llmwiki/htmlmd.py,sha256=pLsIWOgmjLd5PohiG-qj-xqdPsAagHGtoVajAwdixXg,7566
+llmwiki/ingest_queue.py,sha256=jjMm_Yxpgrzun3uk2Yif6ReybJDBUnht4rsjbk9A9Qw,3231
+llmwiki/install_agent_kit.py,sha256=CLskx0m7xVSsjpLu7fRTMKd7ZWmRogtD31DdP6eMllA,12158
+llmwiki/install_hint.py,sha256=y8cRm1wI5tlOX2g7-vmucarBWIAyotZIkKFdB4DRw_w,5743
+llmwiki/lifecycle.py,sha256=e3pPJcbNoAfPiygbEVIt5ZfH_of5VpaGCBHT08ybO58,5141
+llmwiki/link_checker.py,sha256=rEQ3tnutNOMQHSdxDQjTVJShC3qTzl4Bl5M31sGGU7Y,5540
+llmwiki/log_reader.py,sha256=2Gwwk7bBcBI8s-sFJM7Dvgg2dVfWv2VRXnVLlQ5YSMw,4056
+llmwiki/manifest.py,sha256=goh7iG16dgLqjf3Obei6QKR9EM8I-3YrHrUWPSBg3QE,4282
+llmwiki/migrate_broken_provenance.py,sha256=BoLVZUWAQng7pK1exLO0d-nyXx4egULE3ytlB7AnFGA,17266
+llmwiki/migrate_page_kinds.py,sha256=mCopM95z_JoQNNmMATBl8uHjZocjg8cFgfd2C7st4D4,12863
+llmwiki/migrate_topic_kinds.py,sha256=6BwH0lz0SdbvaEJx4ulACqRX7vdEHhnOvpMu8yzl-3Q,16849
+llmwiki/model_pricing.csv,sha256=rcYLOHW_7ZGrwycDqUGCmiejwtYdLx1gmFYD7rzivsE,1168
+llmwiki/models_page.py,sha256=WY-7Sa3KT-MuAV_t0_Guc8bPe5mamIHmDM1Dm82Wlwc,11143
+llmwiki/obsidian_output.py,sha256=1bkZtLB1YJtqdZdxK6KonPkJdI1NPrJBMpFieV-oa8Q,7223
+llmwiki/pipeline.py,sha256=lhHgyra6n1BFRFB7qBzZ4EFdaY4C1zCEHz93SsTtgyk,17944
+llmwiki/pipeline_lock.py,sha256=27QNADPcUKQK93Csnpfi8HAe2mVW9ClQ2Uuz1bvl4mg,3991
+llmwiki/project_topics.py,sha256=nrgskusOac8FYl21LbXmb0Hjuv5lCyXyUj08Z8iyW9I,7145
+llmwiki/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+llmwiki/quarantine.py,sha256=xSSTD1D5mkn2c8nDrrYvIM-GufQUB5O1DUFlOtI4NA4,8955
+llmwiki/queue.py,sha256=IDwdGwPvTcbgivXeQniyrm-8IsuACvVkyLoBeGrrT8w,789
+llmwiki/queue_ops.py,sha256=UtDwNOOAwa25FAwWMyTaX-iT7F7Qw5RqmK1qbNPROVQ,7291
+llmwiki/raw_docs_site.py,sha256=5qa1oebXdcbrCTgxVx14xoSWkN1zh4XXWkyTSOtI0r8,17621
+llmwiki/references.py,sha256=G1IR4-TOi5ngAOhZ7TC48OxqLrR-_O0-mz-76MMraeU,8790
+llmwiki/reindex.py,sha256=MCBDzmJMvDV8OyVboOe4u6B0c7z-0-1MvCuYK2lPZss,19110
+llmwiki/remove_doc.py,sha256=c85851ZSmUxwUF9auYAWZBEmrZB2zFE1hft-vIZR_Wg,11547
+llmwiki/schema.py,sha256=fvyENgx1KegqqFfh2R6plSFXYwICqw7IEdE4taIKTHA,9363
+llmwiki/search_facets.py,sha256=0eoxNCDurar6-YriEYM1LI-_C4PGguOeSFF2wtjZ4yk,4248
+llmwiki/search_tree.py,sha256=uZh3a-q1PfTJ6XE410iAeVmNuTMZ5-UuDMY1tqhl6mU,7323
+llmwiki/session_ready.py,sha256=SbcTm3ycFGFrPTtu2-304_LCYOrT_VJn-06ajNKeMQ4,9346
+llmwiki/skill_installer.py,sha256=tbg5c4QjLeisD6MPo_3OBUQDin2BrGLXHoukby8yWsY,3237
+llmwiki/slugs.py,sha256=4BbdvBmPa2eRL9Y6B_agffbYR7cbjnyeiMAHFpDPMYQ,8474
+llmwiki/source_checkout.py,sha256=_VBgbPmHHjS3RfolfbCEB8w53Y2nRD2J29MB2DiDGiA,2355
+llmwiki/source_topics.py,sha256=V-fi7t4uGUiZXfwiLDtHknwq56winrzd5ltn5_RS1mU,4900
+llmwiki/state_store.py,sha256=XZp1157L858WvCtdzyc1pMXqwo6pw6g9vaUps1MxxWs,16652
+llmwiki/tag_utils.py,sha256=LGBjgsXHS2p5axUFAt85n-rMShQ9N84YEAgWz3x50wU,2541
+llmwiki/tags.py,sha256=9pMyr4MbMzG1gGYWkS3zNuoSPhySKB52sEcfsEA60wo,12822
+llmwiki/topics.py,sha256=vNAIz8EZGbDHgp2FJGnbxP4-6WaZx4flYG0t4PRk9v8,16660
+llmwiki/topics_consolidate.py,sha256=KNxtMbe40fvByI7Q5lrBfh4JvdsaScYvveW4m21Bkho,7874
+llmwiki/topics_page.py,sha256=p1HdysXIeiUgWSISbHvPTbG2kl1A5AJIHPhEAxcgiiY,22766
+llmwiki/trace.py,sha256=gotgVunNW1VfjySEw63kBNG4gm9j4okM1-qS6hAHlHI,19733
+llmwiki/usage.py,sha256=6E4GrHD_55nzfEoogICUo4uWPJUkFcCjiK0g-wcBi34,42983
+llmwiki/vault.py,sha256=yHGmFzvHdkz6BZ0wWq0nSW0TBMG3zE6klV7F5PhAP40,13202
+llmwiki/vault_settings.py,sha256=8PN_1IABTCX96es4QSv0pl-T-cZLu9qCRs3kD79N8bk,5055
+llmwiki/viz_heatmap.py,sha256=W3zeeLV1195XOdExZ_48VHaqTVOiBxJ3i9k-_1JMRVM,13658
+llmwiki/viz_tokens.py,sha256=IR0XS1EB_AUnarAPsYv7zTS6QD4VcqTl5uAschgeC28,16818
+llmwiki/viz_tools.py,sha256=JOzc5hp2WiAz9DObBB8tDvyl6nIgMw62rg5IuymA7jQ,9235
+llmwiki/viz_wiki_value.py,sha256=QsErg4nTw8DDhCsfVEVHmhwfbLi1UKqA8bQlojRhY6c,13410
+llmwiki/watch.py,sha256=SejclQXk3YV_JfrxnWXPMuVkqYv98d2c4WoRjKdqwFQ,10407
+llmwiki/wiki_adoption.py,sha256=ViaHGmKZMAyAmz9xnf9HL4X5tI5rK7oHJIschF1U7To,4533
+llmwiki/wikilinks.py,sha256=T_v4OqG0d6AncoeYrquXpbIyGjQ8l3nYl8QDg6Lo5eU,4974
+llmwiki/adapters/__init__.py,sha256=hWOqHQ2FjWzdKpnhm4EaDkJ0r-TxtEkW-3oWXPZlbxA,5093
+llmwiki/adapters/base.py,sha256=taFomsQcwYhNc3Ewq34GJaaNX63DIfQ1KBjw6lOqFkc,14247
+llmwiki/adapters/claude_code.py,sha256=A-KzSRyFvQn5K1CPPOK6PGnwqYYUvkK3SVKeCHtmYGI,3772
+llmwiki/adapters/codex_cli.py,sha256=7MvsyAQrgh9Aaxtn-1zivhJiinhp0jj5OTLKwHNU16U,9299
+llmwiki/adapters/settings.py,sha256=ls0WgKaf8WdHy1FL8V3O7nReWPZQOzP1O_m9qU3kMhw,4365
+llmwiki/adapters/status.py,sha256=9r0MBwUF34nV5maNGYi6QFNvRUhUdwnHGpJRbxzw0fw,3790
+llmwiki/adapters/contrib/__init__.py,sha256=IKZbcj1u3bQXQrcUq3tSY8mj_bwpmAIgANTE0H-NMrM,72
+llmwiki/adapters/contrib/chatgpt.py,sha256=RFTs1Yqt4NsZw1rCxBQ3r0b4yG7jsJ2VLPi24yFO6kA,8099
+llmwiki/adapters/contrib/copilot_chat.py,sha256=Ao5Xr2EVGPMxKdB86Un-qXwbW8ovF0rnoiH-lmCcqeY,5041
+llmwiki/adapters/contrib/copilot_cli.py,sha256=Sqh9p6YDrs6RGuYy9r_XWB6y5gd1Pa0Z2W_EOfdNttk,4507
+llmwiki/adapters/contrib/cursor_cli.py,sha256=OJtK4ngdxkmB9LM-LHbV3S5gdmFXBlNGLb3YrTLyowk,12204
+llmwiki/adapters/contrib/cursor_ide.py,sha256=6WX4W5T_PNKt-Hhyj0pBcwte4jbHiE_5xMZfNcfjWtY,17863
+llmwiki/adapters/contrib/cursor_slug.py,sha256=2doHOyATu2aFwxEE-CbXCpqubhIPXFzGDf1VjwkHVs0,419
+llmwiki/adapters/contrib/gemini_cli.py,sha256=dDHewS_B0S_othz5ptPeJp1ZqCgL8qg4HQ7kYyDSbF0,2870
+llmwiki/adapters/contrib/obsidian.py,sha256=RRZJHEL5vCo86jZ1ign1p4RTDNH_GSjVizyPb5s7HRw,4668
+llmwiki/adapters/contrib/openclaw.py,sha256=ovyVh9epxFWTu_Ax2vd1Kr4OEEESqMHEQwJKcGajeDs,7329
+llmwiki/adapters/contrib/opencode.py,sha256=39aniUCSgLArvQ_WFQaIsrsejfa2W2Xk8NwcsqABKuY,7025
+llmwiki/agent_kit/__init__.py,sha256=ezGyxY2e3YLjEe4WejEWv1wPtJJkTzDSGxt3L0kfcLQ,1616
+llmwiki/agent_kit/commands/wiki-all.md,sha256=Ark4vSneP34nJT-u_alia7zKvg_zSonvi8VW-PJKtHA,2615
+llmwiki/agent_kit/commands/wiki-build.md,sha256=BoB1MXBZq2zZ9Saia2S_gKUO5Pexm8CAoKjOuhSURWc,491
+llmwiki/agent_kit/commands/wiki-candidates.md,sha256=cjufsIXU6jZ45UEeRD4EMJfXeOGKhoTawsRJVChFF8Y,4692
+llmwiki/agent_kit/commands/wiki-graph.md,sha256=Zo3EEgX_rnUUo131Q5v7i04LoAg6u4VNU7glMs1sheU,2087
+llmwiki/agent_kit/commands/wiki-ingest.md,sha256=KXGi-I3bLWXvmY5Nz4S-HBWQBw6sipQVspgyMyXYWYE,3747
+llmwiki/agent_kit/commands/wiki-init.md,sha256=CTV3BhmocffQvjQ-UA5eHiE8UUuRJDH0Cd0-8m4LK_0,379
+llmwiki/agent_kit/commands/wiki-lint.md,sha256=zcv5r-cZZDJZnPxxbc3gALs_u4EtwsT6BA_sW6It2Sg,1189
+llmwiki/agent_kit/commands/wiki-query.md,sha256=sDUOHMuVI6v-heUPg8ter17dG-Ggu2B0HBrhtBUAhPQ,949
+llmwiki/agent_kit/commands/wiki-reflect.md,sha256=uA7KHXshdSJn4zNkyreZPHn8V5pr9nLZknoEtNFOkiU,2978
+llmwiki/agent_kit/commands/wiki-sync.md,sha256=MB5lFrWcGFRSWzx2gHI4EcYz43hP4ohqrKcKJtMqnNY,1185
+llmwiki/agent_kit/commands/wiki-synth.md,sha256=IcTivJ80KYDXbe7IZqt1e92uYfnMrfzdsrhfqsDXKyc,2303
+llmwiki/agent_kit/commands/wiki-update.md,sha256=Z0cfqKTbePkA1QZRu3vqtp8lUK1cFklFLbg7fhYnec8,2194
+llmwiki/agent_kit/skills/llmwiki-ingest/SKILL.md,sha256=IxLMjF93NEip9_qCJ8ufUlRbxQUgB5z1O37SZl9-ENg,6088
+llmwiki/agent_kit/skills/llmwiki-query/SKILL.md,sha256=m6osuE1zNNxZbRw0iS5EV5DbcVX1E7ChhSJ3nkN09kk,2724
+llmwiki/agent_kit/skills/llmwiki-sync/SKILL.md,sha256=eJkYVpw9cFsaXEN3jmv6T385pRZ27DQ1yfoHnjwZuLc,4192
+llmwiki/agent_kit/skills/wiki-all/SKILL.md,sha256=iVxIcI2DsVDlN-1xbryxhvD41tpzHJS90nlUontAfbE,3197
+llmwiki/lint/__init__.py,sha256=QcpbS6CqJ0Ztx2aqzf8PCzTqhFx9HTdC60kvPYGtpk4,11952
+llmwiki/lint/report.py,sha256=LdqMZyahunhXksANz476LYjEfq_cs1VjXBzmr_tCZyk,5158
+llmwiki/lint/rules/__init__.py,sha256=2jBsuyExXcUhaCSCElw8mWsWzj-pkLE8KpKFWJrKpwU,3706
+llmwiki/lint/rules/_helpers.py,sha256=RR1e5bPK6lwda6H292XfgFp8BqFH1y2pKWnTdkVpDnY,4272
+llmwiki/lint/rules/claim_verification.py,sha256=wgxW_TEpmo0Lv7fc6HFJnx5WXU8qjkkDR8NFSpz2dMc,1458
+llmwiki/lint/rules/content_freshness.py,sha256=Foh4dW2RSSdRYg08sR3rUmgPuJvKv8wMzBuu0ok25lk,1273
+llmwiki/lint/rules/contradiction_detection.py,sha256=KW8hR4TDeh0BrBEJa6CsFCV-96lM5dO8VkjBKfi6X-M,5470
+llmwiki/lint/rules/duplicate_detection.py,sha256=YJu62J785aMVPpgc-i1NZnRhYPbw5_NF8cM4sZT0kYE,7369
+llmwiki/lint/rules/frontmatter_completeness.py,sha256=U_uxJ5uFZZoBswQo-LQYyxzwovuOr0yrbwKP7Q0EJsM,1810
+llmwiki/lint/rules/frontmatter_count_consistency.py,sha256=KIFVd0MAvIL1obYEubfy9pRc4gcQuV1KCd6TWtWUSZM,2300
+llmwiki/lint/rules/frontmatter_validity.py,sha256=qoYMRYFM1lRIx9rQ6JXjJXGGsbq3yIZ-5ErCuaOmuf8,2303
+llmwiki/lint/rules/index_sync.py,sha256=sClg23RB5oD2f-pY0nx0BcDHOGDZwajCN8jiuK660z0,2581
+llmwiki/lint/rules/link_integrity.py,sha256=z_L2E8oIwI_iL3epxJ-lxtxDSi9je0F4goRCOT8aMNM,2792
+llmwiki/lint/rules/orphan_detection.py,sha256=m0Ij5FEq45ro3yEMmmJxoiIRS4VDOs6pXJdjKqm7dxw,2755
+llmwiki/lint/rules/provenance_integrity.py,sha256=94gHh3PY-51eBFERBGnc9Y-_KkGn2_S9kGxSoJocmYQ,3563
+llmwiki/lint/rules/stale_candidates.py,sha256=7Ar6CJ4NwzJ35OSbicMlxvKROsd41qtCKHhGNzLl0hU,2029
+llmwiki/lint/rules/stale_reference_detection.py,sha256=9tGF6vnxcZa_bcAOrdWHskrwR_ik6oLJx-ptFqlSk6w,1587
+llmwiki/lint/rules/stub_source_pages.py,sha256=OtCUe-KvogcP9IrGgU29_-gjtV9FoCYPOXZ3yMlhn4E,2187
+llmwiki/lint/rules/summary_accuracy.py,sha256=hQdSf6Ihw8bS3BtKYgE1qtwrQ2vLjNlX2CNKZPVCOu4,923
+llmwiki/lint/rules/tags_topics_convention.py,sha256=PsGGl2Qptd05wrC0v796nxNNU88u4Zd1KxUNJN1pkYI,2223
+llmwiki/lint/rules/tools_consistency.py,sha256=xbIazbMBoabsUEKAGhUiy0RhaAtok34YLREsZMud13E,2435
+llmwiki/mcp/__init__.py,sha256=Pd0LkjNNXGKcD2lDvdqaux5ulHoNXRaooe0BoBbMewk,966
+llmwiki/mcp/__main__.py,sha256=VMIikJx_mX_Mh1ipr4xWETLDa7IEnyDEen1VOGktG6w,123
+llmwiki/mcp/server.py,sha256=nQfKrb4aGqeVpMLr9AO3ZY8nApJjYySMk-lHBN0mfOU,56887
+llmwiki/render/__init__.py,sha256=xcc-85H84FxqWZWGFtEnv88v0BGoK8qIgU34n8dXVXk,676
+llmwiki/render/collapse_section.py,sha256=XrInH5QXXqcIkK13xku0-WDda3tbF3KgPUF5LtHEwSc,2385
+llmwiki/render/css.py,sha256=KTVW58NU8xowRCtKlWnhVPxyv1B29pafT4NwZm9ywCA,72916
+llmwiki/render/data.py,sha256=McoFg1919wIKwQqlHSNAVLW5ahCsFaivkYJyduwf4nM,1945
+llmwiki/render/docs_css.py,sha256=ZtxL0TKBWl0QKhtHlWlDddIq1NHOIQXvcRDZTPTlNIE,11587
+llmwiki/render/graph_viewer.py,sha256=u0EqG5VHb7L9qbO6KbeXrLUQTbpLze59zJ_lPZgBXtY,30040
+llmwiki/render/js.py,sha256=4dMTvShgnH74MapJ9GJTkq-v53xEKRztKM8Kx4v7ups,84857
+llmwiki/sync/__init__.py,sha256=--jDo0QbQ3Rw3lnqZMAEL9FCIpbRC8QAglXxlFfaC7Q,527
+llmwiki/sync/lookback.py,sha256=hshZmt8vPjZR2bolbPQKnZHaBXDHI3guY_IhRF5pz_s,3244
+llmwiki/sync/status.py,sha256=NSK2_uSy0zGVrKq6rWnguC_tpUAfQeIJ0LH1cG13EfA,5338
+llmwiki/synth/__init__.py,sha256=uhAoquwBPrqf8GeID3TqqftJ4VMFKjoN_Kf0f2pZTMg,635
+llmwiki/synth/base.py,sha256=G7eeswY1pHHG4apymg5S-bGOUN4xR0GoQqbW86qgK1U,7306
+llmwiki/synth/claude_cli.py,sha256=mIPpJc1RW23A-wjyzBD-d73fVe0KVzW_jUcN_Njd7Mc,12848
+llmwiki/synth/estimate.py,sha256=5phwllCZLenKjXVWGwPBoS8c1Z9NWFTyOSqpkZEsMEY,26300
+llmwiki/synth/ollama.py,sha256=VxGMRYEMw0iv9yJi-hjNaiznaz7C4PQMApqgZvLnfnk,15779
+llmwiki/synth/pipeline.py,sha256=mXhc7qZDXXguEC7ILWPORPQMfHWArMApwIuBadtMMbo,74780
+llmwiki/synth/reporting.py,sha256=BRY1n6zwORUSWddiTNnUg9bjVzhKWV-3urcgH7GUSWI,4243
+llmwiki/vendor/NOTICE,sha256=8fgQ8mj6Kv7tf-bXOD0g4iZX0jJFWMMcTaFw4EBrPFM,1735
+llmwiki/vendor/github-dark.min.css,sha256=nyCNAiECsdDHrr_s2OQsp5l9XeY2ZJ0rMepjCT2AkBk,1315
+llmwiki/vendor/github.min.css,sha256=Oppd74ucMR5a5Dq96FxjEzGF7tTw2fZ_6ksAqDCM8GY,1309
+llmwiki/vendor/highlight.min.js,sha256=g3pvpbDHNrUrveKythkPMF2j_J7UFoHbUyFQcFe1yEY,121727
+llmwiki/vendor/vis-network.min.js,sha256=9T-DPdub-X7-hWuwY31P6I8545mZx-lKS4r8jeihouU,688911
+llm_wiki_plus-2.2.0.dist-info/METADATA,sha256=QUZCHCQcxkjU9jd7yb3wnHExAj-yMsTZR0T9bpfEnjY,9794
+llm_wiki_plus-2.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+llm_wiki_plus-2.2.0.dist-info/entry_points.txt,sha256=OG9mJxZ4jmpE7-9rP_8z9CGgYEsOgC-_-uLbKv_dv9I,81
+llm_wiki_plus-2.2.0.dist-info/top_level.txt,sha256=1TYv5RtuN1LNK6YoG0ImVuQCA4iCwCG69-s-Pd3pfGs,8
+llm_wiki_plus-2.2.0.dist-info/RECORD,,

llm_wiki_plus-2.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

llm_wiki_plus-2.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+llm-wiki-add = llmwiki.cli:main_add
+llmwiki = llmwiki.cli:main

llm_wiki_plus-2.2.0.dist-info/licenses/LICENSE

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

llm_wiki_plus-2.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+llmwiki

llmwiki/__init__.py

@@ -0,0 +1,71 @@
+"""llmwiki — LLM-powered knowledge base from Claude Code, Codex CLI, Cursor,
+Gemini CLI, and Obsidian sessions.
+
+Follows Andrej Karpathy's LLM Wiki pattern:
+    https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
+
+Public API:
+    - llmwiki.cli.main()              — the command-line entry point
+    - llmwiki.convert.convert_all()   — .jsonl → markdown
+    - llmwiki.build.build_site()      — markdown → HTML
+    - llmwiki.graph.build_and_report() — knowledge graph
+    - llmwiki.exporters.export_all()  — AI-consumable exports
+    - llmwiki.adapters.REGISTRY       — adapter registry
+    - llmwiki.mcp.server.main()       — MCP server (stdio)
+"""
+
+__version__ = "2.2.0"
+__author__ = "Alexander Makarov"
+__license__ = "MIT"
+
+from pathlib import Path
+
+# Repo root (llmwiki/ clone), resolved from this file's location.
+# Runtime vault/workspace routing is config-driven (see config_schedule +
+# state_store); REPO_ROOT remains the codebase root for bundled assets.
+REPO_ROOT = Path(__file__).resolve().parent.parent
+PACKAGE_ROOT = Path(__file__).resolve().parent
+
+# #arch-m4 (#617): the docstring above promised a "public API" but
+# nothing was actually exported. Wire the listed symbols up as real
+# re-exports so `from llmwiki import build_site` etc. actually works.
+# Lazy via __getattr__ so importing llmwiki itself stays cheap (most
+# CLI invocations don't touch the public API surface, just REPO_ROOT).
+__all__ = [
+    "REPO_ROOT",
+    "PACKAGE_ROOT",
+    "__version__",
+    "main",
+    "convert_all",
+    "build_site",
+    "build_and_report",
+    "export_all",
+    "REGISTRY",
+]
+
+
+def __getattr__(name: str):
+    """PEP 562 module-level lazy attribute access.
+
+    Lets `from llmwiki import build_site` resolve without paying for
+    the full transitive import graph at `import llmwiki` time.
+    """
+    if name == "main":
+        from llmwiki.cli import main  # noqa: PLC0415 — lazy package __getattr__
+        return main
+    if name == "convert_all":
+        from llmwiki.convert import convert_all  # noqa: PLC0415 — lazy package __getattr__
+        return convert_all
+    if name == "build_site":
+        from llmwiki.build import build_site  # noqa: PLC0415 — lazy package __getattr__
+        return build_site
+    if name == "build_and_report":
+        from llmwiki.graph import build_and_report  # noqa: PLC0415 — lazy package __getattr__
+        return build_and_report
+    if name == "export_all":
+        from llmwiki.exporters import export_all  # noqa: PLC0415 — lazy package __getattr__
+        return export_all
+    if name == "REGISTRY":
+        from llmwiki.adapters import REGISTRY  # noqa: PLC0415 — lazy package __getattr__
+        return REGISTRY
+    raise AttributeError(f"module 'llmwiki' has no attribute {name!r}")

llmwiki/__main__.py

@@ -0,0 +1,7 @@
+"""Allow `python3 -m llmwiki` to invoke the CLI."""
+import sys
+
+from llmwiki.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

llmwiki/_frontmatter.py

@@ -0,0 +1,178 @@
+"""Canonical frontmatter parser (#273).
+
+Historically 8 copies of this function lived scattered across the
+codebase with slightly different return shapes — dict vs
+``(dict, body)`` tuple vs ``(str | None, body)``.  Consolidating in
+one hit is risky (every caller makes specific assumptions about the
+return shape), so this module ships the canonical implementation plus
+thin wrappers that match the three existing signatures.  New call
+sites should use :func:`parse_frontmatter` or
+:func:`parse_frontmatter_dict`; legacy sites can migrate over time.
+
+Stdlib-only.  No YAML dependency — we parse the minimal subset of
+YAML we use in practice (scalars, inline lists, inline dicts, block
+lists with `- ` bullets).
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+from typing import Any
+
+# Accept LF, CRLF, or CR after each fence so Windows-authored (CRLF) and
+# old-Mac (CR) files parse identically to LF input. The optional newline
+# slots match the historical regex (`\n?(.*?)\n?---\n?`) so empty
+# frontmatter (`---\n---\nbody`) still parses. BOM is handled separately
+# in `_strip_bom()` before the regex runs. See #409, #423.
+_FRONTMATTER_RE = re.compile(
+    r"^---[ \t]*(?:\r\n|\r|\n)?(.*?)(?:\r\n|\r|\n)?---[ \t]*(?:\r\n|\r|\n)?(.*)$",
+    re.DOTALL,
+)
+
+
+def _strip_bom(text: str) -> str:
+    """Strip leading UTF-8 BOM if present (#423)."""
+    if text and text[0] == "\ufeff":
+        return text[1:]
+    return text
+
+
+def parse_frontmatter(text: str) -> tuple[dict[str, Any], str]:
+    """Return ``(meta, body)`` — the canonical shape.
+
+    Empty or malformed input returns ``({}, text)`` so callers can
+    treat every file uniformly. Handles UTF-8 BOM and CR/LF/CRLF
+    line endings transparently.
+    """
+    text = _strip_bom(text)
+    m = _FRONTMATTER_RE.match(text)
+    if not m:
+        return {}, text
+    meta_text = m.group(1)
+    body = m.group(2)
+    meta: dict[str, Any] = {}
+    for line in meta_text.splitlines():
+        mm = re.match(r"^([a-zA-Z_][\w-]*):\s*(.*)$", line)
+        if not mm:
+            continue
+        key, raw = mm.group(1), mm.group(2).strip()
+        meta[key] = _parse_scalar(raw)
+    return meta, body
+
+
+def is_subagent(meta: dict[str, Any], path: Path) -> bool:
+    """Return True iff a session is a sub-agent run (#406 / #492 / #30).
+
+    Prefers the adapter-written ``is_subagent`` frontmatter field (canonical
+    contract since #406), accepting it as a real bool or one of the
+    case-insensitive strings ``"true"``/``"false"`` since frontmatter parsers
+    historically coerced inconsistently. Falls back to the legacy
+    ``"subagent" in path.name`` substring check ONLY when the field is missing
+    — needed to keep pre-#406 raw files (no field) classified correctly until
+    they're re-synced. The renderer renames sub-agent slugs to
+    ``<slug>-subagent-<id>``, so the substring match is correct on canonically
+    renamed files even when meta is absent.
+
+    Single source of truth for both ``build`` (HTML session counts) and the
+    synth pipeline (``include_subagents`` backlog policy).
+    """
+    raw = meta.get("is_subagent")
+    if isinstance(raw, bool):
+        return raw
+    if isinstance(raw, str):
+        s = raw.strip().lower()
+        if s in ("true", "yes", "1"):
+            return True
+        if s in ("false", "no", "0"):
+            return False
+    return "subagent" in path.name
+
+
+def is_headless(meta: dict[str, Any]) -> bool:
+    """True when this session was an automated ``claude -p`` / SDK run.
+
+    Reads the ``is_headless`` flag the converter records, tolerating the same
+    string/bool spellings as :func:`is_subagent`, and falls back to the raw
+    ``entrypoint`` / ``promptSource`` markers when only those were written.
+
+    Absent every marker this returns False rather than guessing from message
+    counts. Files converted before the flag existed therefore read as "not
+    headless" — a deliberate choice, since silently reclassifying an old
+    session as machine noise is worse than leaving it in the backlog where
+    it is visible. Re-sync (or prune) to classify legacy files.
+
+    Single source of truth for the synth pipeline's headless backlog policy.
+    """
+    raw = meta.get("is_headless")
+    if isinstance(raw, bool):
+        return raw
+    if isinstance(raw, str):
+        s = raw.strip().lower()
+        if s in ("true", "yes", "1"):
+            return True
+        if s in ("false", "no", "0"):
+            return False
+    entrypoint = meta.get("entrypoint")
+    if isinstance(entrypoint, str) and entrypoint.strip().lower().startswith("sdk-"):
+        return True
+    prompt_source = meta.get("promptSource")
+    return isinstance(prompt_source, str) and prompt_source.strip().lower() == "sdk"
+
+
+def parse_frontmatter_dict(text: str) -> dict[str, Any]:
+    """Return just the metadata dict — convenience for callers that
+    don't need the body."""
+    return parse_frontmatter(text)[0]
+
+
+def parse_frontmatter_or_none(text: str) -> tuple[str | None, str]:
+    """Return ``(raw_frontmatter_text | None, body)`` — legacy shape
+    used by ``llmwiki/tags.py`` which does its own line-level parsing
+    inside the frontmatter block."""
+    text = _strip_bom(text)
+    m = _FRONTMATTER_RE.match(text)
+    if not m:
+        return None, text
+    return m.group(1), m.group(2)
+
+
+def _parse_scalar(raw: str, *, coerce_bool: bool = True) -> Any:
+    """Parse a single YAML scalar value (best-effort, no external deps).
+
+    Handles: inline lists ``[a, b, c]``, quoted strings, bools, ints.
+    Everything else comes back as the stripped string.
+
+    #py-l1 (#599): pass ``coerce_bool=False`` when recursing into list
+    items so a tag list like ``[no, yes, maybe]`` doesn't become
+    ``[False, True, "maybe"]``. Top-level scalars still coerce.
+    """
+    s = raw.strip()
+    if not s:
+        return ""
+    # Quoted string
+    if (s.startswith('"') and s.endswith('"')) or (s.startswith("'") and s.endswith("'")):
+        return s[1:-1]
+    # Inline list: [a, b, c]
+    if s.startswith("[") and s.endswith("]"):
+        body = s[1:-1].strip()
+        if not body:
+            return []
+        return [_parse_scalar(x, coerce_bool=False) for x in body.split(",")]
+    # Bool
+    low = s.lower()
+    if coerce_bool and low in {"true", "yes"}:
+        return True
+    if coerce_bool and low in {"false", "no"}:
+        return False
+    # Int
+    try:
+        return int(s)
+    except ValueError:
+        pass
+    # Float
+    try:
+        return float(s)
+    except ValueError:
+        pass
+    return s