productionos-update

productionos-update

Update ProductionOS plugin to the latest version from GitHub

Inputs

Parameter	Values	Default	Description
target	path or context	cwd	What to operate on

ProductionOS Self-Update

You are the update mechanism for the ProductionOS plugin.

Step 0: Preamble

Before executing, run the shared ProductionOS preamble (templates/PREAMBLE.md):

1. Environment check — version, agent count, stack detection
2. Prior work check — read .productionos/ for existing output
3. Success criteria — successful update to latest version

Update Protocol

Step 1: Detect Current Installation

# Find where ProductionOS is installed
INSTALL_DIR=""
CODEX_PLUGIN_DIR=""

# Check marketplace installation
if [ -d "$HOME/.claude/plugins/marketplaces/productionos" ]; then
  INSTALL_DIR="$HOME/.claude/plugins/marketplaces/productionos"
fi

# Check Codex plugin installation
if [ -d "$HOME/.codex/plugins/productionos" ]; then
  CODEX_PLUGIN_DIR="$HOME/.codex/plugins/productionos"
fi

# Check local repo
if [ -d "$HOME/ProductionOS" ]; then
  REPO_DIR="$HOME/ProductionOS"
fi

Read the current version from:

1. $INSTALL_DIR/.claude-plugin/plugin.json → .version field
2. $REPO_DIR/VERSION if exists
3. Report current version to user

Step 2: Check for Updates

# Fetch latest from GitHub without merging
cd "$REPO_DIR" 2>/dev/null || cd "$INSTALL_DIR"
git fetch origin main 2>/dev/null

# Compare versions
LOCAL_VERSION=$(cat VERSION 2>/dev/null || jq -r .version .claude-plugin/plugin.json)
REMOTE_LOG=$(git log origin/main --oneline -10 2>/dev/null)

If no git repo found, inform user:

ProductionOS is not installed from git.
To install the updatable version:
  git clone https://github.com/ShaheerKhawaja/ProductionOS.git ~/ProductionOS
  claude plugin install productionos

Step 3: Show Changelog

Show the user what changed:

git log HEAD..origin/main --oneline --no-merges 2>/dev/null

If there are changes, show:

ProductionOS Update Available
───────────────────────────────
Current: vX.Y.Z
Latest:  vA.B.C

Changes:
  - commit message 1
  - commit message 2
  ...

Update now? (This will pull latest changes)

Step 4: Apply Update

If user confirms (or running in auto mode):

cd "$REPO_DIR"
git pull origin main

Step 5: Sync Installations

After pulling, sync to all installation locations:

# Sync to marketplace plugin directory
if [ -d "$HOME/.claude/plugins/marketplaces/productionos" ]; then
  rsync -av --update \
    --exclude='.git' \
    "$REPO_DIR/" "$HOME/.claude/plugins/marketplaces/productionos/"
  echo "Synced to marketplace installation"
fi

# Sync Codex plugin installation
if [ -d "$HOME/.codex/plugins/productionos" ]; then
  rsync -av --update \
    --exclude='.git' \
    "$REPO_DIR/" "$HOME/.codex/plugins/productionos/"
  echo "Synced Codex plugin installation"
fi

# Sync command files
if [ -d "$HOME/.claude/commands" ]; then
  for cmd in "$REPO_DIR/.claude/commands/"*.md; do
    cp "$cmd" "$HOME/.claude/commands/$(basename $cmd)"
  done
  echo "Synced commands"
fi

Step 6: Verify

NEW_VERSION=$(cat "$REPO_DIR/VERSION" 2>/dev/null || jq -r .version "$REPO_DIR/.claude-plugin/plugin.json")
echo "Updated to v${NEW_VERSION}"

Report:

ProductionOS Updated Successfully
────────────────────────────────────
Previous: vX.Y.Z
Current:  vA.B.C
Files synced: marketplace, Codex plugin, commands

Rollback

If update breaks something:

cd ~/ProductionOS
git log --oneline -5  # Find the commit to roll back to
git reset --hard <commit>  # Roll back
# Then re-run sync steps

Error Handling

Scenario	Action
No target provided	Ask for clarification with examples
Target not found	Search for alternatives, suggest closest match
Missing dependencies	Report what is needed and how to install
Permission denied	Check file permissions, suggest fix
State file corrupted	Reset to defaults, report what was lost

Guardrails

1. Do not silently change scope or expand beyond the user request.
2. Prefer concrete outputs and verification over abstract descriptions.
3. Keep scope faithful to the user intent.
4. Preserve existing workflow guardrails and stop conditions.
5. Verify results before concluding.