Release v1.0.1

Patch release with two important fixes:

• Fixed script execution when script paths contained whitespace.
• Fixed Kind parsing in the PSNote constructor when JSON stored the enum value as a number.

This release improves execution reliability and ensures correct deserialization of existing catalogs.

No breaking changes.

Release v1.0.0

PSNotes 1.0.0 marks the first major, production-ready release of PSNotes.

This version introduces a fully catalog-driven architecture, remote catalog support, improved data durability, favorites management, and a new interactive terminal experience, transforming PSNotes from a simple snippet notebook into a structured, extensible snippet management system.

---

What’s New in 1.0.0

Catalog-Based Architecture

PSNotes now organizes notes into catalogs, enabling logical separation and scalable management.

• Each catalog stored as its own JSON file
• Notes scoped to a catalog
• Catalog-aware filtering across commands
• Duplicate alias protection across catalogs
• Support for moving notes between catalogs

This allows:

• Personal vs. team snippet separation
• Environment-specific catalogs
• Portable snippet libraries

---

Remote Catalog Support

PSNotes now supports registering and syncing remote catalogs.

• Register remote catalogs by URL
• Cached remote content
• ETag / Last-Modified support for efficient sync
• Option to convert remote catalogs to local
• Remote catalogs are read-only by design

This enables:

• Shared team catalogs
• GitHub-hosted snippet repositories
• Controlled central distribution of snippets

---

Improved Data Durability

Significant reliability improvements:

• Atomic writes to prevent corruption
• Automatic rolling backups (last 10 retained)
• Pre-migration backups
• Store version validation before loading catalogs
• Safe migration handling for legacy formats

These changes greatly reduce the risk of data loss during writes or upgrades.

---

Migration Engine

Legacy catalog formats are automatically detected and migrated.

• Legacy array format converted to structured store format
• StoreVersion tracking added
• Migration warnings surfaced
• Safe backup created before migration

Users upgrading from earlier builds are protected automatically.

---

Interactive Terminal App (psnote)

PSNotes now includes an interactive console experience:

• Quickly browse notes
• Copy / Run / Output options
• Script execution support

This makes PSNotes usable as a lightweight terminal snippet manager.

---

Enhanced Note Model

The PSNote model now includes:

• Kind (Snippet or Script)
• Run flag for default execution behavior
• Stable Catalog::Alias keying
• Improved display rendering support

This lays the foundation for future extensibility.

---

Command Improvements

Enhancements across:

• Get-PSNote
• Remove-PSNote
• Move-PSNote
• Import/Export functionality
• Remote catalog safety protections
• Catalog-aware filtering

---

Important Changes

• Notes are now stored per-catalog
• Catalog files include a StoreVersion
• Remote catalogs are read-only unless converted locally
• Favorites stored separately from note objects

Automatic migration handles most upgrades seamlessly.

---

Architectural Foundation for the Future

PSNotes 1.0.0 establishes:

• A structured catalog store
• Remote extensibility
• Durable file operations
• Metadata separation
• Clean alias management

This version provides the stable foundation for future enhancements.

---

Why 1.0.0 Matters

PSNotes is no longer just a snippet notebook, it is now a structured, extensible snippet management platform designed for:

• Individual productivity
• Team collaboration
• Shared automation libraries
• Portable snippet distribution
• Long-term reliability

---

Thank You

Thank you to everyone who tested, reviewed, and contributed ideas during development.

PSNotes 1.0.0 represents the beginning of a stable and extensible future.