@tachu/host-defaults 1.0.0-rc.0

package/dist/resolve-projection-stack.d.ts

@@ -0,0 +1,59 @@
+import { type AdapterCallContext, type EmbeddingRuntime, type EngineConfig, type ObservabilityEmitter, type ProviderAdapter, type VectorIndexAdapter } from "@tachu/core";
+import { projectMemoryRefs, type ProjectionProjectorDeps } from "@tachu/extensions/memory";
+export interface ResolveProjectionStackOptions {
+    /** When true, missing embedding runtime or vector index fails closed. */
+    required?: boolean | undefined;
+    /**
+    * Explicit override. When provided, host-side adapter selection is skipped
+    * and this adapter is used verbatim. Useful for tests and custom hosts that
+    * want to drive a synthetic in-memory adapter.
+    */
+    vectorIndex?: VectorIndexAdapter | undefined;
+    /**
+    * Working directory for relative paths in adapter construction (e.g. the
+    * LocalFs index defaults to `<cwd>/.tachu/vector-index.json`).
+    */
+    cwd?: string | undefined;
+}
+export interface ProjectionStack {
+    embeddingRuntime: EmbeddingRuntime;
+    vectorIndex: VectorIndexAdapter;
+    /** Identifier of the concrete adapter wired (`qdrant`, `local-fs`, or `injected`). */
+    adapterKind: "qdrant" | "local-fs" | "injected";
+    bindProjectionProject: (loadEntry: ProjectionProjectorDeps["loadEntry"], ctx: AdapterCallContext) => (sessionId: string, refs: readonly string[], signal: AbortSignal) => ReturnType<typeof projectMemoryRefs>;
+}
+/**
+ * Select / construct a {@link VectorIndexAdapter} from config + options.
+ *
+ * Resolution order (first match wins):
+ *
+ * 1. `options.vectorIndex` — explicit injection (tests / custom hosts).
+ * 2. `config.providers?.qdrant.extra.vectorIndex` — Qdrant connection details
+ * (`url`, `apiKey`, `collectionName`, `vectorSize`). When present a
+ * {@link QdrantVectorIndexAdapter} is constructed.
+ * 3. Default: a {@link LocalFsVectorIndexAdapter} persisting to
+ * `<cwd>/.tachu/vector-index.json`.
+ *
+ * The returned adapter is always pure-vector: it never accepts string `upsert`
+ * shortcuts, in line with + /.
+ */
+export declare function resolveVectorIndexAdapter(config: EngineConfig, options?: {
+    cwd?: string | undefined;
+    vectorIndex?: VectorIndexAdapter | undefined;
+}): {
+    adapter: VectorIndexAdapter;
+    kind: "qdrant" | "local-fs" | "injected";
+};
+/**
+ * Wire embed + vector index for memory projection ( / / ).
+ *
+ * The returned {@link ProjectionStack} is plug-and-play for hosts: pass
+ * `vectorIndex` and `bindProjectionProject(loadEntry, ctx)` to
+ * {@link FsMemorySystem} alongside a {@link ProjectionOutbox}, and the
+ * {@link ProjectionWorker} produced by `createProjectionWorker()` will index
+ * memory entries through the host-resolved {@link EmbeddingRuntime} +
+ * {@link VectorIndexAdapter} stack — never through the retired
+ * `InMemoryMemorySystem.project()` text-embed shortcut.
+ */
+export declare function resolveProjectionStack(config: EngineConfig, providers: readonly ProviderAdapter[], observability: ObservabilityEmitter, options?: ResolveProjectionStackOptions): ProjectionStack | undefined;
+//# sourceMappingURL=resolve-projection-stack.d.ts.map

package/dist/resolve-projection-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-projection-stack.d.ts","sourceRoot":"","sources":["../src/resolve-projection-stack.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAM3F,MAAM,WAAW,6BAA6B;IAC7C,yEAAyE;IACxE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC;;;;MAIE;IACD,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C;;;MAGE;IACD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,kBAAkB,CAAC;IACjC,sFAAsF;IACrF,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAChD,qBAAqB,EAAE,CACrB,SAAS,EAAE,uBAAuB,CAAC,WAAW,CAAC,EAC/C,GAAG,EAAE,kBAAkB,KACpB,CACH,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,WAAW,KAChB,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;CAC3C;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAA;CAAO,GACvF;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAA;CAAE,CA0B3E;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,aAAa,EAAE,oBAAoB,EACnC,OAAO,GAAE,6BAAkC,GAC1C,eAAe,GAAG,SAAS,CAsF7B"}

package/dist/resolve-projection-stack.js

@@ -0,0 +1,146 @@
+import { isAbsolute, join } from "node:path";
+import { projectMemoryRefs } from "@tachu/extensions/memory";
+import { LocalFsVectorIndexAdapter, QdrantVectorIndexAdapter } from "@tachu/extensions/vector";
+import { assertCapabilityProvided } from "./capabilities";
+import { ENGINE_INIT_CORRELATION } from "./constants";
+import { resolveEmbeddingRuntime } from "./resolve-embedding-runtime";
+/**
+ * Select / construct a {@link VectorIndexAdapter} from config + options.
+ *
+ * Resolution order (first match wins):
+ *
+ * 1. `options.vectorIndex` — explicit injection (tests / custom hosts).
+ * 2. `config.providers?.qdrant.extra.vectorIndex` — Qdrant connection details
+ * (`url`, `apiKey`, `collectionName`, `vectorSize`). When present a
+ * {@link QdrantVectorIndexAdapter} is constructed.
+ * 3. Default: a {@link LocalFsVectorIndexAdapter} persisting to
+ * `<cwd>/.tachu/vector-index.json`.
+ *
+ * The returned adapter is always pure-vector: it never accepts string `upsert`
+ * shortcuts, in line with + /.
+ */
+export function resolveVectorIndexAdapter(config, options = {}) {
+    if (options.vectorIndex !== undefined) {
+        return { adapter: options.vectorIndex, kind: "injected" };
+    }
+    const qdrant = readQdrantConfig(config);
+    if (qdrant !== undefined) {
+        return {
+            adapter: new QdrantVectorIndexAdapter({
+                url: qdrant.url,
+                ...(qdrant.apiKey !== undefined ? { apiKey: qdrant.apiKey } : {}),
+                collectionName: qdrant.collectionName,
+                vectorSize: qdrant.vectorSize,
+            }),
+            kind: "qdrant",
+        };
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const filePath = isAbsolute(".tachu/vector-index.json")
+        ? ".tachu/vector-index.json"
+        : join(cwd, ".tachu", "vector-index.json");
+    return {
+        adapter: new LocalFsVectorIndexAdapter({ filePath }),
+        kind: "local-fs",
+    };
+}
+function readQdrantConfig(config) {
+    const providers = config.providers;
+    const qdrant = providers?.qdrant;
+    if (!qdrant)
+        return undefined;
+    const extra = (qdrant.extra ?? {});
+    const vi = extra.vectorIndex ?? {};
+    const url = vi.url ?? qdrant.baseURL;
+    const collectionName = vi.collectionName ?? "tachu-memory";
+    const vectorSize = typeof vi.vectorSize === "number" ? vi.vectorSize : undefined;
+    if (typeof url !== "string" || url.length === 0)
+        return undefined;
+    if (typeof vectorSize !== "number" || vectorSize <= 0)
+        return undefined;
+    return {
+        url,
+        apiKey: vi.apiKey ?? qdrant.apiKey,
+        collectionName,
+        vectorSize,
+    };
+}
+/**
+ * Wire embed + vector index for memory projection ( / / ).
+ *
+ * The returned {@link ProjectionStack} is plug-and-play for hosts: pass
+ * `vectorIndex` and `bindProjectionProject(loadEntry, ctx)` to
+ * {@link FsMemorySystem} alongside a {@link ProjectionOutbox}, and the
+ * {@link ProjectionWorker} produced by `createProjectionWorker()` will index
+ * memory entries through the host-resolved {@link EmbeddingRuntime} +
+ * {@link VectorIndexAdapter} stack — never through the retired
+ * `InMemoryMemorySystem.project()` text-embed shortcut.
+ */
+export function resolveProjectionStack(config, providers, observability, options = {}) {
+    const resolved = resolveEmbeddingRuntime(config, providers);
+    const { adapter: vectorIndex, kind: adapterKind } = (() => {
+        try {
+            return resolveVectorIndexAdapter(config, {
+                ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+                ...(options.vectorIndex !== undefined ? { vectorIndex: options.vectorIndex } : {}),
+            });
+        }
+        catch (error) {
+            observability.emit({
+                timestamp: Date.now(),
+                correlation: ENGINE_INIT_CORRELATION,
+                phase: "init",
+                type: "warning",
+                payload: {
+                    status: "projection.vector-index.error",
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
+            return { adapter: undefined, kind: "local-fs" };
+        }
+    })();
+    if (options.required === true) {
+        assertCapabilityProvided(observability, "embedding-runtime", resolved !== undefined, "embedding runtime required for memory projection");
+        assertCapabilityProvided(observability, "vector-index", vectorIndex !== undefined, "vector index required for memory projection");
+    }
+    if (!resolved || !vectorIndex) {
+        if (options.required !== true) {
+            observability.emit({
+                timestamp: Date.now(),
+                correlation: ENGINE_INIT_CORRELATION,
+                phase: "init",
+                type: "warning",
+                payload: {
+                    status: "projection.disabled",
+                    reason: !resolved
+                        ? "no embedding runtime available"
+                        : "no vector index adapter configured",
+                },
+            });
+        }
+        return undefined;
+    }
+    observability.emit({
+        timestamp: Date.now(),
+        correlation: ENGINE_INIT_CORRELATION,
+        phase: "init",
+        type: "progress",
+        payload: {
+            status: "projection.available",
+            providerId: resolved.provider.id,
+            model: resolved.model,
+            vectorIndexKind: adapterKind,
+        },
+    });
+    return {
+        embeddingRuntime: resolved.runtime,
+        vectorIndex,
+        adapterKind,
+        bindProjectionProject: (loadEntry, ctx) => (sessionId, refs, signal) => projectMemoryRefs({
+            embedding: resolved.runtime,
+            vectorIndex,
+            loadEntry,
+        }, sessionId, refs, ctx, signal),
+    };
+}
+//# sourceMappingURL=resolve-projection-stack.js.map

package/dist/resolve-projection-stack.js.map

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

package/dist/resolve-semantic-judge.d.ts

@@ -0,0 +1,3 @@
+import { type EngineConfig, type ProviderAdapter, type SemanticJudgeAdapter } from "@tachu/core";
+export declare function resolveSemanticJudge(config: EngineConfig, providers: readonly ProviderAdapter[]): SemanticJudgeAdapter | undefined;
+//# sourceMappingURL=resolve-semantic-judge.d.ts.map

package/dist/resolve-semantic-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-semantic-judge.d.ts","sourceRoot":"","sources":["../src/resolve-semantic-judge.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC,oBAAoB,GAAG,SAAS,CAiBlC"}

package/dist/resolve-semantic-judge.js

@@ -0,0 +1,18 @@
+import { ProviderSemanticJudgeAdapter, } from "@tachu/core";
+export function resolveSemanticJudge(config, providers) {
+    const validationMapping = config.models.capabilityMapping.validation;
+    const preferredId = validationMapping?.provider;
+    const provider = (preferredId ? providers.find((item) => item.id === preferredId) : undefined) ??
+        providers.find((item) => typeof item.chat === "function");
+    if (!provider)
+        return undefined;
+    const model = validationMapping?.model ?? "validation-default";
+    return new ProviderSemanticJudgeAdapter({
+        provider,
+        model,
+        ...(config.validation?.semanticJudgeSystemPromptBase
+            ? { systemPromptBase: config.validation.semanticJudgeSystemPromptBase }
+            : {}),
+    });
+}
+//# sourceMappingURL=resolve-semantic-judge.js.map

package/dist/resolve-semantic-judge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-semantic-judge.js","sourceRoot":"","sources":["../src/resolve-semantic-judge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,GAI7B,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,oBAAoB,CAClC,MAAoB,EACpB,SAAqC;IAErC,MAAM,iBAAiB,GACrB,MAAM,CAAC,MAAM,CAAC,iBACf,CAAC,UAAU,CAAC;IACb,MAAM,WAAW,GAAG,iBAAiB,EAAE,QAAQ,CAAC;IAChD,MAAM,QAAQ,GACZ,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,KAAK,GAAG,iBAAiB,EAAE,KAAK,IAAI,oBAAoB,CAAC;IAC/D,OAAO,IAAI,4BAA4B,CAAC;QACtC,QAAQ;QACR,KAAK;QACL,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,6BAA6B;YAClD,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,6BAA6B,EAAE;YACvE,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/semantic-retrieval.d.ts

@@ -0,0 +1,9 @@
+import { type EngineConfig, type ObservabilityEmitter, type ProviderAdapter, type SemanticRetrievalFacade } from "@tachu/core";
+export interface ResolveSemanticRetrievalFacadeResult {
+    facade: SemanticRetrievalFacade;
+}
+/**
+ * 装配 SemanticRetrievalFacade 并 emit 标准 init 事件。
+ */
+export declare function resolveSemanticRetrievalFacade(config: EngineConfig, providers: readonly ProviderAdapter[], observability: ObservabilityEmitter): ResolveSemanticRetrievalFacadeResult;
+//# sourceMappingURL=semantic-retrieval.d.ts.map

package/dist/semantic-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-retrieval.d.ts","sourceRoot":"","sources":["../src/semantic-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,oCAAoC;IACnD,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,aAAa,EAAE,oBAAoB,GAClC,oCAAoC,CAwCtC"}

package/dist/semantic-retrieval.js

@@ -0,0 +1,44 @@
+import { DefaultRetrievalPolicyRegistry, DefaultSemanticRetrievalFacade, } from "@tachu/core";
+import { ENGINE_INIT_CORRELATION } from "./constants";
+import { resolveEmbeddingRuntime } from "./resolve-embedding-runtime";
+/**
+ * 装配 SemanticRetrievalFacade 并 emit 标准 init 事件。
+ */
+export function resolveSemanticRetrievalFacade(config, providers, observability) {
+    const resolved = resolveEmbeddingRuntime(config, providers);
+    if (resolved) {
+        const facade = new DefaultSemanticRetrievalFacade({
+            policy: new DefaultRetrievalPolicyRegistry(),
+            embedding: resolved.runtime,
+        });
+        observability.emit({
+            timestamp: Date.now(),
+            correlation: ENGINE_INIT_CORRELATION,
+            phase: "semantic-retrieval",
+            type: "progress",
+            payload: {
+                status: "available",
+                providerId: resolved.provider.id,
+                model: resolved.model,
+                strategy: "embedding_runtime",
+                reason: "provider exposes embed(); host wired DefaultSemanticRetrievalFacade with ProviderEmbeddingRuntimeAdapter",
+            },
+        });
+        return { facade };
+    }
+    const facade = new DefaultSemanticRetrievalFacade({
+        policy: new DefaultRetrievalPolicyRegistry(),
+    });
+    observability.emit({
+        timestamp: Date.now(),
+        correlation: ENGINE_INIT_CORRELATION,
+        phase: "semantic-retrieval",
+        type: "warning",
+        payload: {
+            status: "disabled",
+            reason: "no registered provider implements embed(); semantic retrieval falls back to local_scan or bypass per RetrievalPolicy",
+        },
+    });
+    return { facade };
+}
+//# sourceMappingURL=semantic-retrieval.js.map

package/dist/semantic-retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-retrieval.js","sourceRoot":"","sources":["../src/semantic-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,GAK/B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAMtE;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAoB,EACpB,SAAqC,EACrC,aAAmC;IAEnC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE5D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,IAAI,8BAA8B,CAAC;YAChD,MAAM,EAAE,IAAI,8BAA8B,EAAE;YAC5C,SAAS,EAAE,QAAQ,CAAC,OAAO;SAC5B,CAAC,CAAC;QACH,aAAa,CAAC,IAAI,CAAC;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,WAAW,EAAE,uBAAuB;YACpC,KAAK,EAAE,oBAAoB;YAC3B,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE;gBACP,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE;gBAChC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,QAAQ,EAAE,mBAAmB;gBAC7B,MAAM,EACJ,0GAA0G;aAC7G;SACF,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,8BAA8B,CAAC;QAChD,MAAM,EAAE,IAAI,8BAA8B,EAAE;KAC7C,CAAC,CAAC;IACH,aAAa,CAAC,IAAI,CAAC;QACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,WAAW,EAAE,uBAAuB;QACpC,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP,MAAM,EAAE,UAAU;YAClB,MAAM,EACJ,sHAAsH;SACzH;KACF,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@tachu/host-defaults",
+  "version": "1.0.0-rc.0",
+  "description": "Default host wiring for Tachu — provider inference, semantic retrieval facade, capability checks. Shared by CLI and non-CLI hosts.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_ZH.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "tachu",
+    "host",
+    "agent",
+    "llm",
+    "bun",
+    "typescript"
+  ],
+  "author": "Tachu Contributors",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/dangaogit/tachu#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dangaogit/tachu.git",
+    "directory": "packages/host-defaults"
+  },
+  "bugs": {
+    "url": "https://github.com/dangaogit/tachu/issues"
+  },
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@tachu/core": "1.0.0-rc.0",
+    "@tachu/extensions": "1.0.0-rc.0"
+  },
+  "scripts": {
+    "build": "bun run clean && bunx tsc -p tsconfig.build.json && bun ../../scripts/copy-md-assets.ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage"
+  }
+}