feat(daemon): add types and lifecycle management

[galligan]

Add daemon process management infrastructure:

• DaemonError: TaggedError for daemon failures
• DaemonState: running, stopped, starting, stopping
• DaemonOptions: PID file, signal handlers, cleanup hooks
• Daemon interface: start, stop, status, isRunning
• createDaemon() factory with PID file management
• Graceful signal handling (SIGTERM, SIGINT)

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

Contributes to #56

[galligan]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• chore(outfitter): sync templates on pack #108
• chore(changesets): ignore app package #107
• fix(errors): avoid TaggedError extends warnings #106
• chore(release): align package versions to 0.1.0 #105
• docs: add README and CHANGELOG for testing, kit, outfitter #95
• feat(templates): add daemon project template #94
• feat(templates): add MCP server project template #93
• feat(templates): add CLI project template #92
• fix(cli): implement confirmDestructive prompts #104
• fix(cli): implement createCLI and command builder #103
• feat(kit): add @outfitter/kit meta-package #91
• docs(daemon): add README and CHANGELOG #90
• fix(daemon): fix locking module bugs (GREEN phase) #89
• test(daemon): add locking module tests (RED phase) #88
• feat(daemon): add errors, platform, and locking module stubs #87
• feat(outfitter): add doctor command for environment validation #86
• feat(outfitter): add init command with project scaffolding #85
• feat(daemon): add IPC communication and health checks #84
• feat(daemon): add types and lifecycle management #83 👈 (View in Graphite)
• feat(index): add FTS5 full-text search implementation #82
• feat(index): add types for FTS5 full-text search #81
• feat(testing): add MCP and CLI test harnesses #80
• feat(testing): add test fixture utilities #79
• feat(mcp): add MCP server implementation with typed handlers #78
• feat(mcp): add types and interfaces for MCP server #77
• feat(ui): add Shape discriminated union and render() #76
• feat(ui): add createTokens semantic color layer #75
• feat(state): add pagination helpers #74
• feat(logging): add DEFAULT_PATTERNS for common secret redaction #73
• feat(ui): add formatRelative() for human-readable timestamps #72
• feat(state): add encodeCursor/decodeCursor for pagination #71
• feat(types): add hashId() for deterministic short identifiers #70
• feat(contracts): add Logger.child() and fix AssertionError category #69
• feat(config): centralize environment variable access with Zod validation #42
• fix(logging): enable redaction by default when global rules exist #41
• docs(ui): add README, CHANGELOG, and TSDoc comments #39
• docs(state): add README, CHANGELOG, and TSDoc comments #38
• docs(file-ops): add README, CHANGELOG, and TSDoc comments #37
• docs(logging): add README, CHANGELOG, and TSDoc comments #36
• docs(config): add README, CHANGELOG, and TSDoc comments #35
• fix(cli): enforce cursor TTL #114
• fix(tests): remove placeholder tests #113
• chore(gitattributes): prefer ours for bun lockfiles #115
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Summary

• Adds the @outfitter/daemon package implementing daemon lifecycle management with PID file handling, signal processing, and graceful shutdown capabilities
• Introduces comprehensive type system with DaemonError using TaggedError pattern, DaemonState enum for process states, and interfaces for daemon configuration and control
• Implements createDaemon() factory function with finite state machine, re-entry protection during shutdown, and integration with existing foundation packages

Important Files Changed

Filename	Overview
packages/daemon/src/lifecycle.ts	New daemon implementation with PID file management, signal handling, and graceful shutdown with timeout protection
packages/daemon/src/types.ts	New comprehensive type definitions including DaemonError, DaemonState enum, and daemon interfaces

Confidence score: 4/5

• This PR introduces well-structured daemon lifecycle management with proper error handling and follows established repository patterns
• Score reflects solid implementation but potential complexity in concurrent shutdown scenarios and signal handler cleanup timing
• Pay close attention to packages/daemon/src/lifecycle.ts for shutdown re-entry logic and signal handler management

Sequence Diagram

sequenceDiagram
    participant User
    participant Daemon
    participant PIDFile as "PID File System"
    participant SignalHandler as "Signal Handler"
    participant ShutdownHandler as "Shutdown Handler"

    User->>Daemon: "start()"
    Daemon->>Daemon: "Check if already running"
    Daemon->>PIDFile: "Check if PID file exists"
    PIDFile-->>Daemon: "File status"
    Daemon->>PIDFile: "Write PID file"
    PIDFile-->>Daemon: "Success"
    Daemon->>SignalHandler: "Register SIGTERM/SIGINT handlers"
    SignalHandler-->>Daemon: "Handlers registered"
    Daemon-->>User: "Result.ok()"

    Note over Daemon: Daemon is now running

    User->>Daemon: "onShutdown(handler)"
    Daemon->>Daemon: "Add to shutdown handlers list"

    SignalHandler->>Daemon: "SIGTERM/SIGINT received"
    Daemon->>Daemon: "Set state to stopping"
    Daemon->>ShutdownHandler: "Run all registered handlers"
    ShutdownHandler-->>Daemon: "Handlers completed"
    Daemon->>SignalHandler: "Remove signal handlers"
    Daemon->>PIDFile: "Remove PID file"
    PIDFile-->>Daemon: "File removed"
    Daemon->>Daemon: "Set state to stopped"

    User->>Daemon: "stop()"
    Daemon->>Daemon: "Check if running"
    Daemon->>ShutdownHandler: "Run all registered handlers"
    ShutdownHandler-->>Daemon: "Handlers completed"
    Daemon->>SignalHandler: "Remove signal handlers"
    Daemon->>PIDFile: "Remove PID file"
    PIDFile-->>Daemon: "File removed"
    Daemon-->>User: "Result.ok()"

Loading

[galligan]

Added a root entrypoint for @outfitter/daemon (exports types + createDaemon) and a basic smoke test so bun test no longer fails on empty suites. Also resolved the restack conflict to keep the IPC/health exports in index.ts.

[galligan]

Restacked after downstack update (formatRelative test stabilization); no additional changes in this PR.