@auto-engineer/pipeline 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+> @auto-engineer/pipeline@0.0.1 build /home/runner/work/auto-engineer/auto-engineer/packages/pipeline
+> tsc && tsx ../../scripts/fix-esm-imports.ts
+
+Fixed ESM imports in dist/

package/LICENSE

@@ -0,0 +1,10 @@
+Elastic License 2.0
+
+Copyright 2024 Sam Hatoum
+
+This software and associated documentation files (the "Software") are licensed under the Elastic License 2.0 (the "License"). You may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at:
+https://www.elastic.co/licensing/elastic-license
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. 

package/claude.md

@@ -0,0 +1,160 @@
+# Development Guide
+
+## Pomodoro + TDD + TCR + 100% Coverage
+
+```
+╔═════════════════════════════════════════════════════════════════════╗
+║   Red ───► Green ───►[TCR]───► Refactor ───►[TCR]───► Done          ║
+║                                                                     ║
+║   [TCR] = test ──┬── pass ──► commit ──► continue                   ║
+║                  └── fail ──► REVERT ──► RETHINK                    ║
+║                                                                     ║
+║   REVERT means STOP. Don't fix in place.                            ║
+║   RETHINK means try again with SMALLER STEPS OR try a NEW DESIGN    ║
+╚═════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## 🍅 Pomodoro Workflow
+
+One atomic test + implementation per cycle (5-15 min).
+
+**Planning a Pomodoro:**
+
+- Independent, valuable, small, testable
+- Define: value added, code surface size (S/M/L), complexity (S/M/L)
+- 1-2 line approach description
+- Create `pomodoro-plan.md` with sections: TODO / DONE
+- Commit the plan with initial pomodoros
+
+**Execution:**
+
+1. Write ONE failing test (Red)
+2. Write MINIMAL code to pass (Green)
+3. TCR: `test && commit || revert` (include plan update)
+4. Refactor if needed
+5. TCR: `test && commit || revert`
+6. Move pomodoro to DONE in the `pomodoro-plan.md`, commit with TCR
+
+**TCR Command:**
+
+```bash
+pnpm test --run && \
+  git add -A && git commit -m "<COMMITIZEN FORMAT>" || \
+  git checkout -- packages/<package>/
+```
+
+---
+
+## 🎯 TDD + 100% Coverage
+
+All thresholds enforced at 100%. Tests drive the code.
+
+| Do                              | Don't                                    |
+| ------------------------------- | ---------------------------------------- |
+| Let tests drive all code        | Write code without a failing test first  |
+| Add branches only when tested   | Defensive `??`, `?:`, `if/else` untested |
+| Test all error paths            | Leave error handling unverified          |
+| Remove dead code after each run | Keep unused code "just in case"          |
+
+**NEVER Exclude Files to Dodge Coverage**
+
+```
+╔══════════════════════════════════════════════════════════════════════╗
+║  Excluding a file from coverage to avoid testing it is FORBIDDEN.    ║
+║  "Hard to test" code (file system, dynamic imports, network, etc.)   ║
+║  → Inject dependencies and mock them. That's what mocks are for.     ║
+╚══════════════════════════════════════════════════════════════════════╝
+```
+
+Coverage exclusions are ONLY for:
+
+- Type-only files (interfaces, type definitions)
+- Barrel exports (index.ts re-exports)
+- Files that are genuinely 0% logic (pure declarations)
+
+If you're tempted to exclude a file because it's "infrastructure" or "integration-focused" — STOP. The coverage requirement exists precisely to force testable design.
+
+---
+
+## 📝 Testing Guidelines
+
+### Test Title = Spec
+
+The `it('should...')` title defines what you're testing. Body proves exactly that.
+
+```ts
+// ✅ Title matches body
+it('should reject empty usernames', () => {
+  const result = validate({ username: '' });
+  expect(result.valid).toBe(false);
+});
+
+// ❌ Body does more than title claims
+it('should reject empty usernames', () => {
+  const result = validate({ username: '' });
+  expect(result.valid).toBe(false);
+  expect(result.errors).toContain('Username required'); // second spec
+  expect(logger.warn).toHaveBeenCalled(); // third spec
+});
+```
+
+### Stubs Over Mocks
+
+Use deterministic stubs. Mock at boundaries only when stubs aren't possible.
+
+```ts
+// ✅ Deterministic stub
+function createTestIdGenerator() {
+  let counter = 0;
+  return () => `test-id-${counter++}`;
+}
+
+it('creates user with generated id', () => {
+  const generateId = createTestIdGenerator();
+  const user = createUser({ name: 'Alice' }, generateId);
+  expect(user).toEqual({ id: 'test-id-0', name: 'Alice' });
+});
+
+// ❌ Mocking couples tests to implementation
+it('creates user with generated id', () => {
+  const mockGenerateId = vi.fn().mockReturnValue('user-123');
+  const user = createUser({ name: 'Alice' }, mockGenerateId);
+  expect(mockGenerateId).toHaveBeenCalled();
+});
+```
+
+### Assert Whole Objects
+
+Catch structural changes. Don't cherry-pick properties.
+
+```ts
+// ✅ Catches any unexpected changes
+expect(result).toEqual({ type: 'USER', name: 'Alice', processed: true });
+
+// ❌ Misses if extra properties added/removed
+expect(result.type).toBe('USER');
+expect(result.processed).toBe(true);
+```
+
+### Squint Test
+
+All tests should look identical when you squint: **SETUP → EXECUTE → VERIFY**
+
+```ts
+// ✅ Single clear structure
+it('transforms user to uppercase', () => {
+  const input = { type: 'user' }; // SETUP
+  const result = transform(input); // EXECUTE
+  expect(result).toEqual({ type: 'USER' }); // VERIFY
+});
+
+// ❌ Multiple execute/verify = split into separate tests
+it('does too many things', () => {
+  const result = transform({ type: 'user' });
+  expect(result.type).toBe('USER');
+  const updated = updateResult(result); // second execute
+  expect(updated.modified).toBe(true); // second verify
+});
+```

package/dist/src/builder/define.d.ts

@@ -0,0 +1,90 @@
+import type { Event } from '@auto-engineer/message-bus';
+import type { FailureContext, PipelineDescriptor, SuccessContext } from '../core/descriptors';
+import type { CommandDispatch } from '../core/types';
+import type { GraphIR } from '../graph/types';
+import type { PipelineContext } from '../runtime/context';
+export interface Pipeline {
+    descriptor: Readonly<PipelineDescriptor>;
+    toGraph(): GraphIR;
+}
+export interface PipelineBuilder {
+    version(v: string): PipelineBuilder;
+    description(d: string): PipelineBuilder;
+    key<E>(name: string, extractor: (event: E) => string): PipelineBuilder;
+    on(eventType: string): TriggerBuilder;
+    settled(commandTypes: readonly string[]): SettledBuilder;
+    build(): Pipeline;
+}
+export interface DispatchOptions<D extends readonly string[] = readonly string[]> {
+    dispatches: D;
+}
+export interface SettledBuilder {
+    dispatch<const D extends readonly string[]>(options: DispatchOptions<D>, handler: (events: Record<string, Event[]>, send: (commandType: D[number], data: unknown) => void) => void | {
+        persist: boolean;
+    }): SettledChain;
+}
+export interface SettledChain {
+    on(eventType: string): TriggerBuilder;
+    settled(commandTypes: readonly string[]): SettledBuilder;
+    build(): Pipeline;
+}
+export interface HandleOptions {
+    emits?: string[];
+}
+export interface TriggerBuilder {
+    when<E>(predicate: (event: E) => boolean): TriggerBuilder;
+    emit(commandType: string, data: unknown): EmitChain;
+    run(commands: CommandDispatch[]): RunBuilder;
+    run<E>(factory: (event: E) => CommandDispatch[]): RunBuilder;
+    forEach<E, T>(itemsSelector: (event: E) => T[]): ForEachBuilder<T>;
+    handle<E>(handler: (event: E, ctx: PipelineContext) => void | Promise<void>, options?: HandleOptions): HandleChain;
+}
+export interface ForEachBuilder<T> {
+    groupInto<P extends string>(phases: readonly P[], classifier: (item: T) => P): PhasedBuilder<T>;
+}
+export interface PhasedBuilder<T> {
+    process(commandType: string, dataFactory: (item: T) => Record<string, unknown>): PhasedChain<T>;
+}
+export interface CompletionConfig {
+    success: string;
+    failure: string;
+    itemKey: (event: Event) => string;
+}
+export interface PhasedChain<T> {
+    stopOnFailure(): PhasedChain<T>;
+    onComplete(config: CompletionConfig): PhasedTerminal;
+    build(): Pipeline;
+}
+export interface PhasedTerminal {
+    on(eventType: string): TriggerBuilder;
+    build(): Pipeline;
+}
+export interface RunBuilder {
+    awaitAll<E>(keyName: string, keyExtractor: (event: E) => string, options?: {
+        timeout?: number;
+    }): GatherBuilder;
+}
+export interface GatherBuilder {
+    onSuccess<T = unknown>(eventType: string, dataFactory: (ctx: SuccessContext<T>) => Record<string, unknown>): GatherChain;
+    onFailure<T = unknown>(eventType: string, dataFactory: (ctx: FailureContext<T>) => Record<string, unknown>): GatherChain;
+    on(eventType: string): TriggerBuilder;
+    build(): Pipeline;
+}
+export interface GatherChain {
+    onSuccess<T = unknown>(eventType: string, dataFactory: (ctx: SuccessContext<T>) => Record<string, unknown>): GatherChain;
+    onFailure<T = unknown>(eventType: string, dataFactory: (ctx: FailureContext<T>) => Record<string, unknown>): GatherChain;
+    on(eventType: string): TriggerBuilder;
+    build(): Pipeline;
+}
+export interface EmitChain {
+    emit(commandType: string, data: unknown): EmitChain;
+    on(eventType: string): TriggerBuilder;
+    settled(commandTypes: readonly string[]): SettledBuilder;
+    build(): Pipeline;
+}
+export interface HandleChain {
+    on(eventType: string): TriggerBuilder;
+    build(): Pipeline;
+}
+export declare function define(name: string): PipelineBuilder;
+//# sourceMappingURL=define.d.ts.map

package/dist/src/builder/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/builder/define.ts"],"names":[],"mappings":"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"}