Status and Monitoring

/**
 * Shows status of packages and changesets with detailed release planning
 * @param cwd - Working directory path
 * @param options.sinceMaster - Check changes since master branch (deprecated)
 * @param options.since - Custom branch or tag to compare against
 * @param options.verbose - Include detailed output with new versions and changeset links
 * @param options.output - JSON output file path for machine-readable results
 * @param config - Changesets configuration object
 * @returns Promise resolving to ReleasePlan object or void
 */
function status(
  cwd: string, 
  options: {
    sinceMaster?: boolean, 
    since?: string, 
    verbose?: boolean, 
    output?: string
  }, 
  config: Config
): Promise<ReleasePlan | void>;

import { run } from "@changesets/cli";

// Basic status check
await run(["status"], {}, cwd);

// Verbose status with detailed information
await run(["status"], { verbose: true }, cwd);

// Status since specific branch
await run(["status"], { since: "main" }, cwd);

// Export status to JSON file
await run(["status"], { 
  output: "./release-plan.json",
  verbose: true 
}, cwd);

interface ReleasePlan {
  changesets: Changeset[];
  releases: Release[];
  preState: PreState | undefined;
}

interface Release {
  name: string;
  type: "major" | "minor" | "patch" | "none";
  oldVersion: string;
  newVersion: string;
  changelog: string | null;
}

interface Changeset {
  id: string;
  summary: string;
  releases: Array<{name: string, type: "major" | "minor" | "patch"}>;
}

🦋  info The following packages are included in this release:
🦋  info @myorg/ui: patch => 1.2.1
🦋  info @myorg/utils: minor => 2.1.0
🦋  info @myorg/core: major => 3.0.0

{
  "releases": [
    {
      "name": "@myorg/ui",
      "type": "patch", 
      "oldVersion": "1.2.0",
      "newVersion": "1.2.1",
      "changelog": "Fixed button styling issue"
    }
  ],
  "changesets": [
    {
      "id": "brave-lions-sing",
      "summary": "Fixed button styling issue",
      "releases": [{"name": "@myorg/ui", "type": "patch"}]
    }
  ]
}

# CI script example
changeset status --since=origin/main
if [ $? -eq 1 ]; then
  echo "Changes detected but no changesets found"
  exit 1
fi

// Parse JSON output in CI scripts
const releasePlan = JSON.parse(fs.readFileSync('release-plan.json', 'utf8'));

// Check if specific packages are being released
const isUiPackageReleased = releasePlan.releases.some(
  release => release.name === '@myorg/ui' && release.type !== 'none'
);

// Conditional deployment based on release plan
if (isUiPackageReleased) {
  // Run UI-specific deployment steps
}

// Compare against specific branch
await status(cwd, { since: "origin/main" }, config);

// Compare against specific tag  
await status(cwd, { since: "v1.0.0" }, config);

// Compare against commit hash
await status(cwd, { since: "abc123" }, config);

/**
 * Gets packages that have changes and are eligible for versioning
 * @param config - Changesets configuration
 * @param options.cwd - Working directory path
 * @param options.ref - Git reference to compare against
 * @returns Promise resolving to array of changed packages
 */
function getVersionableChangedPackages(
  config: Config, 
  options: {cwd: string, ref?: string}
): Promise<Package[]>;

// Health checks performed during status analysis:
// - .changeset directory exists and is properly configured
// - All changesets reference valid packages
// - No conflicting version requirements
// - Dependency graph is resolvable

// Validates:
// - ignore patterns match actual packages
// - linked/fixed package groups are valid
// - changelog and commit configuration is loadable
// - private package settings are consistent

// Enhanced output includes:
// - New version numbers for each package
// - Links to changeset files
// - Dependency update cascade effects
// - Private package handling details
// - Prerelease state information

🦋  Changeset: brave-lions-sing
🦋  Summary: Fixed button styling issue and improved accessibility
🦋  Releases:
🦋    @myorg/ui: patch
🦋    @myorg/theme: patch (dependency)

interface PreState {
  mode: "pre";
  tag: string;
  initialVersions: Record<string, string>;
  changesets: string[];
}

// Status output indicates prerelease state
// Shows prerelease tag and planned prerelease versions

🦋  info In prerelease mode (tag: beta)
🦋  info @myorg/ui: 1.2.0 => 1.2.1-beta.0  
🦋  info @myorg/utils: 2.0.0 => 2.1.0-beta.0

// Configuration-based filtering
{
  "ignore": ["@myorg/docs", "@myorg/examples"]
}

// Private package handling
{
  "privatePackages": {
    "version": false  // Exclude private packages from status
  }
}

# Only show status for changes since main branch
changeset status --since=origin/main

# Show status for changes since last release tag
changeset status --since=$(git describe --tags --abbrev=0)

name: Changeset Status
on: pull_request

jobs:
  status:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0
      - run: changeset status --output=status.json
      - uses: actions/upload-artifact@v3
        with:
          name: release-plan
          path: status.json

// Custom release dashboard
const statusData = JSON.parse(fs.readFileSync('status.json'));

// Generate release notifications
const releaseNotification = {
  packages: statusData.releases.filter(r => r.type !== 'none'),
  changesetCount: statusData.changesets.length,
  breaking: statusData.releases.some(r => r.type === 'major')
};

// Continues analysis even if some changesets are invalid
// Reports validation issues while showing available information
// Provides suggestions for resolving configuration problems