Local CI

Local CI Execution

Overview

Local CI uses @aidevtool/ci (JSR package) to run the full pipeline.

• CI error diagnosis: /ci-troubleshooting skill
• Release flow: /release-procedure skill
• Branch strategy: /branch-management skill

Recommendation: Delegate to sub agent to save context.

Execution Methods

Sub Agent Delegation (Preferred)

Task({
  subagent_type: "Bash",
  prompt: "Run deno task ci and report results",
  description: "Run local CI"
})

Direct Execution (Watch for Sandbox)

When JSR/Deno packages need to be fetched:

Bash({
  command: "deno task ci",
  dangerouslyDisableSandbox: true,
})

CI Pipeline Stages

@aidevtool/ci runs these stages in order:

1. Type Check - deno check
2. JSR Check - JSR publish dry-run
3. Test - deno test
4. Lint - deno lint
5. Format - deno fmt --check

Execution Modes

Hierarchy Targeting

Check a specific directory only:

deno task ci src/
deno task ci --hierarchy agents/ --mode batch

Log Modes

Key Options

Release Branch Version Check

On release/* branches, verify version consistency before running deno task ci. Skip this check on other branches.

# 1. Branch name version must match deno.json version
BRANCH=$(git rev-parse --abbrev-ref HEAD)
BRANCH_VERSION=${BRANCH#release/}
DENO_VERSION=$(grep '"version"' deno.json | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/')
if [ "$BRANCH_VERSION" != "$DENO_VERSION" ]; then
  echo "ERROR: Branch version mismatch: branch=$BRANCH_VERSION, deno.json=$DENO_VERSION"
  exit 1
fi

# 2. deno.json version must match version.ts
TS_VERSION=$(grep 'export const CLIMPT_VERSION' src/version.ts | sed 's/.*= *"\([^"]*\)".*/\1/')
if [ "$DENO_VERSION" != "$TS_VERSION" ]; then
  echo "ERROR: Version mismatch: deno.json=$DENO_VERSION, version.ts=$TS_VERSION"
  exit 1
fi

This mirrors the GitHub Actions Check version consistency step in .github/workflows/test.yml.

Pre-Push Workflow

deno task ci && git push origin branch-name

Error Handling

Converted and distributed by TomeVault — claim your Tome and manage your conversions.