@jungjaehoon/mama-os 0.47.0 → 0.48.0

package/dist/connectors/trello/query-tools.d.ts

@@ -83,29 +83,161 @@ export interface TrelloKanbanSnapshot {
 export declare function getTrelloKanban(input?: {
     maxCardsPerList?: number;
 }, deps?: TrelloQueryDeps): Promise<TrelloKanbanSnapshot>;
+export interface TrelloBoardOverview {
+    boardId: string;
+    board: string;
+    status: 'ok' | 'failed';
+    rosterDegraded: boolean;
+    /** listId is the STABLE key to pass to getTrelloListCards; `list` is the display name
+     *  (two lists on one board can share it, so never key a read by the name). */
+    lists: Array<{
+        listId: string;
+        list: string;
+        count: number;
+    }>;
+}
+export interface TrelloBoardsOverview {
+    boards: TrelloBoardOverview[];
+    observedAt: string;
+    cacheAgeMs: number;
+    /** Snapshot identity a cards/search cursor is pinned to. */
+    readVersion: string;
+    /** Every configured board read successfully. */
+    complete: boolean;
+}
+/**
+ * Progressive overview: every configured board and its lists with stable ids and
+ * open-card COUNTS - no card arrays. This is the entry point; a caller then reads
+ * one list's cards with `getTrelloListCards`. `readVersion` names the snapshot to
+ * pass back through a cards/search cursor.
+ */
+export declare function getTrelloBoardsOverview(deps?: TrelloQueryDeps): Promise<TrelloBoardsOverview>;
+export interface TrelloCardsPage {
+    boardId: string;
+    listId: string;
+    board: string;
+    list: string;
+    cards: TrelloCardSummary[];
+    total: number;
+    returned: number;
+    nextCursor: string | null;
+    observedAt: string;
+    cacheAgeMs: number;
+    readVersion: string;
+    /** Source coverage for THIS board; a failed board is not an empty complete list. */
+    coverage: {
+        status: 'ok' | 'failed';
+        rosterDegraded: boolean;
+    };
+}
+/**
+ * One bounded page of a single list's open cards, drawn from the cached snapshot.
+ * Every card in the list is reachable by walking `nextCursor` - past the old
+ * 100-card kanban ceiling. The cursor is pinned to the snapshot and (boardId,
+ * listId); a replaced/expired snapshot is rejected with restart guidance.
+ */
+export declare function getTrelloListCards(input: {
+    boardId: string;
+    listId: string;
+    limit?: number;
+    cursor?: string;
+}, deps?: TrelloQueryDeps): Promise<TrelloCardsPage>;
+export interface TrelloSearchPage {
+    query: string;
+    cards: TrelloCardSummary[];
+    total: number;
+    returned: number;
+    nextCursor: string | null;
+    observedAt: string;
+    cacheAgeMs: number;
+    readVersion: string;
+    coverage: {
+        boards: TrelloBoardCoverage[];
+        complete: boolean;
+    };
+}
 /**
- * Search cards across the configured boards, LIVE. Returns current list,
- * labels (revision round / artist), and assignee names per card. Tries
- * Trello's /search first (fast for ASCII terms), then fills up from a
- * board scan with local substring matching (reliable for CJK names).
+ * Progressive search over the cached board snapshot with local substring match -
+ * an HONEST full match total and stable paging, not the old 20-result cap. A
+ * failed board keeps `complete:false` so a missing match is never read as absent.
+ * Local substring scan is deliberate: Trello's /search tokenizes on word
+ * boundaries and misses CJK substrings and underscore compounds (e.g.
+ * 'エルデリーゼ', 'ex_1055003'), which is most of this board vocabulary.
  */
-export declare function searchTrelloCards(input: {
+export declare function searchTrelloBoardCards(input: {
     query: string;
     limit?: number;
-}, deps?: TrelloQueryDeps): Promise<TrelloCardSummary[]>;
-export interface TrelloCardDetail extends TrelloCardSummary {
-    description: string;
+    cursor?: string;
+}, deps?: TrelloQueryDeps): Promise<TrelloSearchPage>;
+export type TrelloCardDetailSection = {
+    cardId: string;
+    section: 'summary';
+    name: string;
+    board: string;
+    list: string;
+    labels: string[];
+    assignees: string[];
+    due: string | null;
+    lastActivity: string;
+    descriptionLength: number;
+    checklistCount: number;
+    itemCount: number;
+    /** Binds the authorized fetched card; a continuation must echo it or restart. */
+    readVersion: string;
+} | {
+    cardId: string;
+    section: 'description';
+    content: string;
+    offset: number;
+    limit: number;
+    total: number;
+    nextOffset: number | null;
+    complete: boolean;
+    readVersion: string;
+} | {
+    cardId: string;
+    section: 'checklists';
     checklists: Array<{
+        id: string;
         name: string;
-        items: Array<{
-            name: string;
-            complete: boolean;
-        }>;
+        itemCount: number;
+        completeCount: number;
     }>;
-}
-/** Full card detail, LIVE: description head, members, labels, checklists. */
-export declare function getTrelloCard(input: {
+    offset: number;
+    limit: number;
+    total: number;
+    nextOffset: number | null;
+    readVersion: string;
+} | {
     cardId: string;
-}, deps?: TrelloQueryDeps): Promise<TrelloCardDetail>;
+    section: 'checklist_items';
+    checklistId: string;
+    items: Array<{
+        name: string;
+        complete: boolean;
+    }>;
+    offset: number;
+    limit: number;
+    total: number;
+    nextOffset: number | null;
+    readVersion: string;
+};
+/**
+ * Sectioned card detail. `summary` (default) is metadata plus description length
+ * and checklist/item counts; `description` pages the text by Unicode CODE POINTS
+ * (offset/limit); `checklists` pages whole checklist headers by RECORD; and
+ * `checklist_items` pages whole item records of one checklist. Every long tail is
+ * reachable through the returned continuation - nothing is silently sliced. The
+ * board allowlist is enforced before ANY field is returned; list/search/detail
+ * all agree on the same configured boards.
+ */
+export declare function getTrelloCardDetail(input: {
+    cardId: string;
+    section?: string;
+    offset?: number;
+    limit?: number;
+    checklistId?: string;
+    readVersion?: string;
+}, deps?: TrelloQueryDeps): Promise<TrelloCardDetailSection>;
 export {};
 //# sourceMappingURL=query-tools.d.ts.map

package/dist/connectors/trello/query-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-tools.d.ts","sourceRoot":"","sources":["../../../src/connectors/trello/query-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;6EAC6E;AAC7E,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,eAAoB,GAAG,UAAU,CAqC7E;AAkCD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AA8CD,0CAA0C;AAC1C,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAmGD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,KAAK,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,EACxC,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAqC/B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACxF;AAED,6EAA6E;AAC7E,wBAAsB,aAAa,CACjC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACzB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAuC3B"}
+{"version":3,"file":"query-tools.d.ts","sourceRoot":"","sources":["../../../src/connectors/trello/query-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;6EAC6E;AAC7E,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,eAAoB,GAAG,UAAU,CAqC7E;AAkCD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAwDD,0CAA0C;AAC1C,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA2HD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,KAAK,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,EACxC,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAqC/B;AAID,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB;kFAC8E;IAC9E,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsB/B;AAoFD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,QAAQ,EAAE;QAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAChE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3E,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,eAAe,CAAC,CAuE1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAChE;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACzD,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAiD3B;AA0CD,MAAM,MAAM,uBAAuB,GAC/B;IACE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA6DN;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE;IACL,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CA4GlC"}