Fix issues where help does not show all command groups or some commands are missing.

The help command dynamically lists:

• command groups
• commands
• descriptions
• aliases
• public/private visibility
• add-on commands

If your help output is missing entire sections like:

USER – missing
WALLET – missing
ADDON – missing

or individual commands are gone, use this guide to diagnose and fix it.

---

🔹 1. Add-On Not Active (Commands Not Loaded) #

If a command group belongs to an add-on (e.g., Social Mining, EVM Integration):

• The add-on must be activated
• Its JS must be loaded
• Its metadata must be registered

Check:

WP Admin → Plugins

Is the add-on active?

If not, commands will be missing.

---

🔹 2. Add-On JavaScript Failed to Load #

If an add-on’s JS file fails, its commands will not register.

Open browser:

F12 → Console

Look for errors like:

my-addon.js failed to load
Uncaught SyntaxError in my-addon.js
registry.mycommand is not a function

If errors appear:

• Fix the add-on script
• Remove syntax errors
• Ensure enqueue uses cointacted-social-terminal-js as dependency

Example correct enqueue:

wp_enqueue_script(
    'cst-addon',
    plugin_dir_url(__FILE__) . 'js/addon.js',
    ['cointacted-social-terminal-js'],
    '1.0',
    true
);

Without the dependency, commands load before the terminal → and fail.

---

🔹 3. Command Metadata Missing or Incorrect #

If commands appear but do not show in help, the metadata is broken.

Correct metadata example:

CointactedSocialTerminalTerminal.commands_meta.mycommand = {
    group: "ADDON",
    description: "My custom command.",
    alias: ["mc"],
    public: true
};

Common mistakes:

❌ Missing group
❌ Missing description
❌ Setting hidden: true
❌ Wrong object name
❌ Metadata registered before the core plugin loaded

Fix:

• Ensure metadata registration runs after the registry exists
• Ensure group strings match exactly

---

🔹 4. Group Name Has Typo or Wrong Formatting #

Example:

group: "adddon"        (typo)
group: "Addon"         (wrong case)
group: "AD D ON"       (extra spaces)

Results:

• help will ignore the group
• commands appear “missing”

Groups are case-sensitive, and must be one word.

Correct:

CORE
USER
SITE
WALLET
NETWORK
CLIENT
FUN
ADMIN
ADDON (for all third-party add-ons)

---

🔹 5. Command Name Conflicts With Another Add-On #

If two add-ons register the same command name:

registry.stats = ...
registry.stats = ...

The last one wins.

The previous one disappears from help.

Fix:

• Rename one of the commands
• Use a namespaced command name: addon_stats

---

🔹 6. Command Marked as Hidden #

If metadata includes:

hidden: true

The help system intentionally hides it.

Remove or set to:

hidden: false

---

🔹 7. Command Is Private but Guest Mode Enabled #

This affects some cases:

If a command is marked:

public: false

And you are logged out, the help system will:

• hide the command
• hide the entire group if all commands inside are private

Fix:

• Log in
• Or enable guest-safe commands under General Settings

---

🔹 8. Commands Removed by Custom Overrides #

If you or another developer wrote:

delete CointactedSocialTerminalTerminal.registry.mycommand;
delete CointactedSocialTerminalTerminal.commands_meta.mycommand;

Or accidentally overwrote metadata with an empty object —
commands will disappear.

Fix:

• Remove override code
• Reload page

---

🔹 9. JS Error Stops Help From Rendering Completely #

Any terminal-wide JS error can break the help command.

Console example:

Uncaught ReferenceError: x is not defined

Fix JS errors from:

• add-ons
• custom scripts
• child themes

Once JS works again, help output works.

---

🔹 10. Core Commands Missing (Severe Error) #

If groups like:

CORE
USER
SITE
FUN

are missing → the core JS file didn’t load.

Check Network tab:

cointacted-social-terminal-terminal.js
cointacted-social-terminal-public.js

If either is missing or blocked:

• Clear caches
• Disable script minifiers
• Restore correct enqueue order
• Check CDN for blocked JS files
• Ensure no mixed-content issue (HTTP vs HTTPS)

---

🎯 Summary #

If help is missing groups or commands:

✔ Add-on may not be active #

✔ Add-on JS may have failed #

✔ Metadata may be missing or broken #

✔ Group names may have typos #

✔ Command overridden or deleted #

✔ Command marked as hidden or private #

✔ Guest mode hiding commands #

✔ JavaScript conflict blocking help #

✔ Core JS not loaded #

Once JS loads correctly and metadata is valid, the help system updates automatically.