feat: add private notes note-taking agent

[Ju-usc]

Summary

This PR adds a new private-notes community ability for OpenHome. It provides a voice-first note-taking flow that can create, read, update, and delete private notes while keeping note data in persistent JSON storage.

What changed

• add community/private-notes/main.py with a single-prompt tool loop for note operations
• add confirmation-protected overwrite and delete flows
• store notes in private_notes.json and safely overwrite JSON by deleting any existing file before writing
• cap readback to the 3 most recent matched notes
• add README.md and SPEC.md describing behavior, storage, and validation

Behavior

• resolves note actions through an LLM-driven tool loop with write_note, read_notes, delete_notes, ask_followup, and finish
• uses recency ordering by updated_at so the latest note is always first in the note index
• asks follow-up questions when the request is ambiguous instead of guessing
• requires explicit confirmation before destructive changes
• returns a graceful error result when an overwrite targets a missing note id

Validation

• python3 -m py_compile abilities/community/private-notes/main.py
• python3 abilities/validate_ability.py abilities/community/private-notes

[github-actions]

🔀 Branch Merge Check

PR direction: feat/private-notes → dev

✅ Passed — feat/private-notes → dev is a valid merge direction

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

🔍 Lint Results

✅ __init__.py — Empty as expected

Files linted: community/private-notes/main.py

✅ Flake8 — Passed

✅ All checks passed!

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/private-notes
  ✅ All checks passed!

[Copilot]

Pull request overview

Adds a new community ability (private-notes) to provide a voice-first CRUD note-taking flow backed by persistent JSON storage.

Changes:

• Introduces an LLM-driven tool loop (write_note, read_notes, delete_notes, ask_followup, finish) with a max-turn cap.
• Implements persistent storage in private_notes.json, including “delete before write” to avoid append-corrupted JSON.
• Adds end-user and technical documentation (README.md, SPEC.md) describing behavior and data model.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 7 comments.

File	Description
community/private-notes/main.py	Implements the ability runtime, tool loop, and JSON persistence for notes.
community/private-notes/README.md	Documents user-facing usage, storage, and suggested trigger phrases.
community/private-notes/SPEC.md	Specifies architecture, tool contracts, data model, and validation steps.
community/private-notes/init.py	Adds required package marker file for ability validation/CI.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[uzair401]

Approved for community.
We will proceed with adopting this ability for a 30-day evaluation period to monitor performance, identify any bugs, and implement any necessary fixes or optimizations. If the ability proves stable and meets our quality standards during this period, we will move forward with publishing it to the marketplace, ensuring full credit is given to the original author for their work and contribution.
We truly appreciate your effort and encourage you to continue developing and submitting new abilities. Contributions like yours help strengthen the ecosystem, and we look forward to seeing more of your work.