kandown 0.11.2 → 0.13.0

package/dist/manifest.json

@@ -12,6 +12,24 @@
       "sizes": "any",
       "type": "image/svg+xml",
       "purpose": "any"
+    },
+    {
+      "src": "/favicon-32x32.png",
+      "sizes": "32x32",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/android-chrome-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any maskable"
+    },
+    {
+      "src": "/android-chrome-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
     }
   ]
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kandown",
-  "version": "0.11.2",
+  "version": "0.13.0",
   "description": "File-based Kanban engine backed by Markdown. Zero backend, AI-agent friendly.",
   "type": "module",
   "bin": {

package/templates/AGENT.md

@@ -1,6 +1,6 @@
 # Kandown conventions for AI agents
 
-This project uses a file-based Kandown board located in `.kandown/`. Read this file before touching task files.
+This project uses a file-based Kandown board. The config and web UI live in `.kandown/`; the task files live in `tasks/` at the project root. Read this file before touching task files.
 
 ## Source of truth
 
@@ -9,10 +9,13 @@ Tasks are the source of truth. There is no board index to maintain.
 ```
 .kandown/
 ├── kandown.json      ← project settings and board columns
-├── tasks/
-│   ├── t1.md      ← task status, metadata, subtasks, notes, report
-│   └── ...
-└── kandown.html      ← local web UI
+├── kandown.html      ← local web UI
+├── AGENT.md          ← this file
+└── AGENT_KANDOWN.md  ← full reference
+
+tasks/
+├── t1.md             ← task status, metadata, subtasks, notes, report
+└── ...
 ```
 
 Columns are stored in `.kandown/kandown.json` under `board.columns`. A task belongs to a column through its frontmatter `status`.
@@ -83,7 +86,7 @@ report: |
 
 ## Creating tasks
 
-Create a new `tasks/<id>.md` file. Pick the next available ID by scanning filenames in `.kandown/tasks/`. Task IDs use the format `t<N>` (e.g. `t1`, `t2`, `t45`).
+Create a new `tasks/<id>.md` file. Pick the next available ID by scanning filenames in `tasks/`. Task IDs use the format `t<N>` (e.g. `t1`, `t2`, `t45`).
 
 ## Mutation rules
 
@@ -94,8 +97,8 @@ Create a new `tasks/<id>.md` file. Pick the next available ID by scanning filena
 | Change title/priority/tags/assignee | Task file frontmatter only |
 | Change ownerType/tools | Task file frontmatter only |
 | Edit description/notes/subtasks/report | Task file body/frontmatter only |
-| Create task | Create one file in `.kandown/tasks/` |
-| Delete task | Delete its file from `.kandown/tasks/` |
+| Create task | Create one file in `tasks/` |
+| Delete task | Delete its file from `tasks/` |
 
 ## Scope control
 

package/templates/AGENT_KANDOWN.md

@@ -2,13 +2,20 @@
 
 ## The System
 
-Kandown is a file-based Kanban backed by plain markdown. All task state lives in `.kandown/tasks/*.md` — no separate board index, no database.
+Kandown is a file-based Kanban backed by plain markdown. All task state lives in `tasks/*.md` at the project root — no separate board index, no database.
 
 ```
-.kandown/
-├── tasks/           # Task files (source of truth)
-├── kandown.json     # Board columns + project settings
-└── kandown.html     # Web UI
+.kandown/             # config, web UI, agent docs
+├── kandown.json      # Board columns + project settings
+├── kandown.html      # Web UI (single-file bundle)
+├── AGENT.md          # AI-agent conventions
+└── AGENT_KANDOWN.md  # (this file) full reference
+
+tasks/                # source of truth — one .md per task
+├── t1.md
+├── t2.md
+└── archive/          # archived tasks (.md files moved here)
+    └── t99.md
 ```
 
 **Board columns** are configured in `kandown.json` at `board.columns`. Tasks without a `status` go to **Backlog**.
@@ -87,9 +94,9 @@ The `report:` field supports markdown and is displayed prominently in the UI. Wr
 | Reorder task | Task file: update `order:` in frontmatter |
 | Change title/priority/tags/assignee | Task file frontmatter |
 | Edit description/notes/subtasks | Task file body only |
-| Create task | Create one new `.kandown/tasks/t-NNN.md` |
+| Create task | Create one new `tasks/t-NNN.md` |
 | Delete task | Delete the task file |
-| Create/rename/delete columns | `kandown.json` at `board.columns` |
+| Create/rename/delete columns | `.kandown/kandown.json` at `board.columns` |
 
 **One task file = one source of truth.** Never maintain a separate board index.
 
@@ -138,9 +145,10 @@ Edge cases, gotchas.
 | `assignee` | Username or AI agent name |
 | `ownerType` | `human` or `ai` |
 | `report` | Completion summary (markdown, shown in UI) |
+| `depends_on` | Task ids this one is blocked by. Moving to the terminal column (last `board.columns` entry) is rejected while any dependency is unresolved. Archived / terminal / unknown ids do not block. |
 
 ---
 
 ## Stack
 
-React, Motion, Tailwind, Vite, Zustand, TypeScript, Node.js ESM CLI.
+React, Motion, Tailwind, Vite, Zustand, TypeScript, Node.js ESM CLI.

package/templates/README.md

@@ -1,31 +1,34 @@
-# .kandown/
+# Kandown
 
 File-based kanban for this project. Zero install, zero backend, plain markdown on disk.
 
+## Layout
+
+```
+.kandown/             # config, web UI, agent docs
+├── kandown.html      # single-file web app — open this in your browser
+├── kandown.json      # project preferences, columns, appearance
+├── AGENT.md          # AI agent conventions
+├── AGENT_KANDOWN.md  # full agent reference
+└── README.md         # this file
+
+tasks/                # source of truth — one .md file per task
+├── t1.md
+├── t2.md
+└── archive/          # archived tasks live here
+```
+
 ## Usage
 
-1. Open `kandown.html` in Chrome, Edge, Brave or Opera (File System Access API required)
-2. Click **Select folder** and pick this `.kandown/` directory, then grant read/write permission
+1. Open `.kandown/kandown.html` in Chrome, Edge, Brave or Opera (File System Access API required)
+2. Click **Select folder** and pick the **project root** (the parent of `.kandown/`), then grant read/write permission
 3. That's it
 
 The app remembers the last 10 projects you've opened — no need to re-select the folder each time.
 
-## Structure
-
-```
-.kandown/
-├── tasks/
-│   ├── t1.md      ← full task details
-│   └── ...
-├── kandown.html       ← the engine (single file, no dependencies)
-├── kandown.json      ← project preferences, columns, appearance, optional fields
-├── AGENT.md          ← AI coding agent conventions
-└── README.md         ← this file
-```
-
 ## Settings
 
-Open Settings from the app header to tune this project. Board columns are stored in `kandown.json` at `board.columns`. Each task chooses a column with its frontmatter `status`.
+Open Settings from the app header to tune this project. Board columns are stored in `.kandown/kandown.json` at `board.columns`. Each task chooses a column with its frontmatter `status`.
 
 ## Editing without the app
 
@@ -33,17 +36,18 @@ Everything is plain markdown. Edit files directly in your IDE, Obsidian, or vim.
 
 ## For AI agents
 
-See `AGENT.md`. The key convention: each task file is its own source of truth. Moving a task means editing the task's frontmatter `status`.
+See `AGENT.md` and `AGENT_KANDOWN.md`. The key convention: each task file in `tasks/` is its own source of truth. Moving a task means editing the task's frontmatter `status`.
 
 ## Keyboard shortcuts
 
 | Key | Action |
 |---|---|
 | `⌘K` / `Ctrl+K` | Command palette |
-| `⌘1` / `Ctrl+2` | Board / list view |
+| `⌘1` / `Ctrl+1` | Board view |
+| `⌘2` / `Ctrl+2` | List view |
 | `N` | New task |
 | `R` | Reload |
 | `/` | Focus search |
 | `Esc` | Close drawer / palette |
 | `⌘S` | Save current task |
-| `⌘⌫` | Delete task (with confirmation) |
+| `⌘⌫` | Delete task (with confirmation) |