@adamancyzhang/claude-orchestrator 0.4.0 → 0.4.1

package/README.md

@@ -73,7 +73,7 @@ Type a requirement in the TUI input line and press Enter. The Leader forwards it
 # CLI commands (from any terminal)
 claude-orchestrator push-task --title "Implement login endpoint" --priority 0
 claude-orchestrator send-message --to-name Jerry --content "Starting on the auth module?"
-claude-orchestrator list-tasks --status pending
+claude-orchestrator poll-task --status pending
 ```
 
 ---
@@ -84,7 +84,7 @@ claude-orchestrator list-tasks --status pending
 
 | Component | What it does | ZK magic |
 |-----------|-------------|----------|
-| **Leader** | Read-only TUI, mechanical message/task routing, merge validation, orphan recovery. No AI calls. | `/leader` EPHEMERAL — exactly one Leader |
+| **Leader** | Read-only TUI, mechanical message/task routing, merge validation, orphan recovery. Self-processes decompose via claude-cli when template available; otherwise forwards to Planner. | `/leader` EPHEMERAL — exactly one Leader |
 | **Worker** | Isolated git worktree, ZK watch loop, auto-processes messages via `claude -p`, self-evaluates output, auto-commits changes | EPHEMERAL nodes → auto-cleanup on disconnect |
 | **Task Queue** | Push → Claim → Complete (or Block/Fail/Retry). Role-link priority sorting. | Sequential nodes for FIFO, ephemeral claims for atomic locks |
 | **Message Router** | Point-to-point messaging via ZK watches | Persistent-sequential nodes, push notification |
@@ -99,7 +99,7 @@ Each Worker runs in its own `git worktree` under `.claude-orchestrator/worktree/
 
 ### CLI-Native — Zero MCP Server
 
-Leader and Workers each connect directly to ZooKeeper. The Leader is a pure router: forwards requirements, creates tasks from ChainDef JSON, mechanically executes EvalDecision JSON. All AI intelligence runs exclusively on Workers via `claude -p`. No HTTP, no SSE, no MCP protocol.
+Leader and Workers each connect directly to ZooKeeper. The Leader is primarily a router: self-processes decompose when template available (otherwise forwards to Planner), creates tasks from ChainDef JSON, mechanically executes EvalDecision JSON. All other AI intelligence runs on Workers via `claude -p`. No HTTP, no SSE, no MCP protocol.
 
 ### Responsibility Chain
 
@@ -120,7 +120,7 @@ Each link is a dedicated role. One Worker produces, the next Worker verifies —
 | `push-task` | Create a task (optionally assign to someone) |
 | `claim-task` | Grab the next task — atomic, no two instances can claim the same one |
 | `complete-task` | Mark a task done with results |
-| `list-tasks` | List tasks by status |
+| `poll-task` | List tasks, optionally filtered by status |
 | `task-block` | Mark a claimed task as blocked (with reason) |
 | `task-fail` | Mark a claimed task as failed (with reason) |
 | `task-retry` | Re-queue a failed task (retry_count + 1, max 3) |
@@ -249,7 +249,7 @@ node dist/index.js run --worker 3
 ### Run Tests
 
 ```bash
-npm test                    # All unit tests (110+)
+npm test                    # Run all tests
 npm run test:watch          # Watch mode
 npx vitest run tests/unit/worker-prompt-rendering.test.ts  # Prompt rendering verification
 ```
@@ -267,14 +267,15 @@ npx vitest run tests/unit/worker-prompt-rendering.test.ts  # Prompt rendering ve
 │   ├── leader/                    # Leader node
 │   │   ├── index.ts               #   Startup / shutdown orchestration
 │   │   ├── tui.ts                 #   ANSI TUI with Worker Messages panel
-│   │   ├── event-bus.ts           #   Typed EventEmitter (15 events)
+│   │   ├── event-bus.ts           #   Typed EventEmitter (17 events)
 │   │   ├── state.ts               #   Centralized LeaderState
 │   │   ├── monitor.ts             #   WorkerMonitor — join/leave detection
 │   │   ├── orchestrator.ts        #   TaskOrchestrator — lifecycle tracking
 │   │   ├── recovery.ts            #   TaskRecovery — orphan recovery (max 3 retries)
 │   │   ├── watcher.ts             #   LeaderWatcher — message processing
-│   │   ├── chain-router.ts        #   ChainRouter — mechanical routing (no AI)
-│   │   └── merge-validator.ts     #   Cross-verify + merge worker branches
+│   │   ├── chain-router.ts        #   ChainRouter — mechanical routing (self or forward decompose)
+│   │   ├── merge-validator.ts     #   Cross-verify + merge worker branches
+│   │   └── stream-tailer.ts       #   StreamTailer — live worker log display
 │   ├── worker/                    # Worker node
 │   │   ├── worktree-initializer.ts#   Name generation, worktree creation, role assignment
 │   │   ├── child.ts               #   Child process entry point
@@ -287,16 +288,21 @@ npx vitest run tests/unit/worker-prompt-rendering.test.ts  # Prompt rendering ve
 │   │   └── runner.ts              #   ClaudeRunner — CLI execution wrapper
 │   ├── zk/
 │   │   ├── client.ts              # ZooKeeper connection management
-│   │   └── paths.ts               # ZK path constants
+│   │   ├── paths.ts               # ZK path constants
+│   │   └── watcher.ts             # ZK watch callback wrapper
 │   ├── modules/
 │   │   ├── registry.ts            # Instance registry
 │   │   ├── task-queue.ts          # Task queue (push/claim/complete/block/fail/retry)
 │   │   └── message-router.ts      # Message routing + template rendering
+│   ├── hooks/
+│   │   └── engine.ts              # HookEngine — pre/post lifecycle hooks
 │   ├── models/
 │   │   └── schemas.ts             # Zod schemas (Instance, Task, Message, ChainDef, EvalDecision)
 │   └── utils/
-│       ├── exec.ts                # Shell execution (execWithTee)
-│       └── logger.ts              # Tagged logger (+ --debug mode)
+│       ├── exec.ts                # Shell execution (execWithTee, execWithStreaming, execAndCapture)
+│       ├── logger.ts              # Tagged logger (+ --debug mode)
+│       ├── output.ts              # JSON output helper
+│       └── console-capture.ts     # Console redirect to file (for TUI)
 ├── templates/                     # Prompt and memory templates (v0.4)
 │   ├── agents/                    #   7 Worker prompt templates
 │   └── claude-memory/             #   6 CLAUDE.md directory memory templates
@@ -317,9 +323,9 @@ npx vitest run tests/unit/worker-prompt-rendering.test.ts  # Prompt rendering ve
 │   │       └── design.md          #   Worker initialization + directory memory design
 │   └── v0.3/                      #   Archived v0.3 docs
 ├── tests/
-│   ├── unit/                      #   11 test files, 110+ tests
+│   ├── unit/                      #   11 test files
 │   │   └── worker-prompt-rendering.test.ts  # Prompt variable substitution verification
-│   └── integration/               #   Leader-Worker integration tests
+│   └── integration/               #   7 integration test files
 ├── examples-workspace/            # Reference implementation of multi-agent patterns
 ├── docker-compose.yml             # ZooKeeper
 ├── package.json

package/dist/config.d.ts

@@ -14,6 +14,20 @@ export interface HooksConfig {
     worker_message_start?: string | null;
     worker_message_end?: string | null;
 }
+export type StepAction = "created" | "updated" | "replaced" | "skipped" | "rejected" | "completed" | "failed";
+export interface StepRecord {
+    action: StepAction;
+    timestamp: string;
+    reason?: string;
+}
+export interface InitStatus {
+    global_config?: StepRecord;
+    user_claude_md?: StepRecord;
+    team_claude_md?: StepRecord;
+    skills?: Record<string, StepRecord>;
+    worktrees?: Record<string, StepRecord>;
+    npm_install?: Record<string, StepRecord>;
+}
 export interface InstanceConfig {
     instance_id?: string;
     name?: string;
@@ -29,6 +43,7 @@ export interface InstanceConfig {
         branch: string;
         instance_id: string;
     }>;
+    init_status?: InitStatus;
 }
 export interface ResolvedConfig {
     zk: ZkConfig;
@@ -63,4 +78,6 @@ export declare function saveProjectWorktreeConfig(entries: Record<string, Worktr
     branch: string;
     instanceId: string;
 }>): void;
+export declare function loadInitStatus(): InitStatus;
+export declare function saveInitStatusStep(stepId: string, record: StepRecord, subId?: string): void;
 export declare function expandHomeDir(p: string): string;

package/dist/config.js

@@ -13,7 +13,7 @@ function defaultZkConfig() {
     return { url: "127.0.0.1:2181", root_path: "/claude-orchestrator", auth: null };
 }
 function defaultCacheDir() {
-    return "~/.claude-orchestrator/sessions";
+    return ".claude-orchestrator/sessions";
 }
 function defaultCliCommand() {
     return "claude --dangerously-skip-permissions --permission-mode dontAsk";
@@ -32,7 +32,7 @@ export function loadConfig(cliOpts) {
     else if (process.env.ZK_HOSTS) {
         zk.url = process.env.ZK_HOSTS;
     }
-    const cacheDir = global.cache_dir || defaultCacheDir();
+    const cacheDir = path.resolve(process.cwd(), expandHomeDir(global.cache_dir || defaultCacheDir()));
     // Command: project overrides global
     const mergedCommands = project.commands || global.commands;
     const cliCommand = mergedCommands?.["claude-cli"] || defaultCliCommand();
@@ -116,6 +116,24 @@ export function saveProjectWorktreeConfig(entries) {
     }
     saveInstanceConfig({ worktree: record }, false);
 }
+export function loadInitStatus() {
+    const global = loadGlobalConfig();
+    return global.init_status ?? {};
+}
+export function saveInitStatusStep(stepId, record, subId) {
+    const global = loadGlobalConfig();
+    const status = global.init_status ?? {};
+    if (subId) {
+        status[stepId] = {
+            ...status[stepId],
+            [subId]: record,
+        };
+    }
+    else {
+        status[stepId] = record;
+    }
+    saveInstanceConfig({ init_status: status }, true);
+}
 export function expandHomeDir(p) {
     if (p.startsWith("~")) {
         return path.join(os.homedir(), p.slice(1));

package/dist/config.js.map

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

package/dist/email-validator/__tests__/domain.test.d.ts

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

package/dist/email-validator/__tests__/domain.test.js

@@ -0,0 +1,128 @@
+import { describe, it, expect } from "vitest";
+import { validateDomain } from "../domain.js";
+describe("validateDomain", () => {
+    describe("valid hostnames", () => {
+        it("accepts example.com", () => {
+            expect(validateDomain("example.com", false, false)).toEqual([]);
+        });
+        it("accepts subdomain", () => {
+            expect(validateDomain("mail.example.com", false, false)).toEqual([]);
+        });
+        it("accepts multi-level domain", () => {
+            expect(validateDomain("a.b.c.d.e.com", false, false)).toEqual([]);
+        });
+        it("accepts hyphen in middle of label", () => {
+            expect(validateDomain("my-domain.com", false, false)).toEqual([]);
+        });
+        it("accepts digits in labels", () => {
+            expect(validateDomain("example123.com", false, false)).toEqual([]);
+        });
+        it("accepts single-char labels", () => {
+            expect(validateDomain("a.b", false, false)).toEqual([]);
+        });
+        it("accepts 63-char label (boundary)", () => {
+            const label = "a".repeat(63);
+            expect(validateDomain(`${label}.com`, false, false)).toEqual([]);
+        });
+    });
+    describe("valid IP literals", () => {
+        it("accepts IPv4 literal", () => {
+            expect(validateDomain("192.168.1.1", true, false)).toEqual([]);
+        });
+        it("accepts IPv4 with boundary values", () => {
+            expect(validateDomain("0.0.0.0", true, false)).toEqual([]);
+            expect(validateDomain("255.255.255.255", true, false)).toEqual([]);
+        });
+        it("accepts IPv6 literal", () => {
+            expect(validateDomain("2001:db8::1", false, true)).toEqual([]);
+        });
+        it("accepts full IPv6", () => {
+            expect(validateDomain("2001:0db8:0000:0000:0000:0000:0000:0001", false, true)).toEqual([]);
+        });
+        it("accepts IPv6 loopback", () => {
+            expect(validateDomain("::1", false, true)).toEqual([]);
+        });
+        it("accepts IPv6 fe80", () => {
+            expect(validateDomain("fe80::1", false, true)).toEqual([]);
+        });
+    });
+    describe("hostname label errors", () => {
+        it("rejects label starting with hyphen", () => {
+            const errors = validateDomain("example.-domain.com", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_LABEL_HYPHEN_START")).toBe(true);
+        });
+        it("rejects label ending with hyphen", () => {
+            const errors = validateDomain("example.domain-.com", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_LABEL_HYPHEN_END")).toBe(true);
+        });
+        it("rejects empty label (consecutive dots)", () => {
+            const errors = validateDomain("example..com", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_LABEL_EMPTY")).toBe(true);
+        });
+        it("rejects label exceeding 63 chars", () => {
+            const label = "a".repeat(64);
+            const errors = validateDomain(`${label}.com`, false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_LABEL_LENGTH")).toBe(true);
+        });
+        it("rejects invalid char in label", () => {
+            const errors = validateDomain("example.c_m.com", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_INVALID_CHAR")).toBe(true);
+        });
+        it("rejects domain with no dot", () => {
+            const errors = validateDomain("localhost", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_NO_DOT")).toBe(true);
+        });
+        it("rejects numeric TLD", () => {
+            const errors = validateDomain("example.123", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_NUMERIC_TLD")).toBe(true);
+        });
+    });
+    describe("length errors", () => {
+        it("rejects empty domain", () => {
+            const errors = validateDomain("", false, false);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_EMPTY")).toBe(true);
+        });
+        it("rejects domain exceeding 255 chars", () => {
+            const label = "a".repeat(63);
+            const domain = `${label}.${label}.${label}.${label}.${label}`;
+            // That's ~319 chars, > 255
+            const errors = validateDomain(domain, false, false, 255);
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_LENGTH")).toBe(true);
+        });
+        it("accepts with custom max domain length", () => {
+            const domain = "a".repeat(10) + ".b";
+            const errors = validateDomain(domain, false, false, 100);
+            expect(errors.filter((e) => e.code === "ERR_DOMAIN_LENGTH")).toEqual([]);
+        });
+    });
+    describe("IPv4 literal errors", () => {
+        it("rejects invalid octet value (>255)", () => {
+            const errors = validateDomain("256.1.1.1", true, false);
+            expect(errors.some((e) => e.code === "ERR_IPV4_INVALID")).toBe(true);
+        });
+        it("rejects wrong number of octets", () => {
+            const errors = validateDomain("1.2.3", true, false);
+            expect(errors.some((e) => e.code === "ERR_IPV4_INVALID")).toBe(true);
+        });
+        it("rejects non-numeric octet", () => {
+            const errors = validateDomain("abc.1.1.1", true, false);
+            expect(errors.some((e) => e.code === "ERR_IPV4_INVALID")).toBe(true);
+        });
+    });
+    describe("IPv6 literal errors", () => {
+        it("rejects empty IPv6", () => {
+            const errors = validateDomain("", false, true);
+            // Empty domain is caught by the general empty check, which takes precedence
+            expect(errors.some((e) => e.code === "ERR_DOMAIN_EMPTY")).toBe(true);
+        });
+        it("rejects invalid hex chars", () => {
+            const errors = validateDomain("gggg::1", false, true);
+            expect(errors.some((e) => e.code === "ERR_IPV6_INVALID")).toBe(true);
+        });
+        it("rejects too many segments", () => {
+            const errors = validateDomain("1:2:3:4:5:6:7:8:9", false, true);
+            expect(errors.some((e) => e.code === "ERR_IPV6_INVALID")).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=domain.test.js.map

package/dist/email-validator/__tests__/domain.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.test.js","sourceRoot":"","sources":["../../../src/email-validator/__tests__/domain.test.ts"],"names":[],"mappings":"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"}

package/dist/email-validator/__tests__/local-part.test.d.ts

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

package/dist/email-validator/__tests__/local-part.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect } from "vitest";
+import { validateLocalPart } from "../local-part.js";
+describe("validateLocalPart", () => {
+    describe("valid dot-atom", () => {
+        it("accepts simple alphanumeric", () => {
+            expect(validateLocalPart("user")).toEqual([]);
+        });
+        it("accepts single character", () => {
+            expect(validateLocalPart("a")).toEqual([]);
+        });
+        it("accepts all allowed special characters", () => {
+            expect(validateLocalPart("a!#$%&'*+-/=?^_`{|}~z")).toEqual([]);
+        });
+        it("accepts dot in middle", () => {
+            expect(validateLocalPart("first.last")).toEqual([]);
+        });
+        it("accepts multiple dots", () => {
+            expect(validateLocalPart("a.b.c")).toEqual([]);
+        });
+        it("accepts digits", () => {
+            expect(validateLocalPart("user123")).toEqual([]);
+        });
+        it("accepts plus sign (common alias)", () => {
+            expect(validateLocalPart("user+tag")).toEqual([]);
+        });
+        it("accepts 64-char local part", () => {
+            const lp = "a".repeat(64);
+            expect(validateLocalPart(lp)).toEqual([]);
+        });
+    });
+    describe("valid quoted strings", () => {
+        it("accepts quoted string with spaces", () => {
+            expect(validateLocalPart('"hello world"')).toEqual([]);
+        });
+        it("accepts quoted string with special chars", () => {
+            expect(validateLocalPart('"john@doe"')).toEqual([]);
+        });
+        it("accepts quoted string with escaped chars", () => {
+            expect(validateLocalPart('"escaped \\" quote"')).toEqual([]);
+        });
+        it("accepts empty quoted string", () => {
+            expect(validateLocalPart('""')).toEqual([]);
+        });
+    });
+    describe("dot-atom errors", () => {
+        it("rejects leading dot", () => {
+            const errors = validateLocalPart(".user");
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_DOT_START")).toBe(true);
+        });
+        it("rejects trailing dot", () => {
+            const errors = validateLocalPart("user.");
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_DOT_END")).toBe(true);
+        });
+        it("rejects consecutive dots", () => {
+            const errors = validateLocalPart("user..name");
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_CONSECUTIVE_DOTS")).toBe(true);
+        });
+        it("rejects invalid char (space)", () => {
+            const errors = validateLocalPart("user name");
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_INVALID_CHAR")).toBe(true);
+        });
+        it("rejects invalid char (angle bracket)", () => {
+            const errors = validateLocalPart("<user>");
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_INVALID_CHAR")).toBe(true);
+        });
+    });
+    describe("length errors", () => {
+        it("rejects empty local part", () => {
+            const errors = validateLocalPart("");
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_EMPTY")).toBe(true);
+        });
+        it("rejects local part exceeding default 64 chars", () => {
+            const lp = "a".repeat(65);
+            const errors = validateLocalPart(lp);
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_LENGTH")).toBe(true);
+        });
+        it("accepts with custom max length", () => {
+            const lp = "a".repeat(10);
+            const errors = validateLocalPart(lp, 10);
+            expect(errors).toEqual([]);
+        });
+        it("rejects with custom max length exceeded", () => {
+            const lp = "a".repeat(11);
+            const errors = validateLocalPart(lp, 10);
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_LENGTH")).toBe(true);
+        });
+    });
+    describe("quoted string errors", () => {
+        it("rejects unbalanced quotes", () => {
+            const errors = validateLocalPart('"unbalanced');
+            // Falls through to dot-atom validation since it doesn't start+end with quotes
+            expect(errors.some((e) => e.code === "ERR_LOCAL_PART_INVALID_CHAR")).toBe(true);
+        });
+        it("rejects quote in middle of quoted string", () => {
+            const errors = validateLocalPart('"hello"world"');
+            expect(errors.some((e) => e.code === "ERR_UNBALANCED_QUOTES")).toBe(true);
+        });
+    });
+    describe("edge cases", () => {
+        it("multiple errors for dot-only local part", () => {
+            const errors = validateLocalPart(".");
+            expect(errors.length).toBeGreaterThanOrEqual(1);
+        });
+        it("multiple errors for double-dot-only", () => {
+            const errors = validateLocalPart("..");
+            expect(errors.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+});
+//# sourceMappingURL=local-part.test.js.map

package/dist/email-validator/__tests__/local-part.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-part.test.js","sourceRoot":"","sources":["../../../src/email-validator/__tests__/local-part.test.ts"],"names":[],"mappings":"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"}

package/dist/email-validator/__tests__/parser.test.d.ts

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

package/dist/email-validator/__tests__/parser.test.js

@@ -0,0 +1,161 @@
+import { describe, it, expect } from "vitest";
+import { parseEmail } from "../parser.js";
+const defaults = { allowDisplayName: true, allowComments: false };
+describe("parseEmail", () => {
+    describe("simple addr-spec", () => {
+        it("parses user@domain.com", () => {
+            const r = parseEmail("user@domain.com", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("user");
+                expect(r.value.domain).toBe("domain.com");
+                expect(r.value.displayName).toBeNull();
+                expect(r.value.isIpLiteral).toBe(false);
+                expect(r.value.isIPv6).toBe(false);
+            }
+        });
+        it("parses a@b.c (minimal)", () => {
+            const r = parseEmail("a@b.c", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("a");
+                expect(r.value.domain).toBe("b.c");
+            }
+        });
+        it("parses addr-spec with subdomain", () => {
+            const r = parseEmail("user@mail.example.co.uk", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("user");
+                expect(r.value.domain).toBe("mail.example.co.uk");
+            }
+        });
+    });
+    describe("display name", () => {
+        it("extracts display name from angle-bracket form", () => {
+            const r = parseEmail("John Doe <john@example.com>", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("john");
+                expect(r.value.domain).toBe("example.com");
+                expect(r.value.displayName).toBe("John Doe");
+            }
+        });
+        it("returns null display name when not present", () => {
+            const r = parseEmail("user@domain.com", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.displayName).toBeNull();
+            }
+        });
+        it("ignores display name when disabled", () => {
+            const r = parseEmail("John <john@example.com>", { allowDisplayName: false });
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("John <john");
+                expect(r.value.domain).toBe("example.com>");
+            }
+        });
+    });
+    describe("comments", () => {
+        it("strips comments when enabled", () => {
+            const r = parseEmail("user(comment)@domain.com", { allowComments: true });
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("user");
+                expect(r.value.domain).toBe("domain.com");
+            }
+        });
+        it("rejects comments when disabled", () => {
+            const r = parseEmail("user(comment)@domain.com", { allowComments: false });
+            expect(r.ok).toBe(false);
+            if (!r.ok) {
+                expect(r.error.code).toBe("ERR_COMMENTS_NOT_ALLOWED");
+            }
+        });
+        it("strips multiple comments", () => {
+            const r = parseEmail("(hello)user(world)@domain.com", { allowComments: true });
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("user");
+            }
+        });
+        it("strips nested comments", () => {
+            const r = parseEmail("user((nested))@domain.com", { allowComments: true });
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("user");
+            }
+        });
+    });
+    describe("IP literals", () => {
+        it("detects IPv4 literal", () => {
+            const r = parseEmail("user@[192.168.1.1]", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.domain).toBe("192.168.1.1");
+                expect(r.value.isIpLiteral).toBe(true);
+                expect(r.value.isIPv6).toBe(false);
+            }
+        });
+        it("detects IPv6 literal", () => {
+            const r = parseEmail("user@[IPv6:2001:db8::1]", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.domain).toBe("2001:db8::1");
+                expect(r.value.isIpLiteral).toBe(true);
+                expect(r.value.isIPv6).toBe(true);
+            }
+        });
+        it("detects IPv6 literal case-insensitively", () => {
+            const r = parseEmail("user@[ipv6:fe80::1]", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.isIPv6).toBe(true);
+                expect(r.value.domain).toBe("fe80::1");
+            }
+        });
+    });
+    describe("error cases", () => {
+        it("ERR_EMPTY_INPUT for empty string", () => {
+            const r = parseEmail("", defaults);
+            expect(r.ok).toBe(false);
+            if (!r.ok)
+                expect(r.error.code).toBe("ERR_EMPTY_INPUT");
+        });
+        it("ERR_EMPTY_INPUT for whitespace-only", () => {
+            const r = parseEmail("   ", defaults);
+            expect(r.ok).toBe(false);
+            if (!r.ok)
+                expect(r.error.code).toBe("ERR_EMPTY_INPUT");
+        });
+        it("ERR_TOTAL_LENGTH for exceeding max", () => {
+            const long = "a".repeat(255) + "@b.c";
+            const r = parseEmail(long, { maxTotalLength: 254 });
+            expect(r.ok).toBe(false);
+            if (!r.ok)
+                expect(r.error.code).toBe("ERR_TOTAL_LENGTH");
+        });
+        it("ERR_NO_AT_SIGN when missing @", () => {
+            const r = parseEmail("not-an-email", defaults);
+            expect(r.ok).toBe(false);
+            if (!r.ok)
+                expect(r.error.code).toBe("ERR_NO_AT_SIGN");
+        });
+        it("ERR_MULTIPLE_AT for double @", () => {
+            const r = parseEmail("a@b@c.com", defaults);
+            expect(r.ok).toBe(false);
+            if (!r.ok)
+                expect(r.error.code).toBe("ERR_MULTIPLE_AT");
+        });
+        it("trims whitespace around input", () => {
+            const r = parseEmail("  user@domain.com  ", defaults);
+            expect(r.ok).toBe(true);
+            if (r.ok) {
+                expect(r.value.localPart).toBe("user");
+                expect(r.value.domain).toBe("domain.com");
+            }
+        });
+    });
+});
+//# sourceMappingURL=parser.test.js.map