@exaudeus/workrail 3.46.0 → 3.48.0

package/dist/cli/commands/index.d.ts

@@ -14,3 +14,4 @@ export { executeWorktrainAwaitCommand, parseDurationMs, type WorktrainAwaitComma
 export { executeWorktrainDaemonCommand, type WorktrainDaemonCommandDeps, type WorktrainDaemonCommandOpts, } from './worktrain-daemon.js';
 export { executeWorktrainOverviewCommand, buildConsoleServiceFromDataDir, type WorktrainOverviewCommandDeps, type WorktrainOverviewCommandOpts, type StatusDataPacket, type StatusSession, } from './worktrain-overview.js';
 export { executeWorktrainPipelineCommand, type WorktrainPipelineCommandDeps, type WorktrainPipelineCommandOpts, } from './worktrain-pipeline.js';
+export { executeWorktrainTriggerTestCommand, type WorktrainTriggerTestDeps, type WorktrainTriggerTestOpts, } from './worktrain-trigger-test.js';

package/dist/cli/commands/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeWorktrainPipelineCommand = exports.buildConsoleServiceFromDataDir = exports.executeWorktrainOverviewCommand = exports.executeWorktrainDaemonCommand = exports.parseDurationMs = exports.executeWorktrainAwaitCommand = exports.executeWorktrainSpawnCommand = exports.executeWorktrainInboxCommand = exports.executeWorktrainTellCommand = exports.executeWorktrainInitCommand = exports.detectWorkflowVersion = exports.migrateWorkflowFile = exports.migrateWorkflow = exports.executeMigrateCommand = exports.executeVersionCommand = exports.executeCleanupCommand = exports.executeStartCommand = exports.executeValidateCommand = exports.executeListCommand = exports.getWorkflowSources = exports.executeSourcesCommand = exports.executeInitConfigCommand = exports.executeInitCommand = void 0;
+exports.executeWorktrainTriggerTestCommand = exports.executeWorktrainPipelineCommand = exports.buildConsoleServiceFromDataDir = exports.executeWorktrainOverviewCommand = exports.executeWorktrainDaemonCommand = exports.parseDurationMs = exports.executeWorktrainAwaitCommand = exports.executeWorktrainSpawnCommand = exports.executeWorktrainInboxCommand = exports.executeWorktrainTellCommand = exports.executeWorktrainInitCommand = exports.detectWorkflowVersion = exports.migrateWorkflowFile = exports.migrateWorkflow = exports.executeMigrateCommand = exports.executeVersionCommand = exports.executeCleanupCommand = exports.executeStartCommand = exports.executeValidateCommand = exports.executeListCommand = exports.getWorkflowSources = exports.executeSourcesCommand = exports.executeInitConfigCommand = exports.executeInitCommand = void 0;
 var init_js_1 = require("./init.js");
 Object.defineProperty(exports, "executeInitCommand", { enumerable: true, get: function () { return init_js_1.executeInitCommand; } });
 Object.defineProperty(exports, "executeInitConfigCommand", { enumerable: true, get: function () { return init_js_1.executeInitConfigCommand; } });
@@ -40,3 +40,5 @@ Object.defineProperty(exports, "executeWorktrainOverviewCommand", { enumerable:
 Object.defineProperty(exports, "buildConsoleServiceFromDataDir", { enumerable: true, get: function () { return worktrain_overview_js_1.buildConsoleServiceFromDataDir; } });
 var worktrain_pipeline_js_1 = require("./worktrain-pipeline.js");
 Object.defineProperty(exports, "executeWorktrainPipelineCommand", { enumerable: true, get: function () { return worktrain_pipeline_js_1.executeWorktrainPipelineCommand; } });
+var worktrain_trigger_test_js_1 = require("./worktrain-trigger-test.js");
+Object.defineProperty(exports, "executeWorktrainTriggerTestCommand", { enumerable: true, get: function () { return worktrain_trigger_test_js_1.executeWorktrainTriggerTestCommand; } });

package/dist/cli/commands/worktrain-trigger-test.d.ts

@@ -0,0 +1,21 @@
+import type { CliResult } from '../types/cli-result.js';
+import type { TriggerDefinition } from '../../trigger/types.js';
+import type { GitHubQueuePollingSource } from '../../trigger/types.js';
+import type { GitHubQueueConfig } from '../../trigger/github-queue-config.js';
+import type { GitHubQueueIssue } from '../../trigger/adapters/github-queue-poller.js';
+import type { Result } from '../../runtime/result.js';
+export interface WorktrainTriggerTestDeps {
+    readonly loadTriggerConfig: () => Promise<Result<Map<string, TriggerDefinition>, string>>;
+    readonly loadQueueConfig: () => Promise<Result<GitHubQueueConfig | null, string>>;
+    readonly pollGitHubQueueIssues: (source: GitHubQueuePollingSource, config: GitHubQueueConfig) => Promise<Result<GitHubQueueIssue[], string>>;
+    readonly countActiveSessions: () => Promise<number>;
+    readonly checkIdempotency: (issueNumber: number) => Promise<'active' | 'clear'>;
+    readonly inferMaturity: (issue: GitHubQueueIssue) => 'idea' | 'specced' | 'ready';
+    readonly print: (line: string) => void;
+    readonly stderr: (line: string) => void;
+}
+export interface WorktrainTriggerTestOpts {
+    readonly triggerId: string;
+    readonly port?: number;
+}
+export declare function executeWorktrainTriggerTestCommand(deps: WorktrainTriggerTestDeps, opts: WorktrainTriggerTestOpts): Promise<CliResult>;

package/dist/cli/commands/worktrain-trigger-test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeWorktrainTriggerTestCommand = executeWorktrainTriggerTestCommand;
+const cli_result_js_1 = require("../types/cli-result.js");
+async function executeWorktrainTriggerTestCommand(deps, opts) {
+    const triggerId = opts.triggerId.trim();
+    if (!triggerId) {
+        deps.stderr('[DryRun] Error: triggerId must not be empty.');
+        return (0, cli_result_js_1.failure)('triggerId must not be empty.');
+    }
+    const triggerIndexResult = await deps.loadTriggerConfig();
+    if (triggerIndexResult.kind === 'err') {
+        deps.stderr(`[DryRun] Error: Failed to load triggers.yml: ${triggerIndexResult.error}`);
+        return (0, cli_result_js_1.failure)(`Failed to load triggers.yml: ${triggerIndexResult.error}`);
+    }
+    const triggerIndex = triggerIndexResult.value;
+    const trigger = triggerIndex.get(triggerId);
+    if (!trigger) {
+        deps.stderr(`[DryRun] Error: Trigger '${triggerId}' not found in triggers.yml.`);
+        return (0, cli_result_js_1.failure)(`Trigger '${triggerId}' not found in triggers.yml.`);
+    }
+    if (trigger.provider !== 'github_queue_poll') {
+        deps.stderr(`[DryRun] Error: Trigger '${triggerId}' is not a queue poll trigger -- ` +
+            `only github_queue_poll triggers can be tested with this command`);
+        return (0, cli_result_js_1.failure)(`Trigger '${triggerId}' is not a queue poll trigger -- ` +
+            `only github_queue_poll triggers can be tested with this command`);
+    }
+    const pollingSource = trigger.pollingSource;
+    const queueConfigResult = await deps.loadQueueConfig();
+    if (queueConfigResult.kind === 'err') {
+        deps.stderr(`[DryRun] Error: Failed to load queue config: ${queueConfigResult.error}`);
+        return (0, cli_result_js_1.failure)(`Failed to load queue config: ${queueConfigResult.error}`);
+    }
+    const queueConfig = queueConfigResult.value;
+    if (queueConfig === null) {
+        deps.stderr('[DryRun] Error: No queue config found in ~/.workrail/config.json (missing "queue" key).');
+        return (0, cli_result_js_1.failure)('No queue config found in ~/.workrail/config.json (missing "queue" key).');
+    }
+    const activeSessions = await deps.countActiveSessions();
+    deps.print(`[DryRun] Trigger: ${triggerId} (${trigger.provider})`);
+    deps.print(`[DryRun] Queue config: type=${queueConfig.type}${queueConfig.queueLabel ? ` queueLabel=${queueConfig.queueLabel}` : ''}${queueConfig.user ? ` user=${queueConfig.user}` : ''} repo=${queueConfig.repo}`);
+    deps.print(`[DryRun] Active sessions: ${activeSessions} / maxTotalConcurrentSessions: ${queueConfig.maxTotalConcurrentSessions}`);
+    deps.print('');
+    if (activeSessions >= queueConfig.maxTotalConcurrentSessions) {
+        deps.print(`[DryRun] Concurrency cap reached: active sessions (${activeSessions}) >= ` +
+            `maxTotalConcurrentSessions (${queueConfig.maxTotalConcurrentSessions})`);
+        deps.print('[DryRun] Summary: 0 would dispatch, 0 would skip (concurrency cap)');
+        return (0, cli_result_js_1.failure)('');
+    }
+    const issuesResult = await deps.pollGitHubQueueIssues(pollingSource, queueConfig);
+    if (issuesResult.kind === 'err') {
+        deps.stderr(`[DryRun] Error: Failed to fetch issues: ${issuesResult.error}`);
+        return (0, cli_result_js_1.failure)(`Failed to fetch issues: ${issuesResult.error}`);
+    }
+    const issues = issuesResult.value;
+    const decisions = [];
+    for (const issue of issues) {
+        const issueLabels = issue.labels.map((l) => l.name);
+        const excludedLabel = queueConfig.excludeLabels.find((el) => issueLabels.includes(el));
+        if (excludedLabel) {
+            decisions.push({ kind: 'skip', issue, reason: `excluded_label: ${excludedLabel}` });
+            continue;
+        }
+        if (issueLabels.includes('worktrain:in-progress')) {
+            decisions.push({ kind: 'skip', issue, reason: 'active_session_or_in_progress' });
+            continue;
+        }
+        if (/sess_[a-z0-9]+/.test(issue.body)) {
+            decisions.push({ kind: 'skip', issue, reason: 'active_session_or_in_progress' });
+            continue;
+        }
+        const idempotencyStatus = await deps.checkIdempotency(issue.number);
+        if (idempotencyStatus === 'active') {
+            decisions.push({ kind: 'skip', issue, reason: 'active_session' });
+            continue;
+        }
+        const maturity = deps.inferMaturity(issue);
+        if (maturity === 'idea') {
+            decisions.push({ kind: 'skip', issue, reason: 'maturity=idea (no spec, no checklist)' });
+            continue;
+        }
+        decisions.push({
+            kind: 'dispatch',
+            issue,
+            maturity,
+            upstreamSpecUrl: extractUpstreamSpecUrl(issue.body),
+        });
+    }
+    for (const decision of decisions) {
+        if (decision.kind === 'dispatch') {
+            deps.print(`[DryRun] Issue #${decision.issue.number} "${decision.issue.title}" -- WOULD DISPATCH`);
+            deps.print(`  maturity: ${decision.maturity} (${describeMaturity(decision.maturity)})`);
+            deps.print(`  upstreamSpecUrl: ${decision.upstreamSpecUrl ?? '(none)'}`);
+        }
+        else {
+            deps.print(`[DryRun] Issue #${decision.issue.number} "${decision.issue.title}" -- WOULD SKIP`);
+            deps.print(`  reason: ${decision.reason}`);
+        }
+        deps.print('');
+    }
+    const dispatchCount = decisions.filter((d) => d.kind === 'dispatch').length;
+    const skipCount = decisions.filter((d) => d.kind === 'skip').length;
+    deps.print(`[DryRun] Summary: ${dispatchCount} would dispatch, ${skipCount} would skip`);
+    if (dispatchCount === 0) {
+        return (0, cli_result_js_1.failure)('');
+    }
+    return (0, cli_result_js_1.success)();
+}
+function extractUpstreamSpecUrl(body) {
+    const specLineMatch = /upstream_spec:\s*(https?:\/\/\S+)/i.exec(body);
+    if (specLineMatch?.[1])
+        return specLineMatch[1];
+    const firstPara = body.split(/\n\s*\n/)[0] ?? '';
+    const urlMatch = /(https?:\/\/\S+)/.exec(firstPara);
+    return urlMatch?.[1];
+}
+function describeMaturity(maturity) {
+    switch (maturity) {
+        case 'ready': return 'has acceptance criteria';
+        case 'specced': return 'has checklist or acceptance criteria heading';
+        case 'idea': return 'no spec, no checklist';
+    }
+}

package/dist/cli-worktrain.js

@@ -970,4 +970,69 @@ runCommand
     });
     process.exit(result.hasErrors ? 1 : 0);
 });
+const triggerCommand = program
+    .command('trigger')
+    .description('Trigger management commands');
+triggerCommand
+    .command('test <triggerId>')
+    .description('Dry-run the queue picker for a trigger -- shows what would dispatch without dispatching')
+    .option('-p, --port <n>', 'Console server port for active session count', parseInt)
+    .action(async (triggerId, options) => {
+    const { loadTriggerConfigFromFile, buildTriggerIndex } = await Promise.resolve().then(() => __importStar(require('./trigger/trigger-store.js')));
+    const { loadQueueConfig } = await Promise.resolve().then(() => __importStar(require('./trigger/github-queue-config.js')));
+    const { pollGitHubQueueIssues, checkIdempotency, inferMaturity } = await Promise.resolve().then(() => __importStar(require('./trigger/adapters/github-queue-poller.js')));
+    const cwd = process.cwd();
+    const result = await (0, index_js_2.executeWorktrainTriggerTestCommand)({
+        loadTriggerConfig: async () => {
+            const configResult = await loadTriggerConfigFromFile(cwd, process.env);
+            if (configResult.kind === 'err') {
+                const e = configResult.error;
+                const msg = e.kind === 'file_not_found'
+                    ? `triggers.yml not found at ${e.filePath}`
+                    : e.kind === 'io_error'
+                        ? `IO error reading triggers.yml: ${e.message}`
+                        : `Failed to parse triggers.yml: ${JSON.stringify(e)}`;
+                return { kind: 'err', error: msg };
+            }
+            const indexResult = buildTriggerIndex(configResult.value);
+            if (indexResult.kind === 'err') {
+                const idxErr = indexResult.error;
+                const triggerId2 = 'triggerId' in idxErr ? idxErr.triggerId : '(unknown)';
+                return { kind: 'err', error: `Duplicate trigger ID: ${triggerId2}` };
+            }
+            return { kind: 'ok', value: indexResult.value };
+        },
+        loadQueueConfig: async () => {
+            return loadQueueConfig();
+        },
+        pollGitHubQueueIssues: async (source, config) => {
+            const result2 = await pollGitHubQueueIssues(source, config);
+            if (result2.kind === 'err') {
+                const e = result2.error;
+                return { kind: 'err', error: `${e.kind}: ${e.message}` };
+            }
+            return result2;
+        },
+        countActiveSessions: async () => {
+            const sessionsDir = path_1.default.join(os_1.default.homedir(), '.workrail', 'daemon-sessions');
+            try {
+                const files = await fs_1.default.promises.readdir(sessionsDir);
+                return files.filter((f) => f.endsWith('.json')).length;
+            }
+            catch {
+                return 0;
+            }
+        },
+        checkIdempotency: async (issueNumber) => {
+            const sessionsDir = path_1.default.join(os_1.default.homedir(), '.workrail', 'daemon-sessions');
+            return checkIdempotency(issueNumber, sessionsDir);
+        },
+        inferMaturity: (issue) => inferMaturity(issue.body),
+        print: (line) => process.stdout.write(line + '\n'),
+        stderr: (line) => process.stderr.write(line + '\n'),
+    }, { triggerId, port: options.port });
+    if (result.kind === 'failure') {
+        process.exit(1);
+    }
+});
 program.parse();