From 1f4c3d35efadea08a398f93a1abb7b0ca10f94bc Mon Sep 17 00:00:00 2001 From: Jason Thistlethwaite Date: Wed, 6 May 2026 05:06:47 -0400 Subject: [PATCH] Convert markdown links to repo-relative paths Replace absolute local filesystem markdown links with repository-relative targets and drop local :line suffixes so links resolve consistently across environments. --- AGENT.md | 22 ++++++++++---------- README.md | 60 +++++++++++++++++++++++++++---------------------------- 2 files changed, 41 insertions(+), 41 deletions(-) diff --git a/AGENT.md b/AGENT.md index fb1629d..3a4f3b3 100644 --- a/AGENT.md +++ b/AGENT.md @@ -77,25 +77,25 @@ embedding calls. Top-level docs: -- [README.md](/home/iadnah/redmine/README.md:1) -- [docs/event_outbox_spec.md](/home/iadnah/redmine/docs/event_outbox_spec.md:1) -- [docs/redmineup_local_fork_changelog.md](/home/iadnah/redmine/docs/redmineup_local_fork_changelog.md:1) -- [docs/pre_existing_issues.md](/home/iadnah/redmine/docs/pre_existing_issues.md:1) +- [README.md](README.md) +- [docs/event_outbox_spec.md](docs/event_outbox_spec.md) +- [docs/redmineup_local_fork_changelog.md](docs/redmineup_local_fork_changelog.md) +- [docs/pre_existing_issues.md](docs/pre_existing_issues.md) Main scripts: -- [redmine_contacts.py](/home/iadnah/redmine/redmine_contacts.py:1) -- [redmine_helpdesk_search.py](/home/iadnah/redmine/redmine_helpdesk_search.py:1) -- [redmine_outbox_worker.py](/home/iadnah/redmine/redmine_outbox_worker.py:1) +- [redmine_contacts.py](redmine_contacts.py) +- [redmine_helpdesk_search.py](redmine_helpdesk_search.py) +- [redmine_outbox_worker.py](redmine_outbox_worker.py) Local Redmine copy: -- [redmine-copy](/home/iadnah/redmine/redmine-copy) +- [redmine-copy](redmine-copy) Important local plugin paths: -- [redmine-copy/plugins/redmine_event_outbox](/home/iadnah/redmine/redmine-copy/plugins/redmine_event_outbox) -- [redmine-copy/plugins/redmine_contacts_helpdesk](/home/iadnah/redmine/redmine-copy/plugins/redmine_contacts_helpdesk) +- [redmine-copy/plugins/redmine_event_outbox](redmine-copy/plugins/redmine_event_outbox) +- [redmine-copy/plugins/redmine_contacts_helpdesk](redmine-copy/plugins/redmine_contacts_helpdesk) ## What Has Already Been Done @@ -231,7 +231,7 @@ Existing rollback archives: Read: -- [docs/pre_existing_issues.md](/home/iadnah/redmine/docs/pre_existing_issues.md:1) +- [docs/pre_existing_issues.md](docs/pre_existing_issues.md) Especially remember: diff --git a/README.md b/README.md index ca3f5f3..625ac9b 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,7 @@ The old RedmineUP plugin stack is effectively local legacy code now: Tracked local plugin source lives under: -- [plugins](/home/iadnah/redmine/plugins) +- [plugins](plugins) The full `redmine-copy/` tree is an ignored working/reference copy of the legacy install. Make local plugin changes in `plugins/` first, then deploy or copy them @@ -45,7 +45,7 @@ into the test Redmine instance or `redmine-copy/` as needed. The Redmine API/MCP wrapper project now lives in: -- [redMCP](/home/iadnah/redmine/redMCP) +- [redMCP](redMCP) That subproject contains the PHP wrapper that composes normal Redmine issue API responses with local Helpdesk metadata. Its dependencies are managed by Composer; @@ -109,7 +109,7 @@ The old RedmineUP contacts plugin already exposes useful JSON routes such as: That led to the first standalone helper: -- [redmine_contacts.py](/home/iadnah/redmine/redmine_contacts.py:1) +- [redmine_contacts.py](redmine_contacts.py) It currently supports: @@ -122,14 +122,14 @@ It currently supports: A small plugin was created at: -- [redmine-copy/plugins/redmine_event_outbox](/home/iadnah/redmine/redmine-copy/plugins/redmine_event_outbox) +- [redmine-copy/plugins/redmine_event_outbox](redmine-copy/plugins/redmine_event_outbox) It records local database events into `event_outbox_events`. Known-good archive: -- [dist/redmine_event_outbox-0.0.1-known-good-20260421T143957Z.tar.gz](/home/iadnah/redmine/dist/redmine_event_outbox-0.0.1-known-good-20260421T143957Z.tar.gz) -- [manifest](/home/iadnah/redmine/dist/redmine_event_outbox-0.0.1-known-good-20260421T143957Z.MANIFEST.md:1) +- [dist/redmine_event_outbox-0.0.1-known-good-20260421T143957Z.tar.gz](dist/redmine_event_outbox-0.0.1-known-good-20260421T143957Z.tar.gz) +- [manifest](dist/redmine_event_outbox-0.0.1-known-good-20260421T143957Z.MANIFEST.md) Tested event types on the LAN copy: @@ -158,7 +158,7 @@ and worker-derived documents without marking rows processed. We made targeted changes to the local fork of `redmine_contacts_helpdesk`: - added a read-only JSON controller: - - [helpdesk_search_controller.rb](/home/iadnah/redmine/redmine-copy/plugins/redmine_contacts_helpdesk/app/controllers/helpdesk_search_controller.rb:1) + - [helpdesk_search_controller.rb](redmine-copy/plugins/redmine_contacts_helpdesk/app/controllers/helpdesk_search_controller.rb) - added routes for: - ticket by issue - issues by contact @@ -174,24 +174,24 @@ successfully. Before touching the RedmineUP plugin forks, rollback archives were created: -- [redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.tar.gz](/home/iadnah/redmine/dist/redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.tar.gz) -- [redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.tar.gz](/home/iadnah/redmine/dist/redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.tar.gz) +- [redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.tar.gz](dist/redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.tar.gz) +- [redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.tar.gz](dist/redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.tar.gz) Manifests: -- [contacts manifest](/home/iadnah/redmine/dist/redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.MANIFEST.md:1) -- [helpdesk manifest](/home/iadnah/redmine/dist/redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.MANIFEST.md:1) +- [contacts manifest](dist/redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.MANIFEST.md) +- [helpdesk manifest](dist/redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.MANIFEST.md) Change tracking docs: -- [docs/redmineup_local_fork_changelog.md](/home/iadnah/redmine/docs/redmineup_local_fork_changelog.md:1) -- [redmine-copy/plugins/redmine_contacts_helpdesk/LOCAL_CHANGELOG.md](/home/iadnah/redmine/redmine-copy/plugins/redmine_contacts_helpdesk/LOCAL_CHANGELOG.md:1) +- [docs/redmineup_local_fork_changelog.md](docs/redmineup_local_fork_changelog.md) +- [redmine-copy/plugins/redmine_contacts_helpdesk/LOCAL_CHANGELOG.md](redmine-copy/plugins/redmine_contacts_helpdesk/LOCAL_CHANGELOG.md) ### 5. Read-Only Helpdesk Export/Search CLI We also built: -- [redmine_helpdesk_search.py](/home/iadnah/redmine/redmine_helpdesk_search.py:1) +- [redmine_helpdesk_search.py](redmine_helpdesk_search.py) Purpose: @@ -216,7 +216,7 @@ intentionally stopped short of treating CLI speed optimization as the main goal. The first external worker prototype is: -- [redmine_outbox_worker.py](/home/iadnah/redmine/redmine_outbox_worker.py:1) +- [redmine_outbox_worker.py](redmine_outbox_worker.py) It runs outside Redmine and consumes `event_outbox_events` over SSH/MySQL. The initial output target is deterministic local JSONL rather than a live search @@ -237,7 +237,7 @@ Current behavior: The worker processing policy is documented in: -- [docs/outbox_worker_policy.md](/home/iadnah/redmine/docs/outbox_worker_policy.md:1) +- [docs/outbox_worker_policy.md](docs/outbox_worker_policy.md) ### 7. Test Helpdesk Mail Reset @@ -245,11 +245,11 @@ After importing a production database into the LAN test instance, reset all active projects to use the local Mailpit test mailbox for Helpdesk settings with: -- [reset_helpdesk_mail_settings.py](/home/iadnah/redmine/reset_helpdesk_mail_settings.py:1) +- [reset_helpdesk_mail_settings.py](reset_helpdesk_mail_settings.py) The complete post-import workflow is documented in: -- [docs/test_instance_post_import.md](/home/iadnah/redmine/docs/test_instance_post_import.md:1) +- [docs/test_instance_post_import.md](docs/test_instance_post_import.md) Use the read-only validator to check the test instance without changing it: @@ -265,7 +265,7 @@ Run the Helpdesk/redMCP live smoke test after the post-import checks pass: That test is documented in: -- [docs/helpdesk_smoke_test.md](/home/iadnah/redmine/docs/helpdesk_smoke_test.md:1) +- [docs/helpdesk_smoke_test.md](docs/helpdesk_smoke_test.md) Run the Helpdesk outbox worker validation when changing outbox hooks, worker enrichment, or Helpdesk/redMCP behavior: @@ -276,7 +276,7 @@ enrichment, or Helpdesk/redMCP behavior: That test is documented in: -- [docs/helpdesk_outbox_worker_validation.md](/home/iadnah/redmine/docs/helpdesk_outbox_worker_validation.md:1) +- [docs/helpdesk_outbox_worker_validation.md](docs/helpdesk_outbox_worker_validation.md) Preview the affected projects and settings: @@ -382,7 +382,7 @@ We discovered old plugin issues while working: These are logged in: -- [docs/pre_existing_issues.md](/home/iadnah/redmine/docs/pre_existing_issues.md:1) +- [docs/pre_existing_issues.md](docs/pre_existing_issues.md) They are important context but are not the primary search deliverable. @@ -390,21 +390,21 @@ They are important context but are not the primary search deliverable. Project docs: -- [docs/event_outbox_spec.md](/home/iadnah/redmine/docs/event_outbox_spec.md:1) -- [docs/redmineup_local_fork_changelog.md](/home/iadnah/redmine/docs/redmineup_local_fork_changelog.md:1) -- [docs/helpdesk_smoke_test.md](/home/iadnah/redmine/docs/helpdesk_smoke_test.md:1) -- [docs/test_instance_post_import.md](/home/iadnah/redmine/docs/test_instance_post_import.md:1) -- [docs/pre_existing_issues.md](/home/iadnah/redmine/docs/pre_existing_issues.md:1) +- [docs/event_outbox_spec.md](docs/event_outbox_spec.md) +- [docs/redmineup_local_fork_changelog.md](docs/redmineup_local_fork_changelog.md) +- [docs/helpdesk_smoke_test.md](docs/helpdesk_smoke_test.md) +- [docs/test_instance_post_import.md](docs/test_instance_post_import.md) +- [docs/pre_existing_issues.md](docs/pre_existing_issues.md) Tooling: -- [redmine_contacts.py](/home/iadnah/redmine/redmine_contacts.py:1) -- [redmine_helpdesk_search.py](/home/iadnah/redmine/redmine_helpdesk_search.py:1) +- [redmine_contacts.py](redmine_contacts.py) +- [redmine_helpdesk_search.py](redmine_helpdesk_search.py) Local plugin work: -- [redmine-copy/plugins/redmine_event_outbox](/home/iadnah/redmine/redmine-copy/plugins/redmine_event_outbox) -- [redmine-copy/plugins/redmine_contacts_helpdesk/app/controllers/helpdesk_search_controller.rb](/home/iadnah/redmine/redmine-copy/plugins/redmine_contacts_helpdesk/app/controllers/helpdesk_search_controller.rb:1) +- [redmine-copy/plugins/redmine_event_outbox](redmine-copy/plugins/redmine_event_outbox) +- [redmine-copy/plugins/redmine_contacts_helpdesk/app/controllers/helpdesk_search_controller.rb](redmine-copy/plugins/redmine_contacts_helpdesk/app/controllers/helpdesk_search_controller.rb) ## Current Recommended Next Steps