git-vibe-setup 3.0.1 → 3.0.2

package/README.md

@@ -3,9 +3,9 @@
 Local initializer for GitVibe consumer repositories.
 
 ```bash
-npx --package=git-vibe-setup git-vibe-setup
+npx git-vibe-setup setup
 ```
 
-The command writes `.github` and `.git-vibe` starter files, pins reusable
+The `setup` command writes `.github` and `.git-vibe` starter files, pins reusable
 workflow refs to the latest stable `markhuangai/git-vibe` release, and fails
 before writing if release lookup or target-file validation fails.

package/dist/cli.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 interface SetupCliRuntime {
+    argv?: string[];
     cwd?: string;
     error?: (message: string) => void;
     fetchImpl?: typeof fetch;
@@ -8,4 +9,5 @@ interface SetupCliRuntime {
 }
 export declare function runSetup(runtime?: SetupCliRuntime): Promise<void>;
 export declare function setupCli(runtime?: SetupCliRuntime): Promise<number>;
+export declare function isDirectRun(moduleUrl: string, entrypoint?: string): boolean;
 export {};

package/dist/cli.js

@@ -1,10 +1,20 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { fileURLToPath } from "node:url";
 import { blockingInstallPaths, buildInstallFiles, existingFilesError, installFiles, } from "./install.js";
 import { renderManualSetupInstructions } from "./instructions.js";
 import { latestStableReleaseTag } from "./releases.js";
+const usage = `Usage:
+  git-vibe-setup setup
+  git-vibe-setup
+
+Commands:
+  setup   Install GitVibe starter files into the current repository.
+
+Options:
+  -h, --help   Show this help message.`;
 export async function runSetup(runtime = {}) {
     const cwd = runtime.cwd || process.cwd();
     const repositoryRoot = runtime.repositoryRoot || packageRoot();
@@ -17,6 +27,16 @@ export async function runSetup(runtime = {}) {
     (runtime.log || console.log)(renderManualSetupInstructions(releaseTag));
 }
 export async function setupCli(runtime = {}) {
+    const argv = runtime.argv || process.argv.slice(2);
+    const command = argv[0] || "setup";
+    if (command === "--help" || command === "-h" || command === "help") {
+        (runtime.log || console.log)(usage);
+        return 0;
+    }
+    if (command !== "setup") {
+        (runtime.error || console.error)(`Unknown command: ${command}\n\n${usage}`);
+        return 1;
+    }
     try {
         await runSetup(runtime);
         return 0;
@@ -36,6 +56,12 @@ if (isDirectRun(import.meta.url)) {
     process.exitCode = exitCode;
 }
 /* c8 ignore stop */
-function isDirectRun(moduleUrl, entrypoint = process.argv[1]) {
-    return Boolean(entrypoint && moduleUrl === pathToFileURL(resolve(entrypoint)).href);
+export function isDirectRun(moduleUrl, entrypoint = process.argv[1]) {
+    if (!entrypoint)
+        return false;
+    return (pathToFileURL(realpathSync(resolve(entrypoint))).href ===
+        pathToFileURL(modulePath(moduleUrl)).href);
+}
+function modulePath(moduleUrl) {
+    return realpathSync(fileURLToPath(moduleUrl));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-vibe-setup",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "private": false,
   "type": "module",
   "bin": {