chore: launch-prep hygiene for public repo (#117)

* chore: launch-prep hygiene fixes for public repo

- fix: set setuptools-scm fallback_version to 0.1.4 (matches latest
  PyPI/GitHub tag); was incorrectly set to 0.19.0 (internal dev series)
- docs: add versioning note to CHANGELOG.md explaining the 0.x.0
  internal history vs the public 0.1.x PyPI line
- chore: git rm proof-pr.json (CI artifact, not project source)
- chore: git rm sprint13-*.png (unreferenced dev screenshots)
- chore: add proof-pr.json and sprint*.png to .gitignore
- fix: audit.yml username input default changed from hardcoded owner
  account to empty string; remove || fallbacks in run blocks
- ci: expand Python matrix to include 3.12 alongside 3.11
- fix: Development Status classifier bumped from Alpha to Beta
- docs: replace hardcoded dated filenames in README demo section with
  generic glob patterns
- docs: replace literal <name> placeholder in workbook-signoff example
  with 'yourname'
- docs: remove emoji from README case-study line

* fix(audit-workflow): guard empty username dispatch with saagpatel fallback

`workflow_dispatch` with no username input produced an empty USERNAME,
causing `audit ""` to hit `/users//repos` and build a blank handoff
title. Add `|| 'saagpatel'` fallback to all three USERNAME assignments
so a bare "Run workflow" click audits the canonical owner rather than
failing silently.

Fixes test_packaging.py assertion and addresses P2 review comment on PR #117.

Author: saagpatel

.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

proof-pr.json

@@ -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"