@dinoxx/dinox-cli 1.1.1 → 2.1.0

package/dist/utils/errorCodes.d.ts

@@ -0,0 +1,311 @@
+export type ErrorCodeDefinition = Readonly<{
+    exitCode: 1 | 2 | 3 | 4 | 5;
+    description: string;
+}>;
+export declare const ERROR_CODES: {
+    readonly ALREADY_EXISTS: {
+        readonly exitCode: 5;
+        readonly description: "The target resource already exists.";
+    };
+    readonly AUTH_INVALID: {
+        readonly exitCode: 3;
+        readonly description: "The configured credentials were rejected.";
+    };
+    readonly AUTH_REQUIRED: {
+        readonly exitCode: 3;
+        readonly description: "The command needs an authenticated Dinox account.";
+    };
+    readonly AUTH_STATE_CHANGED: {
+        readonly exitCode: 3;
+        readonly description: "Authentication changed while the command was running.";
+    };
+    readonly CACHE_CLEANUP_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "Local cache cleanup after logout did not complete.";
+    };
+    readonly COMMAND_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "Generic command failure without a more specific code.";
+    };
+    readonly CONFIG_INVALID_JSON: {
+        readonly exitCode: 1;
+        readonly description: "The CLI config file is not valid JSON.";
+    };
+    readonly CONFIG_WRITE_BUSY: {
+        readonly exitCode: 1;
+        readonly description: "Another process is writing the CLI config.";
+    };
+    readonly DAEMON_ERROR: {
+        readonly exitCode: 5;
+        readonly description: "The background daemon reported an error.";
+    };
+    readonly DAEMON_INSTANCE_CHANGED: {
+        readonly exitCode: 1;
+        readonly description: "The daemon instance changed between requests.";
+    };
+    readonly DAEMON_INSTANCE_MISMATCH: {
+        readonly exitCode: 1;
+        readonly description: "The running daemon belongs to a different CLI version or account.";
+    };
+    readonly DAEMON_INSTANCE_UNKNOWN: {
+        readonly exitCode: 1;
+        readonly description: "The daemon identity could not be verified.";
+    };
+    readonly DAEMON_LEGACY_UNVERIFIED: {
+        readonly exitCode: 1;
+        readonly description: "A daemon from an older CLI could not be verified safely.";
+    };
+    readonly DAEMON_RELEASE_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The daemon could not release database ownership.";
+    };
+    readonly DAEMON_RELEASE_TIMEOUT: {
+        readonly exitCode: 1;
+        readonly description: "The daemon did not release database ownership in time.";
+    };
+    readonly DAEMON_STALE: {
+        readonly exitCode: 5;
+        readonly description: "The daemon state is stale and needs a restart.";
+    };
+    readonly DAEMON_START_FAILED: {
+        readonly exitCode: 5;
+        readonly description: "The daemon process failed to start.";
+    };
+    readonly DAEMON_START_TIMEOUT: {
+        readonly exitCode: 1;
+        readonly description: "The daemon did not become ready in time.";
+    };
+    readonly DAEMON_STOP_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The daemon could not be stopped.";
+    };
+    readonly DAEMON_UNAVAILABLE: {
+        readonly exitCode: 1;
+        readonly description: "The daemon is not available for this request.";
+    };
+    readonly DAEMON_UNREACHABLE: {
+        readonly exitCode: 1;
+        readonly description: "The daemon socket could not be reached.";
+    };
+    readonly INTERNAL_ERROR: {
+        readonly exitCode: 1;
+        readonly description: "Unexpected internal error; not a DinoxError.";
+    };
+    readonly INVALID_ARGUMENT: {
+        readonly exitCode: 2;
+        readonly description: "An argument or option value is invalid.";
+    };
+    readonly INVALID_STORAGE_KEY: {
+        readonly exitCode: 2;
+        readonly description: "The storage object key is invalid.";
+    };
+    readonly NOTE_INVALID_PROPERTIES: {
+        readonly exitCode: 1;
+        readonly description: "Note properties are invalid.";
+    };
+    readonly NOTE_NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "The note does not exist or is deleted.";
+    };
+    readonly NOTE_TEMPLATE_INVALID_CONTENT: {
+        readonly exitCode: 1;
+        readonly description: "The note template content is invalid.";
+    };
+    readonly NOTE_TEMPLATE_INVALID_PROPERTY_DEF: {
+        readonly exitCode: 1;
+        readonly description: "A note template property definition is invalid.";
+    };
+    readonly NOTE_TEMPLATE_INVALID_TOKEN_CONTEXT: {
+        readonly exitCode: 1;
+        readonly description: "A note template token is used in an invalid context.";
+    };
+    readonly NOTE_TEMPLATE_UNSUPPORTED_PROPERTY_DEF_VERSION: {
+        readonly exitCode: 1;
+        readonly description: "The note template property definition version is unsupported.";
+    };
+    readonly NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "The requested resource was not found.";
+    };
+    readonly POWERSYNC_OWNER_BUSY: {
+        readonly exitCode: 1;
+        readonly description: "Another process owns the local PowerSync database.";
+    };
+    readonly PRECONDITION_FAILED: {
+        readonly exitCode: 5;
+        readonly description: "A safety precondition for the operation did not hold.";
+    };
+    readonly SAVED_VIEW_FILTER_TOO_COMPLEX: {
+        readonly exitCode: 1;
+        readonly description: "The saved view filter exceeds supported complexity.";
+    };
+    readonly SAVED_VIEW_FILTER_VALUE_REQUIRED: {
+        readonly exitCode: 5;
+        readonly description: "A saved view filter condition is missing its value.";
+    };
+    readonly SAVED_VIEW_INVALID_CONFIG: {
+        readonly exitCode: 1;
+        readonly description: "The saved view config is invalid.";
+    };
+    readonly SAVED_VIEW_INVALID_DATE_VALUE: {
+        readonly exitCode: 1;
+        readonly description: "A saved view date value is not a real calendar date.";
+    };
+    readonly SAVED_VIEW_INVALID_FIELD: {
+        readonly exitCode: 1;
+        readonly description: "A saved view references an invalid field.";
+    };
+    readonly SAVED_VIEW_INVALID_FILTER: {
+        readonly exitCode: 1;
+        readonly description: "The saved view filter is invalid.";
+    };
+    readonly SAVED_VIEW_INVALID_ROW: {
+        readonly exitCode: 1;
+        readonly description: "A stored saved view row is invalid.";
+    };
+    readonly SAVED_VIEW_NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "The saved view does not exist.";
+    };
+    readonly SAVED_VIEW_OPERATOR_TYPE_MISMATCH: {
+        readonly exitCode: 1;
+        readonly description: "A filter operator is not valid for the field type.";
+    };
+    readonly SAVED_VIEW_OPTION_NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "A select option id referenced by the view does not exist.";
+    };
+    readonly SAVED_VIEW_PROPERTY_CONFIG_INVALID: {
+        readonly exitCode: 1;
+        readonly description: "A property configuration used by the view is invalid.";
+    };
+    readonly SAVED_VIEW_PROPERTY_INVALID: {
+        readonly exitCode: 1;
+        readonly description: "A property used by the view is invalid.";
+    };
+    readonly SAVED_VIEW_PROPERTY_NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "A property referenced by the view does not exist.";
+    };
+    readonly SAVED_VIEW_PROPERTY_OPTIONS_INVALID: {
+        readonly exitCode: 1;
+        readonly description: "Property options used by the view are invalid.";
+    };
+    readonly SAVED_VIEW_PROPERTY_OPTIONS_MIGRATION_REQUIRED: {
+        readonly exitCode: 5;
+        readonly description: "Property options need migration before use.";
+    };
+    readonly SAVED_VIEW_SORT_TYPE_UNSUPPORTED: {
+        readonly exitCode: 1;
+        readonly description: "The field type cannot be sorted.";
+    };
+    readonly SAVED_VIEW_UNSUPPORTED_CONFIG_VERSION: {
+        readonly exitCode: 1;
+        readonly description: "The saved view config version is unsupported.";
+    };
+    readonly SAVED_VIEW_UNSUPPORTED_FILTER_VERSION: {
+        readonly exitCode: 1;
+        readonly description: "The saved view filter version is unsupported.";
+    };
+    readonly SAVED_VIEW_UNSUPPORTED_LAYOUT: {
+        readonly exitCode: 1;
+        readonly description: "The saved view layout is unsupported.";
+    };
+    readonly SAVED_VIEW_VALUE_TYPE_MISMATCH: {
+        readonly exitCode: 1;
+        readonly description: "A filter value does not match the field type.";
+    };
+    readonly SCHEMA_PATH_NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "No command schema exists for the requested path.";
+    };
+    readonly SKILLS_LOCK_INVALID: {
+        readonly exitCode: 1;
+        readonly description: "The skills installer lock file is malformed.";
+    };
+    readonly SKILLS_LOCK_READ_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The skills installer lock file could not be read.";
+    };
+    readonly SKILLS_MIGRATION_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The skills installer failed during migration.";
+    };
+    readonly SKILLS_MIGRATION_PRECONDITION_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The skills lock changed before migration ran.";
+    };
+    readonly SKILLS_MIGRATION_VERIFICATION_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "Post-migration verification did not match the plan.";
+    };
+    readonly STORAGE_IMAGE_PROCESSING_UNAVAILABLE: {
+        readonly exitCode: 1;
+        readonly description: "The optional sharp image library is unavailable, so image uploads are refused.";
+    };
+    readonly STORAGE_OBJECT_ALREADY_EXISTS: {
+        readonly exitCode: 5;
+        readonly description: "The storage object already exists; overwrite was not confirmed.";
+    };
+    readonly STORAGE_RESOURCE_INSERT_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The uploaded object could not be recorded as a resource.";
+    };
+    readonly STORAGE_TEST_CLEANUP_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The storage connectivity test object could not be removed.";
+    };
+    readonly STORAGE_THUMBNAIL_UPLOAD_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The thumbnail upload failed.";
+    };
+    readonly STORAGE_UPLOAD_OUTCOME_UNKNOWN: {
+        readonly exitCode: 1;
+        readonly description: "The upload outcome is unknown; verify before retrying.";
+    };
+    readonly SYNC_REQUIRED: {
+        readonly exitCode: 4;
+        readonly description: "Fresh sync was required (--require-sync) but not confirmed.";
+    };
+    readonly SYNC_STALE: {
+        readonly exitCode: 4;
+        readonly description: "The local cache is stale.";
+    };
+    readonly SYNC_TIMEOUT: {
+        readonly exitCode: 4;
+        readonly description: "Sync did not complete within the timeout.";
+    };
+    readonly TODO_TASK_LOOKUP_TRUNCATED: {
+        readonly exitCode: 1;
+        readonly description: "Task lookup hit its scan limit; pass --note-id.";
+    };
+    readonly TODO_TASK_NOT_FOUND: {
+        readonly exitCode: 5;
+        readonly description: "The todo task does not exist.";
+    };
+    readonly UNAUTHENTICATED: {
+        readonly exitCode: 3;
+        readonly description: "The backend rejected the request as unauthenticated.";
+    };
+    readonly UNSUPPORTED_CRUD_OPERATION: {
+        readonly exitCode: 1;
+        readonly description: "A queued upload contains an unsupported operation.";
+    };
+    readonly UPDATE_FAILED: {
+        readonly exitCode: 1;
+        readonly description: "The CLI self-update failed.";
+    };
+    readonly UPLOAD_PENDING: {
+        readonly exitCode: 4;
+        readonly description: "Local writes are still waiting to upload.";
+    };
+    readonly USAGE_ERROR: {
+        readonly exitCode: 2;
+        readonly description: "Invalid command usage, arguments, or flags.";
+    };
+};
+export type DinoxErrorCode = keyof typeof ERROR_CODES;
+export declare function isRegisteredErrorCode(code: string): code is DinoxErrorCode;
+export declare function listErrorCodes(): Array<{
+    code: DinoxErrorCode;
+} & ErrorCodeDefinition>;

package/dist/utils/errorCodes.js

@@ -0,0 +1,92 @@
+// Registry of every structured error `code` the CLI can emit. Agents branch on
+// these codes, so they are part of the public contract: add new codes here,
+// never rename or re-number an existing one without a major version.
+//
+// Exit codes: 1 failure, 2 usage, 3 auth, 4 sync freshness, 5 precondition / not found.
+// They are pinned per code (not derived from the name) so that renaming or
+// adding a code cannot silently change an exit status.
+export const ERROR_CODES = {
+    ALREADY_EXISTS: { exitCode: 5, description: 'The target resource already exists.' },
+    AUTH_INVALID: { exitCode: 3, description: 'The configured credentials were rejected.' },
+    AUTH_REQUIRED: { exitCode: 3, description: 'The command needs an authenticated Dinox account.' },
+    AUTH_STATE_CHANGED: { exitCode: 3, description: 'Authentication changed while the command was running.' },
+    CACHE_CLEANUP_FAILED: { exitCode: 1, description: 'Local cache cleanup after logout did not complete.' },
+    COMMAND_FAILED: { exitCode: 1, description: 'Generic command failure without a more specific code.' },
+    CONFIG_INVALID_JSON: { exitCode: 1, description: 'The CLI config file is not valid JSON.' },
+    CONFIG_WRITE_BUSY: { exitCode: 1, description: 'Another process is writing the CLI config.' },
+    DAEMON_ERROR: { exitCode: 5, description: 'The background daemon reported an error.' },
+    DAEMON_INSTANCE_CHANGED: { exitCode: 1, description: 'The daemon instance changed between requests.' },
+    DAEMON_INSTANCE_MISMATCH: { exitCode: 1, description: 'The running daemon belongs to a different CLI version or account.' },
+    DAEMON_INSTANCE_UNKNOWN: { exitCode: 1, description: 'The daemon identity could not be verified.' },
+    DAEMON_LEGACY_UNVERIFIED: { exitCode: 1, description: 'A daemon from an older CLI could not be verified safely.' },
+    DAEMON_RELEASE_FAILED: { exitCode: 1, description: 'The daemon could not release database ownership.' },
+    DAEMON_RELEASE_TIMEOUT: { exitCode: 1, description: 'The daemon did not release database ownership in time.' },
+    DAEMON_STALE: { exitCode: 5, description: 'The daemon state is stale and needs a restart.' },
+    DAEMON_START_FAILED: { exitCode: 5, description: 'The daemon process failed to start.' },
+    DAEMON_START_TIMEOUT: { exitCode: 1, description: 'The daemon did not become ready in time.' },
+    DAEMON_STOP_FAILED: { exitCode: 1, description: 'The daemon could not be stopped.' },
+    DAEMON_UNAVAILABLE: { exitCode: 1, description: 'The daemon is not available for this request.' },
+    DAEMON_UNREACHABLE: { exitCode: 1, description: 'The daemon socket could not be reached.' },
+    INTERNAL_ERROR: { exitCode: 1, description: 'Unexpected internal error; not a DinoxError.' },
+    INVALID_ARGUMENT: { exitCode: 2, description: 'An argument or option value is invalid.' },
+    INVALID_STORAGE_KEY: { exitCode: 2, description: 'The storage object key is invalid.' },
+    NOTE_INVALID_PROPERTIES: { exitCode: 1, description: 'Note properties are invalid.' },
+    NOTE_NOT_FOUND: { exitCode: 5, description: 'The note does not exist or is deleted.' },
+    NOTE_TEMPLATE_INVALID_CONTENT: { exitCode: 1, description: 'The note template content is invalid.' },
+    NOTE_TEMPLATE_INVALID_PROPERTY_DEF: { exitCode: 1, description: 'A note template property definition is invalid.' },
+    NOTE_TEMPLATE_INVALID_TOKEN_CONTEXT: { exitCode: 1, description: 'A note template token is used in an invalid context.' },
+    NOTE_TEMPLATE_UNSUPPORTED_PROPERTY_DEF_VERSION: { exitCode: 1, description: 'The note template property definition version is unsupported.' },
+    NOT_FOUND: { exitCode: 5, description: 'The requested resource was not found.' },
+    POWERSYNC_OWNER_BUSY: { exitCode: 1, description: 'Another process owns the local PowerSync database.' },
+    PRECONDITION_FAILED: { exitCode: 5, description: 'A safety precondition for the operation did not hold.' },
+    SAVED_VIEW_FILTER_TOO_COMPLEX: { exitCode: 1, description: 'The saved view filter exceeds supported complexity.' },
+    SAVED_VIEW_FILTER_VALUE_REQUIRED: { exitCode: 5, description: 'A saved view filter condition is missing its value.' },
+    SAVED_VIEW_INVALID_CONFIG: { exitCode: 1, description: 'The saved view config is invalid.' },
+    SAVED_VIEW_INVALID_DATE_VALUE: { exitCode: 1, description: 'A saved view date value is not a real calendar date.' },
+    SAVED_VIEW_INVALID_FIELD: { exitCode: 1, description: 'A saved view references an invalid field.' },
+    SAVED_VIEW_INVALID_FILTER: { exitCode: 1, description: 'The saved view filter is invalid.' },
+    SAVED_VIEW_INVALID_ROW: { exitCode: 1, description: 'A stored saved view row is invalid.' },
+    SAVED_VIEW_NOT_FOUND: { exitCode: 5, description: 'The saved view does not exist.' },
+    SAVED_VIEW_OPERATOR_TYPE_MISMATCH: { exitCode: 1, description: 'A filter operator is not valid for the field type.' },
+    SAVED_VIEW_OPTION_NOT_FOUND: { exitCode: 5, description: 'A select option id referenced by the view does not exist.' },
+    SAVED_VIEW_PROPERTY_CONFIG_INVALID: { exitCode: 1, description: 'A property configuration used by the view is invalid.' },
+    SAVED_VIEW_PROPERTY_INVALID: { exitCode: 1, description: 'A property used by the view is invalid.' },
+    SAVED_VIEW_PROPERTY_NOT_FOUND: { exitCode: 5, description: 'A property referenced by the view does not exist.' },
+    SAVED_VIEW_PROPERTY_OPTIONS_INVALID: { exitCode: 1, description: 'Property options used by the view are invalid.' },
+    SAVED_VIEW_PROPERTY_OPTIONS_MIGRATION_REQUIRED: { exitCode: 5, description: 'Property options need migration before use.' },
+    SAVED_VIEW_SORT_TYPE_UNSUPPORTED: { exitCode: 1, description: 'The field type cannot be sorted.' },
+    SAVED_VIEW_UNSUPPORTED_CONFIG_VERSION: { exitCode: 1, description: 'The saved view config version is unsupported.' },
+    SAVED_VIEW_UNSUPPORTED_FILTER_VERSION: { exitCode: 1, description: 'The saved view filter version is unsupported.' },
+    SAVED_VIEW_UNSUPPORTED_LAYOUT: { exitCode: 1, description: 'The saved view layout is unsupported.' },
+    SAVED_VIEW_VALUE_TYPE_MISMATCH: { exitCode: 1, description: 'A filter value does not match the field type.' },
+    SCHEMA_PATH_NOT_FOUND: { exitCode: 5, description: 'No command schema exists for the requested path.' },
+    SKILLS_LOCK_INVALID: { exitCode: 1, description: 'The skills installer lock file is malformed.' },
+    SKILLS_LOCK_READ_FAILED: { exitCode: 1, description: 'The skills installer lock file could not be read.' },
+    SKILLS_MIGRATION_FAILED: { exitCode: 1, description: 'The skills installer failed during migration.' },
+    SKILLS_MIGRATION_PRECONDITION_FAILED: { exitCode: 1, description: 'The skills lock changed before migration ran.' },
+    SKILLS_MIGRATION_VERIFICATION_FAILED: { exitCode: 1, description: 'Post-migration verification did not match the plan.' },
+    STORAGE_IMAGE_PROCESSING_UNAVAILABLE: { exitCode: 1, description: 'The optional sharp image library is unavailable, so image uploads are refused.' },
+    STORAGE_OBJECT_ALREADY_EXISTS: { exitCode: 5, description: 'The storage object already exists; overwrite was not confirmed.' },
+    STORAGE_RESOURCE_INSERT_FAILED: { exitCode: 1, description: 'The uploaded object could not be recorded as a resource.' },
+    STORAGE_TEST_CLEANUP_FAILED: { exitCode: 1, description: 'The storage connectivity test object could not be removed.' },
+    STORAGE_THUMBNAIL_UPLOAD_FAILED: { exitCode: 1, description: 'The thumbnail upload failed.' },
+    STORAGE_UPLOAD_OUTCOME_UNKNOWN: { exitCode: 1, description: 'The upload outcome is unknown; verify before retrying.' },
+    SYNC_REQUIRED: { exitCode: 4, description: 'Fresh sync was required (--require-sync) but not confirmed.' },
+    SYNC_STALE: { exitCode: 4, description: 'The local cache is stale.' },
+    SYNC_TIMEOUT: { exitCode: 4, description: 'Sync did not complete within the timeout.' },
+    TODO_TASK_LOOKUP_TRUNCATED: { exitCode: 1, description: 'Task lookup hit its scan limit; pass --note-id.' },
+    TODO_TASK_NOT_FOUND: { exitCode: 5, description: 'The todo task does not exist.' },
+    UNAUTHENTICATED: { exitCode: 3, description: 'The backend rejected the request as unauthenticated.' },
+    UNSUPPORTED_CRUD_OPERATION: { exitCode: 1, description: 'A queued upload contains an unsupported operation.' },
+    UPDATE_FAILED: { exitCode: 1, description: 'The CLI self-update failed.' },
+    UPLOAD_PENDING: { exitCode: 4, description: 'Local writes are still waiting to upload.' },
+    USAGE_ERROR: { exitCode: 2, description: 'Invalid command usage, arguments, or flags.' },
+};
+export function isRegisteredErrorCode(code) {
+    return Object.prototype.hasOwnProperty.call(ERROR_CODES, code);
+}
+export function listErrorCodes() {
+    return Object.keys(ERROR_CODES)
+        .sort()
+        .map((code) => ({ code, ...ERROR_CODES[code] }));
+}

package/dist/utils/errors.d.ts

@@ -1,11 +1,23 @@
+import { type DinoxErrorCode } from './errorCodes.js';
+export type { DinoxErrorCode } from './errorCodes.js';
+declare const wireErrorCodeBrand: unique symbol;
+/**
+ * A code received from another process (e.g. the daemon) that may not be registered in this
+ * CLI build. Only `wireErrorCode()` produces one; local code must use a registered code.
+ */
+export type WireErrorCode = string & {
+    readonly [wireErrorCodeBrand]: true;
+};
+export declare function wireErrorCode(code: string): WireErrorCode;
 export type DinoxErrorOptions = {
     exitCode?: number;
     cause?: unknown;
     details?: unknown;
-    code?: string;
+    code?: DinoxErrorCode | WireErrorCode;
     suggestion?: string;
     suggestedAction?: SuggestedAction;
     recoverable?: boolean;
+    requiresProcessExit?: boolean;
 };
 export type SuggestedAction = {
     command: string;
@@ -30,10 +42,11 @@ export type StructuredErrorPayload = {
 export declare class DinoxError extends Error {
     readonly exitCode: number;
     readonly details?: unknown;
-    readonly code: string;
+    readonly code: DinoxErrorCode | WireErrorCode;
     readonly suggestion?: string;
     readonly suggestedAction?: SuggestedAction;
     readonly recoverable: boolean;
+    readonly requiresProcessExit: boolean;
     constructor(message: string, options?: DinoxErrorOptions);
 }
 export declare function isDinoxError(error: unknown): error is DinoxError;

package/dist/utils/errors.js

@@ -1,3 +1,7 @@
+import { ERROR_CODES, isRegisteredErrorCode } from './errorCodes.js';
+export function wireErrorCode(code) {
+    return code;
+}
 export class DinoxError extends Error {
     exitCode;
     details;
@@ -5,6 +9,7 @@ export class DinoxError extends Error {
     suggestion;
     suggestedAction;
     recoverable;
+    requiresProcessExit;
     constructor(message, options) {
         super(message);
         const code = normalizeErrorCode(options?.code ?? inferDinoxErrorCode(message));
@@ -18,6 +23,7 @@ export class DinoxError extends Error {
             ?? suggestedActionFromSuggestion(suggestion)
             ?? defaultSuggestedActionForCode(code, message);
         this.recoverable = options?.recoverable ?? true;
+        this.requiresProcessExit = options?.requiresProcessExit ?? false;
         if (options?.cause !== undefined) {
             // Node 16+ supports Error.cause.
             this.cause = options.cause;
@@ -117,6 +123,13 @@ function inferDinoxErrorCode(message) {
 }
 export function exitCodeForErrorCode(code) {
     const normalized = normalizeErrorCode(code);
+    if (isRegisteredErrorCode(normalized)) {
+        return ERROR_CODES[normalized].exitCode;
+    }
+    return legacyExitCodeForUnregisteredCode(normalized);
+}
+// Fallback for codes outside the registry (for example a daemon from another CLI build).
+function legacyExitCodeForUnregisteredCode(normalized) {
     if (normalized === 'USAGE_ERROR' || normalized === 'INVALID_ARGUMENT' || normalized.startsWith('INVALID_')) {
         return 2;
     }

package/dist/utils/processExit.d.ts

@@ -0,0 +1 @@
+export declare function exitProcessAfterFlushing(exitCode: number, flushTimeoutMs?: number): Promise<never>;

package/dist/utils/processExit.js

@@ -0,0 +1,33 @@
+const DEFAULT_FLUSH_TIMEOUT_MS = 100;
+async function flushWritable(stream, timeoutMs) {
+    if (stream.destroyed || stream.writableEnded || !stream.writable) {
+        return;
+    }
+    await new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(finish, timeoutMs);
+        try {
+            stream.write('', finish);
+        }
+        catch {
+            finish();
+        }
+    });
+}
+export async function exitProcessAfterFlushing(exitCode, flushTimeoutMs = DEFAULT_FLUSH_TIMEOUT_MS) {
+    const timeoutMs = Number.isFinite(flushTimeoutMs)
+        ? Math.max(1, Math.floor(flushTimeoutMs))
+        : DEFAULT_FLUSH_TIMEOUT_MS;
+    await Promise.all([
+        flushWritable(process.stdout, timeoutMs),
+        flushWritable(process.stderr, timeoutMs),
+    ]);
+    process.exit(exitCode);
+}

package/dist/utils/updateNotice.d.ts

@@ -4,4 +4,5 @@ export type UpdateNotice = {
     message: string;
 };
 export declare function isVersionNewer(candidate: string, current: string): boolean;
+export declare function fetchLatestPublishedVersion(fetchImpl?: typeof fetch): Promise<string | null>;
 export declare function getUpdateNotice(currentVersion: string, fetchImpl?: typeof fetch): Promise<UpdateNotice | null>;

package/dist/utils/updateNotice.js

@@ -26,7 +26,7 @@ export function isVersionNewer(candidate, current) {
     }
     return false;
 }
-async function fetchLatestPublishedVersion(fetchImpl = fetch) {
+export async function fetchLatestPublishedVersion(fetchImpl = fetch) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 1500);
     try {

package/package.json

@@ -1,22 +1,28 @@
 {
   "name": "@dinoxx/dinox-cli",
-  "version": "1.1.1",
+  "version": "2.1.0",
   "description": "Dinox CLI",
   "main": "dist/dinox.js",
   "scripts": {
     "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json && node scripts/add-shebang.mjs",
     "dev": "tsx src/dinox.ts",
-    "prepublishOnly": "pnpm run build",
+    "prepublishOnly": "pnpm run skills:check && pnpm run build",
     "publish:npm": "sh ./publish-npm.sh --no-bump",
-    "publish:npm:dry-run": "sh ./publish-npm.sh --dry-run",
+    "publish:npm:dry-run": "sh ./publish-npm.sh --dry-run --no-bump",
     "skills:check": "tsx scripts/check-skills.ts",
+    "skills:eval:triggers": "tsx scripts/evaluate-skill-triggers.ts",
     "skills:sync:standalone": "tsx scripts/sync-standalone-skills-repo.ts",
     "skills:sync:standalone:check": "tsx scripts/sync-standalone-skills-repo.ts --check",
     "skills:sync:standalone:dry-run": "tsx scripts/sync-standalone-skills-repo.ts --dry-run",
     "skills:sync": "tsx scripts/sync-skills-reference.ts",
+    "schema:sync:electron": "tsx scripts/sync-electron-powersync-schema.ts",
+    "schema:sync:electron:check": "tsx scripts/sync-electron-powersync-schema.ts --check",
     "start": "node dist/dinox.js",
     "test": "node scripts/run-tests.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json"
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
+    "lint": "eslint .",
+    "contract:sync": "tsx scripts/sync-contract.ts",
+    "contract:check": "tsx scripts/sync-contract.ts --check"
   },
   "keywords": [],
   "author": "",
@@ -38,8 +44,8 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.1021.0",
     "@node-rs/jieba": "^2.0.1",
-    "@powersync/common": "^1.57.0",
-    "@powersync/node": "^0.19.2",
+    "@powersync/common": "^2.3.1",
+    "@powersync/node": "^1.1.1",
     "@tiptap/core": "^3.20.0",
     "@tiptap/extension-blockquote": "^3.20.0",
     "@tiptap/extension-bold": "^3.20.0",
@@ -70,17 +76,21 @@
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
     "remark-stringify": "^11.0.0",
-    "sharp": "^0.34.5",
     "strip-markdown": "^6.0.0",
     "unified": "^11.0.5",
     "uuidv7": "^1.0.2",
     "yaml": "^2.9.0"
   },
+  "optionalDependencies": {
+    "sharp": "^0.34.5"
+  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.19.0",
+    "eslint": "^10.12.0",
     "tsx": "^4.20.3",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.71.1"
   },
   "packageManager": "pnpm@10.34.5"
 }