tasku 0.4.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd2fbd40e27817e56591b3a6ff769c59b109de5e34f2a09b416e38008de1428f
-  data.tar.gz: 787ea03c2a16d886bf62869d8e5174f28e5be667822e113fc248b32135e175bd
+  metadata.gz: d18e6bd1dfa0e69dc685364eb89aaf5a77ea20536179bb635fe5cabf419b7296
+  data.tar.gz: 2d37502dcef646ec9f7d5b8805ee266759e3414e6768abfc3e0393b0193c5a1e
 SHA512:
-  metadata.gz: 3998485e4d8369986f96db7ab64330e1f9b19993c025288899920fb02f6c6670fd0e9980cfcd881a755c00118e5ea002a980b3ca543d094f15d750c8cb86fb46
-  data.tar.gz: 3c7a5a32c70554e2824ba41d7cc8197669c57ff63e339cc0e7c9a0b5b40606018ba181c6baea59bf4cf1de777740148660d3bd2dbcfe241cd4498aff78dd34f0
+  metadata.gz: 4d90b603cc137e7a1a296d808bfae2287d7bb3a111942a5ead559bb67684bf1a24c30a0b5a03afdced036b60eaebc2a50c4293aead2af7eb6e6caac21a39b49a
+  data.tar.gz: fb33681495b68a02ed4a5b82dc1b9cb04da5409d48bb90a5e6cc70128e8b8e8417b839b4b74d4e86f3ececa9bbf8d89b96f7705b14f20cd2326ce1615cd70777

data/CHANGELOG.md

@@ -0,0 +1,108 @@
+# Changelog
+
+All notable changes to Tasku are documented here.
+
+## [0.4.2] - 2026-10-29
+
+### Added
+- **Auto branch checkout** — when a task is set to `in_progress` via `tasku edit ID --status in_progress`, Tasku automatically creates and checks out a git branch named `CODE-ID-name-slug` in the linked repo. If the branch already exists it switches to it instead. Configure with `tasku git link CODE PATH`, remove with `tasku git unlink CODE`, and inspect with `tasku git list`.
+- **Mado: confirm before delete** — pressing `d` in the interactive task list now shows a confirmation prompt; press `y` to confirm, any other key cancels
+
+### Security
+- All `system()` and `exec()` calls in `MadoList` now use the array form (via
+  `Shellwords.shellsplit`) instead of a shell string, preventing shell
+  interpretation of metacharacters in command arguments
+
+## [0.4.1] - 2026-09-29
+
+### Fixed
+- **Cloud sync: project colours now sync down** — `tasku cloud sync` applied only the tasks from the server's response and ignored its `projects`, so colours set on another machine never arrived. They are now created or updated locally, and the sync summary reports how many changed. In Mado this also restores project colours and workspaces on a freshly synced machine
+
+## [0.4.0] - 2026-09-23
+
+### Added
+- **Tasku Cloud sync** — two-way sync with `tasku cloud sync`; authenticate with `tasku cloud login <token>`, check status with `tasku cloud status`, and revoke with `tasku cloud logout`
+- **`tasku config open`** — opens the config file in `$EDITOR` pre-seeded with all available keys and their defaults
+- **Numeric range preferences** — config keys that accept a numeric range (e.g. column minimum widths) now show their valid range in `tasku config list`
+- **`--code` flag** on `add` and `edit` — attach a short code to a task (e.g. `MDO-42`)
+- **`tasku sql`** — run a raw SQL `SELECT` query against the local database
+- **Category filtering** — `tasku list --category` and category column in list output
+- **Column visibility preferences** — `col_project`, `col_category`, `col_priority`, `col_status`, `col_due` can each be toggled `on`/`off` via `tasku config set`
+- **Column minimum width preferences** — `col_name_min`, `col_priority_min`, `col_status_min`, `col_due_min` for fine-tuning layout
+- **`tasku config open`** — open the config JSON in `$EDITOR` (pre-seeded with defaults)
+- **UUID field** on tasks for stable cross-device identity during cloud sync
+
+### Fixed
+- **Mado: status filter preserved after add/edit/delete** — `MadoList` now receives the full `list_cmd` (including `--status`, `--today`, `--overdue`, etc.) and passes it to `exec` on return, so the active view is restored correctly after an interactive command
+- **Mado: project filter preserved after add/edit/delete** — the inline-exec protocol (`\x02`) now replaces the MadoList process via `exec` instead of nesting it in a `system()` call, so the new MadoList inherits the correct `@list_cmd` and filter is preserved when navigating back from an interactive command
+- **Mado: project filter lost on workspace switch** — the open-panel flag is now tracked correctly for sidebar-positioned Tasku (not just the top-bar overlay), so switching workspace reliably refreshes the task list with the new project filter
+- **Mado: terminal left in raw mode after inline exec** — `$stdin.cooked!` is now called before `exec` when handling a `\x02tasku list` command, preventing the shell from inheriting raw-mode terminal attributes
+- **Due date column truncation** — `DUE_COL_MIN_WIDTH` raised to 17 to accommodate the longest possible due cell (`"Mmm DD (NNNd ago)"`)
+- **MadoList row overflow** — row prefix accounting corrected to 6 characters (`"  [>] "`), matching the actual rendered prefix; was previously 4, causing rows to exceed terminal width and wrap
+- **Name truncation** — task names that exceed available space are now truncated with `…`; names that fit are never truncated, fixing cases where the due-date column wrapped to the next line
+- **Column auto-drop on narrow terminals** — optional columns (project → category → priority → status) are dropped one at a time until at least 15 characters are available for task names, rather than wrapping or clipping
+
+### Changed
+- `tasku list` output uses a consistent `│`-separated column layout with a header row
+- `tasku config set` validates values via `ArgumentError` rather than a plain string comparison, supporting range constraints
+- `tasku stats` includes a "By Project" section sorted by task count
+- Sort defaults to `id` (ascending) when no `--sort` flag is given
+- `id` added as an explicit `--sort` option
+
+---
+
+## [0.3.9] - 2026-09-04
+
+### Added
+- **Mado TUI list mode** — `tasku list` launches an interactive cursor-driven list when `MADO=1` is set in the environment, designed for embedding in the Mado terminal multiplexer sidebar
+- Arrow-key navigation, selected task ID written to `TASKU_SEL_FILE` for Mado button integration
+- Inline-exec protocol (`\x02`) for receiving filter and display commands from Mado without shell round-trips
+- `build_mado_rows` and `ansi_ljust` helpers exposed on `Output::Terminal` for Mado's renderer
+
+---
+
+## [0.3.1] - 2026-08-29
+
+### Fixed
+- Terminal width was capped at 80 columns regardless of actual PTY size, severely truncating the name column in wider terminals — now uses the real terminal width
+
+### Changed
+- `tasku list` sorts by `id` by default
+- `exit_on_failure?` enabled on the CLI so bad subcommands exit with a non-zero status
+
+---
+
+## [0.3.0] - 2026-07-24
+
+### Added
+- **Project colours** — `tasku colour PROJECT #HEX` stores a hex colour per project; project names are tinted throughout `list`, `show`, and `stats`
+- **Colour bar** — three-segment bar in `tasku list` showing project, priority, and status at a glance (toggle each segment with `tasku config set bar_project on/off` etc.)
+- **User preferences** — `tasku config list` / `tasku config set KEY VALUE` / `tasku config get KEY`, backed by `~/.tasku/config.json`
+- `list_spacing` preference (`compact` / `spacious`)
+- **"By Project" section** in `tasku stats` sorted by task count
+- Logo restored on `tasku help` and bare `tasku` invocation
+
+---
+
+## [0.2.0] - 2026-07-01
+
+### Added
+- `tasku projects` — list all projects with task counts and colour swatches
+- `tasku categories` — list all categories
+- `tasku done ID` — shorthand to mark a task done
+- `--overdue`, `--today`, `--tomorrow` filter flags on `tasku list`
+- `--sort` and `--order` flags on `tasku list`
+- `--priority`, `--status`, `--tags` filter flags on `tasku list`
+- `--force` / `-f` flag on `tasku delete` to skip confirmation
+
+---
+
+## [0.1.0] - 2026-06-29
+
+Initial release.
+
+- `tasku add`, `tasku list`, `tasku show`, `tasku edit`, `tasku delete`
+- SQLite-backed storage at `~/.tasku/tasks.db`
+- Task fields: name, description, project, category, priority, status, start date, due date, tags, estimated hours
+- `tasku stats` — task breakdown by priority and status
+- Interactive add/edit with `-i` flag (TTY::Prompt)

data/lib/tasku/cli.rb

@@ -3,6 +3,7 @@
 require "fileutils"
 require "json"
 require "net/http"
+require "shellwords"
 require "uri"
 
 module Tasku
@@ -69,6 +70,48 @@ module Tasku
       end
     end
 
+    class GitApp < Thor
+      desc "link CODE PATH", "Link a project code to a git repo path (enables auto branch checkout)"
+      def link(code, path)
+        pastel = Pastel.new
+        expanded = File.expand_path(path)
+        unless Dir.exist?(expanded)
+          abort pastel.red("  Path does not exist: #{expanded}")
+        end
+        unless Dir.exist?(File.join(expanded, ".git"))
+          abort pastel.red("  Not a git repository: #{expanded}")
+        end
+        Tasku::Config.set_git_path(code, expanded)
+        puts pastel.green("  ✓ #{code.upcase} linked to #{expanded}")
+        puts pastel.dim("  Setting a task to in_progress will now auto-checkout a branch.")
+      end
+
+      desc "unlink CODE", "Remove a project code's git repo link"
+      def unlink(code)
+        pastel = Pastel.new
+        unless Tasku::Config.git_path_for(code)
+          abort pastel.yellow("  #{code.upcase} is not linked to any repo.")
+        end
+        Tasku::Config.unset_git_path(code)
+        puts pastel.green("  ✓ #{code.upcase} unlinked.")
+      end
+
+      desc "list", "List all project code → repo path links"
+      def list
+        pastel = Pastel.new
+        projects = Tasku::Config.all_git_projects
+        if projects.empty?
+          puts pastel.dim("  No git links configured. Use `tasku git link CODE PATH` to add one.")
+          return
+        end
+        puts ""
+        projects.each do |code, path|
+          puts "  #{pastel.bold(code.ljust(8))} #{path}"
+        end
+        puts ""
+      end
+    end
+
     class CloudApp < Thor
       desc "login TOKEN", "Authenticate with Tasku Cloud using an API token"
       option :url, type: :string, desc: "Tasku Cloud URL (default: #{Tasku::Config::CLOUD_URL_DEFAULT})"
@@ -196,9 +239,10 @@ module Tasku
           abort pastel.red("  Sync failed (HTTP #{res.code}).")
         end
 
-        body         = JSON.parse(res.body)
-        server_tasks = body["tasks"] || []
-        synced_at    = body["synced_at"]
+        body            = JSON.parse(res.body)
+        server_tasks    = body["tasks"]    || []
+        server_projects = body["projects"] || []
+        synced_at       = body["synced_at"]
 
         created = updated = conflicts = 0
 
@@ -261,6 +305,21 @@ module Tasku
           end
         end
 
+        # Local projects were pushed above, so the server's list already reflects
+        # them — adopt it wholesale so colours set on other machines come down.
+        projects_pulled = 0
+        (body["projects"] || []).each do |sp|
+          name   = sp["name"].to_s.strip
+          colour = sp["colour"].to_s.strip
+          next if name.empty? || colour !~ /\A#[0-9A-Fa-f]{6}\z/
+
+          proj = Tasku::Project.find_or_create(name: name)
+          next if proj.colour == colour
+
+          proj.update(colour: colour)
+          projects_pulled += 1
+        end
+
         Tasku::Config.last_synced_at = synced_at ? Time.parse(synced_at).utc : Time.now.utc
 
         puts ""
@@ -268,6 +327,7 @@ module Tasku
         puts "  #{pastel.bold(local_tasks.count.to_s)} #{local_tasks.count == 1 ? "task" : "tasks"} pushed to cloud."
         puts "  #{pastel.bold(created.to_s)} #{created == 1 ? "task" : "tasks"} pulled from cloud."  if created > 0
         puts "  #{pastel.bold(updated.to_s)} #{updated == 1 ? "task" : "tasks"} updated from cloud." if updated > 0
+        puts "  #{pastel.bold(projects_pulled.to_s)} #{projects_pulled == 1 ? "project colour" : "project colours"} updated from cloud." if projects_pulled > 0
         if conflicts > 0
           puts "  #{pastel.yellow("⚠")}  #{conflicts} #{conflicts == 1 ? "conflict" : "conflicts"} — visit #{pastel.bold(url)} to resolve."
         end
@@ -302,6 +362,9 @@ module Tasku
       desc "config SUBCOMMAND", "Manage user preferences"
       subcommand "config", ConfigApp
 
+      desc "git SUBCOMMAND", "Manage git repo links for auto branch checkout"
+      subcommand "git", GitApp
+
       desc "cloud SUBCOMMAND", "Sync tasks with Tasku Cloud"
       subcommand "cloud", CloudApp
 
@@ -470,7 +533,15 @@ module Tasku
           "col_due_min"      => Config.get("col_due_min")
         }
         if ENV["MADO"] == "1"
-          Tasku::TUI::MadoList.new(tasks, colour_map: Project.colour_map, bar: bar, cols_cfg: cols_cfg, project: options[:project]).run
+          list_cmd = "tasku list"
+          list_cmd += " --status #{Shellwords.shellescape(options[:status])}"     if options[:status]
+          list_cmd += " --priority #{Shellwords.shellescape(options[:priority])}" if options[:priority]
+          list_cmd += " --project #{Shellwords.shellescape(options[:project])}"   if options[:project]
+          list_cmd += " --category #{Shellwords.shellescape(options[:category])}" if options[:category]
+          list_cmd += " --today"    if options[:today]
+          list_cmd += " --tomorrow" if options[:tomorrow]
+          list_cmd += " --overdue"  if options[:overdue]
+          Tasku::TUI::MadoList.new(tasks, colour_map: Project.colour_map, bar: bar, cols_cfg: cols_cfg, project: options[:project], list_cmd: list_cmd).run
         else
           terminal.render_list(tasks, colour_map: Project.colour_map, spacing: Config.get("list_spacing"), bar: bar, cols_cfg: cols_cfg)
         end
@@ -537,6 +608,7 @@ module Tasku
 
         task.update(attrs)
         terminal.render_updated(task)
+        auto_checkout_branch(task, attrs) if attrs[:status] == "in_progress"
       rescue Sequel::ValidationFailed => e
         abort pastel.red("Validation error: #{e.message}")
       end
@@ -672,7 +744,7 @@ module Tasku
           category = nil if category&.empty?
 
           priority = prompt.select("Priority?", %w[none low medium high urgent], default: 1)
-          status = prompt.select("Status?", %w[backlog todo in_progress], default: 2)
+          status = prompt.select("Status?", Task::VALID_STATUSES, default: 2)
 
           start_day = prompt.ask("Start date (YYYY-MM-DD, optional):", default: "")
           start_day = nil if start_day&.empty?
@@ -860,6 +932,34 @@ module Tasku
           "\e[1;38;2;#{r};#{g};#{b}m#{text}\e[0m"
         end
 
+        def auto_checkout_branch(task, attrs)
+          return unless task.code && !task.code.empty?
+
+          repo_path = Tasku::Config.git_path_for(task.code)
+          return unless repo_path
+
+          slug = task.name.downcase.gsub(/[^a-z0-9]+/, "-").gsub(/\A-|-\z/, "")
+          branch = "#{task.code}-#{task.id}-#{slug}"
+
+          # Check if the branch already exists locally.
+          existing = `git -C #{repo_path.shellescape} branch --list #{branch.shellescape} 2>/dev/null`.strip
+          if existing.empty?
+            result = system("git", "-C", repo_path, "checkout", "-b", branch, out: :close, err: :close)
+            if result
+              puts pastel.dim("  git: created and switched to branch #{branch}")
+            else
+              puts pastel.yellow("  git: could not create branch #{branch} — is the working tree clean?")
+            end
+          else
+            result = system("git", "-C", repo_path, "checkout", branch, out: :close, err: :close)
+            if result
+              puts pastel.dim("  git: switched to existing branch #{branch}")
+            else
+              puts pastel.yellow("  git: could not switch to branch #{branch}")
+            end
+          end
+        end
+
         def colour_cell(col, padded_val, row)
           case col.to_s
           when "priority"

data/lib/tasku/config.rb

@@ -104,6 +104,40 @@ module Tasku
       !cloud_token.nil?
     end
 
+    # ── Git project paths ──────────────────────────────────────────────────
+    # Maps a 3-char project code (e.g. "TAS") to an absolute repo path.
+    # Stored under the "git_projects" key in config.json.
+
+    def self.git_path_for(code)
+      git_projects[code.to_s.upcase]
+    end
+
+    def self.set_git_path(code, path)
+      current = all
+      current["git_projects"] ||= {}
+      current["git_projects"][code.to_s.upcase] = File.expand_path(path)
+      FileUtils.mkdir_p(File.dirname(CONFIG_PATH))
+      File.write(CONFIG_PATH, JSON.pretty_generate(current))
+    end
+
+    def self.unset_git_path(code)
+      current = all
+      return unless current["git_projects"]
+
+      current["git_projects"].delete(code.to_s.upcase)
+      current.delete("git_projects") if current["git_projects"].empty?
+      File.write(CONFIG_PATH, JSON.pretty_generate(current))
+    end
+
+    def self.all_git_projects
+      git_projects
+    end
+
+    def self.git_projects
+      all["git_projects"] || {}
+    end
+    private_class_method :git_projects
+
     def self.get(key)
       all[key] || VALID_KEYS.dig(key, :default)
     end

data/lib/tasku/tui/mado_list.rb

@@ -13,15 +13,16 @@ module Tasku
     # button handlers can inject it into commands like `tasku edit <id>`.
     class MadoList
       HINT = "  ↑↓ navigate   a add   e/↵ edit   d delete   s stats   q quit"
+      HINT_CONFIRM = "  Delete task? Press y to confirm, any other key to cancel"
 
-      def initialize(tasks, colour_map: {}, bar: {}, cols_cfg: {}, project: nil)
+      def initialize(tasks, colour_map: {}, bar: {}, cols_cfg: {}, project: nil, list_cmd: nil)
         @tasks      = tasks
         @cursor     = 0
         @pastel     = Pastel.new
         @sel_file   = ENV["TASKU_SEL_FILE"]
         @running    = true
         @inline_cmd = nil
-        @list_cmd   = project ? "tasku list --project #{Shellwords.shellescape(project)}" : "tasku list"
+        @list_cmd   = list_cmd || (project ? "tasku list --project #{Shellwords.shellescape(project)}" : "tasku list")
 
         # Pre-render row content once so key-press redraws are cheap.
         table      = Output::Terminal.new.build_mado_rows(tasks, colour_map, bar, cols_cfg)
@@ -156,7 +157,7 @@ module Tasku
           run_command("tasku edit #{@tasks[@cursor].id} -i")
         when :delete
           return if @tasks.empty?
-          run_command("tasku delete #{@tasks[@cursor].id} -f")
+          confirm_delete
         when :stats
           run_and_show("tasku stats")
         when :inline_exec
@@ -164,6 +165,18 @@ module Tasku
           MadoLog.log("inline_exec cmd=#{cmd.inspect}")
           if cmd == "SQL"
             run_sql
+          elsif cmd.start_with?("tasku list")
+            # exec directly so the new MadoList initialises with the correct
+            # @list_cmd (project filter, status filter, etc.).  Using
+            # run_command would nest a subprocess and then re-exec @list_cmd
+            # (no filter) when the subprocess exits — losing the filter.
+            # Must restore terminal + cooked mode before exec so the new
+            # process doesn't inherit raw-mode terminal attributes.
+            @running = false
+            restore_terminal
+            $stdin.cooked!
+            MadoLog.log("inline_exec tasku list → exec #{cmd.inspect}")
+            exec(*Shellwords.shellsplit(cmd))
           else
             run_command(cmd)
           end
@@ -177,9 +190,9 @@ module Tasku
         @running = false
         restore_terminal
         $stdin.cooked!
-        system(cmd)
+        system(*Shellwords.shellsplit(cmd))
         MadoLog.log("run_command finished cmd=#{cmd.inspect} → exec #{@list_cmd}")
-        exec(@list_cmd)
+        exec(*Shellwords.shellsplit(@list_cmd))
       end
 
       # Run a non-interactive display command, wait for any keypress via
@@ -190,12 +203,12 @@ module Tasku
         @running = false
         restore_terminal
         $stdin.cooked!
-        system(cmd)
+        system(*Shellwords.shellsplit(cmd))
         $stdout.print "\r\n\e[2m  Press any key to return to list…\e[0m\r\n"
         $stdout.flush
         $stdin.getch
         MadoLog.log("run_and_show keypress received → exec #{@list_cmd}")
-        exec(@list_cmd)
+        exec(*Shellwords.shellsplit(@list_cmd))
       end
 
       # Show a SQL prompt, run the query, wait for keypress, then re-exec list.
@@ -215,7 +228,24 @@ module Tasku
           $stdin.getch
         end
         MadoLog.log("run_sql done → exec #{@list_cmd}")
-        exec(@list_cmd)
+        exec(*Shellwords.shellsplit(@list_cmd))
+      end
+
+      def confirm_delete
+        task = @tasks[@cursor]
+        name_preview = task.name.length > 40 ? "#{task.name[0, 39]}…" : task.name
+        border = @pastel.dim("  " + "─" * (@row_width + 4))
+        $stdout.print "\r\n#{border}\r\n"
+        $stdout.print "  #{@pastel.yellow("Delete: ")}#{name_preview}\r\n"
+        $stdout.print "#{border}\r\n"
+        $stdout.print "#{@pastel.dim(HINT_CONFIRM)}\r\n"
+        $stdout.flush
+        byte = $stdin.getbyte
+        if byte == 0x79 || byte == 0x59  # y / Y
+          run_command("tasku delete #{task.id} -f")
+        else
+          full_render
+        end
       end
 
       def restore_terminal

data/lib/tasku/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tasku
-  VERSION = "0.4.0"
+  VERSION = "0.4.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tasku
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - Tom Dringer
@@ -86,6 +86,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - exe/tasku
 - lib/tasku.rb
 - lib/tasku/cli.rb
@@ -103,7 +104,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/tomdringer/tasku
   source_code_uri: https://github.com/tomdringer/tasku
-  changelog_uri: https://github.com/tomdringer/tasku/releases
+  changelog_uri: https://github.com/tomdringer/tasku/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib