@dinoxx/dinox-cli 2.1.1 → 2.2.0

package/dist/commands/notes/actions.js

@@ -39,11 +39,17 @@ async function executeNoteUpdateOperation(args) {
         await syncBeforeNoteCommand(runtime);
         const durability = resolveWriteDurabilityForRuntime(runtime, args.durability);
         const ids = await parseTargetNoteIds(args.id, args.idsOption, 'update');
+        const hasTitle = typeof args.title === 'string';
         const hasTags = typeof args.tagsOption === 'string';
         const hasBoxes = typeof args.boxOption === 'string';
         const hasStarred = typeof args.starred === 'boolean';
-        if (!hasTags && !hasBoxes && !hasStarred) {
-            throw new DinoxError('At least one option is required: --tags, --boxes, or --starred');
+        if (!hasTitle && !hasTags && !hasBoxes && !hasStarred) {
+            throw new DinoxError('At least one option is required: --title, --tags, --boxes, or --starred');
+        }
+        if (hasTitle && ids.length !== 1) {
+            throw new DinoxError('--title can only be used with a single note id; run one `dino note update <id> --title` per note', {
+                code: 'USAGE_ERROR',
+            });
         }
         const requestedTags = hasTags
             ? await parseMutationListInput(args.tagsOption, '--tags')
@@ -68,6 +74,7 @@ async function executeNoteUpdateOperation(args) {
                 offline,
                 userId: tagUserId,
                 ids,
+                title: args.title,
                 tagsInput: tags,
                 zettelBoxNames: requestedBoxNames,
                 starred: hasStarred ? args.starred : undefined,
@@ -81,6 +88,7 @@ async function executeNoteUpdateOperation(args) {
         for (const targetId of ids) {
             results.push(await updateNote(db, {
                 id: targetId,
+                title: args.title,
                 tags,
                 zettelBoxIds,
                 starred: hasStarred ? args.starred : undefined,
@@ -98,6 +106,7 @@ async function executeNoteUpdateOperation(args) {
             results: results.map((item) => ({
                 id: item.id,
                 updated: item.updated,
+                title: item.title,
                 tags: item.tags,
                 boxes: item.zettelBoxIds,
                 is_starred: item.is_starred,
@@ -452,6 +461,17 @@ export async function runNoteDelete({ command, options, args }) {
         printStaleCacheWarning(runtime);
     });
 }
+// Titles are single-line metadata; reject input that would render as a multi-line title.
+function parseNoteTitleOption(raw) {
+    const title = raw.trim();
+    if (!title) {
+        throw new DinoxError('--title must not be empty', { code: 'USAGE_ERROR' });
+    }
+    if (/[\u0000-\u001f\u007f]/.test(title)) {
+        throw new DinoxError('--title must be a single line without control characters', { code: 'USAGE_ERROR' });
+    }
+    return title;
+}
 export async function runNoteUpdate({ command, options, args }) {
     const updateOptions = options;
     await executeNoteUpdateOperation({
@@ -463,6 +483,9 @@ export async function runNoteUpdate({ command, options, args }) {
         starred: typeof updateOptions.starred === 'string'
             ? parseStarredOption(updateOptions.starred, '--starred')
             : undefined,
+        title: typeof updateOptions.title === 'string'
+            ? parseNoteTitleOption(updateOptions.title)
+            : undefined,
         tagsOption: updateOptions.tags,
         commandName: 'dino note update',
         actionName: 'update_note',

package/dist/commands/notes/descriptors.js

@@ -202,10 +202,11 @@ export const noteCommandGroup = {
         },
         {
             name: 'update',
-            description: 'Full-replace note metadata for explicit note ids',
+            description: 'Full-replace note metadata (title, tags, boxes, starred) for explicit note ids',
             arguments: [{ syntax: '[id]', description: 'Optional note id for single-note full replacement' }],
             options: [
                 { flags: '--ids <string|@file>', description: 'Batch note ids (JSON array or comma/newline-separated)', type: 'string' },
+                { flags: '--title <title>', description: 'Replace the note title (single note id only; content is unchanged)', type: 'string' },
                 { flags: '--tags <string|@file>', description: 'Replace the entire tag list; use [] to clear all tags', type: 'string' },
                 { flags: '--boxes <string|@file>', description: 'Replace the entire box list; use [] to clear all boxes', type: 'string' },
                 { flags: '--starred <true|false>', description: 'Replace the starred state', type: 'string', enum: ['true', 'false'] },
@@ -224,6 +225,7 @@ export const noteCommandGroup = {
                 },
                 examples: [
                     'dino note update <id> --tags "work,ai" --format json --dry-run',
+                    'dino note update <id> --title "New title" --format json --dry-run',
                     'dino note update --ids @/tmp/note-ids.txt --boxes "Inbox" --starred true --format json',
                 ],
             },

package/dist/commands/notes/dryRun.d.ts

@@ -18,6 +18,7 @@ export declare function buildNoteUpdateDryRunPreview(args: {
     offline: boolean;
     userId?: string;
     ids: string[];
+    title?: string;
     tagsInput?: string[];
     zettelBoxNames?: string[];
     starred?: boolean;

package/dist/commands/notes/dryRun.js

@@ -67,9 +67,14 @@ export async function buildNoteUpdateDryRunPreview(args) {
         const nextBoxes = Array.isArray(args.zettelBoxNames) ? normalizeDistinctStrings(args.zettelBoxNames) : note.zettel_boxes;
         const tagsTo = nextTags ?? currentTags;
         const starredTo = typeof args.starred === 'boolean' ? args.starred : note.is_starred;
+        const titleFrom = note.title ?? '';
+        const titleTo = typeof args.title === 'string' ? args.title : titleFrom;
         return {
             id: note.id,
-            title: note.title ?? '',
+            title: titleFrom,
+            ...(typeof args.title === 'string'
+                ? { title_from: titleFrom, title_to: titleTo, title_changed: titleFrom !== titleTo }
+                : {}),
             tags_from: currentTags,
             tags_to: tagsTo,
             tags_changed: Array.isArray(args.tagsInput) ? !sameNormalizedSet(currentTags, tagsTo) : false,
@@ -81,7 +86,7 @@ export async function buildNoteUpdateDryRunPreview(args) {
             starred_changed: typeof args.starred === 'boolean' ? note.is_starred !== starredTo : false,
         };
     });
-    const changedCount = changes.filter((item) => item.tags_changed || item.boxes_changed || item.starred_changed).length;
+    const changedCount = changes.filter((item) => item.title_changed === true || item.tags_changed || item.boxes_changed || item.starred_changed).length;
     return {
         dry_run: true,
         command: args.commandName,
@@ -91,6 +96,7 @@ export async function buildNoteUpdateDryRunPreview(args) {
         warnings: buildExecutionWarnings(args.config, args.offline),
         inputs: {
             ids: args.ids,
+            ...(typeof args.title === 'string' ? { title: args.title } : {}),
             ...(Array.isArray(args.tagsInput) ? { tags: nextTags } : {}),
             ...(Array.isArray(args.zettelBoxNames) ? { boxes: normalizeDistinctStrings(args.zettelBoxNames) } : {}),
             ...(typeof args.starred === 'boolean' ? { starred: args.starred } : {}),

package/dist/commands/notes/repo/shared.d.ts

@@ -163,6 +163,7 @@ export type NotePreview = {
 };
 export type NoteUpdateStateRow = {
     id: string;
+    title: string | null;
     tags: string | null;
     zettel_boxes: string | null;
     is_del: number | null;
@@ -176,6 +177,7 @@ export type UpdateNoteResult = {
     id: string;
     updated: boolean;
     changed: string[];
+    title: string;
     tags: string[];
     zettelBoxIds: string[];
     is_starred: boolean;

package/dist/commands/notes/repo/write.d.ts

@@ -16,6 +16,7 @@ export declare function createNote(db: AbstractPowerSyncDatabase, input: {
 }>;
 export declare function updateNote(db: AbstractPowerSyncDatabase, input: {
     id: string;
+    title?: string;
     tags?: string[];
     zettelBoxIds?: string[];
     starred?: boolean;

package/dist/commands/notes/repo/write.js

@@ -124,14 +124,15 @@ export async function updateNote(db, input) {
     if (!id) {
         throw new DinoxError('Note id is required');
     }
+    const shouldUpdateTitle = typeof input.title === 'string';
     const shouldUpdateTags = Array.isArray(input.tags);
     const shouldUpdateBoxes = Array.isArray(input.zettelBoxIds);
     const shouldUpdateStarred = typeof input.starred === 'boolean';
-    if (!shouldUpdateTags && !shouldUpdateBoxes && !shouldUpdateStarred) {
-        throw new DinoxError('At least one field is required: tags, boxes, or starred');
+    if (!shouldUpdateTitle && !shouldUpdateTags && !shouldUpdateBoxes && !shouldUpdateStarred) {
+        throw new DinoxError('At least one field is required: title, tags, boxes, or starred');
     }
     const existing = await db.getOptional(`
-    SELECT id, tags, zettel_boxes, is_del, starred_at
+    SELECT id, title, tags, zettel_boxes, is_del, starred_at
     FROM c_note
     WHERE id = ?
     `, [id]);
@@ -141,20 +142,24 @@ export async function updateNote(db, input) {
     if (typeof existing.is_del === 'number' && existing.is_del !== 0) {
         throw new DinoxError(`Note has been deleted: ${id}`);
     }
+    const currentTitle = existing.title ?? '';
     const currentTags = parseStoredTags(existing.tags);
     const currentZettelBoxIds = parseZettelBoxIds(existing.zettel_boxes);
     const currentStarred = existing.starred_at !== null;
+    const nextTitle = shouldUpdateTitle ? input.title : currentTitle;
     const nextTags = shouldUpdateTags ? normalizeDistinctStrings(input.tags) : currentTags;
     const nextZettelBoxIds = shouldUpdateBoxes ? normalizeDistinctStrings(input.zettelBoxIds) : currentZettelBoxIds;
     const nextStarred = shouldUpdateStarred ? input.starred : currentStarred;
+    const titleChanged = shouldUpdateTitle && currentTitle !== nextTitle;
     const tagsChanged = shouldUpdateTags && !sameTagSet(currentTags, nextTags);
     const boxesChanged = shouldUpdateBoxes && !sameStringSet(currentZettelBoxIds, nextZettelBoxIds);
     const starredChanged = shouldUpdateStarred && currentStarred !== nextStarred;
-    if (!tagsChanged && !boxesChanged && !starredChanged) {
+    if (!titleChanged && !tagsChanged && !boxesChanged && !starredChanged) {
         return {
             id,
             updated: false,
             changed: [],
+            title: currentTitle,
             tags: currentTags,
             zettelBoxIds: currentZettelBoxIds,
             is_starred: currentStarred,
@@ -162,6 +167,10 @@ export async function updateNote(db, input) {
     }
     const setParts = [];
     const params = [];
+    if (titleChanged) {
+        setParts.push('title = ?');
+        params.push(nextTitle);
+    }
     if (tagsChanged) {
         setParts.push('tags = ?');
         params.push(JSON.stringify(nextTags));
@@ -190,10 +199,12 @@ export async function updateNote(db, input) {
         id,
         updated: true,
         changed: [
+            ...(titleChanged ? ['title'] : []),
             ...(tagsChanged ? ['tags'] : []),
             ...(boxesChanged ? ['boxes'] : []),
             ...(starredChanged ? ['is_starred'] : []),
         ],
+        title: nextTitle,
         tags: nextTags,
         zettelBoxIds: nextZettelBoxIds,
         is_starred: nextStarred,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dinoxx/dinox-cli",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Dinox CLI",
   "main": "dist/dinox.js",
   "scripts": {