Skip to content

Clean up for public release: drop broken examples, fix stale docs - #13

Merged
fioenix merged 3 commits into
mainfrom
chore/oss-publish-prep
Jun 30, 2026
Merged

Clean up for public release: drop broken examples, fix stale docs#13
fioenix merged 3 commits into
mainfrom
chore/oss-publish-prep

Conversation

@fioenix

@fioenix fioenix commented Jun 30, 2026

Copy link
Copy Markdown
Collaborator

Final cleanup before flipping the repo public, driven by a security + OSS-readiness audit.

Audit verdict

No secret/credential leakage, no PII, no injection vectors in shipped code (src/). Token redaction, 0600 .env perms, and the skills-install path hardening are all correct and test-covered.

Changes

  • Remove examples/ (HIGH). Scripts referenced a vendored examples/threads/cli/ + requirements.txt that don't exist in the src/ layout — broken for any user, wired into nothing (not in README/docs/CI). dashboard.py also sent post text to quickchart.io. The canonical workflow is the threads draft commands. Also drops the now-dead examples/** ruff ignore rule.
  • Remove BUILD-PLAN.md — internal planning doc, not for a public repo (recoverable from history).
  • Fix .env.example (MEDIUM) — redirect URI was http://localhost:8080 (Threads rejects http + wrong port) → https://localhost:8473; refresh stale auth-local notes.
  • Rewrite SECURITY.md — address-less "email the maintainer" → GitHub private vulnerability reporting; add credential-handling scope notes.
  • Plus (earlier commits on this branch): comprehensive CHANGELOG, [project.urls] metadata.

Known follow-up (non-blocking, LOW)

OAuth flow has no state/CSRF param. Risk is low for a manual copy-paste flow with no automated listener; deliberately not changing the auth path at publish time.

Verification

87 tests pass · ruff check + format clean · wheel builds and still bundles the skill · final secret/PII grep clean.

🤖 Generated with Claude Code

fioenix and others added 3 commits June 30, 2026 16:18
The [Unreleased] section only mentioned `export`; it now covers auth/setup/config,
snapshot, the draft-first publish gate, agent skill distribution, and the plugin
marketplace — the actual scope shipping in the first public release.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Homepage/Repository/Issues pointing at finolabs/threads-cli — standard metadata
for the wheel and any future package index listing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Security/OSS-readiness audit follow-ups before flipping public:

- Remove examples/ — the scripts referenced a vendored examples/threads/cli/
  layout and requirements.txt that no longer exist (src/ layout), were wired
  into nothing (not in README/docs/CI), and would fail for any user. One script
  also exfiltrated post text to quickchart.io. The canonical workflow lives in
  the `threads draft` commands. Drops the now-dead ruff examples/** ignore rule.
- Remove BUILD-PLAN.md — internal planning doc, not meant for a public repo.
- .env.example: redirect URI was http://localhost:8080 (rejected by Threads,
  wrong port); fix to https://localhost:8473 and refresh stale auth-local notes.
- SECURITY.md: replace the address-less "email the maintainer" with GitHub
  private vulnerability reporting; add credential-handling scope notes.

Audit found no secret/PII leakage and no injection vectors in shipped code.
87 tests pass, ruff clean, wheel still bundles the skill.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@fioenix
fioenix merged commit e676396 into main Jun 30, 2026
6 checks passed
@fioenix
fioenix deleted the chore/oss-publish-prep branch June 30, 2026 09:23
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