Commit Graph
35 Commits
Author SHA1 Message Date
Claude ce72c4bbad fix(agents): replace gh CLI with curl for PR checking to prevent duplicate work
Agents do not have access to gh CLI, causing them to skip the pre-flight
PR check and collide on duplicate work. This replaces all gh-based PR
checking commands with curl + jq using the GitHub REST API, updates the
task claiming protocol to use branch push + started log file as the
primary lock mechanism, and updates automation scripts to use curl for
PR listing and git fetch for PR checkout.

Files updated:
- AGENTS.md (Section 12 coordination rules)
- CLAUDE.md (coordination rules)
- META_PROMPTS.md (daily + weekly meta prompts)
- daily-scheduler.md (pre-flight gate, task claiming, error handling)
- weekly-scheduler.md (pre-flight gate, task claiming, error handling)
- bitvid-pr-review-agent.md (PR enumeration + checkout)
- bitvid-ci-health-agent.md (CI run gathering)
- bitvid-weekly-synthesis-agent.md (PR metadata gathering)
- bitvid-changelog-agent.md (PR metadata verification)
- scripts/agent/review-open-prs.mjs (PR listing + checkout)
- scripts/automated-pr-review.mjs (--all mode PR listing + checkout)

https://claude.ai/code/session_01L5bzzGpZ6YTiLXcfqaL81G
2026-02-13 15:47:42 +00:00
Claude 17a736b8da refactor(agents): migrate task logs from CSV to directory-based format
Replace shared CSV files (AGENT_TASK_LOG.csv, WEEKLY_AGENT_TASK_LOG.csv)
with per-entry files in docs/agents/task-logs/{daily,weekly}/. Each log
entry is now a separate file named YYYY-MM-DD_HH-MM-SS_<agent>_<status>.md,
eliminating git merge conflicts and race conditions when multiple agents
run concurrently.

Updated files:
- daily-scheduler.md: rewritten for directory-based log format
- weekly-scheduler.md: rewritten for directory-based log format
- META_PROMPTS.md: updated pre-flight scan and claiming instructions
- AGENTS.md: updated scheduler reference from CSV to directory-based

Migrated all existing CSV entries to individual files in the new
directory structure.

https://claude.ai/code/session_01P62EWUXwupgxPhpnRejUuz
2026-02-13 04:41:05 +00:00
google-labs-jules[bot]andPR0M3TH3AN 77ec8e18c3 chore(agents): migrate persistent state files to timestamped directories
- Move `CONTEXT.md`, `TODO.md`, `DECISIONS.md`, `TEST_LOG.md` to `context/`, `todo/`, `decisions/`, `test_logs/` directories with timestamps.
- Update `AGENTS.md` and `CLAUDE.md` to define the new workflow: agents must read the latest timestamped file and create a new one when updating.
- Update `daily-scheduler.md` and `weekly-scheduler.md` to initialize tasks using the new file structure.
- Update all daily agent prompts to reference the new directory structure.
- This change prevents merge conflicts on persistent state files by treating them as an append-only log of snapshots.

Co-authored-by: PR0M3TH3AN <[email protected]>
2026-02-13 03:14:50 +00:00
Claude 749dece7dd docs(agents): add draft PR task claiming protocol to prevent duplicate work
When multiple agents (Claude Code, Codex, Jules) run schedulers concurrently,
they can pick up the same task because neither has committed yet. This adds a
"Draft PR Lock" protocol: agents must check for and create a draft PR before
starting work, acting as a distributed lock visible to all platforms.

Changes:
- AGENTS.md §12: new "Task Claiming Protocol" subsection with check/claim/race
  handling steps
- daily-scheduler.md: new Step 1.5 with concrete gh CLI commands
- weekly-scheduler.md: same Step 1.5 addition

https://claude.ai/code/session_01Vnih5ZARbEmnh3EGTDQAXX
2026-02-12 22:02:37 +00:00
Claude 33851013d8 docs: add Agent Execution Protocol (AGENTS.md §15)
Introduces a structured meta-workflow for AI agents that ensures
safe incremental changes, persistent state across context resets,
and a clear decision trail for multi-agent coordination.

Key additions:
- Work scoping (goal, success criteria, non-goals)
- External notes files (CONTEXT.md, TODO.md, DECISIONS.md, TEST_LOG.md)
- Locate → Implement → Verify → Update notes work loop
- Context recovery procedure for new agent sessions
- Quality bar principles
- Cross-references from CLAUDE.md to the new section

https://claude.ai/code/session_0159eSJrqKvKpgDiwYZ2iGxK
2026-02-12 18:54:14 +00:00
google-labs-jules[bot]andPR0M3TH3AN 761a5a2dd2 docs: align playback strategy documentation with codebase behavior
Updates AGENTS.md and README.md to reflect the configurable hybrid playback strategy (URL vs. WebTorrent) instead of asserting a strict "URL-First" rule, which contradicted the default configuration.

- Updated "Mission" in AGENTS.md to "Hybrid Playback Strategy".
- Clarified that `DEFAULT_PLAYBACK_SOURCE` controls priority.
- Updated README.md "How playback works" section.
- Adjusted QA checklists to focus on "configured priority" rather than "URL-first".

Co-authored-by: PR0M3TH3AN <[email protected]>
2026-02-11 17:00:12 +00:00
google-labs-jules[bot]andPR0M3TH3AN 5f7d1e4457 docs(ai): update quickstart and contributing (agent)
Co-authored-by: PR0M3TH3AN <[email protected]>
2026-02-11 14:39:48 +00:00
Claude f43cad1902 docs: add agent testing infrastructure documentation to AGENTS.md and CLAUDE.md
Section 14 in AGENTS.md covers the full test harness API, mock relay
HTTP endpoints, Playwright fixture usage, and data-testid selector
reference. CLAUDE.md testing section updated with quick-start example.

https://claude.ai/code/session_01XnrszNmdqrAGd8g8qhAn4G
2026-02-10 05:24:54 +00:00
Claude 804b3323c4 Add code health lint guards, consolidate relay constants, document agent prompts
Three CI-enforced lint scripts to prevent common codebase growth problems:

- lint:file-size — enforces 1000-line max for new JS files, grandfathers
  existing oversized files and prevents them from growing further
- lint:innerhtml — tracks innerHTML usage per-file with a baseline count,
  blocks new innerHTML additions (guides agents toward safe DOM APIs)
- Relay constants consolidated from duplicate definitions in client.js and
  ConnectionManager.js into shared js/nostr/relayConstants.js
- AGENTS.md Section 13: documents all three rules with examples
- docs/scheduled-agent-prompts.md: copy-paste prompts for recurring
  file decomposition, innerHTML migration, and constant dedup tasks

https://claude.ai/code/session_01LzErpH9FNw4hAPsjoYb1v9
2026-02-10 03:25:18 +00:00
Claude 1ebfefe9c8 Add multi-agent coordination guide to AGENTS.md and CLAUDE.md
- AGENTS.md Section 12: subsystem boundary table, PR discipline rules,
  in-flight work reservation section, and signaling conventions for
  parallel AI agent workflows (Claude Code, Codex, Jules)
- CLAUDE.md: document the unstable→beta→main promotion pipeline,
  add multi-agent workflow section with coordination rules for both
  agents and human maintainers, fix Node.js version reference (20→22)

https://claude.ai/code/session_01LzErpH9FNw4hAPsjoYb1v9
2026-02-10 02:44:35 +00:00
google-labs-jules[bot]andPR0M3TH3AN d35aced8ad docs: align development docs with codebase behavior
Updates documentation to match current codebase implementation:
- Deprecates `nostrClient.fetchVideos` in README.md, pointing to `subscribeVideos`.
- Clarifies `playVideoWithFallback` implementation location in `docs/playback-fallback.md` and `AGENTS.md` (moved to `js/app/playbackCoordinator.js`).
- Corrects `WATCH_HISTORY` d-tag description in `docs/nostr-event-schemas.md` to match actual code behavior (`<YYYY-MM>`).

Co-authored-by: PR0M3TH3AN <[email protected]>
2026-02-09 18:33:32 +00:00
google-labs-jules[bot]andPR0M3TH3AN 45f28f1d6b feat(telemetry): Document telemetry aggregation tool usage in AGENTS.md
- Added section 11 to AGENTS.md describing the `telemetry:aggregate` script.
- Documented privacy policy (PII sanitization) and opt-in guardrails.
- Verified the script functionality and PII removal.

Co-authored-by: PR0M3TH3AN <[email protected]>
2026-01-31 06:18:57 +00:00
google-labs-jules[bot] 281f102e84 docs: add instruction to read KNOWN_ISSUES.md in AGENTS.md
Updates AGENTS.md to explicitly instruct AI agents to review
KNOWN_ISSUES.md before starting development or debugging. This
ensures awareness of pre-existing test failures and environmental
quirks, preventing unnecessary investigation.
2026-01-22 01:36:56 +00:00
google-labs-jules[bot] 228ce1694f docs: Add NIP-04/NIP-44 dual support policy to AGENTS.md
Update AGENTS.md to explicitly require support for both legacy NIP-04 and newer NIP-44 Direct Messages, as many users still rely on the legacy standard.
2026-01-06 21:22:06 +00:00
google-labs-jules[bot] c621d9ad50 doc: add NIP-33 addressing lessons to AGENTS.md
Adds a new section to `AGENTS.md` documenting the importance of using
the `d` tag (network identifier) over logical IDs (like `videoRootId`)
when creating pointers for parameterized replaceable events (NIP-33).
This captures the lessons learned from recent watch history bugs where
mismatched identifiers caused hydration failures.
2026-01-06 14:37:33 +00:00
thePR0M3TH3AN e19abcbbf4 Document comment publishing signer requirement 2025-10-30 12:12:37 -04:00
thePR0M3TH3AN 51be9342be added nip database 2025-10-29 16:00:32 -04:00
thePR0M3TH3AN ad339133f1 Document logging channels and dev mode flow 2025-10-15 15:51:06 -04:00
thePR0M3TH3AN 490041ba51 Document styling and theming policy 2025-10-14 22:19:12 -04:00
thePR0M3TH3AN 3b14de35da chore: adopt gpl licensing and lowercase bitvid 2025-10-10 12:56:46 -04:00
thePR0M3TH3AN c1ae2c8c9f updated agents.md 2025-10-07 17:40:12 -04:00
thePR0M3TH3AN b3b467755a Stabilize collapsed sidebar rail 2025-10-06 19:57:16 -04:00
thePR0M3TH3AN 957a3ae6fa Fix collapsed sidebar layout and cache busting 2025-10-06 18:58:54 -04:00
thePR0M3TH3AN 58fd6ef7d5 Tighten collapsed sidebar rail spacing 2025-10-06 17:46:02 -04:00
thePR0M3TH3AN 2bafecfb50 Refine sidebar collapse interactions 2025-10-06 17:08:35 -04:00
thePR0M3TH3AN f04c21004a Bust cached sidebar assets 2025-10-06 16:27:13 -04:00
thePR0M3TH3AN 38ec169b22 Lower sidebar z-index below modals 2025-10-06 13:47:44 -04:00
thePR0M3TH3AN 7550007fe6 Add moderation documentation bundle 2025-10-05 01:52:50 -04:00
thePR0M3TH3AN 9e509bb782 update 2025-10-01 13:53:00 -04:00
thePR0M3TH3AN c9ebc80ab4 Document v3 publishing schema 2025-09-25 08:35:19 -04:00
thePR0M3TH3AN 1a6371fee3 Document magnet safety rules for contributors 2025-09-25 07:40:42 -04:00
thePR0M3TH3AN e85831bbf6 Update contributor docs for URL-first playback 2025-09-24 21:53:50 -04:00
thePR0M3TH3AN 96e1679618 update 2025-09-24 17:23:41 -04:00
thePR0M3TH3AN 7742e3968c Fix magnet playback handling and update agent guidance 2025-09-24 13:07:14 -04:00
thePR0M3TH3AN b51b692f31 Added Agents.md 2025-09-22 09:57:19 -04:00