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

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 sprint with dates and settings
   - Arguments: title, description, startDate, endDate, isPrivate, organizationId
   - Confirmation messages with sprint details
-- **forloopSprintUpdate** - Update sprint details
+- **forloopSpaceSprintUpdate** - Update sprint 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 sprint details with stories and files
+- `forloopSpaceSprintList` - List all accessible sprints
 - `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.14",
   "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/ai-trigger-tools.ts

@@ -8,13 +8,13 @@ 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 sprint work
  * Triggers the forLoopTaskSupervisor agent via EventBridge → Step Functions → ECS
  */
 function createDeveloperSprintTool(client: ForLoopAPIClient) {
@@ -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}`
       }
     },