mktask 0.1.0__py3-none-any.whl

mktask/__init__.py

@@ -0,0 +1,8 @@
+"""mktask — work task prioritizer built on mkio and mkui."""
+
+__version__ = "0.1.0"
+
+
+def serve(config="mktask.toml", host=None, port=None, db_path=None):
+    from mktask.__main__ import serve as _serve
+    _serve(config, host=host, port=port, db_path=db_path)

mktask/__main__.py

@@ -0,0 +1,153 @@
+"""mktask CLI and server entry point."""
+
+from __future__ import annotations
+
+import argparse
+import socket
+import sys
+from pathlib import Path
+from typing import Any
+
+from mkio import create_app
+from mkio.config import load_config
+
+from mktask import __version__
+
+
+def serve(
+    config: str | Path | dict[str, Any] = "mktask.toml",
+    host: str | None = None,
+    port: int | None = None,
+    db_path: str | None = None,
+) -> None:
+    """Start the mktask server. Blocks until shutdown."""
+    cfg = _load_config(config)
+    if host is not None:
+        cfg["host"] = host
+    if port is not None:
+        cfg["port"] = port
+    if db_path is not None:
+        cfg["db_path"] = db_path
+
+    # Probe the port before anything else starts: a bind failure inside
+    # app.start() happens after the startup hooks have opened the database,
+    # whose aiosqlite threads then keep the process alive after the traceback.
+    _check_port(cfg["host"], cfg["port"])
+
+    app = create_app(cfg)
+
+    async def announce() -> None:
+        print(_banner(cfg, config), flush=True)
+
+    app.on_startup(announce)
+    app.run()
+
+
+def _check_port(host: str, port: int) -> None:
+    """Fail fast, before anything else starts, if the web port can't be bound."""
+    family = socket.AF_INET6 if ":" in host else socket.AF_INET
+    try:
+        with socket.socket(family, socket.SOCK_STREAM) as probe:
+            probe.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            probe.bind((host, port))
+    except OSError as exc:
+        print(f"Error: cannot listen on {host}:{port}: {exc.strerror or exc}", file=sys.stderr)
+        raise SystemExit(1) from None
+
+
+def _banner(cfg: dict[str, Any], config: str | Path | dict[str, Any]) -> str:
+    """Startup summary: where the UI is and what it is running on."""
+    host = cfg.get("host", "127.0.0.1")
+    port = cfg.get("port", 8080)
+    url_host = "localhost" if host in ("", "0.0.0.0", "::") else host
+    if ":" in url_host:
+        url_host = f"[{url_host}]"
+    listen = f"{host}:{port}"
+    if host in ("", "0.0.0.0", "::"):
+        listen += " (all interfaces)"
+
+    db_path = cfg.get("db_path", "mkio.db")
+    database = "in-memory (nothing persists)" if db_path == ":memory:" else str(Path(db_path).resolve())
+    config_desc = "<dict>" if isinstance(config, dict) else str(Path(config).resolve())
+
+    return "\n".join([
+        f"mktask {__version__}",
+        f"  Web UI:    http://{url_host}:{port}/",
+        f"  Listening: {listen}",
+        f"  Config:    {config_desc}",
+        f"  Database:  {database}",
+        "  Press Ctrl+C to stop.",
+    ])
+
+
+def _load_config(config: str | Path | dict[str, Any]) -> dict[str, Any]:
+    """Load config, resolving the mkui static path and relative directories."""
+    config_dir = Path(config).parent.resolve() if isinstance(config, (str, Path)) else Path.cwd()
+    cfg = load_config(config)
+    cfg["version"] = __version__
+
+    statics = cfg.get("static", {})
+    for route, directory in list(statics.items()):
+        if directory == "__mkui__":
+            import mkui
+            statics[route] = str(mkui.static_dir)
+        else:
+            statics[route] = str((config_dir / directory).resolve())
+
+    return cfg
+
+
+def _find_config() -> str:
+    """Look for mktask.toml in the current directory, then the package."""
+    cwd = Path.cwd() / "mktask.toml"
+    if cwd.exists():
+        return str(cwd)
+
+    pkg = Path(__file__).parent / "mktask.toml"
+    if pkg.exists():
+        return str(pkg)
+
+    print("Error: mktask.toml not found. Provide a config path as argument.", file=sys.stderr)
+    sys.exit(1)
+
+
+def main() -> None:
+    """CLI entry point."""
+    parser = argparse.ArgumentParser(
+        prog="mktask",
+        description="Work task prioritizer built on mkio and mkui",
+    )
+    parser.add_argument(
+        "config", nargs="?", default=None,
+        help="path to mktask.toml config file (default: ./mktask.toml, else the built-in one)",
+    )
+    parser.add_argument(
+        "-p", "--port", type=int, default=None,
+        help="override listening port",
+    )
+    parser.add_argument(
+        "--host", default=None,
+        help="override listening host",
+    )
+    parser.add_argument(
+        "-d", "--db", default=None, metavar="PATH",
+        help="database filename (.db added if no extension; use ':memory:' for in-memory)",
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"mktask {__version__}",
+    )
+    args = parser.parse_args()
+
+    db_path = args.db
+    if db_path is not None and db_path != ":memory:" and not Path(db_path).suffix:
+        db_path += ".db"
+
+    config_path = args.config or _find_config()
+    if not Path(config_path).is_file():
+        print(f"Error: config file not found: {config_path}", file=sys.stderr)
+        sys.exit(1)
+    serve(config_path, host=args.host, port=args.port, db_path=db_path)
+
+
+if __name__ == "__main__":
+    main()

mktask/mktask.toml

@@ -0,0 +1,75 @@
+name = "mktask"
+# version is injected from mktask.__version__ at load time; do not add one here
+port = 8080
+host = "127.0.0.1"
+db_path = "mktask.db"
+auto_migrate = true
+
+# ─── Tables ─────────────────────────────────────────────────────────
+
+# One row per task. importance/urgency are 1..5; the UI derives a score
+# from them (placeholder for the real prioritization model). Timestamps are
+# UTC "YYYY-MM-DD HH:MM:SS" to match SQLite's CURRENT_TIMESTAMP.
+[tables.tasks]
+columns = { id = "INTEGER PRIMARY KEY AUTOINCREMENT", title = "TEXT NOT NULL", notes = "TEXT NOT NULL DEFAULT ''", status = "TEXT NOT NULL DEFAULT 'open'", importance = "INTEGER NOT NULL DEFAULT 3", urgency = "INTEGER NOT NULL DEFAULT 3", due = "TEXT NOT NULL DEFAULT ''", created_at = "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP", updated_at = "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP", done_at = "TEXT NOT NULL DEFAULT ''" }
+
+# Saved window layouts for mkui's Layout menu: one row per save, the newest
+# being the user's current layout and the older ones its restorable history
+# (the client prunes through `delete`). mktask has no login, so every save
+# lands under owner '' — the default history shared by everyone on this server.
+[tables.mkui_layouts]
+columns = { id = "INTEGER PRIMARY KEY AUTOINCREMENT", app = "TEXT NOT NULL DEFAULT ''", owner = "TEXT NOT NULL DEFAULT ''", saved = "TEXT DEFAULT CURRENT_TIMESTAMP", layout = "TEXT NOT NULL" }
+
+# ─── Services ───────────────────────────────────────────────────────
+
+[services.tasks]
+protocol = "transaction"
+description = "Add, edit, complete, reopen, and delete tasks"
+
+[services.tasks.ops]
+add = [
+    { table = "tasks", op_type = "insert", fields = ["title", "notes", "importance", "urgency", "due"], defaults = { notes = "", importance = 3, urgency = 3, due = "" } },
+]
+edit = [
+    { table = "tasks", op_type = "update", key = ["id"], fields = ["title", "notes", "importance", "urgency", "due", "updated_at"] },
+]
+done = [
+    { table = "tasks", op_type = "update", key = ["id"], fields = ["done_at", "updated_at"], defaults = { status = "done" } },
+]
+reopen = [
+    { table = "tasks", op_type = "update", key = ["id"], fields = ["updated_at"], defaults = { status = "open", done_at = "" } },
+]
+delete = [
+    { table = "tasks", op_type = "delete", key = ["id"] },
+]
+
+[services.all_tasks]
+protocol = "query"
+description = "Every task, live"
+primary_table = "tasks"
+filterable = ["status"]
+
+[services.mkui_layouts]
+protocol = "transaction"
+description = "Save and delete window layouts"
+
+[services.mkui_layouts.ops]
+save = { table = "mkui_layouts", op_type = "insert", fields = ["app", "owner", "layout"] }
+delete = { table = "mkui_layouts", op_type = "delete", key = ["id"] }
+
+[services.mkui_layouts_list]
+protocol = "reqrep"
+description = "Saved layouts of one app and owner, newest first"
+sql = "SELECT id, saved FROM mkui_layouts WHERE app = :app AND owner = :owner ORDER BY id DESC"
+
+[services.mkui_layouts_get]
+protocol = "reqrep"
+description = "One saved layout"
+sql = "SELECT id, saved, layout FROM mkui_layouts WHERE id = :id"
+
+# ─── Static files ───────────────────────────────────────────────────
+# "__mkui__" resolves to the installed mkui package's static directory.
+
+[static]
+"/" = "./static"
+"/mkui" = "__mkui__"

mktask/static/app.json

@@ -0,0 +1,578 @@
+{
+  "app": {
+    "title": "mktask",
+    "theme": "dark"
+  },
+  "state": {
+    "status": {
+      "message": "Connecting...",
+      "background": "#858585",
+      "color": "#000"
+    },
+    "selected_task": null
+  },
+  "menubar": [
+    {
+      "label": "Edit",
+      "items": [
+        {
+          "label": "Copy",
+          "action": "edit.copy",
+          "shortcut": "mod+C"
+        },
+        {
+          "label": "Select All",
+          "action": "edit.selectAll",
+          "shortcut": "mod+A"
+        }
+      ]
+    },
+    {
+      "label": "Tasks",
+      "items": [
+        {
+          "label": "Tasks",
+          "action": "pane.show",
+          "args": "tasks"
+        },
+        {
+          "label": "Detail",
+          "action": "pane.show",
+          "args": "task-detail"
+        },
+        {
+          "sep": true
+        },
+        {
+          "label": "Show Open Only",
+          "action": "table.filter",
+          "args": {
+            "pane": "tasks",
+            "filters": {
+              "status": [
+                "open"
+              ]
+            },
+            "merge": true
+          }
+        },
+        {
+          "label": "Show All",
+          "action": "table.filter",
+          "args": {
+            "pane": "tasks",
+            "filters": {
+              "status": null
+            },
+            "merge": true
+          }
+        }
+      ]
+    },
+    {
+      "label": "Layout",
+      "items": [
+        {
+          "label": "Save Layout",
+          "action": "layout.save"
+        },
+        {
+          "label": "Restore Layout",
+          "layouts": true
+        },
+        {
+          "sep": true
+        },
+        {
+          "label": "Reset to Default",
+          "action": "layout.reset"
+        }
+      ]
+    },
+    {
+      "label": "Window",
+      "items": [
+        {
+          "label": "Cascade",
+          "action": "window.cascade"
+        },
+        {
+          "label": "Tile",
+          "items": [
+            {
+              "label": "Horizontal",
+              "action": "window.tileH"
+            },
+            {
+              "label": "Vertical",
+              "action": "window.tileV"
+            },
+            {
+              "label": "Grid",
+              "action": "window.grid"
+            }
+          ]
+        },
+        {
+          "sep": true
+        },
+        {
+          "windows": true
+        }
+      ]
+    }
+  ],
+  "statusbar": {
+    "left": [
+      {
+        "type": "text",
+        "bind": "status.message"
+      }
+    ],
+    "right": [
+      {
+        "type": "text",
+        "text": "mktask"
+      }
+    ],
+    "bindStyle": {
+      "color": "status.color",
+      "background": "status.background"
+    }
+  },
+  "layouts": {
+    "key": "mktask",
+    "keep": 10,
+    "keepDays": 7
+  },
+  "panes": {
+    "tasks": {
+      "title": "Tasks",
+      "type": "mkio-table",
+      "service": "all_tasks",
+      "protocol": "query",
+      "columns": [
+        "id",
+        "title",
+        "score",
+        "importance",
+        "urgency",
+        "due",
+        "status",
+        "created_at"
+      ],
+      "labels": {
+        "id": "ID",
+        "title": "Title",
+        "score": "Score",
+        "importance": "Imp",
+        "urgency": "Urg",
+        "due": "Due",
+        "status": "Status",
+        "created_at": "Created"
+      },
+      "values": {
+        "score": "importance * urgency"
+      },
+      "types": {
+        "due": "time",
+        "created_at": {
+          "type": "time",
+          "parse": "%Y-%m-%d %H:%M:%S"
+        }
+      },
+      "sort": "-score",
+      "filters": {
+        "status": [
+          "open"
+        ]
+      },
+      "styles": {
+        "score": [
+          {
+            "when": "value >= 16",
+            "color": "#f44747",
+            "bold": true
+          },
+          {
+            "when": "value >= 9",
+            "color": "#dcdcaa"
+          },
+          {
+            "color": "#858585"
+          }
+        ],
+        "status": [
+          {
+            "when": "value == 'done'",
+            "color": "#4ec9b0"
+          }
+        ]
+      },
+      "rowStyle": [
+        {
+          "when": "status == 'done'",
+          "color": "#858585",
+          "strike": true
+        }
+      ],
+      "select": {
+        "state": "selected_task"
+      },
+      "buttons": [
+        {
+          "label": "+ Add",
+          "enable": {
+            "connected": true
+          },
+          "action": {
+            "type": "dialog",
+            "dialog": {
+              "title": "Add Task",
+              "modal": true,
+              "width": 440,
+              "fields": [
+                {
+                  "name": "title",
+                  "label": "Title",
+                  "type": "text",
+                  "required": true,
+                  "placeholder": "What needs doing?"
+                },
+                {
+                  "row": [
+                    {
+                      "name": "importance",
+                      "label": "Importance",
+                      "type": "select",
+                      "width": 0.5,
+                      "value": 3,
+                      "options": [
+                        {
+                          "value": 1,
+                          "label": "1 - Lowest"
+                        },
+                        {
+                          "value": 2,
+                          "label": "2 - Low"
+                        },
+                        {
+                          "value": 3,
+                          "label": "3 - Medium"
+                        },
+                        {
+                          "value": 4,
+                          "label": "4 - High"
+                        },
+                        {
+                          "value": 5,
+                          "label": "5 - Highest"
+                        }
+                      ]
+                    },
+                    {
+                      "name": "urgency",
+                      "label": "Urgency",
+                      "type": "select",
+                      "width": 0.5,
+                      "value": 3,
+                      "options": [
+                        {
+                          "value": 1,
+                          "label": "1 - Lowest"
+                        },
+                        {
+                          "value": 2,
+                          "label": "2 - Low"
+                        },
+                        {
+                          "value": 3,
+                          "label": "3 - Medium"
+                        },
+                        {
+                          "value": 4,
+                          "label": "4 - High"
+                        },
+                        {
+                          "value": 5,
+                          "label": "5 - Highest"
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "name": "due",
+                  "label": "Due (YYYY-MM-DD, optional)",
+                  "type": "text",
+                  "placeholder": "2026-12-31",
+                  "value": ""
+                },
+                {
+                  "name": "notes",
+                  "label": "Notes",
+                  "type": "textarea",
+                  "value": ""
+                }
+              ],
+              "submit": {
+                "label": "Add",
+                "service": "tasks",
+                "op": "add"
+              }
+            }
+          }
+        },
+        {
+          "label": "Edit",
+          "unit": "row",
+          "enable": {
+            "connected": true
+          },
+          "action": {
+            "type": "dialog",
+            "dialog": {
+              "title": "Edit Task #${row.id}",
+              "modal": true,
+              "width": 440,
+              "fields": [
+                {
+                  "name": "id",
+                  "type": "hidden",
+                  "value": "${row.id}"
+                },
+                {
+                  "name": "updated_at",
+                  "type": "hidden",
+                  "value": "${TIME(NOW(), '%Y-%m-%d %H:%M:%S')}"
+                },
+                {
+                  "name": "title",
+                  "label": "Title",
+                  "type": "text",
+                  "required": true,
+                  "placeholder": "What needs doing?",
+                  "value": "${row.title}"
+                },
+                {
+                  "row": [
+                    {
+                      "name": "importance",
+                      "label": "Importance",
+                      "type": "select",
+                      "width": 0.5,
+                      "value": "${row.importance}",
+                      "options": [
+                        {
+                          "value": 1,
+                          "label": "1 - Lowest"
+                        },
+                        {
+                          "value": 2,
+                          "label": "2 - Low"
+                        },
+                        {
+                          "value": 3,
+                          "label": "3 - Medium"
+                        },
+                        {
+                          "value": 4,
+                          "label": "4 - High"
+                        },
+                        {
+                          "value": 5,
+                          "label": "5 - Highest"
+                        }
+                      ]
+                    },
+                    {
+                      "name": "urgency",
+                      "label": "Urgency",
+                      "type": "select",
+                      "width": 0.5,
+                      "value": "${row.urgency}",
+                      "options": [
+                        {
+                          "value": 1,
+                          "label": "1 - Lowest"
+                        },
+                        {
+                          "value": 2,
+                          "label": "2 - Low"
+                        },
+                        {
+                          "value": 3,
+                          "label": "3 - Medium"
+                        },
+                        {
+                          "value": 4,
+                          "label": "4 - High"
+                        },
+                        {
+                          "value": 5,
+                          "label": "5 - Highest"
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "name": "due",
+                  "label": "Due (YYYY-MM-DD, optional)",
+                  "type": "text",
+                  "placeholder": "2026-12-31",
+                  "value": "${row.due}"
+                },
+                {
+                  "name": "notes",
+                  "label": "Notes",
+                  "type": "textarea",
+                  "value": "${row.notes}"
+                }
+              ],
+              "submit": {
+                "label": "Save",
+                "service": "tasks",
+                "op": "edit"
+              }
+            }
+          }
+        },
+        {
+          "label": "Done",
+          "enable": {
+            "connected": true,
+            "minSelected": 1,
+            "when": "ALL(rows, r -> r.status == 'open')"
+          },
+          "action": {
+            "type": "transaction",
+            "service": "tasks",
+            "op": "done",
+            "data": {
+              "id": "${row.id}",
+              "done_at": "${TIME(NOW(), '%Y-%m-%d %H:%M:%S')}",
+              "updated_at": "${TIME(NOW(), '%Y-%m-%d %H:%M:%S')}"
+            }
+          }
+        },
+        {
+          "label": "Reopen",
+          "enable": {
+            "connected": true,
+            "minSelected": 1,
+            "when": "ALL(rows, r -> r.status == 'done')"
+          },
+          "action": {
+            "type": "transaction",
+            "service": "tasks",
+            "op": "reopen",
+            "data": {
+              "id": "${row.id}",
+              "updated_at": "${TIME(NOW(), '%Y-%m-%d %H:%M:%S')}"
+            }
+          }
+        },
+        {
+          "label": "Delete",
+          "unit": "row",
+          "enable": {
+            "connected": true
+          },
+          "action": {
+            "type": "dialog",
+            "dialog": {
+              "title": "Delete Task #${row.id}",
+              "modal": true,
+              "width": 380,
+              "fields": [
+                {
+                  "name": "id",
+                  "type": "hidden",
+                  "value": "${row.id}"
+                },
+                {
+                  "label": "Delete this task?",
+                  "type": "readonly",
+                  "value": "${row.title}"
+                }
+              ],
+              "submit": {
+                "label": "Delete",
+                "service": "tasks",
+                "op": "delete"
+              }
+            }
+          }
+        }
+      ]
+    },
+    "task-detail": {
+      "title": "Detail",
+      "widgets": [
+        {
+          "type": "text",
+          "text": "${IF(state.selected_task == NULL, 'Select a task to see its notes.', FORMAT('#{}  {}', state.selected_task.id, state.selected_task.title))}",
+          "class": "task-detail-title"
+        },
+        {
+          "type": "text",
+          "text": "${IF(state.selected_task == NULL, '', state.selected_task.notes)}",
+          "class": "task-detail-notes"
+        }
+      ]
+    }
+  },
+  "frames": [
+    {
+      "id": "main",
+      "x": 0.02,
+      "y": 0.03,
+      "w": 0.64,
+      "h": 0.94,
+      "layout": {
+        "type": "tabs",
+        "active": 0,
+        "children": [
+          "tasks"
+        ]
+      }
+    },
+    {
+      "id": "side",
+      "x": 0.68,
+      "y": 0.03,
+      "w": 0.3,
+      "h": 0.94,
+      "layout": {
+        "type": "tabs",
+        "active": 0,
+        "children": [
+          "task-detail"
+        ]
+      }
+    }
+  ],
+  "mkio": {
+    "url": "auto",
+    "expect": {
+      "name": "mktask",
+      "expr": "1"
+    },
+    "connected": {
+      "status.message": "Connected",
+      "status.color": null,
+      "status.background": null
+    },
+    "disconnected": {
+      "status.message": "Disconnected",
+      "status.color": "#000",
+      "status.background": "#858585"
+    },
+    "incompatible": {
+      "status.message": "Server mismatch",
+      "status.color": "#fff",
+      "status.background": "#cc0000"
+    }
+  }
+}

mktask/static/index.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>mktask</title>
+  <link rel="stylesheet" href="/mkui/styles/mkui.css">
+  <link rel="stylesheet" href="/static/mktask.css">
+  <script type="module">
+    import "/mkui/src/index.js";
+
+    // Revalidate rather than trust heuristic freshness: mkio serves static
+    // files without Cache-Control, so a stale app.json silently pins the UI
+    // to an old layout.
+    const res = await fetch("/static/app.json", { cache: "no-cache" });
+    const config = await res.json();
+    const wsProto = location.protocol === "https:" ? "wss:" : "ws:";
+    config.mkio.url = `${wsProto}//${location.host}/ws`;
+    document.querySelector("mkui-app").setConfig(config);
+  </script>
+</head>
+<body>
+  <mkui-app></mkui-app>
+</body>
+</html>

mktask/static/mktask.css

@@ -0,0 +1,13 @@
+/* mktask — app-specific overrides on top of mkui's theme. */
+
+/* Detail pane: text widgets render as inline spans; stack them. */
+.task-detail-title,
+.task-detail-notes {
+  display: block;
+  padding: 0.5em 0.75em 0;
+  white-space: pre-wrap;
+}
+
+.task-detail-title {
+  font-weight: bold;
+}

mktask-0.1.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.5
+Name: mktask
+Version: 0.1.0
+Summary: Work task prioritizer built on mkio and mkui
+Project-URL: Homepage, https://github.com/markuskimius/mktask
+Project-URL: Repository, https://github.com/markuskimius/mktask
+Project-URL: Issues, https://github.com/markuskimius/mktask/issues
+Author: Mark Kim
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: mkio,mkui,prioritization,tasks,todo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Scheduling
+Requires-Python: >=3.11
+Requires-Dist: mkio>=0.2.0
+Requires-Dist: mkui>=0.2.9
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-aiohttp; extra == 'test'
+Requires-Dist: pytest-asyncio; extra == 'test'
+Description-Content-Type: text/markdown
+
+# mktask
+
+[![PyPI](https://img.shields.io/pypi/v/mktask)](https://pypi.org/project/mktask/)
+[![Python](https://img.shields.io/pypi/pyversions/mktask)](https://pypi.org/project/mktask/)
+[![License](https://img.shields.io/pypi/l/mktask)](https://github.com/markuskimius/mktask/blob/main/LICENSE)
+
+A work task prioritizer built on [mkio](https://github.com/markuskimius/mkio)
+(config-driven microservice backend) and
+[mkui](https://github.com/markuskimius/mkui) (config-driven Web Components
+workspace with dockable panes).
+
+Tasks live in a local SQLite database and show up in a live-updating blotter
+you can sort, filter, and arrange however you like. Each task carries an
+importance and an urgency (1–5); the blotter derives a score from them so the
+most pressing work floats to the top.
+
+## Quick start
+
+```bash
+pip install mktask
+mktask                    # http://127.0.0.1:8080/
+```
+
+Everything installs via `pip`; nothing is fetched at runtime.
+
+## CLI
+
+```
+mktask [config] [-p PORT] [--host HOST] [-d PATH] [--version]
+```
+
+- `config` — path to a `mktask.toml`. Defaults to `./mktask.toml` if
+  present, otherwise the one bundled with the package.
+- `-p, --port` — override the listening port (default 8080).
+- `--host` — override the listening host (default `127.0.0.1`).
+- `-d, --db` — database file; `.db` is appended when there is no
+  extension. `:memory:` runs without persistence.
+
+The server prints the URL to open once it is listening. If the port is
+already taken it exits immediately with an error instead of starting.
+
+## Customizing
+
+Copy the bundled config out and edit it:
+
+```bash
+python -c "import mktask, pathlib; print(pathlib.Path(mktask.__file__).parent / 'mktask.toml')"
+```
+
+`mktask.toml` declares the SQLite tables, the mkio services, and the static
+routes; `static/app.json` next to it declares the UI (menus, panes, frames,
+dialogs). Both are plain config — see the mkio and mkui READMEs for the
+formats.
+
+## Development
+
+```bash
+pip install -e '.[test]'
+mktask -d :memory:
+python -m pytest
+```
+
+The tests cover the CLI and config loading, a real server over HTTP and
+WebSocket (every task op, the query filter, saved layouts, the port and
+host flags), and the static integrity of `app.json` against `mktask.toml`.
+
+## License
+
+Apache License 2.0. See [LICENSE](LICENSE).

mktask-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+mktask/__init__.py,sha256=3NI1BOucJrgSde7x0VdKn1VQeJMlPA_W_yswseo9SA8,263
+mktask/__main__.py,sha256=tOOzs4_ALojj0v-5LGwIf3PLgQji0LLfz1n7_R14ex8,4928
+mktask/mktask.toml,sha256=NkwelfOFEKV5dH_6FgksEQ5okAe2XqnQuBmBNu_CrbI,3602
+mktask/static/app.json,sha256=ZCs3-yzvJlUkSVMx0hAd3hnePWuvKzX9LW_HPkSXWTQ,14449
+mktask/static/index.html,sha256=alN_BEu2rE7XUCe1MRkz8dTwD6XjNaPl7aiZaaI23qs,793
+mktask/static/mktask.css,sha256=ULUlBRe5WsVdwGbj-EkCD-ssmigmoCvPKVxdVajiqT4,291
+mktask-0.1.0.dist-info/METADATA,sha256=sfKqCjVxsz1batHIDTSR1OTuHX84ir_HhdmDvWqqgy8,3455
+mktask-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+mktask-0.1.0.dist-info/entry_points.txt,sha256=vVn6-YAIDvlMtxu1JlCaoMRCosyiczKIymXz-TAjTqE,48
+mktask-0.1.0.dist-info/licenses/LICENSE,sha256=6yqlSHcP6dLy30x4mERZlzbfbx1b8sXOZYaf_JgRJKU,10759
+mktask-0.1.0.dist-info/RECORD,,

mktask-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mktask-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mktask = mktask.__main__:main

mktask-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Mark Kim
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.