edsger 0.54.1 → 0.55.1

package/dist/commands/issue-analysis/index.d.ts

@@ -0,0 +1,5 @@
+export interface IssueAnalysisCliOptions {
+    issueId: string;
+    verbose?: boolean;
+}
+export declare const runIssueAnalysisCommand: (options: IssueAnalysisCliOptions) => Promise<void>;

package/dist/commands/issue-analysis/index.js

@@ -0,0 +1,9 @@
+import { analyseIssue } from '../../phases/issue-analysis/index.js';
+import { runIssuePhaseCli } from '../../utils/issue-phase-cli.js';
+export const runIssueAnalysisCommand = (options) => runIssuePhaseCli({
+    command: 'issue-analysis',
+    description: 'Issue analysis',
+    issueId: options.issueId,
+    verbose: options.verbose,
+    execute: analyseIssue,
+});

package/dist/commands/technical-design/index.d.ts

@@ -0,0 +1,5 @@
+export interface TechnicalDesignCliOptions {
+    issueId: string;
+    verbose?: boolean;
+}
+export declare const runTechnicalDesignCommand: (options: TechnicalDesignCliOptions) => Promise<void>;

package/dist/commands/technical-design/index.js

@@ -0,0 +1,9 @@
+import { generateTechnicalDesign } from '../../phases/technical-design/index.js';
+import { runIssuePhaseCli } from '../../utils/issue-phase-cli.js';
+export const runTechnicalDesignCommand = (options) => runIssuePhaseCli({
+    command: 'technical-design',
+    description: 'Technical design',
+    issueId: options.issueId,
+    verbose: options.verbose,
+    execute: generateTechnicalDesign,
+});

package/dist/commands/test-cases-analysis/index.d.ts

@@ -0,0 +1,5 @@
+export interface TestCasesAnalysisCliOptions {
+    issueId: string;
+    verbose?: boolean;
+}
+export declare const runTestCasesAnalysisCommand: (options: TestCasesAnalysisCliOptions) => Promise<void>;

package/dist/commands/test-cases-analysis/index.js

@@ -0,0 +1,9 @@
+import { analyseTestCases } from '../../phases/test-cases-analysis/index.js';
+import { runIssuePhaseCli } from '../../utils/issue-phase-cli.js';
+export const runTestCasesAnalysisCommand = (options) => runIssuePhaseCli({
+    command: 'test-cases-analysis',
+    description: 'Test-cases analysis',
+    issueId: options.issueId,
+    verbose: options.verbose,
+    execute: analyseTestCases,
+});

package/dist/commands/user-stories-analysis/index.d.ts

@@ -0,0 +1,5 @@
+export interface UserStoriesAnalysisCliOptions {
+    issueId: string;
+    verbose?: boolean;
+}
+export declare const runUserStoriesAnalysisCommand: (options: UserStoriesAnalysisCliOptions) => Promise<void>;

package/dist/commands/user-stories-analysis/index.js

@@ -0,0 +1,9 @@
+import { analyseUserStories } from '../../phases/user-stories-analysis/index.js';
+import { runIssuePhaseCli } from '../../utils/issue-phase-cli.js';
+export const runUserStoriesAnalysisCommand = (options) => runIssuePhaseCli({
+    command: 'user-stories-analysis',
+    description: 'User-stories analysis',
+    issueId: options.issueId,
+    verbose: options.verbose,
+    execute: analyseUserStories,
+});

package/dist/index.js

@@ -21,6 +21,7 @@ import { parseCategoriesOption, runFindSmells, } from './commands/find-smells/in
 import { runGrowthAnalysis } from './commands/growth-analysis/index.js';
 import { runInit } from './commands/init/index.js';
 import { runIntelligence } from './commands/intelligence/index.js';
+import { runIssueAnalysisCommand } from './commands/issue-analysis/index.js';
 import { runPRResolve } from './commands/pr-resolve/index.js';
 import { runPRReview } from './commands/pr-review/index.js';
 import { runRefactor } from './commands/refactor/refactor.js';
@@ -30,6 +31,9 @@ import { runSmokeTestCommand } from './commands/smoke-test/index.js';
 import { runSyncGithubIssues } from './commands/sync-github-issues/index.js';
 import { runSyncSentryIssues } from './commands/sync-sentry-issues/index.js';
 import { runTaskWorker } from './commands/task-worker/index.js';
+import { runTechnicalDesignCommand } from './commands/technical-design/index.js';
+import { runTestCasesAnalysisCommand } from './commands/test-cases-analysis/index.js';
+import { runUserStoriesAnalysisCommand } from './commands/user-stories-analysis/index.js';
 import { runWorkflow } from './commands/workflow/index.js';
 import { DEFAULT_MAX_FILES as FIND_ARCHITECTURE_DEFAULT_MAX_FILES } from './phases/find-architecture/index.js';
 import { DEFAULT_MAX_FILES as FIND_SMELLS_DEFAULT_MAX_FILES } from './phases/find-smells/index.js';
@@ -335,6 +339,70 @@ program
     }
 });
 // ============================================================
+// Subcommand: edsger issue-analysis <issueId>
+// ============================================================
+program
+    .command('issue-analysis <issueId>')
+    .description('Generate or refine the execution plan for an issue (issue_analysis phase, with verification loop)')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (issueId, opts) => {
+    try {
+        await runIssueAnalysisCommand({ issueId, verbose: opts.verbose });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
+// Subcommand: edsger user-stories-analysis <issueId>
+// ============================================================
+program
+    .command('user-stories-analysis <issueId>')
+    .description('Generate or refine user stories for an issue (user_stories_analysis phase, with verification loop)')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (issueId, opts) => {
+    try {
+        await runUserStoriesAnalysisCommand({ issueId, verbose: opts.verbose });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
+// Subcommand: edsger test-cases-analysis <issueId>
+// ============================================================
+program
+    .command('test-cases-analysis <issueId>')
+    .description('Generate or refine test cases for an issue (test_cases_analysis phase, with verification loop)')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (issueId, opts) => {
+    try {
+        await runTestCasesAnalysisCommand({ issueId, verbose: opts.verbose });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
+// Subcommand: edsger technical-design <issueId>
+// ============================================================
+program
+    .command('technical-design <issueId>')
+    .description('Generate or refine the technical design for an issue (technical_design phase, with verification loop)')
+    .option('-v, --verbose', 'Verbose output')
+    .action(async (issueId, opts) => {
+    try {
+        await runTechnicalDesignCommand({ issueId, verbose: opts.verbose });
+    }
+    catch (error) {
+        logError(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+// ============================================================
 // Subcommand: edsger smoke-test <releaseId>
 // ============================================================
 program
@@ -569,7 +637,17 @@ program
     .option('--concurrency <number>', 'Max concurrent issues to process (default: 3)', parseInt)
     .option('-c, --config <path>', 'Path to config file')
     .option('-v, --verbose', 'Verbose output');
-program.action(async (options) => {
+program.action(async (options, command) => {
+    // Commander silently falls through to this default action when the user
+    // passes a subcommand name that isn't registered (e.g. an old binary that
+    // doesn't yet know about `sync-sentry-issues`). That makes version-skew
+    // bugs look like the agent inexplicably running with the wrong intent.
+    // Treat any leftover positional arg as an unknown command and abort.
+    if (command.args.length > 0) {
+        logError(`Unknown command: ${command.args[0]}`);
+        logError(`Run 'edsger --help' to see available commands.`);
+        process.exit(1);
+    }
     try {
         await runEdsger(options);
     }

package/dist/utils/issue-phase-cli.d.ts

@@ -0,0 +1,26 @@
+import { type EdsgerConfig } from '../types/index.js';
+/** Result shape shared by all four issue-scoped phase functions.
+ *  `pending` means the phase had no work to do (e.g. nothing to regenerate);
+ *  it's not a failure. */
+interface IssuePhaseResult {
+    status: 'success' | 'error' | 'pending';
+    summary: string;
+}
+/**
+ * Run a single-issue phase from the CLI: validate config, register a session,
+ * invoke the phase function, log the result, and set the process exit code on
+ * failure. Used by `issue-analysis`, `user-stories-analysis`,
+ * `test-cases-analysis`, and `technical-design` — all of which share the
+ * same `(options, config) => Result` shape and need the same wrapper.
+ */
+export declare const runIssuePhaseCli: <TResult extends IssuePhaseResult>(args: {
+    command: string;
+    description: string;
+    issueId: string;
+    verbose?: boolean;
+    execute: (options: {
+        issueId: string;
+        verbose?: boolean;
+    }, config: EdsgerConfig) => Promise<TResult>;
+}) => Promise<void>;
+export {};

package/dist/utils/issue-phase-cli.js

@@ -0,0 +1,44 @@
+import { deregisterSession, registerSession, } from '../system/session-manager.js';
+import { logError, logInfo } from './logger.js';
+import { validateConfiguration } from './validation.js';
+/**
+ * Run a single-issue phase from the CLI: validate config, register a session,
+ * invoke the phase function, log the result, and set the process exit code on
+ * failure. Used by `issue-analysis`, `user-stories-analysis`,
+ * `test-cases-analysis`, and `technical-design` — all of which share the
+ * same `(options, config) => Result` shape and need the same wrapper.
+ */
+export const runIssuePhaseCli = async (args) => {
+    const { command, description, issueId, verbose, execute } = args;
+    if (!issueId) {
+        throw new Error(`Issue ID is required for ${command}`);
+    }
+    const config = validateConfiguration({ verbose });
+    // registerSession must run inside the try so a partial failure still
+    // triggers deregisterSession in the finally — otherwise the server-side
+    // session row is leaked.
+    let registered = false;
+    try {
+        await registerSession({ command });
+        registered = true;
+        logInfo(`Starting ${description} for issue: ${issueId}`);
+        const result = await execute({ issueId, verbose }, config);
+        if (result.status === 'error') {
+            logError(`${description} failed: ${result.summary}`);
+            process.exitCode = 1;
+        }
+        else {
+            // success or pending — both are non-failure outcomes
+            logInfo(result.summary);
+        }
+    }
+    catch (error) {
+        logError(`${description} failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+    finally {
+        if (registered) {
+            await deregisterSession();
+        }
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edsger",
-  "version": "0.54.1",
+  "version": "0.55.1",
   "type": "module",
   "bin": {
     "edsger": "dist/index.js"