update adding claude.md

Author: detain

.claude/hooks/caliber-check-sync.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+if grep -q "caliber" .git/hooks/pre-commit 2>/dev/null; then
+  exit 0
+fi
+FLAG="/tmp/caliber-nudge-$(echo "$PWD" | shasum | cut -c1-8)"
+find /tmp -maxdepth 1 -name "caliber-nudge-*" -mmin +120 -delete 2>/dev/null
+if [ -f "$FLAG" ]; then
+  exit 0
+fi
+touch "$FLAG"
+printf '{"decision":"block","reason":"Caliber agent config sync is not set up on this machine. Tell the user: This project uses Caliber to keep agent configs in sync — it is not set up yet. Want me to run /setup-caliber? (~30 seconds)"}'

.claude/settings.json

@@ -0,0 +1,79 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/caliber-check-sync.sh",
+            "description": "Caliber: offer setup if not configured"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "caliber learn observe",
+            "description": "Caliber: recording tool usage for session learning"
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "caliber learn observe --failure",
+            "description": "Caliber: recording tool failure for session learning"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "caliber learn observe --prompt",
+            "description": "Caliber: recording user prompt for correction detection"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "caliber learn finalize --auto",
+            "description": "Caliber: finalizing session learnings"
+          }
+        ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "caliber refresh --quiet",
+            "description": "Caliber: auto-refreshing docs based on code changes"
+          }
+        ]
+      }
+    ]
+  },
+  "permissions": {
+    "allow": [
+      "Bash(git *)"
+    ]
+  }
+}

.claude/skills/find-skills/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: find-skills
+description: Discovers and installs community skills from the public registry. Use when the user mentions a technology, framework, or task that could benefit from specialized skills not yet installed, asks 'how do I do X', 'find a skill for X', or starts work in a new technology area. Proactively suggest when the user's task involves tools or frameworks without existing skills.
+---
+
+# Find Skills
+
+Search the public skill registry for community-contributed skills
+relevant to the user's current task and install them into this project.
+
+## Instructions
+
+1. Identify the key technologies, frameworks, or task types from the
+   user's request that might have community skills available
+2. Ask the user: "Would you like me to search for community skills
+   for [identified technologies]?"
+3. If the user agrees, run:
+   ```bash
+   caliber skills --query "<relevant terms>"
+   ```
+   This outputs the top 5 matching skills with scores and descriptions.
+4. Present the results to the user and ask which ones to install
+5. Install the selected skills:
+   ```bash
+   caliber skills --install <slug1>,<slug2>
+   ```
+6. Read the installed SKILL.md files to load them into your current
+   context so you can use them immediately in this session
+7. Summarize what was installed and continue with the user's task
+
+## Examples
+
+User: "let's build a web app using React"
+-> "I notice you want to work with React. Would you like me to search
+   for community skills that could help with React development?"
+-> If yes: run `caliber skills --query "react frontend"`
+-> Show the user the results, ask which to install
+-> Run `caliber skills --install <selected-slugs>`
+-> Read the installed files and continue
+
+User: "help me set up Docker for this project"
+-> "Would you like me to search for Docker-related skills?"
+-> If yes: run `caliber skills --query "docker deployment"`
+
+User: "I need to write tests for this Python ML pipeline"
+-> "Would you like me to find skills for Python ML testing?"
+-> If yes: run `caliber skills --query "python machine-learning testing"`
+
+## When NOT to trigger
+
+- The user is working within an already well-configured area
+- You already suggested skills for this technology in this session
+- The user is in the middle of urgent debugging or time-sensitive work
+- The technology is too generic (e.g. just "code" or "programming")

.claude/skills/license-cli-script/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: license-cli-script
+description: Creates a new CLI script in bin/ for Softaculous/Webuzo/Virtualizor/SiteMush license operations. Use when user says 'add CLI script', 'new bin command', 'create license tool', or 'add a script to bin/'. Do NOT use for src/ classes, test files, or Plugin hooks.
+---
+# License CLI Script
+
+## Critical
+
+- All CLI scripts go in `bin/` — never in `src/` or `tests/`.
+- Every script MUST start with `#!/usr/bin/env php` shebang line.
+- Require the parent MyAdmin bootstrap: `require_once __DIR__.'/../../../../include/functions.inc.php';`
+- Use credential constants `SOFTACULOUS_USERNAME` / `SOFTACULOUS_PASSWORD` (or `WEBUZO_USERNAME` / `WEBUZO_PASSWORD` for Webuzo-specific scripts). Never hardcode credentials.
+- CLI arguments come from `$_SERVER['argv']`, not `$argc`/`$argv`.
+- Never add argument parsing libraries or option parsers — keep scripts minimal.
+
+## Instructions
+
+1. **Determine the API method to call.** Check `src/SoftaculousNOC.php` for available methods. Common ones:
+   - `licenses($key, $ip)` — list/search licenses
+   - `cancel($key, $ip)` — cancel a license
+   - `refund($actid)` — refund a license
+   - `licenselogs($key)` — get license logs
+   - `invoicedetails($invoid)` — get invoice details
+   - `editips($lid, $ips)` — change license IP
+   - `autorenewals()` / `addautorenewal($key)` / `removeautorenewal($key)`
+   - Prefixed variants: `webuzo_*`, `virt_*`, `sitemush_*`
+   
+   Verify the method exists and note its parameters before proceeding.
+
+2. **Create the script file.** Name it `bin/<name>.php` using snake_case. Match the naming pattern of existing scripts:
+   - `bin/cancel_by_ip.php`, `bin/cancel_by_key.php`, `bin/license_by_ip.php`
+   - `bin/license_logs.php`, `bin/license_refund.php`, `bin/invoice_details.php`
+   - `bin/licenses.php`, `bin/update_data.php`
+   
+   Verify the filename does not already exist in `bin/`.
+
+3. **Write the script** following this exact template:
+
+```php
+#!/usr/bin/env php
+<?php
+
+require_once __DIR__.'/../../../../include/functions.inc.php';
+
+$noc = new \Detain\MyAdminSoftaculous\SoftaculousNOC(SOFTACULOUS_USERNAME, SOFTACULOUS_PASSWORD);
+
+print_r($noc->methodName($_SERVER['argv'][1]));
+print_r($noc->response);
+
+//$GLOBALS['tf']->session->destroy();
+```
+
+   Key rules:
+   - Use fully-qualified class name `\Detain\MyAdminSoftaculous\SoftaculousNOC` (no `use` statement).
+   - If the method returns the result directly (like `licenses()`), just `print_r()` the return value — skip `print_r($noc->response)`. See `bin/licenses.php` for this pattern.
+   - If the method requires side-effect inspection, print both the return value AND `$noc->response` (see `bin/cancel_by_key.php`, `bin/license_refund.php`).
+   - CLI arguments map positionally: `$_SERVER['argv'][1]` is the first arg, `$_SERVER['argv'][2]` is the second, etc.
+   - Keep the commented-out `$GLOBALS['tf']->session->destroy();` line at the bottom — this is the project convention.
+
+4. **Verify the script.** Run `php -l bin/<name>.php` to check for syntax errors.
+
+## Examples
+
+### User says: "Add a CLI script to check auto-renewals for a license key"
+
+**Actions:**
+1. Confirm `autorenewals($key)` exists in `src/SoftaculousNOC.php`.
+2. Create a new file in `bin/` (e.g., `bin/auto_renewals.php`):
+
+```php
+#!/usr/bin/env php
+<?php
+
+require_once __DIR__.'/../../../../include/functions.inc.php';
+
+$noc = new \Detain\MyAdminSoftaculous\SoftaculousNOC(SOFTACULOUS_USERNAME, SOFTACULOUS_PASSWORD);
+
+print_r($noc->autorenewals($_SERVER['argv'][1]));
+print_r($noc->response);
+
+//$GLOBALS['tf']->session->destroy();
+```
+
+3. Run `php -l` on the new file — no errors.
+
+**Result:** New script in `bin/` — usage: `php bin/auto_renewals.php <license_key>`
+
+### User says: "Create a script to edit IPs on a Virtualizor license"
+
+**Actions:**
+1. Confirm `virt_editips($lid, $ips)` exists in `src/SoftaculousNOC.php`.
+2. Create a new file in `bin/` (e.g., `bin/virt_edit_ips.php`):
+
+```php
+#!/usr/bin/env php
+<?php
+
+require_once __DIR__.'/../../../../include/functions.inc.php';
+
+$noc = new \Detain\MyAdminSoftaculous\SoftaculousNOC(SOFTACULOUS_USERNAME, SOFTACULOUS_PASSWORD);
+
+print_r($noc->virt_editips($_SERVER['argv'][1], $_SERVER['argv'][2]));
+print_r($noc->response);
+
+//$GLOBALS['tf']->session->destroy();
+```
+
+3. Run `php -l` on the new file — no errors.
+
+**Result:** New script in `bin/` — usage: `php bin/virt_edit_ips.php <license_id> <new_ip>`
+
+## Common Issues
+
+- **`PHP Fatal error: Uncaught Error: Undefined constant "SOFTACULOUS_USERNAME"`**: The `functions.inc.php` path is wrong. The `bin/` scripts use `__DIR__.'/../../../../include/functions.inc.php'` because the package is installed at `vendor/detain/myadmin-softaculous-licensing/`. Count the directory levels: `bin/` → package root → `detain/` → `vendor/` → project root → `include/`. Verify with `ls $(dirname bin/new_script.php)/../../../../include/functions.inc.php`.
+
+- **`Undefined offset: 1` when running the script**: The user forgot to pass a CLI argument. The existing scripts do not validate arguments — this is intentional to keep them minimal. Do not add argument validation unless the user specifically asks for it.
+
+- **Script runs but prints empty output**: Check `$noc->response` — the API may have returned an error. Also verify the credential constants are defined and non-empty in the MyAdmin configuration.
+
+- **Using Webuzo credentials for Webuzo methods**: If calling `webuzo_*` methods, use `WEBUZO_USERNAME` and `WEBUZO_PASSWORD` instead of the Softaculous constants. Check `tests/.env.example` for the full list of expected credential constants.