town.chalky.task

{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "title",
      "completed",
      "order",
      "createdAt",
      "updatedAt"
    ],
    "properties": {
      "day": {
        "type": "string",
        "description": "Local calendar day the task sits on, as YYYY-MM-DD. Omit for the Someday bucket."
      },
      "color": {
        "type": "string",
        "knownValues": [
          "salmon",
          "chardonnay",
          "witch-haze",
          "mint-green",
          "melrose"
        ]
      },
      "order": {
        "type": "integer",
        "description": "Fractional-ish sort key within a day; lower sorts higher."
      },
      "title": {
        "type": "string",
        "maxLength": 500,
        "description": "The task title. May contain inline Markdown (links and emphasis); clients that don't render Markdown can show it as plain text."
      },
      "recCount": {
        "type": "integer",
        "minimum": 1,
        "description": "Optional: end the series after this many occurrences, counted from the anchor (inclusive)."
      },
      "recUntil": {
        "type": "string",
        "description": "Optional last occurrence day (YYYY-MM-DD), inclusive. Set directly or kept in sync as the concrete stop date when recCount is used."
      },
      "subtasks": {
        "type": "array",
        "items": {
          "ref": "#subtask",
          "type": "ref"
        }
      },
      "completed": {
        "type": "boolean",
        "default": false
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "updatedAt": {
        "type": "string",
        "format": "datetime",
        "description": "Last local edit; used as the last-write-wins clock during sync."
      },
      "recByMonth": {
        "type": "integer",
        "maximum": 12,
        "minimum": 1,
        "description": "Yearly only: the month (1=January … 12=December). Omitted means the anchor's month."
      },
      "recMonthly": {
        "enum": [
          "day",
          "weekday"
        ],
        "type": "string",
        "description": "Monthly & yearly: land on the calendar date-of-month (\"day\") or the anchor's nth weekday (\"weekday\", e.g. the 2nd Friday). Omitted means \"day\"."
      },
      "completedAt": {
        "type": "string",
        "format": "datetime",
        "description": "When `completed` last flipped to true (non-recurring tasks only; recurring tasks track per-occurrence completion in completedDates)."
      },
      "description": {
        "type": "string",
        "maxLength": 3000,
        "description": "Optional longer notes. May contain block-level Markdown (headings, lists, links, code, etc.); clients that don't render Markdown can show it as plain text."
      },
      "isRecurring": {
        "type": "boolean",
        "default": false,
        "description": "Whether this task is a recurring template."
      },
      "recInterval": {
        "type": "integer",
        "minimum": 1,
        "description": "Recur every N frequency units (e.g. every 2 weeks)."
      },
      "recByWeekday": {
        "type": "array",
        "items": {
          "type": "integer",
          "maximum": 6,
          "minimum": 0
        },
        "description": "Weekly only: weekdays the series lands on (0=Sunday … 6=Saturday). Omitted means just the anchor day's weekday."
      },
      "recFrequency": {
        "enum": [
          "daily",
          "weekly",
          "monthly",
          "yearly"
        ],
        "type": "string",
        "description": "How often the task recurs."
      },
      "recByMonthDay": {
        "type": "integer",
        "maximum": 31,
        "minimum": 1,
        "description": "Monthly & yearly \"day\" mode: the date-of-month. Omitted means the anchor's date. Months without this day are skipped."
      }
    }
  },
  "description": "A single task in a chalky.town weekly planner. Stored in the author's repo. Field names mirror app.attodo.task where the concept is shared (title/description/completed/completedAt and the rec* recurrence fields); chalky-specific fields (day, order, color, subtasks, updatedAt) extend it. A recurring task is a template that projects occurrences onto later matching days; per-occurrence state (done/skipped) lives in separate town.chalky.occurrence records that reference this one."
}