town.chalky.task

{
  "id": "town.chalky.task",
  "defs": {
    "main": {
      "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."
    },
    "subtask": {
      "type": "object",
      "required": [
        "id",
        "text",
        "done"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "done": {
          "type": "boolean",
          "default": false
        },
        "text": {
          "type": "string",
          "maxLength": 500
        },
        "completedAt": {
          "type": "string",
          "format": "datetime",
          "description": "When `done` last flipped to true. Used to order completed subtasks by completion time."
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}