@suwujs/king-ai 0.2.0

package/dist/src/host-ledger.d.ts

@@ -0,0 +1,261 @@
+import { type CompactJsonlResult } from "./jsonl.js";
+import type { KingHandoffPolicy, KingWorkflowObjectType } from "./team-workflow.js";
+export type HostTaskStatus = "pending" | "in_progress" | "blocked" | "done" | "cancelled";
+export type HostCapsuleStatus = "open" | "in_review" | "accepted" | "abandoned";
+export type HostWorkflowStatus = "open" | "assigned" | "in_progress" | "blocked" | "review" | "waiting_human" | "done" | "cancelled";
+export interface HostLedgerPathInput {
+    outputDir?: string;
+    tasksFile?: string;
+    capsulesFile?: string;
+    workflowFile?: string;
+}
+export interface HostTaskCreateInput extends HostLedgerPathInput {
+    id?: string;
+    title: string;
+    status?: HostTaskStatus;
+    assignee?: string;
+    ownerRole?: string;
+    reviewerRole?: string;
+    priority?: string;
+    dependsOn?: string[];
+    capsuleId?: string;
+    acceptance?: string[];
+    detail?: string;
+}
+export interface HostTaskUpdateInput extends HostLedgerPathInput {
+    id: string;
+    status?: HostTaskStatus;
+    assignee?: string;
+    ownerRole?: string;
+    reviewerRole?: string;
+    priority?: string;
+    dependsOn?: string[];
+    capsuleId?: string;
+    acceptance?: string[];
+    detail?: string;
+    result?: string;
+}
+export interface HostTaskListInput extends HostLedgerPathInput {
+    status?: HostTaskStatus;
+    assignee?: string;
+    limit?: number;
+}
+export interface HostAgendaInput extends HostLedgerPathInput {
+    assignee?: string;
+    limit?: number;
+}
+export interface HostCapsuleCreateInput extends HostLedgerPathInput {
+    id?: string;
+    taskId?: string;
+    goal: string;
+    owner: string;
+    branchOrWorktree: string;
+    allowedPaths: string[];
+    acceptance: string[];
+    reviewer: string;
+    verificationCommands: string[];
+    status?: HostCapsuleStatus;
+}
+export interface HostCapsuleUpdateInput extends HostLedgerPathInput {
+    id: string;
+    taskId?: string;
+    goal?: string;
+    owner?: string;
+    branchOrWorktree?: string;
+    allowedPaths?: string[];
+    acceptance?: string[];
+    reviewer?: string;
+    verificationCommands?: string[];
+    status?: HostCapsuleStatus;
+}
+export interface HostCapsuleListInput extends HostLedgerPathInput {
+    status?: HostCapsuleStatus;
+    owner?: string;
+    limit?: number;
+}
+export interface HostTask {
+    id: string;
+    title: string;
+    status: HostTaskStatus;
+    createdAt: string;
+    updatedAt?: string;
+    assignee?: string;
+    ownerRole?: string;
+    reviewerRole?: string;
+    priority?: string;
+    dependsOn: string[];
+    capsuleId?: string;
+    acceptance: string[];
+    detail?: string;
+    result?: string;
+}
+export interface HostTaskUpdate {
+    id: string;
+    updatedAt: string;
+    status?: HostTaskStatus;
+    assignee?: string;
+    ownerRole?: string;
+    reviewerRole?: string;
+    priority?: string;
+    dependsOn?: string[];
+    capsuleId?: string;
+    acceptance?: string[];
+    detail?: string;
+    result?: string;
+}
+export interface HostCapsule {
+    id: string;
+    status: HostCapsuleStatus;
+    createdAt: string;
+    updatedAt?: string;
+    taskId?: string;
+    goal: string;
+    owner: string;
+    branchOrWorktree: string;
+    allowedPaths: string[];
+    acceptance: string[];
+    reviewer: string;
+    verificationCommands: string[];
+}
+export interface HostWorkflowCardCreateInput extends HostLedgerPathInput {
+    kind: KingWorkflowObjectType;
+    id?: string;
+    title: string;
+    status?: HostWorkflowStatus;
+    ownerRole?: string;
+    reviewerRole?: string;
+    assignee?: string;
+    priority?: string;
+    dependsOn?: string[];
+    acceptance?: string[];
+    handoffPolicy?: KingHandoffPolicy;
+    sourceId?: string;
+    targetRole?: string;
+    decisionBy?: string;
+    artifactPath?: string;
+    detail?: string;
+    result?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HostWorkflowCardUpdateInput extends HostLedgerPathInput {
+    id: string;
+    status?: HostWorkflowStatus;
+    ownerRole?: string;
+    reviewerRole?: string;
+    assignee?: string;
+    priority?: string;
+    dependsOn?: string[];
+    acceptance?: string[];
+    handoffPolicy?: KingHandoffPolicy;
+    sourceId?: string;
+    targetRole?: string;
+    decisionBy?: string;
+    artifactPath?: string;
+    detail?: string;
+    result?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HostWorkflowCardListInput extends HostLedgerPathInput {
+    kind?: KingWorkflowObjectType;
+    status?: HostWorkflowStatus;
+    ownerRole?: string;
+    reviewerRole?: string;
+    assignee?: string;
+    limit?: number;
+}
+export interface HostWorkflowCard {
+    kind: KingWorkflowObjectType;
+    id: string;
+    title: string;
+    status: HostWorkflowStatus;
+    createdAt: string;
+    updatedAt?: string;
+    ownerRole?: string;
+    reviewerRole?: string;
+    assignee?: string;
+    priority?: string;
+    dependsOn: string[];
+    acceptance: string[];
+    handoffPolicy?: KingHandoffPolicy;
+    sourceId?: string;
+    targetRole?: string;
+    decisionBy?: string;
+    artifactPath?: string;
+    detail?: string;
+    result?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HostWorkflowCardUpdate {
+    id: string;
+    updatedAt: string;
+    status?: HostWorkflowStatus;
+    ownerRole?: string;
+    reviewerRole?: string;
+    assignee?: string;
+    priority?: string;
+    dependsOn?: string[];
+    acceptance?: string[];
+    handoffPolicy?: KingHandoffPolicy;
+    sourceId?: string;
+    targetRole?: string;
+    decisionBy?: string;
+    artifactPath?: string;
+    detail?: string;
+    result?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HostCapsuleUpdate {
+    id: string;
+    updatedAt: string;
+    status?: HostCapsuleStatus;
+    taskId?: string;
+    goal?: string;
+    owner?: string;
+    branchOrWorktree?: string;
+    allowedPaths?: string[];
+    acceptance?: string[];
+    reviewer?: string;
+    verificationCommands?: string[];
+}
+export interface HostAgendaTask extends HostTask {
+    blockedBy: string[];
+    ready: boolean;
+}
+export interface HostAgenda {
+    tasks: HostAgendaTask[];
+    readyCount: number;
+    blockedCount: number;
+    summary: string;
+}
+export declare function hostTasksPathForOutputDir(outputDir?: string): string;
+export declare function hostCapsulesPathForOutputDir(outputDir?: string): string;
+export declare function hostWorkflowPathForOutputDir(outputDir?: string): string;
+export declare function createHostTask(input: HostTaskCreateInput, now?: () => Date): Promise<HostTask>;
+export declare function updateHostTask(input: HostTaskUpdateInput, now?: () => Date): Promise<HostTask>;
+export declare function listHostTasks(input?: HostTaskListInput): Promise<HostTask[]>;
+export declare function buildHostAgenda(input?: HostAgendaInput): Promise<HostAgenda>;
+export declare function createHostCapsule(input: HostCapsuleCreateInput, now?: () => Date): Promise<HostCapsule>;
+export declare function updateHostCapsule(input: HostCapsuleUpdateInput, now?: () => Date): Promise<HostCapsule>;
+export declare function listHostCapsules(input?: HostCapsuleListInput): Promise<HostCapsule[]>;
+export declare function getHostCapsule(input: HostLedgerPathInput & {
+    id: string;
+}): Promise<HostCapsule | null>;
+export declare function createHostWorkflowCard(input: HostWorkflowCardCreateInput, now?: () => Date): Promise<HostWorkflowCard>;
+export declare function updateHostWorkflowCard(input: HostWorkflowCardUpdateInput, now?: () => Date): Promise<HostWorkflowCard>;
+export declare function listHostWorkflowCards(input?: HostWorkflowCardListInput): Promise<HostWorkflowCard[]>;
+export declare function formatHostWorkflowCards(cards: HostWorkflowCard[]): string;
+export declare function formatHostTasks(tasks: HostTask[]): string;
+export declare function formatHostCapsules(capsules: HostCapsule[]): string;
+export declare function formatHostAgenda(agenda: Pick<HostAgenda, "tasks" | "readyCount" | "blockedCount">): string;
+export interface HostLedgerCompactResult {
+    tasks: CompactJsonlResult;
+    capsules: CompactJsonlResult;
+    workflow: CompactJsonlResult;
+}
+/**
+ * Rewrite the append-only task, capsule, and workflow logs into their merged latest-state
+ * snapshots. The result is observationally identical to the pre-compaction ledger but drops
+ * superseded update records, bounding unbounded log growth from long multi-role runs.
+ */
+export declare function compactHostLedger(input?: HostLedgerPathInput): Promise<HostLedgerCompactResult>;
+export declare function formatHostLedgerCompact(result: HostLedgerCompactResult): string;