@outfitter/stack

Version coordination meta-package for Outfitter.

Purpose

This package ensures compatible versions across all @outfitter/* packages. Install it alongside specific packages to get coordinated version constraints via peerDependencies.

Installation

bun add @outfitter/stack

When to Use

Use @outfitter/stack when:

1. Building applications that use multiple Outfitter packages
2. Ensuring compatibility between package versions
3. Checking version requirements programmatically

# Install stack alongside the packages you need
bun add @outfitter/stack @outfitter/cli @outfitter/logging @outfitter/config

The stack's peerDependencies will warn if you have incompatible versions installed.

Version Matrix

See VERSIONS.md for the complete compatibility matrix.

Current Release (0.1.0-rc.1)

| Package | Minimum Version | |---------|-----------------| | @outfitter/agents | 0.1.0-rc.1 | | @outfitter/contracts | 0.1.0-rc.1 | | @outfitter/types | 0.1.0-rc.1 | | @outfitter/cli | 0.1.0-rc.1 | | @outfitter/config | 0.1.0-rc.1 | | @outfitter/logging | 0.1.0-rc.1 | | @outfitter/file-ops | 0.1.0-rc.1 | | @outfitter/state | 0.1.0-rc.1 | | @outfitter/ui | 0.1.0-rc.1 | | @outfitter/mcp | 0.1.0-rc.1 | | @outfitter/index | 0.1.0-rc.1 | | @outfitter/daemon | 0.1.0-rc.1 | | @outfitter/testing | 0.1.0-rc.1 |

Exports

STACK_VERSION

The current stack version (matches package.json).

import { STACK_VERSION } from "@outfitter/stack";

console.log(`Using Outfitter Stack ${STACK_VERSION}`);

MINIMUM_VERSIONS

Minimum compatible versions for each package.

import { MINIMUM_VERSIONS } from "@outfitter/stack";

// Check if a package meets the minimum version
const cliMinimum = MINIMUM_VERSIONS["@outfitter/cli"]; // "0.1.0-rc.0"

OutfitterPackage

Type for valid package names in the stack.

import { type OutfitterPackage, MINIMUM_VERSIONS } from "@outfitter/stack";

function getMinVersion(pkg: OutfitterPackage): string {
  return MINIMUM_VERSIONS[pkg];
}

getMinVersion("@outfitter/cli"); // "0.1.0-rc.0"
getMinVersion("@outfitter/invalid"); // TypeScript error

API Reference

| Export | Type | Description | |--------|------|-------------| | STACK_VERSION | string | Current stack version | | MINIMUM_VERSIONS | Record<OutfitterPackage, string> | Minimum versions for all packages | | OutfitterPackage | type | Union type of valid package names |

Dependency Tiers

Packages are organized into tiers based on stability:

Foundation (cold)

Stable APIs, rarely change:

• @outfitter/contracts - Result/Error patterns
• @outfitter/types - Branded types

Runtime (warm)

Expected to evolve:

• @outfitter/cli - CLI framework
• @outfitter/config - Configuration
• @outfitter/logging - Structured logging
• @outfitter/file-ops - File operations
• @outfitter/state - State management
• @outfitter/ui - Terminal UI
• @outfitter/mcp - MCP server framework
• @outfitter/index - SQLite FTS5 indexing
• @outfitter/daemon - Daemon lifecycle

Tooling (lukewarm)

Workflow-focused:

• @outfitter/testing - Test harnesses

Related Packages

All @outfitter/* packages are designed to work together. See individual package documentation:

• @outfitter/contracts - Result types and error patterns
• @outfitter/cli - CLI framework
• @outfitter/daemon - Daemon lifecycle management
• @outfitter/testing - Test harnesses

License

MIT