docs-drift 0.1.0__tar.gz

docs_drift-0.1.0/.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+# Unified patches preserve CRLF and single-space blank context from the target document.
+*.patch -text whitespace=-blank-at-eol,cr-at-eol

docs_drift-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python and build output
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# uv environments and caches; keep uv.lock for reproducible development.
+.venv/
+venv/
+.uv-cache/
+.pre-commit-cache/
+
+# Editors and operating systems
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# Local scanner cache
+.docs-drift/
+
+# Generated fixture repositories (including their nested Git metadata).
+/tests/fixtures/repos/
+.pytest-tmp*/
+.npm-cache/
+node_modules/
+.hypothesis/
+# Full raw benchmark scans stay local; committed samples, pins, measurements and source snapshots reproduce them.
+benchmark/runs/*/*--*.json
+benchmark/runs/*/*.log
+docs-drift-bench-*/
+!editors/vscode/.vscode/
+!editors/vscode/.vscode/launch.json

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

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.17.1
+    hooks:
+      - id: ruff-check
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: end-of-file-fixer
+        exclude: '\.patch$'
+      - id: trailing-whitespace
+        exclude: '\.patch$'
+  - repo: local
+    hooks:
+      - id: staged-file-guard
+        name: Guard staged files and secrets
+        entry: uv run python scripts/guard.py
+        language: system
+        pass_filenames: false
+        always_run: true

docs_drift-0.1.0/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable user-facing changes are recorded here, following
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-24
+
+### Added
+
+- Static checks for commands, flags, defaults, environment variables, routes,
+  symbols, files, package scripts and Make targets, with partial ecosystem coverage.
+- Evidence chains connecting documentation to source and the Git commit that
+  introduced drift, with explicit limits for shallow or truncated history.
+- Terminal reports with stale-token carets; JSON, SARIF, Markdown, JUnit, GitHub
+  annotations and offline HTML reports with an interactive evidence graph.
+- Explanations, conservative fix previews, CI checks, baselines, suppressions,
+  workspace scoping, change impact and repository insights.
+- Optional watch mode, language server and VS Code client; optional model
+  verification with redaction, budgets and explicit opt-in.
+- A local web demo with cached examples and bounded public-repository scanning.
+- Reproducible public-repository benchmark samples for human review, plus docs
+  and configuration reference. Real-world precision and recall remain unmeasured.
+- Package version in CLI and JSON reports, separate from JSON schema version 1.
+- PR comparisons with documentation lines, source evidence, available commit
+  attribution, workflow annotations and reviewable documentation patches.
+- Source-scoped human feedback with reasons and conservative reopening when
+  supporting source changes; full findings remain available for review.
+- Bounded static support history, CODEOWNERS routing, documentation coverage
+  reports and verified local fix branches that leave final approval to a person.
+
+### Changed
+
+- Static Typer checks respect default and explicitly configured help options.
+- Markdown explanations are presented as review text; applicable changes use
+  exact-span patches rather than token-only whole-line suggestions.
+
+
+Changelogs are ignored by default. Historical examples such as `--port` may stay
+in this file without being treated as current usage instructions.
+
+[Unreleased]: https://github.com/ayushagarwalhere/docs-drift/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/ayushagarwalhere/docs-drift/releases/tag/v0.1.0

docs_drift-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing
+
+Use Python 3.11+ and uv. From the repository root:
+
+```console
+uv sync --locked --all-extras
+uv run just setup
+uv run just check
+```
+
+We use a justfile rather than duplicating recipes in a Makefile. `just` is a dev
+dependency (`rust-just` on PyPI), and recipes use native PowerShell on Windows.
+`setup` installs the pre-commit hook. Other recipes are `test`, `lint`, `fmt`,
+`typecheck`, and `demo`. `check` verifies formatting without rewriting files;
+run `fmt` explicitly to fix it. `demo` displays CLI help. Use the fixture commands
+below to inspect a scan.
+
+Without just, run `uv run ruff check`, `uv run ruff format --check`, `uv run mypy`,
+`uv run pytest --cov=docs_drift --cov=scripts --cov-report=term-missing`, and
+`uv run pre-commit run --all-files`. CI tests Ubuntu and Windows on Python 3.11
+and 3.13, with full Git history and all extras installed. Coverage must remain
+at least 85% overall and 90% for extraction and matching; report a failure instead of lowering the thresholds.
+
+The guard reads staged Git blobs, so cleaning a working file does not hide a
+staged secret. It blocks files over 1,000,000 bytes, `.env` and `.env.*` files
+(including examples), and token-shaped Anthropic, GitHub, and AWS keys. Use
+safe placeholders in docs and construct fake test tokens from separate parts.
+Guard diagnostics identify the file and line without printing a token.
+
+For an indexer, add a typed, pure parser under `src/docs_drift/index/`, retain
+source file/line/text evidence, and test it against text-only fixtures, including
+Windows paths and unsupported dynamic behavior. Never import or run scanned code.
+For a claim kind, update the models, extraction, matching, design taxonomy, and
+report examples together; cover confirmed, missing, and unverifiable cases.
+Do not invent a match when the available index is incomplete.
+
+Record every metric, including failures, with the exact command and revision
+that produced it. Keep fixture answer keys fixed; never tune rules or thresholds
+to improve a score. The optional LLM cannot override a code-based verdict.
+
+Fixture tests build fresh Git repositories in temporary directories. For manual
+inspection use `uv run python tests/fixtures/build_fixtures.py`; the default output
+under the generated `tests/fixtures/repos/` directory is ignored. Never run the generated programs or
+commit their `.git` folders. `uv run python scripts/measure.py` validates the
+hand-written key; read `tests/fixtures/ANSWER_KEY.md` before changing any fixture.
+
+Use `pathlib` for filesystem paths. `.gitattributes` normalizes text to LF on
+every platform. Review the diff and propose a commit message; do not auto-commit.

docs_drift-0.1.0/LICENSE

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

docs_drift-0.1.0/PKG-INFO

@@ -0,0 +1,331 @@
+Metadata-Version: 2.5
+Name: docs-drift
+Version: 0.1.0
+Summary: Find evidence-backed drift between repository documentation and code.
+Project-URL: Homepage, https://github.com/ayushagarwalhere/docs-drift
+Project-URL: Documentation, https://ayushagarwalhere.github.io/docs-drift/
+Project-URL: Source, https://github.com/ayushagarwalhere/docs-drift
+Project-URL: Issues, https://github.com/ayushagarwalhere/docs-drift/issues
+Project-URL: Changelog, https://github.com/ayushagarwalhere/docs-drift/blob/main/CHANGELOG.md
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,developer-tools,documentation,drift,sarif,static-analysis
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: jinja2>=3.1
+Requires-Dist: markdown-it-py>=3.0
+Requires-Dist: pathspec>=1.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rapidfuzz>=3.9
+Requires-Dist: rich>=13.9
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tree-sitter-javascript<0.26,>=0.25
+Requires-Dist: tree-sitter-typescript<0.24,>=0.23.2
+Requires-Dist: tree-sitter<0.27,>=0.25
+Requires-Dist: typer<0.28,>=0.27.3
+Provides-Extra: dev
+Requires-Dist: deptry>=0.24; extra == 'dev'
+Requires-Dist: httpx>=0.28; extra == 'dev'
+Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: jsonschema>=4.23; extra == 'dev'
+Requires-Dist: mypy>=1.14; extra == 'dev'
+Requires-Dist: pillow>=11; extra == 'dev'
+Requires-Dist: pip-audit>=2.9; extra == 'dev'
+Requires-Dist: playwright>=1.48; extra == 'dev'
+Requires-Dist: pre-commit>=4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.17.1; extra == 'dev'
+Requires-Dist: rust-just>=1.40; extra == 'dev'
+Requires-Dist: types-jsonschema>=4.26; extra == 'dev'
+Requires-Dist: types-pyyaml>=6; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.6; extra == 'docs'
+Provides-Extra: graph
+Provides-Extra: llm
+Requires-Dist: httpx>=0.28; extra == 'llm'
+Provides-Extra: lsp
+Requires-Dist: lsprotocol>=2025.0; extra == 'lsp'
+Requires-Dist: pygls<3,>=2.0; extra == 'lsp'
+Provides-Extra: watch
+Requires-Dist: watchfiles<2,>=1.0; extra == 'watch'
+Provides-Extra: web
+Requires-Dist: fastapi>=0.115; extra == 'web'
+Requires-Dist: jinja2>=3.1; extra == 'web'
+Requires-Dist: uvicorn[standard]>=0.32; extra == 'web'
+Description-Content-Type: text/markdown
+
+# docs-drift
+
+Self-hosted documentation drift checks for maintainers: scan local repositories,
+review source evidence, and gate newly introduced drift in CI. Organizations can
+scan multiple checkouts into one dashboard with `docs-drift portfolio`.
+[PR reviews, feedback, history, ownership and fix branches](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/TEAM-WORKFLOWS.md).
+[Organization adoption](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/ORGANIZATIONS.md) · [Product maturity](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/PRODUCT.md).
+
+The product hypothesis is repeatable CI checks of exact documentation contracts
+for SDK, CLI and API maintainers. Start external repositories in report-only mode:
+real-world precision/recall and maintainer adoption remain unestablished.
+[Run a frozen maintainer review](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/MAINTAINER-PILOT.md) with blank human labels,
+source evidence and an explicit decision about keeping it in CI.
+
+## Judges start here
+
+**Smallest offline demo:** [exact local run steps and one synthetic claim](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/JUDGE-DEMO.md).
+Open `/scan/example-judge` in the local app to inspect the source, rename commit,
+and proposed documentation fix. Fixture results are not real-world accuracy measurements.
+
+- **Public demo:** AWS deployment deferred by owner. Run the app locally on port 8080; no public URL is claimed. [AWS handoff](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/AWS-HANDOFF.md).
+- **Real case:** [reproduced rich-cli failure, source and commit](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/REAL-CASE.md).
+- **Try immediately:** the local app includes a repo URL scanner and precomputed real sample, with no sign-in or API key.
+- **Interface:** monochrome themes, scroll-driven 3D evidence layers, motion controls and searchable reports; [UI verification](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/UI-REVIEW.md).
+- **Video:** pending owner recording and upload; target 1:50 with captions; [updated shot list](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/FLOW-RECORDING.md).
+- **Source:** [GitHub repository](https://github.com/ayushagarwalhere/docs-drift).
+- **Evidence:** [benchmark results](https://github.com/ayushagarwalhere/docs-drift/blob/main/benchmark/RESULTS.md),
+  [measured limitations](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/RESULTS.md), and [submission checklist](https://github.com/ayushagarwalhere/docs-drift/blob/main/SUBMISSION.md).
+
+Three-command local quick start (Python 3.11+, Git and uv installed):
+
+```sh
+git clone https://github.com/ayushagarwalhere/docs-drift.git
+cd docs-drift
+uv run --all-extras docs-drift scan --repo .
+```
+
+Release preparation: [owner's publish gates](https://github.com/ayushagarwalhere/docs-drift/blob/main/RELEASING.md). Public installs and
+URLs must be verified after publication; local checks do not prove a published release.
+
+**Find documentation statements your code no longer supports, with source evidence and available Git history.**
+
+[![CI](https://img.shields.io/badge/CI-configured-blue)](https://github.com/ayushagarwalhere/docs-drift/blob/main/.github/workflows/ci.yml)
+**Package status:** PyPI unpublished (404 verified 22 October 2026); use the source quick start.
+[![Licence](https://img.shields.io/badge/licence-MIT-blue)](https://github.com/ayushagarwalhere/docs-drift/blob/main/LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue)](https://github.com/ayushagarwalhere/docs-drift/blob/main/pyproject.toml)
+
+Alpha software: source installation works before the first package is published.
+The PyPI page becomes available after authenticated publication; the hosted
+demo and video remain explicitly pending above. Real-world
+precision and recall are **pending human labeling**, not inferred from fixtures.
+
+![Actual fixture scan output, eight-second terminal replay](https://raw.githubusercontent.com/ayushagarwalhere/docs-drift/main/docs/assets/scan-demo.gif)
+
+![HTML evidence graph from the actual py-cli fixture](https://raw.githubusercontent.com/ayushagarwalhere/docs-drift/main/docs/assets/graph-view.png)
+
+## A real failure, reproduced during this build
+
+To render rich-cli's README with line numbers, we followed its documented
+`--line-number` option. It exited 2: "No such option." Source declares
+`--line-numbers`, which exited 0. docs-drift locates README:61; manual Git
+inspection identifies documentation commit `567f6c84`. The scanner does not
+attribute a breaking commit for this finding. This is an agent-assisted build
+investigation, not an invented account of the owner's earlier work.
+[Exact snapshot, commands, source and review](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/REAL-CASE.md).
+
+The four-finding saved sample includes **two confirmed defects and two false
+positives**. A fresh scan flags only the defective options. This selected,
+agent-assisted review is not an independent human accuracy measurement.
+
+The `--port` / `--listen` images above are synthetic fixtures, excluded from the
+real case and review sample.
+
+For beginners contributing to documentation, an evidence-backed finding can be a
+concrete first contribution. Maintainers can use the same checks to keep docs
+aligned with a changing codebase; the suggested patches still need review.
+
+## Quick start
+
+From this source checkout, with Python 3.11+ and Git:
+
+```sh
+uv sync --locked --all-extras
+uv run docs-drift scan
+```
+
+After the first PyPI release, these are the intended package entry points:
+
+```sh
+pipx install docs-drift
+docs-drift scan
+# Alternative after publication:
+uvx docs-drift scan
+```
+
+Or build the CLI container locally (Docker must be running):
+
+```sh
+docker build -t docs-drift:local . && docker run --rm -v "$PWD:/repo" docs-drift:local scan --repo /repo
+```
+
+Try it in your browser: AWS hosting is deferred by the owner. Locally,
+start `uv run python -m docs_drift.web` and open `http://127.0.0.1:8080`; set
+`DOCS_DRIFT_ALLOWED_ORIGIN` to that exact origin before submitting a scan.
+
+Useful commands, exercised against a trusted fixture in CI:
+
+```sh
+docs-drift scan --no-color
+docs-drift scan --format html --output scan.html
+docs-drift insights --format json
+docs-drift impact --base HEAD~1 --format json
+docs-drift fix
+docs-drift check  # documented exit: 1 on the stale py-cli fixture
+```
+
+`scan` reports findings and exits 0. `check` exits 1 for findings meeting its
+threshold, or 2 for usage/configuration errors. `fix` previews a patch; applying
+it requires an explicit write option and confirmation. No target code is run.
+
+## What it checks (illustrative fixtures)
+
+| Claim kind | Example documentation | Static evidence |
+| --- | --- | --- |
+| CLI flag / command | A synthetic README mentions `--port` | argparse/Click/Typer or Commander declarations |
+| Environment variable | A synthetic README mentions `APP_LOG_LEVEL` | literal environment reads or safe config templates |
+| Endpoint | A synthetic guide requests `GET /status` | literal FastAPI/Flask/Express routes |
+| Setting / default | A synthetic guide says `workers` defaults to 4 | a recognized literal declaration/default |
+| Code symbol | A synthetic guide calls `Client.connect()` | a parsed function/class/method declaration |
+| File path | A synthetic guide links `config/settings.toml` | a contained repository-relative path |
+| Package script / task | A synthetic guide invokes `npm run build` | package manifests and Make/just task declarations |
+| Project command | A synthetic guide runs `tool serve --port 8000` | independently identified executable/command/flags |
+
+Arbitrary behavioural prose is not proved by name matching. Optional model
+assessment is separately labeled and constrained by source citations.
+
+## Supported ecosystems
+
+<!-- support-table:start -->
+| Language | Framework / surface | Support |
+| --- | --- | --- |
+| Python | AST declarations | partial |
+| Python | argparse | partial |
+| Python | Click | partial |
+| Python | Typer | partial |
+| Python | FastAPI | partial |
+| Python | Flask | partial |
+| Python | Django / DRF | none |
+| JavaScript / TypeScript | AST declarations | partial |
+| JavaScript / TypeScript | Commander | partial |
+| JavaScript / TypeScript | yargs | none |
+| JavaScript / TypeScript | Express | partial |
+| JavaScript / TypeScript | Next.js / NestJS routes | none |
+| JSON / YAML / TOML / INI | literal settings | partial |
+| Go / Rust | language-specific configuration | none |
+<!-- support-table:end -->
+
+Partial means recognized literal/static patterns, not complete framework support.
+No framework is advertised as fully supported. Dynamic registration, signatures,
+router composition and generated source may remain unverifiable.
+
+## CI
+
+This ten-line example uses the development Action from this repository:
+
+```yaml
+name: Documentation
+on: [push, pull_request]
+permissions: {contents: read}
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803
+      - uses: ./
+        with: {repo: '.', fail-on-drift: 'true'}
+```
+
+Other projects must replace the local action path with the real repository pinned
+to a reviewed commit after publication. Reports include JSON, HTML, SARIF and
+escaped Markdown. The Action needs no write token, accepts no model key, and never
+posts a PR comment automatically. [Action guide](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/github-action.md).
+
+![Preview of generated PR Markdown, not a submitted comment](https://raw.githubusercontent.com/ayushagarwalhere/docs-drift/main/docs/assets/pr-comment-preview.png)
+
+## Editor
+
+The development VS Code extension supplies diagnostics, definitions and safe
+quick fixes via the stdio LSP. **Actual squiggle GIF pending a verified editor
+capture**; protocol tests are not presented as a native-editor recording.
+[Extension guide](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/vscode.md).
+
+## How it works
+
+```mermaid
+flowchart LR
+  D[Docs] --> C[Located claims]
+  S[Source text / AST] --> I[Static index]
+  C --> M[Scoped matching]
+  I --> M
+  M --> H[Bounded Git history]
+  H --> R[Evidence, reports and reviewable fixes]
+```
+
+```mermaid
+flowchart LR
+  Section --> Claim
+  Claim --> Symbol
+  Symbol --> SourceFile
+  SourceFile --> Commit
+```
+
+Rules decide literal claims first. Optional model assessment handles selected
+anchored prose, cannot override code-decided findings, and must cite supplied
+source that passes validation.
+
+## Accuracy and limitations
+
+<!-- accuracy:start -->
+Real-world accuracy is **not yet established**. The 12-repository protocol and
+blank human labeling sheet are in [the benchmark](https://github.com/ayushagarwalhere/docs-drift/blob/main/benchmark/PROTOCOL.md); its
+[dated results](https://github.com/ayushagarwalhere/docs-drift/blob/main/benchmark/RESULTS.md) keep precision/recall pending until the owner
+labels them. Fixture scores establish plumbing, not product accuracy. Missing
+findings can be intentional examples, third-party tools or indexing limitations;
+review every report. [Known limitations](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/LIMITATIONS.md).
+<!-- accuracy:end -->
+
+## Configuration
+
+```toml
+# .docs-drift.toml
+min_confidence = 0.6
+[history]
+max_commits = 2000
+```
+
+The [full configuration reference](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/configuration.md) is generated from the
+Pydantic model and checked for freshness in CI. Common CLI options work before
+or after subcommands. [CLI reference](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/CLI.md).
+
+## Privacy and security
+
+Rule-only scans parse local text/AST and call Git for evidence. They never import
+or execute target modules or fenced commands. Optional model mode sends selected
+redacted documentation/source excerpts through OpenRouter to the chosen provider;
+replay mode sends nothing. The public demo and composite Action are rule-only.
+[Security policy](https://github.com/ayushagarwalhere/docs-drift/blob/main/SECURITY.md) ? [Threat model](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/SECURITY.md).
+
+## Built with voice
+
+The owner supplied original Flow usage cards, including **31,351 total words**,
+**276 words/minute**, **11 apps**, and a **1-day streak**, plus a separate card
+showing **26,412 total words**. These are account-level figures, not docs-drift
+word counts. [Actual cards and provenance](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/built-with-voice.md).
+
+The specific dictated prompts, build revisions and Flow-use recording still need
+owner evidence. [Concrete 1:50 recording plan](https://github.com/ayushagarwalhere/docs-drift/blob/main/docs/FLOW-RECORDING.md). No personal
+workflow or recording has been invented.
+
+## Contributing and licence
+
+See [CONTRIBUTING.md](https://github.com/ayushagarwalhere/docs-drift/blob/main/CONTRIBUTING.md). Run tests, lint and type checks before
+opening a change; do not change a frozen benchmark's rules or prefill human labels.
+The code is [MIT licensed](https://github.com/ayushagarwalhere/docs-drift/blob/main/LICENSE). [Changelog](https://github.com/ayushagarwalhere/docs-drift/blob/main/CHANGELOG.md).