backlog.md 0.1.0 → 0.1.3

package/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { platform, arch } from 'os';
+import { accessSync, constants } from 'fs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function getBinaryPath() {
+  const os = platform();
+  const architecture = arch();
+  
+  const platformMap = {
+    'darwin': 'darwin',
+    'linux': 'linux',
+    'win32': 'win32'
+  };
+  
+  const archMap = {
+    'x64': 'x64',
+    'arm64': 'arm64'
+  };
+  
+  const mappedOs = platformMap[os];
+  const mappedArch = archMap[architecture];
+  
+  if (!mappedOs || !mappedArch) {
+    throw new Error(`Unsupported platform: ${os}-${architecture}`);
+  }
+  
+  const binaryName = os === 'win32' ? 'backlog.exe' : 'backlog';
+  const binaryPath = join(__dirname, 'bin', `backlog-${mappedOs}-${mappedArch}`, binaryName);
+  
+  try {
+    accessSync(binaryPath, constants.X_OK);
+    return binaryPath;
+  } catch (error) {
+    throw new Error(`Binary not found for platform ${mappedOs}-${mappedArch} at ${binaryPath}`);
+  }
+}
+
+try {
+  const binaryPath = getBinaryPath();
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: process.env
+  });
+  
+  child.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+  
+  child.on('error', (err) => {
+    console.error('Failed to run backlog:', err.message);
+    process.exit(1);
+  });
+} catch (error) {
+  console.error(error.message);
+  console.error('\nPlease report this issue at: https://github.com/MrLesk/Backlog.md/issues');
+  process.exit(1);
+}

package/package.json

@@ -1,47 +1,58 @@
 {
-	"name": "backlog.md",
-	"version": "0.1.0",
-	"module": "src/index.ts",
-	"type": "module",
-	"bin": {
-		"backlog": "cli/index.js"
-	},
-	"dependencies": {
-		"commander": "14.0.0",
-		"gray-matter": "4.0.3",
-		"blessed": "0.1.81"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "1.9.4",
-		"@types/bun": "1.2.15",
-		"husky": "9.1.7",
-		"lint-staged": "16.1.0"
-	},
-	"scripts": {
-		"test": "bun test",
-		"format": "biome format --write .",
-		"lint": "biome lint --write .",
-		"check": "biome check .",
-		"prepare": "husky",
-		"build": "node scripts/build.js",
-		"build:js": "bun build src/cli.ts --outdir cli --target node",
-		"build:exe": "bun build src/cli.ts --compile --outfile cli/backlog",
-		"cli": "bun src/cli.ts"
-	},
-	"lint-staged": {
-		"*.{ts,js,json}": ["biome check --write --files-ignore-unknown=true"],
-		"src/**/*.{ts,js}": ["biome check --write --files-ignore-unknown=true"]
-	},
-	"author": "Alex Gavrilescu (https://github.com/MrLesk)",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/MrLesk/Backlog.md.git"
-	},
-	"bugs": {
-		"url": "https://github.com/MrLesk/Backlog.md/issues"
-	},
-	"homepage": "https://backlog.md",
-	"keywords": ["cli", "markdown", "kanban", "task", "project-management", "backlog", "agents"],
-	"license": "MIT",
-	"trustedDependencies": ["@biomejs/biome"]
-}
+  "name": "backlog.md",
+  "version": "0.1.3",
+  "module": "src/index.ts",
+  "type": "module",
+  "bin": {
+    "backlog": "cli.js"
+  },
+  "dependencies": {
+    "commander": "14.0.0",
+    "gray-matter": "4.0.3",
+    "blessed": "0.1.81"
+  },
+  "scripts": {
+    "test": "bun test",
+    "format": "biome format --write .",
+    "lint": "biome lint --write .",
+    "check": "biome check .",
+    "build": "bun build --compile --outfile=backlog src/cli.ts",
+    "build:standalone": "node scripts/build-standalone.js",
+    "build:npm": "node scripts/build.js",
+    "cli": "bun src/cli.ts"
+  },
+  "lint-staged": {
+    "*.{ts,js,json}": [
+      "biome check --write --files-ignore-unknown=true"
+    ],
+    "src/**/*.{ts,js}": [
+      "biome check --write --files-ignore-unknown=true"
+    ]
+  },
+  "author": "Alex Gavrilescu (https://github.com/MrLesk)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MrLesk/Backlog.md.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MrLesk/Backlog.md/issues"
+  },
+  "homepage": "https://backlog.md",
+  "keywords": [
+    "cli",
+    "markdown",
+    "kanban",
+    "task",
+    "project-management",
+    "backlog",
+    "agents"
+  ],
+  "license": "MIT",
+  "trustedDependencies": [
+    "@biomejs/biome"
+  ],
+  "files": [
+    "bin/",
+    "cli.js"
+  ]
+}

package/.backlog/archive/drafts/readme.md

@@ -1,3 +0,0 @@
-# Archived Drafts
-
-Drafts that were removed from the drafts list but are kept for reference.

package/.backlog/archive/drafts/task-41 - temporary-test-task.md

@@ -1,13 +0,0 @@
----
-id: task-41
-title: Temporary test task
-status: Draft
-assignee: []
-created_date: '2025-06-11'
-labels: []
-dependencies: []
----
-
-## Description
-
-test description

package/.backlog/archive/readme.md

@@ -1,6 +0,0 @@
-# Archive
-
-Tasks that are no longer relevant.
-They may have been completed, superseded, or deemed unnecessary.
-They are kept here for reference or historical purposes.
-They are not actively tracked or managed.

package/.backlog/archive/tasks/readme.md

@@ -1,3 +0,0 @@
-# Archived Tasks
-
-Tasks that were removed from the main backlog but are kept for reference.

package/.backlog/archive/tasks/task-41 - cli-migrate-terminal-ui-to-bblessed.md

@@ -1,14 +0,0 @@
----
-id: task-41
-title: 'CLI: Migrate terminal UI to bblessed'
-status: To Do
-assignee: []
-created_date: '2025-06-11'
-labels:
-  - cli
-dependencies: []
----
-
-## Description
-
-Migrate all CLI interfaces to bblessed for a consistent terminal experience.\n\n## Acceptance Criteria\n- [ ] Init wizard uses bblessed forms and lists\n- [ ] Task view uses bblessed components\n- [ ] Doc view uses bblessed components\n- [ ] Board view rendered with bblessed\n- [ ] Remove prompts-based UI code\n- [ ] Works on Node and Bun

package/.backlog/config.yml

@@ -1,7 +0,0 @@
-project_name: "Backlog.md"
-default_status: "To Do"
-statuses: ["To Do", "In Progress", "Done"]
-labels: []
-milestones: []
-date_format: yyyy-mm-dd
-max_column_width: 80

package/.backlog/decisions/readme.md

@@ -1,7 +0,0 @@
-# Decisions
-
-Team decisions regarding architecture/technologies.
-They are not tasks but rather decisions that guide the development process.
-They may include choices about frameworks, libraries, or design patterns.
-
-Create a new decision log with `backlog decision create <title>` and list all decisions with `backlog decision list`.

package/.backlog/docs/readme.md

@@ -1,20 +0,0 @@
-# Documentation
-
-This directory contains the project's documentation files, including guides, specifications, and other relevant information.
-
-Use `backlog doc create <title>` to add a new document. By default, files are saved here, but you can specify a subfolder with `-p <path>`.
-List all documents with `backlog doc list`.
-
-## Configuration Options
-
-`config.yml` supports the following keys:
-
-- `project_name`: Name of the project
-- `default_assignee`: Optional user assigned to new tasks
-- `default_status`: Default status for new tasks
-- `statuses`: List of allowed task statuses
-- `labels`: List of available labels
-- `milestones`: Project milestones
-- `date_format`: Format for `created_date` values (default `yyyy-mm-dd`)
-
-Default statuses are `To Do`, `In Progress`, and `Done`. Draft tasks live in `.backlog/drafts`.

package/.backlog/drafts/readme.md

@@ -1,3 +0,0 @@
-# Drafts
-
-These tasks are in the draft stage and may require further refinement before they can be moved to the main task list.

package/.backlog/drafts/task-26 - docs-add-board-export-step-to-agent-dod.md

@@ -1,21 +0,0 @@
----
-id: task-26
-title: 'Agents: add board export step to agent DoD'
-status: To Do
-assignee: []
-created_date: '2025-06-09'
-updated_date: '2025-06-09'
-labels:
-  - agents
-dependencies: []
----
-
-## Description
-
-Update the "Definition of Done" sections in CLAUDE.md, AGENTS.md and .cursorrules to instruct agents to run `backlog board export` before committing.
-
-## Acceptance Criteria
-
-- [ ] CLAUDE.md includes a bullet about running `backlog board export` before committing.
-- [ ] AGENTS.md includes the same bullet.
-- [ ] .cursorrules includes the same bullet.

package/.backlog/drafts/task-28 - add-code-of-conduct.md

@@ -1,20 +0,0 @@
----
-id: task-28
-title: Add CODE OF CONDUCT
-status: To Do
-assignee: []
-created_date: '2025-06-09'
-labels:
-  - docs
-  - github
-dependencies: []
----
-
-## Description
-
-Create a standard CODE_OF_CONDUCT.md for the project.
-
-## Acceptance Criteria
-- [ ] CODE_OF_CONDUCT.md added with Contributor Covenant text
-- [ ] Mention in README where to find the Code of Conduct
-- [ ] Task committed to repository

package/.backlog/drafts/task-30 - create-changelog.md

@@ -1,19 +0,0 @@
----
-id: task-30
-title: Create CHANGELOG
-status: To Do
-assignee: []
-created_date: '2025-06-09'
-labels:
-  - docs
-dependencies: []
----
-
-## Description
-
-Start a CHANGELOG.md documenting major features and fixes.
-
-## Acceptance Criteria
-- [ ] CHANGELOG.md added with entries for initial release
-- [ ] Guidelines in README reference the changelog
-- [ ] Task committed to repository

package/.backlog/milestones/m-0 - project-setup.md

@@ -1,8 +0,0 @@
----
-id: m-0
-title: "Bootstrap Backlog.md Project Definition with Initial Tasks"
----
-
-## Description
-
-This milestone focuses on setting up the foundational structure for the Backlog.md project. It includes creating the initial directory structure, defining the first set of tasks, and establishing the project setup with Git for version control. The goal is to prepare the groundwork for subsequent milestones.

package/.backlog/milestones/m-1 - cli.md

@@ -1,8 +0,0 @@
----
-id: m-1
-title: "CLI Development"
----
-
-## Description
-
-This milestone focuses on building the command-line interface (CLI) for the Backlog.md tool. It includes tasks for implementing core functionality, such as task management commands, documentation handling, and decision logging. The goal is to create a robust CLI that can be easily used and extended.

package/.backlog/milestones/m-2 - cli-kanban.md

@@ -1,8 +0,0 @@
----
-id: m-2
-title: "Kanban Board (CLI Visualization)"
----
-
-## Description
-
-In this milestone, we will implement a text-based Kanban board view in the CLI, allowing users to visualize and manage tasks more effectively.

package/.backlog/milestones/m-3 - gui.md

@@ -1,8 +0,0 @@
----
-id: m-3
-title: "GUI Development"
----
-
-## Description
-
-The third milestone focuses on building the graphical user interface (GUI) for the Backlog.md tool. 

package/.backlog/milestones/m-4 - gui-kanban.md

@@ -1,8 +0,0 @@
----
-id: m-4
-title: "GUI Kanban Board Development"
----
-
-## Description
-
-This milestone focuses on building the graphical user interface (GUI) for the Kanban board view in the Backlog.md tool.

package/.backlog/milestones/m-5 - gui-advanced.md

@@ -1,12 +0,0 @@
----
-id: m-5
-title: "Advanced GUI Features"
----
-
-## Description
-
-The fifth milestone focuses on enhancing the graphical user interface (GUI) for the Backlog.md tool. This includes implementing advanced features such as:
-
-- Improved task visualization and management.
-- Enhanced user interactions and feedback.
-- Integration with external tools and services.

package/.backlog/milestones/readme.md

@@ -1,3 +0,0 @@
-# Milestones
-
-List of milestones that the task will be part of, including their goals and high-level tasks.

package/.backlog/readme.md

@@ -1,5 +0,0 @@
-# Backlog.md Project files
-
-This directory contains the Backlog.md project files, including tasks, documentation, and configuration.
-
-Refer to the `readme.md` files in each subdirectory for specific instructions on how to use the Backlog.md tool for that folder.

package/.backlog/tasks/readme.md

@@ -1,37 +0,0 @@
-# Tasks
-
-List of tasks that are ready to be implemented
-
-Tasks are stored as `task-<id> - <title>.md`.  
-For subtasks, use decimal numbering like `task-4.1 - example.md`.
-
-Example of a task definition in Markdown format:
-
-```markdown
----
-id: task-0
-title: "Bootstrap Backlog.md Project Definition with Initial Tasks"
-status: "Done"
-assignee: "@MrLesk"
-reporter: "@MrLesk"
-created_date: 2025-06-03
-completed_date: 2025-06-03
-labels: ["project-setup", "meta", "milestone-0"]
-milestone: "M0 - Project Setup"
----
-
-## Description
-
-Define the initial Backlog working directory structure and create the first set of tasks for building the Backlog tool itself using the Backlog methodology. This includes defining the first three milestones (CLI, Kanban Dashboard, GUI) and their high-level tasks. Set up Git for version control and define basic rules for AI agents.
-
-## Acceptance Criteria (Optional)
-
-- [x] `.backlog` directory structure created.
-- [x] Initial `config.yml` created.
-- [x] Markdown task files for Milestones 1, 2, and 3 high-level tasks created in `.backlog/tasks/` or `.backlog/draft/`.
-- [x] All initial tasks committed to the Git repository.
-- [x] `agents.md` file for AI Agent instructions
-
-## Notes & Comments (Optional)
-This task serves as the foundation for the Backlog.md project, ensuring that all subsequent tasks and milestones are built upon a solid structure. It is crucial for maintaining organization and clarity throughout the project lifecycle.
-```

package/.backlog/tasks/task-1 - cli-setup-core-project.md

@@ -1,23 +0,0 @@
----
-id: task-1
-title: "CLI: Setup Core Project (Bun, TypeScript, Git, Linters)"
-status: Done
-assignee: @MrLesk
-reporter: @MrLesk
-created_date: 2025-06-03
-labels: ["cli", "setup"]
-milestone: "M1 - CLI"
-dependencies: ["task-0"]
----
-
-## Description
-
-Initialize the actual Bun + TypeScript project. Configure linters (Biome), basic testing framework (Bun test).
-
-## Acceptance Criteria
-
-- [x] Bun project initialized (`bun init`).
-- [x] TypeScript configured.
-- [x] Biome configured and working.
-- [x] Basic `bun test` example runs.
-- [x] Project `README.md` created.

package/.backlog/tasks/task-10 - gui-init-packaging.md

@@ -1,23 +0,0 @@
----
-id: task-10
-title: "GUI: Implement `backlog init` in GUI & GUI Packaging"
-status: "To Do"
-assignee: []
-reporter: @MrLesk
-created_date: 2025-06-04
-labels: ["gui", "feature"]
-milestone: "M3 - GUI"
-dependencies: ["task-8"]
----
-
-## Description
-
-- Implement a GUI mechanism to perform the `backlog init` action
-- Set up build process for the Tauri build tool to create distributable packages.
-- Implement the `backlog gui` command in the CLI to launch the packaged GUI application or guide download.
-
-## Acceptance Criteria
-
-- [ ] GUI can initialize a new Backlog.md project.
-- [ ] GUI can be packaged into distributable formats (.exe, .dmg, .AppImage).
-- [ ] `backlog gui` command in CLI successfully launches the GUI or provides download instructions.

package/.backlog/tasks/task-11 - gui-kanban-board.md

@@ -1,26 +0,0 @@
----
-id: task-11
-title: "GUI: Implement GUI Kanban Board Display & Interaction"
-status: "To Do"
-assignee: []
-reporter: @MrLesk
-created_date: 2025-06-04
-labels: ["gui", "kanban", "feature"]
-milestone: "M4 - GUI-Kanban Board"
-dependencies: ["task-8"]
----
-
-## Description
-
-Develop the main Kanban board view in the GUI:
-
-- Display columns based on task statuses.
-- Render task cards with key information.
-- Implement drag-and-drop to change task status (updating the Markdown file and committing).
-- Allow opening a task for detailed view/edit.
-
-## Acceptance Criteria
-
-- [ ] Kanban board accurately reflects tasks in `.backlog/tasks/`.
-- [ ] Task cards display relevant info.
-- [ ] Drag-and-drop updates task status and commits change.

package/.backlog/tasks/task-12 - gui-advanced.md

@@ -1,25 +0,0 @@
----
-id: task-12
-title: "GUI: Implement GUI for Drafts, Docs, Decisions"
-status: "To Do"
-assignee: []
-reporter: @MrLesk
-created_date: 2025-06-04
-labels: ["gui", "feature"]
-milestone: "M5 - Advanced GUI Features"
-dependencies: ["task-8"]
----
-
-## Description
-
-Develop GUI sections for:
-
-- Viewing and managing the drafts (promoting to active board).
-- Viewing and editing documentation files (`.backlog/docs/`).
-- Viewing and editing decision logs (`.backlog/decisions/`).
-
-## Acceptance Criteria
-
-- [ ] Draft view with promote functionality.
-- [ ] Documentation section with Markdown viewer/editor.
-- [ ] Decisions section with viewer/editor.

package/.backlog/tasks/task-13 - cli-add-agent-instruction-prompt.md

@@ -1,53 +0,0 @@
----
-id: task-13
-title: 'CLI: Add Agent Instruction Prompt'
-status: Done
-assignee: []
-reporter: @MrLesk
-created_date: 2025-06-08
-updated_date: 2025-06-09
-labels: [cli, agents]
-dependencies: []
----
-
-## Description
-
-Add an interactive step to `backlog init` that asks the user if they want to include instructions for AI agents such as Codex, Claude Code, or Google Jules. When confirmed, the command should create the appropriate guideline files (`AGENTS.md`, `.CLAUDE.md`, `.cursorrules`) if they do not exist, or append the instructions if they are already present.
-
-## Acceptance Criteria
-
-- [x] `backlog init` prompts: "Add instructions for AI agents? [y/N]".
-- [x] On confirmation, guideline files are created or updated with Backlog usage instructions.
-- [x] Existing files are appended rather than overwritten.
-- [x] Declining the prompt leaves the repository unchanged.
-- [x] Feature covered by automated tests.
-
-## Implementation Notes
-
-Added interactive agent instructions prompt to the CLI `backlog init` command. Key technical details:
-
-**CLI Integration (src/cli.ts:48-57):**
-- Added prompt "Add instructions for AI agents? [y/N]" after reporter configuration
-- Only calls `addAgentInstructions()` when user confirms with "y" or "yes"
-- Integrated with existing git operations for automatic commit
-
-**Agent Instructions Module (src/agent-instructions.ts):**
-- Creates three guideline files: `AGENTS.md`, `CLAUDE.md`, and `.cursorrules`
-- Reads existing files and appends new content rather than overwriting
-- Handles missing files by creating them with default content
-- Automatically commits changes via GitOperations when provided
-
-**Guideline Content (src/guidelines/):**
-- `AGENTS.md`: General guidelines for AI agents working with Backlog projects
-- `CLAUDE.md`: Specific instructions for Claude Code integration
-- `.cursorrules`: Configuration for Cursor AI editor
-
-**Testing:**
-- Unit tests in `src/test/agent-instructions.test.ts` verify file creation and appending behavior
-- CLI integration test in `src/test/cli.test.ts` verifies end-to-end functionality
-- All 127 tests pass including the new integration test
-
-**File Handling:**
-- Uses Bun.file() for efficient file I/O operations
-- Preserves existing content by reading before writing
-- Ensures proper newline handling when appending content

package/.backlog/tasks/task-13.1 - cli-agent-instruction-file-selection.md

@@ -1,40 +0,0 @@
----
-id: task-13.1
-title: 'CLI: Agent Instruction File Selection'
-status: Done
-assignee: []
-reporter: '@MrLesk'
-created_date: '2025-06-09'
-updated_date: '2025-06-09'
-labels:
-  - cli
-  - agents
-dependencies: []
-parent_task_id: task-13
----
-
-## Description
-
-Replace the existing yes/no prompt in `backlog init` with a multi-select menu. Users can choose any combination of the following guideline files to update with Backlog instructions:
-
-- `.cursorrules`
-- `CLAUDE.md`
-- `AGENTS.md`
-- `readme.md`
-
-## Acceptance Criteria
-
-- [x] `backlog init` displays a multi-select prompt for agent instruction files.
-- [x] Users can select one or more files, or skip entirely.
-- [x] Selected files are created or appended with instructions; unselected files remain unchanged.
-- [x] Automated tests cover the new selection flow.
-
-## Implementation Notes
-
-* Replaced yes/no prompt with numbered multi-select menu in `src/cli.ts:52-65`.
-* Users can select from `.cursorrules`, `CLAUDE.md`, `AGENTS.md`, and `readme.md` files.
-* Menu displays numbered options (1-4) and accepts comma-separated selections.
-* Blank input skips agent instruction file creation entirely.
-* Implementation uses `addAgentInstructions()` function to handle file creation/appending.
-* Test coverage provided by "should create agent instruction files when requested" in `src/test/cli.test.ts`.
-* Maintains backward compatibility while improving user experience with more granular control.