/**
 * pi-docgraph — AI-Native Documentation Graph Extension for Pi
 *
 * An extension that enables AI coding agents to understand, maintain, and
 * evolve a repository through an AI-native documentation graph with:
 *
 * - Selective retrieval (read only the docs relevant to the current task)
 * - Ticket-driven workflows (kanban board under docs/tickets/)
 * - Code-as-the-source-of-truth enforcement
 * - Cross-reference validation between documents
 * - Automatic metadata synchronization
 *
 * @module pi-docgraph
 */

import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

import { registerEvents } from "./events/index.js";
import { registerAllCommands } from "./commands/index.js";
import {
  registerDocgraphInit,
  registerDocgraphRead,
  registerDocgraphSync,
  registerDocgraphUpdate,
  registerDocgraphTicketCreate,
  registerDocgraphTicketUpdate,
  registerDocgraphTicketList,
} from "./tools/index.js";

export default function (pi: ExtensionAPI): void {
  // ── Tools (callable by the AI agent) ──────────────────────────────

  // Documentation management
  registerDocgraphInit(pi);
  registerDocgraphRead(pi);
  registerDocgraphSync(pi);
  registerDocgraphUpdate(pi);

  // Ticket-driven workflow
  registerDocgraphTicketCreate(pi);
  registerDocgraphTicketUpdate(pi);
  registerDocgraphTicketList(pi);

  // ── Commands (user-facing shortcuts) ──────────────────────────────

  registerAllCommands(pi);

  // ── Event handlers (context injection, status display) ────────────

  registerEvents(pi);
}