[v0.6.1 Phase 0] Hygiene cleanup — branches, About-box, topics

[dfrostar]

Tracking issue for Phase 0 of the v0.6.1 "Install Anywhere" plan.

See docs/HANDOFF-v0.6.1.md for full context.

Scope

No public-facing marketing — table-stakes credibility moves so first-time visitors see an actively maintained project.

Tasks

• Delete throwaway branches from the v0.6.0 train:
  • claude/dispatch-release-v0.6.0 (the one-shot release.yml dispatcher; couldn't delete via MCP auth)
  • claude/v0.6.0-handoff-doc (superseded; content was the playbook for the now-shipped session)
• Audit + archive/delete ~30 stale claude/* and copilot/* branches (none are tracked in open PRs anymore). Use git for-each-ref --merged main refs/remotes/origin/ to find safe-to-delete merged branches.
• Triage stale open PRs:
  • Self-improvement engine: plans + D1 logging substrate + D2 selector auto-tuning #100 self-improvement engine — substantial feature; decide rebase or close
  • chore(deps): bump mcp from 1.27.0 to 1.27.1 #93 mcp 1.27.0 → 1.27.1 (dependabot) — likely outdated, check for new version
  • chore(deps): bump chromadb from 1.5.8 to 1.5.9 #94 chromadb 1.5.8 → 1.5.9 (dependabot) — likely outdated
  • chore(deps): bump mypy from 1.20.2 to 2.0.0 #95 mypy 1.20.2 → 2.0.0 (dependabot) — major version, needs review
• Repo About-box rewrite (top of repo page). Suggested copy in PR docs: refresh roadmap + landing pages with current graph-view plan #107 body:

  Local-first semantic code intelligence for AI coding agents. 40-70× token reduction on code questions, brain-like synapse layer that learns from co-activation, and an Obsidian-style graph view (neuralmind serve). MCP server + PostToolUse compression for Claude Code, Cursor, Cline, Continue.

• Repo topics chips — add: graph-view, code-visualization, synapse, hebbian-learning, obsidian, force-directed-graph, code-graph. (Currently 10; aiming for ~17.)
• Verify PyPI trusted publisher still pinned to release.yml. Should be fine since the v0.6.0 publish succeeded, but confirm at https://pypi.org/manage/project/neuralmind/settings/publishing/

Out of scope

• Any code changes
• pyproject.toml keywords (bundled with Phase 1 instead)

Why it matters

Indirect marketing. A visitor landing on the repo today sees ~70 branches and no recent About-box edit. Two hours of UI clicks moves the project visibly from "lots going on, hard to read" to "tight ship". This sets up Phase 1's announcement to land in a credible context.

Effort

~1-2 hours, all UI work that needs maintainer hands (mostly). MCP tools can do PR triage and issue tracking; branch deletion via UI.

[dfrostar]

Progress update — what's done vs what's still UI-bound.

Done (landed in main)

• ✅ Stale PR triage — all four PRs called out in the original issue have been resolved:
  • Self-improvement engine: plans + D1 logging substrate + D2 selector auto-tuning #100 (self-improvement engine) → closed; tracking issue opened as Self-improvement engine — rebuild on v0.11 base (replaces #100) #156 for a clean rebuild on the v0.11 base. Branch claude/plan-next-task-nwJak preserved.
  • chore(deps): bump mcp from 1.27.0 to 1.27.1 #93 / chore(deps): bump chromadb from 1.5.8 to 1.5.9 #94 (old mcp + chromadb dependabot bumps) → superseded by newer dependabot PRs; no longer in the queue.
  • chore(deps): bump mypy from 1.20.2 to 2.0.0 #95 (mypy 2.0) → equivalent chore(deps): bump mypy from 1.20.2 to 2.1.0 #135 (mypy 2.1.0) was opened and we closed it deliberately — major mypy version jumps need their own focused session, not auto-merge.
• ✅ Hygiene PR landed — chore: repo hygiene pass — junk removal + SECURITY/CONTRIBUTING review #157 just merged:
  • Removed the six accidentally-committed GitHub Actions runner-log directories at the repo root (Build Package/, Lint/, Test (Python 3.x)/, Type Check/) with .gitignore guard against recurrence.
  • SECURITY.md review pass (accurate version table, real reporting email, all v0.4/v0.6/v0.10/v0.11 attack surfaces documented).
  • CONTRIBUTING.md refresh (project tree, Discussions triage, dropped dangling pre-commit reference).
  • Deleted stale docs/DOCUMENTATION-AUDIT.md (April 22 artifact referencing files that no longer exist).
• ✅ PyPI trusted publisher still pinned (v0.10.0 + v0.11.0 publishes both succeeded — implicit confirmation).

Still UI-bound (need maintainer hands in the GitHub UI)

Cannot be done via MCP — direct paste actions in the repo settings:

• Delete throwaway branches from the v0.6.0 train:
  • claude/dispatch-release-v0.6.0
  • claude/v0.6.0-handoff-doc
• Audit + delete ~30 stale claude/* and copilot/* branches — git for-each-ref --merged main refs/remotes/origin/ to find safe-to-delete merged branches; bulk delete via Settings → Branches.
• Repo About-box rewrite — drafted copy (matches the new persistent-memory framing from PR docs: reframe README + PyPI around persistent memory, demote token savings #154) ready to paste:

  Persistent memory for AI coding agents. Your agent learns your codebase the way a senior engineer would — what files go together, what you usually edit next. Works with Claude Code, Cursor, Cline, Continue. 100% local. (Side effect: 40-70× cheaper code questions.)

• Repo topics chips — 20 drafted (paste each into the topics chip input):
  persistent-memory, ai-coding-agent, agent-memory, mcp-server, claude-code, cursor, hebbian-learning, synapse-layer, next-file-prediction, directional-transitions, local-first, semantic-code-search, knowledge-graph, graph-view, obsidian-style, markov-chain, token-reduction, llm-tools, developer-tools, python
• Enable Discussions + 3 pinned posts + 6 category descriptions + 4 templates — full step-by-step copy/paste material drafted; ready to apply.

Closing this issue

Recommend closing once the UI-bound items above are done. If they're going to remain pending for more than a week, leave open as a maintainer checklist; otherwise close and re-open if anything resurfaces.

---

Generated by Claude Code

[dfrostar]

Status as of 2026-06-12 — everything here is done except branch deletion, which needs maintainer credentials.

Done:

• About-box: rewritten (current copy is the "Persistent memory for AI coding agents…" version, stronger than the draft in this issue).
• Topics: at GitHub's 20-topic cap, including graph-view, hebbian-learning, synapse-layer, obsidian-style, code-visualization-adjacent terms. Nothing more can be added without dropping something.
• Stale PR triage: Self-improvement engine: plans + D1 logging substrate + D2 selector auto-tuning #100 closed in favor of Self-improvement engine — rebuild on v0.11 base (replaces #100) #156; the dependabot PRs (chore(deps): bump mcp from 1.27.0 to 1.27.1 #93/chore(deps): bump chromadb from 1.5.8 to 1.5.9 #94/chore(deps): bump mypy from 1.20.2 to 2.0.0 #95) were closed/superseded earlier; today's codecov bump (chore(ci): bump codecov/codecov-action from 4 to 7 #227) reviewed and merged.
• PyPI trusted publisher: confirmed working — v0.23.0, v0.24.0, and v0.25.0 all published via release.yml (now fully automatic since ci: auto-dispatch the publish workflow when release-please cuts a tag #226).

Remaining (needs your local git credentials — the remote-session proxy only permits pushes to its own work branch):

Delete the ~118 stale claude/* and copilot/* branches. All their PRs are merged or closed, and commits stay reachable via GitHub's refs/pull/N/head even after deletion. From a local clone:

git fetch origin --prune
git for-each-ref --format='%(refname:short)' refs/remotes/origin/ \
  | sed 's#^origin/##' \
  | grep -E '^(claude|copilot)/' \
  | xargs git push origin --delete

(If any branch is the head of an open PR at the time you run it, GitHub will refuse that single deletion and the rest proceed — but as of now no open PR uses a claude/*/copilot/* head.)

After that this issue can close.

---

Generated by Claude Code