Known Issues & Feature Status (v0.8.0)
Version: 0.8.0 (First Alpha Release)
Last Updated: November 23, 2025
Status: Production Ready (Alpha Testing Begins Nov 24)
✅ What Works (Production Ready)
These features have been tested, completed, and are ready for alpha testing:
Core Infrastructure
-
✅ Interactive setup wizard (python main.py setup)
- System verification (Docker, Python, ports)
- User account creation with secure password (bcrypt-hashed)
- Password confirmation and validation (min 8 chars)
- API key validation and storage
- Database initialization
- Docker installation guidance (platform-specific)
-
✅ System health checker (python main.py status)
- Database connection status
- API key validation
- Performance metrics
- User detection (#255)
- Recommendations
-
✅ Preference system (python main.py preferences)
- 5-dimension questionnaire (communication, work, decision, learning, feedback)
- Stores in alpha_users.preferences (JSONB)
- Personalizes Piper’s behavior
User Management
-
✅ Multi-user support
- Separate alpha_users table (21 columns, 9 indexes)
- User migration tool (
python main.py migrate-user)
- Role-based access control (superuser, user)
- Clean alpha/production separation
-
✅ Authentication
- Password setup via interactive wizard (bcrypt, 12 rounds)
- JWT token generation and validation
- Token blacklist with CASCADE delete (Issue #291)
- Secure keychain storage for API keys
- Session management
- Login/logout flow
Security & Audit
Database & Persistence
-
✅ PostgreSQL database (via Docker)
- Alembic migrations working
- SSL/TLS support
- Connection pooling
- Health checks
- Performance tests passing
-
✅ UUID-based user IDs (Issue #262)
- Native PostgreSQL UUID type
- Optimized indexing and foreign keys
- 1.70ms lookup performance
- Migration complete (Nov 10, 2025)
-
✅ Referential integrity (Issue #291)
- Token blacklist CASCADE delete
- Foreign key constraints enforced
- Orphaned token prevention
- Migration complete (Nov 10, 2025)
-
✅ Knowledge graph
- Node creation and updates
- Edge management
- Boundary-filtered queries
- Bulk operations
- Subgraph extraction
File Operations
Development Quality
UX Polish (Sprint A7)
User Interface (Nov 22-23, 2025)
- ✅ Lists Management (/lists)
- Create, view, edit, delete lists
- Share with other users (Viewer/Editor/Admin roles)
- Permission-aware UI with role badges
- Breadcrumb navigation
- Issue #379-6: Create button fixed (was commented out, now working)
- ✅ Todos Management (/todos)
- Same functionality as Lists
- Separate organization for tasks
- Issue #379-7: Create button fixed (pattern reused from Lists)
- ✅ Projects Management (/projects)
- Same functionality as Lists/Todos
- For larger work items
- ✅ Files Management (/files)
- Upload files (PDF, DOCX, TXT, MD, JSON - max 10MB)
- Download files
- Delete files
- Owner-based access control
- Issue #379-8: UI built Nov 23 (backend was ready)
- ✅ Permission System
- Share resources with specific users
- Role-based access (Viewer, Editor, Admin, Owner)
- Conversational permission commands (“share my list with alex@example.com as editor”)
- Visual permission badges in UI
- Permission helper functions (canEdit, canDelete, canShare, isOwner)
- ✅ Authentication UI
- User menu in navigation header
- Logout functionality (Issue #379-14: endpoint path corrected)
- Token revocation on logout
- Multi-user testing enabled
- ✅ Standup Generation
- Generate daily standup reports
- 2-3 second completion time
- AI-powered summaries
- Issue #379-4: Proxy endpoint fixed (was calling itself, now calls backend)
- ✅ Navigation Polish (Issue #379 - 14 fixes total)
- Breadcrumb navigation on all pages (Home › Lists, etc.)
- Normalized titles (removed “My” prefix from Lists/Todos)
- Settings pages on unified grid
- Integrations placeholder page (no more 404 errors)
- Privacy & Data settings with clear messaging
- Learning dashboard cosmetic polish
- Home page help shortcut
Security & Access Control (Nov 21-23, 2025)
- ✅ SEC-RBAC Phase 1 Complete (Issue #357)
- owner_id validation on 9 resource tables (Files, Lists, Todos, Projects, KnowledgeGraph, etc.)
- shared_with JSONB arrays for permission grants
- Admin bypass pattern (owner_id checks skip for is_admin users)
- All CRUD repositories RBAC-aware
- Migration: 5 Alembic migrations (add columns, backfill owner_id, add shared_with)
- 22/22 integration tests passing
- ADR-044: Lightweight RBAC architecture approved
⚠️ Known Issues
Minor Issues (Non-Blocking)
Cosmetic Issues (Low Priority):
- Settings/Personality page: Minor layout inconsistencies (Issue #379-11 fixed)
- Some pages had missing breadcrumbs (Issue #379 - all fixed)
Features with Placeholder Pages:
- ⏸️ Integrations Management UI: Backend integrations exist (Slack, GitHub, Notion, Calendar) but management UI shows “coming soon” placeholder
- ⏸️ Advanced Privacy Controls: Basic privacy working (owner_id, shared_with), granular controls planned for beta
All P0/P1 issues resolved as of November 23, 2025:
- ✅ Issue #262: UUID Migration - Complete
- ✅ Issue #291: Token Blacklist FK - Complete
- ✅ Issue #263: Response Humanization - Complete
- ✅ Issue #297: Password Setup in Wizard - Complete
- ✅ Issue #376: Frontend RBAC Awareness - Complete (Nov 22)
- ✅ Issue #379: UI Quick Fixes - Complete (14 issues fixed, Nov 23)
- ✅ Issue #357: SEC-RBAC Phase 1 - Complete (Nov 21)
Note: This is alpha software. New issues may be discovered during testing.
🚧 Experimental / Needs Testing
These features exist but need more alpha testing validation:
Learning System
- Pattern recognition: Implemented but needs real-world usage data
- Preference learning: Working but needs validation with varied user styles
- Workflow optimization: Chain-of-Draft implemented, needs testing
- Intelligent automation: Safety-first system complete, needs alpha validation
Integrations (Status TBD)
[PM: Please review these with Chief Architect]
- GitHub: Issue creation, updates, search
- Slack: Message sending, channel reading
- Notion: Page creation, search
- Calendar: Schedule checking, event creation
Morning Standup
- Status: ✅ Working (Issue #379-4 fixed Nov 23)
- Features: Multi-modal generation (text, Slack), reminder integration
- Testing: Proxy endpoint corrected, 2-3 second generation time
- Validation needed: Real daily usage with alpha testers
📋 Planned for Beta (0.9.0)
Features not yet implemented or incomplete:
[PM: Please populate based on roadmap]
High Priority
Medium Priority
Nice to Have
🐛 How to Report Issues
If You Find a Bug
- Check this list first - Is it already known?
- Gather context:
python main.py status > status.txt
- Create detailed report:
WHAT I TRIED: [specific action]
WHAT EXPECTED: [expected result]
WHAT HAPPENED: [actual result]
ERROR MESSAGE: [if any]
SYSTEM STATUS: [attach status.txt]
Reporting Channels
- GitHub Issues: For bugs and feature requests
- Email: christian@[domain] for private issues
- Weekly Check-in: Discuss during scheduled calls
📊 Feature Completeness Matrix
| Feature Category |
Status |
Alpha Ready? |
Notes |
| Setup Wizard |
✅ Complete |
Yes |
With password setup (A8) |
| User Management |
✅ Complete |
Yes |
UUID-based IDs (#262) |
| Authentication |
✅ Complete |
Yes |
JWT + bcrypt + blacklist |
| Password Security |
✅ Complete |
Yes |
Bcrypt 12 rounds (#297) |
| API Keys |
✅ Complete |
Yes |
Multi-provider |
| File Upload |
✅ Complete |
Yes |
10MB, 5 formats |
| Document Processing |
✅ Complete |
Yes |
LLM-powered analysis |
| Audit Logging |
✅ Complete |
Yes |
Comprehensive |
| Boundary Enforcement |
✅ Complete |
Yes |
Ethics layer |
| Knowledge Graph |
✅ Complete |
Yes |
With boundaries |
| Learning System |
🚧 Experimental |
Partial |
Needs validation |
| Integrations |
🚧 Experimental |
TBD |
PM to review |
| Standup Automation |
✅ Complete |
Yes |
Issue #379-4 fixed |
| Lists Management |
✅ Complete |
Yes |
CRUD + sharing (Issue #376) |
| Todos Management |
✅ Complete |
Yes |
CRUD + sharing (Issue #376) |
| Projects Management |
✅ Complete |
Yes |
CRUD + sharing (Issue #376) |
| Files Management |
✅ Complete |
Yes |
Upload/download/delete (Issue #379) |
| Permission System |
✅ Complete |
Yes |
RBAC + sharing + conversational |
| SEC-RBAC |
✅ Complete |
Yes |
Phase 1 owner_id validation |
| Logout Functionality |
✅ Complete |
Yes |
Issue #379-14 fixed |
| Navigation Polish |
✅ Complete |
Yes |
14 QA issues fixed |
🎯 Alpha Testing Goals
What we’re specifically trying to validate:
- Setup Experience: Is the wizard intuitive? Any confusing steps?
- Preference System: Do the 5 dimensions make sense? Any missing?
- Daily Usage: What workflows feel natural? What’s clunky?
- Performance: Is it fast enough? Any lag or delays?
- Reliability: Does it crash? Lose data? Behave unpredictably?
- Value: Does it actually help with PM work? Or just overhead?
📝 Notes for Alpha Testers
What to Focus On:
- Setup experience (did wizard work smoothly?)
- Preference configuration (did it personalize effectively?)
- Core workflows (task management, document handling)
- Integration points (if you use GitHub/Slack/Notion)
- Overall “feel” (is it delightful or frustrating?)
What to Ignore:
- UI polish (we know it’s rough)
- Missing features (see “Planned for Beta”)
- One-off quirks (unless they’re blocking)
What to Report:
- Blockers (can’t use at all)
- Frequent annoyances (happens repeatedly)
- Delightful surprises (what worked great!)
- Missing expectations (thought it would do X, doesn’t)
🔄 Update Frequency
This document will be updated:
- Weekly during active alpha testing
- After each alpha release (0.8.1, 0.8.2, etc.)
- As issues are discovered and fixed
See Also
ALPHA_TESTING_GUIDE.md - Setup and usage instructionsALPHA_AGREEMENT.md - Legal terms and conditionsVERSION_NUMBERING.md - Understanding version 0.8.0- GitHub Issues: https://github.com/mediajunkie/piper-morgan-product/issues
Last Updated: November 23, 2025
Status: Production (ready for alpha testing)
Software Version: 0.8.0