@odarino/backlog.md 1.55.0 → 1.57.0-next.0

package/README.md

@@ -29,6 +29,8 @@ Homebrew and Nix install the upstream package, which does not have the fork feat
 
 - **Image zoom.** Click an image in a task, a document, or a decision to open it full screen. Zoom with the mouse wheel, a double-click, or a pinch. Drag to pan. Use the arrow keys to move between all images of the task.
 - **Image upload, paste, and drag-drop.** Paste a screenshot or drop image files into any task editor. The server compresses each image to WebP and saves it under `backlog/assets/images/<task-id>/`. Images that you add before a task has an ID go to `_unsorted/`, and they move to the task folder when you create the task. An image that another task also links is copied, not moved.
+- **Image upload mode.** A dialog shows a preview of each image and lets you choose to convert it to WebP or keep the original. From the CLI, run `backlog asset add <file> [--task <id>] [--original]`. MCP uses `asset_add`.
+- **Random task IDs.** Set `taskIdMode` to `random` (`backlog config set taskIdMode random`) to give new tasks a random 6-digit ID (100000-999999). The default is `sequential`. The mode applies to tasks only. Subtasks keep the `.1` form. Duplicate-ID repair and draft promotion still allocate IDs as before, and collisions across unsynced branches remain possible (repairable with the duplicate-ID repair).
 - **Image picker.** The image button in the editor toolbar opens a picker. Search, select, and insert existing images, or upload new ones.
 - **Workflow editor.** In Settings, add, rename, reorder, color, and delete statuses. A rename or delete rewrites the affected tasks in `tasks/`, `completed/`, and `archive/tasks/`. Status colors show on the board columns and in the task list.
 - **Clone task.** Copy a task into a new one from the task view (**Clone**), the CLI (`backlog task clone <id> [--title <title>]`), or MCP (`task_clone`). The copy keeps the content, labels, links, and checklists (unchecked), and resets the status (drafts stay drafts), due date, notes, summary, and comments.

package/haren-plugin.json

@@ -0,0 +1,22 @@
+{
+	"name": "backlog",
+	"harenApi": "1",
+	"description": "Two-way sync between haren tasks and a Backlog.md board",
+	"requires": [
+		{
+			"bin": "backlog",
+			"version": ">=1.57.0-0",
+			"install": "npm i -g @odarino/backlog.md"
+		}
+	],
+	"setup": [
+		"sh -c 'if [ -f backlog/config.yml ] || [ -f backlog/config.yaml ] || [ -f .backlog/config.yml ] || [ -f .backlog/config.yaml ] || [ -f backlog.config.yml ] || [ -f backlog.json ]; then exit 0; fi; if git rev-parse --git-dir >/dev/null 2>&1; then backlog init \"$0\" --defaults; else backlog init \"$0\" --defaults --no-git; fi' '{{project}}'"
+	],
+	"hooks": {
+		"session-start": "backlog haren-hook session-start",
+		"after-plan": "backlog haren-hook after-plan",
+		"on-task-status": "backlog haren-hook on-task-status"
+	},
+	"config": {},
+	"skills": ["skills/haren-board"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odarino/backlog.md",
-  "version": "1.55.0",
+  "version": "1.57.0-next.0",
   "module": "src/cli.ts",
   "files": [
     "cli.js",
@@ -8,18 +8,20 @@
     "postuninstall.cjs",
     "package.json",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "haren-plugin.json",
+    "skills/"
   ],
   "bin": {
     "backlog": "cli.js"
   },
   "optionalDependencies": {
-    "@odarino/backlog.md-darwin-arm64": "1.55.0",
-    "@odarino/backlog.md-darwin-x64": "1.55.0",
-    "@odarino/backlog.md-linux-arm64": "1.55.0",
-    "@odarino/backlog.md-linux-x64": "1.55.0",
-    "@odarino/backlog.md-windows-arm64": "1.55.0",
-    "@odarino/backlog.md-windows-x64": "1.55.0"
+    "@odarino/backlog.md-darwin-arm64": "1.57.0-next.0",
+    "@odarino/backlog.md-darwin-x64": "1.57.0-next.0",
+    "@odarino/backlog.md-linux-arm64": "1.57.0-next.0",
+    "@odarino/backlog.md-linux-x64": "1.57.0-next.0",
+    "@odarino/backlog.md-windows-arm64": "1.57.0-next.0",
+    "@odarino/backlog.md-windows-x64": "1.57.0-next.0"
   },
   "scripts": {
     "postuninstall": "node postuninstall.cjs"

package/skills/haren-board/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: haren-board
+description: Use the Backlog.md board inside a haren project. Open the board, read task status, and change status through haren.
+---
+
+# Backlog board for haren
+
+haren syncs its planned features with Backlog.md tasks. Each synced task has the label `haren:<module>/<feature>`.
+
+## Open the board
+
+- Terminal board: `backlog board`
+- Web board: `backlog browser`
+
+## Rules
+
+1. In a haren session, change a feature status with the haren `update-tracking` skill. Do not change it with `backlog task edit`. haren then updates the board.
+2. A person can move a task on the board. haren reads the change at the next session start.
+3. haren owns the title, the description, and the dependencies of a synced task. Change them in the haren plan, not on the board.
+4. Do not remove the `haren:` label from a task. haren uses it to find the task.