@shetty4l/core 0.1.3 → 0.1.9

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@shetty4l/core",
-  "version": "0.1.3",
+  "version": "0.1.9",
   "description": "Shared infrastructure primitives for Bun/TypeScript services",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shetty4l/core"
+  },
   "type": "module",
   "main": "src/index.ts",
   "exports": {
@@ -14,6 +18,13 @@
     "./daemon": "./src/daemon.ts",
     "./http": "./src/http.ts"
   },
+  "files": [
+    "src/",
+    "scripts/install-lib.sh"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
   "bin": {
     "version-bump": "./src/scripts/version-bump.ts"
   },

package/src/cli.ts

@@ -45,7 +45,7 @@ export function formatUptime(seconds: number): string {
 export type CommandHandler = (
   args: string[],
   json: boolean,
-) => void | Promise<void>;
+) => void | number | Promise<void | number>;
 
 export interface RunCliOpts {
   /** Service name, used in error messages. */
@@ -104,6 +104,6 @@ export async function runCli(opts: RunCliOpts): Promise<void> {
     process.exit(1);
   }
 
-  await handler(args, json);
-  process.exit(0);
+  const exitCode = (await handler(args, json)) ?? 0;
+  process.exit(exitCode);
 }

package/.github/workflows/ci-shared.yml

@@ -1,36 +0,0 @@
-name: CI (shared)
-
-on:
-  workflow_call:
-    inputs:
-      extra-validate-command:
-        description: "Optional extra command to run after validate (e.g. a full test suite)"
-        required: false
-        type: string
-        default: ""
-
-permissions:
-  contents: read
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Validate
-        run: bun run validate
-
-      - name: Extra validation
-        if: ${{ inputs.extra-validate-command != '' }}
-        shell: bash
-        run: ${{ inputs.extra-validate-command }}

package/.github/workflows/ci.yml

@@ -1,14 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-  push:
-    branches:
-      - main
-
-permissions:
-  contents: read
-
-jobs:
-  validate:
-    uses: ./.github/workflows/ci-shared.yml

package/.github/workflows/release-shared.yml

@@ -1,150 +0,0 @@
-name: Release (shared)
-
-on:
-  workflow_call:
-    inputs:
-      service-name:
-        description: "Service name for tarball prefix and release title (e.g. engram, synapse)"
-        required: true
-        type: string
-      extra-tarball-paths:
-        description: "Space-separated additional paths to include in tarball (e.g. 'opencode/ scripts/install.sh')"
-        required: false
-        type: string
-        default: ""
-      publish-npm:
-        description: "Whether to publish to GitHub Packages via npm publish"
-        required: false
-        type: boolean
-        default: false
-      attach-install-sh:
-        description: "Whether to attach scripts/install.sh as a release asset"
-        required: false
-        type: boolean
-        default: false
-
-concurrency:
-  group: release
-  cancel-in-progress: false
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      packages: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.workflow_run.head_sha }}
-          fetch-depth: 0
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Compute next version
-        id: version
-        run: |
-          LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.1.0")
-          echo "latest_tag=${LATEST_TAG}" >> "$GITHUB_OUTPUT"
-
-          VERSION="${LATEST_TAG#v}"
-          IFS='.' read -r MAJOR MINOR PATCH <<< "$VERSION"
-
-          COMMITS_SINCE="$(git log "${LATEST_TAG}..HEAD" --format='%s' 2>/dev/null || echo "")"
-          if echo "$COMMITS_SINCE" | grep -q '\[major\]'; then
-            NEXT_VERSION="$((MAJOR + 1)).0.0"
-            BUMP_LEVEL="major"
-          elif echo "$COMMITS_SINCE" | grep -q '\[minor\]'; then
-            NEXT_VERSION="${MAJOR}.$((MINOR + 1)).0"
-            BUMP_LEVEL="minor"
-          else
-            NEXT_VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
-            BUMP_LEVEL="patch"
-          fi
-
-          echo "bump_level=${BUMP_LEVEL}" >> "$GITHUB_OUTPUT"
-          echo "next_version=${NEXT_VERSION}" >> "$GITHUB_OUTPUT"
-          echo "next_tag=v${NEXT_VERSION}" >> "$GITHUB_OUTPUT"
-          echo "Releasing: v${NEXT_VERSION} (previous: ${LATEST_TAG}, bump: ${BUMP_LEVEL})"
-
-      - name: Write VERSION file
-        run: echo "${{ steps.version.outputs.next_version }}" > VERSION
-
-      - name: Update package.json version
-        run: |
-          jq --arg v "${{ steps.version.outputs.next_version }}" '.version = $v' package.json > tmp.json
-          mv tmp.json package.json
-
-      - name: Write BUILD_META.json
-        run: |
-          SHA="${{ github.event.workflow_run.head_sha }}"
-          SHORT_SHA="${SHA:0:7}"
-          BRANCH="${{ github.event.workflow_run.head_branch }}"
-          TITLE="$(git log -1 --format='%s' "$SHA")"
-          BUILD_TIME="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-          jq -n \
-            --arg sha "$SHA" \
-            --arg shortSha "$SHORT_SHA" \
-            --arg branch "$BRANCH" \
-            --arg title "$TITLE" \
-            --arg buildTime "$BUILD_TIME" \
-            '{
-              gitSha: $sha,
-              gitShortSha: $shortSha,
-              gitBranch: $branch,
-              commitTitle: $title,
-              buildTimeUtc: $buildTime
-            }' > BUILD_META.json
-
-      - name: Publish to GitHub Packages
-        if: ${{ inputs.publish-npm }}
-        run: |
-          echo "//npm.pkg.github.com/:_authToken=${{ github.token }}" > .npmrc
-          echo "@shetty4l:registry=https://npm.pkg.github.com" >> .npmrc
-          npm publish --access public
-
-      - name: Create source tarball
-        run: |
-          TAG="${{ steps.version.outputs.next_tag }}"
-          EXTRA_PATHS="${{ inputs.extra-tarball-paths }}"
-          tar czf "${{ inputs.service-name }}-${TAG}.tar.gz" \
-            --exclude='node_modules' \
-            --exclude='.git' \
-            --exclude='test' \
-            --exclude='.husky' \
-            --exclude='.DS_Store' \
-            --exclude='dist' \
-            src/ \
-            package.json \
-            bun.lock \
-            tsconfig.json \
-            biome.json \
-            VERSION \
-            BUILD_META.json \
-            $EXTRA_PATHS
-
-      - name: Create tag and release
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          TAG="${{ steps.version.outputs.next_tag }}"
-          ASSETS=("${{ inputs.service-name }}-${TAG}.tar.gz")
-
-          if [ "${{ inputs.attach-install-sh }}" = "true" ] && [ -f "scripts/install.sh" ]; then
-            ASSETS+=("scripts/install.sh")
-          fi
-
-          git tag "${TAG}"
-          git push origin "${TAG}"
-
-          gh release create "${TAG}" \
-            --title "Release ${TAG}" \
-            --notes "Automated release ${TAG}" \
-            "${ASSETS[@]}"

package/.github/workflows/release.yml

@@ -1,19 +0,0 @@
-name: Release
-
-on:
-  workflow_run:
-    workflows: ["CI"]
-    types: [completed]
-    branches: [main]
-
-permissions:
-  contents: write
-  packages: write
-
-jobs:
-  release:
-    if: ${{ github.event.workflow_run.conclusion == 'success' }}
-    uses: ./.github/workflows/release-shared.yml
-    with:
-      service-name: core
-      publish-npm: true

package/.husky/pre-commit

@@ -1,3 +0,0 @@
-#!/bin/sh
-
-bun run validate || exit 1

package/biome.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2
-  },
-  "linter": {
-    "enabled": false
-  },
-  "assist": { "actions": { "source": { "organizeImports": "on" } } }
-}

package/bun.lock

@@ -1,65 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "@shetty4l/core",
-      "devDependencies": {
-        "@biomejs/biome": "^2.3.13",
-        "@types/bun": "latest",
-        "husky": "^9.0.0",
-        "oxlint": "^0.12.0",
-        "typescript": "^5.0.0",
-      },
-    },
-  },
-  "packages": {
-    "@biomejs/biome": ["@biomejs/biome@2.4.2", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.4.2", "@biomejs/cli-darwin-x64": "2.4.2", "@biomejs/cli-linux-arm64": "2.4.2", "@biomejs/cli-linux-arm64-musl": "2.4.2", "@biomejs/cli-linux-x64": "2.4.2", "@biomejs/cli-linux-x64-musl": "2.4.2", "@biomejs/cli-win32-arm64": "2.4.2", "@biomejs/cli-win32-x64": "2.4.2" }, "bin": { "biome": "bin/biome" } }, "sha512-vVE/FqLxNLbvYnFDYg3Xfrh1UdFhmPT5i+yPT9GE2nTUgI4rkqo5krw5wK19YHBd7aE7J6r91RRmb8RWwkjy6w=="],
-
-    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.4.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-3pEcKCP/1POKyaZZhXcxFl3+d9njmeAihZ17k8lL/1vk+6e0Cbf0yPzKItFiT+5Yh6TQA4uKvnlqe0oVZwRxCA=="],
-
-    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.4.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-P7hK1jLVny+0R9UwyGcECxO6sjETxfPyBm/1dmFjnDOHgdDPjPqozByunrwh4xPKld8sxOr5eAsSqal5uKgeBg=="],
-
-    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.4.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-DI3Mi7GT2zYNgUTDEbSjl3e1KhoP76OjQdm8JpvZYZWtVDRyLd3w8llSr2TWk1z+U3P44kUBWY3X7H9MD1/DGQ=="],
-
-    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.4.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-/x04YK9+7erw6tYEcJv9WXoBHcULI/wMOvNdAyE9S3JStZZ9yJyV67sWAI+90UHuDo/BDhq0d96LDqGlSVv7WA=="],
-
-    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.4.2", "", { "os": "linux", "cpu": "x64" }, "sha512-GK2ErnrKpWFigYP68cXiCHK4RTL4IUWhK92AFS3U28X/nuAL5+hTuy6hyobc8JZRSt+upXt1nXChK+tuHHx4mA=="],
-
-    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.4.2", "", { "os": "linux", "cpu": "x64" }, "sha512-wbBmTkeAoAYbOQ33f6sfKG7pcRSydQiF+dTYOBjJsnXO2mWEOQHllKlC2YVnedqZFERp2WZhFUoO7TNRwnwEHQ=="],
-
-    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.4.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-k2uqwLYrNNxnaoiW3RJxoMGnbKda8FuCmtYG3cOtVljs3CzWxaTR+AoXwKGHscC9thax9R4kOrtWqWN0+KdPTw=="],
-
-    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.4.2", "", { "os": "win32", "cpu": "x64" }, "sha512-9ma7C4g8Sq3cBlRJD2yrsHXB1mnnEBdpy7PhvFrylQWQb4PoyCmPucdX7frvsSBQuFtIiKCrolPl/8tCZrKvgQ=="],
-
-    "@oxlint/darwin-arm64": ["@oxlint/darwin-arm64@0.12.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-UydkjcAImpmBn8JYaMPg0zJrwgWJMGvJagvCnyPfyiBRWAN83Kq+BDgJZgIq+2Te6kvlnoiHWNJKVJmpy0f0BA=="],
-
-    "@oxlint/darwin-x64": ["@oxlint/darwin-x64@0.12.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-bxLyiAiHzXB56w7cf50YNPpZlK+PMxA8GgHutRSoNK/Z/BR/xsibNLs/9YNUnjHB+PF19+EbIRtJxoHjmbRr8g=="],
-
-    "@oxlint/linux-arm64-gnu": ["@oxlint/linux-arm64-gnu@0.12.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-jVkmfoMjPKFDIZySmpykwrCmx5xhpLJdMpUAR8ycEkFRJFp5qKLWZd6cEjiMb7gxmWN6qcCvDVTF/zEs3aRpyQ=="],
-
-    "@oxlint/linux-arm64-musl": ["@oxlint/linux-arm64-musl@0.12.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-8VdV1nKYDj7AFaw1a03Ih43/+pUS/hhMZbTFLRMpvlVp1cPtdB77c+bl/OdiJ/BwNTzLIzr/GrospwCoEJkQKg=="],
-
-    "@oxlint/linux-x64-gnu": ["@oxlint/linux-x64-gnu@0.12.0", "", { "os": "linux", "cpu": "x64" }, "sha512-MacAt8N4XU5DeoHcseXLom/z+B0seecCz8vGAH4ppF2EH49o7NbN7VvFsw2nZ2QNO/4vw+pdS1BHXLTr9lY6zQ=="],
-
-    "@oxlint/linux-x64-musl": ["@oxlint/linux-x64-musl@0.12.0", "", { "os": "linux", "cpu": "x64" }, "sha512-/ZBDJ9wpUE6bB05nniQl29kD5vJUMg6n75LdHD8F6ThXfsHGI/n7Je3gzggnXokgf9UQpTUPWrWlfEuWVCBMag=="],
-
-    "@oxlint/win32-arm64": ["@oxlint/win32-arm64@0.12.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-hY1ya9dv8VY8113YSSDfMs/989aFmoA2fIZco8uxTxIEVl9nGY6tDtpgKZqUIiGrrMbDO8BBb1G5jsekmfexbA=="],
-
-    "@oxlint/win32-x64": ["@oxlint/win32-x64@0.12.0", "", { "os": "win32", "cpu": "x64" }, "sha512-NHLJolo4sZk3nu/bPNuaJ+6p5DdHoRuZAjyuSO6CnLgpmZcYqx7LgngA/x2oB/bLgi4Hv9twjHjODc5Ce5o14g=="],
-
-    "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
-
-    "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
-
-    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
-
-    "husky": ["husky@9.1.7", "", { "bin": { "husky": "bin.js" } }, "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA=="],
-
-    "oxlint": ["oxlint@0.12.0", "", { "optionalDependencies": { "@oxlint/darwin-arm64": "0.12.0", "@oxlint/darwin-x64": "0.12.0", "@oxlint/linux-arm64-gnu": "0.12.0", "@oxlint/linux-arm64-musl": "0.12.0", "@oxlint/linux-x64-gnu": "0.12.0", "@oxlint/linux-x64-musl": "0.12.0", "@oxlint/win32-arm64": "0.12.0", "@oxlint/win32-x64": "0.12.0" }, "bin": { "oxlint": "bin/oxlint", "oxc_language_server": "bin/oxc_language_server" } }, "sha512-M0vWq8KYtp4vpweRxcdCiVO8QFwzoRyp5bWTMrEL/0Z+GDKCMJltac7H3T3T09FIiktOZLvID733d7OcKk/caw=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
-  }
-}

package/test/cli.test.ts

@@ -1,61 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { formatUptime, parseArgs } from "../src/cli";
-
-// --- parseArgs ---
-
-describe("parseArgs", () => {
-  test("extracts command and args", () => {
-    const result = parseArgs(["start", "--port", "8080"]);
-    expect(result.command).toBe("start");
-    expect(result.args).toEqual(["--port", "8080"]);
-    expect(result.json).toBe(false);
-  });
-
-  test("strips --json flag", () => {
-    const result = parseArgs(["status", "--json"]);
-    expect(result.command).toBe("status");
-    expect(result.args).toEqual([]);
-    expect(result.json).toBe(true);
-  });
-
-  test("--json can appear anywhere", () => {
-    const result = parseArgs(["--json", "health"]);
-    expect(result.command).toBe("health");
-    expect(result.json).toBe(true);
-  });
-
-  test("defaults to help when empty", () => {
-    const result = parseArgs([]);
-    expect(result.command).toBe("help");
-    expect(result.args).toEqual([]);
-    expect(result.json).toBe(false);
-  });
-});
-
-// --- formatUptime ---
-
-describe("formatUptime", () => {
-  test("formats seconds", () => {
-    expect(formatUptime(45)).toBe("45s");
-  });
-
-  test("formats minutes and seconds", () => {
-    expect(formatUptime(192)).toBe("3m 12s");
-  });
-
-  test("formats hours and minutes", () => {
-    expect(formatUptime(8100)).toBe("2h 15m");
-  });
-
-  test("edge case: exactly 60 seconds", () => {
-    expect(formatUptime(60)).toBe("1m 0s");
-  });
-
-  test("edge case: exactly 1 hour", () => {
-    expect(formatUptime(3600)).toBe("1h 0m");
-  });
-
-  test("zero seconds", () => {
-    expect(formatUptime(0)).toBe("0s");
-  });
-});

package/test/config.test.ts

@@ -1,263 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-import {
-  expandPath,
-  getConfigDir,
-  getDataDir,
-  interpolateDeep,
-  interpolateEnvVars,
-  loadJsonConfig,
-  parsePort,
-} from "../src/config";
-
-const TMP = join(import.meta.dir, ".tmp-config");
-
-beforeEach(() => {
-  if (existsSync(TMP)) rmSync(TMP, { recursive: true });
-  mkdirSync(TMP, { recursive: true });
-});
-
-afterEach(() => {
-  if (existsSync(TMP)) rmSync(TMP, { recursive: true });
-  // Clean up env vars
-  delete process.env.XDG_DATA_HOME;
-  delete process.env.XDG_CONFIG_HOME;
-  delete process.env.CORE_TEST_VAR;
-});
-
-// --- getDataDir ---
-
-describe("getDataDir", () => {
-  test("uses XDG_DATA_HOME when set", () => {
-    process.env.XDG_DATA_HOME = "/custom/data";
-    expect(getDataDir("engram")).toBe("/custom/data/engram");
-  });
-
-  test("falls back to ~/.local/share/{name}", () => {
-    delete process.env.XDG_DATA_HOME;
-    expect(getDataDir("engram")).toBe(
-      join(homedir(), ".local", "share", "engram"),
-    );
-  });
-});
-
-// --- getConfigDir ---
-
-describe("getConfigDir", () => {
-  test("uses XDG_CONFIG_HOME when set", () => {
-    process.env.XDG_CONFIG_HOME = "/custom/config";
-    expect(getConfigDir("synapse")).toBe("/custom/config/synapse");
-  });
-
-  test("falls back to ~/.config/{name}", () => {
-    delete process.env.XDG_CONFIG_HOME;
-    expect(getConfigDir("synapse")).toBe(join(homedir(), ".config", "synapse"));
-  });
-});
-
-// --- expandPath ---
-
-describe("expandPath", () => {
-  test("expands ~ to homedir", () => {
-    const result = expandPath("~/foo/bar");
-    expect(result).toBe(join(homedir(), "foo/bar"));
-  });
-
-  test("leaves absolute paths unchanged", () => {
-    expect(expandPath("/usr/bin")).toBe("/usr/bin");
-  });
-
-  test("leaves relative paths unchanged", () => {
-    expect(expandPath("foo/bar")).toBe("foo/bar");
-  });
-});
-
-// --- interpolateEnvVars ---
-
-describe("interpolateEnvVars", () => {
-  test("replaces env var references", () => {
-    process.env.CORE_TEST_VAR = "hello";
-    const result = interpolateEnvVars("prefix-${CORE_TEST_VAR}-suffix");
-    expect(result.ok).toBe(true);
-    if (result.ok) expect(result.value).toBe("prefix-hello-suffix");
-  });
-
-  test("returns err for missing env var", () => {
-    delete process.env.CORE_TEST_VAR;
-    const result = interpolateEnvVars("${CORE_TEST_VAR}");
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("CORE_TEST_VAR");
-  });
-
-  test("returns string unchanged when no vars present", () => {
-    const result = interpolateEnvVars("plain string");
-    expect(result.ok).toBe(true);
-    if (result.ok) expect(result.value).toBe("plain string");
-  });
-
-  test("ignores malformed env var references", () => {
-    const result = interpolateEnvVars("${not valid}");
-    expect(result.ok).toBe(true);
-    if (result.ok) expect(result.value).toBe("${not valid}");
-  });
-
-  test("ignores empty braces", () => {
-    const result = interpolateEnvVars("${}");
-    expect(result.ok).toBe(true);
-    if (result.ok) expect(result.value).toBe("${}");
-  });
-});
-
-// --- interpolateDeep ---
-
-describe("interpolateDeep", () => {
-  test("interpolates strings in nested objects", () => {
-    process.env.CORE_TEST_VAR = "world";
-    const result = interpolateDeep({
-      greeting: "hello ${CORE_TEST_VAR}",
-      nested: { value: "${CORE_TEST_VAR}" },
-    });
-    expect(result.ok).toBe(true);
-    if (result.ok) {
-      expect(result.value).toEqual({
-        greeting: "hello world",
-        nested: { value: "world" },
-      });
-    }
-  });
-
-  test("interpolates strings in arrays", () => {
-    process.env.CORE_TEST_VAR = "item";
-    const result = interpolateDeep(["${CORE_TEST_VAR}", 42, true]);
-    expect(result.ok).toBe(true);
-    if (result.ok) {
-      expect(result.value).toEqual(["item", 42, true]);
-    }
-  });
-
-  test("passes through non-string primitives", () => {
-    const result = interpolateDeep({ num: 42, bool: true, nil: null });
-    expect(result.ok).toBe(true);
-    if (result.ok) {
-      expect(result.value).toEqual({ num: 42, bool: true, nil: null });
-    }
-  });
-
-  test("returns err on missing env var in nested value", () => {
-    delete process.env.CORE_TEST_VAR;
-    const result = interpolateDeep({ deep: { value: "${CORE_TEST_VAR}" } });
-    expect(result.ok).toBe(false);
-  });
-});
-
-// --- parsePort ---
-
-describe("parsePort", () => {
-  test("valid port returns Ok with branded Port", () => {
-    const result = parsePort("8080", "TEST");
-    expect(result.ok).toBe(true);
-    if (result.ok) expect(result.value as number).toBe(8080);
-  });
-
-  test("port 1 is valid", () => {
-    const result = parsePort("1", "TEST");
-    expect(result.ok).toBe(true);
-  });
-
-  test("port 65535 is valid", () => {
-    const result = parsePort("65535", "TEST");
-    expect(result.ok).toBe(true);
-  });
-
-  test("port 0 is invalid", () => {
-    const result = parsePort("0", "TEST");
-    expect(result.ok).toBe(false);
-  });
-
-  test("port 65536 is invalid", () => {
-    const result = parsePort("65536", "TEST");
-    expect(result.ok).toBe(false);
-  });
-
-  test("non-numeric returns error", () => {
-    const result = parsePort("abc", "SOURCE");
-    expect(result.ok).toBe(false);
-    if (!result.ok) {
-      expect(result.error).toContain("abc");
-      expect(result.error).toContain("SOURCE");
-    }
-  });
-});
-
-// --- loadJsonConfig ---
-
-describe("loadJsonConfig", () => {
-  const defaults = { host: "localhost", port: 3000 };
-
-  test("returns defaults when config file missing", () => {
-    const result = loadJsonConfig({
-      name: "test",
-      defaults,
-      configPath: join(TMP, "nonexistent.json"),
-    });
-    expect(result.ok).toBe(true);
-    if (result.ok) {
-      expect(result.value.config).toEqual(defaults);
-      expect(result.value.source).toBe("defaults");
-    }
-  });
-
-  test("merges file config with defaults", () => {
-    const configPath = join(TMP, "config.json");
-    writeFileSync(configPath, JSON.stringify({ port: 9999 }));
-
-    const result = loadJsonConfig({ name: "test", defaults, configPath });
-    expect(result.ok).toBe(true);
-    if (result.ok) {
-      expect(result.value.config).toEqual({ host: "localhost", port: 9999 });
-      expect(result.value.source).toBe("file");
-    }
-  });
-
-  test("interpolates env vars in config file", () => {
-    process.env.CORE_TEST_VAR = "from-env";
-    const configPath = join(TMP, "config.json");
-    writeFileSync(configPath, JSON.stringify({ host: "${CORE_TEST_VAR}" }));
-
-    const result = loadJsonConfig({ name: "test", defaults, configPath });
-    expect(result.ok).toBe(true);
-    if (result.ok) {
-      expect(result.value.config.host).toBe("from-env");
-    }
-  });
-
-  test("returns err for invalid JSON", () => {
-    const configPath = join(TMP, "config.json");
-    writeFileSync(configPath, "not json{{{");
-
-    const result = loadJsonConfig({ name: "test", defaults, configPath });
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("invalid JSON");
-  });
-
-  test("returns err for non-object JSON", () => {
-    const configPath = join(TMP, "config.json");
-    writeFileSync(configPath, "[1, 2, 3]");
-
-    const result = loadJsonConfig({ name: "test", defaults, configPath });
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("must be a JSON object");
-  });
-
-  test("returns err for missing env var in config", () => {
-    delete process.env.CORE_TEST_VAR;
-    const configPath = join(TMP, "config.json");
-    writeFileSync(configPath, JSON.stringify({ host: "${CORE_TEST_VAR}" }));
-
-    const result = loadJsonConfig({ name: "test", defaults, configPath });
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("CORE_TEST_VAR");
-  });
-});

package/test/daemon.test.ts

@@ -1,89 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "fs";
-import { join } from "path";
-import type { DaemonManager } from "../src/daemon";
-import { createDaemonManager } from "../src/daemon";
-
-const TMP = join(import.meta.dir, ".tmp-daemon");
-
-function setup(): string {
-  if (existsSync(TMP)) rmSync(TMP, { recursive: true });
-  mkdirSync(TMP, { recursive: true });
-  return TMP;
-}
-
-function teardown() {
-  if (existsSync(TMP)) rmSync(TMP, { recursive: true });
-}
-
-describe("createDaemonManager", () => {
-  test("creates a manager with all methods", () => {
-    const configDir = setup();
-    try {
-      const manager = createDaemonManager({
-        name: "test",
-        configDir,
-        cliPath: "/nonexistent/cli.ts",
-      });
-      expect(typeof manager.start).toBe("function");
-      expect(typeof manager.stop).toBe("function");
-      expect(typeof manager.restart).toBe("function");
-      expect(typeof manager.status).toBe("function");
-    } finally {
-      teardown();
-    }
-  });
-
-  test("status returns not running when no PID file", async () => {
-    const configDir = setup();
-    try {
-      const manager = createDaemonManager({
-        name: "test",
-        configDir,
-        cliPath: "/nonexistent/cli.ts",
-      });
-      const status = await manager.status();
-      expect(status.running).toBe(false);
-      expect(status.pid).toBeUndefined();
-    } finally {
-      teardown();
-    }
-  });
-
-  test("status cleans up stale PID file", async () => {
-    const configDir = setup();
-    try {
-      // Write a PID that doesn't correspond to a running process
-      writeFileSync(join(configDir, "test.pid"), "999999");
-
-      const manager = createDaemonManager({
-        name: "test",
-        configDir,
-        cliPath: "/nonexistent/cli.ts",
-      });
-      const status = await manager.status();
-      expect(status.running).toBe(false);
-
-      // PID file should be cleaned up
-      expect(existsSync(join(configDir, "test.pid"))).toBe(false);
-    } finally {
-      teardown();
-    }
-  });
-
-  test("stop returns err when not running", async () => {
-    const configDir = setup();
-    try {
-      const manager = createDaemonManager({
-        name: "test",
-        configDir,
-        cliPath: "/nonexistent/cli.ts",
-      });
-      const result = await manager.stop();
-      expect(result.ok).toBe(false);
-      if (!result.ok) expect(result.error).toContain("not running");
-    } finally {
-      teardown();
-    }
-  });
-});

package/test/http.test.ts

@@ -1,152 +0,0 @@
-import { afterAll, describe, expect, test } from "bun:test";
-import {
-  corsHeaders,
-  corsPreflightResponse,
-  createServer,
-  healthResponse,
-  jsonError,
-  jsonOk,
-} from "../src/http";
-
-// --- corsHeaders ---
-
-describe("corsHeaders", () => {
-  test("returns CORS headers", () => {
-    const headers = corsHeaders();
-    expect(headers["Access-Control-Allow-Origin"]).toBe("*");
-    expect(headers["Access-Control-Allow-Methods"]).toContain("GET");
-    expect(headers["Access-Control-Allow-Headers"]).toContain("Content-Type");
-  });
-
-  test("returns a fresh copy each time", () => {
-    const a = corsHeaders();
-    const b = corsHeaders();
-    expect(a).toEqual(b);
-    a["X-Custom"] = "mutated";
-    expect(b["X-Custom"]).toBeUndefined();
-  });
-});
-
-// --- corsPreflightResponse ---
-
-describe("corsPreflightResponse", () => {
-  test("returns 204 with CORS headers", () => {
-    const res = corsPreflightResponse();
-    expect(res.status).toBe(204);
-    expect(res.headers.get("Access-Control-Allow-Origin")).toBe("*");
-  });
-});
-
-// --- jsonOk ---
-
-describe("jsonOk", () => {
-  test("returns JSON with 200 by default", async () => {
-    const res = jsonOk({ message: "hello" });
-    expect(res.status).toBe(200);
-    const body = await res.json();
-    expect(body).toEqual({ message: "hello" });
-  });
-
-  test("supports custom status code", () => {
-    const res = jsonOk({ id: 1 }, 201);
-    expect(res.status).toBe(201);
-  });
-
-  test("includes CORS headers", () => {
-    const res = jsonOk({});
-    expect(res.headers.get("Access-Control-Allow-Origin")).toBe("*");
-  });
-});
-
-// --- jsonError ---
-
-describe("jsonError", () => {
-  test("returns error JSON", async () => {
-    const res = jsonError(400, "bad request");
-    expect(res.status).toBe(400);
-    const body = await res.json();
-    expect(body).toEqual({ error: "bad request" });
-  });
-
-  test("includes CORS headers", () => {
-    const res = jsonError(500, "oops");
-    expect(res.headers.get("Access-Control-Allow-Origin")).toBe("*");
-  });
-});
-
-// --- healthResponse ---
-
-describe("healthResponse", () => {
-  test("returns standard health fields", async () => {
-    const startTime = Date.now() - 5000;
-    const res = healthResponse("1.0.0", startTime);
-    expect(res.status).toBe(200);
-    const body = (await res.json()) as Record<string, unknown>;
-    expect(body.status).toBe("healthy");
-    expect(body.version).toBe("1.0.0");
-    expect(typeof body.uptime).toBe("number");
-    expect((body.uptime as number) >= 4).toBe(true);
-  });
-
-  test("includes extra fields when provided", async () => {
-    const res = healthResponse("1.0.0", Date.now(), {
-      memories: 42,
-    });
-    const body = (await res.json()) as Record<string, unknown>;
-    expect(body.memories).toBe(42);
-  });
-});
-
-// --- createServer ---
-
-describe("createServer", () => {
-  let server: ReturnType<typeof createServer> | null = null;
-
-  afterAll(() => {
-    if (server) server.stop();
-  });
-
-  test("starts server and responds to /health", async () => {
-    server = createServer({
-      port: 0, // random available port
-      version: "0.1.0-test",
-      onRequest: () => null,
-    });
-
-    const res = await fetch(`http://localhost:${server.port}/health`);
-    expect(res.status).toBe(200);
-    const body = (await res.json()) as Record<string, unknown>;
-    expect(body.status).toBe("healthy");
-    expect(body.version).toBe("0.1.0-test");
-  });
-
-  test("handles OPTIONS preflight", async () => {
-    const res = await fetch(`http://localhost:${server!.port}/anything`, {
-      method: "OPTIONS",
-    });
-    expect(res.status).toBe(204);
-    expect(res.headers.get("Access-Control-Allow-Origin")).toBe("*");
-  });
-
-  test("routes to onRequest for custom paths", async () => {
-    server!.stop();
-    server = createServer({
-      port: 0,
-      version: "0.1.0-test",
-      onRequest: (_req, url) => {
-        if (url.pathname === "/echo") return jsonOk({ path: "/echo" });
-        return null;
-      },
-    });
-
-    const res = await fetch(`http://localhost:${server.port}/echo`);
-    expect(res.status).toBe(200);
-    const body = (await res.json()) as Record<string, unknown>;
-    expect(body.path).toBe("/echo");
-  });
-
-  test("returns 404 when onRequest returns null", async () => {
-    const res = await fetch(`http://localhost:${server!.port}/nonexistent`);
-    expect(res.status).toBe(404);
-  });
-});

package/test/result.test.ts

@@ -1,58 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { err, ok } from "../src/result";
-
-describe("ok", () => {
-  test("creates Ok result", () => {
-    const result = ok(42);
-    expect(result.ok).toBe(true);
-    expect(result.value).toBe(42);
-  });
-
-  test("works with string values", () => {
-    const result = ok("hello");
-    expect(result.ok).toBe(true);
-    expect(result.value).toBe("hello");
-  });
-
-  test("works with objects", () => {
-    const result = ok({ name: "test" });
-    expect(result.ok).toBe(true);
-    expect(result.value).toEqual({ name: "test" });
-  });
-});
-
-describe("err", () => {
-  test("creates Err result", () => {
-    const result = err("something went wrong");
-    expect(result.ok).toBe(false);
-    expect(result.error).toBe("something went wrong");
-  });
-
-  test("works with structured errors", () => {
-    const result = err({ code: "NOT_FOUND", message: "missing" });
-    expect(result.ok).toBe(false);
-    expect(result.error).toEqual({ code: "NOT_FOUND", message: "missing" });
-  });
-});
-
-describe("type narrowing", () => {
-  test("narrows Ok in conditional", () => {
-    const result = ok(42);
-    if (result.ok) {
-      // TypeScript knows this is Ok<number>
-      expect(result.value).toBe(42);
-    } else {
-      throw new Error("should not reach");
-    }
-  });
-
-  test("narrows Err in conditional", () => {
-    const result = err("bad");
-    if (!result.ok) {
-      // TypeScript knows this is Err<string>
-      expect(result.error).toBe("bad");
-    } else {
-      throw new Error("should not reach");
-    }
-  });
-});

package/test/signals.test.ts

@@ -1,25 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { onShutdown } from "../src/signals";
-
-describe("onShutdown", () => {
-  test("registers handler without throwing", () => {
-    // onShutdown registers process listeners — verify it doesn't throw.
-    // We can't easily test signal delivery in unit tests, but we can
-    // verify the function accepts valid inputs.
-    expect(() => {
-      onShutdown(() => {}, { signals: [] });
-    }).not.toThrow();
-  });
-
-  test("accepts async cleanup function", () => {
-    expect(() => {
-      onShutdown(async () => {}, { signals: [] });
-    }).not.toThrow();
-  });
-
-  test("accepts custom signals list", () => {
-    expect(() => {
-      onShutdown(() => {}, { signals: ["SIGUSR1"], timeoutMs: 1000 });
-    }).not.toThrow();
-  });
-});

package/test/version.test.ts

@@ -1,55 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "fs";
-import { join } from "path";
-import { readVersion } from "../src/version";
-
-const TMP = join(import.meta.dir, ".tmp-version");
-
-function setup() {
-  if (existsSync(TMP)) rmSync(TMP, { recursive: true });
-  mkdirSync(TMP, { recursive: true });
-}
-
-function teardown() {
-  if (existsSync(TMP)) rmSync(TMP, { recursive: true });
-}
-
-describe("readVersion", () => {
-  test("returns fallback when VERSION file missing", () => {
-    setup();
-    try {
-      expect(readVersion(TMP)).toBe("0.0.0-dev");
-    } finally {
-      teardown();
-    }
-  });
-
-  test("returns custom fallback when VERSION file missing", () => {
-    setup();
-    try {
-      expect(readVersion(TMP, "1.0.0-local")).toBe("1.0.0-local");
-    } finally {
-      teardown();
-    }
-  });
-
-  test("reads VERSION file when present", () => {
-    setup();
-    try {
-      writeFileSync(join(TMP, "VERSION"), "2.3.4\n");
-      expect(readVersion(TMP)).toBe("2.3.4");
-    } finally {
-      teardown();
-    }
-  });
-
-  test("trims whitespace from VERSION file", () => {
-    setup();
-    try {
-      writeFileSync(join(TMP, "VERSION"), "  1.0.0  \n\n");
-      expect(readVersion(TMP)).toBe("1.0.0");
-    } finally {
-      teardown();
-    }
-  });
-});

package/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "types": ["bun"]
-  },
-  "include": ["src/**/*", "test/**/*"],
-  "exclude": ["node_modules"]
-}