trekoon 0.2.8 → 0.3.0

package/README.md

@@ -28,7 +28,7 @@ Recommended (global install with Bun):
 bun add -g trekoon
 ```
 
-Alternative (npm global install):
+Alternative (npm global install — Bun must still be installed as the runtime):
 
 ```bash
 npm i -g trekoon
@@ -99,20 +99,19 @@ The browser flow is local-only by design:
 Current runtime expectations:
 
 - the local runtime is served from `.trekoon/board`
-- the shell currently loads Vue from `unpkg.com`, Tailwind from
-  `cdn.tailwindcss.com`, and Google-hosted fonts/icons when the page renders
-- if your environment blocks those hosts, `trekoon board open` still starts the
-  local server, but the browser UI may render without the enhanced shell until
-  network access is restored
+- all assets are self-hosted: the board ships its own CSS, fonts (Inter,
+  Material Symbols), and vanilla JS with no framework or CDN dependencies
+- the board works fully offline once `trekoon board open` copies the runtime
+  assets into `.trekoon/board`
 
 Current board behavior to expect:
 
-- the topbar is a compact single-row navbar showing the workspace name, active
-  epic context, Epics and Board navigation, search, theme toggle, and a
-  workspace info popover
-- wide screens show the epic switcher sidebar, task workspace, and task
-  inspector together; narrower screens collapse these into stacked panels or
-  drawer-style views
+- the topbar is a compact single-row navbar showing the Trekoon brand, Epics
+  and Board navigation, search, theme toggle, and a workspace info popover;
+  selecting an epic adds the active epic context to the topbar
+- the board toggles between an epics overview and a task workspace view; task
+  detail opens as a modal overlay; responsive breakpoints adjust kanban column
+  counts and component spacing
 - the page scrolls naturally as a single SPA surface; modal overlays (task
   detail, subtask editor) lock body scroll while open
 - overview cards are the primary entry point into an epic; clicking a card opens
@@ -132,8 +131,9 @@ agent to:
 
 - use `--toon` by default
 - prefer the smallest sufficient read
-- use bulk planning commands when possible
-- keep progress in Trekoon with append-based updates
+- use transactional bulk planning commands when possible
+- append progress and blocker notes instead of rewriting full descriptions
+- preview scoped replace before `--apply`
 - treat `.trekoon` as shared repo-scoped operational state
 
 Read [AI agents and the Trekoon skill](docs/ai-agents.md) for installation,

package/docs/commands.md

@@ -79,16 +79,15 @@ Current shell/runtime notes:
 
 - the runtime copied into `.trekoon/board` includes the HTML shell, local app
   modules, and shared styles
-- the current shell also requests Vue from `unpkg.com`, Tailwind from
-  `cdn.tailwindcss.com`, and Google-hosted fonts/icons in the browser
-- if those remote dependencies are blocked, the local server still starts and
-  the fallback URL remains valid, but the browser UI may not fully load until
-  network access is restored
+- all assets are self-hosted: the board ships its own CSS, fonts (Inter,
+  Material Symbols), and vanilla JS with no framework or CDN dependencies
+- the board works fully offline once the runtime assets are copied into
+  `.trekoon/board`
 
 Board UI architecture:
 
-- the board is a single-page application served from `.trekoon/board` with Vue 3
-  (shell) and vanilla JS (board app) loaded from CDN dependencies
+- the board is a single-page application served from `.trekoon/board` using a
+  zero-dependency vanilla JS component runtime with locally bundled CSS and fonts
 - the backend is a Bun HTTP server exposing a REST API at `/api/*` with
   token-based authentication; every mutation response includes an updated
   snapshot so the client always has fresh state
@@ -100,10 +99,9 @@ Board layout behavior:
 - the topbar is a compact flex-row navbar with workspace identity, Epics and
   Board navigation pills, a debounced search input, theme toggle, and a
   workspace info popover
-- extra-wide layouts show the epic switcher sidebar, task workspace, and task
-  inspector or detail modal together
-- narrower layouts progressively collapse support surfaces into stacked panels
-  or drawer-style views
+- the board toggles between an epics overview and a task workspace view; task
+  detail opens as a modal overlay
+- responsive breakpoints adjust kanban column counts and component spacing
 - task cards show truncated descriptions; clicking anywhere on a card opens the
   task detail modal
 

package/docs/quickstart.md

@@ -75,20 +75,19 @@ Current runtime expectations for operators:
 
 - the served HTML, styles, and board app files come from the local
   `.trekoon/board` runtime directory
-- the current shell also pulls Vue from `unpkg.com`, Tailwind from
-  `cdn.tailwindcss.com`, and Google-hosted fonts/icons at page load time
-- if those hosts are unavailable, the command still starts the loopback server
-  and prints the fallback URL, but the shell may not fully hydrate in the
-  browser until network access is available again
+- all assets are self-hosted: the board ships its own CSS, fonts (Inter,
+  Material Symbols), and vanilla JS with no framework or CDN dependencies
+- the board works fully offline once the runtime assets are copied into
+  `.trekoon/board`
 
 Current layout behavior:
 
 - the topbar is a compact navbar with workspace identity, Epics and Board
   navigation, debounced search, theme toggle, and workspace info
-- on wide displays, expect a three-surface workspace: epic switcher sidebar,
-  task workspace, and task inspector
-- on medium and small displays, secondary surfaces collapse into stacked panels
-  or drawer-style views so the board remains navigable on narrower widths
+- the board toggles between an epics overview and a task workspace view; task
+  detail opens as a modal overlay
+- responsive breakpoints adjust kanban column counts and component spacing so
+  the board remains navigable on narrower widths
 - the page scrolls naturally as one document; modal overlays lock body scroll
   while open
 - task cards show truncated descriptions; clicking a card opens the task detail
@@ -106,9 +105,8 @@ Verification checklist for operators:
    the search input while typing.
 4. Click a task card and confirm the task detail modal opens with the full
    description, edit form, and subtask list.
-5. On desktop width, confirm the epic switcher sidebar, workspace, and detail
-   panel can all be visible simultaneously.
-6. Resize to a narrow viewport and confirm the layout stacks cleanly without
+5. On desktop width, confirm the kanban board shows multiple columns.
+6. Resize to a narrow viewport and confirm columns reflow cleanly without
    horizontal overflow.
 7. Close modals and confirm you return to the previous board context.
 

package/package.json

@@ -1,8 +1,30 @@
 {
   "name": "trekoon",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "AI-first local issue tracker CLI.",
+  "keywords": [
+    "ai",
+    "agent",
+    "skill",
+    "cli",
+    "board",
+    "tracker",
+    "agent-tracker",
+    "issue-tracker",
+    "task-tracker",
+    "local-first",
+    "planning",
+    "worktree"
+  ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KristjanPikhof/Trekoon.git"
+  },
+  "homepage": "https://github.com/KristjanPikhof/Trekoon#readme",
+  "bugs": {
+    "url": "https://github.com/KristjanPikhof/Trekoon/issues"
+  },
   "type": "module",
   "bin": {
     "trekoon": "./bin/trekoon"