@kiipu/cli 0.0.7 → 0.0.9

package/dist/lib/ask-formatters.js

@@ -0,0 +1,114 @@
+function formatTimestamp(value) {
+    if (!value) {
+        return 'unknown time';
+    }
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        return value;
+    }
+    return parsed.toLocaleString('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+}
+function truncate(value, maxLength) {
+    const normalized = value.trim().replace(/\s+/g, ' ');
+    if (normalized.length <= maxLength) {
+        return normalized;
+    }
+    return `${normalized.slice(0, maxLength - 3)}...`;
+}
+function formatSourceLine(source) {
+    const title = source.title?.trim() || '(untitled)';
+    const score = Number.isFinite(source.score) ? ` score ${source.score.toFixed(3)}` : '';
+    return `[${source.index}] ${title} (${source.noteId})${score}`;
+}
+export function formatAskFooter(input) {
+    const lines = ['', 'Sources:'];
+    if (input.sources.length === 0) {
+        lines.push('  none');
+    }
+    else {
+        for (const source of input.sources) {
+            lines.push(`  ${formatSourceLine(source)}`);
+            lines.push(`    ${truncate(source.snippet, 140)}`);
+        }
+    }
+    const usage = input.usage;
+    if (usage) {
+        lines.push('', `Usage: input ${usage.inputTokens}, output ${usage.outputTokens}, latency ${usage.latencyMs}ms`);
+    }
+    if (input.conversationId) {
+        lines.push(`Conversation: ${input.conversationId}`);
+    }
+    if (input.title) {
+        lines.push(`Title: ${input.title}`);
+    }
+    if (input.turnId) {
+        lines.push(`Turn: ${input.turnId}`);
+    }
+    return lines.join('\n');
+}
+export function formatConversationHistory(title, conversations, nextCursor) {
+    const lines = [title, ''];
+    if (conversations.length === 0) {
+        lines.push('No Ask conversations found.');
+        return lines.join('\n');
+    }
+    for (const item of conversations) {
+        const label = item.title?.trim() || truncate(item.preview, 80) || '(untitled)';
+        const flags = [item.pinnedAt ? 'pinned' : '', item.archivedAt ? 'archived' : '']
+            .filter(Boolean)
+            .join(', ');
+        lines.push(`${item.id}  ${formatTimestamp(item.lastMessageAt)}`);
+        lines.push(`  ${label}`);
+        if (flags) {
+            lines.push(`  flags: ${flags}`);
+        }
+        lines.push('');
+    }
+    if (nextCursor) {
+        lines.push(`Next cursor: ${nextCursor}`);
+    }
+    if (!nextCursor && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines.join('\n');
+}
+function formatTurn(turn) {
+    const role = turn.role === 'user' ? 'User' : 'Assistant';
+    const lines = [`${role} ${turn.id}  ${formatTimestamp(turn.createdAt)}  status: ${turn.status}`];
+    if (turn.errorCode) {
+        lines.push(`error: ${turn.errorCode}`);
+    }
+    lines.push(turn.content.trim() || '(empty)');
+    if (turn.sources && turn.sources.length > 0) {
+        lines.push('sources:');
+        for (const source of turn.sources) {
+            lines.push(`  ${formatSourceLine(source)}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function formatConversationDetail(detail) {
+    const lines = [
+        detail.title?.trim() || '(untitled Ask conversation)',
+        '',
+        `id: ${detail.id}`,
+        `created: ${formatTimestamp(detail.createdAt)}`,
+        `updated: ${formatTimestamp(detail.lastMessageAt)}`,
+        '',
+    ];
+    if (detail.turns.length === 0) {
+        lines.push('No turns found.');
+    }
+    else {
+        for (const turn of detail.turns) {
+            lines.push(formatTurn(turn), '');
+        }
+    }
+    return lines.slice(0, -1).join('\n');
+}

package/dist/lib/kiipu-integration-client.js

@@ -9,40 +9,46 @@ function buildError(requestId, message, code = 'request_failed') {
         },
     };
 }
-function parseCreatePostRequest(input) {
+function parseCreateNoteRequest(input) {
     const requestId = typeof input.requestId === 'string' ? input.requestId : randomUUID();
     const rawText = typeof input.rawText === 'string' ? input.rawText.trim() : '';
     if (!rawText) {
         throw new Error('rawText is required.');
     }
     const visibility = input.visibility;
-    const tags = Array.isArray(input.tags) ? input.tags.filter((tag) => typeof tag === 'string') : [];
+    const tags = Array.isArray(input.tags)
+        ? input.tags.filter((tag) => typeof tag === 'string')
+        : [];
     return {
         requestId,
         requestedAt: typeof input.requestedAt === 'string' ? input.requestedAt : undefined,
         traceId: typeof input.traceId === 'string' ? input.traceId : undefined,
         rawText,
-        sourceType: input.sourceType === 'manual' || input.sourceType === 'imported' || input.sourceType === 'skill_command'
+        sourceType: input.sourceType === 'manual' ||
+            input.sourceType === 'imported' ||
+            input.sourceType === 'skill_command'
             ? input.sourceType
             : 'skill_command',
         finalText: typeof input.finalText === 'string' ? input.finalText : undefined,
-        visibility: visibility === 'unlisted' || visibility === 'private' || visibility === 'public' ? visibility : 'public',
+        visibility: visibility === 'unlisted' || visibility === 'private' || visibility === 'public'
+            ? visibility
+            : 'public',
         sourceMessageId: typeof input.sourceMessageId === 'string' ? input.sourceMessageId : undefined,
         title: typeof input.title === 'string' ? input.title : input.title === null ? null : undefined,
         tags,
     };
 }
-function parsePostMutationRequest(input) {
+function parseNoteMutationRequest(input) {
     const requestId = typeof input.requestId === 'string' ? input.requestId : randomUUID();
-    const postId = typeof input.postId === 'string' ? input.postId.trim() : '';
-    if (!postId) {
-        throw new Error('postId is required.');
+    const noteId = typeof input.noteId === 'string' ? input.noteId.trim() : '';
+    if (!noteId) {
+        throw new Error('noteId is required.');
     }
     return {
         requestId,
         requestedAt: typeof input.requestedAt === 'string' ? input.requestedAt : undefined,
         traceId: typeof input.traceId === 'string' ? input.traceId : undefined,
-        postId,
+        noteId,
     };
 }
 export class KiipuIntegrationApiClient {
@@ -87,19 +93,19 @@ export class KiipuIntegrationApiClient {
                     ? payload.code
                     : 'request_failed');
     }
-    createPost(input) {
-        return this.request('/integrations/posts', 'POST', parseCreatePostRequest(input));
+    createNote(input) {
+        return this.request('/integrations/notes', 'POST', parseCreateNoteRequest(input));
     }
-    deletePost(input) {
-        const body = parsePostMutationRequest(input);
-        return this.request(`/integrations/posts/${body.postId}/delete`, 'POST', body);
+    deleteNote(input) {
+        const body = parseNoteMutationRequest(input);
+        return this.request(`/integrations/notes/${body.noteId}/delete`, 'POST', body);
     }
-    restorePost(input) {
-        const body = parsePostMutationRequest(input);
-        return this.request(`/integrations/posts/${body.postId}/restore`, 'POST', body);
+    restoreNote(input) {
+        const body = parseNoteMutationRequest(input);
+        return this.request(`/integrations/notes/${body.noteId}/restore`, 'POST', body);
     }
-    permanentDeletePost(input) {
-        const body = parsePostMutationRequest(input);
-        return this.request(`/integrations/posts/${body.postId}/permanent-delete`, 'POST', body);
+    permanentDeleteNote(input) {
+        const body = parseNoteMutationRequest(input);
+        return this.request(`/integrations/notes/${body.noteId}/permanent-delete`, 'POST', body);
     }
 }

package/dist/lib/kiipu-user-client.js

@@ -72,34 +72,34 @@ export class KiipuUserApiClient {
             body: JSON.stringify(input),
         });
     }
-    listPosts(input) {
-        return this.request(this.buildPath('/posts/me', input));
+    listNotes(input) {
+        return this.request(this.buildPath('/notes/me', input));
     }
-    searchPosts(query) {
-        return this.request(this.buildPath('/posts/me/search', { q: query }));
+    searchNotes(query) {
+        return this.request(this.buildPath('/notes/me/search', { q: query }));
     }
-    listStarredPosts(input) {
-        return this.request(this.buildPath('/posts/me/starred', input));
+    listStarredNotes(input) {
+        return this.request(this.buildPath('/notes/me/starred', input));
     }
-    listDeletedPosts(input) {
-        return this.request(this.buildPath('/posts/me/deleted', input));
+    listDeletedNotes(input) {
+        return this.request(this.buildPath('/notes/me/deleted', input));
     }
-    getPost(id) {
-        return this.request(`/posts/${id}`);
+    getNote(id) {
+        return this.request(`/notes/${id}`);
     }
-    updatePost(id, input) {
-        return this.request(`/posts/${id}/content`, {
+    updateNote(id, input) {
+        return this.request(`/notes/${id}/content`, {
             method: 'PATCH',
             body: JSON.stringify(input),
         });
     }
     toggleStar(id) {
-        return this.request(`/posts/${id}/star`, {
+        return this.request(`/notes/${id}/star`, {
             method: 'PATCH',
         });
     }
     togglePin(id) {
-        return this.request(`/posts/${id}/pin`, {
+        return this.request(`/notes/${id}/pin`, {
             method: 'PATCH',
         });
     }

package/dist/lib/{post-actions.js → note-actions.js}

@@ -3,7 +3,7 @@ import { KiipuIntegrationApiClient } from './kiipu-integration-client.js';
 function formatRequestFailed(message, code) {
     return `Request failed: ${message} (${code}).`;
 }
-function getPostApiClient(config) {
+function getNoteApiClient(config) {
     const apiKey = config.apiKey ?? process.env.KIIPU_API_KEY ?? '';
     if (!apiKey) {
         return {
@@ -20,16 +20,16 @@ function getPostApiClient(config) {
         }),
     };
 }
-export async function executePostAction(config, input) {
-    const { client, error } = getPostApiClient(config);
+export async function executeNoteAction(config, input) {
+    const { client, error } = getNoteApiClient(config);
     if (!client) {
         return error;
     }
     if (input.action === 'create') {
-        const response = await client.createPost({
+        const response = await client.createNote({
             requestId: randomUUID(),
             requestedAt: new Date().toISOString(),
-            traceId: `${input.traceIdPrefix ?? 'post'}-${Date.now()}`,
+            traceId: `${input.traceIdPrefix ?? 'note'}-${Date.now()}`,
             rawText: input.content,
             sourceType: 'skill_command',
             sourceMessageId: input.sourceMessageId ?? `local-${Date.now()}`,
@@ -44,18 +44,18 @@ export async function executePostAction(config, input) {
         }
         return {
             ok: true,
-            message: `Post published. Post id ${String(response.data.id)} is now visible in the feed.`,
+            message: `Note created. Note id ${String(response.data.id)} is now visible in the feed.`,
             data: response.data,
             requestId: response.requestId,
-            postId: String(response.data.id),
+            noteId: String(response.data.id),
         };
     }
     if (input.action === 'delete') {
-        const response = await client.deletePost({
+        const response = await client.deleteNote({
             requestId: randomUUID(),
             requestedAt: new Date().toISOString(),
             traceId: `${input.traceIdPrefix ?? 'delete'}-${Date.now()}`,
-            postId: input.postId,
+            noteId: input.noteId,
         });
         if (!response.ok) {
             return {
@@ -65,18 +65,18 @@ export async function executePostAction(config, input) {
         }
         return {
             ok: true,
-            message: 'Post deleted. The current post is no longer visible in the feed.',
+            message: 'Note deleted. The current note is no longer visible in the feed.',
             data: response.data,
             requestId: response.requestId,
-            postId: null,
+            noteId: null,
         };
     }
     if (input.action === 'restore') {
-        const response = await client.restorePost({
+        const response = await client.restoreNote({
             requestId: randomUUID(),
             requestedAt: new Date().toISOString(),
             traceId: `${input.traceIdPrefix ?? 'restore'}-${Date.now()}`,
-            postId: input.postId,
+            noteId: input.noteId,
         });
         if (!response.ok) {
             return {
@@ -86,17 +86,17 @@ export async function executePostAction(config, input) {
         }
         return {
             ok: true,
-            message: `Post restored. Post id ${input.postId} is now back in the feed.`,
+            message: `Note restored. Note id ${input.noteId} is now back in the feed.`,
             data: response.data,
             requestId: response.requestId,
-            postId: input.postId,
+            noteId: input.noteId,
         };
     }
-    const response = await client.permanentDeletePost({
+    const response = await client.permanentDeleteNote({
         requestId: randomUUID(),
         requestedAt: new Date().toISOString(),
         traceId: `${input.traceIdPrefix ?? 'purge'}-${Date.now()}`,
-        postId: input.postId,
+        noteId: input.noteId,
     });
     if (!response.ok) {
         return {
@@ -106,9 +106,9 @@ export async function executePostAction(config, input) {
     }
     return {
         ok: true,
-        message: `Post permanently deleted. Post id ${input.postId} has been removed from the database.`,
+        message: `Note permanently deleted. Note id ${input.noteId} has been removed from the database.`,
         data: response.data,
         requestId: response.requestId,
-        postId: null,
+        noteId: null,
     };
 }

package/dist/lib/{post-formatters.js → note-formatters.js}

@@ -23,52 +23,55 @@ function formatTags(tags, limit) {
         : [];
     return normalized.length > 0 ? normalized.map((tag) => `#${tag}`).join(', ') : 'none';
 }
-function getPostPreview(post) {
-    const content = (post.title?.trim() || post.finalText?.trim() || post.rawText?.trim() || '').replace(/\s+/g, ' ');
+function getNotePreview(note) {
+    const content = (note.title?.trim() ||
+        note.finalText?.trim() ||
+        note.rawText?.trim() ||
+        '').replace(/\s+/g, ' ');
     if (!content) {
         return '(empty)';
     }
     return content.length > 100 ? `${content.slice(0, 97)}...` : content;
 }
-function getStatusFlags(post) {
+function getStatusFlags(note) {
     const flags = [];
-    if (post.isPinned) {
+    if (note.isPinned) {
         flags.push('pinned');
     }
-    if (post.isStarred) {
+    if (note.isStarred) {
         flags.push('starred');
     }
     return flags.length > 0 ? flags.join(', ') : 'none';
 }
-export function formatPostCollection(title, posts) {
+export function formatNoteCollection(title, notes) {
     const lines = [title, ''];
-    if (posts.length === 0) {
-        lines.push('No posts found.');
+    if (notes.length === 0) {
+        lines.push('No notes found.');
         return lines.join('\n');
     }
-    for (const post of posts) {
-        lines.push(`${post.id}  ${formatTimestamp(post.updatedAt ?? post.createdAt)}`);
-        lines.push(`  flags: ${getStatusFlags(post)}  visibility: ${post.visibility}  tags: ${formatTags(post.tags, 3)}`);
-        lines.push(`  ${getPostPreview(post)}`);
+    for (const note of notes) {
+        lines.push(`${note.id}  ${formatTimestamp(note.updatedAt ?? note.createdAt)}`);
+        lines.push(`  flags: ${getStatusFlags(note)}  visibility: ${note.visibility}  tags: ${formatTags(note.tags, 3)}`);
+        lines.push(`  ${getNotePreview(note)}`);
         lines.push('');
     }
     return lines.slice(0, -1).join('\n');
 }
-export function formatPostDetail(post) {
-    const title = post.title?.trim() || '(untitled)';
-    const body = post.finalText?.trim() || post.rawText?.trim() || '(empty)';
+export function formatNoteDetail(note) {
+    const title = note.title?.trim() || '(untitled)';
+    const body = note.finalText?.trim() || note.rawText?.trim() || '(empty)';
     return [
         title,
         '',
         body,
         '',
-        `id: ${post.id}`,
-        `visibility: ${post.visibility}`,
-        `created: ${formatTimestamp(post.createdAt)}`,
-        `updated: ${formatTimestamp(post.updatedAt)}`,
-        `tags: ${formatTags(post.tags)}`,
-        `folder: ${post.folder ? `${post.folder.name} (${post.folder.id})` : 'none'}`,
-        `pinned: ${post.isPinned ? 'yes' : 'no'}`,
-        `starred: ${post.isStarred ? 'yes' : 'no'}`,
+        `id: ${note.id}`,
+        `visibility: ${note.visibility}`,
+        `created: ${formatTimestamp(note.createdAt)}`,
+        `updated: ${formatTimestamp(note.updatedAt)}`,
+        `tags: ${formatTags(note.tags)}`,
+        `folder: ${note.folder ? `${note.folder.name} (${note.folder.id})` : 'none'}`,
+        `pinned: ${note.isPinned ? 'yes' : 'no'}`,
+        `starred: ${note.isStarred ? 'yes' : 'no'}`,
     ].join('\n');
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kiipu/cli",
-  "version": "0.0.7",
-  "description": "Kiipu CLI for local authentication, doctor checks, and direct post actions.",
+  "version": "0.0.9",
+  "description": "Kiipu CLI for local authentication, doctor checks, and direct note actions.",
   "license": "MIT",
   "type": "module",
   "repository": {