@hasna/project 0.1.12 → 0.1.14

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;AA+EzC,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;AAoIzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6rB9D"}

package/dist/cli/commands/projects.json-output.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects.json-output.test.d.ts.map

package/dist/cli/commands/projects.json-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.json-output.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/projects.json-output.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/projects.limit-validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects.limit-validation.test.d.ts.map

package/dist/cli/commands/projects.limit-validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.limit-validation.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/projects.limit-validation.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/projects.not-found-hints.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects.not-found-hints.test.d.ts.map

package/dist/cli/commands/projects.not-found-hints.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.not-found-hints.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/projects.not-found-hints.test.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -46409,6 +46409,55 @@ function suppressSslWarnings() {
     return orig(msg, ...args);
   };
 }
+function wantsJsonOutput(opts) {
+  return Boolean(opts?.json || process.env["PROJECTS_JSON"]);
+}
+function parsePositiveIntOrExit(raw, flagName, fallback) {
+  if (raw === undefined)
+    return fallback;
+  const value = Number.parseInt(raw, 10);
+  if (!Number.isInteger(value) || value < 1) {
+    console.error(source_default.red(`Invalid value for ${flagName}: ${raw}. Expected a positive integer.`));
+    process.exit(1);
+  }
+  return value;
+}
+function exitProjectNotFound(idOrSlug) {
+  console.error(source_default.red(`Project not found: ${idOrSlug}`));
+  const query = idOrSlug.toLowerCase();
+  const candidates = [
+    ...listProjects({ status: "active", limit: 500 }),
+    ...listProjects({ status: "archived", limit: 500 })
+  ];
+  const seen = new Set;
+  const matches = [];
+  for (const project of candidates) {
+    if (seen.has(project.id))
+      continue;
+    seen.add(project.id);
+    const haystack = `${project.slug} ${project.name}`.toLowerCase();
+    if (haystack.includes(query) || project.id.startsWith(idOrSlug)) {
+      matches.push(project);
+    }
+    if (matches.length >= 5)
+      break;
+  }
+  if (matches.length) {
+    console.error(source_default.dim("Did you mean:"));
+    for (const project of matches) {
+      console.error(source_default.dim(`  - ${project.slug} (${project.id})`));
+    }
+  } else {
+    console.error(source_default.dim("Hint: run `project list --limit 20` to see available project IDs/slugs."));
+  }
+  process.exit(1);
+}
+function resolveProjectOrExit(idOrSlug) {
+  const project = resolveProject(idOrSlug);
+  if (!project)
+    exitProjectNotFound(idOrSlug);
+  return project;
+}
 function requireProject(idOrSlug) {
   if (idOrSlug)
     return resolveProject(idOrSlug);
@@ -46437,7 +46486,7 @@ function printProject(p2) {
 }
 function registerProjectCommands(program2) {
   const cmd = program2;
-  cmd.command("create").description("Register a new project").requiredOption("--name <name>", "Project name").option("--path <path>", "Project path (default: cwd)").option("--slug <slug>", "Custom slug (auto-generated from name if omitted)").option("--description <desc>", "Description").option("--tags <tags>", "Comma-separated tags").option("--s3-bucket <bucket>", "S3 bucket for sync").option("--s3-prefix <prefix>", "S3 prefix").option("--git-remote <remote>", "Git remote URL").option("--no-git-init", "Skip auto git init").action((opts) => {
+  cmd.command("create").description("Register a new project").requiredOption("--name <name>", "Project name").option("--path <path>", "Project path (default: cwd)").option("--slug <slug>", "Custom slug (auto-generated from name if omitted)").option("--description <desc>", "Description").option("--tags <tags>", "Comma-separated tags").option("--s3-bucket <bucket>", "S3 bucket for sync").option("--s3-prefix <prefix>", "S3 prefix").option("--git-remote <remote>", "Git remote URL").option("--no-git-init", "Skip auto git init").option("-j, --json", "Output raw JSON").action((opts) => {
     try {
       const path = opts.path ? resolve4(opts.path) : process.cwd();
       const project = createProject({
@@ -46451,6 +46500,10 @@ function registerProjectCommands(program2) {
         git_remote: opts.gitRemote,
         git_init: opts.gitInit !== false
       });
+      if (wantsJsonOutput(opts)) {
+        console.log(JSON.stringify(project, null, 2));
+        return;
+      }
       console.log(source_default.green("\u2713 Project created"));
       printProject(project);
       if (!existsSync13(project.path)) {
@@ -46465,7 +46518,7 @@ function registerProjectCommands(program2) {
   cmd.command("list").description("List projects").option("--status <status>", "Filter by status (active|archived)").option("--tags <tags>", "Filter by tags (comma-separated)").option("--limit <n>", "Max results", "50").option("--json", "Output raw JSON").action((opts) => {
     const filter = {
       status: opts.status,
-      limit: parseInt(opts.limit, 10),
+      limit: parsePositiveIntOrExit(opts.limit, "--limit", 50),
       tags: opts.tags ? opts.tags.split(",").map((t8) => t8.trim()) : undefined
     };
     const projects = listProjects(filter);
@@ -46489,7 +46542,9 @@ ${projects.length} project(s)`));
   cmd.command("get [id-or-slug]").description("Get project details (auto-detects from cwd if no arg given)").option("--json", "Output raw JSON").action((idOrSlug, opts) => {
     const project = requireProject(idOrSlug);
     if (!project) {
-      console.error(source_default.red(idOrSlug ? `Project not found: ${idOrSlug}` : "No project detected in current directory. Pass a project ID or slug."));
+      if (idOrSlug)
+        exitProjectNotFound(idOrSlug);
+      console.error(source_default.red("No project detected in current directory. Pass a project ID or slug."));
       process.exit(1);
     }
     if (opts?.json || process.env["PROJECTS_JSON"]) {
@@ -46498,12 +46553,8 @@ ${projects.length} project(s)`));
     }
     printProject(project);
   });
-  cmd.command("rename <id-or-slug> <new-name>").description("Rename a project and update slug + .project.json in all workdirs").action((idOrSlug, newName) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+  cmd.command("rename <id-or-slug> <new-name>").description("Rename a project and update slug + .project.json in all workdirs").option("-j, --json", "Output raw JSON").action((idOrSlug, newName, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
     const updated = updateProject(project.id, { name: newName });
     const workdirs = listWorkdirs(project.id);
     for (const w2 of workdirs) {
@@ -46516,34 +46567,34 @@ ${projects.length} project(s)`));
         }
       } catch {}
     }
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(updated, null, 2));
+      return;
+    }
     console.log(source_default.green(`\u2713 Renamed: ${project.name} \u2192 ${updated.name} (slug: ${updated.slug})`));
   });
-  cmd.command("tag <id-or-slug> [tags...]").description("Add tags to a project").action((idOrSlug, tags) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+  cmd.command("tag <id-or-slug> [tags...]").description("Add tags to a project").option("-j, --json", "Output raw JSON").action((idOrSlug, tags, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
     const merged = [...new Set([...project.tags, ...tags])];
-    updateProject(project.id, { tags: merged });
+    const updated = updateProject(project.id, { tags: merged });
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(updated, null, 2));
+      return;
+    }
     console.log(source_default.green(`\u2713 Tags: ${merged.join(", ")}`));
   });
-  cmd.command("untag <id-or-slug> [tags...]").description("Remove tags from a project").action((idOrSlug, tags) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+  cmd.command("untag <id-or-slug> [tags...]").description("Remove tags from a project").option("-j, --json", "Output raw JSON").action((idOrSlug, tags, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
     const remaining = project.tags.filter((t8) => !tags.includes(t8));
-    updateProject(project.id, { tags: remaining });
+    const updated = updateProject(project.id, { tags: remaining });
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(updated, null, 2));
+      return;
+    }
     console.log(source_default.green(`\u2713 Tags: ${remaining.length ? remaining.join(", ") : "(none)"}`));
   });
-  cmd.command("update <id-or-slug>").description("Update a project").option("--name <name>", "New name").option("--description <desc>", "New description").option("--path <path>", "New path").option("--tags <tags>", "New tags (comma-separated, replaces existing)").option("--s3-bucket <bucket>", "S3 bucket").option("--s3-prefix <prefix>", "S3 prefix").option("--git-remote <remote>", "Git remote URL").action((idOrSlug, opts) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+  cmd.command("update <id-or-slug>").description("Update a project").option("--name <name>", "New name").option("--description <desc>", "New description").option("--path <path>", "New path").option("--tags <tags>", "New tags (comma-separated, replaces existing)").option("--s3-bucket <bucket>", "S3 bucket").option("--s3-prefix <prefix>", "S3 prefix").option("--git-remote <remote>", "Git remote URL").option("-j, --json", "Output raw JSON").action((idOrSlug, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
     const updated = updateProject(project.id, {
       name: opts.name,
       description: opts.description,
@@ -46553,25 +46604,29 @@ ${projects.length} project(s)`));
       s3_prefix: opts.s3Prefix,
       git_remote: opts.gitRemote
     });
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(updated, null, 2));
+      return;
+    }
     console.log(source_default.green("\u2713 Project updated"));
     printProject(updated);
   });
-  cmd.command("archive <id-or-slug>").description("Archive a project").action((idOrSlug) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
+  cmd.command("archive <id-or-slug>").description("Archive a project").option("-j, --json", "Output raw JSON").action((idOrSlug, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
+    const archived = archiveProject(project.id);
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(archived, null, 2));
+      return;
     }
-    archiveProject(project.id);
     console.log(source_default.yellow(`\u2713 Archived: ${project.name}`));
   });
-  cmd.command("unarchive <id-or-slug>").description("Unarchive a project").action((idOrSlug) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
+  cmd.command("unarchive <id-or-slug>").description("Unarchive a project").option("-j, --json", "Output raw JSON").action((idOrSlug, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
+    const unarchived = unarchiveProject(project.id);
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(unarchived, null, 2));
+      return;
     }
-    unarchiveProject(project.id);
     console.log(source_default.green(`\u2713 Unarchived: ${project.name}`));
   });
   cmd.command("open [id-or-slug]").description("Print the path of a project (for use with cd, auto-detects from cwd)").action((idOrSlug) => {
@@ -46588,7 +46643,7 @@ ${projects.length} project(s)`));
     console.log(project.path);
   });
   cmd.command("recent").description("List recently opened projects").option("--limit <n>", "Max results", "10").option("--json", "Output raw JSON").action((opts) => {
-    const projects = getRecentProjects(parseInt(opts.limit, 10));
+    const projects = getRecentProjects(parsePositiveIntOrExit(opts.limit, "--limit", 10));
     if (opts.json || process.env["PROJECTS_JSON"]) {
       console.log(JSON.stringify(projects, null, 2));
       return;
@@ -46605,11 +46660,7 @@ ${projects.length} project(s)`));
   });
   cmd.command("status [id-or-slug]").description("Show project health at a glance").option("--json", "Output raw JSON").action(async (idOrSlug, opts) => {
     if (idOrSlug) {
-      const project = resolveProject(idOrSlug);
-      if (!project) {
-        console.error(source_default.red(`Project not found: ${idOrSlug}`));
-        process.exit(1);
-      }
+      const project = resolveProjectOrExit(idOrSlug);
       const s2 = getProjectStatus(project);
       if (opts?.json || process.env["PROJECTS_JSON"]) {
         console.log(JSON.stringify(s2, null, 2));
@@ -46642,10 +46693,8 @@ ${projects.length} project(s)`));
   });
   cmd.command("doctor [id-or-slug]").description("Health-check all registered projects").option("--fix", "Auto-repair what can be fixed").option("--json", "Output raw JSON").action(async (idOrSlug, opts) => {
     const target = idOrSlug ? resolveProject(idOrSlug) : null;
-    if (idOrSlug && !target) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    if (idOrSlug && !target)
+      exitProjectNotFound(idOrSlug);
     const results = target ? [await doctorProject(target)] : await doctorAll();
     if (opts?.json || process.env["PROJECTS_JSON"]) {
       console.log(JSON.stringify(results, null, 2));
@@ -46671,11 +46720,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
   });
   cmd.command("stats [id-or-slug]").description("Show storage and sync statistics").option("--json", "Output raw JSON").action((idOrSlug, opts) => {
     if (idOrSlug) {
-      const project = resolveProject(idOrSlug);
-      if (!project) {
-        console.error(source_default.red(`Project not found: ${idOrSlug}`));
-        process.exit(1);
-      }
+      const project = resolveProjectOrExit(idOrSlug);
       const s2 = getProjectStats(project.id);
       if (!s2) {
         console.error(source_default.red("Stats not available"));
@@ -46719,11 +46764,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
     }
   });
   cmd.command("clone <id-or-slug> [target-path]").description("Pull a project from S3 to a new local path and register as workdir").option("--region <region>", "AWS region").option("--label <label>", "Workdir label", "clone").action(async (idOrSlug, targetPath, opts) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     const dest = resolve4(targetPath ?? join14(process.cwd(), project.slug));
     console.log(source_default.dim(`Cloning ${project.name} \u2192 ${dest}...`));
     try {
@@ -46753,7 +46794,9 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
   cmd.command("sync [id-or-slug]").description("Sync project files to/from S3 (auto-detects from cwd)").option("--direction <dir>", "push, pull, or both (default: both)", "both").option("--dry-run", "Show what would be synced without doing it").option("--region <region>", "AWS region").action(async (idOrSlug, opts) => {
     const project = requireProject(idOrSlug);
     if (!project) {
-      console.error(source_default.red(idOrSlug ? `Project not found: ${idOrSlug}` : "No project detected in current directory."));
+      if (idOrSlug)
+        exitProjectNotFound(idOrSlug);
+      console.error(source_default.red("No project detected in current directory."));
       process.exit(1);
     }
     try {
@@ -46812,11 +46855,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
   });
   const workdirCmd = cmd.command("workdir").description("Manage working directories for a project");
   workdirCmd.command("add <id-or-slug> <path>").description("Add a working directory to a project").option("--label <label>", "Label for this directory (e.g. frontend, backend)", "main").option("--primary", "Set as the primary working directory").option("--generate", "Generate CLAUDE.md + AGENTS.md immediately").action((idOrSlug, path, opts) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     const absPath = resolve4(path);
     const workdir = addWorkdir({ project_id: project.id, path: absPath, label: opts.label, is_primary: opts.primary });
     console.log(source_default.green(`\u2713 Added workdir: ${workdir.label} \u2192 ${workdir.path}`));
@@ -46827,13 +46866,13 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
       console.log(source_default.dim(`  AGENTS.md \u2192 ${result.path}/AGENTS.md`));
     }
   });
-  workdirCmd.command("list <id-or-slug>").description("List all working directories for a project").action((idOrSlug) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+  workdirCmd.command("list <id-or-slug>").description("List all working directories for a project").option("-j, --json", "Output raw JSON").action((idOrSlug, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
     const workdirs = listWorkdirs(project.id);
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(workdirs, null, 2));
+      return;
+    }
     if (!workdirs.length) {
       console.log(source_default.dim("No workdirs registered."));
       return;
@@ -46846,20 +46885,12 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
     }
   });
   workdirCmd.command("remove <id-or-slug> <path>").description("Remove a working directory from a project").action((idOrSlug, path) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     removeWorkdir(project.id, resolve4(path));
     console.log(source_default.yellow(`\u2713 Removed workdir: ${path}`));
   });
   workdirCmd.command("generate <id-or-slug>").description("Generate CLAUDE.md + AGENTS.md in all working directories").option("--path <path>", "Only generate for a specific workdir path").option("--dry-run", "Show what would be generated without writing").option("--force", "Overwrite existing CLAUDE.md even if not generated by open-projects").action((idOrSlug, opts) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     const allDirs = listWorkdirs(project.id);
     if (opts.path) {
       const absPath = resolve4(opts.path);
@@ -46880,11 +46911,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
     }
   });
   cmd.command("publish <id-or-slug>").description("Publish project to GitHub").option("--org <org>", "GitHub org (default: hasnaxyz)").option("--public", "Make repo public (default: private)").action((idOrSlug, opts) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     try {
       const result = publishProject(project.name, project.path, {
         org: opts.org,
@@ -46900,20 +46927,22 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
     }
   });
   cmd.command("unpublish <id-or-slug>").description("Remove GitHub remote from project (does not delete the repo)").action((idOrSlug) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     unpublishProject(project.path);
     console.log(source_default.yellow(`\u2713 Removed origin remote from ${project.name}`));
   });
-  cmd.command("import <path>").description("Import an existing directory as a project").option("--tags <tags>", "Tags (comma-separated)").option("--dry-run", "Show what would be imported without doing it").action(async (path, opts) => {
+  cmd.command("import <path>").description("Import an existing directory as a project").option("--tags <tags>", "Tags (comma-separated)").option("--dry-run", "Show what would be imported without doing it").option("-j, --json", "Output raw JSON").action(async (path, opts) => {
     const { project, skipped, error } = await importProject(path, {
       dryRun: opts.dryRun,
       defaultTags: opts.tags ? opts.tags.split(",").map((t8) => t8.trim()) : [],
       onProgress: (msg) => console.log(source_default.dim(`  ${msg}`))
     });
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify({ project: project ?? null, skipped: skipped ?? null, error: error ?? null }, null, 2));
+      if (error)
+        process.exit(1);
+      return;
+    }
     if (error) {
       console.error(source_default.red(`Error: ${error}`));
       process.exit(1);
@@ -46927,12 +46956,16 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
       printProject(project);
     }
   });
-  cmd.command("import-bulk <dir>").description("Import all subdirectories of a directory as projects").option("--tags <tags>", "Tags to apply to all imported projects (comma-separated)").option("--dry-run", "Show what would be imported without doing it").action(async (dir, opts) => {
+  cmd.command("import-bulk <dir>").description("Import all subdirectories of a directory as projects").option("--tags <tags>", "Tags to apply to all imported projects (comma-separated)").option("--dry-run", "Show what would be imported without doing it").option("-j, --json", "Output raw JSON").action(async (dir, opts) => {
     const result = await importBulk(dir, {
       dryRun: opts.dryRun,
       defaultTags: opts.tags ? opts.tags.split(",").map((t8) => t8.trim()) : [],
       onProgress: (msg) => console.log(source_default.dim(`  ${msg}`))
     });
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
     console.log(source_default.green(`\u2713 imported: ${result.imported.length}`));
     if (result.skipped.length)
       console.log(source_default.dim(`  skipped: ${result.skipped.length}`));
@@ -46942,11 +46975,7 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
     }
   });
   cmd.command("git <id-or-slug> [git-args...]").description("Run a git command inside the project directory").allowUnknownOption().action((idOrSlug, gitArgs) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
-    }
+    const project = resolveProjectOrExit(idOrSlug);
     try {
       gitPassthrough(project.path, gitArgs);
     } catch (err) {
@@ -47025,13 +47054,13 @@ ${source_default.bold(r2.project.name)} ${source_default.dim(r2.project.slug)}`)
       process.exit(1);
     }
   });
-  cmd.command("sync-log <id-or-slug>").description("Show sync history for a project").option("--limit <n>", "Max entries", "10").action((idOrSlug, opts) => {
-    const project = resolveProject(idOrSlug);
-    if (!project) {
-      console.error(source_default.red(`Project not found: ${idOrSlug}`));
-      process.exit(1);
+  cmd.command("sync-log <id-or-slug>").description("Show sync history for a project").option("--limit <n>", "Max entries", "10").option("-j, --json", "Output raw JSON").action((idOrSlug, opts) => {
+    const project = resolveProjectOrExit(idOrSlug);
+    const logs = listSyncLogs(project.id, parsePositiveIntOrExit(opts?.limit, "--limit", 10));
+    if (wantsJsonOutput(opts)) {
+      console.log(JSON.stringify(logs, null, 2));
+      return;
     }
-    const logs = listSyncLogs(project.id, parseInt(opts.limit, 10));
     if (!logs.length) {
       console.log(source_default.dim("No sync history."));
       return;

package/dist/mcp/index.js

@@ -47555,6 +47555,24 @@ function getPkgVersion() {
     return "0.0.0";
   }
 }
+function printHelp() {
+  console.log(`Usage: project-mcp [options]
+
+MCP server for project management tools (stdio transport)
+
+Options:
+  -V, --version  output the version number
+  -h, --help     display help for command`);
+}
+var args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+  printHelp();
+  process.exit(0);
+}
+if (args.includes("--version") || args.includes("-V")) {
+  console.log(getPkgVersion());
+  process.exit(0);
+}
 var server = new McpServer({
   name: "project",
   version: getPkgVersion()

package/dist/mcp/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/mcp/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/mcp/index.test.ts"],"names":[],"mappings":""}

package/package.json

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