tasku 0.2.2 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '092769965a41ae651877809552cd6275d60c15793f338d5f185324e86e6bc118'
-  data.tar.gz: df005e9ccf3967a90320a4fe7d0acf46b03a92bac7986685720e01b305564972
+  metadata.gz: d01584cb8583cbcb7623bf5ba3487efa0f9ae428db88b5cd3cf2e6d90393381d
+  data.tar.gz: cb79bddf2a6c141a23ee9f0dcf52169767dfb34ab9e86870afeba7d7dc158d33
 SHA512:
-  metadata.gz: 7d743c6742d162b3efd017fb460b69f7a0c649d916f6d552790ebafdf998e83ad4c8b1db52ae5d2f8901ed6c7eea8f6423c05009738646a20afb698d95fbfc05
-  data.tar.gz: 77543fdc9c23db135e3d5da61bbb7ff986cbfffc380967b6d142bd1c842c69fdd3394538ff6f50987caba556270e937deef815537ba82889177c83a6e19b7865
+  metadata.gz: 92d51c1a51d85b185ba14e982ccc5eb8a5bbe7bb6f04f74c5dac3d6b0ae0b916174e7afbc09a3230f9525a08650fd8b228a2e4724c20c7f5bdb3a1de71db5ba0
+  data.tar.gz: de7d23c5f2032c57ded24ff9d8920001ba7e650538d6a58d0e08d9647d538ee67aa0588d98e29b5986c080ebfe798a5557d02fb100ac53904db29c378fa19df0

data/exe/tasku

@@ -3,4 +3,8 @@
 
 require "tasku"
 
-Tasku::CLI::App.start(ARGV)
+if ARGV.empty?
+  Tasku::CLI::App.start(["help"])
+else
+  Tasku::CLI::App.start(ARGV)
+end

data/lib/tasku/cli.rb

@@ -13,7 +13,45 @@ module Tasku
 
     TAGLINE = "\u30BF\u30B9\u30AF\u30EA\u30B9\u30C8 \u2014 terminal task manager"
 
+    class ConfigApp < Thor
+      desc "list", "Show all preferences and their current values"
+      def list
+        pastel = Pastel.new
+        puts ""
+        Tasku::Config::VALID_KEYS.each do |key, meta|
+          current = Tasku::Config.get(key)
+          options_str = meta[:values].map { |v| v == current ? pastel.bold(pastel.green(v)) : pastel.dim(v) }.join(", ")
+          puts "  #{pastel.bold(key.ljust(20))} #{options_str}  #{pastel.dim("— #{meta[:description]}")}"
+        end
+        puts ""
+      end
+
+      desc "set KEY VALUE", "Set a preference value"
+      def set(key, value)
+        pastel = Pastel.new
+        meta = Tasku::Config::VALID_KEYS[key]
+        abort pastel.red("Unknown preference '#{key}'. Run `tasku config list` to see available keys.") unless meta
+        unless meta[:values].include?(value)
+          abort pastel.red("Invalid value '#{value}' for '#{key}'. Valid: #{meta[:values].join(', ')}")
+        end
+        Tasku::Config.set(key, value)
+        puts pastel.green("  ✓ #{key} set to '#{value}'.")
+      end
+
+      desc "get KEY", "Get the current value of a preference"
+      def get(key)
+        pastel = Pastel.new
+        meta = Tasku::Config::VALID_KEYS[key]
+        abort pastel.red("Unknown preference '#{key}'. Run `tasku config list` to see available keys.") unless meta
+        puts "  #{key}: #{pastel.bold(Tasku::Config.get(key))}"
+      end
+    end
+
     class App < Thor
+      def self.exit_on_failure?
+        true
+      end
+
       def self.start(args = ARGV, **opts)
         sql_index = args.index("--sql")
         if sql_index
@@ -33,6 +71,19 @@ module Tasku
 
       class_option :db, type: :string, desc: "Path to SQLite database (default: ~/.tasku/tasks.db)", hide: true
 
+      desc "config SUBCOMMAND", "Manage user preferences"
+      subcommand "config", ConfigApp
+
+      def help(*args)
+        if args.empty?
+          puts ""
+          puts pastel.bold(LOGO)
+          puts "  #{pastel.bold(TAGLINE)}"
+          puts ""
+        end
+        super
+      end
+
       desc "sql QUERY", "Run a raw SQL query against the database"
       def sql(query)
         if query.strip.upcase.match?(/\A(SELECT|PRAGMA|EXPLAIN)/)
@@ -123,7 +174,7 @@ module Tasku
       option :category, type: :string,  desc: "Filter by category"
       option :tags,     type: :string,  desc: "Filter by tag (comma-separated)"
       option :overdue,  type: :boolean, desc: "Show only overdue tasks"
-      option :sort,     type: :string,  desc: "Sort by: name, priority, due, status, created"
+      option :sort,     type: :string,  desc: "Sort by: id, name, priority, due, status, created"
       option :order,    type: :string,  desc: "Order: asc, desc", default: "asc"
       def list
         dataset = Task.dataset
@@ -150,20 +201,22 @@ module Tasku
                    when "priority" then Sequel.case(Task::VALID_PRIORITIES.each_with_index.to_h, 999, :priority)
                    when "due"      then :due_day
                    when "status"   then Sequel.case(Task::VALID_STATUSES.each_with_index.to_h, 999, :status)
-                   else :created_at
+                   when "created"  then :created_at
+                   else :id
                    end
 
         order = options[:order] == "desc" ? Sequel.desc(sort_col) : Sequel.asc(sort_col)
         dataset = dataset.order(order)
 
         tasks = dataset.all
-        terminal.render_list(tasks)
+        bar = { "bar_project" => Config.get("bar_project"), "bar_priority" => Config.get("bar_priority"), "bar_status" => Config.get("bar_status") }
+        terminal.render_list(tasks, colour_map: Project.colour_map, spacing: Config.get("list_spacing"), bar: bar)
       end
 
       desc "show ID", "Show task details"
       def show(id)
         task = find_task(id)
-        terminal.render_show(task)
+        terminal.render_show(task, colour_map: Project.colour_map)
       end
 
       desc "edit ID", "Edit a task"
@@ -241,25 +294,48 @@ module Tasku
       desc "stats", "Show task statistics"
       def stats
         tasks = Task.dataset.all
-        terminal.render_stats(tasks) if tasks
+        terminal.render_stats(tasks, colour_map: Project.colour_map) if tasks
       end
 
       desc "projects", "List all projects"
       def projects
-        projects = Task.dataset.select(:project).where(Sequel.~(project: nil)).distinct.order(:project).map(:project)
-        if projects.empty?
+        project_names = Task.dataset.select(:project).where(Sequel.~(project: nil)).distinct.order(:project).map(:project)
+        if project_names.empty?
           puts pastel.yellow("  No projects found.")
           return
         end
 
+        colour_map = Project.colour_map
         puts ""
-        projects.each do |p|
+        project_names.each do |p|
           count = Task.where(project: p).count
-          puts "  #{pastel.bold(p)} #{pastel.dim("(#{count} task(s))")}"
+          colour = colour_map[p]
+          swatch = colour ? "#{hex_colour_str("█", colour)} " : "  "
+          name_str = colour ? hex_bold_str(p, colour) : pastel.bold(p)
+          puts "  #{swatch}#{name_str} #{pastel.dim("(#{count} task(s))")}"
         end
         puts ""
       end
 
+      desc "colour PROJECT HEX", "Set a project's display colour (e.g. #FF5733). Omit HEX to clear."
+      def colour(project, hex = nil)
+        if hex.nil?
+          proj = Project[project]
+          if proj
+            proj.update(colour: nil)
+            puts pastel.green("  Colour cleared for project '#{project}'.")
+          else
+            puts pastel.yellow("  No colour set for project '#{project}'.")
+          end
+          return
+        end
+
+        validated = validate_hex!(hex)
+        Project.find_or_create(name: project).update(colour: validated)
+        swatch = hex_colour_str("█", validated)
+        puts "  #{swatch} Colour #{pastel.bold(validated)} set for project '#{pastel.bold(project)}'."
+      end
+
       desc "categories", "List all categories"
       def categories
         categories = Task.dataset.select(:category).where(Sequel.~(category: nil)).distinct.order(:category).map(:category)
@@ -428,6 +504,24 @@ module Tasku
           "archived"    => :dim
         }.freeze
 
+        def validate_hex!(hex)
+          hex = hex.start_with?("#") ? hex : "##{hex}"
+          unless hex.match?(/\A#[0-9a-fA-F]{6}\z/)
+            abort pastel.red("Invalid hex colour '#{hex}'. Use format #RRGGBB.")
+          end
+          hex
+        end
+
+        def hex_colour_str(text, hex)
+          r, g, b = hex.delete("#").scan(/../).map { |c| c.to_i(16) }
+          "\e[38;2;#{r};#{g};#{b}m#{text}\e[0m"
+        end
+
+        def hex_bold_str(text, hex)
+          r, g, b = hex.delete("#").scan(/../).map { |c| c.to_i(16) }
+          "\e[1;38;2;#{r};#{g};#{b}m#{text}\e[0m"
+        end
+
         def colour_cell(col, padded_val, row)
           case col.to_s
           when "priority"

data/lib/tasku/config.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module Tasku
+  class Config
+    CONFIG_PATH = File.join(Dir.home, ".tasku", "config.json")
+
+    VALID_KEYS = {
+      "list_spacing" => {
+        values: %w[compact spacious],
+        default: "compact",
+        description: "Row spacing in task list"
+      },
+      "bar_project" => {
+        values: %w[on off],
+        default: "on",
+        description: "Show project colour segment in row bar"
+      },
+      "bar_priority" => {
+        values: %w[on off],
+        default: "on",
+        description: "Show priority colour segment in row bar"
+      },
+      "bar_status" => {
+        values: %w[on off],
+        default: "on",
+        description: "Show status colour segment in row bar"
+      }
+    }.freeze
+
+    def self.get(key)
+      all[key] || VALID_KEYS.dig(key, :default)
+    end
+
+    def self.set(key, value)
+      current = all
+      current[key] = value
+      FileUtils.mkdir_p(File.dirname(CONFIG_PATH))
+      File.write(CONFIG_PATH, JSON.pretty_generate(current))
+    end
+
+    def self.all
+      return {} unless File.exist?(CONFIG_PATH)
+
+      JSON.parse(File.read(CONFIG_PATH))
+    rescue JSON::ParserError
+      {}
+    end
+  end
+end

data/lib/tasku/database.rb

@@ -42,6 +42,11 @@ module Tasku
       if db.table_exists?(:tasks) && !db.schema(:tasks).map(&:first).include?(:code)
         db.alter_table(:tasks) { add_column :code, String }
       end
+
+      db.create_table? :projects do
+        String :name, primary_key: true
+        String :colour
+      end
     end
   end
 end

data/lib/tasku/output/terminal.rb

@@ -5,6 +5,23 @@ require "pastel"
 module Tasku
   module Output
     class Terminal
+      PRIORITY_HEX = {
+        "none"   => "#6B7280",
+        "low"    => "#06B6D4",
+        "medium" => "#EAB308",
+        "high"   => "#EF4444",
+        "urgent" => "#E879F9"
+      }.freeze
+
+      STATUS_HEX = {
+        "backlog"     => "#6B7280",
+        "todo"        => "#3B82F6",
+        "in_progress" => "#EAB308",
+        "done"        => "#22C55E",
+        "cancelled"   => "#EF4444",
+        "archived"    => "#6B7280"
+      }.freeze
+
       PRIORITY_STYLES = {
         "none"   => { color: :dim,    symbol: " " },
         "low"    => { color: :cyan,   symbol: "↓" },
@@ -26,16 +43,16 @@ module Tasku
 
       def initialize
         @pastel = Pastel.new
-        @term_width = [terminal_width, 80].min
+        @term_width = terminal_width
       end
 
-      def render_list(tasks)
+      def render_list(tasks, colour_map: {}, spacing: "compact", bar: {})
         if tasks.empty?
           puts @pastel.yellow("  No tasks found.")
           return
         end
 
-        rows = tasks.map { |t| build_columns(t) }
+        rows = tasks.map { |t| build_columns(t, colour_map, bar) }
         col_widths = compute_widths(rows)
         total = col_widths.sum + (COL_SEP.length * (col_widths.length - 1))
 
@@ -44,12 +61,13 @@ module Tasku
         rows.each do |cols|
           line = cols.each_with_index.map { |c, i| c.to_s.ljust(col_widths[i]) }.join(COL_SEP)
           puts "  #{line}"
+          puts "" if spacing == "spacious"
         end
         puts @pastel.dim("  #{"─" * total}")
         puts @pastel.dim("  #{tasks.length} task(s) found")
       end
 
-      def render_show(task)
+      def render_show(task, colour_map: {})
         puts ""
         puts @pastel.bold("  Task ##{task.id}")
         puts @pastel.dim("  #{"─" * 60}")
@@ -57,7 +75,7 @@ module Tasku
         fields = [
           ["Name",       @pastel.bold(task.name)],
           ["Description", task.description ? @pastel.dim(task.description) : @pastel.dim("—")],
-          ["Project",    task.project || @pastel.dim("—")],
+          ["Project",    project_str(task.project, colour_map)],
           ["Category",   task.category || @pastel.dim("—")],
           ["Priority",   priority_tag(task.priority)],
           ["Status",     status_tag(task.status)],
@@ -90,7 +108,7 @@ module Tasku
         puts @pastel.red("  ✗ Task ##{task.id} deleted") + " — #{@pastel.bold(task.name)}"
       end
 
-      def render_stats(tasks)
+      def render_stats(tasks, colour_map: {})
         puts ""
         puts @pastel.bold("  Task Statistics")
         puts @pastel.dim("  #{"─" * 60}")
@@ -98,12 +116,13 @@ module Tasku
         total = tasks.length
         by_status = tasks.group_by(&:status).transform_values(&:length)
         by_priority = tasks.group_by(&:priority).transform_values(&:length)
+        by_project = tasks.group_by(&:project).transform_values(&:length)
         overdue = tasks.count(&:overdue?)
-        projects = tasks.map(&:project).compact.uniq.length
+        project_count = tasks.map(&:project).compact.uniq.length
 
         puts "  #{@pastel.dim("Total tasks:".ljust(20))} #{total}"
         puts "  #{@pastel.dim("Overdue:".ljust(20))} #{overdue.positive? ? @pastel.red(overdue.to_s) : @pastel.green("0")}"
-        puts "  #{@pastel.dim("Projects:".ljust(20))} #{projects}"
+        puts "  #{@pastel.dim("Projects:".ljust(20))} #{project_count}"
         puts ""
 
         puts "  #{@pastel.dim("By Status:")}"
@@ -122,16 +141,42 @@ module Tasku
 
           puts "    #{priority_tag(p)} #{@pastel.send(PRIORITY_STYLES.dig(p, :color) || :dim, count.to_s.rjust(3))}"
         end
+
+        puts ""
+        puts "  #{@pastel.dim("By Project:")}"
+        by_project.sort_by { |_, count| -count }.each do |name, count|
+          label = name || @pastel.dim("(none)")
+          coloured_name = name && colour_map[name] ? hex_colour_str(name, colour_map[name]) : label
+          padding = " " * [20 - strip_ansi(coloured_name).length, 0].max
+          puts "    #{coloured_name}#{padding} #{@pastel.dim(count.to_s.rjust(3))}"
+        end
         puts ""
       end
 
       private
 
-      def build_columns(task)
+      def build_columns(task, colour_map = {}, bar = {})
         id_val = task.code && !task.code.empty? ? "#{task.code}-#{task.id}" : task.id.to_s
-        id_str = @pastel.dim(id_val)
+
+        segments = []
+        if bar["bar_project"] != "off"
+          proj_colour = task.project && colour_map[task.project]
+          segments << (proj_colour ? hex_colour_str("█", proj_colour) : @pastel.dim("█"))
+        end
+        if bar["bar_priority"] != "off"
+          segments << hex_colour_str("█", PRIORITY_HEX[task.priority] || PRIORITY_HEX["none"])
+        end
+        if bar["bar_status"] != "off"
+          segments << hex_colour_str("█", STATUS_HEX[task.status] || STATUS_HEX["backlog"])
+        end
+
+        id_str = if segments.any?
+                   "#{segments.join} #{@pastel.dim(id_val)}"
+                 else
+                   @pastel.dim(id_val)
+                 end
         name_str = @pastel.bold(task.name)
-        proj_str = task.project || @pastel.dim("—")
+        proj_str = project_str(task.project, colour_map)
         prio_str = priority_tag(task.priority)
         stat_str = status_tag(task.status)
         due_str = due_cell(task)
@@ -181,6 +226,21 @@ module Tasku
         @pastel.send(style[:color], "#{style[:symbol]} #{label}")
       end
 
+      def hex_colour_str(text, hex)
+        r, g, b = hex.delete("#").scan(/../).map { |c| c.to_i(16) }
+        "\e[38;2;#{r};#{g};#{b}m#{text}\e[0m"
+      end
+
+      def project_str(project, colour_map)
+        return @pastel.dim("—") unless project
+
+        colour = colour_map[project]
+        return project unless colour
+
+        r, g, b = colour.delete("#").scan(/../).map { |c| c.to_i(16) }
+        "\e[38;2;#{r};#{g};#{b}m#{project}\e[0m"
+      end
+
       def due_cell(task)
         return @pastel.dim("—") unless task.due_day
 

data/lib/tasku/project.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "database"
+
+module Tasku
+  class Project < Sequel::Model(:projects)
+    unrestrict_primary_key
+
+    def self.colour_map
+      all.each_with_object({}) { |p, h| h[p.name] = p.colour }
+    end
+  end
+end

data/lib/tasku/version.rb

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

data/lib/tasku.rb

@@ -8,6 +8,12 @@ require_relative "tasku/version"
 require_relative "tasku/database"
 Tasku::Database.connect
 require_relative "tasku/task"
+require_relative "tasku/project"
+require_relative "tasku/config"
 require_relative "tasku/output/terminal"
 require_relative "tasku/cli"
-require_relative "tasku/tui/app"
+begin
+  require_relative "tasku/tui/app"
+rescue LoadError
+  # TUI not available in this build
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tasku
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.1
 platform: ruby
 authors:
 - Tom Dringer
 bindir: exe
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -89,8 +89,10 @@ files:
 - exe/tasku
 - lib/tasku.rb
 - lib/tasku/cli.rb
+- lib/tasku/config.rb
 - lib/tasku/database.rb
 - lib/tasku/output/terminal.rb
+- lib/tasku/project.rb
 - lib/tasku/task.rb
 - lib/tasku/version.rb
 homepage: https://github.com/tomdringer/tasku