wpallstars/wp-fix-plugin-does-not-exist-notices

Files

T

marcus 34b0b6f0d6 fix: replace ambiguous X.Y.Z placeholder with actual version in AGENTS.md (#23 )

Gemini review (PR #14) flagged that 'X.Y.Z' in the Version Management
section is problematic for AI agents — they may interpret it literally
or fail to match it during automated edits.

Replace with the actual current version '2.4.0' plus a parenthetical
instruction '(replace 2.4.0 with the new version)' so the context is
unambiguous: agents can grep for the exact string and know what to
substitute.

Resolves #19

2026-04-23 05:29:11 +01:00

4.8 KiB

Raw Blame History

AGENTS.md — AI Agent Guide for wp-fix-plugin-does-not-exist-notices

This file provides precise, verified guidance for AI agents working in this repository. Read it before editing any file to avoid read:file_not_found and edit:not_read_first errors.

Repository Purpose

Fix 'Plugin file does not exist' Notices — a WordPress plugin that detects active plugins whose files are missing, adds them to the Plugins list with a "Remove Notice" action link, and safely removes their database references.

GitHub: wpallstars/wp-fix-plugin-does-not-exist-notices
Namespace: WPALLSTARS\FixPluginDoesNotExistNotices
Text domain: wp-fix-plugin-does-not-exist-notices
Current version: see wp-fix-plugin-does-not-exist-notices.php header

Exact File Map (authoritative — verified against git ls-files)

CRITICAL: PHP class files in includes/ use PascalCase. The docs and require_once paths must match exactly. On Linux (case-sensitive), wrong case = fatal error.

wp-fix-plugin-does-not-exist-notices.php   # Plugin entry point — sets Version, requires includes/Plugin.php
includes/Plugin.php                         # Main Plugin class — loads dependencies, inits components
includes/Core.php                           # Core class — all WordPress hooks and plugin logic
includes/Updater.php                        # Updater class — handles Git Updater / WP.org update sources
admin/lib/admin.php                         # Admin\Admin class — admin page rendering, enqueues
admin/lib/modal.php                         # Admin\Modal class — update source selector modal
admin/css/admin-styles.css                  # General admin styles
admin/css/update-source-selector.css        # Styles for the update source modal
admin/js/admin-scripts.js                   # General admin JS
admin/js/update-source-selector.js          # JS for the update source modal
languages/wp-fix-plugin-does-not-exist-notices.pot  # Translation template
build.sh                                    # Build/release script
scripts/deploy-local.sh                     # Local deployment helper
composer.json                               # Composer config (no vendor/ committed)
README.md                                   # Developer readme
readme.txt                                  # WordPress.org readme (keep in sync with README.md)
CHANGELOG.md                                # Changelog (keep in sync with README.md and readme.txt)

Directories that DO NOT exist (do not attempt to read or create files here):

admin/images/ — does not exist
admin/partials/ — does not exist
admin/settings/ — does not exist
admin/tools/ — does not exist
vendor/ — not committed; loaded at runtime if present

Before Editing Any File

Read the file first: Read includes/Core.php — not includes/core.php (wrong case fails).
Re-read the file if another tool call may have modified it since your last read.
Verify the file path with git ls-files '<pattern>' when uncertain.

Version Management

Version appears in four places — all must be updated together:

wp-fix-plugin-does-not-exist-notices.php — Version: header and new Plugin(__FILE__, '2.4.0') (replace 2.4.0 with the new version)
includes/Plugin.php — no direct version constant; version passed via constructor
readme.txt — Stable tag: and changelog section
CHANGELOG.md — top entry

README.md changelog section must also stay in sync with CHANGELOG.md.

Common Tasks

Fix a bug in core plugin logic

Edit includes/Core.php. All WordPress hooks are registered in the constructor.

Change admin UI or settings

Edit admin/lib/admin.php (Admin class) and/or admin/lib/modal.php (Modal class). CSS: admin/css/admin-styles.css or admin/css/update-source-selector.css. JS: admin/js/admin-scripts.js or admin/js/update-source-selector.js.

Bump version for a release

Update version in wp-fix-plugin-does-not-exist-notices.php (both header and constructor call).
Update Stable tag: in readme.txt.
Add changelog entry to readme.txt, CHANGELOG.md, and README.md.

Add or fix update source logic

Edit includes/Updater.php.

Git Workflow

Branch naming: feature/, fix/, patch/, refactor/ prefixes
One branch per issue; one PR per issue
Push to both github and gitea remotes
Do not include version numbers in branch names during development

AI Workflow Documentation

Extended guidance is in .ai-workflows/:

folder-structure.md — directory layout with correct filenames
git-workflow.md — branching, commit messages, remote management
feature-development.md — feature development process
bug-fixing.md — bug investigation and fix process
release-process.md — full release checklist including Git Updater notes
dev-prefs-memory.md — persistent developer preferences

4.8 KiB Raw Blame History