docs: Fix broken links and update outdated refresh references

[robinebers]

Fix broken links in README and update all documentation to reflect current auto-update timer behavior (manual Refresh button was removed).

Changes

• Fix 2 broken links in README (docs/openusage-api.md → docs/plugins/api.md)
• Update all "Refresh" references to reflect auto-update timer behavior
• Delete docs/choices.md and docs/breadcrumbs.md, add to .gitignore

Made with Cursor

---

Note

Low Risk
Low risk: documentation-only updates plus ignoring agent-generated docs files; no runtime or build behavior changes.

Overview
Updates docs to reflect the current auto-update timer behavior (probes run on app load and on a configurable 5/15/30/60-minute interval) and removes outdated mentions of manual Refresh-driven probing.

Fixes broken README references by pointing the Plugin API link to docs/plugins/api.md, and adds docs/choices.md / docs/breadcrumbs.md to .gitignore while deleting those agent working files from the repo.

^{Written by Cursor Bugbot for commit 723ebb0. This will update automatically on new commits. Configure here.}

---

Summary by cubic

Fix broken README links and update all docs to reflect the auto-update timer (5/15/30/60 min) replacing the manual Refresh button. Remove outdated breadcrumbs/choices docs and add them to .gitignore.

^{Written for commit 723ebb0. Summary will update on new commits.}

[macroscopeapp]

Update docs to reflect configurable auto-update interval (5/15/30/60 min) and fix Plugin API link path in README.md

Revise plugin execution timing to use an auto-update timer and correct Plugin API links, remove deprecated docs, and ignore agent-generated doc files.

📍Where to Start

Start with the Execution Timing section in docs/plugins/api.md and the architecture notes in docs/plugins/schema.md.

---

Macroscope summarized 723ebb0.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 723ebb0267

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[cubic-dev-ai]

1 issue found across 7 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name=".gitignore">

<violation number="1" location=".gitignore:31">
P2: Ignoring `/docs/choices.md` and `/docs/breadcrumbs.md` contradicts the documented workflow that requires updates to these files. Keeping them in `.gitignore` will prevent required decision/breadcrumb logs from being committed.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P2: Ignoring /docs/choices.md and /docs/breadcrumbs.md contradicts the documented workflow that requires updates to these files. Keeping them in .gitignore will prevent required decision/breadcrumb logs from being committed.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At .gitignore, line 31:

<comment>Ignoring `/docs/choices.md` and `/docs/breadcrumbs.md` contradicts the documented workflow that requires updates to these files. Keeping them in `.gitignore` will prevent required decision/breadcrumb logs from being committed.</comment>

<file context>
@@ -26,3 +26,7 @@ coverage
 !.env.example
+
+# Agent working files
+docs/choices.md
+docs/breadcrumbs.md
</file context>