@forloop-cc/forloop-opencode-plugin-planner 2.2.13 → 2.2.15

package/CHANGELOG.md

@@ -10,13 +10,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added - Sprint & Story API Enhancements
 
 #### New Sprint Tools
-- **forloopSprintCreate** - Create new sprint with dates and settings
+- **forloopSpaceSprintCreate** - Create new space with dates and settings
   - Arguments: title, description, startDate, endDate, isPrivate, organizationId
-  - Confirmation messages with sprint details
-- **forloopSprintUpdate** - Update sprint details
+  - Confirmation messages with space details
+- **forloopSpaceSprintUpdate** - Update space details
   - Arguments: sprintId, title, description, startDate, endDate, isPrivate
   - Partial updates supported
-- **forloopSprintDelete** - Delete sprint (with confirmation)
+- **forloopSpaceSprintDelete** - Delete sprint (with confirmation)
   - Arguments: sprintId, confirm (required for safety)
   - Warning message before deletion
 
@@ -155,8 +155,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 #### Core Features
 - `forloopTokenSet` - Set/update ForLoop API token
 - `forloopTokenGet` - Check if API token is configured
-- `forloopSprintGet` - Get sprint details with stories and files
-- `forloopSprintList` - List all accessible sprints
+- `forloopSpaceSprintGet` - Get space details with stories and files
+- `forloopSpaceSprintList` - List all accessible spaces
 - `forloopStoryCreate` - Create new stories
 - `forloopStoryUpdate` - Update existing stories
 - `forloopStoryDelete` - Delete stories

package/CONTRIBUTING.md

@@ -137,7 +137,7 @@ Before submitting your PR, ensure:
 
 Example:
 ```typescript
-describe('forloopSprintList', () => {
+describe('forloopSpaceSprintList', () => {
   it('should list sprints successfully', async () => {
     // Arrange
     mockClient.listSprints.mockResolvedValue([...])

package/docs/CONFIGURATION.md

@@ -110,7 +110,7 @@ opencode
 
 ```bash
 # Quick test without permanent config
-FORLOOP_API_URL=https://api.dev.forloop.cc opencode run "forloopSprintList"
+FORLOOP_API_URL=https://api.dev.forloop.cc opencode run "forloopSpaceSprintList"
 ```
 
 ### Production Deployment

package/docs/DEVELOPER-VS-USER.md

@@ -37,7 +37,7 @@ This document clarifies the difference between **developing** the plugin and **u
 │  $ opencode                                                   │
 │  ─────────────────────────────────────────────────────────   │
 │                                                               │
-│  You: forloopSprintList                                     │
+│  You: forloopSpaceSprintList                                     │
 │       └─ Lists all sprints                                   │
 │                                                               │
 │  You: forloopStoryCreate                                    │
@@ -83,7 +83,7 @@ npm run install:local
 
 # Test in opencode
 opencode
-> forloopSprintList
+> forloopSpaceSprintList
 ```
 
 ### Users (Simple Setup)
@@ -96,7 +96,7 @@ npm install @forloop/opencode-plugin
 
 # Then just use in opencode
 opencode
-> forloopSprintList
+> forloopSpaceSprintList
 ```
 
 ## When Do You Need TypeScript Knowledge?

package/docs/PLANNER-AGENT-IMPROVEMENTS.md

@@ -51,7 +51,7 @@ name: ForLoop Planner  ← THIS should be passed
 ```typescript
 1. Check if .forloop/manifest.json exists
 2. If NOT exists or empty:
-   - Call forloopSprintList to get sprints
+   - Call forloopSpaceSprintList to get sprints
    - Call forloopSyncS3ToLocal to sync latest context
 3. Load context files
 ```

package/docs/PLUGIN-ARCHITECTURE.md

@@ -249,7 +249,7 @@ npm update @forloop/opencode-plugin
 
 **Stored in:** `~/.cache/opencode/node_modules/@forloop/opencode-plugin/`
 
-**Visible to user:** Only the tools (`forloopSprintList`, etc.)
+**Visible to user:** Only the tools (`forloopSpaceSprintList`, etc.)
 
 ### What You See as a User
 

package/docs/QUICKSTART-NON-DEV.md

@@ -44,7 +44,7 @@ Just use commands in opencode chat:
 
 ### List Sprints
 ```
-forloopSprintList
+forloopSpaceSprintList
 ```
 
 ### Create a Story
@@ -61,8 +61,8 @@ forloopAgentBreakdown --storyId 78
 
 | What You Want to Do | Command |
 |---------------------|---------|
-| See all sprints | `forloopSprintList` |
-| See sprint details | `forloopSprintGet --sprintId 14` |
+| See all sprints | `forloopSpaceSprintList` |
+| See sprint details | `forloopSpaceSprintGet --sprintId 14` |
 | Create story | `forloopStoryCreate --title "..." --sprintId 14` |
 | Update story | `forloopStoryUpdate --storyId 78 --status done` |
 | Get AI breakdown | `forloopAgentBreakdown --storyId 78` |

package/docs/USER-INTERACTION-MODEL.md

@@ -9,7 +9,7 @@ The ForLoop Plugin is **NOT a CLI tool** that you run directly. It's an **openco
 ```bash
 # These DON'T work:
 node plugins/tools/sprint-tools.ts          ✗
-npm run forloopSprintList                 ✗
+npm run forloopSpaceSprintList                 ✗
 ./plugins/forloop-plugin.ts                 ✗
 ```
 
@@ -22,7 +22,7 @@ Users interact through **opencode chat** using tool commands:
 opencode
 
 # 2. In the chat, use tool commands:
-forloopSprintList
+forloopSpaceSprintList
 forloopStoryCreate --title "As a user, I want to login" --sprintId 14
 forloopAgentBreakdown --storyId 78
 ```
@@ -56,7 +56,7 @@ forloopAgentBreakdown --storyId 78
 
 | TypeScript Function | User Command |
 |---------------------|--------------|
-| `createSprintListTool()` | `forloopSprintList` |
+| `createSprintListTool()` | `forloopSpaceSprintList` |
 | `createStoryCreateTool()` | `forloopStoryCreate --title "..."` |
 | `createAgentBreakdownTool()` | `forloopAgentBreakdown --storyId 78` |
 
@@ -76,7 +76,7 @@ npm run install:local
 
 # 4. Test in opencode
 opencode
-> forloopSprintList
+> forloopSpaceSprintList
 ```
 
 If you're **using** the plugin:
@@ -84,7 +84,7 @@ If you're **using** the plugin:
 ```bash
 # Just use opencode chat
 opencode
-> forloopSprintList
+> forloopSpaceSprintList
 
 # That's it! No TypeScript knowledge needed.
 ```

package/docs/superpowers/plans/2026-05-03-sprint-isolated-directory-structure.md

@@ -444,7 +444,7 @@ Replace lines 106-117:
    - Confirm active sprint
 3. **IF manifest missing or empty:**
    - ⚠️ **STOP searching immediately**
-   - ✅ **Call `forloopSprintList` to get sprints from API**
+   - ✅ **Call `forloopSpaceSprintList` to get sprints from API**
    - ✅ **Call `forloopUserProfile` to get user info from API**
    - Ask user to select/confirm sprint
    - Create `$HOME/.forloop/manifest.json` after selection
@@ -459,7 +459,7 @@ With:
    - Confirm active sprint
 3. **IF manifest missing or empty:**
    - ⚠️ **STOP searching immediately**
-   - ✅ **Call `forloopSprintList` to get sprints from API**
+   - ✅ **Call `forloopSpaceSprintList` to get sprints from API**
    - ✅ **Call `forloopUserProfile` to get user info from API**
    - Ask user to select/confirm sprint
    - Create `$HOME/.forloop/manifest.json` after selection

package/docs/superpowers/plans/2026-05-29-install-system.md

@@ -371,7 +371,7 @@ show_summary() {
     echo ""
     echo "  Next steps:"
     echo "    1. Start opencode: opencode"
-    echo "    2. List sprints:   forloopSprintList"
+    echo "    2. List sprints:   forloopSpaceSprintList"
     echo "    3. Create a story: forloopStoryCreate --title 'My feature'"
     echo ""
     echo "  Docs: https://github.com/forloop-cc/forloop-opencode-plugin-planner"

package/docs/superpowers/specs/2026-06-08-plugin-test-docker-design.md

@@ -70,7 +70,7 @@ The Docker container installs in this order:
 
 ### Stage E: Tool Discovery
 **Assert:** `opencode run --agent forLoopPlanner "what tools and skills do you have"` produces output that:
-- Lists or references ForLoop plugin tools (forloopSprintList, forloopStoryCreate, forloopAgentQuery, etc.)
+- Lists or references ForLoop plugin tools (forloopSpaceSprintList, forloopStoryCreate, forloopAgentQuery, etc.)
 - References skills loaded from the plugin (sprint-planning, task-tracking, file-management, forloop-skill)
 
 ## No Token Behavior

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@forloop-cc/forloop-opencode-plugin-planner",
-  "version": "2.2.13",
+  "version": "2.2.15",
   "description": "ForLoop integration plugin for opencode — Sprint, story, and agent tools for the ForLoop platform",
   "type": "module",
   "license": "MIT",

package/plugins/forloop-plugin.ts

@@ -100,11 +100,11 @@ export default async (ctx: any) => {
       'forloopTokenGet': createTokenGetTool(),
       
       // Sprint Operations
-      'forloopSprintList': createSprintListTool(client),
-      'forloopSprintGet': createSprintGetTool(client),
-      'forloopSprintCreate': createSprintCreateTool(client),
-      'forloopSprintUpdate': createSprintUpdateTool(client),
-      'forloopSprintDelete': createSprintDeleteTool(client),
+      'forloopSpaceSprintList': createSprintListTool(client),
+      'forloopSpaceSprintGet': createSprintGetTool(client),
+      'forloopSpaceSprintCreate': createSprintCreateTool(client),
+      'forloopSpaceSprintUpdate': createSprintUpdateTool(client),
+      'forloopSpaceSprintDelete': createSprintDeleteTool(client),
       
       // Sub-Sprint (Iteration) Operations
       'forloopSubSprintList'  : createSubSprintListTool(client),
@@ -162,7 +162,7 @@ export default async (ctx: any) => {
       'forloopAgentHistory': createConversationHistoryTool(client),
       'forloopAgentClear': createClearHistoryTool(client),
       'forloopAiAgentList': createAgentListTool(client),
-      'forloopSprintAiAgentsUpdate': createSprintAiAgentsUpdateTool(client),
+      'forloopSpaceSprintAiAgentsUpdate': createSprintAiAgentsUpdateTool(client),
       
       // AI Execution Tools
       ...aiTriggerTools,

package/plugins/tools/agent-sprint-tools.ts

@@ -44,7 +44,7 @@ export function createAgentListTool(client: ForLoopAPIClient) {
 
 export function createSprintAiAgentsUpdateTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Enable or disable AI agents for a sprint',
+    description: 'Enable or disable AI agents for a space',
     args: {
       sprintId: tool.schema.number()
         .optional()

package/plugins/tools/ai-trigger-tools.ts

@@ -8,18 +8,18 @@ import { validateToken } from '../capabilities/auth';
 export function createAITriggerTools(client: ForLoopAPIClient) {
   const tools: Record<string, ReturnType<typeof tool>> = {};
 
-  tools['forloopAiDeveloperSprint'] = createDeveloperSprintTool(client);
+  tools['forloopAiDeveloperSpaceSprint'] = createDeveloperSprintTool(client);
 
   return tools;
 }
 
 /**
- * forloopAiDeveloperSprint - Trigger developer agent for sprint work
+ * forloopAiDeveloperSpaceSprint - Trigger developer agent for space work
  * Triggers the forLoopTaskSupervisor agent via EventBridge → Step Functions → ECS
  */
 function createDeveloperSprintTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Trigger forLoopTaskSupervisor agent to execute sprint work. This sends stories to the developer agent for implementation via EventBridge → Step Functions → ECS Fargate.',
+    description: 'Trigger forLoopTaskSupervisor agent to execute space work. This sends stories to the developer agent for implementation via EventBridge → Step Functions → ECS Fargate.',
     args: {
       sprintId: tool.schema.number()
         .describe('Sprint ID to execute'),
@@ -35,7 +35,7 @@ function createDeveloperSprintTool(client: ForLoopAPIClient) {
       }
 
       try {
-        console.log('[forloopAiDeveloperSprint] Triggering developer agent', {
+        console.log('[forloopAiDeveloperSpaceSprint] Triggering developer agent', {
           sprintId: args.sprintId,
         });
 
@@ -71,7 +71,7 @@ function createDeveloperSprintTool(client: ForLoopAPIClient) {
 - Check the ForLoop dashboard for story status updates
 - Wait for email notification upon completion`
       } catch (error: any) {
-        console.error('[forloopAiDeveloperSprint] Failed to trigger developer', error)
+        console.error('[forloopAiDeveloperSpaceSprint] Failed to trigger developer', error)
         return `❌ Failed to trigger forLoopTaskSupervisor: ${error.message}`
       }
     },

package/plugins/tools/sprint-tools.ts

@@ -6,7 +6,7 @@ import { getToken } from '../capabilities/token-storage';
 
 export function createSprintGetTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Get sprint details including stories, files, and AI agents',
+    description: 'Get space details including stories, files, and AI agents',
     args: {
       sprintId: tool.schema.number()
         .optional()
@@ -49,7 +49,7 @@ export function createSprintGetTool(client: ForLoopAPIClient) {
         });
 
         const lines = [
-          `📋 Sprint #${sprint.id}: ${sprint.title}`,
+          `📋 Space #${sprint.id}: ${sprint.title}`,
           '',
           `**Status**: ${sprint.status}`,
           `**Period**: ${formatDate(sprint.startDate)} - ${formatDate(sprint.endDate)}`,
@@ -80,7 +80,7 @@ export function createSprintGetTool(client: ForLoopAPIClient) {
 
 export function createSprintListTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'List all accessible sprints',
+    description: 'List all accessible spaces',
     args: {
       organizationId: tool.schema.number()
         .optional()
@@ -106,10 +106,10 @@ export function createSprintListTool(client: ForLoopAPIClient) {
         });
 
         if (!sprints.length) {
-          return 'No sprints found.';
+          return 'No spaces found.';
         }
 
-        const lines = ['📋 Sprints:', ''];
+        const lines = ['📋 Spaces:', ''];
         for (const sprint of sprints) {
           const statusIcon = getStatusIcon(sprint.status);
           const orgInfo = sprint.organizationName ? ` (${sprint.organizationName})` : '';
@@ -155,7 +155,7 @@ function getStatusIcon(status: string): string {
 
 export function createSprintCreateTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Create a new sprint with specified dates and settings',
+    description: 'Create a new space with specified dates and settings',
     args: {
       title: tool.schema.string()
         .describe('Sprint title'),
@@ -191,7 +191,7 @@ export function createSprintCreateTool(client: ForLoopAPIClient) {
         });
 
         const lines = [
-          '✅ Sprint created successfully!',
+          '✅ Space created successfully!',
           '',
           `**#${sprint.id}**: ${sprint.title}`,
           `**Period**: ${formatDate(sprint.startDate)} - ${formatDate(sprint.endDate)}`,
@@ -212,7 +212,7 @@ export function createSprintCreateTool(client: ForLoopAPIClient) {
 
 export function createSprintUpdateTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Update sprint details',
+    description: 'Update space details',
     args: {
       sprintId: tool.schema.number()
         .describe('Sprint ID to update'),
@@ -249,7 +249,7 @@ export function createSprintUpdateTool(client: ForLoopAPIClient) {
 
         const sprint = await client.updateSprint(args.sprintId, updateData);
 
-        return `✅ Sprint #${sprint.id} updated successfully!`;
+        return `✅ Space #${sprint.id} updated successfully!`;
       } catch (error: any) {
         return `❌ Error: ${error.message}`;
       }
@@ -259,7 +259,7 @@ export function createSprintUpdateTool(client: ForLoopAPIClient) {
 
 export function createSprintDeleteTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Delete a sprint (use with caution)',
+    description: 'Delete a space (use with caution)',
     args: {
       sprintId: tool.schema.number()
         .describe('Sprint ID to delete'),
@@ -276,7 +276,7 @@ export function createSprintDeleteTool(client: ForLoopAPIClient) {
 
       if (!args.confirm) {
         return [
-          '⚠️ Warning: This will permanently delete the sprint and all its stories.',
+          '⚠️ Warning: This will permanently delete the space and all its stories.',
           '',
           'Use --confirm true to proceed.',
         ].join('\n');
@@ -285,7 +285,7 @@ export function createSprintDeleteTool(client: ForLoopAPIClient) {
       try {
         await client.deleteSprint(args.sprintId);
 
-        return `✅ Sprint #${args.sprintId} deleted successfully!`;
+        return `✅ Space #${args.sprintId} deleted successfully!`;
       } catch (error: any) {
         return `❌ Error: ${error.message}`;
       }
@@ -295,7 +295,7 @@ export function createSprintDeleteTool(client: ForLoopAPIClient) {
 
 export function createSubSprintListTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'List all iterations (sub-sprints) within a sprint',
+    description: 'List all iterations (sub-sprints) within a space',
     args: {
       sprintId: tool.schema.number()
         .optional()
@@ -313,9 +313,9 @@ export function createSubSprintListTool(client: ForLoopAPIClient) {
       try {
         const subSprints = await client.getSubSprints(resolution.sprintId)
         if (subSprints.length === 0) {
-          return `Sprint #${resolution.sprintId} has no iterations yet.`
+          return `Space #${resolution.sprintId} has no iterations yet.`
         }
-        const lines = [`Iterations for sprint #${resolution.sprintId}:`, '']
+        const lines = [`Iterations for space #${resolution.sprintId}:`, '']
         for (const s of subSprints) {
           const active = s.status === 'in_progress' ? ' ▶ ACTIVE' : ''
           lines.push(
@@ -414,7 +414,7 @@ export function createSubSprintUpdateTool(client: ForLoopAPIClient) {
 
 export function createSubSprintDeleteTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Soft-delete an iteration (sub-sprint). Linked stories retain their subSprintId and will not appear in default sprint views.',
+    description: 'Soft-delete an iteration (sub-sprint). Linked stories retain their subSprintId and will not appear in default space views.',
     args: {
       subSprintId: tool.schema.number()
         .describe('Sub-sprint ID to delete'),