@helmiq/crew 0.1.0

package/dist/actions/actions.test.js

@@ -0,0 +1,158 @@
+import { describe, it, expect } from 'vitest';
+import { getAction, listActions, listActionNames, resolveAction, parseWorkItemId, UnknownActionError, DirectDispatcher, } from './index.js';
+describe('action registry', () => {
+    it('returns the implement action definition', () => {
+        const action = getAction('implement');
+        expect(action).toBeDefined();
+        expect(action.persona).toBe('engineer');
+        expect(action.task).toBe('implement-story');
+        expect(action.track).toBe('delivery');
+        expect(action.idLevel).toBe('task');
+    });
+    it('returns the review action definition', () => {
+        const action = getAction('review');
+        expect(action).toBeDefined();
+        expect(action.persona).toBe('reviewer');
+        expect(action.task).toBe('review-pr');
+        expect(action.track).toBe('delivery');
+        expect(action.idLevel).toBe('task');
+    });
+    it('returns the address action definition', () => {
+        const action = getAction('address');
+        expect(action).toBeDefined();
+        expect(action.persona).toBe('engineer');
+        expect(action.task).toBe('address-feedback');
+        expect(action.track).toBe('delivery');
+        expect(action.idLevel).toBe('task');
+    });
+    it('returns the decide action definition', () => {
+        const action = getAction('decide');
+        expect(action).toBeDefined();
+        expect(action.persona).toBe('architect');
+        expect(action.task).toBe('adr-workflow');
+        expect(action.track).toBe('architecture');
+        expect(action.idLevel).toBe('epic');
+    });
+    it('returns undefined for unknown actions', () => {
+        expect(getAction('nonexistent')).toBeUndefined();
+    });
+    it('lists all registered actions', () => {
+        const actions = listActions();
+        expect(actions.length).toBeGreaterThanOrEqual(4);
+        expect(actions.some((a) => a.name === 'implement')).toBe(true);
+        expect(actions.some((a) => a.name === 'review')).toBe(true);
+        expect(actions.some((a) => a.name === 'address')).toBe(true);
+        expect(actions.some((a) => a.name === 'decide')).toBe(true);
+    });
+    it('lists action names', () => {
+        const names = listActionNames();
+        expect(names).toContain('implement');
+        expect(names).toContain('review');
+        expect(names).toContain('address');
+        expect(names).toContain('decide');
+    });
+});
+describe('parseWorkItemId', () => {
+    it('parses a task-level ID into epicId and storyId', () => {
+        const result = parseWorkItemId('CREW-03-001');
+        expect(result.epicId).toBe('CREW-03');
+        expect(result.storyId).toBe('CREW-03-001');
+    });
+    it('parses an epic-level ID into epicId only', () => {
+        const result = parseWorkItemId('CREW-03');
+        expect(result.epicId).toBe('CREW-03');
+        expect(result.storyId).toBeUndefined();
+    });
+    it('handles IDs with more than three segments', () => {
+        const result = parseWorkItemId('CREW-03-001-sub');
+        expect(result.epicId).toBe('CREW-03');
+        expect(result.storyId).toBe('CREW-03-001-sub');
+    });
+});
+describe('resolveAction', () => {
+    it('resolves implement action to engineer persona', () => {
+        const resolved = resolveAction({
+            action: 'implement',
+            id: 'CREW-03-001',
+            workspace: '/tmp/workspace',
+        });
+        expect(resolved.action).toBe('implement');
+        expect(resolved.persona).toBe('engineer');
+        expect(resolved.task).toBe('implement-story');
+        expect(resolved.scope).toBe('CREW-03');
+        expect(resolved.epicId).toBe('CREW-03');
+        expect(resolved.storyId).toBe('CREW-03-001');
+        expect(resolved.workspace).toBe('/tmp/workspace');
+    });
+    it('resolves review action to reviewer persona', () => {
+        const resolved = resolveAction({
+            action: 'review',
+            id: 'CREW-04-001',
+            workspace: '/tmp/workspace',
+        });
+        expect(resolved.action).toBe('review');
+        expect(resolved.persona).toBe('reviewer');
+        expect(resolved.task).toBe('review-pr');
+        expect(resolved.scope).toBe('CREW-04');
+        expect(resolved.epicId).toBe('CREW-04');
+        expect(resolved.storyId).toBe('CREW-04-001');
+    });
+    it('resolves address action to engineer persona address-feedback task', () => {
+        const resolved = resolveAction({
+            action: 'address',
+            id: 'CREW-04-001',
+            workspace: '/tmp/workspace',
+        });
+        expect(resolved.action).toBe('address');
+        expect(resolved.persona).toBe('engineer');
+        expect(resolved.task).toBe('address-feedback');
+        expect(resolved.scope).toBe('CREW-04');
+        expect(resolved.epicId).toBe('CREW-04');
+        expect(resolved.storyId).toBe('CREW-04-001');
+    });
+    it('resolves decide action to architect persona at epic level', () => {
+        const resolved = resolveAction({
+            action: 'decide',
+            id: 'CREW-05',
+            workspace: '/tmp/workspace',
+        });
+        expect(resolved.action).toBe('decide');
+        expect(resolved.persona).toBe('architect');
+        expect(resolved.task).toBe('adr-workflow');
+        expect(resolved.scope).toBe('CREW-05');
+        expect(resolved.epicId).toBe('CREW-05');
+        expect(resolved.storyId).toBeUndefined();
+        expect(resolved.workspace).toBe('/tmp/workspace');
+    });
+    it('passes dryRun through', () => {
+        const resolved = resolveAction({
+            action: 'implement',
+            id: 'CREW-03-001',
+            workspace: '/tmp/ws',
+            dryRun: true,
+        });
+        expect(resolved.dryRun).toBe(true);
+    });
+    it('throws UnknownActionError for unregistered actions', () => {
+        expect(() => resolveAction({ action: 'deploy', id: 'CREW-01', workspace: '/tmp/ws' })).toThrow(UnknownActionError);
+    });
+    it('error message lists available actions', () => {
+        try {
+            resolveAction({ action: 'deploy', id: 'CREW-01', workspace: '/tmp/ws' });
+            expect.fail('should have thrown');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(UnknownActionError);
+            expect(err.message).toContain('implement');
+            expect(err.message).toContain('review');
+            expect(err.message).toContain('address');
+            expect(err.message).toContain('decide');
+        }
+    });
+});
+describe('ActionDispatcher interface', () => {
+    it('DirectDispatcher implements ActionDispatcher', () => {
+        const dispatcher = new DirectDispatcher();
+        expect(typeof dispatcher.dispatch).toBe('function');
+    });
+});

package/dist/actions/direct-dispatcher.d.ts

@@ -0,0 +1,10 @@
+import type { ActionDispatcher } from './dispatcher.js';
+import type { ResolvedAction, ActionResult } from './resolver.js';
+/**
+ * DirectDispatcher calls the execution engine in-process (synchronous).
+ * This is the Phase 1 dispatcher per ADR-0013.
+ */
+export declare class DirectDispatcher implements ActionDispatcher {
+    dispatch(resolved: ResolvedAction): Promise<ActionResult>;
+}
+//# sourceMappingURL=direct-dispatcher.d.ts.map

package/dist/actions/direct-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-dispatcher.d.ts","sourceRoot":"","sources":["../../src/actions/direct-dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACjD,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAqBhE"}

package/dist/actions/direct-dispatcher.js

@@ -0,0 +1,27 @@
+import { executeRunCommand } from '../cli/run.js';
+/**
+ * DirectDispatcher calls the execution engine in-process (synchronous).
+ * This is the Phase 1 dispatcher per ADR-0013.
+ */
+export class DirectDispatcher {
+    async dispatch(resolved) {
+        const result = await executeRunCommand({
+            persona: resolved.persona,
+            task: resolved.task,
+            scope: resolved.scope,
+            workspace: resolved.workspace,
+            dryRun: resolved.dryRun,
+            storyId: resolved.storyId,
+        });
+        return {
+            runId: result.runId,
+            status: result.status,
+            artifactPath: result.artifactPath,
+            provenancePath: result.provenancePath,
+            evaluationScore: result.evaluationScore,
+            durationMs: result.durationMs,
+            feedbackIteration: result.feedbackIteration,
+            escalated: result.escalated,
+        };
+    }
+}

package/dist/actions/dispatcher.d.ts

@@ -0,0 +1,11 @@
+import type { ResolvedAction, ActionResult } from './resolver.js';
+/**
+ * ActionDispatcher interface per ADR-0013.
+ *
+ * Phase 1: DirectDispatcher calls the execution engine in-process.
+ * Phase 2: InngestDispatcher sends events to Inngest for durable workflows.
+ */
+export interface ActionDispatcher {
+    dispatch(resolved: ResolvedAction): Promise<ActionResult>;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/actions/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/actions/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3D"}

package/dist/actions/dispatcher.js

@@ -0,0 +1 @@
+export {};

package/dist/actions/index.d.ts

@@ -0,0 +1,7 @@
+export { getAction, listActions, listActionNames } from './registry.js';
+export type { ActionDefinition, ActionTrack, ActionIdLevel } from './registry.js';
+export { resolveAction, parseWorkItemId, UnknownActionError } from './resolver.js';
+export type { ResolvedAction, ActionResult, ResolveOptions } from './resolver.js';
+export type { ActionDispatcher } from './dispatcher.js';
+export { DirectDispatcher } from './direct-dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/actions/index.js

@@ -0,0 +1,3 @@
+export { getAction, listActions, listActionNames } from './registry.js';
+export { resolveAction, parseWorkItemId, UnknownActionError } from './resolver.js';
+export { DirectDispatcher } from './direct-dispatcher.js';

package/dist/actions/registry.d.ts

@@ -0,0 +1,13 @@
+export type ActionTrack = 'delivery' | 'discovery' | 'architecture' | 'refine';
+export type ActionIdLevel = 'task' | 'epic' | 'sprint';
+export interface ActionDefinition {
+    name: string;
+    track: ActionTrack;
+    idLevel: ActionIdLevel;
+    persona: string;
+    task: string;
+}
+export declare function getAction(name: string): ActionDefinition | undefined;
+export declare function listActions(): ActionDefinition[];
+export declare function listActionNames(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/actions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/actions/registry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAmCD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpE;AAED,wBAAgB,WAAW,IAAI,gBAAgB,EAAE,CAEhD;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/actions/registry.js

@@ -0,0 +1,40 @@
+const ACTIONS = [
+    {
+        name: 'implement',
+        track: 'delivery',
+        idLevel: 'task',
+        persona: 'engineer',
+        task: 'implement-story',
+    },
+    {
+        name: 'review',
+        track: 'delivery',
+        idLevel: 'task',
+        persona: 'reviewer',
+        task: 'review-pr',
+    },
+    {
+        name: 'address',
+        track: 'delivery',
+        idLevel: 'task',
+        persona: 'engineer',
+        task: 'address-feedback',
+    },
+    {
+        name: 'decide',
+        track: 'architecture',
+        idLevel: 'epic',
+        persona: 'architect',
+        task: 'adr-workflow',
+    },
+];
+const actionMap = new Map(ACTIONS.map((a) => [a.name, a]));
+export function getAction(name) {
+    return actionMap.get(name);
+}
+export function listActions() {
+    return [...ACTIONS];
+}
+export function listActionNames() {
+    return ACTIONS.map((a) => a.name);
+}

package/dist/actions/resolver.d.ts

@@ -0,0 +1,47 @@
+import type { RunStatus } from '../types/index.js';
+export interface ResolvedAction {
+    action: string;
+    persona: string;
+    task: string;
+    scope: string;
+    workspace: string;
+    epicId: string;
+    storyId?: string;
+    dryRun?: boolean;
+}
+export interface ActionResult {
+    runId: string;
+    status: RunStatus;
+    artifactPath?: string;
+    provenancePath?: string;
+    evaluationScore?: number;
+    durationMs: number;
+    feedbackIteration?: number;
+    escalated?: boolean;
+}
+export declare class UnknownActionError extends Error {
+    readonly code: "UNKNOWN_ACTION";
+    constructor(action: string);
+}
+export interface ResolveOptions {
+    action: string;
+    id: string;
+    workspace: string;
+    dryRun?: boolean;
+}
+/**
+ * Parse a work item ID into epic and optional story components.
+ *
+ * `CREW-03-001` yields `{ epicId: 'CREW-03', storyId: 'CREW-03-001' }`
+ * `CREW-03` yields `{ epicId: 'CREW-03' }`
+ */
+export declare function parseWorkItemId(id: string): {
+    epicId: string;
+    storyId?: string;
+};
+/**
+ * Resolve a CLI action + ID into a fully-qualified ResolvedAction
+ * that the dispatcher can execute.
+ */
+export declare function resolveAction(options: ResolveOptions): ResolvedAction;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/actions/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/actions/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;gBAE9B,MAAM,EAAE,MAAM;CAK3B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAMhF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAkBrE"}

package/dist/actions/resolver.js

@@ -0,0 +1,43 @@
+import { getAction, listActionNames } from './registry.js';
+export class UnknownActionError extends Error {
+    code = 'UNKNOWN_ACTION';
+    constructor(action) {
+        const available = listActionNames().join(', ');
+        super(`Unknown action '${action}'. Available: ${available}`);
+        this.name = 'UnknownActionError';
+    }
+}
+/**
+ * Parse a work item ID into epic and optional story components.
+ *
+ * `CREW-03-001` yields `{ epicId: 'CREW-03', storyId: 'CREW-03-001' }`
+ * `CREW-03` yields `{ epicId: 'CREW-03' }`
+ */
+export function parseWorkItemId(id) {
+    const parts = id.split('-');
+    if (parts.length >= 3) {
+        return { epicId: `${parts[0]}-${parts[1]}`, storyId: id };
+    }
+    return { epicId: id };
+}
+/**
+ * Resolve a CLI action + ID into a fully-qualified ResolvedAction
+ * that the dispatcher can execute.
+ */
+export function resolveAction(options) {
+    const definition = getAction(options.action);
+    if (!definition) {
+        throw new UnknownActionError(options.action);
+    }
+    const { epicId, storyId } = parseWorkItemId(options.id);
+    return {
+        action: definition.name,
+        persona: definition.persona,
+        task: definition.task,
+        scope: epicId,
+        workspace: options.workspace,
+        epicId,
+        storyId,
+        dryRun: options.dryRun,
+    };
+}

package/dist/cli/cli.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.test.d.ts.map

package/dist/cli/cli.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.test.d.ts","sourceRoot":"","sources":["../../src/cli/cli.test.ts"],"names":[],"mappings":""}