agent-changemgmt

CLI tool for FlowPaaS Change Management platform.

Covers all 5 platform modules — Change Management (tickets + SOPs), Change Governance, Service Dependency, Action Flows (Kafka/Redis infra), and Incidents — plus Announcements, Change Freezes, AIOps Events, and Alert Heatmaps.

Install

# Global install from tarball
npm install -g agent-changemgmt-1.0.0.tgz

# Or link directly
chmod +x src/index.js
ln -sf "$(pwd)/src/index.js" ~/.claude/bin/agent-changemgmt

Authentication

Personal token (recommended):

1. Create a personal token at: https://cicd.toolsfdg.net/flowpaas/personal-token
2. Run:

agent-changemgmt auth --personal-token fp_xxxxxxxxxxxx

Once saved, the CLI automatically refreshes the JWT when it expires — no manual re-auth needed.

Direct JWT injection:

agent-changemgmt auth --token "JWT_TOKEN"

Check current user:

agent-changemgmt whoami

Usage

agent-changemgmt <command> <subcommand> [options]
agent-changemgmt help

Command Groups

| Command | Description | |---------|-------------| | ticket | Create, search, approve, reject, manage change tickets | | sop | Create, review, approve SOP templates | | governance | Investigate governance records, overrides, analysis | | dependency | Service dependency analysis, CMDB, lineage, P0 reviews | | incident | Search incidents, view postmortems | | actionflow | Kafka/Redis infra change requests (SG add, scaling) | | announcement | Send announcements to WEA groups | | freeze | Manage change freeze windows | | aiops | AIOps events, alert heatmaps, AI analysis logs |

Examples

# Search recent change tickets
agent-changemgmt ticket search --days 7

# Investigate what apps depend on a Kafka cluster
agent-changemgmt dependency search --infra bin-prod-kyc --type kafka

# Review a P0 API's dependencies
agent-changemgmt dependency review-collect --url "/bapi/accounts/v1/..." --json --save /tmp/deps.json
agent-changemgmt dependency review-analyze --data-file /tmp/deps.json
agent-changemgmt dependency review-report --data-file /tmp/deps.json --save /tmp/report.md

# Query bigdata table ownership
agent-changemgmt dependency lineage --table my_table_name

# Check alert heatmap
agent-changemgmt aiops heatmap --group-by alert_target --hours 24

Claude Code Skill

This CLI is designed to work with Claude Code via the agent-changemgmt skill. The skill provides guided workflows for ticket creation, dependency analysis, governance investigation, and more.

Requirements

• Node.js >= 18.0.0
• Zero external dependencies