close / reopen

Mark goals or interactions as closed (complete) or reopen them.

Usage

et close <type> <id> [--json]
et reopen <type> <id> [--json]

Supported Types

Only goals and interactions support status:

Type	Description
goal	Mark a user goal as achieved
interaction	Mark an interaction as complete

Actors and journeys do not have status. Journeys are templates.

Close

Mark work as complete:

et close goal <id> [--json]
et close interaction <id> [--json]

Examples:

# Close a goal
et close goal checkout
# Output: Goal 'checkout' closed

# Close an interaction
et close interaction add_to_cart
# Output: Interaction 'add_to_cart' closed

# With JSON output
et close goal checkout --json
# Output: {"success":true,"message":"Goal 'checkout' closed","data":{...}}

Reopen

Mark closed work as open again:

et reopen goal <id> [--json]
et reopen interaction <id> [--json]

Examples:

# Reopen a goal
et reopen goal checkout
# Output: Goal 'checkout' reopened

# Reopen an interaction
et reopen interaction add_to_cart
# Output: Interaction 'add_to_cart' reopened

Already in Target State

If an entity is already in the target state:

et close goal checkout
# Output: Goal 'checkout' is already closed

This is not an error - the command succeeds.

Effect on List Commands

Closed items are hidden from default list output:

# Shows only open goals (default)
et list goals

# Shows only closed goals
et list goals --closed

# Shows all goals with status column
et list goals --all

See list for more details on status filtering.

Workflow

Typical workflow for tracking work completion:

# Review open work
et list

# Complete implementation...

# Mark goal as achieved
et close goal checkout

# Verify it's now hidden from open list
et list goals
# checkout no longer appears

# View closed work
et list goals --closed
# checkout appears here

JSON Output

With --json, returns the updated entity:

et close goal checkout --json

{
  "success": true,
  "message": "Goal 'checkout' closed",
  "data": {
    "id": "checkout",
    "description": "Complete purchase successfully",
    "actor": "customer",
    "status": "closed",
    "created_at": "2024-01-15T10:30:00.000Z",
    "updated_at": "2024-01-15T14:45:00.000Z"
  }
}

Errors

# Entity not found
et close goal nonexistent
# Error: Goal 'nonexistent' not found

# Invalid type
et close actor customer
# Error: Unknown entity type: actor
# Valid types for close: goal, interaction