@sylphx/flow 1.8.0 → 1.8.1

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # @sylphx/flow
 
+## 1.8.1
+
+### Patch Changes
+
+- ad56fc3: Add structured completion report format to prompts
+
+  Added comprehensive 3-tier report structure to guide task completion reporting:
+
+  **Tier 1 - Always Required:**
+
+  - Summary, Changes, Commits, Tests, Documentation, Breaking Changes, Known Issues
+
+  **Tier 2 - When Relevant:**
+
+  - Dependencies, Tech Debt, Files Cleanup/Refactor, Next Actions
+
+  **Tier 3 - Major Changes Only:**
+
+  - Performance, Security, Migration, Verification, Rollback, Optimization Opportunities
+
+  Benefits:
+
+  - Forces LLM to remember completed work (must write report)
+  - Provides reviewable, structured output
+  - Prevents incomplete reporting
+  - Consistent format across all tasks
+
+  Includes detailed example for authentication refactoring showing proper usage of each section.
+
+- a4b0b48: Fix broken imports and Ctrl+C handling
+
+  - Fix Ctrl+C gracefully exits during target selection instead of showing stack trace
+  - Restore accidentally deleted object-utils.ts file
+  - Correct 16 broken relative import paths from refactor reorganization:
+    - target-config.ts: Fix imports to config/, core/, services/ (5 paths)
+    - sync-utils.ts: Fix imports to types, servers, paths (3 paths)
+    - mcp-config.ts: Fix imports to config/, core/, target-config (4 paths)
+    - target-utils.ts: Fix import to types (1 path)
+    - execute.ts, setup.ts, flow-orchestrator.ts: Fix sync-utils paths (3 paths)
+
+  All module resolution errors fixed. Application now runs successfully.
+
+- 7e3a3a1: Refactor codebase for better modularity and maintainability
+
+  - Split flow-command.ts into focused modules (1207 → 258 lines, 78% reduction)
+  - Reorganize utils into feature-based directories (config, display, files, security)
+  - Extract reusable utilities (version, banner, status, prompt resolution)
+  - Create modular flow command structure in src/commands/flow/
+  - Add JSONC parser utility for JSON with comments support
+  - Update all imports to use new modular structure
+  - Improve code organization and separation of concerns
+
 ## 1.8.0
 
 ### Minor Changes

package/assets/output-styles/silent.md

@@ -15,23 +15,156 @@ User sees work through:
 - Test results
 - Commits
 
+---
+
 ## At Completion
 
-<!-- P0 --> Report what was accomplished, verification status, artifacts created.
+Report what was accomplished. Structured, comprehensive, reviewable.
 
-<example>
-✅ "Refactored 3 files. All tests passing. Published v1.2.3."
-✅ "Fixed auth bug. Added test. Verified."
-❌ [Silent after completing work]
-</example>
+### Report Structure
+
+#### 🔴 Tier 1: Always Required
+
+```markdown
+## Summary
+[1-2 sentences: what was done]
+
+## Changes
+- [Key changes made]
+
+## Commits
+- [List of commits with hashes]
+
+## Tests
+- Status: ✅/❌
+- Coverage: [if changed]
+
+## Documentation
+- Updated: [files]
+- Added: [files]
+
+## Breaking Changes
+- [List, or "None"]
+
+## Known Issues
+- [List, or "None"]
+```
+
+#### 🟡 Tier 2: When Relevant
+
+```markdown
+## Dependencies
+- Added: [package@version (reason)]
+- Removed: [package@version (reason)]
+- Updated: [package: old → new]
+
+## Tech Debt
+- Removed: [what was cleaned]
+- Added: [what was introduced, why acceptable]
+
+## Files
+- Cleanup: [files removed/simplified]
+- Refactored: [files restructured]
+
+## Next Actions
+- [ ] [Remaining work]
+```
+
+#### 🔵 Tier 3: Major Changes Only
+
+```markdown
+## Performance
+- Bundle: [size change]
+- Speed: [improvement/regression]
+- Memory: [change]
+
+## Security
+- Fixed: [vulnerabilities]
+- Added: [security measures]
+
+## Migration
+Steps for users:
+1. [Action 1]
+2. [Action 2]
+
+## Verification
+How to test:
+1. [Step 1]
+2. [Step 2]
+
+## Rollback
+If issues:
+1. [Rollback step]
+
+## Optimization Opportunities
+- [Future improvements]
+```
+
+### Example Report
+
+```markdown
+## Summary
+Refactored authentication system to use JWT tokens instead of sessions.
+
+## Changes
+- Replaced session middleware with JWT validation
+- Added token refresh endpoint
+- Updated user login flow
+
+## Commits
+- feat(auth): add JWT token generation (a1b2c3d)
+- feat(auth): implement token refresh (e4f5g6h)
+- refactor(auth): remove session storage (i7j8k9l)
+- docs(auth): update API documentation (m0n1o2p)
+
+## Tests
+- Status: ✅ All passing (142/142)
+- Coverage: 82% → 88% (+6%)
+- New tests: 8 unit, 2 integration
+
+## Documentation
+- Updated: API.md, auth-flow.md
+- Added: jwt-setup.md
+
+## Breaking Changes
+- Session cookies no longer supported
+- `/auth/session` endpoint removed
+- Users must implement token storage
+
+## Known Issues
+- None
+
+## Dependencies
+- Added: jsonwebtoken@9.0.0 (JWT signing/verification)
+- Removed: express-session@1.17.0 (replaced by JWT)
+
+## Migration
+Users need to:
+1. Update client to store tokens: `localStorage.setItem('token', response.token)`
+2. Add Authorization header: `Authorization: Bearer ${token}`
+3. Implement token refresh on 401 errors
+
+## Performance
+- Bundle: -15KB (removed session dependencies)
+- Login speed: -120ms (no server session lookup)
+
+## Verification
+1. Run: `npm test`
+2. Test login: Should receive token in response
+3. Test protected route: Should work with Authorization header
+```
+
+---
 
 ## Never
 
-<!-- P0 --> Don't narrate during execution.
+Don't narrate during execution.
 
 <example>
 ❌ "Now I'm going to search for the authentication logic..."
 ✅ [Uses Grep tool silently]
 </example>
 
-<!-- P1 --> Don't create report files (ANALYSIS.md, FINDINGS.md, REPORT.md).
+Don't create report files (ANALYSIS.md, FINDINGS.md, REPORT.md).
+
+Report directly to user at completion.

package/assets/rules/core.md

@@ -143,11 +143,28 @@ When stuck:
 
 **Output Style**: Concise and direct. No fluff, no apologies, no hedging. Show, don't tell. Code examples over explanations. One clear statement over three cautious ones.
 
-**Task Completion**: Report accomplishments, verification, changes.
+**Task Completion**: Report accomplishments using structured format.
+
+Always include:
+- Summary (what was done)
+- Commits (with hashes)
+- Tests (status + coverage)
+- Documentation (updated files)
+- Breaking changes (if any)
+- Known issues (if any)
+
+When relevant, add:
+- Dependencies changed
+- Tech debt status
+- Files cleanup/refactor
+- Next actions
+
+See output-styles for detailed report structure.
 
 <example>
-✅ "Refactored 5 files. 47 tests passing. No breaking changes."
+✅ Structured report with all required sections
 ❌ [Silent after completing work]
+❌ "Done" (no details)
 </example>
 
 **Minimal Effective Prompt**: All docs, comments, delegation messages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sylphx/flow",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "AI-powered development workflow automation with autonomous loop mode and smart configuration",
   "type": "module",
   "bin": {
@@ -27,17 +27,7 @@
     "gray-matter": "^4.0.3",
     "yaml": "^2.8.1",
     "zod": "^4.1.12",
-    "debug": "^4.4.3",
-    "react": "^19.2.0",
-    "ink": "^6.4.0",
-    "drizzle-orm": "^0.44.7",
-    "@modelcontextprotocol/sdk": "^1.21.0",
-    "@libsql/client": "^0.15.15",
-    "@lancedb/lancedb": "^0.22.2",
-    "@huggingface/transformers": "^3.7.6",
-    "chokidar": "^4.0.3",
-    "ignore": "^7.0.5",
-    "ai": "^5.0.88"
+    "debug": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^24.9.2",