How does the dual-identifier system work?

It uses immutable UUIDs internally for storage and business logic while presenting stable, sequential integers (like 1, 2, 3) to the user in the CLI.

Does the system support nested notes?

Yes, it uses dot notation (e.g., 1.1.2) to provide a stable, hierarchical namespace for each level of the pad tree.

Where is the indexing logic located in the codebase?

Index generation is handled in crates/padzapp/src/index.rs, while resolution from user input is managed in crates/padzapp/src/api.rs.

What is index drift in Padz?

Index drift occurs when item IDs change based on the current search or filter view. Padz avoids this by assigning IDs based on the full, unfiltered list.

Why do pinned pads have two different indexes?

Pinned pads appear as 'pN' for quick access but retain their regular index to ensure stability when unpinning or viewing the full list.

Padz Display Identifiers

Name: Padz Display Identifiers
Author: arthur-debert

byarthur-debert

Productivity & Workflow

Manages stable, user-friendly display identifiers for the Padz CLI to prevent index drift during listing, filtering, and item selection.

About

This skill provides the architectural logic for the Padz dual-identifier system, balancing internal UUID stability with human-readable sequential indexing. It ensures that CLI commands like listing, searching, and deleting maintain canonical ID consistency regardless of current filters or views. By implementing a three-pass indexing algorithm and supporting hierarchical tree structures with range selection, it allows developers to maintain a predictable user interface while interacting with complex note or pad structures. It specifically guides developers on using the index_pads function for output and parse_selectors for input resolution at the API boundary.

Key Features

0 GitHub stars
Prevents index drift using a canonical three-pass sorting algorithm
Enables hierarchical tree navigation using stable dot-notation syntax
Implements safe range selection for bulk actions like deletion
Decouples human-readable IDs from internal UUIDs at the API boundary
Supports distinct identifier types for regular, pinned (p1), and deleted (d1) items

Use Cases

Extending the Padz hierarchical tree structure with new nested elements
Implementing new CLI commands that require stable item selection
Debugging pad listing logic or index resolution errors

About

Key Features

0 GitHub stars
Prevents index drift using a canonical three-pass sorting algorithm
Enables hierarchical tree navigation using stable dot-notation syntax
Implements safe range selection for bulk actions like deletion
Decouples human-readable IDs from internal UUIDs at the API boundary
Supports distinct identifier types for regular, pinned (p1), and deleted (d1) items

Use Cases

Extending the Padz hierarchical tree structure with new nested elements
Implementing new CLI commands that require stable item selection
Debugging pad listing logic or index resolution errors