Create a new OBO session file and update index.json atomically.

Args: base_dir: Project root directory (session goes in {base_dir}/.github/obo_sessions/) title: Human-readable session title description: What this session is reviewing items: List of item dicts (title, description, urgency, importance, effort, dependencies, category are all optional with defaults) session_filename: Optional explicit filename (e.g. session_20260314_120000.json). If omitted, generated from current timestamp.

List OBO sessions from index.json.

Args: base_dir: Project root directory status_filter: Optional filter — 'active', 'completed', or 'incomplete' (incomplete = active sessions with pending items)

Return summary statistics for an OBO session.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ base_dir: Required if session_file is a bare filename

Return the next item to work on.

Returns in_progress items first (highest priority_score), then pending.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ base_dir: Required if session_file is a bare filename

List all items in a session, sorted by priority_score descending.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ base_dir: Required if session_file is a bare filename status_filter: Optional — 'pending', 'in_progress', 'completed', 'skipped'

Return full detail for a single item.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ item_id: Item ID (integer or string) base_dir: Required if session_file is a bare filename

Mark an item as completed with resolution text.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ item_id: Item ID to mark complete resolution: Text describing how the item was resolved base_dir: Required if session_file is a bare filename

Mark an item as skipped.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ item_id: Item ID to skip base_dir: Required if session_file is a bare filename reason: Optional reason for skipping

Update any field on an item. Auto-recalculates priority_score when a score component (urgency, importance, effort, dependencies) is changed.

Args: session_file: Absolute path or filename relative to {base_dir}/.github/obo_sessions/ item_id: Item ID to update field: Field name (e.g. 'urgency', 'title', 'description', 'status') value: New value (always passed as string; numeric fields are cast automatically) base_dir: Required if session_file is a bare filename