takibibase 1.5.0 → 1.7.0

package/SKILL.md

@@ -23,6 +23,10 @@ error hints.
 - Projects: `takibi projects` lists what this key can reach. `--project`
   takes a name or a UUID; single-grant keys may omit it.
   `takibi projects --add <name> <uuid>` keeps local aliases for offline use.
+- Folders: `takibi folders [--project …]` lists folder names → uuids for
+  `--folder` (only folders this key's grants touch; single-grant keys may
+  omit `--project`). Discovery flow: `projects` → `folders` → scoped
+  `ask`/`search`/`doc list`.
 - First probe: `takibi version` (needs no key; shows build + `jev` status).
 - Update notice: the CLI polls the npm registry once a day and nudges on
   stderr when behind (never on `--json`).
@@ -75,6 +79,9 @@ back to `search`, try `doc text` on the hits — then either answer from
 evidence or say the evidence is not there. Never fill gaps with generated
 prose presented as sourced.
 
+Split bundled asks: one narrow ask per field — a combined question
+abstains honestly instead of answering halfway.
+
 ## Notes (agent scratchpad, not canon)
 
 - When to use: end-of-run debriefs (problem, what you tried, what worked,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "takibibase",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Thin CLI for the Takibi API: ask, search, tasks, docs, notes. Single file, zero dependencies.",
   "type": "module",
   "bin": {

package/takibi.mjs

@@ -15,6 +15,8 @@
  *   reads the API first and --project resolves names through it. A LOCAL
  *   map (~/.takibi/projects, `name=uuid` lines) remains as the offline
  *   fallback and for custom aliases. UUIDs pass straight through.
+ *   `folders` lists granted folders via GET /v1/projects/:id/folders the
+ *   same way (single-grant keys may omit --project; the CLI defaults it).
  * - There is no GET /v1/tasks/:id, so `tasks get` lists and filters.
  * - Account-only routes (doc download, uploads, deletes) answer 401, not
  *   403, to Bearer callers; `doc download` refuses client-side with a hint.
@@ -34,7 +36,7 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 
 /** Baked fallback; the published package re-reads package.json next door. */
-const BAKED_VERSION = '1.5.0';
+const BAKED_VERSION = '1.7.0';
 const CLI_INFO = (() => {
   try {
     const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
@@ -370,6 +372,7 @@ Commands:
   notes keep <id> <ver>   Endorse a note (expected version)
   notes remove <id> <ver> Discard a note (expected version)
   projects                Granted projects (names -> uuids for --project)
+  folders                 Granted folders (names -> uuids for --folder)
   version                 What build is serving + jev wired|unwired (no key needed)
   skill                   Print the takibi-use agent skill (pipe it to an agent)
   skill --install         Install the skill into agent skills dirs
@@ -566,7 +569,7 @@ async function ctxFor(globals, { needKey, resolveProject = true }) {
   const { warnings } = loadProjectMap();
   for (const w of warnings) err(`warning: ${w}`);
   if (globals.folder !== undefined && globals.folder !== null && globals.folder !== '' && !UUID_RE.test(globals.folder)) {
-    throw usageError(`--folder takes a folder UUID, not ${JSON.stringify(globals.folder)}. (Folder names are not resolvable — keys cannot list folders.)`);
+    throw usageError(`--folder takes a folder UUID, not ${JSON.stringify(globals.folder)}. (Run \`takibi folders\` for this key's folder names.)`);
   }
   return { baseUrl, key, projectId, folder: globals.folder || undefined, json: globals.json, verbose: globals.verbose };
 }
@@ -1085,6 +1088,35 @@ async function cmdProjects(tokens, globals) {
   for (const { name, id } of entries) out(`${name} → ${id}`);
 }
 
+async function cmdFolders(tokens, globals) {
+  if (tokens.length > 0) throw usageError(`Unexpected ${JSON.stringify(tokens[0])}. Usage: takibi folders [--project <name-or-uuid>]`);
+  const ctx = await ctxFor(globals, { needKey: true });
+  let projectId = ctx.projectId;
+  if (!projectId) {
+    // The server cannot default a path param, so single-grant keys resolve
+    // their one project client-side (ask/search default server-side).
+    const data = await api('GET', '/v1/projects', { baseUrl: ctx.baseUrl, key: ctx.key, verbose: ctx.verbose, label: 'projects' });
+    const ids = [...new Set((data?.projects ?? []).map((p) => p?.id).filter(Boolean))];
+    // Tag-only grants list no collections, so an empty list is ambiguous:
+    // the key may hold nothing, or hold tags. Say both, accurately.
+    if (ids.length === 0) throw new CliError('This key lists no projects.', { hint: 'Tag-only keys cannot list collections — pass --project <uuid> explicitly (ask the account owner for the id), or grant this profile a collection or folder.' });
+    if (ids.length > 1) throw usageError('This key spans projects — pass --project <name-or-uuid>.');
+    projectId = ids[0];
+  }
+  const data = await api('GET', `/v1/projects/${projectId}/folders`, { baseUrl: ctx.baseUrl, key: ctx.key, verbose: ctx.verbose, label: 'folders' });
+  if (ctx.json) {
+    out(JSON.stringify(data, null, 2));
+    return;
+  }
+  const entries = data?.folders ?? [];
+  if (!entries.length) {
+    out('No folders found.');
+    err('(This project has no folders this key can reach. Tag-only keys see only folders holding their tagged files.)');
+    return;
+  }
+  for (const f of entries) out(`${f.name} → ${f.id}`);
+}
+
 async function cmdVersion(globals) {
   const baseUrl = resolveBaseUrl();
   const data = await api('GET', '/version', { baseUrl, verbose: globals.verbose, label: 'version' });
@@ -1238,6 +1270,7 @@ async function main(argv) {
   if (cmd === 'doc' || cmd === 'docs') return cmdDoc(tokens, globals);
   if (cmd === 'notes' || cmd === 'note') return cmdNotes(tokens, globals);
   if (cmd === 'projects') return cmdProjects(tokens, globals);
+  if (cmd === 'folders' || cmd === 'folder') return cmdFolders(tokens, globals);
   if (cmd === 'version') return cmdVersion(globals);
   if (cmd === 'skill') return cmdSkill(tokens, globals);
   throw usageError(`Unknown command ${JSON.stringify(cmd)}. See \`takibi --help\`.`);