@hasna/project 0.1.10 → 0.1.12

package/README.md

@@ -13,39 +13,70 @@ bun install -g @hasna/project
 ```bash
 # Register a project
 project create --name my-app --path /path/to/my-app
+project create --name my-app                          # uses cwd as path
 
-# List projects
+# List / search
 project list
 project list --status archived
-
-# Get details
-project get my-app
-
-# Open a project (cd into it)
-cd $(project open my-app)
-
-# Update metadata
+project list --tags web,ts                            # AND filter
+project list --json | jq '.[].path'                  # machine-readable
+
+# Get / status
+project get my-app                                    # auto-detects from cwd
+project get my-app --json
+project status                                        # all projects at a glance
+project status my-app                                 # single project detail
+project recent                                        # recently opened (with relative times)
+project doctor                                        # health-check all projects
+project doctor my-app --fix                           # auto-repair what can be fixed
+project stats                                         # disk / sync totals
+project stats my-app
+
+# Modify
 project update my-app --description "My app" --tags "web,ts"
-
-# Archive / unarchive
+project rename my-app my-app-v2                       # updates slug + .project.json
+project tag my-app infra cloud                        # add tags
+project untag my-app cloud                            # remove a tag
 project archive my-app
 project unarchive my-app
 
+# Open (cd into it)
+cd $(project open my-app)                             # print path; auto-detects cwd
+workon my-app                                         # shell function — actually cd's
+penv my-app                                           # load project .env into shell
+project env my-app                                    # print export statements (eval)
+project env my-app --list                             # list keys only
+
+# Working directories (multi-machine / multi-repo)
+project workdir add my-app /path/to/dir --label backend
+project workdir list my-app
+project workdir generate my-app                       # write CLAUDE.md + AGENTS.md
+project workdir generate my-app --dry-run
+project workdir remove my-app /path/to/dir
+
 # Import existing directories
 project import /path/to/existing-project
-project import-bulk /path/to/workspace     # imports all subdirs
+project import-bulk /path/to/workspace                # imports all subdirs
+project clone my-app /new/local/path                  # pull from S3 to new machine path
 
 # Sync to/from S3
 project update my-app --s3-bucket my-bucket
 project sync my-app
 project sync my-app --direction push
-project sync-all                           # sync all projects with S3 configured
+project sync-all                                      # sync all projects with S3 configured
+project watch my-app                                  # push changes live as you edit
+project sync-log my-app                               # show sync history
 
 # Schedule auto-sync
 project schedule set --interval daily --direction both
 project schedule status
 project schedule remove
 
+# Cloud sync (SQLite ↔ RDS PostgreSQL)
+project cloud status
+project cloud pull
+project cloud push
+
 # Publish to GitHub
 project publish my-app --org hasnaxyz
 project unpublish my-app
@@ -54,9 +85,9 @@ project unpublish my-app
 project git my-app status
 project git my-app log --oneline -10
 
-# Shell completion
-eval "$(project completion)"          # bash
-eval "$(project completion --shell zsh)"  # zsh
+# Shell completion (includes workon + penv functions)
+eval "$(project completion)"                          # bash
+eval "$(project completion --shell zsh)"              # zsh
 ```
 
 ## MCP Server
@@ -78,20 +109,26 @@ Add to your Claude config:
 | Tool | Description |
 |------|-------------|
 | `projects_create` | Register a new project. Returns `workingDirectory` + `post_create_actions` |
-| `projects_list` | List projects, filter by status |
+| `projects_list` | List projects, filter by `status` and/or `tags` |
 | `projects_get` | Get project by ID or slug. Returns `workingDirectory` |
 | `projects_update` | Update project metadata |
 | `projects_archive` | Archive a project |
-| `projects_open` | Get `workingDirectory` for a project |
+| `projects_open` | Get `workingDirectory` for a project (also tracks `last_opened_at`) |
 | `projects_sync` | Sync to/from S3 (incremental, by file hash) |
 | `projects_sync_all` | Sync all active projects with S3 configured |
+| `projects_sync_log` | List recent sync history |
 | `projects_link` | Store integration IDs (todos, mementos, conversations, files) |
 | `projects_import` | Import an existing directory as a project |
 | `projects_import_bulk` | Import all subdirectories of a path |
 | `projects_publish` | Create GitHub repo, add remote, push |
+| `projects_workdir_add` | Add a working directory; optionally generate CLAUDE.md + AGENTS.md |
+| `projects_workdir_list` | List all working directories for a project |
+| `projects_workdir_generate` | Generate CLAUDE.md + AGENTS.md in working directories |
 | `projects_schedule_set` | Enable cron-based auto-sync |
 | `projects_schedule_status` | Get current schedule config |
-| `projects_sync_log` | List recent sync history |
+| `projects_cloud_status` | Show RDS connection health |
+| `projects_cloud_pull` | Pull from cloud PostgreSQL to local SQLite |
+| `projects_cloud_push` | Push local SQLite to cloud PostgreSQL |
 
 ### projects_create response
 

package/dist/cli/commands/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsEzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8rB9D"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+EzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8rB9D"}

package/dist/cli/index.js

@@ -46400,6 +46400,15 @@ function timeAgo(iso) {
   const d2 = Math.floor(h2 / 24);
   return `${d2}d ago`;
 }
+function suppressSslWarnings() {
+  const orig = process.emitWarning.bind(process);
+  process.emitWarning = (msg, ...args) => {
+    const text = typeof msg === "string" ? msg : msg.message;
+    if (text?.includes("SSL modes"))
+      return;
+    return orig(msg, ...args);
+  };
+}
 function requireProject(idOrSlug) {
   if (idOrSlug)
     return resolveProject(idOrSlug);
@@ -46947,6 +46956,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
   const cloudCmd = cmd.command("cloud").description("Cloud sync \u2014 push/pull between local SQLite and RDS PostgreSQL");
   cloudCmd.command("status").description("Show cloud configuration and connection health").action(async () => {
     process.env["NODE_NO_WARNINGS"] = "1";
+    suppressSslWarnings();
     const { getCloudConfig: getCloudConfig2, getConnectionString: getConnectionString2, PgAdapterAsync: PgAdapterAsync2 } = await Promise.resolve().then(() => (init_dist(), exports_dist));
     const config = getCloudConfig2();
     console.log(`mode:    ${config.mode}`);
@@ -46966,7 +46976,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
   cloudCmd.command("pull").description("Pull data from cloud PostgreSQL to local SQLite").option("--tables <tables>", "Comma-separated table names (default: all)").action(async (opts) => {
     console.log(source_default.dim("Pulling from cloud..."));
     try {
-      process.env["NODE_NO_WARNINGS"] = "1";
+      suppressSslWarnings();
       const { syncPull: syncPull2, getCloudConfig: getCloudConfig2, getConnectionString: getConnectionString2, PgAdapterAsync: PgAdapterAsync2, SqliteAdapter: SqliteAdapter2 } = await Promise.resolve().then(() => (init_dist(), exports_dist));
       const config = getCloudConfig2();
       if (!config.rds?.host) {
@@ -46991,7 +47001,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
   cloudCmd.command("push").description("Push local SQLite data to cloud PostgreSQL").option("--tables <tables>", "Comma-separated table names (default: all)").action(async (opts) => {
     console.log(source_default.dim("Pushing to cloud..."));
     try {
-      process.env["NODE_NO_WARNINGS"] = "1";
+      suppressSslWarnings();
       const { syncPush: syncPush2, getCloudConfig: getCloudConfig2, getConnectionString: getConnectionString2, PgAdapterAsync: PgAdapterAsync2, SqliteAdapter: SqliteAdapter2 } = await Promise.resolve().then(() => (init_dist(), exports_dist));
       const { runPgMigrations: runPgMigrations2 } = await Promise.resolve().then(() => (init_pg_migrations(), exports_pg_migrations));
       const config = getCloudConfig2();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/project",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Project management CLI + MCP server for AI agents — register, sync, and open projects across machines",
   "type": "module",
   "main": "dist/index.js",