@forloop-cc/forloop-cli 0.2.4 → 0.2.6

package/README.md

@@ -1,5 +1,7 @@
 # @forloop-cc/forloop-cli
 
+[English](README.md) · [中文](README_zh.md) · [日本語](README_ja.md)
+
 Command-line interface for the [ForLoop](https://forloop.cc) AI development platform. Manage sprints, stories, files, AI agents, and organizations without leaving your terminal.
 
 ## Table of Contents
@@ -8,7 +10,6 @@ Command-line interface for the [ForLoop](https://forloop.cc) AI development plat
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Authentication](#authentication)
-- [Environments](#environments)
 - [Commands](#commands)
   - [Sprint Operations](#sprint-operations)
   - [Story Operations](#story-operations)
@@ -63,7 +64,7 @@ npm install -g @forloop-cc/forloop-cli
 
 ```bash
 forloop --version
-# Output: forloop 0.2.1
+# Output: forloop 0.2.4
 ```
 
 ---
@@ -129,10 +130,6 @@ forloop auth logout          # Remove saved token
 
 ---
 
----
-
-## Commands
-
 ### Sprint Operations
 
 Work with sprints — the containers that hold your stories and track development cycles.
@@ -141,11 +138,14 @@ Work with sprints — the containers that hold your stories and track developmen
 # 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
 
 # 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
 
 # Create a new sprint
 forloop sprint create \
@@ -193,6 +193,7 @@ forloop story create \
 # Read story details, including developer comments
 forloop story get --id 229
 forloop story get --id 229 --no-comments
+forloop story get --id 229 --output json     # Structured JSON output
 
 # Update a story
 forloop story update --id 229 --status in_progress
@@ -210,7 +211,11 @@ Templates define the structure of your stories. List available templates to see
 
 ```bash
 forloop template list
-# Output shows: Basic Task, Basic Note, Schedule Meeting, New Folder
+# Built-in templates: Basic Task (basic-task), Basic Note (basic-note)
+# Server templates: Schedule Meeting (schedule-meeting), New Folder (doc-folder)
+
+# JSON output:
+forloop template list --output json
 ```
 
 ### Agent Operations
@@ -220,6 +225,7 @@ Interact with ForLoop's AI agents — check their progress, trigger new work, an
 ```bash
 # See what AI agents have discussed in the past
 forloop agent history --sprint 66 --limit 20
+forloop agent history --sprint 66 --output json
 
 # Check if a developer task is running, completed, or failed
 forloop agent developer-status --sprint 66
@@ -241,9 +247,11 @@ Organizations group sprints and control access for teams.
 # List organizations you belong to
 forloop org list
 forloop org list --owned-only    # Only orgs you own
+forloop org list --output json    # Structured JSON output
 
 # View organization details
 forloop org get --id 1
+forloop org get --id 1 --output json
 
 # Create an organization (requires Team or Enterprise tier)
 forloop org create \
@@ -261,14 +269,15 @@ Check your profile, limits, and usage.
 ```bash
 # View your profile
 forloop user profile
-# Output: User: TOSHI WORKSHOP JP, Email: ..., Tier: free
+forloop user profile --output json
 
 # Check your quota limits and current usage
 forloop user quotas
-# Output: Stories used: 23/100, Storage used: 17KB/3GB, etc.
+forloop user quotas --output json
 
 # Check quota usage for a specific organization
 forloop org quotas --org-id 1
+forloop org quotas --org-id 1 --output json
 ```
 
 ### File Operations
@@ -282,6 +291,7 @@ forloop file upload --path ./mockup.png --sprint 66 --folder designs
 
 # List all files in a sprint
 forloop file list --sprint 66
+forloop file list --sprint 66 --output json
 
 # Generate a download link
 forloop file download --id 84

package/dist/forloop

@@ -1688,7 +1688,8 @@ function createFileUploadCommand() {
       { flag: "--path <path>", description: "Local file path", required: true },
       { flag: "--sprint <id>", description: "Target sprint ID", required: true, type: "number" },
       { flag: "--description <text>", description: "File description" },
-      { flag: "--folder <text>", description: "S3 folder within sprint" }
+      { flag: "--folder <text>", description: "S3 folder within sprint" },
+      { flag: "--story-id <id>", description: "Link file to a story (e.g., doc_folder story)", type: "number" }
     ],
     examples: ["forloop file upload --path ./report.pdf --sprint 1 --folder docs"],
     async run(config, flags) {
@@ -1725,7 +1726,10 @@ function createFileUploadCommand() {
         originalName: fileName,
         fileType: contentType,
         size: fileContent.length,
-        folder: flags.folder
+        folder: flags.folder,
+        x: 0,
+        y: 0,
+        storyId: flags.storyId
       });
       print(config, { fileName, size: fileContent.length, url: complete.url, fileId: complete.id }, `File uploaded: ${fileName} (${formatSize(fileContent.length)})`);
     }
@@ -1898,7 +1902,7 @@ function createAivyDocGetCommand() {
       { flag: "--title <text>", description: 'Doc folder title (default: "forloop Aivy doc")' }
     ],
     examples: ["forloop sync aivy-doc-get --sprint 1"],
-    async run(_config, flags) {
+    async run(config, flags) {
       const resolved = await getClient7();
       if (!resolved) return;
       const { client } = resolved;
@@ -1912,9 +1916,9 @@ function createAivyDocGetCommand() {
       const stories = Array.isArray(sprint?.stories) ? sprint.stories : [];
       const existing = stories.find((s) => s.type === "doc_folder" && s.title?.toLowerCase() === title.toLowerCase());
       if (existing?.id) {
-        console.log(`Doc folder: #${existing.id} "${existing.title}" (Sprint #${resolution.sprintId})`);
+        print(config, { docFolderId: existing.id, exists: true, title: existing.title, sprintId: resolution.sprintId }, `Doc folder: #${existing.id} "${existing.title}" (Sprint #${resolution.sprintId})`);
       } else {
-        console.log(`Doc folder not found. Run: forloop sync aivy-folder --sprint ${resolution.sprintId}`);
+        print(config, { exists: false, sprintId: resolution.sprintId }, `Doc folder not found. Run: forloop sync aivy-folder --sprint ${resolution.sprintId}`);
       }
     }
   });
@@ -1977,6 +1981,7 @@ function createLocalToS3Command() {
       { flag: "--path <path>", description: "Local file path", required: true },
       { flag: "--sprint <id>", description: "Target sprint ID", type: "number" },
       { flag: "--folder <text>", description: "Remote folder (e.g., project/plans)" },
+      { flag: "--story-id <id>", description: "Link file to a story (e.g., doc_folder story)", type: "number" },
       { flag: "--delete", description: "Delete remote file instead of uploading" }
     ],
     examples: ["forloop sync local-to-s3 --path ~/.forloop/sprint-1/plan/plan.md --sprint 1"],
@@ -2015,7 +2020,10 @@ function createLocalToS3Command() {
         originalName: fileName,
         fileType: contentType,
         size: fileBuf.length,
-        folder
+        folder,
+        x: 0,
+        y: 0,
+        storyId: flags.storyId
       });
       console.log(`Synced: ${fileName} -> Sprint #${resolution.sprintId}`);
     }

package/package.json

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