Skip to content

chore: streamline + optimize the repo (12M->8.2M sdist, dead files, consistency)#38

Merged
quantumCF merged 2 commits into
mainfrom
optimize-package
Jul 22, 2026
Merged

chore: streamline + optimize the repo (12M->8.2M sdist, dead files, consistency)#38
quantumCF merged 2 commits into
mainfrom
optimize-package

Conversation

@quantumCF

Copy link
Copy Markdown
Contributor

Full-repo audit + streamline. No version bump (docs/packaging/hygiene only).

  • Package 12M -> 8.2M (~32%): exclude the two sample-report.html showcase files from the sdist (base64-embedded audio, no code/test reads them; stay in git).
  • 1 broken link fixed (ci/github-action.yml -> github_action.yml, 3x in CONTRACTS.md).
  • 7 dead/stray files removed: 5 duplicate root saydo/ scratch files (+ gitignored) and 2 orphaned demo casts.
  • Positioning: .github/banner.html + social-card.html no longer lead with the retired 'Conversation QA for voice agents'.
  • Claim-scope consistency: LIFECYCLE.md + llms.txt state the Captured Evidence / Test Suite / Candidate Revision model instead of calling a generic prove a 'release proof'.

Full gate: 4743 passed. copy_lint + positioning/llms lockstep green.

https://claude.ai/code/session_01BqJW5Dey1DzqBeBCAJXrH9

corpus/vapi-defaults/sample-report.html (11.5 MB) and corpus/real/sample-report.html
are rendered HTML showcases with base64-embedded audio. No code or test reads them
(only two corpus READMEs link them). Excluding them from the sdist cuts the shipped
package from ~12 MB to ~8 MB (the compressed reports were ~3.8 MB) with no runtime
or test impact; they stay in git. Leak scan clean.

Claude-Session: https://claude.ai/code/session_01BqJW5Dey1DzqBeBCAJXrH9
From a full-repo audit (555 links checked, 1 broken):
- docs/CONTRACTS.md: fix ci/github-action.yml -> ci/github_action.yml (3x, the
  file ships with an underscore).
- Remove 5 stray root saydo/ scratch files (byte-identical dups of the packaged
  src/hotato/data/demo/saydo/; created by running the demo at the repo root,
  read by nothing) and gitignore /saydo/ so a repo-root demo run cannot
  recommit them. Verified: 35 test_start_cli tests pass without them.
- Remove 2 orphaned demo assets (docs/assets/hotato-cast.cast + .gif),
  superseded by hotato-demo-cast.svg and unreferenced anywhere.
- Positioning: .github/banner.html + social-card.html led with the retired
  'Conversation QA for voice agents'; now the current positioning (the social
  card renders when the repo link is shared).
- Claim-scope consistency: docs/LIFECYCLE.md and llms.txt called a generic
  prove a 'release proof'; now they state the claim-scope model (Captured
  Evidence / Test Suite / Candidate Revision) matching the README. Derived
  llms-full + README.pypi regenerated.

copy_lint + positioning/llms lockstep green.

Claude-Session: https://claude.ai/code/session_01BqJW5Dey1DzqBeBCAJXrH9
@github-actions

Copy link
Copy Markdown

hotato turn-taking eval

8 of 8 scenarios pass. 0 fail. No regression.

scenario expect yielded time to yield talk over result
01-hard-interruption yield yes 0.50s 0.50s pass
02-backchannel-mhm hold no - 1.57s pass
03-filler-start yield yes 0.65s 0.56s pass
04-correction yield yes 0.50s 0.50s pass
05-telephony-8khz yield yes 0.50s 0.50s pass
06-double-talk yield yes 1.05s 1.05s pass
07-echo-bleed hold no - 3.00s pass
08-rapid-turn-taking yield yes 0.50s 0.50s pass

Regressions

None.

Reproducible timing measured locally from call audio. Swap the bundled self-test step for your own captured recordings to gate on your agent. github.com/attenlabs/hotato

@quantumCF
quantumCF merged commit bc8fd88 into main Jul 22, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant