chore: launch-prep hygiene for public repo

.github/workflows/audit.yml

@@ -4,9 +4,9 @@ on:
   workflow_dispatch:
     inputs:
       username:
-        description: GitHub username to audit
+        description: GitHub username to audit (defaults to saagpatel)
         required: false
-        default: saagpatel
+        default: ''
 
 permissions:
   contents: read

.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.11"]
+        python-version: ["3.11", "3.12"]
     steps:
       - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
       - name: Set up Python ${{ matrix.python-version }}

.gitignore

@@ -14,6 +14,8 @@ output/PORTFOLIO.md
 !output/.gitkeep
 config/notion-config.json
 HANDOFF.md
+proof-pr.json
+sprint*.png
 .claude/
 .serena/
 __pycache__/

CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project are documented here.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
+> **Versioning note:** The `0.x.0` entries below (0.1.0 through 0.19.0) reflect
+> the internal development history prior to the first public PyPI release. The
+> public PyPI line starts at `0.1.0` (tag `v0.1.0`, released 2026-05-18) and
+> follows `0.1.x` for patches. Do not conflate the internal `0.x.0` series with
+> PyPI release versions.
+
 ---
 
 ## [Unreleased]

README.md

@@ -9,7 +9,7 @@
 
 > Know the truth about every project you've ever started — because `git log` across a crowded repo portfolio doesn't tell you which ones are worth finishing.
 
-📐 **Case study — [Operator OS: a multi-agent control plane over a repo portfolio](CASE-STUDY.md).** How this auditor's truth layer anchors six local services and two coordinated coding agents (Claude Code + Codex), with real portfolio metrics and a [90-second demo plan](DEMO-PLAN.md).
+**Case study — [Operator OS: a multi-agent control plane over a repo portfolio](CASE-STUDY.md).** How this auditor's truth layer anchors six local services and two coordinated coding agents (Claude Code + Codex), with real portfolio metrics and a [90-second demo plan](DEMO-PLAN.md).
 
 GitHub Repo Auditor is a portfolio audit and operator tool for developers with a lot of repositories. It clones every repo on your GitHub account, runs 12 analyzers across completeness and interest dimensions, assigns letter grades and achievement badges, preserves historical state, and generates actionable dashboards you can actually use to decide what to work on next. Built for developers who ship fast, start often, and need a system to manage the sprawl.
 
@@ -212,8 +212,8 @@ Expected outputs include `output/demo/demo-report.json`,
 `output/demo/operator-control-center-demo.json`,
 `output/demo/operator-control-center-demo.md`,
 `output/demo/portfolio-truth-latest.json`,
-`output/demo/weekly-command-center-sample-user-2026-04-12.json`,
-`output/demo/security-burndown-sample-user-2026-04-12.json`,
+`output/demo/weekly-command-center-<username>-<date>.json`,
+`output/demo/security-burndown-<username>-<date>.json`,
 `output/demo/pending-proposals.json`, and `output/demo/portfolio-warehouse.db`.
 
 To browse the same fixture in the local web UI:
@@ -393,7 +393,7 @@ That command generates stable sample `standard` and `template` workbooks, valida
 After that manual desktop Excel check, record the outcome back into the gate artifacts:
 
 ```bash
-make workbook-signoff ARGS="--reviewer <name> --outcome passed --check excel-open-no-repair=passed --check visible-tabs-present=passed --check normal-zoom-readable=passed --check chart-placement-clean=passed --check filters-work=passed"
+make workbook-signoff ARGS="--reviewer yourname --outcome passed --check excel-open-no-repair=passed --check visible-tabs-present=passed --check normal-zoom-readable=passed --check chart-placement-clean=passed --check filters-work=passed"
 ```
 
 ## Managed Campaigns and Governance

pyproject.toml

@@ -18,7 +18,7 @@ keywords = [
     "developer-tools",
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
@@ -100,4 +100,4 @@ target-version = "py311"
 ignore = ["E501"]
 
 [tool.setuptools_scm]
-fallback_version = "0.19.0"
+fallback_version = "0.1.4"