@getfrontline/cli 1.0.3 → 1.0.4

package/dist/skills/crm-setup/SKILL.md

@@ -24,7 +24,7 @@ allowed-tools: Bash(frontline:*)
 This skill walks through building a complete CRM system: Companies, Contacts,
 and Deals — with relations, pipeline stages, record types, and views.
 
-> The built-in `standard__companies`, `standard__people`, and `standard__deals` objects already
+> The built-in `companies`, `people`, and `deals` objects already
 > exist. This guide uses **custom objects** to show how to build everything from
 > scratch, but the same patterns apply when extending existing objects.
 
@@ -75,6 +75,8 @@ Use `object create` for business entities and `table create` for simple data.
 # Create a new "Embarques" table
 frontline table create embarques --data '{
   "displayName": "Embarques",
+  "emoji": "truck",
+  "icon_color": "orange",
   "columns": [
     { "name": "Nombre", "type": "string", "metadata": { "format": "text" } }
   ]
@@ -83,6 +85,8 @@ frontline table create embarques --data '{
 # Create a new "Pedidos" table
 frontline table create pedidos --data '{
   "displayName": "Pedidos",
+  "emoji": "package",
+  "icon_color": "blue",
   "columns": [
     { "name": "Nombre", "type": "string", "metadata": { "format": "text" } }
   ]
@@ -92,9 +96,9 @@ frontline table create pedidos --data '{
 The system also ships with these core objects:
 
 ```
-standard__companies  — Companies
-standard__people     — People (contacts)
-standard__deals      — Deals (sales pipeline)
+companies  — Companies
+people     — People (contacts)
+deals      — Deals (sales pipeline)
 ```
 
 Verify they exist:
@@ -103,21 +107,35 @@ Verify they exist:
 frontline object list
 ```
 
+### Setting Icons on Existing Objects/Tables
+
+```bash
+frontline object update deals --data '{"emoji": "handshake", "icon_color": "emerald"}'
+frontline table update embarques --data '{"emoji": "delivery", "icon_color": "teal"}'
+```
+
+### Available Icon Colors
+
+Use the `icon_color` field with a **color name** (case-insensitive):
+
+`red`, `orange`, `amber`, `yellow`, `lime`, `green`, `emerald`, `teal`,
+`cyan`, `sky`, `blue`, `indigo`, `violet`, `purple`, `pink`, `rose`
+
 ## Step 2 — Inspect & Extend the Schema
 
 ### View current fields
 
 ```bash
-frontline object field list standard__companies
-frontline object field list standard__people
-frontline object field list standard__deals
+frontline object field list companies
+frontline object field list people
+frontline object field list deals
 ```
 
 ### Add custom fields
 
 ```bash
 # Add a "Lead Source" select field to People
-frontline object field create standard__people --data '{
+frontline object field create people --data '{
   "name": "Lead Source",
   "type": "select",
   "metadata": { "mode": "singleSelect" }
@@ -125,20 +143,20 @@ frontline object field create standard__people --data '{
 # → Returns: { id: 15, name: "Lead Source", type: "select", ... }
 
 # Add options to the new field (use the field ID from above)
-frontline object option create standard__people 15 --data '{"name": "Website", "color": "Sky"}'
-frontline object option create standard__people 15 --data '{"name": "Referral", "color": "Emerald"}'
-frontline object option create standard__people 15 --data '{"name": "Cold Outreach", "color": "Gray"}'
-frontline object option create standard__people 15 --data '{"name": "Event", "color": "Lavender"}'
+frontline object option create people 15 --data '{"name": "Website", "color": "Sky"}'
+frontline object option create people 15 --data '{"name": "Referral", "color": "Emerald"}'
+frontline object option create people 15 --data '{"name": "Cold Outreach", "color": "Gray"}'
+frontline object option create people 15 --data '{"name": "Event", "color": "Lavender"}'
 
 # Add a "Probability %" number field to Deals
-frontline object field create standard__deals --data '{
+frontline object field create deals --data '{
   "name": "Probability",
   "type": "number",
   "metadata": {}
 }'
 
 # Add a "Next Follow-up" date field to Deals
-frontline object field create standard__deals --data '{
+frontline object field create deals --data '{
   "name": "Next Follow-up",
   "type": "dateOnly",
   "metadata": {}
@@ -150,13 +168,13 @@ frontline object field create standard__deals --data '{
 The built-in objects already have relations defined:
 
 ```bash
-frontline object schema standard__people
-# → relations: [{ name: "companies", target: "standard__companies", mode: "multi" }]
+frontline object schema people
+# → relations: [{ name: "companies", target: "companies", mode: "multi" }]
 
-frontline object schema standard__deals
+frontline object schema deals
 # → relations: [
-#     { name: "people", target: "standard__people", mode: "multi" },
-#     { name: "company", target: "standard__companies", mode: "single" }
+#     { name: "people", target: "people", mode: "multi" },
+#     { name: "company", target: "companies", mode: "single" }
 #   ]
 ```
 
@@ -167,14 +185,14 @@ The `name` field is what you use in all relation commands.
 ### Create companies
 
 ```bash
-frontline object record create standard__companies --data '{
+frontline object record create companies --data '{
   "Name": "Acme Corp",
   "Domain": "acme.com",
   "Primary Location": "New York, USA"
 }'
 # → { id: "6625aaa...", ... }
 
-frontline object record create standard__companies --data '{
+frontline object record create companies --data '{
   "Name": "TechStart Inc",
   "Domain": "techstart.io",
   "Primary Location": "San Francisco, USA"
@@ -185,7 +203,7 @@ frontline object record create standard__companies --data '{
 ### Create contacts
 
 ```bash
-frontline object record create standard__people --data '{
+frontline object record create people --data '{
   "First Name": "Alice",
   "Last Name": "Johnson",
   "Email": "alice@acme.com",
@@ -194,7 +212,7 @@ frontline object record create standard__people --data '{
 }'
 # → { id: "6625ccc...", ... }
 
-frontline object record create standard__people --data '{
+frontline object record create people --data '{
   "First Name": "Bob",
   "Last Name": "Smith",
   "Email": "bob@techstart.io",
@@ -206,10 +224,10 @@ frontline object record create standard__people --data '{
 ### Create deals
 
 ```bash
-# Use option IDs from `frontline object field list standard__deals`
+# Use option IDs from `frontline object field list deals`
 # Stage options: 1=Lead, 2=In Progress, 3=Won, 4=Lost
 
-frontline object record create standard__deals --data '{
+frontline object record create deals --data '{
   "Name": "Acme Enterprise License",
   "Stage": [2],
   "Value": 150000
@@ -223,36 +241,36 @@ frontline object record create standard__deals --data '{
 
 ```bash
 # Alice works at Acme
-frontline object relation link standard__people 6625ccc... Companies 6625aaa...
+frontline object relation link people 6625ccc... Companies 6625aaa...
 
 # Bob works at TechStart
-frontline object relation link standard__people 6625ddd... Companies 6625bbb...
+frontline object relation link people 6625ddd... Companies 6625bbb...
 ```
 
 ### Link deal → company and deal → person
 
 ```bash
 # The Acme deal belongs to Acme Corp
-frontline object relation link standard__deals 6625eee... Company 6625aaa...
+frontline object relation link deals 6625eee... Company 6625aaa...
 
 # Alice is the contact for this deal
-frontline object relation link standard__deals 6625eee... People 6625ccc...
+frontline object relation link deals 6625eee... People 6625ccc...
 ```
 
 ### Verify links
 
 ```bash
 # What company does Alice belong to?
-frontline object relation get standard__people 6625ccc... Companies
+frontline object relation get people 6625ccc... Companies
 
 # Who are the contacts for the Acme deal?
-frontline object relation get standard__deals 6625eee... People
+frontline object relation get deals 6625eee... People
 
 # Which deals belong to Acme Corp? (reverse lookup)
-frontline object relation find-by standard__deals Company 6625aaa...
+frontline object relation find-by deals Company 6625aaa...
 
 # Which people work at Acme Corp? (reverse lookup)
-frontline object relation find-by standard__people Companies 6625aaa...
+frontline object relation find-by people Companies 6625aaa...
 ```
 
 ## Step 6 — Set Up Pipeline Views
@@ -261,10 +279,10 @@ frontline object relation find-by standard__people Companies 6625aaa...
 
 ```bash
 # Get the field IDs to include in each record type
-frontline object field list standard__deals
+frontline object field list deals
 # → Use the IDs for Name, Stage, Value, People, Company
 
-frontline object record-type create standard__deals --data '{
+frontline object record-type create deals --data '{
   "name": "active_pipeline",
   "displayName": "Active Pipeline",
   "columnIds": [1, 2, 3, 5, 8]
@@ -277,14 +295,14 @@ frontline object record-type create standard__deals --data '{
 ```bash
 # Use the Stage field ID for grouping (e.g., field ID 2)
 # Create directly on the object (no record type needed)
-frontline object view create standard__deals --data '{
+frontline object view create deals --data '{
   "name": "Pipeline Board",
   "type": "KANBAN",
   "metadata": { "groupingColumnId": 2 }
 }'
 
 # Or scoped to a specific record type with --record-type <id>
-frontline object view create standard__deals --record-type 7 --data '{
+frontline object view create deals --record-type 7 --data '{
   "name": "Pipeline Board",
   "type": "KANBAN",
   "metadata": { "groupingColumnId": 2 }
@@ -299,13 +317,13 @@ Refine your views to show only the most important information:
 
 ```bash
 # Set order of columns/fields
-frontline object view update standard__deals <view-id> --column-order "Name, Stage, Value, Company"
+frontline object view update deals <view-id> --column-order "Name, Stage, Value, Company"
 
 # Hide less relevant fields
-frontline object view update standard__deals <view-id> --hidden-columns "Created At, Updated At"
+frontline object view update deals <view-id> --hidden-columns "Created At, Updated At"
 
 # Order fields in the record creation dialog
-frontline object view update standard__deals <view-id> --dialog-field-order "Name, Stage, Value, Probability"
+frontline object view update deals <view-id> --dialog-field-order "Name, Stage, Value, Probability"
 ```
 
 ## Step 8 — Query Your CRM
@@ -313,7 +331,7 @@ frontline object view update standard__deals <view-id> --dialog-field-order "Nam
 ### Find high-value deals
 
 ```bash
-frontline object record list standard__deals --query '{
+frontline object record list deals --query '{
   "operator": "and",
   "conditions": [
     { "path": "[Value]", "operator": "gte", "value": 50000 },
@@ -325,7 +343,7 @@ frontline object record list standard__deals --query '{
 ### Find contacts with no company
 
 ```bash
-frontline object record list standard__people --query '{
+frontline object record list people --query '{
   "path": "[Companies]", "operator": "isNull"
 }'
 ```
@@ -333,29 +351,29 @@ frontline object record list standard__people --query '{
 ### Search across fields
 
 ```bash
-frontline object record list standard__people --search "alice"
-frontline object record list standard__companies --search "tech"
+frontline object record list people --search "alice"
+frontline object record list companies --search "tech"
 ```
 
 ### Find all contacts at a specific company
 
 ```bash
-frontline object relation find-by standard__people Companies <company-id>
+frontline object relation find-by people Companies <company-id>
 ```
 
 ## Step 8 — Export & Backup
 
 ```bash
 # Export all deals to spreadsheet
-frontline object export xlsx standard__deals --output deals_report.xlsx
+frontline object export xlsx deals --output deals_report.xlsx
 
 # Export filtered data (only won deals)
-frontline object export csv standard__deals \
+frontline object export csv deals \
   --query '{"path": "[Stage]", "operator": "containsAny", "value": [3]}' \
   --output won_deals.csv
 
 # Export all contacts
-frontline object export xlsx standard__people --output contacts_backup.xlsx
+frontline object export xlsx people --output contacts_backup.xlsx
 ```
 
 ## Quick Command Reference

package/dist/skills/crud-operations/SKILL.md

@@ -269,10 +269,10 @@ Create a new record type with a kanban view for a deals pipeline:
 
 ```bash
 # 1. Check current fields
-frontline object field list standard__deals
+frontline object field list deals
 
 # 2. Create a record type (returns record_type_id)
-frontline object record-type create standard__deals --data '{
+frontline object record-type create deals --data '{
   "name": "enterprise",
   "displayName": "Enterprise Deals",
   "columnIds": [1, 2, 5, 8]

package/dist/skills/export-and-delete/SKILL.md

@@ -23,10 +23,10 @@ frontline object export xlsx <name> [--output file.xlsx]
 
 ```bash
 # Export all people
-frontline object export xlsx standard__people
+frontline object export xlsx people
 
 # Export with filter (high-value deals only)
-frontline object export xlsx standard__deals \
+frontline object export xlsx deals \
   --query '{"path": "[Amount]", "operator": "gte", "value": 10000}' \
   --output big_deals.xlsx
 
@@ -46,7 +46,7 @@ frontline object export csv <name> [--output file.csv]
 
 ```bash
 # Export all records as CSV
-frontline object export csv standard__people --output people_backup.csv
+frontline object export csv people --output people_backup.csv
 ```
 
 ### Default Output
@@ -86,11 +86,11 @@ Always export before deleting:
 
 ```bash
 # 1. Export everything
-frontline object export xlsx standard__legacy_deals --output legacy_deals_backup.xlsx
+frontline object export xlsx legacy_deals --output legacy_deals_backup.xlsx
 
 # 2. Verify the export file exists and looks right
 ls -la legacy_deals_backup.xlsx
 
 # 3. Delete the object
-frontline object delete standard__legacy_deals
+frontline object delete legacy_deals
 ```

package/dist/skills/files/SKILL.md

@@ -55,16 +55,16 @@ frontline table file delete <table> <file-id>
 
 ```bash
 # 1. Find the row
-frontline object row list standard__deals --search "Acme Corp"
+frontline object row list deals --search "Acme Corp"
 # → row ID = 6625abc123def456
 
 # 2. List attached files
-frontline object file list standard__deals 6625abc123def456
+frontline object file list deals 6625abc123def456
 # → [{ id: 15, originalName: "contract_v2.pdf", size: 245000, ... }]
 
 # 3. Download a file
-frontline object file download standard__deals 15 --output ./contract_v2.pdf
+frontline object file download deals 15 --output ./contract_v2.pdf
 
 # 4. Delete an outdated file
-frontline object file delete standard__deals 15
+frontline object file delete deals 15
 ```

package/dist/skills/filter-and-query/SKILL.md

@@ -17,18 +17,18 @@ The `frontline table row list` and `frontline object record list` commands accep
 
 ```bash
 # Simple text search across all fields
-frontline object record list standard__people --search "john"
+frontline object record list people --search "john"
 
 # Filter by a single condition
 # TIP: Use 'frontline object field list <name>' to find field names and tag IDs
-frontline object record list standard__deals --query '{
+frontline object record list deals --query '{
   "path": "[Amount]",
   "operator": "gte",
   "value": 10000
 }'
 
 # Multiple conditions (AND)
-frontline object record list standard__deals --query '{
+frontline object record list deals --query '{
   "operator": "and",
   "conditions": [
     { "path": "[Status]", "operator": "containsAny", "value": [1, 2] },
@@ -37,7 +37,7 @@ frontline object record list standard__deals --query '{
 }'
 
 # Sort results
-frontline object record list standard__people --sort '[{"path": "[Last Name]", "type": "asc"}]'
+frontline object record list people --sort '[{"path": "[Last Name]", "type": "asc"}]'
 ```
 
 ## Path Format
@@ -176,8 +176,8 @@ frontline table row list my_table --page 1 --page-size 50
 ## Filter by Record Type (objects only)
 
 ```bash
-frontline object record list standard__people --record-type lead
-frontline object record list standard__deals --record-type "all"
+frontline object record list people --record-type lead
+frontline object record list deals --record-type "all"
 ```
 
 ## Full Example
@@ -185,7 +185,7 @@ frontline object record list standard__deals --record-type "all"
 Find all open deals worth over $10k, owned by a specific company, sorted by amount:
 
 ```bash
-frontline object record list standard__deals \
+frontline object record list deals \
   --query '{
     "operator": "and",
     "conditions": [

package/dist/skills/frontline-internals/SKILL.md

@@ -24,10 +24,10 @@ Frontline ships with four core objects that form the foundation of every
 account. They are pre-provisioned and cannot be deleted.
 
 ```
-standard__companies   — Organizations / accounts
-standard__people      — Individual contacts
-standard__deals       — Sales opportunities
-standard__tickets     — Support or service requests
+companies   — Organizations / accounts
+people      — Individual contacts
+deals       — Sales opportunities
+tickets     — Support or service requests
 ```
 
 ### Built-in Relations
@@ -118,8 +118,8 @@ that aggregate and summarize information at the People and Company level.
 Use this checklist whenever you are about to create a new object, table, or field:
 
 1. **Is this already a base object?**
-   Check `frontline object list` — `standard__companies`, `standard__people`,
-   `standard__deals`, `standard__tickets` may already fit.
+   Check `frontline object list` — `companies`, `people`,
+   `deals`, `tickets` may already fit.
 
 2. **Is this interaction data?**
    If the new entity stores emails, messages, calls, or any user-to-contact
@@ -204,6 +204,6 @@ points to keep record profiles fresh:
 │  • Updates Vector Store for context-aware AI reasoning         │
 │                                                                 │
 │ BASE OBJECTS                                                    │
-│  standard__companies  standard__people  standard__deals  standard__tickets         │
+│  companies  people  deals  tickets         │
 └─────────────────────────────────────────────────────────────────┘
 ```

package/dist/skills/notes-and-tasks/SKILL.md

@@ -1,53 +1,54 @@
 ---
-name: notes-and-tasks
+name: activities-and-tasks
 description: >
-    How to create, read, update, and delete notes and tasks attached to rows
+    How to create, read, update, and delete activities and tasks attached to rows
     in tables and objects using the Frontline CLI.
 allowed-tools: Bash(frontline:*)
 ---
 
-# Notes & Tasks
+# Activities & Tasks
 
-Notes and tasks are sub-resources attached to individual rows. They let you
-track follow-ups, comments, and to-do items without polluting row fields.
+Activities and tasks are sub-resources attached to individual rows. They let you
+track follow-ups, comments, interactions, and to-do items without polluting row fields.
 
-## Notes
+## Activities
 
-Notes are simple text entries attached to a row.
+Activities log manual interactions on a row. Each activity has a **type**:
+`NOTE`, `EMAIL`, `PHONE_CALL`, `MEETING`, or `WHATSAPP`.
 
-### List Notes
+### List Activities
 
 ```bash
-frontline object note list <object> <row-id>
-frontline table note list <table> <row-id>
+frontline object activity list <object> <row-id>
 ```
 
-### Create a Note
+### Create an Activity
 
 ```bash
-frontline object note create <object> <row-id> --content "Follow up next week"
-frontline table note create <table> <row-id> --content "Check inventory levels"
+# Simple note (default type)
+frontline object activity create <object> <row-id> --content "Follow up next week"
+
+# With a specific type
+frontline object activity create <object> <row-id> --content "Called re: pricing" --type PHONE_CALL
+frontline object activity create <object> <row-id> --content "Discussed contract" --type MEETING
 ```
 
-### Get a Note by ID
+### Get an Activity by ID
 
 ```bash
-frontline object note get <object> <note-id>
-frontline table note get <table> <note-id>
+frontline object activity get <object> <activity-id>
 ```
 
-### Update a Note
+### Update an Activity
 
 ```bash
-frontline object note update <object> <note-id> --content "Updated: follow up tomorrow"
-frontline table note update <table> <note-id> --content "Updated content"
+frontline object activity update <object> <activity-id> --content "Updated: follow up tomorrow"
 ```
 
-### Delete a Note
+### Delete an Activity
 
 ```bash
-frontline object note delete <object> <note-id>
-frontline table note delete <table> <note-id>
+frontline object activity delete <object> <activity-id>
 ```
 
 ---
@@ -60,7 +61,6 @@ Tasks have content, optional due dates, assignees, and a completion state.
 
 ```bash
 frontline object task list <object> <row-id>
-frontline table task list <table> <row-id>
 ```
 
 ### Create a Task
@@ -111,18 +111,18 @@ frontline object task delete <object> <task-id>
 
 ```bash
 # 1. Find the row you want to annotate
-frontline object record list standard__deals --search "Acme"
+frontline object record list deals --search "Acme"
 # → row ID = 6625abc123def456
 
-# 2. Add a note
-frontline object note create standard__deals 6625abc123def456 \
-  --content "Discussed pricing on call"
+# 2. Log a phone call activity
+frontline object activity create deals 6625abc123def456 \
+  --content "Discussed pricing on call" --type PHONE_CALL
 
 # 3. Add a follow-up task with a due date
-frontline object task create standard__deals 6625abc123def456 \
+frontline object task create deals 6625abc123def456 \
   --content "Send revised proposal" \
   --due-date 2026-05-15
 
 # 4. Later, mark it complete
-frontline object task complete standard__deals 7
+frontline object task complete deals 7
 ```

package/dist/skills/pipeline-setup/SKILL.md

@@ -176,33 +176,33 @@ frontline object record list <object> --query '{
 ## Complete Example: Support Ticket Pipeline
 
 ```bash
-# 1. The Status field already exists on standard__tickets as a predefined field.
+# 1. The Status field already exists on tickets as a predefined field.
 #    Check its field ID and existing options:
-frontline object field list standard__tickets
+frontline object field list tickets
 # → Status field ID = 64, existing options: New, On You, On Customer, On Hold, Closed
 
 # 2. Add more stages to the existing Status field (optionsEditable: true)
-frontline object option create standard__tickets 64 --data '{"name": "Escalated", "color": "Bright Red"}'
-frontline object option create standard__tickets 64 --data '{"name": "Waiting on Vendor", "color": "Amber"}'
+frontline object option create tickets 64 --data '{"name": "Escalated", "color": "Bright Red"}'
+frontline object option create tickets 64 --data '{"name": "Waiting on Vendor", "color": "Amber"}'
 
 # 3. Also add a priority field
-frontline object field create standard__tickets --data '{
+frontline object field create tickets --data '{
   "name": "Priority",
   "type": "select",
   "metadata": { "mode": "singleSelect" }
 }'
 # → { id: 11, ... }
 
-frontline object option create standard__tickets 11 --data '{"name": "Critical", "color": "Bright Red"}'
-frontline object option create standard__tickets 11 --data '{"name": "High", "color": "Magenta"}'
-frontline object option create standard__tickets 11 --data '{"name": "Medium", "color": "Amber"}'
-frontline object option create standard__tickets 11 --data '{"name": "Low", "color": "Gray"}'
+frontline object option create tickets 11 --data '{"name": "Critical", "color": "Bright Red"}'
+frontline object option create tickets 11 --data '{"name": "High", "color": "Magenta"}'
+frontline object option create tickets 11 --data '{"name": "Medium", "color": "Amber"}'
+frontline object option create tickets 11 --data '{"name": "Low", "color": "Gray"}'
 
 # 4. Create record type with relevant fields
-frontline object field list standard__tickets
+frontline object field list tickets
 # → Suppose: 1=Subject, 10=Status, 11=Priority, 5=Assignee, 3=Description
 
-frontline object record-type create standard__tickets --data '{
+frontline object record-type create tickets --data '{
   "name": "support_board",
   "displayName": "Support Board",
   "columnIds": [1, 10, 11, 5, 3]
@@ -210,14 +210,14 @@ frontline object record-type create standard__tickets --data '{
 # → { id: 4, ... }
 
 # 5. Create kanban view grouped by Status — directly on the object
-frontline object view create standard__tickets --data '{
+frontline object view create tickets --data '{
   "name": "Ticket Board",
   "type": "KANBAN",
   "metadata": { "groupingColumnId": 10 }
 }'
 
 # 6. Create a table view too (for list browsing)
-frontline object view create standard__tickets --data '{
+frontline object view create tickets --data '{
   "name": "All Tickets",
   "type": "TABLE",
   "metadata": {}