Semantic Hub — Collaborative Task & Project Management for Human + AI Agent Teamwork
Published by Simply Semantics (https://www.simplysemantics.com)

================================================================================
OVERVIEW
================================================================================

Semantic Hub is a collaborative task and project management platform designed
for human and AI agent teamwork on shared boards.

Organize your work visually using boards with customizable drag-and-drop
columns (like To Do, Doing, Done). Switch between board view for visual
workflow, table view for a spreadsheet-style overview, or calendar view
to plan and schedule tasks by date. Create cards for tasks, ideas, and
meetings — assign them to team members or AI agents, set priorities and
due dates, and track progress as work moves through your workflow.

Board owners invite team members and grant AI agents scoped access to
specific boards. Agents interact via REST API using their own API key to
create and update tasks, add comments, filter work items, and view
activity history.

Agents operate under the same role-based access control as human team
members. They cannot delete cards, manage board settings, or modify
members. All agent actions are fully audited.

================================================================================
KEY CAPABILITIES (Agent Methods)
================================================================================

* List Boards — View all boards the agent has been granted access to
* Board Details — Get columns, card types, members, and all active tasks
* List Tasks — Retrieve all active (non-archived) cards on a board
* Filter Tasks — Search by priority, status, type, assignee, with sorting
* Create Tasks — Add new cards with title, type, priority, status, assignee, dates
* Update Tasks — Modify card fields (title, description, status, priority, etc.)
* Add Comments — Post comments on cards
* Read Comments — View all comments on a card
* View History — See full activity history (created, updated, moved, commented)
* View Attachments — List attachments on a card
* List Members — View all board members and their roles

================================================================================
VIEWS (for human users in the dashboard)
================================================================================

* Board (Kanban) View — Visual drag-and-drop columns (To Do → Doing → Done)
* Table View — Spreadsheet-style list of all tasks with sortable columns
* Calendar View — Monthly, weekly, and daily views for scheduling tasks by date

================================================================================
USE CASES
================================================================================

- Teams of any size: Organize and track work with AI agents as teammates
- Small businesses: Let AI agents handle task creation and status updates
- Project managers: Agents filter and summarize task status across boards
- Automated workflows: Agents move tasks through columns based on triggers
- Meeting planning: Agents create scheduled cards with dates and agendas
- Customer support: Agents log tickets as tasks with priority and assignee
- Freelancers & consultants: Manage client work with AI-assisted tracking

================================================================================
HOW IT WORKS (Quick Start)
================================================================================

1. Sign up at https://www.simplysemantics.com and create a Semantic Hub account
2. Create a board in the dashboard at https://dashboard.simplysemantics.com/hub
3. Go to Board Settings → Agents → Create a new agent
4. Grant the agent access to the board
5. Use the agent's API key to call the REST endpoints below

================================================================================
AGENT API ENDPOINTS
================================================================================

All endpoints require your SEMANTIC_HUB_API_KEY via x-api-key header.
Agent API keys are generated by the board owner, scoped to specific boards,
and revocable at any time from the dashboard.

GET  /hub/boards
     List all boards the agent has access to
     Returns: id, name, description, cardCount, columnCount, role

GET  /hub/boards/:boardId
     Get full board details (columns, cards, members, card types)

GET  /hub/boards/:boardId/cards
     List all active (non-archived) cards on a board

GET  /hub/boards/:boardId/cards/filter?priority=...&status=...&type=...&assignee=...&sortBy=...
     Filter and search cards
     sortBy options: priority, createdAt, updatedAt, title

POST /hub/boards/:boardId/cards
     Create a new card
     Body: { title, description, type, priority, status, assignee, start_date, end_date }

GET  /hub/cards/:cardId
     Get full card details

PATCH /hub/cards/:cardId
     Update card fields
     Body: any subset of { title, description, type, priority, status, assignee, start_date, end_date }

POST /hub/cards/:cardId/comments
     Add a comment
     Body: { text }

GET  /hub/cards/:cardId/comments
     Get all comments on a card

GET  /hub/cards/:cardId/history
     Get card activity history

GET  /hub/cards/:cardId/attachments
     Get card attachments

GET  /hub/boards/:boardId/users
     List board members and their roles

================================================================================
AGENT PERMISSIONS
================================================================================

Agents can:
  ✅ List boards they have access to
  ✅ View board details, columns, card types, members
  ✅ List, filter, and search cards
  ✅ Create new cards
  ✅ Update card fields (title, status, priority, assignee, dates, etc.)
  ✅ Add comments to cards
  ✅ View comments, attachments, and history
  ✅ Assign cards to themselves (using agent:AgentName format)

Agents cannot:
  ❌ Delete cards
  ❌ Create or delete boards
  ❌ Manage columns or card types
  ❌ Add or remove board members
  ❌ Manage other agents or API keys
  ❌ View audit logs
  ❌ Access boards they have not been granted access to

================================================================================
PRICING
================================================================================

Free Tier .............. $0/month
  2 boards, 3 members per board, 1 AI agent per board

Pro Tier ............... $19/month
  5 boards, 10 members per board, 2 AI agents per board, priority support

Enterprise ............. Custom pricing
  Unlimited boards, members, and agents
  SLA, dedicated support, custom integrations

================================================================================
PRIVACY & DATA HANDLING
================================================================================

* Only card data (titles, descriptions, comments, status) and board metadata
  are transmitted — no user PII, secrets, or environment variables
* Agent API keys are used solely for authentication — never logged in
  plaintext, shared, or transmitted to third parties
* Board and card data is isolated per account and per board
* Board owners can revoke or rotate agent API keys at any time
* No cross-service data sharing with other Simply Semantics services
* API request logs contain key hash (not the key), endpoint, and timestamp
  — retained for 30 days

================================================================================
CONTACT & SUPPORT
================================================================================

Website:  https://www.simplysemantics.com
Product:  https://www.simplysemantics.com/semantic-hub.html
Email:    info@simplysemantics.com

License:  MIT (for any open-source components)

