@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/gitflow/agents/cleanup.md

@@ -0,0 +1,50 @@
+---
+name: gitflow-cleanup
+description: Audit and clean up GitFlow repository state
+model: sonnet
+tools: Bash, Read, Glob, Write
+---
+
+# GitFlow Cleanup Agent
+
+## Steps
+
+1. **Run Cleanup Audit**
+   - Run: `ss gitflow cleanup --json`
+   - This performs a dry-run audit without making changes
+
+2. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Show audit failures:
+       - If "unmerged branches": list branches not yet merged to main/develop
+       - If "stale worktrees": list orphaned worktree directories
+       - If "dangling tags": list tags without corresponding commits
+   - If `success: true`:
+     - Show cleanup audit summary:
+       - Unmerged branches found (if any)
+       - Stale worktrees (if any)
+       - Dangling tags (if any)
+       - Orphaned commits (if any)
+
+3. **Display Cleanup Plan**
+   - Show what will be cleaned:
+     - Branches to delete
+     - Worktrees to remove
+     - Tags to clean (if dead references)
+     - Reflog entries to prune
+
+4. **Prompt for Confirmation**
+   - Ask user: "Apply cleanup changes? (y/n)"
+   - If yes: re-run with `--apply` flag
+   - If no: exit with "No changes made"
+
+5. **Post-Cleanup Verification**
+   - If cleanup applied:
+     - Show summary of deleted items
+     - Show freed disk space (if available)
+     - Verify repository consistency
+
+6. **Suggest Next Steps**
+   - Display: "Repository cleaned up successfully"
+   - Recommend: "Run `ss gitflow status` to verify state"

package/templates/skills/gitflow/agents/commit.md

@@ -0,0 +1,41 @@
+---
+name: gitflow-commit
+description: Commit changes on current GitFlow branch
+model: haiku
+tools: Bash, Read, Glob, Grep
+---
+
+# GitFlow Commit Agent
+
+## Steps
+
+1. **Prepare Commit Message**
+   - Accept user-provided message or use context variable
+   - If no message provided: use default or prompt user
+
+2. **Execute Commit**
+   - Run: `ss gitflow commit --json` with message flag if provided
+   - e.g., `ss gitflow commit --message "Fix login bug" --json`
+
+3. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Suggest fixes:
+       - If "no changes": run `git status` to verify changes exist
+       - If "conflicts": suggest `ss gitflow sync` to resolve
+   - If `success: true`:
+     - Show commit summary:
+       - Commit hash (short form)
+       - Message
+       - Files changed count
+       - Insertions/deletions
+
+4. **Check for Destructive Warnings**
+   - If `efcore.destructive: true` in response:
+     - **WARN**: Display prominent message:
+       - "⚠️ Entity Framework destructive changes detected"
+       - "Review migrations before merging"
+       - Suggest: `ss gitflow merge` with review step
+
+5. **Suggest Next Steps**
+   - Display: "Next: run `ss gitflow pr` to open pull request"

package/templates/skills/gitflow/agents/finish.md

@@ -0,0 +1,47 @@
+---
+name: gitflow-finish
+description: Finish and clean up GitFlow branch
+model: sonnet
+tools: Bash, Read, Glob, Write
+---
+
+# GitFlow Finish Agent
+
+## Steps
+
+1. **Execute Finish Operation**
+   - Run: `ss gitflow finish --json`
+   - Optionally pass version tag if specified: `ss gitflow finish --tag <version> --json`
+
+2. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Show failure reason:
+       - If "branch not merged": suggest `ss gitflow merge` first
+       - If "uncommitted changes": suggest `ss gitflow commit` or stash changes
+       - If "tag already exists": show existing tag and suggest new version
+   - If `success: true`:
+     - Show finish summary:
+       - Tag created (if applicable)
+       - Version bumped (if applicable)
+       - Target branch returned to
+       - Feature/release/hotfix branch deleted locally and remotely
+       - Changelog entry (if available)
+
+3. **Display Cleanup Status**
+   - Show branches deleted:
+     - Local branch removed
+     - Remote branch removed
+     - Worktree destroyed (if applicable)
+   - Show tags created/updated
+
+4. **Verify Version Bump**
+   - If version was bumped:
+     - Show old → new version
+     - Suggest commit message for version bump
+     - Verify package.json or version file updated
+
+5. **Suggest Next Steps**
+   - Display: "GitFlow cycle complete"
+   - Suggest: "Run `ss gitflow status` to verify cleanup"
+   - Recommend: "Next feature: `ss gitflow start -f <name>`"

package/templates/skills/gitflow/agents/init.md

@@ -0,0 +1,41 @@
+---
+name: gitflow-init
+description: Initialize GitFlow repository with detection and optional user input
+model: sonnet
+tools: Bash, Read, Write, Glob, AskUserQuestion
+---
+
+# GitFlow Init Agent
+
+## Steps
+
+1. **Detect Repository Values**
+   - Run: `ss gitflow init --json`
+   - Parse response to extract `detectedUrl`, `detectedRootFolder`, `detectedName`, `detectedMode`
+
+2. **Handle User Input (if needed)**
+   - If `needsInput: true` in response:
+     - Ask user for:
+       - Repository URL (or accept detected value)
+       - Root folder path (or accept detected value)
+       - Repository name (or accept detected value)
+       - GitFlow mode (feature/release/hotfix)
+     - Collect answers via AskUserQuestion tool
+
+3. **Initialize with Values**
+   - Run: `ss gitflow init <url> --root <path> --name <name> --mode <mode> --yes --json`
+   - Replace placeholders with detected or user-provided values
+
+4. **Parse Result**
+   - If `success: false`:
+     - Display error message from `error` field
+     - Suggest fix (e.g., "Check URL is accessible" or "Verify folder permissions")
+   - If `success: true`:
+     - Show initialization summary:
+       - Repository URL
+       - Root folder
+       - GitFlow mode configured
+       - Initial branch set
+
+5. **Suggest Next Steps**
+   - Display: "Next: run `ss gitflow start -f <feature-name>` to create a feature branch"

package/templates/skills/gitflow/agents/merge.md

@@ -0,0 +1,44 @@
+---
+name: gitflow-merge
+description: Merge GitFlow branch back to main branch
+model: sonnet
+tools: Bash, Read, Glob, Grep, Edit
+---
+
+# GitFlow Merge Agent
+
+## Steps
+
+1. **Verify PR Status**
+   - Check if PR is approved and ready to merge
+   - Run: `ss gitflow merge --json` (with optional --force-merge flag)
+
+2. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Show blocking issues:
+       - If "not approved": suggest waiting for review or requesting approval
+       - If "checks failed": show failed CI/CD checks, suggest fixes
+       - If "conflicts": suggest `ss gitflow sync` then manual resolution
+       - If "branch not found": verify branch still exists
+   - If `success: true`:
+     - Show merge summary:
+       - Merge commit hash
+       - Commits included in merge
+       - Files modified in this branch
+       - Merge strategy used (fast-forward, squash, merge commit)
+
+3. **Check Code Review State**
+   - If available in response:
+     - Show review comments count
+     - Show reviewer approvals
+     - Alert on unresolved discussions
+
+4. **Post-Merge Verification**
+   - If merge successful:
+     - Show updated branch state
+     - Verify target branch updated
+     - List any cleanup needed
+
+5. **Suggest Next Steps**
+   - Display: "Merge complete. Run `ss gitflow finish` to finalize release"

package/templates/skills/gitflow/agents/pr.md

@@ -0,0 +1,39 @@
+---
+name: gitflow-pr
+description: Create or open pull request for GitFlow branch
+model: haiku
+tools: Bash, Glob
+---
+
+# GitFlow PR Agent
+
+## Steps
+
+1. **Create Pull Request**
+   - Run: `ss gitflow pr --json`
+
+2. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Suggest fixes:
+       - If "no commits": ensure changes are committed with `ss gitflow commit`
+       - If "remote not found": verify origin is set
+       - If "PR exists": show existing PR number and URL
+   - If `success: true`:
+     - Show PR summary:
+       - PR number
+       - PR URL (clickable if supported)
+       - Title (auto-generated or provided)
+       - Description
+       - Target branch (develop/main)
+       - Source branch name
+
+3. **Display PR Metadata**
+   - Labels (if auto-assigned)
+   - Reviewers (if auto-assigned)
+   - CI/CD status (if available from response)
+
+4. **Suggest Next Steps**
+   - Display: "PR created successfully"
+   - Suggest: "Wait for review, then run `ss gitflow merge` to merge"
+   - Show: Direct link to PR for review

package/templates/skills/gitflow/agents/start.md

@@ -0,0 +1,42 @@
+---
+name: gitflow-start
+description: Start a new feature, release, or hotfix branch
+model: sonnet
+tools: Bash, Read, Glob, Write
+---
+
+# GitFlow Start Agent
+
+## Steps
+
+1. **Determine Branch Type**
+   - Extract from context or flags:
+     - `-f, --feature <name>` → feature branch
+     - `-r, --release <version>` → release branch
+     - `-h, --hotfix <version>` → hotfix branch
+   - Use first available: flag value, context variable, or prompt user
+
+2. **Start Branch Creation**
+   - Run: `ss gitflow start -f <name> --json` (or -r/-h as applicable)
+   - Include any user-provided flags
+
+3. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Suggest remediation:
+       - If "branch exists": suggest `ss gitflow status` to view existing branches
+       - If "invalid name": suggest naming convention (lowercase, hyphens, no spaces)
+   - If `success: true`:
+     - Show branch creation summary:
+       - New branch name
+       - Based on parent branch
+       - Current HEAD
+       - Worktree status if applicable
+
+4. **Validate Working Directory**
+   - Use Glob or Read to verify:
+     - No uncommitted changes (if requested)
+     - .git directory exists
+
+5. **Suggest Next Steps**
+   - Display: "Next: make your changes, then run `ss gitflow commit`"

package/templates/skills/gitflow/agents/status.md

@@ -0,0 +1,39 @@
+---
+name: gitflow-status
+description: Check current GitFlow repository status
+model: haiku
+tools: Bash, Read, Glob
+---
+
+# GitFlow Status Agent
+
+## Steps
+
+1. **Query Repository Status**
+   - Run: `ss gitflow status --json`
+
+2. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Suggest: check repository initialization with `ss gitflow init`
+   - If `success: true`:
+     - Extract and display:
+       - Current branch name
+       - Current worktree (if applicable)
+       - List of active features (from `features` array)
+       - List of active releases (from `releases` array)
+       - List of active hotfixes (from `hotfixes` array)
+       - Outstanding actions or blocking items (from `actions` array)
+
+3. **Display Branch State**
+   - Show branch status icon/badge:
+     - Active (currently checked out)
+     - Pending (created but not active)
+     - Merged (in history)
+   - Display commits ahead/behind if available
+
+4. **Action Summary**
+   - If `actions` array present:
+     - List each pending action
+     - Suggest command to resolve
+   - If clean: display "No pending actions"

package/templates/skills/gitflow/agents/sync.md

@@ -0,0 +1,38 @@
+---
+name: gitflow-sync
+description: Synchronize GitFlow branch with upstream
+model: haiku
+tools: Bash
+---
+
+# GitFlow Sync Agent
+
+## Steps
+
+1. **Sync with Upstream**
+   - Run: `ss gitflow sync --json`
+
+2. **Parse Response**
+   - If `success: false`:
+     - Display error message
+     - Show conflict details (if `conflicts` array present):
+       - List conflicted files
+       - Show conflict markers if available
+     - Suggest resolution:
+       - If merge conflicts: "Resolve conflicts manually, then re-run `ss gitflow sync`"
+       - If network error: "Check internet connection and repository access"
+   - If `success: true`:
+     - Show sync summary:
+       - Fetch result (fast-forward, merge commit, or no changes)
+       - Commits pulled from upstream
+       - Commits pushed to origin
+       - Local branch status (ahead/behind)
+
+3. **Conflict Resolution**
+   - If conflicts detected:
+     - Display conflicted files
+     - Suggest merge strategy (if applicable)
+
+4. **Suggest Next Steps**
+   - If synced successfully: "Ready to proceed with next step"
+   - Display appropriate next command based on workflow

package/templates/skills/gitflow/cli/abort/execute.ts

@@ -0,0 +1,61 @@
+/**
+ * execute.ts — Execution logic. Imports from ../lib/. NO validation.
+ * Receives validated data, returns typed result.
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import type { AbortSpec, AbortResult } from './types.js';
+import { execGit } from '../lib/git.js';
+
+export async function execute(spec: AbortSpec, workDir: string = process.cwd()): Promise<AbortResult> {
+  try {
+    // Detect which operation is in progress
+    const gitDir = join(workDir, '.git');
+    const rebaseMergeDir = join(gitDir, 'rebase-merge');
+    const rebaseApplyDir = join(gitDir, 'rebase-apply');
+    const mergeHeadFile = join(gitDir, 'MERGE_HEAD');
+    const cherryPickHeadFile = join(gitDir, 'CHERRY_PICK_HEAD');
+
+    let operation: 'rebase' | 'merge' | 'cherry-pick' | 'none' = 'none';
+    let restored = false;
+
+    if (spec.git) {
+      // Check for rebase
+      if (existsSync(rebaseMergeDir) || existsSync(rebaseApplyDir)) {
+        operation = 'rebase';
+        const result = await execGit(['rebase', '--abort'], workDir);
+        restored = result.exitCode === 0;
+      }
+      // Check for merge
+      else if (existsSync(mergeHeadFile)) {
+        operation = 'merge';
+        const result = await execGit(['merge', '--abort'], workDir);
+        restored = result.exitCode === 0;
+      }
+      // Check for cherry-pick
+      else if (existsSync(cherryPickHeadFile)) {
+        operation = 'cherry-pick';
+        const result = await execGit(['cherry-pick', '--abort'], workDir);
+        restored = result.exitCode === 0;
+      }
+    }
+
+    return {
+      success: operation === 'none' || restored,
+      operation,
+      restored,
+      message: operation === 'none'
+        ? 'No in-progress operation detected'
+        : restored
+          ? `${operation} aborted successfully`
+          : `Failed to abort ${operation}`,
+    };
+  } catch (err) {
+    return {
+      success: false,
+      operation: 'none',
+      restored: false,
+      error: (err as Error).message,
+    };
+  }
+}

package/templates/skills/gitflow/cli/abort/index.ts

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * cli:gitflow-abort
+ * Detects and aborts in-progress git operations (rebase, merge, cherry-pick).
+ *
+ * Exit codes: 0 = OK, 1 = warnings, 2 = blockers
+ *
+ * Usage:
+ *   npx ts-node index.ts --spec '<json>' [--workdir <path>] [--json]
+ */
+import { parseArgs } from 'node:util';
+import { readFileSync, existsSync } from 'node:fs';
+import { validate } from './validate.js';
+import { execute } from './execute.js';
+import type { AbortResult } from './types.js';
+
+const { values, positionals } = parseArgs({
+  options: {
+    spec: { type: 'string' },
+    workdir: { type: 'string' },
+    help: { type: 'boolean', short: 'h' },
+    json: { type: 'boolean' },
+  },
+  allowPositionals: true,
+});
+
+if (values.help) {
+  console.log(`
+cli:gitflow-abort — SmartStack Studio
+
+Detects and aborts in-progress git operations (rebase, merge, cherry-pick).
+
+Usage:
+  npx ts-node index.ts --spec '<json>' [--workdir <path>] [--json]
+
+Options:
+  --spec        JSON string or path to a JSON file with abort spec
+  --workdir     Working directory for git operations (defaults to cwd)
+  --json        Output result as JSON
+  --help, -h    Show this help
+  `);
+  process.exit(0);
+}
+
+// ── Validate args ─────────────────────────────────────────
+const specArg = values.spec;
+const workdir = values.workdir || process.cwd();
+
+if (!specArg) {
+  const result = { success: false, blockers: ['Missing required arg: --spec'], warnings: [] };
+  if (values.json) console.log(JSON.stringify(result, null, 2));
+  else console.error('[BLOCKER] Missing required arg: --spec');
+  process.exit(2);
+}
+
+// ── Parse spec (JSON string or file path) ──────────────────
+let rawSpec: unknown;
+try {
+  if (existsSync(specArg)) {
+    rawSpec = JSON.parse(readFileSync(specArg, 'utf-8'));
+  } else {
+    rawSpec = JSON.parse(specArg);
+  }
+} catch (err) {
+  const result = { success: false, blockers: [`Invalid JSON spec: ${(err as Error).message}`], warnings: [] };
+  if (values.json) console.log(JSON.stringify(result, null, 2));
+  else console.error(`[BLOCKER] Invalid JSON spec: ${(err as Error).message}`);
+  process.exit(2);
+}
+
+// ── Validate ──────────────────────────────────────────────
+const validation = validate(rawSpec);
+
+if (!validation.valid || !validation.data) {
+  const result = { success: false, blockers: validation.blockers, warnings: validation.warnings };
+  if (values.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    for (const b of validation.blockers) console.error(`[BLOCKER] ${b}`);
+    for (const w of validation.warnings) console.warn(`[WARNING] ${w}`);
+  }
+  process.exit(2);
+}
+
+// Log warnings
+if (!values.json) {
+  for (const w of validation.warnings) console.warn(`[WARNING] ${w}`);
+}
+
+// ── Execute ───────────────────────────────────────────────
+let result: AbortResult;
+try {
+  result = await execute(validation.data, workdir);
+} catch (err) {
+  const errResult = { success: false, operation: 'none' as const, restored: false, error: (err as Error).message };
+  if (values.json) console.log(JSON.stringify(errResult, null, 2));
+  else console.error(`[BLOCKER] ${(err as Error).message}`);
+  process.exit(2);
+}
+
+// ── Output ────────────────────────────────────────────────
+if (values.json) {
+  console.log(JSON.stringify(result, null, 2));
+} else {
+  if (result.success) {
+    if (result.operation === 'none') {
+      console.log('✓ No in-progress operation');
+    } else {
+      console.log(`✓ ${result.operation} aborted successfully`);
+    }
+  } else {
+    console.error(`✗ Failed to abort ${result.operation}: ${result.error}`);
+  }
+}
+
+process.exit(result.success ? 0 : 2);

package/templates/skills/gitflow/cli/abort/types.ts

@@ -0,0 +1,21 @@
+/**
+ * abort CLI types — Input spec and output result
+ */
+
+import { z } from 'zod';
+
+export const AbortSpecSchema = z.object({
+  git: z.boolean().optional().default(true),
+});
+
+export type AbortSpec = z.infer<typeof AbortSpecSchema>;
+
+export const AbortResultSchema = z.object({
+  success: z.boolean(),
+  operation: z.enum(['rebase', 'merge', 'cherry-pick', 'none']),
+  restored: z.boolean(),
+  message: z.string().optional(),
+  error: z.string().optional(),
+});
+
+export type AbortResult = z.infer<typeof AbortResultSchema>;

package/templates/skills/gitflow/cli/abort/validate.ts

@@ -0,0 +1,38 @@
+/**
+ * validate.ts — Validation structurelle (Zod) + règles métier.
+ * Ne connaît pas la DB, ne persiste rien.
+ */
+import { AbortSpecSchema, type AbortSpec } from './types.js';
+
+export interface ValidationResult {
+  valid: boolean;
+  data?: AbortSpec;
+  blockers: string[];
+  warnings: string[];
+}
+
+export function validate(raw: unknown): ValidationResult {
+  const blockers: string[] = [];
+  const warnings: string[] = [];
+
+  // ── Structural validation (Zod) ─────────────────────────
+  const parsed = AbortSpecSchema.safeParse(raw);
+  if (!parsed.success) {
+    for (const issue of parsed.error.issues) {
+      blockers.push(`[${issue.path.join('.')}] ${issue.message}`);
+    }
+    return { valid: false, blockers, warnings };
+  }
+
+  const data = parsed.data;
+
+  // ── Business rules ──────────────────────────────────────
+  // Minimal validation — mostly just structural
+
+  return {
+    valid: blockers.length === 0,
+    data,
+    blockers,
+    warnings,
+  };
+}