mission

Module: vibex/mission

Mission - User’s substantial intent within a Space

A Mission represents a high-level goal that requires multiple tasks to complete. Example: “Write a research paper on AI” is a Mission containing tasks like “Research sources”, “Create outline”, “Write introduction”, etc.

Hierarchy: Space (persistent container) └── Mission (user’s intent, has lifecycle) └── Plan (strategy, evolves) └── Task[] (individual work items)

Classes

Mission

Properties:

Methods:

setPlan

Set the plan for this mission

function setPlan(plan: Plan): void

Parameters:

getTasks

Get all tasks from the plan

function getTasks(): Task[]

getTasksByStatus

Get tasks by status

function getTasksByStatus(status: TaskStatus): Task[]

Parameters:

getNextTask

Get the next actionable task

function getNextTask(): Task | undefined

getCurrentTask

Get current running task

function getCurrentTask(): Task | undefined

getProgress

Calculate mission progress (0-100)

function getProgress(): number

pause

Pause the mission

function pause(): void

resume

Resume a paused mission

function resume(): void

complete

Complete the mission

function complete(): void

abandon

Abandon the mission

function abandon(): void

isFinished

Check if mission is finished (completed or abandoned)

function isFinished(): boolean

toJSON

Serialize to JSON

function toJSON(): Record<string, unknown>

fromJSON

Deserialize from JSON

function fromJSON(data: Record<string, unknown>): Mission

Parameters:

Interfaces

MissionConfig

Properties:

Types

MissionStatus

type MissionStatus = | "active" // Mission is being worked on
  | "paused" // User paused the mission
  | "completed" // All tasks done, goal achieved
  | "abandoned"