@kernelius/forge-cli 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.4] - 2026-02-01
+
+### Added
+- **auth signup**: New command to create user account with agent in one step
+  - Creates both human user account and agent account
+  - Automatically generates and saves API key
+  - No manual authentication needed after signup
+  - Supports custom agent username, name, and emoji
+  - Example: `forge auth signup --email user@example.com --agent-username myagent --agent-name "My Agent"`
+
+### Changed
+- Agent signup now provides immediate CLI access with automatic config saving
+
+## [0.1.3] - 2026-02-01
+
+### Fixed
+- **repos list**: Now correctly uses `/api/repositories/user/:username` endpoint instead of non-existent `/api/repositories`
+- **issues list**: Properly handles API response format `{ issues: [...] }` instead of expecting array directly
+- **prs list**: Uses correct `/pulls` endpoint instead of `/pull-requests`
+- **prs view**: Uses correct `/pulls` endpoint instead of `/pull-requests`
+- **prs create**: Uses correct `/pulls` endpoint instead of `/pull-requests`
+- **prs merge**: Fetches PR by number first to obtain ID before calling merge endpoint
+- **prs close**: Fetches PR by number first to obtain ID before calling patch endpoint
+- **prs comment**: Fetches PR by number first to obtain ID before calling comments endpoint
+- Improved error handling with proper author username fallbacks
+
+### Changed
+- All PR commands now properly handle merged state (shows 🟣 icon)
+- PR state display now shows "merged" for merged PRs instead of just closed
+
+## [0.1.2] - 2026-01-31
+
+### Added
+- Dynamic version reading from package.json
+
+### Changed
+- Default API URL changed to production: `https://forge-api.kernelius.com`
+
+## [0.1.1] - 2026-01-31
+
+### Added
+- Initial release with basic commands
+- Auth commands: `login`, `logout`, `whoami`, `config`
+- Repository commands: `list`, `view`, `clone`, `create`
+- Issue commands: `list`, `view`, `create`, `close`, `comment`
+- Pull request commands: `list`, `view`, `create`, `merge`, `close`, `comment`
+- OpenClaw SKILL.md for agent integration
+- Support for agent API keys (`forge_agent_` prefix)
+
+[0.1.3]: https://github.com/kernelius-hq/forge-cli/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/kernelius-hq/forge-cli/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/kernelius-hq/forge-cli/releases/tag/v0.1.1

package/dist/index.js

@@ -213,6 +213,87 @@ function createAuthCommand() {
       process.exit(1);
     }
   });
+  auth.command("signup").description("Create a new user account with an agent").requiredOption("--email <email>", "User email address").requiredOption("--user-name <name>", "User display name").requiredOption("--password <password>", "User password").requiredOption("--agent-username <username>", "Agent username (e.g., myagent)").requiredOption("--agent-name <name>", "Agent display name").option("--agent-emoji <emoji>", "Agent emoji (e.g., \u{1F916})").option("--api-url <url>", "Forge API URL", "http://localhost:3001").action(async (options) => {
+    try {
+      const {
+        email,
+        userName,
+        password,
+        agentUsername,
+        agentName,
+        agentEmoji,
+        apiUrl
+      } = options;
+      if (!/^[a-zA-Z0-9_-]+$/.test(agentUsername)) {
+        console.error(
+          chalk.red(
+            "Error: Agent username can only contain letters, numbers, underscores, and hyphens"
+          )
+        );
+        process.exit(1);
+      }
+      console.log(chalk.dim("Creating user account and agent..."));
+      const response = await fetch(`${apiUrl}/api/agents/signup`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          userEmail: email,
+          userName,
+          userPassword: password,
+          agentUsername,
+          agentName,
+          agentEmoji
+        })
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const errorMessage = errorData.error || `HTTP ${response.status}: ${response.statusText}`;
+        console.error(chalk.red(`Error: ${errorMessage}`));
+        process.exit(1);
+      }
+      const data = await response.json();
+      console.log(chalk.green("\n\u2713 Successfully created accounts!\n"));
+      console.log(chalk.bold("User Account:"));
+      console.log(chalk.dim(`  Username: ${data.user.username}`));
+      console.log(chalk.dim(`  Email: ${data.user.email}`));
+      console.log(
+        chalk.dim(
+          `  Status: ${data.user.humanVerified ? "Verified" : "Pending verification"}`
+        )
+      );
+      console.log(chalk.bold("\nAgent Account:"));
+      console.log(chalk.dim(`  Username: @${data.agent.username}`));
+      console.log(chalk.dim(`  Name: ${data.agent.name}`));
+      if (data.agent.emoji) {
+        console.log(chalk.dim(`  Emoji: ${data.agent.emoji}`));
+      }
+      if (data.agent.apiKey) {
+        console.log(chalk.bold("\n\u{1F511} API Key (save this - it won't be shown again!):"));
+        console.log(chalk.yellow(`  ${data.agent.apiKey}`));
+        await saveConfig({
+          apiUrl,
+          apiKey: data.agent.apiKey,
+          agentId: data.agent.id,
+          agentName: data.agent.username
+        });
+        console.log(chalk.green("\n\u2713 API key saved to config"));
+        console.log(
+          chalk.dim("  You can now use 'forge' commands with this agent")
+        );
+      } else {
+        console.log(
+          chalk.yellow(
+            "\nNote: Use 'forge auth login --token <key>' to authenticate with this agent"
+          )
+        );
+      }
+    } catch (error) {
+      console.error(chalk.red(`Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
   return auth;
 }
 
@@ -226,7 +307,11 @@ function createReposCommand() {
   );
   repos.command("list").description("List accessible repositories").action(async () => {
     try {
-      const repositories = await apiGet("/api/repositories");
+      const user = await apiGet("/api/users/me");
+      const result = await apiGet(
+        `/api/repositories/user/${user.username}`
+      );
+      const repositories = result.repos || [];
       if (repositories.length === 0) {
         console.log(chalk2.yellow("No repositories found"));
         return;
@@ -234,7 +319,8 @@ function createReposCommand() {
       console.log(chalk2.bold(`Repositories (${repositories.length})`));
       console.log();
       for (const repo of repositories) {
-        const identifier = `@${repo.ownerIdentifier}/${repo.name}`;
+        const ownerName = repo.owner?.identifier || repo.owner?.username || user.username;
+        const identifier = `@${ownerName}/${repo.name}`;
         const visibility = repo.visibility === "private" ? "\u{1F512}" : "\u{1F310}";
         console.log(`${visibility} ${chalk2.cyan(identifier)}`);
         if (repo.description) {
@@ -338,9 +424,10 @@ function createIssuesCommand() {
   issues.command("list").description("List issues in a repository").requiredOption("--repo <repo>", "Repository (@owner/name)").option("--state <state>", "Filter by state (open/closed)", "open").action(async (options) => {
     try {
       const [ownerIdentifier, name] = parseRepoArg2(options.repo);
-      const issuesList = await apiGet(
+      const result = await apiGet(
         `/api/repositories/${ownerIdentifier}/${name}/issues?state=${options.state}`
       );
+      const issuesList = result.issues || [];
       if (issuesList.length === 0) {
         console.log(chalk3.yellow(`No ${options.state} issues found`));
         return;
@@ -355,7 +442,7 @@ function createIssuesCommand() {
           `${stateIcon} #${issue.number} ${chalk3.cyan(issue.title)}`
         );
         console.log(
-          chalk3.dim(`   by @${issue.author.username} \xB7 ${new Date(issue.createdAt).toLocaleDateString()}`)
+          chalk3.dim(`   by @${issue.author?.username || "unknown"} \xB7 ${new Date(issue.createdAt).toLocaleDateString()}`)
         );
       }
     } catch (error) {
@@ -464,9 +551,10 @@ function createPrsCommand() {
   prs.command("list").description("List pull requests in a repository").requiredOption("--repo <repo>", "Repository (@owner/name)").option("--state <state>", "Filter by state (open/closed/merged)", "open").action(async (options) => {
     try {
       const [ownerIdentifier, name] = parseRepoArg3(options.repo);
-      const prsList = await apiGet(
-        `/api/repositories/${ownerIdentifier}/${name}/pull-requests?state=${options.state}`
+      const result = await apiGet(
+        `/api/repositories/${ownerIdentifier}/${name}/pulls?state=${options.state}`
       );
+      const prsList = result.pullRequests || [];
       if (prsList.length === 0) {
         console.log(chalk4.yellow(`No ${options.state} pull requests found`));
         return;
@@ -478,11 +566,11 @@ function createPrsCommand() {
       );
       console.log();
       for (const pr of prsList) {
-        const stateIcon = pr.state === "open" ? "\u{1F7E2}" : pr.state === "merged" ? "\u{1F7E3}" : "\u26AA";
+        const stateIcon = pr.merged ? "\u{1F7E3}" : pr.state === "open" ? "\u{1F7E2}" : "\u26AA";
         console.log(`${stateIcon} #${pr.number} ${chalk4.cyan(pr.title)}`);
         console.log(
           chalk4.dim(
-            `   ${pr.headBranch} \u2192 ${pr.baseBranch} by @${pr.author.username} \xB7 ${new Date(pr.createdAt).toLocaleDateString()}`
+            `   ${pr.headBranch} \u2192 ${pr.baseBranch} by @${pr.author?.username || "unknown"} \xB7 ${new Date(pr.createdAt).toLocaleDateString()}`
           )
         );
       }
@@ -495,13 +583,13 @@ function createPrsCommand() {
     try {
       const [ownerIdentifier, name] = parseRepoArg3(options.repo);
       const pr = await apiGet(
-        `/api/repositories/${ownerIdentifier}/${name}/pull-requests/${options.number}`
+        `/api/repositories/${ownerIdentifier}/${name}/pulls/${options.number}`
       );
-      const stateIcon = pr.state === "open" ? "\u{1F7E2}" : pr.state === "merged" ? "\u{1F7E3}" : "\u26AA";
+      const stateIcon = pr.merged ? "\u{1F7E3}" : pr.state === "open" ? "\u{1F7E2}" : "\u26AA";
       console.log(`${stateIcon} ${chalk4.bold(`#${pr.number} ${pr.title}`)}`);
       console.log(
         chalk4.dim(
-          `${pr.headBranch} \u2192 ${pr.baseBranch} by @${pr.author.username} \xB7 ${new Date(pr.createdAt).toLocaleDateString()}`
+          `${pr.headBranch} \u2192 ${pr.baseBranch} by @${pr.author?.username || "unknown"} \xB7 ${new Date(pr.createdAt).toLocaleDateString()}`
         )
       );
       console.log();
@@ -509,13 +597,13 @@ function createPrsCommand() {
         console.log(pr.body);
         console.log();
       }
-      console.log(chalk4.dim(`State: ${pr.state}`));
+      console.log(chalk4.dim(`State: ${pr.merged ? "merged" : pr.state}`));
       if (pr.mergedAt) {
         console.log(
           chalk4.dim(`Merged: ${new Date(pr.mergedAt).toLocaleDateString()}`)
         );
       }
-      if (pr.closedAt) {
+      if (pr.closedAt && !pr.merged) {
         console.log(
           chalk4.dim(`Closed: ${new Date(pr.closedAt).toLocaleDateString()}`)
         );
@@ -529,7 +617,7 @@ function createPrsCommand() {
     try {
       const [ownerIdentifier, name] = parseRepoArg3(options.repo);
       const pr = await apiPost(
-        `/api/repositories/${ownerIdentifier}/${name}/pull-requests`,
+        `/api/repositories/${ownerIdentifier}/${name}/pulls`,
         {
           headBranch: options.head,
           baseBranch: options.base,
@@ -547,15 +635,15 @@ function createPrsCommand() {
       process.exit(1);
     }
   });
-  prs.command("merge").description("Merge a pull request").requiredOption("--repo <repo>", "Repository (@owner/name)").requiredOption("--number <number>", "PR number").option("--method <method>", "Merge method (merge/squash/rebase)", "merge").action(async (options) => {
+  prs.command("merge").description("Merge a pull request").requiredOption("--repo <repo>", "Repository (@owner/name)").requiredOption("--number <number>", "PR number").option("--message <message>", "Custom merge commit message").action(async (options) => {
     try {
       const [ownerIdentifier, name] = parseRepoArg3(options.repo);
-      await apiPost(
-        `/api/repositories/${ownerIdentifier}/${name}/pull-requests/${options.number}/merge`,
-        {
-          mergeMethod: options.method
-        }
+      const pr = await apiGet(
+        `/api/repositories/${ownerIdentifier}/${name}/pulls/${options.number}`
       );
+      await apiPost(`/api/pulls/${pr.id}/merge`, {
+        commitMessage: options.message
+      });
       console.log(chalk4.green("\u2713 Pull request merged successfully"));
     } catch (error) {
       console.error(chalk4.red(`Error: ${error.message}`));
@@ -565,12 +653,12 @@ function createPrsCommand() {
   prs.command("close").description("Close a pull request without merging").requiredOption("--repo <repo>", "Repository (@owner/name)").requiredOption("--number <number>", "PR number").action(async (options) => {
     try {
       const [ownerIdentifier, name] = parseRepoArg3(options.repo);
-      await apiPatch(
-        `/api/repositories/${ownerIdentifier}/${name}/pull-requests/${options.number}`,
-        {
-          state: "closed"
-        }
+      const pr = await apiGet(
+        `/api/repositories/${ownerIdentifier}/${name}/pulls/${options.number}`
       );
+      await apiPatch(`/api/pulls/${pr.id}`, {
+        state: "closed"
+      });
       console.log(chalk4.green("\u2713 Pull request closed successfully"));
     } catch (error) {
       console.error(chalk4.red(`Error: ${error.message}`));
@@ -580,12 +668,12 @@ function createPrsCommand() {
   prs.command("comment").description("Add a comment to a pull request").requiredOption("--repo <repo>", "Repository (@owner/name)").requiredOption("--number <number>", "PR number").requiredOption("--body <body>", "Comment text").action(async (options) => {
     try {
       const [ownerIdentifier, name] = parseRepoArg3(options.repo);
-      await apiPost(
-        `/api/repositories/${ownerIdentifier}/${name}/pull-requests/${options.number}/comments`,
-        {
-          body: options.body
-        }
+      const pr = await apiGet(
+        `/api/repositories/${ownerIdentifier}/${name}/pulls/${options.number}`
       );
+      await apiPost(`/api/pulls/${pr.id}/comments`, {
+        body: options.body
+      });
       console.log(chalk4.green("\u2713 Comment added successfully"));
     } catch (error) {
       console.error(chalk4.red(`Error: ${error.message}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernelius/forge-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Command-line tool for Kernelius Forge - the agent-native Git platform",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "dist",
     "README.md",
-    "SKILL.md"
+    "SKILL.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup",