Projects — Registry & Backup

The projects package manages multi-project discovery, registration, and backup.

ProjectRegistry

class jot.projects.registry.ProjectRegistry(registry_file='~/.jot-projects.json')

Bases: object

Manages project name → directory path mappings with usage tracking

register_project(name, path)

Register a project

Parameters:

• name – Project name (validated for safety)

• path – Project directory path

Raises:

ValueError – If name contains dangerous characters

unregister_project(name)

Unregister a project

get_project_path(name)

Get path for a project name

list_projects()

Return {name: path} dict (backward compatible)

list_projects_by_usage()

Return [(name, path, usage_count)] sorted by usage desc, then name asc

record_usage(name)

Increment usage count for a project

is_path_registered(path)

Check if a directory path is already registered

refresh()

Re-run auto-discovery

ProjectBackup

class jot.projects.backup.ProjectBackup(project_dir=None)

Bases: object

Manages project backup and restoration

__init__(project_dir=None)

Initialize backup manager

get_backup_files()

Get list of all jot files to backup

create_backup(output_file=None)

Create a backup tarball of all jot files

restore_backup(backup_file, force=False)

Restore from a backup tarball

list_backup_contents(backup_file)

List contents of a backup file