integrate

/mnemonic:integrate

Integrate mnemonic memory capture and recall into another Claude Code plugin.

Arguments

• <plugin_path> - Required. Path to target plugin directory
• --analyze - Show proposed changes without applying
• --dry-run - Show detailed diff of what would change
• --remove - Remove mnemonic protocol (delete content between sentinel markers)
• --migrate - Convert old marker-less integrations to marker-wrapped format
• --verify - Verify integration integrity matches template
• --rollback - Revert the last mnemonic integration commit

Procedure

Step 1: Call Python Implementation

The integration is handled by the Python library in skills/integrate/lib/.

PLUGIN_PATH="${1:?Error: Plugin path required}"
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$(dirname $(dirname $0))}"

# Parse mode from arguments
MODE="integrate"
DRY_RUN=""
for arg in "$@"; do
    case "$arg" in
        --analyze|--dry-run) DRY_RUN="--dry-run" ;;
        --remove) MODE="remove" ;;
        --migrate) MODE="migrate" ;;
        --verify) MODE="verify" ;;
        --rollback) MODE="rollback" ;;
    esac
done

# Validate plugin path
if [ ! -f "${PLUGIN_PATH}/.claude-plugin/plugin.json" ]; then
    echo "Error: Not a valid plugin directory (missing .claude-plugin/plugin.json)"
    exit 1
fi

# Handle rollback separately
if [ "$MODE" = "rollback" ]; then
    cd "${PLUGIN_PATH}"
    if [ ! -d .git ]; then
        echo "Error: No git repository for rollback"
        exit 1
    fi

    # Find the mnemonic integration commit (not just any commit)
    COMMIT=$(git log --oneline --grep="feat(mnemonic)" --grep="chore(mnemonic)" -1 | cut -d' ' -f1)

    if [ -z "$COMMIT" ]; then
        echo "Error: No mnemonic integration commit found"
        echo "Looking for commits with 'feat(mnemonic)' or 'chore(mnemonic)' in message"
        exit 1
    fi

    echo "Found mnemonic integration commit: $COMMIT"
    git show --stat "$COMMIT"
    echo ""
    echo "Reverting this commit..."
    git revert "$COMMIT" --no-edit
    echo "Rollback complete: $(git log -1 --oneline)"
    exit 0
fi

# Run Python integrator
python3 "$PLUGIN_DIR/skills/integrate/lib/integrator.py" \
    "${PLUGIN_PATH}" \
    --mode "$MODE" \
    $DRY_RUN \
    --git-commit