@hivehub/rulebook 3.4.2 → 4.1.0

package/dist/core/ralph-plan-checkpoint.js

@@ -0,0 +1,154 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import chalk from 'chalk';
+const defaultExecAsync = promisify(exec);
+// ─── Plan generation ─────────────────────────────────────────────────────────
+/**
+ * Build the planning-only prompt sent to the AI CLI tool.
+ *
+ * The prompt asks for an implementation plan without generating any code.
+ */
+export function buildPlanPrompt(story) {
+    const criteria = story.acceptanceCriteria.map((c) => `- ${c}`).join('\n');
+    return [
+        'You are planning (NOT implementing) a solution for this story:',
+        '',
+        `Story: ${story.title}`,
+        `Description: ${story.description}`,
+        `Acceptance Criteria:`,
+        criteria,
+        '',
+        'Provide a detailed implementation plan covering:',
+        '1. Files to create/modify',
+        '2. Key design decisions',
+        '3. Potential risks or blockers',
+        '4. Estimated implementation steps',
+        '',
+        'IMPORTANT: Output ONLY the plan. Do NOT implement or generate code.',
+    ].join('\n');
+}
+/**
+ * Generate an implementation plan for a user story by invoking an AI CLI tool.
+ *
+ * Uses the same execution pattern as {@link review-manager#runAIReview} — runs
+ * the tool binary with the prompt piped via stdin (for Claude) or as an
+ * argument (for Gemini / Amp).
+ *
+ * @returns The plan text, or an empty string if the tool fails or times out.
+ */
+export async function generateIterationPlan(story, tool, _projectRoot, execFn = defaultExecAsync) {
+    const prompt = buildPlanPrompt(story);
+    const commands = {
+        claude: 'claude',
+        gemini: 'gemini',
+        amp: 'amp',
+    };
+    const binary = commands[tool];
+    const flag = tool === 'gemini' ? '' : '-p';
+    // Pipe prompt via stdin to avoid shell escaping and arg-length issues
+    const escapedPrompt = prompt.replace(/'/g, "'\\''");
+    const command = flag
+        ? `echo '${escapedPrompt}' | ${binary} ${flag} -`
+        : `${binary} '${escapedPrompt}'`;
+    try {
+        const { stdout } = await execFn(command, { timeout: 120_000 });
+        return stdout.trim();
+    }
+    catch {
+        return '';
+    }
+}
+// ─── Plan display ────────────────────────────────────────────────────────────
+/**
+ * Display the generated plan in the terminal with a chalk-styled border.
+ *
+ * Uses simple `console.log` output — no blessed/ncurses dependencies.
+ */
+export function displayPlan(plan, storyTitle) {
+    const maxWidth = 60;
+    const titleLine = `  Story: ${storyTitle}`;
+    const headerLine = '  Implementation Plan';
+    const width = Math.max(maxWidth, headerLine.length + 4, titleLine.length + 4);
+    const top = chalk.cyan(`${'='.repeat(width + 4)}`);
+    const bottom = chalk.cyan(`${'='.repeat(width + 4)}`);
+    console.log('');
+    console.log(top);
+    console.log(chalk.cyan.bold(headerLine));
+    console.log(chalk.cyan(titleLine));
+    console.log(bottom);
+    console.log('');
+    console.log(plan);
+    console.log('');
+}
+/**
+ * Display the plan and interactively request approval from the user.
+ *
+ * When `autoApproveAfterSeconds` is greater than zero the plan is automatically
+ * approved after the specified delay. Otherwise an interactive inquirer prompt
+ * is presented with three choices: approve, reject, or edit.
+ *
+ * @returns Approval result indicating whether to proceed and optional feedback.
+ */
+export async function requestPlanApproval(plan, story, autoApproveAfterSeconds) {
+    displayPlan(plan, story.title);
+    // Auto-approve path
+    if (autoApproveAfterSeconds > 0) {
+        console.log(chalk.yellow(`  Auto-approving in ${autoApproveAfterSeconds} seconds... (Ctrl+C to abort)`));
+        await new Promise((resolve) => setTimeout(resolve, autoApproveAfterSeconds * 1000));
+        console.log(chalk.green('  Plan auto-approved.'));
+        return { approved: true };
+    }
+    // Interactive prompt path
+    const inquirer = (await import('inquirer')).default;
+    const { action } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: 'Review plan:',
+            choices: [
+                { name: 'approve', value: 'approve' },
+                { name: 'reject', value: 'reject' },
+                { name: 'edit', value: 'edit' },
+            ],
+        },
+    ]);
+    if (action === 'approve') {
+        return { approved: true };
+    }
+    const feedbackMessage = action === 'reject' ? 'Reason for rejection?' : 'What needs to change?';
+    const { feedback } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'feedback',
+            message: feedbackMessage,
+        },
+    ]);
+    return { approved: false, feedback };
+}
+// ─── Checkpoint gate ─────────────────────────────────────────────────────────
+/**
+ * Determine whether a plan checkpoint should be executed for the given story.
+ *
+ * Returns `false` when:
+ * - The checkpoint feature is disabled.
+ * - The session is non-interactive (CI, --yes flag, piped stdin).
+ * - `requireApprovalForStories` is `'none'`.
+ * - `requireApprovalForStories` is `'failed'` but the story already passes.
+ */
+export function shouldRunCheckpoint(config, story, isNonInteractive) {
+    if (!config.enabled) {
+        return false;
+    }
+    if (isNonInteractive) {
+        return false;
+    }
+    if (config.requireApprovalForStories === 'none') {
+        return false;
+    }
+    if (config.requireApprovalForStories === 'all') {
+        return true;
+    }
+    // 'failed' — only checkpoint stories that haven't passed yet
+    return !story.passes;
+}
+//# sourceMappingURL=ralph-plan-checkpoint.js.map

package/dist/core/ralph-plan-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-plan-checkpoint.js","sourceRoot":"","sources":["../../src/core/ralph-plan-checkpoint.ts"],"names":[],"mappings":"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"}

package/dist/core/ralph-scripts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Install Ralph shell scripts into the project's `.rulebook/scripts/` directory.
+ *
+ * Copies `.sh` and `.bat` script pairs from the templates directory.
+ * Sets executable permissions (0o755) on `.sh` files on non-Windows platforms.
+ * Idempotent: overwrites existing scripts without error.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns List of installed file paths (relative to projectRoot).
+ */
+export declare function installRalphScripts(projectRoot: string): Promise<string[]>;
+//# sourceMappingURL=ralph-scripts.d.ts.map

package/dist/core/ralph-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-scripts.d.ts","sourceRoot":"","sources":["../../src/core/ralph-scripts.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BhF"}

package/dist/core/ralph-scripts.js

@@ -0,0 +1,49 @@
+import path from 'path';
+import { promises as fs } from 'fs';
+import { fileURLToPath } from 'url';
+import { copyFile, ensureDir } from '../utils/file-system.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/** Resolve templates/ralph directory (handles both dev and production). */
+function getRalphTemplatesDir() {
+    return path.join(__dirname, '..', '..', 'templates', 'ralph');
+}
+const RALPH_SCRIPTS = [
+    'ralph-init',
+    'ralph-run',
+    'ralph-status',
+    'ralph-pause',
+    'ralph-history',
+];
+const SCRIPT_EXTENSIONS = ['.sh', '.bat'];
+/**
+ * Install Ralph shell scripts into the project's `.rulebook/scripts/` directory.
+ *
+ * Copies `.sh` and `.bat` script pairs from the templates directory.
+ * Sets executable permissions (0o755) on `.sh` files on non-Windows platforms.
+ * Idempotent: overwrites existing scripts without error.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @returns List of installed file paths (relative to projectRoot).
+ */
+export async function installRalphScripts(projectRoot) {
+    const templatesDir = getRalphTemplatesDir();
+    const scriptsDir = path.join(projectRoot, '.rulebook', 'scripts');
+    await ensureDir(scriptsDir);
+    const installed = [];
+    for (const scriptName of RALPH_SCRIPTS) {
+        for (const ext of SCRIPT_EXTENSIONS) {
+            const filename = `${scriptName}${ext}`;
+            const source = path.join(templatesDir, filename);
+            const destination = path.join(scriptsDir, filename);
+            await copyFile(source, destination);
+            // Set executable permissions on .sh files (Unix/macOS only)
+            if (ext === '.sh' && process.platform !== 'win32') {
+                await fs.chmod(destination, 0o755);
+            }
+            installed.push(path.join('.rulebook', 'scripts', filename));
+        }
+    }
+    return installed;
+}
+//# sourceMappingURL=ralph-scripts.js.map

package/dist/core/ralph-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-scripts.js","sourceRoot":"","sources":["../../src/core/ralph-scripts.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,2EAA2E;AAC3E,SAAS,oBAAoB;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,aAAa,GAAG;IACpB,YAAY;IACZ,WAAW;IACX,cAAc;IACd,aAAa;IACb,eAAe;CACP,CAAC;AAEX,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,YAAY,GAAG,oBAAoB,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAElE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,GAAG,UAAU,GAAG,GAAG,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEpD,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAEpC,4DAA4D;YAC5D,IAAI,GAAG,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAClD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/review-manager.d.ts

@@ -0,0 +1,74 @@
+export interface ReviewIssue {
+    severity: 'critical' | 'major' | 'minor' | 'suggestion';
+    file?: string;
+    line?: number;
+    message: string;
+    code?: string;
+}
+export interface ReviewResult {
+    summary: string;
+    issues: ReviewIssue[];
+    suggestions: string[];
+    /** True when no critical or major issues are present. */
+    approved: boolean;
+}
+export type ReviewOutputFormat = 'terminal' | 'github-comment' | 'json';
+export type ReviewFailOnSeverity = 'critical' | 'major' | 'minor';
+export type ReviewTool = 'claude' | 'gemini' | 'amp';
+/**
+ * Retrieve the git diff between the current HEAD and a base branch.
+ *
+ * Returns an empty string when:
+ * - The working directory is not a git repo.
+ * - There is no diff between the branches.
+ * - An error occurs during execution.
+ *
+ * The returned string is truncated to {@link MAX_DIFF_LENGTH} characters.
+ */
+export declare function getDiffContext(projectRoot: string, baseBranch?: string): Promise<string>;
+/**
+ * Build a structured review prompt suitable for an AI code reviewer.
+ */
+export declare function buildReviewPrompt(diff: string, context: {
+    agentsMdContent?: string;
+    projectName?: string;
+}): string;
+/**
+ * Parse the raw AI output into a structured {@link ReviewResult}.
+ *
+ * Handles missing sections gracefully — every field has a sensible default.
+ */
+export declare function parseReviewOutput(output: string): ReviewResult;
+/**
+ * Run the specified AI CLI tool with the given prompt.
+ *
+ * Returns the tool's stdout. On any error (timeout, missing tool, etc.)
+ * returns an empty string.
+ */
+export declare function runAIReview(prompt: string, tool?: ReviewTool): Promise<string>;
+/**
+ * Format a {@link ReviewResult} as a chalk-colored terminal string.
+ */
+export declare function formatReviewTerminal(result: ReviewResult): string;
+/**
+ * Format a {@link ReviewResult} as a GitHub-flavored markdown comment.
+ */
+export declare function formatReviewMarkdown(result: ReviewResult): string;
+/**
+ * Post a review result as a PR comment using the `gh` CLI.
+ *
+ * When `prNumber` is omitted the `gh` CLI auto-detects the current PR
+ * from the branch.
+ */
+export declare function postGitHubComment(result: ReviewResult, prNumber?: string): Promise<void>;
+/**
+ * Check whether any issue meets or exceeds the given severity threshold.
+ *
+ * Returns `true` when at least one issue is at the threshold level or higher.
+ */
+export declare function hasFailingIssues(issues: readonly ReviewIssue[], failOn: ReviewFailOnSeverity): boolean;
+/**
+ * Read AGENTS.md from the given project root, if it exists.
+ */
+export declare function readAgentsMd(projectRoot: string): Promise<string | undefined>;
+//# sourceMappingURL=review-manager.d.ts.map

package/dist/core/review-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-manager.d.ts","sourceRoot":"","sources":["../../src/core/review-manager.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,gBAAgB,GAAG,MAAM,CAAC;AAExE,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAIrD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAe,GAC1B,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,MAAM,CAiCR;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAW9D;AA4ED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,UAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB9F;AAkBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA2DjE;AAoBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAyCjE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9F;AAWD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAGT;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMnF"}