@outfitter/kit 0.2.1 → 0.2.2

package/README.md

@@ -1,130 +1,60 @@
 # @outfitter/kit
 
-Version coordination meta-package for Outfitter.
+Foundation facade for Outfitter.
 
-## Purpose
+`@outfitter/kit` provides a single foundation entrypoint over:
 
-This package ensures compatible versions across all `@outfitter/*` packages. Install it alongside specific packages to get coordinated version constraints via `peerDependencies`.
+- `@outfitter/contracts`
+- `@outfitter/types`
 
-## Installation
+Runtime and transport packages (`@outfitter/cli`, `@outfitter/mcp`, etc.) remain explicit dependencies.
+
+## Install
 
 ```bash
 bun add @outfitter/kit
 ```
 
-## When to Use
+## Root Facade
 
-Use `@outfitter/kit` when:
+The root entrypoint re-exports the contracts surface and exposes types under a namespace.
 
-1. **Building applications** that use multiple Outfitter packages
-2. **Ensuring compatibility** between package versions
-3. **Checking version requirements** programmatically
+```typescript
+import { Result, ValidationError, Types } from "@outfitter/kit";
 
-```bash
-# Install stack alongside the packages you need
-bun add @outfitter/kit @outfitter/cli @outfitter/logging @outfitter/config
+const value = Result.ok({ id: Types.shortId() });
 ```
 
-The stack's `peerDependencies` will warn if you have incompatible versions installed.
-
-## Version Matrix
-
-See [VERSIONS.md](./VERSIONS.md) for the complete compatibility matrix.
-
-### Current Release (0.1.0-rc.1)
+## Foundation Subpaths
 
-| Package | Minimum Version |
-|---------|-----------------|
-| @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/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 |
+Use subpaths when you want explicit import intent.
 
-## Exports
-
-### STACK_VERSION
-
-The current stack version (matches package.json).
+### Contracts
 
 ```typescript
-import { STACK_VERSION } from "@outfitter/kit";
-
-console.log(`Using Outfitter Stack ${STACK_VERSION}`);
+import { Result, createLoggerFactory } from "@outfitter/kit/foundation/contracts";
 ```
 
-### MINIMUM_VERSIONS
-
-Minimum compatible versions for each package.
+### Types
 
 ```typescript
-import { MINIMUM_VERSIONS } from "@outfitter/kit";
-
-// Check if a package meets the minimum version
-const cliMinimum = MINIMUM_VERSIONS["@outfitter/cli"]; // "0.1.0-rc.0"
+import { shortId, isDefined } from "@outfitter/kit/foundation/types";
 ```
 
-### OutfitterPackage
-
-Type for valid package names in the stack.
+### Aggregate Foundation
 
 ```typescript
-import { type OutfitterPackage, MINIMUM_VERSIONS } from "@outfitter/kit";
-
-function getMinVersion(pkg: OutfitterPackage): string {
-  return MINIMUM_VERSIONS[pkg];
-}
-
-getMinVersion("@outfitter/cli"); // "0.1.0-rc.0"
-getMinVersion("@outfitter/invalid"); // TypeScript error
+import { Result, Types } from "@outfitter/kit/foundation";
 ```
 
-## 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
+## What Kit Does Not Hide
 
-### Runtime (warm)
-Expected to evolve:
-- `@outfitter/cli` - CLI framework (includes terminal rendering)
-- `@outfitter/config` - Configuration
-- `@outfitter/logging` - Structured logging
-- `@outfitter/file-ops` - File operations
-- `@outfitter/state` - State management
-- `@outfitter/mcp` - MCP server framework
-- `@outfitter/index` - SQLite FTS5 indexing
-- `@outfitter/daemon` - Daemon lifecycle
+`@outfitter/kit` does not implicitly install or expose runtime transports.
+Keep transport dependencies explicit in your app:
 
-### Tooling (lukewarm)
-Workflow-focused:
-- `@outfitter/testing` - Test harnesses
-
-## Related Packages
-
-All `@outfitter/*` packages are designed to work together. See individual package documentation:
-
-- [@outfitter/contracts](../contracts/README.md) - Result types and error patterns
-- [@outfitter/cli](../cli/README.md) - CLI framework
-- [@outfitter/daemon](../daemon/README.md) - Daemon lifecycle management
-- [@outfitter/testing](../testing/README.md) - Test harnesses
+```bash
+bun add @outfitter/kit @outfitter/cli @outfitter/mcp
+```
 
 ## License
 

package/dist/foundation/contracts.d.ts

@@ -0,0 +1 @@
+export * from "@outfitter/contracts";

package/dist/foundation/contracts.js

@@ -0,0 +1,3 @@
+// @bun
+// packages/kit/src/foundation/contracts.ts
+export * from "@outfitter/contracts";

package/dist/foundation/index.d.ts

@@ -0,0 +1,3 @@
+export * from "@outfitter/contracts";
+import * as Types from "@outfitter/types";
+export { Types };

package/dist/foundation/index.js

@@ -0,0 +1,7 @@
+// @bun
+// packages/kit/src/foundation/index.ts
+export * from "@outfitter/contracts";
+import * as Types from "@outfitter/types";
+export {
+  Types
+};

package/dist/foundation/types.d.ts

@@ -0,0 +1 @@
+export * from "@outfitter/types";

package/dist/foundation/types.js

@@ -0,0 +1,3 @@
+// @bun
+// packages/kit/src/foundation/types.ts
+export * from "@outfitter/types";

package/dist/index.d.ts

@@ -1,33 +1,3 @@
-/**
-* @outfitter/kit - Version coordination meta-package
-*
-* This package coordinates versions across all @outfitter packages.
-* Install it alongside specific packages to ensure compatible versions.
-*
-* @packageDocumentation
-*/
-/**
-* Stack version - matches package.json version
-*/
-declare const STACK_VERSION = "0.1.0-rc.1";
-/**
-* Minimum compatible versions for each package
-*/
-declare const MINIMUM_VERSIONS: {
-	readonly "@outfitter/cli": "0.1.0-rc.1";
-	readonly "@outfitter/config": "0.1.0-rc.1";
-	readonly "@outfitter/contracts": "0.1.0-rc.1";
-	readonly "@outfitter/daemon": "0.1.0-rc.1";
-	readonly "@outfitter/file-ops": "0.1.0-rc.1";
-	readonly "@outfitter/index": "0.1.0-rc.1";
-	readonly "@outfitter/logging": "0.1.0-rc.1";
-	readonly "@outfitter/mcp": "0.1.0-rc.1";
-	readonly "@outfitter/state": "0.1.0-rc.1";
-	readonly "@outfitter/testing": "0.1.0-rc.1";
-	readonly "@outfitter/types": "0.1.0-rc.1";
-};
-/**
-* Type for package names in the stack
-*/
-type OutfitterPackage = keyof typeof MINIMUM_VERSIONS;
-export { STACK_VERSION, OutfitterPackage, MINIMUM_VERSIONS };
+export * from "@outfitter/contracts";
+import * as Types from "@outfitter/types";
+export { Types };

package/dist/index.js

@@ -1,20 +1,7 @@
 // @bun
 // packages/kit/src/index.ts
-var STACK_VERSION = "0.1.0-rc.1";
-var MINIMUM_VERSIONS = {
-  "@outfitter/cli": "0.1.0-rc.1",
-  "@outfitter/config": "0.1.0-rc.1",
-  "@outfitter/contracts": "0.1.0-rc.1",
-  "@outfitter/daemon": "0.1.0-rc.1",
-  "@outfitter/file-ops": "0.1.0-rc.1",
-  "@outfitter/index": "0.1.0-rc.1",
-  "@outfitter/logging": "0.1.0-rc.1",
-  "@outfitter/mcp": "0.1.0-rc.1",
-  "@outfitter/state": "0.1.0-rc.1",
-  "@outfitter/testing": "0.1.0-rc.1",
-  "@outfitter/types": "0.1.0-rc.1"
-};
+export * from "@outfitter/contracts";
+import * as Types from "@outfitter/types";
 export {
-  STACK_VERSION,
-  MINIMUM_VERSIONS
+  Types
 };

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@outfitter/kit",
-  "description": "Version coordination meta-package for Outfitter",
-  "version": "0.2.1",
+  "description": "Foundation facade for Outfitter contracts and types",
+  "version": "0.2.2",
   "type": "module",
   "files": [
     "dist",
-    "VERSIONS.md",
     "shared/migrations"
   ],
   "module": "./dist/index.js",
@@ -17,62 +16,33 @@
         "default": "./dist/index.js"
       }
     },
-    "./package.json": "./package.json"
-  },
-  "peerDependencies": {
-    "@outfitter/cli": ">=0.1.0",
-    "@outfitter/config": ">=0.1.0",
-    "@outfitter/contracts": ">=0.1.0",
-    "@outfitter/daemon": ">=0.1.0",
-    "@outfitter/file-ops": ">=0.1.0",
-    "@outfitter/index": ">=0.1.0",
-    "@outfitter/logging": ">=0.1.0",
-    "@outfitter/mcp": ">=0.1.0",
-    "@outfitter/state": ">=0.1.0",
-    "@outfitter/testing": ">=0.1.0",
-    "@outfitter/types": ">=0.1.0",
-    "@outfitter/ui": ">=0.1.0-rc.1"
-  },
-  "peerDependenciesMeta": {
-    "@outfitter/cli": {
-      "optional": true
-    },
-    "@outfitter/config": {
-      "optional": true
-    },
-    "@outfitter/contracts": {
-      "optional": true
-    },
-    "@outfitter/daemon": {
-      "optional": true
-    },
-    "@outfitter/file-ops": {
-      "optional": true
-    },
-    "@outfitter/index": {
-      "optional": true
-    },
-    "@outfitter/logging": {
-      "optional": true
-    },
-    "@outfitter/mcp": {
-      "optional": true
-    },
-    "@outfitter/state": {
-      "optional": true
+    "./foundation/contracts": {
+      "import": {
+        "types": "./dist/foundation/contracts.d.ts",
+        "default": "./dist/foundation/contracts.js"
+      }
     },
-    "@outfitter/testing": {
-      "optional": true
+    "./foundation/types": {
+      "import": {
+        "types": "./dist/foundation/types.d.ts",
+        "default": "./dist/foundation/types.js"
+      }
     },
-    "@outfitter/types": {
-      "optional": true
+    "./foundation": {
+      "import": {
+        "types": "./dist/foundation/index.d.ts",
+        "default": "./dist/foundation/index.js"
+      }
     },
-    "@outfitter/ui": {
-      "optional": true
-    }
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@outfitter/contracts": "0.2.0",
+    "@outfitter/types": "0.2.0"
   },
   "scripts": {
-    "build": "bun run sync:migrations && bunup --filter @outfitter/kit",
+    "build": "bun run sync:migrations && cd ../.. && bunup --filter @outfitter/kit",
+    "test": "bun test",
     "typecheck": "tsc --noEmit",
     "sync:migrations": "bun run ../../scripts/sync-migrations.ts",
     "prepack": "bun run sync:migrations"

package/VERSIONS.md

@@ -1,38 +0,0 @@
-# Version Compatibility Matrix
-
-This document tracks version compatibility across @outfitter packages.
-
-## Current Release
-
-| Package | Version | Status |
-|---------|---------|--------|
-| @outfitter/contracts | 0.1.0-rc.0 | RC |
-| @outfitter/types | 0.1.0-rc.0 | RC |
-| @outfitter/cli | 0.1.0-rc.0 | RC |
-| @outfitter/config | 0.1.0-rc.0 | RC |
-| @outfitter/logging | 0.1.0-rc.0 | RC |
-| @outfitter/file-ops | 0.1.0-rc.0 | RC |
-| @outfitter/state | 0.1.0-rc.0 | RC |
-| @outfitter/mcp | 0.1.0-rc.0 | RC |
-| @outfitter/index | 0.1.0-rc.0 | RC |
-| @outfitter/daemon | 0.1.0-rc.0 | RC |
-| @outfitter/testing | 0.1.0-rc.0 | RC |
-
-## Dependency Tiers
-
-### Foundation (cold)
-- `@outfitter/contracts` - Result/Error patterns
-- `@outfitter/types` - Branded types
-
-### Runtime (warm)
-- `@outfitter/cli` - CLI framework (includes terminal rendering)
-- `@outfitter/config` - Configuration
-- `@outfitter/logging` - Structured logging
-- `@outfitter/file-ops` - File operations
-- `@outfitter/state` - State management
-- `@outfitter/mcp` - MCP server framework
-- `@outfitter/index` - SQLite FTS5 indexing
-- `@outfitter/daemon` - Daemon lifecycle
-
-### Tooling (lukewarm)
-- `@outfitter/testing` - Test harnesses