@behavior-os/sdk 0.0.0-stage → 2.2.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @behavior-os/sdk@2.2.1 build /home/runner/work/behavior-os-governance/behavior-os-governance/packages/sdk
+> tsc -p tsconfig.build.json
+

package/CHANGELOG.md

@@ -0,0 +1,77 @@
+# @behavior-os/sdk
+
+## 2.2.1
+
+### Patch Changes
+
+- fix(publish): ship installable manifests
+  
+  The 2.2.0 tarballs were produced with `npm publish` from the workspace, so the
+  published manifests still contained `workspace:*` dependency ranges and npm
+  rejects the install with `EUNSUPPORTEDPROTOCOL: Unsupported URL Type
+  "workspace:"`. Republishing through `pnpm changeset publish` rewrites those
+  ranges to the real version.
+  
+  `pnpm verify:publish` now packs every publishable package and fails when a
+  packed manifest still carries a `workspace:` range or declares a `bin`/`main`
+  target that is missing from the tarball. The release and tag workflows run it
+  before publishing, and it is part of `pnpm verify:all`.
+- Updated dependencies
+  - @behavior-os/schemas@2.2.1
+  - @behavior-os/core@2.2.1
+
+## 2.2.0
+
+### Minor Changes
+
+- 885f016: fix: unify MCP protocol advancement steps with plugin host
+  
+  The MCP server now advances `bos_list_dna` (step 2) and `bos_get_state` (step 3)
+  protocol steps, matching the plugin host's behavior. Previously, MCP callers
+  stalled at step 1 after `bos_select_dna` because only `bos_start_mission` advanced
+  the protocol in MCP.
+  
+  Also completes the SDK lifecycle gap (added `completeMission`, `failMission`,
+  `cancelMission`, `listMissions`, `requiredChecks`/`verificationMode` on
+  `createMission`) and fixes the CLI `autonomous` command to close dry-run missions.
+
+### Patch Changes
+
+- Updated dependencies [885f016]
+  - @behavior-os/core@2.2.0
+  - @behavior-os/schemas@2.2.0
+
+## 2.1.0
+
+### Minor Changes
+
+- c95526d: Transparent execution on Windows and an asynchronous audit engine:
+  
+  - `AuditEngine.run/runReal/runStageReal` are now async so hosts can await them
+    (MCP server, plugin, SDK, CLI and examples all updated). Callers that used
+    the result synchronously must await — hence the minor bumps.
+  - Every process spawn in the governed paths sets `windowsHide: true` and uses
+    `shell: true` with a single-string command (Node DEP0190-safe), so governed
+    execution no longer flashes CMD windows; `pnpm` invocations get the shell
+    treatment required by Windows `.cmd` shims.
+  - Audit stages run sequentially under contention (parallel tsc produced false
+    failures), and the plugin tool handlers await their audit calls, too.
+  - New UX gate: `pnpm verify:windows` runs `scripts/win-window-probe.mjs`
+    against the spawn topology that leaked windows before and fails (exit 1)
+    when any new visible console window appears, reporting pid/name
+    attribution. It is part of `verify:all` and documented in the AGENTS.md
+    verification ladder.
+  - Examples are covered from the root ladder and `verify:opencode` batches
+    `git check-ignore` into a single hidden spawn.
+
+### Patch Changes
+
+- Updated dependencies [2fe6d18]
+- Updated dependencies [2fe6d18]
+- Updated dependencies [2fe6d18]
+- Updated dependencies [c95526d]
+- Updated dependencies [c95526d]
+- Updated dependencies [c95526d]
+- Updated dependencies [2fe6d18]
+  - @behavior-os/core@2.1.0
+  - @behavior-os/schemas@2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 Ilvan Joaquim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+import { type BehaviorOSConfig, type MissionTransitionResult } from '@behavior-os/core';
+import type { AuditReport, DNA, GovernanceDecision, LearningEvent, Mission, MissionPriority, MissionStatus, MissionType } from '@behavior-os/schemas';
+export type { BehaviorOSConfig, MissionTransitionResult } from '@behavior-os/core';
+export { BehaviorOS } from '@behavior-os/core';
+export type { Agent, AuditReport, DNA, GovernanceDecision, LearningEvent, Mission, MissionPriority, MissionStatus, MissionType, } from '@behavior-os/schemas';
+export declare class BehaviorOSSDK {
+    private bos;
+    constructor(config?: BehaviorOSConfig);
+    loadDNA(dna: DNA): Promise<void>;
+    getDNA(): DNA | null;
+    evaluateGovernance(action: string, context: {
+        agent: string;
+        scope?: string;
+        [key: string]: unknown;
+    }): GovernanceDecision;
+    checkQuality(metrics: Record<string, number>): {
+        passed: boolean;
+        details: unknown;
+    };
+    runAudit(options: {
+        missionId: string;
+        agentId?: string;
+        stages?: string[];
+        simulate?: boolean;
+    }): Promise<AuditReport>;
+    createMission(options: {
+        title: string;
+        description?: string;
+        type: string;
+        priority: string;
+        dnaPattern?: string;
+        createdBy?: string;
+        tags?: string[];
+        /** Gates that must each have passing evidence before completion. */
+        requiredChecks?: string[];
+        /** `executed` requires real, provenance-stamped evidence for every gate. */
+        verificationMode?: 'any' | 'executed';
+    }): Mission;
+    startMission(missionId: string): Mission | null;
+    completeMission(missionId: string, options?: {
+        expectedVersion?: number;
+        actor?: string;
+        evidence?: Array<{
+            gate: string;
+            status: 'passed' | 'failed' | 'skipped';
+            source: string;
+            detail?: string;
+            simulated?: boolean;
+            provenance?: 'executed' | 'reported' | 'simulated';
+            executionId?: string;
+        }>;
+    }): Mission | null;
+    failMission(missionId: string, reason?: string): Mission | null;
+    cancelMission(missionId: string): MissionTransitionResult;
+    listMissions(limit?: number, filters?: {
+        status?: MissionStatus;
+        type?: MissionType;
+        priority?: MissionPriority;
+    }): Mission[];
+    recordLearning(options: {
+        type: string;
+        source: string;
+        content: string;
+        impact: string;
+        relatedMission?: string;
+    }): LearningEvent;
+    getInsights(limit?: number): LearningEvent[];
+    getStatus(): {
+        engine: boolean;
+        dna: string | null;
+        missions: number;
+        agents: number;
+        state: import("@behavior-os/schemas").AgentState;
+        config: {
+            governance: "strict" | "moderate" | "lenient";
+            qualityEnabled: boolean;
+            auditEnabled: boolean;
+            learningEnabled: boolean;
+        };
+        store: boolean | null;
+        storeError: string | null;
+    };
+    getState(): {
+        currentStep: number;
+        selectedDna: string | null;
+        agentId: string | null;
+        persona: string | null;
+        activeMission: string | null;
+        stepHistory: Record<string, unknown>[];
+        createdAt: string;
+        updatedAt: string;
+    };
+}
+export default BehaviorOSSDK;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,62 @@
+import { BehaviorOS } from '@behavior-os/core';
+export { BehaviorOS } from '@behavior-os/core';
+export class BehaviorOSSDK {
+    bos;
+    constructor(config = {}) {
+        this.bos = new BehaviorOS(config);
+    }
+    // DNA Management
+    async loadDNA(dna) {
+        await this.bos.loadDNA(dna);
+    }
+    getDNA() {
+        return this.bos.getDNA();
+    }
+    // Governance
+    evaluateGovernance(action, context) {
+        return this.bos.evaluateGovernance(action, context);
+    }
+    // Quality
+    checkQuality(metrics) {
+        return this.bos.checkQuality(metrics);
+    }
+    // Audit
+    async runAudit(options) {
+        return this.bos.runAudit(options);
+    }
+    // Missions
+    createMission(options) {
+        return this.bos.createMission(options);
+    }
+    startMission(missionId) {
+        return this.bos.startMission(missionId);
+    }
+    completeMission(missionId, options = {}) {
+        return this.bos.completeMission(missionId, options);
+    }
+    failMission(missionId, reason) {
+        return this.bos.failMission(missionId, reason);
+    }
+    cancelMission(missionId) {
+        return this.bos.cancelMission(missionId);
+    }
+    listMissions(limit = 50, filters = {}) {
+        return this.bos.listMissions(limit, filters);
+    }
+    // Learning
+    recordLearning(options) {
+        return this.bos.recordLearning(options);
+    }
+    getInsights(limit = 10) {
+        return this.bos.getInsights(limit);
+    }
+    // Status
+    getStatus() {
+        return this.bos.getStatus();
+    }
+    getState() {
+        return this.bos.getState();
+    }
+}
+export default BehaviorOSSDK;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuD,MAAM,mBAAmB,CAAC;AAapG,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAa/C,MAAM,OAAO,aAAa;IAChB,GAAG,CAAa;IAExB,YAAY,SAA2B,EAAE;QACvC,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,iBAAiB;IACjB,KAAK,CAAC,OAAO,CAAC,GAAQ;QACpB,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,aAAa;IACb,kBAAkB,CAChB,MAAc,EACd,OAAkE;QAElE,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,UAAU;IACV,YAAY,CAAC,OAA+B;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;IACR,KAAK,CAAC,QAAQ,CAAC,OAKd;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,WAAW;IACX,aAAa,CAAC,OAYb;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,YAAY,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CACb,SAAiB,EACjB,UAYI,EAAE;QAEN,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,MAAe;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,YAAY,CACV,KAAK,GAAG,EAAE,EACV,UAAsF,EAAE;QAExF,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,WAAW;IACX,cAAc,CAAC,OAMd;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,WAAW,CAAC,KAAK,GAAG,EAAE;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,SAAS;IACT,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC9B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@behavior-os/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.2.1",
+  "description": "High-level TypeScript SDK for Behavior-OS",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@behavior-os/core": "2.2.1",
+    "@behavior-os/schemas": "2.2.1"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "node ../../scripts/clean.mjs"
+  }
 }

package/src/index.ts

@@ -0,0 +1,146 @@
+import { BehaviorOS, type BehaviorOSConfig, type MissionTransitionResult } from '@behavior-os/core';
+import type {
+  AuditReport,
+  DNA,
+  GovernanceDecision,
+  LearningEvent,
+  Mission,
+  MissionPriority,
+  MissionStatus,
+  MissionType,
+} from '@behavior-os/schemas';
+
+export type { BehaviorOSConfig, MissionTransitionResult } from '@behavior-os/core';
+export { BehaviorOS } from '@behavior-os/core';
+export type {
+  Agent,
+  AuditReport,
+  DNA,
+  GovernanceDecision,
+  LearningEvent,
+  Mission,
+  MissionPriority,
+  MissionStatus,
+  MissionType,
+} from '@behavior-os/schemas';
+
+export class BehaviorOSSDK {
+  private bos: BehaviorOS;
+
+  constructor(config: BehaviorOSConfig = {}) {
+    this.bos = new BehaviorOS(config);
+  }
+
+  // DNA Management
+  async loadDNA(dna: DNA): Promise<void> {
+    await this.bos.loadDNA(dna);
+  }
+
+  getDNA(): DNA | null {
+    return this.bos.getDNA();
+  }
+
+  // Governance
+  evaluateGovernance(
+    action: string,
+    context: { agent: string; scope?: string; [key: string]: unknown },
+  ): GovernanceDecision {
+    return this.bos.evaluateGovernance(action, context);
+  }
+
+  // Quality
+  checkQuality(metrics: Record<string, number>): { passed: boolean; details: unknown } {
+    return this.bos.checkQuality(metrics);
+  }
+
+  // Audit
+  async runAudit(options: {
+    missionId: string;
+    agentId?: string;
+    stages?: string[];
+    simulate?: boolean;
+  }): Promise<AuditReport> {
+    return this.bos.runAudit(options);
+  }
+
+  // Missions
+  createMission(options: {
+    title: string;
+    description?: string;
+    type: string;
+    priority: string;
+    dnaPattern?: string;
+    createdBy?: string;
+    tags?: string[];
+    /** Gates that must each have passing evidence before completion. */
+    requiredChecks?: string[];
+    /** `executed` requires real, provenance-stamped evidence for every gate. */
+    verificationMode?: 'any' | 'executed';
+  }): Mission {
+    return this.bos.createMission(options);
+  }
+
+  startMission(missionId: string): Mission | null {
+    return this.bos.startMission(missionId);
+  }
+
+  completeMission(
+    missionId: string,
+    options: {
+      expectedVersion?: number;
+      actor?: string;
+      evidence?: Array<{
+        gate: string;
+        status: 'passed' | 'failed' | 'skipped';
+        source: string;
+        detail?: string;
+        simulated?: boolean;
+        provenance?: 'executed' | 'reported' | 'simulated';
+        executionId?: string;
+      }>;
+    } = {},
+  ): Mission | null {
+    return this.bos.completeMission(missionId, options);
+  }
+
+  failMission(missionId: string, reason?: string): Mission | null {
+    return this.bos.failMission(missionId, reason);
+  }
+
+  cancelMission(missionId: string): MissionTransitionResult {
+    return this.bos.cancelMission(missionId);
+  }
+
+  listMissions(
+    limit = 50,
+    filters: { status?: MissionStatus; type?: MissionType; priority?: MissionPriority } = {},
+  ): Mission[] {
+    return this.bos.listMissions(limit, filters);
+  }
+
+  // Learning
+  recordLearning(options: {
+    type: string;
+    source: string;
+    content: string;
+    impact: string;
+    relatedMission?: string;
+  }): LearningEvent {
+    return this.bos.recordLearning(options);
+  }
+
+  getInsights(limit = 10): LearningEvent[] {
+    return this.bos.getInsights(limit);
+  }
+
+  // Status
+  getStatus() {
+    return this.bos.getStatus();
+  }
+
+  getState() {
+    return this.bos.getState();
+  }
+}
+
+export default BehaviorOSSDK;

package/tests/sdk-integration.test.ts

@@ -0,0 +1,80 @@
+import type { DNA } from '@behavior-os/schemas';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { BehaviorOSSDK } from '../src/index.js';
+
+describe('BehaviorOSSDK Integration', () => {
+  let sdk: BehaviorOSSDK;
+
+  beforeEach(() => {
+    sdk = new BehaviorOSSDK();
+  });
+
+  it('should create and manage missions through SDK', () => {
+    const mission = sdk.createMission({
+      title: 'SDK Test Mission',
+      type: 'feature',
+      priority: 'high',
+      dnaPattern: 'enterprise-governance',
+    });
+
+    expect(mission.id).toBeDefined();
+    expect(mission.title).toBe('SDK Test Mission');
+
+    const started = sdk.startMission(mission.id);
+    expect(started?.status).toBe('active');
+  });
+
+  it('should evaluate governance through SDK', async () => {
+    const dna: DNA = {
+      name: 'Test DNA',
+      version: '1.0.0',
+      description: 'Test',
+      personas: [],
+      governance: [],
+      quality: [],
+    };
+    await sdk.loadDNA(dna);
+
+    const decision = sdk.evaluateGovernance('test-action', {
+      agent: 'sdk-agent',
+      context: {},
+    });
+
+    expect(decision.action).toBe('test-action');
+    expect(decision.verdict).toBeDefined();
+  });
+
+  it('should record and retrieve learning through SDK', () => {
+    sdk.recordLearning({
+      type: 'insight',
+      source: 'sdk-test',
+      content: 'SDK learning test',
+      impact: 'high',
+    });
+
+    const insights = sdk.getInsights(10);
+    expect(insights.length).toBeGreaterThan(0);
+  });
+
+  it('should get status and state through SDK', () => {
+    const status = sdk.getStatus();
+    expect(status.engine).toBe(true);
+
+    const state = sdk.getState();
+    expect(state).toBeDefined();
+  });
+
+  it('should load DNA through SDK', async () => {
+    const dna: DNA = {
+      name: 'SDK DNA',
+      version: '1.0.0',
+      description: 'SDK test DNA',
+      personas: [],
+      governance: [],
+      quality: [],
+    };
+
+    await sdk.loadDNA(dna);
+    expect(sdk.getDNA()?.name).toBe('SDK DNA');
+  });
+});

package/tests/sdk.test.ts

@@ -0,0 +1,159 @@
+import type { DNA } from '@behavior-os/schemas';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { BehaviorOSSDK } from '../src/index.js';
+
+describe('BehaviorOSSDK', () => {
+  let sdk: BehaviorOSSDK;
+
+  beforeEach(() => {
+    sdk = new BehaviorOSSDK();
+  });
+
+  it('should initialize with default config', () => {
+    const status = sdk.getStatus();
+    expect(status.engine).toBe(true);
+    expect(status.dna).toBeNull();
+  });
+
+  it('should load DNA pattern', async () => {
+    const dna: DNA = {
+      name: 'Test DNA',
+      version: '1.0.0',
+      description: 'Test',
+      personas: [],
+      governance: [],
+      quality: [],
+    };
+
+    await sdk.loadDNA(dna);
+    expect(sdk.getDNA()).toEqual(dna);
+  });
+
+  it('should evaluate governance with DNA loaded', async () => {
+    const dna: DNA = {
+      name: 'Test DNA',
+      version: '1.0.0',
+      description: 'Test',
+      personas: [],
+      governance: [],
+      quality: [],
+    };
+    await sdk.loadDNA(dna);
+
+    const decision = sdk.evaluateGovernance('test-action', {
+      agent: 'agent-1',
+      context: {},
+    });
+
+    expect(decision.action).toBe('test-action');
+    expect(decision.verdict).toBeDefined();
+    expect(decision.timestamp).toBeDefined();
+  });
+
+  it('should create mission', () => {
+    const mission = sdk.createMission({
+      title: 'Test Mission',
+      type: 'feature',
+      priority: 'high',
+    });
+
+    expect(mission.id).toBeDefined();
+    expect(mission.title).toBe('Test Mission');
+    expect(mission.status).toBe('pending');
+  });
+
+  it('should record learning', () => {
+    const event = sdk.recordLearning({
+      type: 'insight',
+      source: 'test',
+      content: 'Test insight',
+      impact: 'medium',
+    });
+
+    expect(event.id).toBeDefined();
+    expect(event.content).toBe('Test insight');
+  });
+
+  it('should get insights after recording', () => {
+    sdk.recordLearning({
+      type: 'insight',
+      source: 'test',
+      content: 'Test insight',
+      impact: 'high',
+    });
+
+    const insights = sdk.getInsights(10);
+    expect(insights.length).toBeGreaterThan(0);
+  });
+
+  it('should create mission with requiredChecks', () => {
+    const mission = sdk.createMission({
+      title: 'Test Mission',
+      type: 'feature',
+      priority: 'high',
+      requiredChecks: ['governance', 'audit'],
+    });
+
+    expect(mission.id).toBeDefined();
+    expect(mission.title).toBe('Test Mission');
+    expect(mission.status).toBe('pending');
+  });
+
+  it('should start, complete, and cancel missions via SDK', () => {
+    const mission = sdk.createMission({
+      title: 'Lifecycle Mission',
+      type: 'feature',
+      priority: 'high',
+      requiredChecks: ['governance'],
+    });
+
+    // Start -> active
+    const started = sdk.startMission(mission.id);
+    expect(started).not.toBeNull();
+    expect(started?.status).toBe('active');
+
+    // Complete with evidence
+    const completed = sdk.completeMission(mission.id, {
+      evidence: [{ gate: 'governance', status: 'passed', source: 'test' }],
+    });
+    expect(completed).not.toBeNull();
+    expect(completed?.status).toBe('completed');
+
+    // Cancel a new mission
+    const cancelTarget = sdk.createMission({
+      title: 'Cancel Mission',
+      type: 'refactor',
+      priority: 'medium',
+    });
+    const result = sdk.cancelMission(cancelTarget.id);
+    expect(result.ok).toBe(true);
+    expect(result.mission?.status).toBe('cancelled');
+  });
+
+  it('should list missions with filters', () => {
+    sdk.createMission({ title: 'Feature A', type: 'feature', priority: 'high' });
+    sdk.createMission({ title: 'Bug B', type: 'bugfix', priority: 'low' });
+
+    const all = sdk.listMissions();
+    expect(all.length).toBeGreaterThanOrEqual(2);
+
+    const features = sdk.listMissions(50, { type: 'feature' });
+    expect(features.every((m) => m.type === 'feature')).toBe(true);
+
+    const highPriority = sdk.listMissions(50, { priority: 'high' });
+    expect(highPriority.every((m) => m.priority === 'high')).toBe(true);
+  });
+
+  it('should fail a mission with reason', () => {
+    const mission = sdk.createMission({
+      title: 'Fail Mission',
+      type: 'incident',
+      priority: 'critical',
+    });
+
+    sdk.startMission(mission.id);
+    const failed = sdk.failMission(mission.id, 'Test failure reason');
+    expect(failed).not.toBeNull();
+    expect(failed?.status).toBe('failed');
+  });
+});

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "declaration": false,
+    "declarationMap": false,
+    "types": ["node"]
+  },
+  "include": ["src/**/*", "tests/**/*", "vitest.config.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,16 @@
+import path from 'node:path';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/**/*.test.ts'],
+  },
+  resolve: {
+    alias: {
+      '@behavior-os/core': path.resolve(__dirname, '../core/src/index.ts'),
+      '@behavior-os/schemas': path.resolve(__dirname, '../schemas/src/index.ts'),
+    },
+  },
+});

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.