API.md

API Reference

Complete API reference for ab.

ABClient

Main client for interacting with ab.

from ab import ABClient

async with ABClient() as client:
    # Use client...

Methods

create_project(name, description, repo_url)

Create a new project.

store_awareness(prompt, files, diffs, status, emotional_state, project_id)

Store awareness card.

store_architecture_decision(decision, constraints, modules, alternatives, project_id)

Store architecture decision.

store_feature_plan(epic_name, tasks, user_stories, acceptance_criteria, dependencies, project_id)

Store feature plan.

recall_shape(shape_id, project_id)

Recall using a shape.

recall_architecture_context(project_id)

Recall architecture context.

run_council(card_id)

Run Council of Selves.

get_card(card_id)

Get card by ID.

store_card(label, buffers, project_id)

Store a card.

Core Entities

Card

Memory object with label and buffers.

Buffer

Named payload container with optional channel.

EmotionalState

Emotional state with primary, intensity, secondary emotions.

Storage

TreewebStorage

Graph-based storage with SQL persistence.

ImageStorage

Image storage backends (Local, S3, Reference).

AudioStorage

Audio storage backends (Local, Reference).

Recall

auto_link_similar_cards(cards, similarity_threshold, db, treeweb)

Auto-link similar cards.

find_connected_cards(card_id, session, treeweb, max_depth)

Find connected cards via graph traversal.

See examples for detailed usage.