@forloop-cc/forloop-cli 0.2.12 → 0.2.14

package/ERRORS.md

@@ -44,37 +44,37 @@ No error scenarios — silently clears the token.
 
 ## Sprint Commands
 
-### `forloop sprint get`
+### `forloop space-sprint get`
 
 | Scenario | Error Message |
 |---|---|
 | No sprint ID resolved | `Error: No sprint ID resolved. Use --id, set FORLOOP_SPRINT_ID, or use a sprint-XXX branch.` |
 | Sprint not found (404) | `ForLoop API GET /api/opencode/sprints/<id> failed: 404 Not Found` |
 
-### `forloop sprint list`
+### `forloop space-sprint list`
 
 | Scenario | Error Message |
 |---|---|
 | No sprints found | `No sprints found.` |
 
-### `forloop sprint create`
+### `forloop space-sprint create`
 
 | Scenario | Error Message |
 |---|---|
 | Missing `--title`, `--start-date`, or `--end-date` | `Error: --title, --start-date, and --end-date are required` |
 
-### `forloop sprint update`
+### `forloop space-sprint update`
 
 | Scenario | Error Message |
 |---|---|
 | `--id` not provided | `Error: --id is required` |
 | No fields to update | `Error: at least one field to update is required` |
 
-### `forloop sprint delete`
+### `forloop space-sprint delete`
 
 | Scenario | Error Message |
 |---|---|
-| `--confirm` not provided | `Error: --confirm is required to permanently delete a sprint.` |
+| `--confirm` not provided | `Error: --confirm is required to permanently delete a space.` |
 | Sprint not found | `ForLoop API DELETE /api/opencode/sprints/<id> failed: 404 Not Found` |
 
 ---

package/README.md

@@ -83,10 +83,10 @@ In about 30 seconds, you'll be connected:
 forloop auth login --api-key floop_xxxxx
 
 # 3. See your sprints
-forloop sprint list
+forloop space-sprint list
 
 # 4. Dive into a sprint
-forloop sprint get --id 66
+forloop space-sprint get --id 66
 
 # 5. Check what your AI agents are doing
 forloop agent developer-status --sprint 66
@@ -138,19 +138,19 @@ Work with sprints — the containers that hold your stories and track developmen
 
 ```bash
 # List all sprints you have access to
-forloop sprint list
-forloop sprint list --org-id 1
-forloop sprint list --include-system-org    # Include system organization sprints
-forloop sprint list --output json           # Structured JSON output
+forloop space-sprint list
+forloop space-sprint list --org-id 1
+forloop space-sprint list --include-system-org    # Include system organization sprints
+forloop space-sprint list --output json           # Structured JSON output
 
 # Get sprint details, including all stories
-forloop sprint get --id 66
-forloop sprint get --id 66 --no-stories     # Exclude stories
-forloop sprint get --id 66 --no-files       # Exclude files
-forloop sprint get --id 66 --output json    # Structured JSON output
+forloop space-sprint get --id 66
+forloop space-sprint get --id 66 --no-stories     # Exclude stories
+forloop space-sprint get --id 66 --no-files       # Exclude files
+forloop space-sprint get --id 66 --output json    # Structured JSON output
 
 # Create a new sprint
-forloop sprint create \
+forloop space-sprint create \
   --title "Sprint 15" \
   --start-date 2026-06-09 \
   --end-date 2026-06-23 \
@@ -158,11 +158,11 @@ forloop sprint create \
   --org-id 1
 
 # Update sprint details
-forloop sprint update --id 66 --title "Updated Title"
-forloop sprint update --id 66 --description "New goals for this sprint"
+forloop space-sprint update --id 66 --title "Updated Title"
+forloop space-sprint update --id 66 --description "New goals for this sprint"
 
 # Delete a sprint (destructive — requires --confirm)
-forloop sprint delete --id 66 --confirm
+forloop space-sprint delete --id 66 --confirm
 ```
 
 > **Tip:** The CLI auto-detects your sprint from `FORLOOP_SPRINT_ID` env var or a git branch named `sprint-66`. You can often omit `--id` and the right sprint will be chosen.
@@ -381,10 +381,10 @@ A typical session start — load context, check progress, and understand what's
 forloop auth status
 
 # 2. Find your sprint
-forloop sprint list
+forloop space-sprint list
 
 # 3. Load the full picture — stories, status, AI agents
-forloop sprint get --id 66
+forloop space-sprint get --id 66
 
 # 4. Is the developer agent already running?
 forloop agent developer-status --sprint 66
@@ -402,7 +402,7 @@ Create a sprint, add stories, and let AI agents implement them.
 
 ```bash
 # 1. Create the sprint
-forloop sprint create \
+forloop space-sprint create \
   --title "Feature X" \
   --start-date 2026-06-09 \
   --end-date 2026-06-23
@@ -429,7 +429,7 @@ forloop agent developer-sprint --sprint 67
 
 # 5. Monitor progress
 forloop agent developer-status --sprint 67
-forloop sprint get --id 67
+forloop space-sprint get --id 67
 ```
 
 ### Sync Files Between Local and S3
@@ -545,7 +545,7 @@ Tokens must start with `floop_`. Double-check you copied the entire token from h
 ### "Forbidden" or "Not Found" on Specific Resources
 
 Some resources (organizations, stories, files) return 403/404 when you don't have access or they don't exist in your current environment. Try:
-- Verifying the resource ID exists with `forloop sprint get --id <id>`
+- Verifying the resource ID exists with `forloop space-sprint get --id <id>`
 - Checking your token has the required scopes
 
 ### Verbose Debugging
@@ -553,7 +553,7 @@ Some resources (organizations, stories, files) return 403/404 when you don't hav
 When something isn't working, use `--verbose` to see the raw HTTP requests:
 
 ```bash
-forloop sprint get --id 66 --verbose
+forloop space-sprint get --id 66 --verbose
 # Output:
 # > GET https://api.forloop.cc/api/opencode/sprints/66
 # < 200 OK

package/dist/forloop

@@ -1134,15 +1134,15 @@ function createStoryDeleteCommand() {
 // src/commands/sprint.ts
 function createSprintCommands() {
   return {
-    "sprint get": createSprintGetCommand(),
-    "sprint list": createSprintListCommand(),
-    "sprint create": createSprintCreateCommand(),
-    "sprint update": createSprintUpdateCommand(),
-    "sprint delete": createSprintDeleteCommand(),
-    "sprint sub-sprint list": createSubSprintListCommand(),
-    "sprint sub-sprint create": createSubSprintCreateCommand(),
-    "sprint sub-sprint update": createSubSprintUpdateCommand(),
-    "sprint sub-sprint delete": createSubSprintDeleteCommand()
+    "space-sprint get": createSprintGetCommand(),
+    "space-sprint list": createSprintListCommand(),
+    "space-sprint create": createSprintCreateCommand(),
+    "space-sprint update": createSprintUpdateCommand(),
+    "space-sprint delete": createSprintDeleteCommand(),
+    "space-sprint sub-sprint list": createSubSprintListCommand(),
+    "space-sprint sub-sprint create": createSubSprintCreateCommand(),
+    "space-sprint sub-sprint update": createSubSprintUpdateCommand(),
+    "space-sprint sub-sprint delete": createSubSprintDeleteCommand()
   };
 }
 async function getClient2() {
@@ -1157,9 +1157,9 @@ async function getClient2() {
 }
 function createSprintGetCommand() {
   return defineCommand({
-    name: "sprint get",
-    description: "Get sprint details including stories and files",
-    usage: "forloop sprint get --id <number>",
+    name: "space-sprint get",
+    description: "Get space details including stories and files",
+    usage: "forloop space-sprint get --id <number>",
     options: [
       { flag: "--id <number>", description: "Sprint ID (auto-detected if not provided)", type: "number" },
       { flag: "--no-stories", description: "Exclude stories from response" },
@@ -1168,7 +1168,7 @@ function createSprintGetCommand() {
       { flag: "--sub-sprint-id <number>", description: "Filter stories to a specific sub-sprint", type: "number" },
       { flag: "--include-sub-sprints", description: "Include sub-sprints array in response" }
     ],
-    examples: ["forloop sprint get --id 456", "forloop sprint get --id 456 --no-files", "forloop sprint get --id 456 --all-stories"],
+    examples: ["forloop space-sprint get --id 456", "forloop space-sprint get --id 456 --no-files", "forloop space-sprint get --id 456 --all-stories"],
     async run(config, flags) {
       const resolved = await getClient2();
       if (!resolved) return;
@@ -1191,14 +1191,14 @@ function createSprintGetCommand() {
 }
 function createSprintListCommand() {
   return defineCommand({
-    name: "sprint list",
-    description: "List all accessible sprints",
-    usage: "forloop sprint list [--org-id <id>] [--include-system-org]",
+    name: "space-sprint list",
+    description: "List all accessible spaces",
+    usage: "forloop space-sprint list [--org-id <id>] [--include-system-org]",
     options: [
       { flag: "--org-id <id>", description: "Filter by organization ID", type: "number" },
       { flag: "--include-system-org", description: "Include system organization sprints" }
     ],
-    examples: ["forloop sprint list", "forloop sprint list --org-id 1"],
+    examples: ["forloop space-sprint list", "forloop space-sprint list --org-id 1"],
     async run(config, flags) {
       const resolved = await getClient2();
       if (!resolved) return;
@@ -1213,18 +1213,18 @@ function createSprintListCommand() {
 }
 function createSprintCreateCommand() {
   return defineCommand({
-    name: "sprint create",
-    description: "Create a new sprint",
-    usage: "forloop sprint create --title <text> --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD> [flags]",
+    name: "space-sprint create",
+    description: "Create a new space",
+    usage: "forloop space-sprint create --title <text> --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD> [flags]",
     options: [
       { flag: "--title <text>", description: "Sprint title", required: true },
       { flag: "--start-date <date>", description: "Start date (YYYY-MM-DD)", required: true },
       { flag: "--end-date <date>", description: "End date (YYYY-MM-DD)", required: true },
       { flag: "--description <text>", description: "Sprint description" },
-      { flag: "--private", description: "Make sprint private" },
+      { flag: "--private", description: "Make space private" },
       { flag: "--org-id <id>", description: "Organization ID", type: "number" }
     ],
-    examples: ['forloop sprint create --title "Sprint 15" --start-date 2026-06-09 --end-date 2026-06-23'],
+    examples: ['forloop space-sprint create --title "Sprint 15" --start-date 2026-06-09 --end-date 2026-06-23'],
     async run(config, flags) {
       const resolved = await getClient2();
       if (!resolved) return;
@@ -1247,9 +1247,9 @@ function createSprintCreateCommand() {
 }
 function createSprintUpdateCommand() {
   return defineCommand({
-    name: "sprint update",
-    description: "Update sprint details",
-    usage: "forloop sprint update --id <number> [flags]",
+    name: "space-sprint update",
+    description: "Update space details",
+    usage: "forloop space-sprint update --id <number> [flags]",
     options: [
       { flag: "--id <number>", description: "Sprint ID", required: true, type: "number" },
       { flag: "--title <text>", description: "New title" },
@@ -1258,7 +1258,7 @@ function createSprintUpdateCommand() {
       { flag: "--end-date <date>", description: "New end date" },
       { flag: "--private", description: "Set visibility to private" }
     ],
-    examples: ['forloop sprint update --id 456 --title "Updated Sprint"'],
+    examples: ['forloop space-sprint update --id 456 --title "Updated Sprint"'],
     async run(config, flags) {
       const resolved = await getClient2();
       if (!resolved) return;
@@ -1274,44 +1274,44 @@ function createSprintUpdateCommand() {
         process.exit(1);
       }
       const sprint = await client.updateSprint(flags.id, updateData);
-      print(config, sprint, `Sprint #${sprint.id} updated successfully.`);
+      print(config, sprint, `Space #${sprint.id} updated successfully.`);
     }
   });
 }
 function createSprintDeleteCommand() {
   return defineCommand({
-    name: "sprint delete",
-    description: "Delete a sprint permanently",
-    usage: "forloop sprint delete --id <number> --confirm",
+    name: "space-sprint delete",
+    description: "Delete a space permanently",
+    usage: "forloop space-sprint delete --id <number> --confirm",
     options: [
       { flag: "--id <number>", description: "Sprint ID", required: true, type: "number" },
       { flag: "--confirm", description: "Confirm deletion" }
     ],
-    examples: ["forloop sprint delete --id 456 --confirm"],
+    examples: ["forloop space-sprint delete --id 456 --confirm"],
     async run(config, flags) {
       if (!flags.confirm) {
-        console.error("Error: --confirm is required to permanently delete a sprint.");
+        console.error("Error: --confirm is required to permanently delete a space.");
         process.exit(1);
       }
       const resolved = await getClient2();
       if (!resolved) return;
       const { client } = resolved;
       const result = await client.deleteSprint(flags.id);
-      print(config, result, `Sprint #${flags.id} deleted successfully.`);
+      print(config, result, `Space #${flags.id} deleted successfully.`);
     }
   });
 }
 function createSubSprintListCommand() {
   return defineCommand({
-    name: "sprint sub-sprint list",
-    description: "List all iterations within a sprint",
-    usage: "forloop sprint sub-sprint list [--sprint-id <number>]",
+    name: "space-sprint sub-sprint list",
+    description: "List all iterations within a space",
+    usage: "forloop space-sprint sub-sprint list [--sprint-id <number>]",
     options: [
       { flag: "--sprint-id <number>", description: "Sprint ID (auto-detected if not provided)", type: "number" }
     ],
     examples: [
-      "forloop sprint sub-sprint list",
-      "forloop sprint sub-sprint list --sprint-id 456"
+      "forloop space-sprint sub-sprint list",
+      "forloop space-sprint sub-sprint list --sprint-id 456"
     ],
     async run(config, flags) {
       const resolved = await getClient2();
@@ -1329,9 +1329,9 @@ function createSubSprintListCommand() {
 }
 function createSubSprintCreateCommand() {
   return defineCommand({
-    name: "sprint sub-sprint create",
+    name: "space-sprint sub-sprint create",
     description: "Create a new iteration (auto-completes the previously active one)",
-    usage: "forloop sprint sub-sprint create [--sprint-id <number>] --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD> [--title <text>]",
+    usage: "forloop space-sprint sub-sprint create [--sprint-id <number>] --start-date <YYYY-MM-DD> --end-date <YYYY-MM-DD> [--title <text>]",
     options: [
       { flag: "--sprint-id <number>", description: "Sprint ID (auto-detected if not provided)", type: "number" },
       { flag: "--start-date <date>", description: "Start date (YYYY-MM-DD)", required: true },
@@ -1339,8 +1339,8 @@ function createSubSprintCreateCommand() {
       { flag: "--title <text>", description: "Iteration title (auto-generates if not provided)" }
     ],
     examples: [
-      "forloop sprint sub-sprint create --start-date 2026-08-15 --end-date 2026-08-28",
-      "forloop sprint sub-sprint create --sprint-id 456 --start-date 2026-08-15 --end-date 2026-08-28"
+      "forloop space-sprint sub-sprint create --start-date 2026-08-15 --end-date 2026-08-28",
+      "forloop space-sprint sub-sprint create --sprint-id 456 --start-date 2026-08-15 --end-date 2026-08-28"
     ],
     async run(config, flags) {
       const resolved = await getClient2();
@@ -1366,9 +1366,9 @@ function createSubSprintCreateCommand() {
 }
 function createSubSprintUpdateCommand() {
   return defineCommand({
-    name: "sprint sub-sprint update",
+    name: "space-sprint sub-sprint update",
     description: "Update an iteration title, dates, or status",
-    usage: "forloop sprint sub-sprint update --id <number> [--title <text>] [--start-date <date>] [--end-date <date>] [--status <planned|in_progress|completed>]",
+    usage: "forloop space-sprint sub-sprint update --id <number> [--title <text>] [--start-date <date>] [--end-date <date>] [--status <planned|in_progress|completed>]",
     options: [
       { flag: "--id <number>", description: "Sub-sprint ID", required: true, type: "number" },
       { flag: "--title <text>", description: "New title" },
@@ -1377,8 +1377,8 @@ function createSubSprintUpdateCommand() {
       { flag: "--status <string>", description: "New status: planned, in_progress, or completed" }
     ],
     examples: [
-      'forloop sprint sub-sprint update --id 5 --title "Iteration 2 \u2014 Payment Integration"',
-      "forloop sprint sub-sprint update --id 5 --status completed"
+      'forloop space-sprint sub-sprint update --id 5 --title "Iteration 2 \u2014 Payment Integration"',
+      "forloop space-sprint sub-sprint update --id 5 --status completed"
     ],
     async run(config, flags) {
       const resolved = await getClient2();
@@ -1400,14 +1400,14 @@ function createSubSprintUpdateCommand() {
 }
 function createSubSprintDeleteCommand() {
   return defineCommand({
-    name: "sprint sub-sprint delete",
+    name: "space-sprint sub-sprint delete",
     description: "Soft-delete an iteration",
-    usage: "forloop sprint sub-sprint delete --id <number> --confirm",
+    usage: "forloop space-sprint sub-sprint delete --id <number> --confirm",
     options: [
       { flag: "--id <number>", description: "Sub-sprint ID", required: true, type: "number" },
       { flag: "--confirm", description: "Confirm deletion" }
     ],
-    examples: ["forloop sprint sub-sprint delete --id 5 --confirm"],
+    examples: ["forloop space-sprint sub-sprint delete --id 5 --confirm"],
     async run(config, flags) {
       if (!flags.confirm) {
         console.error("Error: --confirm is required to delete an iteration.");
@@ -1599,7 +1599,7 @@ function createTemplateListCommand() {
 function createAgentCommands() {
   return {
     "agent history": createAgentHistoryCommand(),
-    "agent developer-sprint": createDeveloperSprintCommand(),
+    "agent developer-space-sprint": createDeveloperSprintCommand(),
     "agent developer-status": createDeveloperStatusCommand()
   };
 }
@@ -1638,14 +1638,14 @@ function createAgentHistoryCommand() {
 }
 function createDeveloperSprintCommand() {
   return defineCommand({
-    name: "agent developer-sprint",
-    description: "Trigger the developer agent to implement sprint stories",
-    usage: "forloop agent developer-sprint --sprint <id> [--message <text>]",
+    name: "agent developer-space-sprint",
+    description: "Trigger the developer agent to implement space stories",
+    usage: "forloop agent developer-space-sprint --sprint <id> [--message <text>]",
     options: [
       { flag: "--sprint <id>", description: "Sprint ID", required: true, type: "number" },
       { flag: "--message <text>", description: "Instructions for the developer agent" }
     ],
-    examples: ['forloop agent developer-sprint --sprint 1 --message "Implement all planned tasks"'],
+    examples: ['forloop agent developer-space-sprint --sprint 1 --message "Implement all planned tasks"'],
     async run(_config, flags) {
       if (!flags.sprint) {
         console.error("Error: --sprint is required");
@@ -2305,10 +2305,10 @@ ${b("Usage:")} forloop <resource> <command> [flags]
 
 ${b("Resources:")}
   ${a("auth")}       ${d("Authentication (login, status, logout)")}
-  ${a("sprint")}     ${d("Sprint operations (list, get, create, update, delete)")}
+  ${a("space-sprint")}${d("Space operations (list, get, create, update, delete)")}
   ${a("story")}      ${d("Story operations (create, get, update, delete)")}
   ${a("template")}   ${d("Template operations (list)")}
-  ${a("agent")}      ${d("Agent operations (history, developer-sprint, developer-status)")}
+  ${a("agent")}      ${d("Agent operations (history, developer-space-sprint, developer-status)")}
   ${a("org")}        ${d("Organization operations (list, get, create, update)")}
   ${a("user")}       ${d("User operations (profile, quotas)")}
   ${a("file")}       ${d("File operations (upload, list, delete, download)")}
@@ -2390,21 +2390,21 @@ ${d("Global flags (--api-key, --output, --quiet, etc.) are always available.")}
     }
   }
 };
-var sprintGetCmd = createSprintCommands()["sprint get"];
-var sprintListCmd = createSprintCommands()["sprint list"];
-var sprintCreateCmd = createSprintCommands()["sprint create"];
-var sprintUpdateCmd = createSprintCommands()["sprint update"];
-var sprintDeleteCmd = createSprintCommands()["sprint delete"];
-var ssListCmd = createSprintCommands()["sprint sub-sprint list"];
-var ssCreateCmd = createSprintCommands()["sprint sub-sprint create"];
-var ssUpdateCmd = createSprintCommands()["sprint sub-sprint update"];
-var ssDeleteCmd = createSprintCommands()["sprint sub-sprint delete"];
+var sprintGetCmd = createSprintCommands()["space-sprint get"];
+var sprintListCmd = createSprintCommands()["space-sprint list"];
+var sprintCreateCmd = createSprintCommands()["space-sprint create"];
+var sprintUpdateCmd = createSprintCommands()["space-sprint update"];
+var sprintDeleteCmd = createSprintCommands()["space-sprint delete"];
+var ssListCmd = createSprintCommands()["space-sprint sub-sprint list"];
+var ssCreateCmd = createSprintCommands()["space-sprint sub-sprint create"];
+var ssUpdateCmd = createSprintCommands()["space-sprint sub-sprint update"];
+var ssDeleteCmd = createSprintCommands()["space-sprint sub-sprint delete"];
 var storyCreateCmd = createStoryCommands()["story create"];
 var storyGetCmd = createStoryCommands()["story get"];
 var storyUpdateCmd = createStoryCommands()["story update"];
 var storyDeleteCmd = createStoryCommands()["story delete"];
 var agentHistoryCmd = createAgentCommands()["agent history"];
-var agentDeveloperSprintCmd = createAgentCommands()["agent developer-sprint"];
+var agentDeveloperSprintCmd = createAgentCommands()["agent developer-space-sprint"];
 var agentDeveloperStatusCmd = createAgentCommands()["agent developer-status"];
 var fileUploadCmd = createFileCommands()["file upload"];
 var fileListCmd = createFileCommands()["file list"];
@@ -2422,15 +2422,15 @@ var registry = new CommandRegistry({
   ...createFolderCommands(),
   ...createSyncCommands(),
   // Aliases
-  "sprint show": sprintGetCmd,
-  "sprint info": sprintGetCmd,
+  "space-sprint show": sprintGetCmd,
+  "space-sprint info": sprintGetCmd,
   "agent status": agentDeveloperStatusCmd,
-  "agent sprint": agentDeveloperSprintCmd,
+  "agent space-sprint": agentDeveloperSprintCmd,
   // Sub-sprint aliases
-  "sub-sprint list": ssListCmd,
-  "sub-sprint create": ssCreateCmd,
-  "sub-sprint update": ssUpdateCmd,
-  "sub-sprint delete": ssDeleteCmd
+  "space-sprint sub-sprint list": ssListCmd,
+  "space-sprint sub-sprint create": ssCreateCmd,
+  "space-sprint sub-sprint update": ssUpdateCmd,
+  "space-sprint sub-sprint delete": ssDeleteCmd
 });
 
 // src/errors/handler.ts

package/install.sh

@@ -80,11 +80,11 @@ echo ""
 echo -e "${BOLD}Next steps:${NC}"
 echo "  1. Get an API token: https://forloop.cc/profile?tab=api-tokens"
 echo "  2. Authenticate:      forloop auth login --api-key floop_xxxxx"
-echo "  3. Start using:       forloop sprint list"
+echo "  3. Start using:       forloop space-sprint list"
 echo ""
 echo -e "${BOLD}Quick reference:${NC}"
 echo "  forloop --help              Show all commands"
 echo "  forloop auth login          Set your API token"
-echo "  forloop sprint list         List sprints"
+echo "  forloop space-sprint list         List sprints"
 echo "  forloop agent developer-status   Check AI agent status"
 echo ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forloop-cc/forloop-cli",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Command-line interface for the ForLoop AI development platform",
   "type": "module",
   "license": "MIT",