chore: repo hygiene — remove examples/ notebooks, untrack stale skill bundles + dead scripts, add OSS files (#130)

* chore: ignore AI-tool state + build junk, publish .claude rules/agents, add OSS hygiene

- .gitignore: ignore .claude/* then re-include only .claude/rules/ and
  .claude/agents/ so contributors and their AI agents inherit the project
  conventions; un-ignore root CLAUDE.md; ignore .crush/ .goose/
  (other AI harnesses' local skill dirs), *.tsbuildinfo, coverage/, *.tgz.
  Machine state (settings.local.json), shared config (settings.json),
  slash-commands and hooks stay local.
- Add .editorconfig, .gitattributes (LF normalization + generated-file
  marking), .nvmrc (20), .python-version (3.12), and .github/dependabot.yml
  (weekly pip + npm x2 + github-actions).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore: untrack stale line-voice-agent skill bundles

Agent Skills were migrated to the dedicated PatterAI/skills repo (#116);
the copies force-tracked under .agents/, .crush/, and .goose/ (plus
skills-lock.json) are stale duplicates. Stop tracking them — they are now
covered by the .gitignore AI-tool-state rules.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(scripts): remove dead one-shot notebook-scaffolding tooling

32 unreferenced scripts (section_cells_*, appendix_cells_*, inject_*,
scaffold_all_notebooks.sh, quickstart_cells.py, and two orphan tests).
The generated notebooks are already committed; nothing in CI, pre-commit,
pyproject, or the kept scripts references these. Kept the live tooling:
pr-validate.sh, check_notebook_parity.py, scan_notebook_secrets.py,
generate_notebook_fixtures.py, scaffold_notebook.py, run_all_notebooks.sh,
check_feature_docs_drift.py and their tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs(claude): publish engineering rules, subagents, and root CLAUDE.md

Make the project's engineering-discipline rules (.claude/rules/) and
subagent definitions (.claude/agents/) public so contributors and their
AI agents inherit the same conventions (parity, immutability, async,
authentic tests, security, release-via-PR, …), plus the root CLAUDE.md
entry guide.

Scrubbed before publishing: removed personal home paths and maintainer
usernames, replaced private-assets-repo references with a generic
$PATTER_ASSETS env var, rewrote the strategy-revealing "why" sections of
no-internal-docs.md and no-competitor-references.md to keep the actionable
policy without internal posture, fixed no-competitor-references.md's
self-contradictory ".claude never reaches the public repo" claim, and
corrected stale sdk/ / sdk-py/ / sdk-ts/ layout paths to libraries/.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore: keep .claude/rules local — publish only CLAUDE.md + subagents

Per maintainer decision, the engineering-discipline rules under
.claude/rules/ stay local (gitignored). Only the root CLAUDE.md and the
.claude/agents/ subagent definitions are published, so contributors can
reuse the agents without exposing the internal rule set. The .gitignore
re-include now covers .claude/agents/ only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore: keep the entire .claude/ directory local — publish only root CLAUDE.md

Per maintainer decision, nothing under .claude/ (rules, agents, commands,
hooks, settings) is published; the whole directory stays gitignored. Only
the root CLAUDE.md entry guide is committed. .gitignore reverts to ignoring
.claude/ wholesale.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore: keep root CLAUDE.md local — PR is now pure repo hygiene

Per maintainer decision, the root CLAUDE.md stays local (gitignored)
alongside the rest of .claude/. This PR no longer publishes any AI-agent
config; it is repo hygiene only: untrack stale skill bundles, remove dead
notebook-scaffolding scripts, ignore other AI tools' local dirs + build
junk, and add OSS hygiene files.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore: remove examples/ notebook series and its notebook-only tooling

The paired Python+TypeScript notebook series under examples/ is no longer
kept in the SDK repo. Remove it together with everything that existed only
to serve it:
- examples/ (entire notebook series)
- .github/workflows/notebooks.yml (notebook parity + setup CI)
- scripts/{check_notebook_parity,scaffold_notebook,scan_notebook_secrets,
  generate_notebook_fixtures,run_all_notebooks} + their tests
- the notebook stage + --skip-notebooks flag in scripts/pr-validate.sh
- the nbstripout + notebook-secret-grep hooks in .pre-commit-config.yaml
- the notebook-parity job in .github/workflows/docs-feature-drift.yml
- notebook references in AGENTS.md, CONTRIBUTING.md, the PR template, and a
  stale examples/ path in docs/dev-tools/dashboard.mdx

scripts/ now holds only pr-validate.sh and check_feature_docs_drift.py. SDK
test suites never depended on examples/, so this is CI-safe.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(docs): English-only TTS comment + correct logger namespace in contributor docs

- libraries/python/getpatter/tts/elevenlabs.py and the TS twin: the code
  comment quoted a user report in Italian ("audio a scatti") — restated in
  English ("choppy audio"). Comment-only, no behaviour change.
- AGENTS.md and CONTRIBUTING.md told contributors to use
  logging.getLogger("patter"), but the SDK uses getLogger("getpatter")
  everywhere (29 occurrences, zero "patter"). A logger under "patter" is
  invisible to getpatter-scoped filtering. Corrected to "getpatter".

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* chore(docs): correct logger namespace in bug-report issue template

The bug-report template told users to enable debug logging via
logging.getLogger("patter"), but the SDK logs under "getpatter".
Last public file still carrying the wrong namespace — now consistent
with AGENTS.md / CONTRIBUTING.md and the source.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: nicolotognoni