@getfrontline/cli 1.0.0

package/dist/skills/auth-and-profiles/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: auth-and-profiles
+description: How to authenticate and manage CLI profiles for different environments
+---
+
+# Authentication & Profiles
+
+The Frontline CLI supports multiple named profiles for working with different environments (dev, staging, production).
+
+## Quick Start
+
+```bash
+frontline auth login <api-key>
+```
+
+This saves the key to the **default** profile with base URL `http://localhost:7010/public/v1`.
+
+## Managing Profiles
+
+### Create profiles for different environments
+
+```bash
+frontline auth login <key> --profile production --base-url https://api.getfrontline.ai/public/v1
+frontline auth login <key> --profile staging --base-url https://staging.example.com/public/v1
+frontline auth login <key>   # default profile, localhost
+```
+
+### Switch active profile
+
+```bash
+frontline auth use production
+```
+
+All commands will now use the production key and URL until you switch again.
+
+### See all profiles
+
+```bash
+frontline auth status
+```
+
+Output shows each profile's key preview, base URL, and which one is active.
+
+### Check identity
+
+```bash
+frontline auth whoami
+```
+
+Calls the `/me` endpoint and shows account/user info for the active profile.
+
+### Remove a profile
+
+```bash
+frontline auth logout                    # removes current profile
+frontline auth logout --profile staging  # removes specific profile
+```
+
+## Per-Command Overrides
+
+Any command can override the active profile for a single call:
+
+```bash
+frontline object list --api-key <other-key> --base-url https://other.example.com/public/v1
+```
+
+## Resolution Priority
+
+1. `--api-key` / `--base-url` flags
+2. `FRONTLINE_API_KEY` / `FRONTLINE_BASE_URL` env vars
+3. Active profile
+4. Default: `http://localhost:7010/public/v1`
+
+## Typical Workflow
+
+```bash
+# 1. Set up profiles once
+frontline auth login flk_dev_abc --profile dev
+frontline auth login flk_prod_xyz --profile prod --base-url https://api.getfrontline.ai/public/v1
+
+# 2. Work in dev
+frontline auth use dev
+frontline object list
+frontline table row list my_table
+
+# 3. Switch to prod when needed
+frontline auth use prod
+frontline object count sor__deals
+
+# 4. Quick one-off against staging without switching
+frontline object list --api-key flk_stg_123 --base-url https://staging.example.com/public/v1
+```
+
+## Config Location
+
+Config is stored automatically by the OS:
+
+- **Linux**: `~/.config/frontline-cli/config.json`
+- **macOS**: `~/Library/Preferences/frontline-cli/config.json`
+- **Windows**: `%APPDATA%/frontline-cli/Config/config.json`
+
+Run `frontline auth status` to see the exact path.

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

@@ -0,0 +1,385 @@
+---
+name: crm-setup
+description: >
+    End-to-end guide for building a CRM using the Frontline CLI.
+    Covers creating custom objects/tables with fields, setting up relations
+    between entities, adding pipeline stages, populating data, and querying
+    across related objects. Use as a reference when building any multi-entity
+    business workflow from scratch.
+allowed-tools: Bash(frontline:*)
+---
+
+# Building a CRM with the Frontline CLI
+
+This skill walks through building a complete CRM system: Companies, Contacts,
+and Deals — with relations, pipeline stages, record types, and views.
+
+> The built-in `sor__companies`, `sor__people`, and `sor__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.
+
+## Available Field Types
+
+| Type            | Usage                                    | Value format             |
+| --------------- | ---------------------------------------- | ------------------------ |
+| `string`        | Text fields (name, email, url)           | `"text"`                 |
+| `number`        | Numeric fields (amounts, counts)         | `42`                     |
+| `date`          | Timestamps                               | `"2026-04-17T00:00:00Z"` |
+| `dateOnly`      | Date without time                        | `"2026-04-17"`           |
+| `boolean`       | True/false toggles                       | `true` / `false`         |
+| `select`        | Single/multi-select (options with color) | `[1, 3]` (option IDs)    |
+| `relation`      | Link to records in another table         | `["record_id_1"]`        |
+| `autoIncrement` | Auto-generated sequential ID             | _(auto)_                 |
+| `file`          | File attachment                          | _(upload only)_          |
+
+## Available Option Colors
+
+When creating options for select fields, use these color **names** (case-insensitive):
+
+| Name       | Hex       |
+| ---------- | --------- |
+| Terracotta | `#D08F6D` |
+| Amber      | `#FFCA41` |
+| Lime       | `#D4F997` |
+| Emerald    | `#00DC71` |
+| Lavender   | `#B76FFF` |
+| Sky        | `#339AFF` |
+| Magenta    | `#FE55AA` |
+| Bright Red | `#E90012` |
+| Teal       | `#00D1B7` |
+| Gray       | `#727272` |
+| Brown      | `#775B49` |
+| Orange     | `#8D4818` |
+| Yellow     | `#846826` |
+| Green      | `#237045` |
+| Blue       | `#215B9D` |
+| Purple     | `#7132A2` |
+| Pink       | `#A32662` |
+| Red        | `#A0362E` |
+
+## Step 1 — Create the Objects or Tables
+
+Use `object create` for business entities and `table create` for simple data.
+
+```bash
+# Create a new "Embarques" table
+frontline table create embarques --data '{
+  "displayName": "Embarques",
+  "columns": [
+    { "name": "Nombre", "type": "string", "metadata": { "format": "text" } }
+  ]
+}'
+
+# Create a new "Pedidos" table
+frontline table create pedidos --data '{
+  "displayName": "Pedidos",
+  "columns": [
+    { "name": "Nombre", "type": "string", "metadata": { "format": "text" } }
+  ]
+}'
+```
+
+The system also ships with these core objects:
+
+```
+sor__companies  — Companies
+sor__people     — People (contacts)
+sor__deals      — Deals (sales pipeline)
+```
+
+Verify they exist:
+
+```bash
+frontline object list
+```
+
+## Step 2 — Inspect & Extend the Schema
+
+### View current fields
+
+```bash
+frontline object field list sor__companies
+frontline object field list sor__people
+frontline object field list sor__deals
+```
+
+### Add custom fields
+
+```bash
+# Add a "Lead Source" select field to People
+frontline object field create sor__people --data '{
+  "name": "Lead Source",
+  "type": "select",
+  "metadata": { "mode": "singleSelect" }
+}'
+# → Returns: { id: 15, name: "Lead Source", type: "select", ... }
+
+# Add options to the new field (use the field ID from above)
+frontline object option create sor__people 15 --data '{"name": "Website", "color": "Sky"}'
+frontline object option create sor__people 15 --data '{"name": "Referral", "color": "Emerald"}'
+frontline object option create sor__people 15 --data '{"name": "Cold Outreach", "color": "Gray"}'
+frontline object option create sor__people 15 --data '{"name": "Event", "color": "Lavender"}'
+
+# Add a "Probability %" number field to Deals
+frontline object field create sor__deals --data '{
+  "name": "Probability",
+  "type": "number",
+  "metadata": {}
+}'
+
+# Add a "Next Follow-up" date field to Deals
+frontline object field create sor__deals --data '{
+  "name": "Next Follow-up",
+  "type": "dateOnly",
+  "metadata": {}
+}'
+```
+
+## Step 3 — Understand Relations
+
+The built-in objects already have relations defined:
+
+```bash
+frontline object schema sor__people
+# → relations: [{ name: "companies", target: "sor__companies", mode: "multi" }]
+
+frontline object schema sor__deals
+# → relations: [
+#     { name: "people", target: "sor__people", mode: "multi" },
+#     { name: "company", target: "sor__companies", mode: "single" }
+#   ]
+```
+
+The `name` field is what you use in all relation commands.
+
+## Step 4 — Populate Data
+
+### Create companies
+
+```bash
+frontline object record create sor__companies --data '{
+  "Name": "Acme Corp",
+  "Domain": "acme.com",
+  "Primary Location": "New York, USA"
+}'
+# → { id: "6625aaa...", ... }
+
+frontline object record create sor__companies --data '{
+  "Name": "TechStart Inc",
+  "Domain": "techstart.io",
+  "Primary Location": "San Francisco, USA"
+}'
+# → { id: "6625bbb...", ... }
+```
+
+### Create contacts
+
+```bash
+frontline object record create sor__people --data '{
+  "First Name": "Alice",
+  "Last Name": "Johnson",
+  "Email": "alice@acme.com",
+  "Phone Number": "+1-555-0101",
+  "Role": "VP Sales"
+}'
+# → { id: "6625ccc...", ... }
+
+frontline object record create sor__people --data '{
+  "First Name": "Bob",
+  "Last Name": "Smith",
+  "Email": "bob@techstart.io",
+  "Role": "CTO"
+}'
+# → { id: "6625ddd...", ... }
+```
+
+### Create deals
+
+```bash
+# Use option IDs from `frontline object field list sor__deals`
+# Stage options: 1=Lead, 2=In Progress, 3=Won, 4=Lost
+
+frontline object record create sor__deals --data '{
+  "Name": "Acme Enterprise License",
+  "Stage": [2],
+  "Value": 150000
+}'
+# → { id: "6625eee...", ... }
+```
+
+## Step 5 — Link Records
+
+### Link person → company
+
+```bash
+# Alice works at Acme
+frontline object relation link sor__people 6625ccc... Companies 6625aaa...
+
+# Bob works at TechStart
+frontline object relation link sor__people 6625ddd... Companies 6625bbb...
+```
+
+### Link deal → company and deal → person
+
+```bash
+# The Acme deal belongs to Acme Corp
+frontline object relation link sor__deals 6625eee... Company 6625aaa...
+
+# Alice is the contact for this deal
+frontline object relation link sor__deals 6625eee... People 6625ccc...
+```
+
+### Verify links
+
+```bash
+# What company does Alice belong to?
+frontline object relation get sor__people 6625ccc... Companies
+
+# Who are the contacts for the Acme deal?
+frontline object relation get sor__deals 6625eee... People
+
+# Which deals belong to Acme Corp? (reverse lookup)
+frontline object relation find-by sor__deals Company 6625aaa...
+
+# Which people work at Acme Corp? (reverse lookup)
+frontline object relation find-by sor__people Companies 6625aaa...
+```
+
+## Step 6 — Set Up Pipeline Views
+
+### Create record types for deal stages
+
+```bash
+# Get the field IDs to include in each record type
+frontline object field list sor__deals
+# → Use the IDs for Name, Stage, Value, People, Company
+
+frontline object record-type create sor__deals --data '{
+  "name": "active_pipeline",
+  "displayName": "Active Pipeline",
+  "columnIds": [1, 2, 3, 5, 8]
+}'
+# → { id: 7, ... }
+```
+
+### Create a kanban board for the pipeline
+
+```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 sor__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 sor__deals --record-type 7 --data '{
+  "name": "Pipeline Board",
+  "type": "KANBAN",
+  "metadata": { "groupingColumnId": 2 }
+}'
+```
+
+> View types must be uppercase: `KANBAN`, `TABLE`, `RECORD`.
+
+## Step 7 — View Customization (Ordering and Visibility)
+
+Refine your views to show only the most important information:
+
+```bash
+# Set order of columns/fields
+frontline object view update sor__deals <view-id> --column-order "Name, Stage, Value, Company"
+
+# Hide less relevant fields
+frontline object view update sor__deals <view-id> --hidden-columns "Created At, Updated At"
+
+# Order fields in the record creation dialog
+frontline object view update sor__deals <view-id> --dialog-field-order "Name, Stage, Value, Probability"
+```
+
+## Step 8 — Query Your CRM
+
+### Find high-value deals
+
+```bash
+frontline object record list sor__deals --query '{
+  "operator": "and",
+  "conditions": [
+    { "path": "[Value]", "operator": "gte", "value": 50000 },
+    { "path": "[Stage]", "operator": "containsAny", "value": [2] }
+  ]
+}' --sort '[{"path": "[Value]", "type": "desc"}]'
+```
+
+### Find contacts with no company
+
+```bash
+frontline object record list sor__people --query '{
+  "path": "[Companies]", "operator": "isNull"
+}'
+```
+
+### Search across fields
+
+```bash
+frontline object record list sor__people --search "alice"
+frontline object record list sor__companies --search "tech"
+```
+
+### Find all contacts at a specific company
+
+```bash
+frontline object relation find-by sor__people Companies <company-id>
+```
+
+## Step 8 — Export & Backup
+
+```bash
+# Export all deals to spreadsheet
+frontline object export xlsx sor__deals --output deals_report.xlsx
+
+# Export filtered data (only won deals)
+frontline object export csv sor__deals \
+  --query '{"path": "[Stage]", "operator": "containsAny", "value": [3]}' \
+  --output won_deals.csv
+
+# Export all contacts
+frontline object export xlsx sor__people --output contacts_backup.xlsx
+```
+
+## Quick Command Reference
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│ SCHEMA                                                           │
+│  frontline object list                                           │
+│  frontline object schema <obj>                                   │
+│  frontline object field list <obj>                               │
+│  frontline object field create <obj> --data '{...}'              │
+│  frontline object option create <obj> <field-id> --data '{..}'   │
+├──────────────────────────────────────────────────────────────────┤
+│ RECORDS                                                          │
+│  frontline object record create <obj> --data '{...}'             │
+│  frontline object record list <obj> [--query] [--search]         │
+│  frontline object record get <obj> <id>                          │
+│  frontline object record update <obj> <id> --data '{...}'        │
+│  frontline object record delete <obj> <id>                       │
+├──────────────────────────────────────────────────────────────────┤
+│ RELATIONS                                                        │
+│  frontline object relation link <obj> <id> <rel> <target>        │
+│  frontline object relation unlink <obj> <id> <rel> <target>      │
+│  frontline object relation get <obj> <id> <rel>                  │
+│  frontline object relation find-by <obj> <rel> <target-id>       │
+├──────────────────────────────────────────────────────────────────┤
+│ VIEWS & RECORD TYPES                                             │
+│  frontline object record-type list <obj>                         │
+│  frontline object record-type create <obj> --data '{...}'        │
+│  frontline object view list <obj>                                │
+│  frontline object view create <rt-id> --data '{...}'             │
+├──────────────────────────────────────────────────────────────────┤
+│ EXPORT                                                           │
+│  frontline object export xlsx <obj> [--query] [--output]         │
+│  frontline object export csv <obj> [--query] [--output]          │
+└──────────────────────────────────────────────────────────────────┘
+```