Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
projects
What it is
Part of the Projects feature (folder organization for documents and other entities). Owns the project entity: hierarchy, sharing/team-share policy, soft delete/restore/purge, and bulk upload into a project tree.
Start here
src/domain/ports.rs:ProjectRepo,ProjectService, and the upload/search ports — start here to see the contract before the implementation.src/domain/service.rs: the concrete service (access checks, team-share authorization, soft-delete/restore/purge, bulk upload orchestration).src/domain/events.rs: theProjectMacroEventvariants published to the event broker.src/domain/duplicate.rs: folder duplication (ProjectDuplicator, theDuplicateEntityimpl). It recreates subfolders here and copies documents and chats through theProjectContentCopierport, which DSS implements over the documents and chat capabilities.src/outbound/pg_project_repo.rs,src/outbound/dynamo_bulk_upload.rs,src/outbound/s3_upload_urls.rs,src/outbound/sqs_search_indexer.rs: the adapters behind those ports.
Scope
- Owns: project CRUD, hierarchy, team-share authorization for projects, folder duplication, and bulk-upload-into-project orchestration.
- Not here: generic item access/sharing primitives →
entity_access,entity_access_management; property values on a project →properties.
Boundaries
- Depends on:
entity_access,entity_access_management,entity_mutation,macro_event_broker,model_owner,models_permissions. - Used by:
ai_tools(project tools),soup_realtime,services/deleted_item_poller,services/search_processing_service.
Recipes
- Add a mutation route:
src/domain/ports.rs(ProjectServicemethod) →src/domain/service.rs→src/inbound/axum_router.rs. - Add an AI tool:
src/inbound/toolset.rs→ theai_toolsfeature gate inCargo.toml. - Copy a folder tree in from elsewhere (an import): create each folder with
ProjectService::create_project_dated_by_contents. It starts never edited and leaves its parent alone; documents created in it with their own dates date it and the folders above it.
Tool contracts
- AI project tools omit legacy chat targets and results; agent-session lifecycle and sharing belong to
agent_session.
Gotchas
- Folder duplication copies at most
MAX_PROJECT_DUPLICATE_ENTRIESsubfolders, documents, and chats, and discards the whole copy if any part fails. Email threads are filed by a link on the thread, not owned by the folder, so they stay with the source.
Checks
cargo test -p projects(SQLX_OFFLINEunset; requires local MacroDB).
Related
- Rules:
.agents/rules/rust/architecture.md,.agents/rules/rust/security.md