How amherryyy/flower works
Flower is a framework and CLI for creating, validating, and safely upgrading structured projects. The principal workflow starts with a developer invoking flower to inspect, initialize, adopt, or update a project; plans are validated and applied through kernel operations, with journals recording changes. Separate capabilities cover module composition, database/security controls, and workflow-based agent adapters. The README documents these product branches; sampled source confirms some kernel calls, but not every CLI dispatch or integration, so unsupported internal links are omitted.
Main entry points: index.ts Flower CLI · module.ts Module engine · journal.ts Local journal · adoption-application.ts Project adoption
Components 30
CLI entry
- Flower CLI
packages/cli/src/index.ts
Project lifecycle
- Initialization
packages/kernel/src/initialization.ts - Project adoption
packages/kernel/src/adoption-application.ts - Adoption planning
packages/kernel/src/adoption-plan.ts - Module engine
packages/kernel/src/module.ts - Module operations
packages/kernel/src/module-add.ts - Remove and eject
packages/kernel/src/module-disposition.ts - Update planning
packages/kernel/src/update-plan.ts - Update application
packages/kernel/src/update-application.ts - Release packages
packages/kernel/src/release-package.ts - Auth capability
modules/auth/generators/src/flower/auth.ts - Organizations capability
modules/organizations/generators/src/flower/organizations.ts - RBAC capability
modules/rbac/generators/src/flower/rbac.ts - Audit capability
modules/audit/generators/src/flower/audit.ts - Limits capability
modules/limits/generators/src/flower/limits.ts
Kernel foundations
- Project validation
packages/kernel/src/validation.ts - Ownership guards
packages/kernel/src/ownership.ts - Local journal
packages/kernel/src/journal.ts - Template verification
packages/kernel/src/template.ts
Database security
- Database migrations
packages/kernel/src/postgres-migration.ts - RLS controls
packages/kernel/src/rls.ts - Security baseline
packages/kernel/src/security.ts - Service-role policy
packages/kernel/src/service-role.ts - Upload validation
packages/kernel/src/upload.ts - Usage quotas
packages/kernel/src/usage-policy.ts
Workflow adapters
- Workflow engine
packages/kernel/src/workflow.ts - Workflow journal
packages/kernel/src/workflow-journal.ts - Adapter discovery
packages/cli/src/agent-adapters.ts - Adapter materialization
packages/kernel/src/agent-adapter-materialization.ts
Other components
- Developer
Connections 24
- Developer → Flower CLI: invokes
README.md - Flower CLI → Project validation: validates projects
README.md - Flower CLI → Initialization: initializes
README.md - Flower CLI → Project adoption: adopts projects
README.md - Flower CLI → Update planning: plans updates
README.md - Flower CLI → Module operations: adds modules
README.md - Flower CLI → Remove and eject: removes or ejects
README.md - Flower CLI → Security baseline: checks security
README.md - Flower CLI → Adapter discovery: syncs adapters
README.md - Adapter discovery → Adapter materialization: creates bundle
packages/cli/src/agent-adapters.ts - Adoption planning → Module engine: resolves modules
packages/kernel/src/adoption-plan.ts - Module operations → Module engine: resolves modules
packages/kernel/src/module-add.ts - Project adoption → Adoption planning: applies plan
packages/kernel/src/adoption-application.ts - Project adoption → Adapter materialization: materializes adapters
packages/kernel/src/adoption-application.ts - Initialization → Local journal: records operation
packages/kernel/src/initialization.ts - Module operations → Local journal: records operation
packages/kernel/src/module-add.ts - Adapter materialization → Local journal: records operation
packages/kernel/src/agent-adapter-materialization.ts - Update application → Local journal: records operation
packages/kernel/src/update-application.ts - Workflow journal → Workflow engine: validates schema
packages/kernel/src/workflow-journal.ts - Auth capability → Module engine: defines capability
- Organizations capability → Module engine: defines capability
- RBAC capability → Module engine: defines capability
- Audit capability → Module engine: defines capability
- Limits capability → Module engine: defines capability