Merge origin/main into refactor/lock-ops-decomposition-2507393976208881863 (resolve conflicts)

src/context/2026-02-25T01-09-05Z__torch-garbage-collection-agent.md

@@ -0,0 +1,22 @@
+---
+agent: torch-garbage-collection-agent
+cadence: daily
+run-start: 2026-02-25T01:09:35Z
+---
+
+# Context
+Prompt: src/prompts/daily/torch-garbage-collection-agent.md
+
+## Goal
+Clean up stale log files and ephemeral memory updates from the repository root to maintain hygiene.
+
+## Scope
+- Files in the repository root matching `*.log`, `*.log.*`, `*.out.log`.
+- Files in `memory-updates/` matching `*.md`.
+- Only files older than 14 days.
+
+## Constraints
+- Must not delete files outside the repository root.
+- Must not delete files that do not match the specified patterns.
+- Must not delete files younger than 14 days.
+- Must verify candidates before deletion.

src/context/CONTEXT_2026-02-21T20-22-19Z.md

@@ -0,0 +1,21 @@
+---
+agent: refactor-agent
+cadence: weekly
+session: 2026-02-21T20:22:19Z
+run-start: 2026-02-21T20:22:19Z
+prompt: src/prompts/weekly/refactor-agent.md
+---
+
+# Context
+
+## Goal
+Refactor `src/ops.mjs` to improve modularity and fix CI failures.
+
+## Scope
+- Extract `cmdRemove` and related helpers into `src/cmd-remove.mjs`.
+- Fix `src/lock-utils.mjs` export issue causing CI syntax errors.
+- Fix `test/test-audit-run-flaky-check.test.mjs` assertion error.
+
+## Constraints
+- Preserve backward compatibility by re-exporting.
+- Add unit tests.

src/context/CONTEXT_2026-02-21T22-21-27Z.md

@@ -0,0 +1,31 @@
+# Context: Decompose Agent Run 2026-02-21T22-21-27Z
+
+- Agent: decompose-agent
+- Cadence: daily
+- Session: 2026-02-21T22-21-27Z
+- Run-Start: 2026-02-21T22-21-27Z
+- Prompt: src/prompts/daily/decompose-agent.md
+
+## Goal
+Decompose `src/lib.mjs` into smaller modules to reduce size by at least 200 lines.
+
+## Scope
+Decomposition of `src/lib.mjs` by extracting command implementations.
+
+## Constraints
+- Do not change behavior.
+- Reduce size by at least 200 lines.
+- Preserve existing functionality.
+
+## Selection
+- File: `src/lib.mjs`
+- Original Size: 730 lines
+- Reason: Largest grandfathered file not recently refactored (based on manual check).
+- Commit SHA: a6c06ce173fbbff9170476e4b97c1bac4b30cb10
+- Node/npm: v22.22.0 / 11.7.0
+
+## Plan
+Extract cohesive blocks:
+1. `cmdCheck`
+2. `cmdList`
+3. `cmdComplete`

src/context/CONTEXT_2026-02-21T23-11-21Z.md

@@ -0,0 +1,21 @@
+---
+agent: deps-security-agent
+cadence: daily
+run-start: 2026-02-21T23:11:21Z
+prompt: src/prompts/daily/deps-security-agent.md
+---
+# Run Context - 2026-02-21T23-11-21Z
+
+## Goal
+Perform daily security audit and safe upgrades.
+
+## Scope
+Dependency analysis, security reporting, and safe minor/patch upgrades.
+
+## Constraints
+- Do not force major upgrades.
+- Do not auto-upgrade crypto/protocol libs.
+- Run tests after upgrades.
+
+## Prompt Path
+src/prompts/daily/deps-security-agent.md

src/context/CONTEXT_2026-02-22.md

@@ -0,0 +1,19 @@
+---
+Agent: deps-security-agent
+Cadence: daily
+Run-Start: 2026-02-22T00:10:00Z
+Prompt: src/prompts/daily/deps-security-agent.md
+Platform: linux
+Node Version: v22.22.0
+Package Manager: npm
+---
+
+# Run Context — deps-security-agent — 2026-02-22
+
+## Goal
+Perform daily security audit and dependency maintenance.
+
+## Scope
+- Scan `package.json` and `package-lock.json`.
+- Identify vulnerabilities and outdated packages.
+- Attempt safe upgrades for direct dependencies.

src/context/CONTEXT_2026-02-22T01-05-54Z.md

@@ -0,0 +1,26 @@
+---
+Agent: design-system-audit-agent
+Cadence: daily
+Run-Start: 2026-02-22T01-05-54Z
+---
+
+# Context
+
+Executed prompt: `src/prompts/daily/design-system-audit-agent.md`
+
+## Goal
+Audit the repository for design system violations (inline styles, hex codes, raw lengths) and create a remediation report.
+
+## Scope
+- `landing/` directory
+- `dashboard/` directory
+- CSS and HTML files
+
+## Constraints
+- No automated style checking script exists in `package.json`.
+- Manual grep scans used as fallback.
+- No auto-fixes applied due to lack of policy.
+
+## Findings
+- `landing/index.html` contains significant inline styles and hardcoded hex values.
+- `dashboard/styles.css` defines the token system (CSS variables).

src/context/CONTEXT_2026-02-22T02-06-57Z.md

@@ -0,0 +1,29 @@
+---
+Agent: docs-agent
+Cadence: daily
+Run-Start: 2026-02-22T02-06-57Z
+---
+
+# Context
+
+## Goal
+Audit documentation for accuracy and alignment with the codebase.
+
+## Scope
+- `README.md`
+- `CONTRIBUTING.md`
+- `AGENTS.md`
+- `docs/` directory
+
+## Constraints
+- Do not modify implementation code.
+- Only update docs that are verifiably incorrect.
+
+## Findings
+- `README.md` commands for installation and development are accurate based on `package.json`.
+- `CONTRIBUTING.md` correctly lists testing commands (`npm test`, `npm run test:unit:lock-backend`).
+- `npm run format` and `npm run test:unit` (mentioned in agent prompt as targets) do not exist in `package.json`, so they are not documented.
+- `docs/lib-overview.md` and `docs/lock-ops-overview.md` exist as referenced.
+
+## Current State
+Documentation appears up-to-date with the current codebase state.

src/context/CONTEXT_2026-02-22T05-02-48Z.md

@@ -0,0 +1,22 @@
+---
+Agent: smoke-agent
+Cadence: weekly
+Run-Start: 2026-02-22T05-02-48Z
+---
+
+# Context
+
+Executed prompt: src/prompts/weekly/smoke-agent.md
+
+## Goal
+Verify repository health via smoke tests.
+
+## Scope
+- `npm run validate:scheduler`
+- `npm run test:integration:e2e`
+- `npm run test:ci-resilience`
+- `npm test`
+
+## Constraints
+- Run within the sandbox environment.
+- Respect known issues.

src/context/CONTEXT_2026-02-22T16:59:21Z.md

@@ -0,0 +1,21 @@
+---
+agent: docs-alignment-agent
+cadence: daily
+run-start: 2026-02-22T16:59:21Z
+---
+
+# Context: Documentation Alignment
+
+## Goal
+Verify and correct `TORCH.md` and `README.md` against codebase reality, specifically `package.json` scripts and `src/constants.mjs` CLI usage.
+
+## Scope
+- `TORCH.md`
+- `README.md`
+- `package.json`
+- `src/constants.mjs`
+
+## Constraints
+- Minimal changes.
+- Only fix clear mismatches.
+- Follow `src/prompts/daily/docs-alignment-agent.md` instructions.

src/context/CONTEXT_2026-02-22T18-16-24Z.md

@@ -0,0 +1,29 @@
+---
+agent: docs-code-investigator
+cadence: daily
+run-start: 2026-02-22T18:16:24Z
+---
+
+# Context - Docs Code Investigator - 2026-02-22
+
+Executed prompt: `src/prompts/daily/docs-code-investigator.md`
+
+## Goal
+To analyze and document `src/ops.mjs`, ensuring its behavior and public API are clear.
+
+## Scope
+- `src/ops.mjs`: Core CLI operations (`init`, `update`).
+- `docs/ops-overview.md`: High-level overview.
+
+## Constraints
+- No behavioral changes.
+- Non-invasive documentation only.
+
+## Selection
+- **Target File:** `src/ops.mjs`
+- **Reason:** Large file (567 lines), core logic, lacked JSDoc.
+- **Plan:**
+    1.  Analyze `src/ops.mjs` flow.
+    2.  Add JSDoc to all functions.
+    3.  Add file-level flow comment.
+    4.  Create `docs/ops-overview.md`.

src/context/CONTEXT_2026-02-22T19-15-51Z.md

@@ -0,0 +1,15 @@
+---
+agent: governance-agent
+cadence: daily
+run-start: 2026-02-22T19:15:51Z
+---
+
+# Goal
+Process prompt change proposals.
+Executed prompt: src/prompts/daily/governance-agent.md
+
+# Scope
+src/proposals/
+
+# Constraints
+Follow governance rules.

src/context/CONTEXT_2026-02-22T21-19-19Z.md

@@ -0,0 +1,21 @@
+---
+agent: innerhtml-migration-agent
+cadence: daily
+run-start: 2026-02-22T21:19:19Z
+---
+# Context
+
+Executed prompt: src/prompts/daily/innerhtml-migration-agent.md
+
+Goal: Migrate innerHTML usage in landing/index.html to safe DOM APIs.
+Scope: landing/index.html
+Constraints: Do not break functionality. Minimize changes.
+
+Reason: Security hardening and reducing innerHTML count.
+Date: 2026-02-22
+
+Plan:
+1. Replace container.innerHTML = '' with replaceChildren()
+2. Replace container.innerHTML = Error... with createElement
+3. Replace card.innerHTML = ... with createElement structure
+4. Keep marked.parse usage as is (documented)

src/context/CONTEXT_2026-02-22T22-35-00Z.md

@@ -0,0 +1,15 @@
+---
+agent: known-issues-agent
+cadence: daily
+run-start: 2026-02-22T22:35:00Z
+---
+Executed prompt: src/prompts/daily/known-issues-agent.md
+
+# Goal
+Triage known issues.
+
+# Scope
+KNOWN_ISSUES.md
+
+# Constraints
+None.

src/context/CONTEXT_2026-02-22T23-03-37Z.md

@@ -0,0 +1,22 @@
+---
+agent: load-test-agent
+cadence: daily
+run-start: 2026-02-22T23:03:37Z
+---
+
+# Context
+
+Executed prompt: src/prompts/daily/load-test-agent.md
+
+## Goal
+Execute a safe, reproducible load test against a local relay to measure baseline performance.
+
+## Scope
+- Create a local ephemeral relay for testing.
+- Run the load test harness (`scripts/agent/load-test.mjs`) against the local relay.
+- Generate a performance report.
+
+## Constraints
+- Must not target public relays.
+- Must use `load-test-agent` prompt instructions.
+- Must not introduce new dependencies if possible.

src/context/CONTEXT_2026-02-23T00-16-03Z.md

@@ -0,0 +1,21 @@
+---
+agent: known-issues-agent
+cadence: daily
+run-start: 2026-02-23T00-16-03Z
+---
+
+# Goal
+Triage known issues and verify their status.
+
+# Scope
+Validate KNOWN_ISSUES.md against the current environment (Jules).
+Focus on Active issues:
+- scheduler-preflight-lock.e2e.test.mjs
+- memory-telemetry.test.mjs
+- Sandbox restrictions (dashboard-auth, nostr-lock, ops)
+- Relay health
+
+# Constraints
+- Dark factory validation rules apply.
+- Do not modify tests unless correcting spec.
+- Only fix trivial/safe issues.

src/context/CONTEXT_2026-02-23T01-05-34Z.md

@@ -0,0 +1,21 @@
+---
+agent: load-test-agent
+cadence: daily
+run-start: 2026-02-23T01:05:34Z
+---
+
+# Context — load-test-agent
+
+## Goal
+Execute a scheduled load test (dry-run) to verify harness stability and ensure no regressions in load testing capabilities.
+
+## Scope
+- Run `scripts/agent/load-test.mjs` in dry-run mode.
+- Generate load test reports.
+- Verify safe execution (no public relay connections).
+
+## Constraints
+- Must not connect to public relays.
+- Must run in dry-run mode unless on dedicated infra.
+- Must update memory and artifacts.
+- Executed prompt: src/prompts/daily/load-test-agent.md

src/context/CONTEXT_2026-02-23T12-00-00Z.md

@@ -0,0 +1,23 @@
+---
+agent: onboarding-audit-agent
+cadence: daily
+run-start: 2026-02-23T12:00:00Z
+---
+
+# Context — onboarding-audit-agent
+
+## Goal
+Ensure fresh developer onboarding works from a clean checkout by validating README onboarding steps, documenting failures with full logs, and landing small docs fixes.
+
+## Scope
+- Validate onboarding from a clean environment.
+- Execute onboarding commands exactly as documented.
+- Capture complete failure logs and root-cause notes.
+- Patch README.md/CONTRIBUTING.md if needed.
+
+## Constraints
+- Follow the docs first.
+- Verify scripts exist.
+- No secrets.
+- Minimal churn.
+- Executed prompt: src/prompts/daily/onboarding-audit-agent.md

src/context/CONTEXT_2026-02-23T18-18-24Z.md

@@ -0,0 +1,20 @@
+---
+agent: perf-agent
+cadence: daily
+run-start: 2026-02-23T18:18:24Z
+---
+
+# Context: Perf Agent Run
+
+## Goal
+Daily measurable improvement of app responsiveness by finding and fixing background CPU/network work.
+
+## Scope
+- Search for performance patterns.
+- Analyze hits.
+- Report findings.
+- Fix low-hanging fruit (if any).
+
+## Constraints
+- Safe, incremental changes.
+- Verify work.

src/context/CONTEXT_2026-02-23T21-25-49Z.md

@@ -0,0 +1,19 @@
+---
+agent: perf-agent
+cadence: daily
+run-start: 2026-02-23T21:25:49Z
+---
+
+# Context
+
+Executed prompt: src/prompts/daily/perf-agent.md
+
+## Goal
+Daily scan for performance regressions.
+
+## Scope
+- Scan src/ for CPU/Network intensive patterns.
+- Generate report.
+
+## Constraints
+- Non-invasive scan.

src/context/CONTEXT_2026-02-24T00-28-14Z.md

@@ -0,0 +1,18 @@
+# Context: Onboarding Audit Agent
+
+- Agent: onboarding-audit-agent
+- Cadence: daily
+- Run Start: 2026-02-24T00:28:14Z
+- Prompt: src/prompts/daily/onboarding-audit-agent.md
+
+## Goal
+Ensure fresh developer onboarding works from a clean checkout by validating README onboarding steps.
+
+## Scope
+- Validating onboarding from a clean environment.
+- Executing `npm install`, `npm run build`, `npm test`, `npm run lint`.
+- Documenting failures.
+
+## Constraints
+- Follow docs first.
+- Minimal churn.

src/context/CONTEXT_2026-02-24T01-10-54Z.md

@@ -0,0 +1,21 @@
+---
+agent: perf-agent
+cadence: daily
+run-start: 2026-02-24T01:10:54Z
+---
+
+# Context
+
+Executed prompt: src/prompts/daily/perf-agent.md
+
+## Goal
+Daily, measurable improvement of app responsiveness by finding and fixing background CPU/network work that degrades UX.
+
+## Scope
+- `src/` directory for performance patterns.
+- `dashboard/` for UI responsiveness.
+
+## Constraints
+- Never invent files or APIs.
+- Keep changes small and incremental.
+- Verify changes with tests.

src/context/CONTEXT_2026-02-24T06-00-00Z.md

@@ -0,0 +1,13 @@
+---
+agent: test-coverage-agent
+cadence: weekly
+run-start: 2026-02-24T06:00:00Z
+---
+
+Executed prompt: src/prompts/weekly/test-coverage-agent.md
+
+**Goal:** Improve unit test coverage for `src/lock-utils.mjs`.
+
+**Scope:** `src/lock-utils.mjs` and related test files.
+
+**Constraints:** Do not break existing tests. Mock external dependencies.

src/context/CONTEXT_2026-02-24T16-49-41Z.md

@@ -0,0 +1 @@
+Not needed

src/context/CONTEXT_2026-02-24T18-18-09Z.md

@@ -0,0 +1,18 @@
+---
+agent: style-agent
+cadence: daily
+run-start: 2026-02-24T18:18:09Z
+---
+# Context
+
+**Goal:** Keep code style consistent by running the repo’s configured formatters/linters.
+
+**Scope:**
+- Run `npm run format` (eslint --fix)
+- Run `npm run lint` (eslint)
+- Run `npm run lint:inline-styles`
+
+**Constraints:**
+- No refactors, behavior changes, renames, “cleanup”, or stylistic rewrites.
+- Only safe auto-fixes.
+- Do not bypass policy checks.

src/context/CONTEXT_2026-02-24T21-04-05Z.md

@@ -0,0 +1,18 @@
+---
+agent: todo-triage-agent
+cadence: daily
+run-start: 2026-02-24T21:04:05Z
+---
+# Context
+
+Prompt: src/prompts/daily/todo-triage-agent.md
+
+## Goal
+Scan codebase for TODO/FIXME/XXX markers and triage them.
+
+## Scope
+- Source files
+- Docs
+
+## Constraints
+- Only fix trivial items.

src/context/CONTEXT_2026-02-24T22-17-46Z.md

@@ -0,0 +1,22 @@
+---
+agent: torch-garbage-collection-agent
+cadence: daily
+run-start: 2026-02-24T22:17:46Z
+---
+
+Prompt: src/prompts/daily/torch-garbage-collection-agent.md
+
+# Context
+
+## Goal
+Clean up stale log files and memory updates older than 14 days to keep the repository tidy.
+
+## Scope
+-   Log files (`*.log`, `*.log.*`, `*.out.log`) in the repository root.
+-   Memory updates (`memory-updates/*.md`) in the repository root.
+-   Files older than 14 days.
+
+## Constraints
+-   Do not delete files outside the repository root.
+-   Do not delete non-log/non-memory files.
+-   Do not broaden scope if deletion fails.

src/context/CONTEXT_2026-02-24T23-22-51Z.md

@@ -0,0 +1,21 @@
+---
+agent: audit-agent
+cadence: daily
+run-start: 2026-02-24T23:22:51Z
+---
+
+# Context: Daily Audit Run
+
+**Goal:** Run static audit scripts to identify regressions in file size, innerHTML usage, and lint errors.
+
+**Scope:**
+- `check-file-size.mjs`
+- `check-innerhtml.mjs`
+- `npm run lint`
+
+**Constraints:**
+- Do not modify source files.
+- Report only.
+- Redact secrets.
+
+**Prompt:** src/prompts/daily/audit-agent.md

src/context/CONTEXT_2026-02-25T00-30-00Z.md

@@ -0,0 +1,22 @@
+---
+agent: todo-triage-agent
+cadence: daily
+run-start: 2026-02-25T00:30:00Z
+---
+
+# Context — 2026-02-25T00:30:00Z
+
+**Prompt:** src/prompts/daily/todo-triage-agent.md
+
+## Goal
+Scan the codebase for TODO/FIXME/XXX markers, inventory them, and triage them by fixing trivial items or creating issues for larger ones.
+
+## Scope
+- Scan `src/` and `dashboard/` directories.
+- Ignore `node_modules`, `task-logs`, and `artifacts`.
+- Create inventory in `artifacts/todos.txt`.
+
+## Constraints
+- Only fix trivial, safe items (< 1 hour, low risk).
+- Do not modify sensitive areas.
+- Create issues (documented in TODO artifact) for non-trivial items.

src/context/CONTEXT_2026-02-25T02-31-57Z.md

@@ -0,0 +1,12 @@
+---
+agent: audit-agent
+cadence: daily
+run-start: 2026-02-25T02:31:57Z
+---
+
+# Context
+
+- **Goal**: Run daily audit scripts.
+- **Scope**: Repository wide.
+- **Constraints**: Read-only, no code changes.
+- **Prompt**: /app/src/prompts/daily/audit-agent.md

src/context/telemetry_skip.md

@@ -0,0 +1 @@
+Not needed. Telemetry agent found no opt-in logs to process.