mdboard 1.3.0 → 2.0.0

package/presets/scrum/docs.json

@@ -0,0 +1,43 @@
+{
+  "status": {
+    "output": "status.md",
+    "header": "Project Status: {{project.name}}",
+    "sections": [
+      {
+        "type": "summary",
+        "metrics": [
+          {
+            "label": "Sprints",
+            "compute": "count",
+            "entity": "sprint"
+          },
+          {
+            "label": "Tasks",
+            "compute": "count",
+            "entity": "task",
+            "detail": "done-ratio"
+          }
+        ]
+      },
+      {
+        "type": "entity-list",
+        "entity": "sprint",
+        "fields": [
+          "title",
+          "status",
+          "progress"
+        ]
+      },
+      {
+        "type": "entity-table",
+        "entity": "task",
+        "groupBy": "status",
+        "fields": [
+          "id",
+          "title",
+          "status"
+        ]
+      }
+    ]
+  }
+}

package/presets/scrum/entities.json

@@ -0,0 +1,268 @@
+{
+  "methodology": "scrum",
+  "entities": {
+    "sprint": {
+      "singular": "Sprint",
+      "plural": "Sprints",
+      "prefix": "SPR",
+      "file": "README.md",
+      "fields": {
+        "status": {
+          "type": "enum",
+          "values": [
+            {
+              "key": "planned",
+              "label": "Planned",
+              "color": "#8B8B93",
+              "icon": "dashed-circle"
+            },
+            {
+              "key": "active",
+              "label": "Active",
+              "color": "#5B6EF5",
+              "icon": "half-circle"
+            },
+            {
+              "key": "completed",
+              "label": "Completed",
+              "color": "#2EA043",
+              "icon": "check-circle"
+            }
+          ],
+          "default": "planned"
+        },
+        "goal": {
+          "type": "string",
+          "label": "Goal"
+        },
+        "start_date": {
+          "type": "date",
+          "label": "Start"
+        },
+        "end_date": {
+          "type": "date",
+          "label": "End"
+        }
+      }
+    },
+    "story": {
+      "singular": "Story",
+      "plural": "Stories",
+      "prefix": "US",
+      "file": "README.md",
+      "fields": {
+        "status": {
+          "type": "enum",
+          "values": [
+            {
+              "key": "backlog",
+              "label": "Backlog",
+              "color": "#8B8B93",
+              "icon": "circle"
+            },
+            {
+              "key": "ready",
+              "label": "Ready",
+              "color": "#06B6D4",
+              "icon": "dashed-circle"
+            },
+            {
+              "key": "in-progress",
+              "label": "In Progress",
+              "color": "#D4A72C",
+              "icon": "half-circle"
+            },
+            {
+              "key": "review",
+              "label": "Review",
+              "color": "#8B5CF6",
+              "icon": "three-quarter-circle"
+            },
+            {
+              "key": "done",
+              "label": "Done",
+              "color": "#2EA043",
+              "icon": "check-circle"
+            }
+          ],
+          "default": "backlog"
+        },
+        "points": {
+          "type": "number",
+          "label": "Points"
+        },
+        "assigned": {
+          "type": "list",
+          "label": "Assigned"
+        }
+      }
+    },
+    "task": {
+      "singular": "Task",
+      "plural": "Tasks",
+      "prefix": "TASK",
+      "file": "PREFIX-NNN.md",
+      "fields": {
+        "status": {
+          "type": "enum",
+          "values": [
+            {
+              "key": "todo",
+              "label": "Todo",
+              "color": "#8B8B93",
+              "icon": "circle"
+            },
+            {
+              "key": "in-progress",
+              "label": "In Progress",
+              "color": "#D4A72C",
+              "icon": "half-circle"
+            },
+            {
+              "key": "done",
+              "label": "Done",
+              "color": "#2EA043",
+              "icon": "check-circle"
+            }
+          ],
+          "default": "todo"
+        },
+        "assigned": {
+          "type": "list",
+          "label": "Assigned"
+        },
+        "points": {
+          "type": "number",
+          "label": "Points"
+        }
+      }
+    },
+    "epic": {
+      "singular": "Epic",
+      "plural": "Epics",
+      "prefix": "EPIC",
+      "file": "README.md",
+      "fields": {
+        "status": {
+          "type": "enum",
+          "values": [
+            {
+              "key": "open",
+              "label": "Open",
+              "color": "#5B6EF5",
+              "icon": "circle"
+            },
+            {
+              "key": "closed",
+              "label": "Closed",
+              "color": "#2EA043",
+              "icon": "check-circle"
+            }
+          ],
+          "default": "open"
+        }
+      }
+    },
+    "bug": {
+      "singular": "Bug",
+      "plural": "Bugs",
+      "prefix": "BUG",
+      "file": "PREFIX-NNN.md",
+      "fields": {
+        "status": {
+          "type": "enum",
+          "values": [
+            {
+              "key": "open",
+              "label": "Open",
+              "color": "#DA3633",
+              "icon": "circle"
+            },
+            {
+              "key": "in-progress",
+              "label": "In Progress",
+              "color": "#D4A72C",
+              "icon": "half-circle"
+            },
+            {
+              "key": "fixed",
+              "label": "Fixed",
+              "color": "#2EA043",
+              "icon": "check-circle"
+            }
+          ],
+          "default": "open"
+        },
+        "severity": {
+          "type": "enum",
+          "values": [
+            {
+              "key": "critical",
+              "label": "Critical",
+              "color": "#DA3633"
+            },
+            {
+              "key": "major",
+              "label": "Major",
+              "color": "#F97316"
+            },
+            {
+              "key": "minor",
+              "label": "Minor",
+              "color": "#D4A72C"
+            }
+          ],
+          "default": "major"
+        },
+        "assigned": {
+          "type": "list",
+          "label": "Assigned"
+        }
+      }
+    },
+    "note": {
+      "singular": "Note",
+      "plural": "Notes",
+      "prefix": "NOTE",
+      "file": "PREFIX-NNN.md",
+      "fields": {
+        "updated": {
+          "type": "date",
+          "label": "Updated"
+        }
+      }
+    }
+  },
+  "priorities": [
+    {
+      "key": "urgent",
+      "label": "Urgent",
+      "color": "#F97316",
+      "bars": 4
+    },
+    {
+      "key": "high",
+      "label": "High",
+      "color": "#F97316",
+      "bars": 3
+    },
+    {
+      "key": "medium",
+      "label": "Medium",
+      "color": "#D4A72C",
+      "bars": 2
+    },
+    {
+      "key": "low",
+      "label": "Low",
+      "color": "#5B6EF5",
+      "bars": 1
+    }
+  ],
+  "completedStatuses": [
+    "done",
+    "completed",
+    "fixed",
+    "closed"
+  ]
+}

package/presets/scrum/structure.json

@@ -0,0 +1,32 @@
+{
+  "root": "project",
+  "hierarchy": {
+    "sprint": {
+      "dir": "sprints",
+      "children": {
+        "story": {
+          "dir": "stories",
+          "children": {
+            "task": {
+              "dir": "tasks"
+            }
+          }
+        }
+      }
+    }
+  },
+  "standalone": {
+    "epic": {
+      "dir": "epics"
+    },
+    "bug": {
+      "dir": "bugs"
+    },
+    "note": {
+      "dir": "notes"
+    }
+  },
+  "archive": {
+    "dir": "archive"
+  }
+}

package/presets/scrum/ui.json

@@ -0,0 +1,201 @@
+{
+  "tabs": [
+    {
+      "id": "tasks",
+      "label": "Tasks",
+      "description": "Tasks — leaf work items",
+      "icon": "check-square",
+      "entity": "task",
+      "layouts": [
+        "board",
+        "table",
+        "list"
+      ],
+      "defaultLayout": "board",
+      "board": {
+        "groupBy": "status",
+        "cardFields": [
+          "id",
+          "title",
+          "status"
+        ],
+        "dragAction": "update-status"
+      },
+      "table": {
+        "columns": [
+          "id",
+          "title",
+          "story",
+          "sprint",
+          "status",
+          "points",
+          "assigned"
+        ],
+        "sortable": true
+      },
+      "filters": "auto"
+    },
+    {
+      "id": "stories",
+      "label": "Stories",
+      "description": "Stories",
+      "icon": "layers",
+      "entity": "story",
+      "layouts": [
+        "cards",
+        "list"
+      ],
+      "defaultLayout": "cards",
+      "cards": {
+        "fields": [
+          "title",
+          "status"
+        ],
+        "showProgress": true,
+        "expandChildren": {
+          "entity": "task",
+          "fields": [
+            "title",
+            "status"
+          ]
+        }
+      },
+      "list": {
+        "fields": [
+          "title",
+          "status",
+          "progress"
+        ],
+        "expandable": true
+      },
+      "filters": "auto"
+    },
+    {
+      "id": "sprints",
+      "label": "Sprints",
+      "description": "Sprints",
+      "icon": "refresh-cw",
+      "entity": "sprint",
+      "layouts": [
+        "list"
+      ],
+      "defaultLayout": "list",
+      "list": {
+        "fields": [
+          "title",
+          "status",
+          "start_date",
+          "end_date",
+          "progress"
+        ],
+        "expandChildren": {
+          "entity": "story",
+          "fields": [
+            "title",
+            "status"
+          ]
+        }
+      },
+      "filters": [
+        "status"
+      ]
+    },
+    {
+      "id": "epics",
+      "label": "Epics",
+      "description": "Epics",
+      "icon": "alert-circle",
+      "entity": "epic",
+      "layouts": [
+        "cards"
+      ],
+      "defaultLayout": "cards",
+      "cards": {
+        "fields": [
+          "title",
+          "status"
+        ],
+        "showContent": true
+      },
+      "filters": [
+        "status"
+      ]
+    },
+    {
+      "id": "bugs",
+      "label": "Bugs",
+      "description": "Bugs",
+      "icon": "alert-circle",
+      "entity": "bug",
+      "layouts": [
+        "cards"
+      ],
+      "defaultLayout": "cards",
+      "cards": {
+        "fields": [
+          "title",
+          "status"
+        ],
+        "showContent": true
+      },
+      "filters": [
+        "status"
+      ]
+    },
+    {
+      "id": "notes",
+      "label": "Notes",
+      "description": "Notes",
+      "icon": "file-text",
+      "entity": "note",
+      "layouts": [
+        "editor"
+      ],
+      "defaultLayout": "editor"
+    },
+    {
+      "id": "metrics",
+      "label": "Metrics",
+      "description": "Project progress and health overview",
+      "icon": "bar-chart",
+      "layouts": [
+        "metrics"
+      ],
+      "defaultLayout": "metrics",
+      "metrics": {
+        "cards": [
+          {
+            "title": "Sprint Progress",
+            "type": "progress-by-parent",
+            "parent": "sprint"
+          },
+          {
+            "title": "Status Breakdown",
+            "type": "status-breakdown",
+            "entity": "task"
+          },
+          {
+            "title": "Project Health",
+            "type": "health"
+          }
+        ]
+      }
+    }
+  ],
+  "panel": {
+    "enabled": true,
+    "position": "right",
+    "editableFields": "auto",
+    "sections": [
+      "properties",
+      "ai",
+      "content"
+    ]
+  },
+  "sourceRail": {
+    "enabled": true,
+    "position": "left",
+    "showHome": true,
+    "showHistory": true
+  }
+}

package/presets/shape-up/api.json

@@ -0,0 +1,40 @@
+{
+  "endpoints": {
+    "crud": {
+      "entities": ["cycle", "bet", "scope", "task", "pitch", "note"],
+      "operations": ["list", "get", "create", "update", "delete"],
+      "pattern": "/api/:entity",
+      "sourceScoped": true,
+      "sourcePattern": "/api/sources/:source/:entity"
+    },
+    "queries": {
+      "active": {
+        "pattern": "/api/:entity/active",
+        "filter": { "status": ["active", "building"] },
+        "entities": ["cycle", "bet"]
+      },
+      "metrics": {
+        "pattern": "/api/metrics",
+        "computes": ["status-breakdown", "priority-distribution", "progress-by-parent", "hill-chart"]
+      },
+      "health": {
+        "pattern": "/api/health",
+        "computes": ["total", "completed", "in-progress", "velocity"]
+      }
+    },
+    "system": {
+      "config":  { "method": "GET",  "path": "/api/config" },
+      "project": { "method": "GET",  "path": "/api/project" },
+      "sources": { "method": "GET",  "path": "/api/sources" },
+      "sync":    { "method": "POST", "path": "/api/sources/sync" },
+      "history": { "method": "GET",  "path": "/api/history" },
+      "switch":  { "method": "POST", "path": "/api/history/switch" },
+      "theme":   { "method": "POST", "path": "/api/theme" },
+      "events":  { "method": "GET",  "path": "/api/events", "type": "sse" }
+    }
+  },
+  "filtering": {
+    "strategy": "query-params",
+    "autoFilters": true
+  }
+}

package/presets/shape-up/cli.json

@@ -0,0 +1,44 @@
+{
+  "commands": {
+    "create": {
+      "entities": ["cycle", "bet", "scope", "task", "pitch", "note"],
+      "args": {
+        "positional": "title",
+        "flags": "auto"
+      }
+    },
+    "update": {
+      "entities": ["cycle", "bet", "scope", "task", "pitch", "note"],
+      "args": {
+        "positional": "id",
+        "flags": "auto"
+      }
+    },
+    "delete": {
+      "entities": ["cycle", "bet", "scope", "task", "pitch", "note"],
+      "action": "archive"
+    },
+    "status": {
+      "output": "status.md",
+      "sections": [
+        { "type": "summary", "metrics": ["total-tasks", "completed", "progress", "points"] },
+        { "type": "entity-list", "entity": "cycle", "nest": "bet" },
+        { "type": "entity-table", "entity": "task", "groupBy": "status" }
+      ]
+    },
+    "sync": {
+      "checks": ["dangling-refs", "duplicate-ids", "missing-parents", "orphaned-tasks"],
+      "fix": true
+    },
+    "init": {
+      "presets": ["shape-up", "scrum", "kanban"],
+      "default": "shape-up"
+    },
+    "theme": {
+      "scope": ["global", "project"]
+    },
+    "cache": {
+      "subcommands": ["list", "clean"]
+    }
+  }
+}

package/presets/shape-up/docs.json

@@ -0,0 +1,32 @@
+{
+  "status": {
+    "output": "status.md",
+    "header": "Project Status: {{project.name}}",
+    "sections": [
+      {
+        "type": "summary",
+        "metrics": [
+          { "label": "Cycles",  "compute": "count",    "entity": "cycle" },
+          { "label": "Tasks",   "compute": "count",    "entity": "task", "detail": "done-ratio" },
+          { "label": "Points",  "compute": "sum",      "entity": "task", "field": "points", "detail": "done-ratio" },
+          { "label": "Active",  "compute": "active",   "entity": "cycle" }
+        ]
+      },
+      {
+        "type": "entity-list",
+        "entity": "cycle",
+        "fields": ["title", "status", "progress"],
+        "nest": {
+          "entity": "bet",
+          "fields": ["title", "status", "appetite"]
+        }
+      },
+      {
+        "type": "entity-table",
+        "entity": "task",
+        "groupBy": "status",
+        "fields": ["id", "title", "bet", "scope", "status", "points"]
+      }
+    ]
+  }
+}