@bussolabs/closeyourit-cli 0.20.0 → 0.21.0

package/opencli.json

@@ -3,7 +3,7 @@
   "opencli": "0.1",
   "info": {
     "title": "closeyourit",
-    "version": "0.20.0",
+    "version": "0.21.0",
     "description": "CLI for CloseYourIt — manage org, errors, tokens and tickets with your user token",
     "license": {
       "name": "MIT",
@@ -2463,6 +2463,121 @@
               "closeyourit kb ask \"what is our retry/backoff policy?\" --json"
             ]
           },
+          {
+            "name": "book",
+            "description": "Knowledge books: ordered collections of pages (summary, add a page)",
+            "commands": [
+              {
+                "name": "add-page",
+                "description": "Add a knowledge page to a book, optionally at a given position in the summary",
+                "options": [
+                  {
+                    "name": "--page",
+                    "description": "Id of the knowledge page to add (an id, not a page number; alias: --page-id)",
+                    "required": true,
+                    "arguments": [
+                      {
+                        "name": "PAGE",
+                        "required": true
+                      }
+                    ]
+                  },
+                  {
+                    "name": "--position",
+                    "description": "Where to put it in the summary (0 = top; omit to append at the end)",
+                    "arguments": [
+                      {
+                        "name": "POSITION",
+                        "required": true
+                      }
+                    ]
+                  }
+                ],
+                "arguments": [
+                  {
+                    "name": "ID",
+                    "required": true,
+                    "description": "Knowledge book id"
+                  }
+                ],
+                "examples": [
+                  "closeyourit kb book add-page <book-id> --page <page-id>",
+                  "closeyourit kb book add-page <book-id> --page <page-id> --position 0",
+                  "closeyourit kb book add-page <book-id> --page <page-id> --json"
+                ]
+              },
+              {
+                "name": "list",
+                "description": "List knowledge books (ordered collections of pages) across the projects you can see",
+                "options": [
+                  {
+                    "name": "--project",
+                    "aliases": [
+                      "-p"
+                    ],
+                    "description": "Filter by project (key or UUID)",
+                    "arguments": [
+                      {
+                        "name": "PROJECT",
+                        "required": true
+                      }
+                    ]
+                  },
+                  {
+                    "name": "--q",
+                    "description": "Filter by title (substring, case-insensitive)",
+                    "arguments": [
+                      {
+                        "name": "Q",
+                        "required": true
+                      }
+                    ]
+                  },
+                  {
+                    "name": "--per",
+                    "description": "Page size",
+                    "arguments": [
+                      {
+                        "name": "PER",
+                        "required": true
+                      }
+                    ]
+                  },
+                  {
+                    "name": "--page",
+                    "description": "Page number",
+                    "arguments": [
+                      {
+                        "name": "PAGE",
+                        "required": true
+                      }
+                    ]
+                  }
+                ],
+                "examples": [
+                  "closeyourit kb book list",
+                  "closeyourit kb book list --project acme-api",
+                  "closeyourit kb book list --q deploy --per 50",
+                  "closeyourit kb book list --json"
+                ]
+              },
+              {
+                "name": "show",
+                "description": "Show a knowledge book: its metadata, then the summary of the pages it collects",
+                "arguments": [
+                  {
+                    "name": "ID",
+                    "required": true,
+                    "description": "Knowledge book id"
+                  }
+                ],
+                "examples": [
+                  "closeyourit kb book show <book-id>",
+                  "closeyourit kb book show <book-id> --json"
+                ]
+              }
+            ]
+          },
           {
             "name": "consolidate",
             "description": "Mark an accepted page as written to the versioned docs, recording its path",
@@ -2688,6 +2803,82 @@
               "closeyourit kb list --awaiting-consolidation"
             ]
           },
+          {
+            "name": "publish",
+            "description": "Idempotently create or update a Knowledge page by publication key.\n\nExactly one of --body or --body-file is required.",
+            "options": [
+              {
+                "name": "--project",
+                "aliases": [
+                  "-p"
+                ],
+                "description": "Project id (UUID) or key",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "PROJECT",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--publication-key",
+                "description": "Stable publication key (1-255 URL-safe characters)",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "PUBLICATION-KEY",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--title",
+                "description": "Page title (max 255 characters)",
+                "required": true,
+                "arguments": [
+                  {
+                    "name": "TITLE",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--kind",
+                "description": "Page kind: note|decision|guide (new page: note; existing: unchanged)",
+                "arguments": [
+                  {
+                    "name": "KIND",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--body",
+                "description": "Page body (markdown, max 4000 characters); exactly one of --body or --body-file is required",
+                "arguments": [
+                  {
+                    "name": "BODY",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "name": "--body-file",
+                "description": "Read the page body (markdown, max 4000 characters) from a local file; exactly one of --body or --body-file is required",
+                "arguments": [
+                  {
+                    "name": "BODY-FILE",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "examples": [
+              "closeyourit kb publish --project CYCL --publication-key docs:release --title \"Release guide\" --body \"Steps…\"",
+              "closeyourit kb publish -p CYCL --publication-key docs:release --title \"Release guide\" --kind guide --body-file ./release.md"
+            ]
+          },
           {
             "name": "related",
             "description": "List the pages to read next: the ones this page links to (and that link to it), plus close matches by meaning",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bussolabs/closeyourit-cli",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "CLI for CloseYourIt — manage org, errors, tokens and tickets with your user token",
   "publishConfig": {
     "access": "public"
@@ -79,6 +79,9 @@
       "kb": {
         "description": "Knowledge base: pages (notes/decisions/guides), semantic search and AI ask"
       },
+      "kb:book": {
+        "description": "Knowledge books: ordered collections of pages (summary, add a page)"
+      },
       "todos": {
         "description": "Personal todo lists: items, sharing, completion"
       },