intent 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86c9e5d7f4f81b1db6abe7c6fbd2ec7daebbfef06abaa05e3129697743648e63
-  data.tar.gz: ca5a9c91a8ee077bc018c0b5a2251d6e84dfbc4ab2ce371a1fff96dfc65596bc
+  metadata.gz: a80e9d9082642b1f2325b40629ff95ffb096cdba644d0f2d5aa2af25541c2d2b
+  data.tar.gz: 90ed06f5afbf84636fbeb70e6fab66a4868dc0d485b751178b2ff31568315237
 SHA512:
-  metadata.gz: de2d74dc9068848a13f5b85d6fd58aefb0381d908e9ff7e2f0d2d81c688afd715dc7bc3d50b584650c3acbc5596cb4ebcd010a5c3b37de4a4ea52f296a3a2ed1
-  data.tar.gz: f8b7273cb674c0cd9336a1d3acac3cc88a96e31d2a1cf9736ddf03f9d1c56bd5b8aa2ab7112c62655283b78a40d99f2ae70679cb101e3e02f509a66741c05834
+  metadata.gz: a4a23b8d4882af953e2d330c26388c91bb86513c1881192952998f6f74b5f49b682f4b609566ea18b0b6f0ad7517020ac15ccc22ce8756edc001ac5fc25c455b
+  data.tar.gz: cfc14324613fc505a6ec0a591e73f667dd3360b4ec1d8ee7f05d86813fcbaf5e645f12b917579adc6b046223dbc251f665f65b0cd70087dac39d59cc7adfdccf

data/.gitignore

@@ -7,4 +7,6 @@
 /pkg/
 /spec/reports/
 /tmp/
+*.gem
 NOTES.md
+.DS_Store

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Mark Rickerby
+Copyright (c) 2016-2024 Mark Rickerby <https://maetl.net>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -0,0 +1,23 @@
+# Intent
+
+Automation engine with todo.txt
+
+This tool is mired deep in the obscurity and pedantry of the text-based computing culture that originated in the 1970s and still continues today. You probably don’t want to use this.
+
+## Installation
+
+```
+gem install intent
+```
+
+## Usage
+
+```
+intent help
+```
+
+## Copyright & License
+
+Copyright 2024 Mark Rickerby <https://maetl.net>.
+
+All documentation and modelling concepts are **CC BY-NC**. Source code and command line tools are MIT.

data/bin/{review → intent}

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-
 path = __FILE__
 while File.symlink?(path)
   path = File.expand_path(File.readlink(path), File.dirname(path))
@@ -8,4 +7,4 @@ $:.unshift(File.join(File.dirname(File.expand_path(path)), '..', 'lib'))
 
 require 'intent'
 
-Intent::Review::Manager.run(ARGV.dup)
+Intent::Dispatcher.exec_command(:intent, ARGV.dup)

data/bin/inventory

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+path = __FILE__
+
+while File.symlink?(path)
+  path = File.expand_path(File.readlink(path), File.dirname(path))
+end
+
+$:.unshift(File.join(File.dirname(File.expand_path(path)), '..', 'lib'))
+
+require 'intent'
+
+Intent::Dispatcher.exec_command(:inventory, ARGV.dup)

data/bin/projects

@@ -8,4 +8,4 @@ $:.unshift(File.join(File.dirname(File.expand_path(path)), '..', 'lib'))
 
 require 'intent'
 
-Intent::Projects::Manager.run(ARGV.dup)
+Intent::Dispatcher.exec_command(:projects, ARGV.dup)

data/bin/todo

@@ -8,4 +8,4 @@ $:.unshift(File.join(File.dirname(File.expand_path(path)), '..', 'lib'))
 
 require 'intent'
 
-Intent::Todo::Manager.run(ARGV.dup)
+Intent::Dispatcher.exec_command(:todo, ARGV.dup)

data/intent.gemspec

@@ -20,9 +20,18 @@ Gem::Specification.new do |spec|
 
   spec.add_runtime_dependency "todo-txt", "~> 0.12"
   spec.add_runtime_dependency "pastel", "~> 0.8"
-  spec.add_runtime_dependency "git", "~> 1.9.1"
+  spec.add_runtime_dependency "git", "~> 1.19.1"
   spec.add_runtime_dependency "terminal-notifier", "~> 2.0"
   spec.add_runtime_dependency "ghost", "~> 1.0.0"
+  spec.add_runtime_dependency "unicode_plot", "0.0.5"
+  spec.add_runtime_dependency "kdl", "1.0.3"
+  spec.add_runtime_dependency "sorted_set", "1.0.3"
+  spec.add_runtime_dependency "strings-ansi", "0.2.0"
+  spec.add_runtime_dependency "bibtex-ruby", "6.1.0"
+  spec.add_runtime_dependency "tty-prompt", "~> 0.23.1"
+  spec.add_runtime_dependency "tty-table", "~> 0.12.0"
+  spec.add_runtime_dependency "tty-tree", "~> 0.4.0"
+  spec.add_runtime_dependency "nanoid", "~> 2.0.0"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "rake"

data/lib/gem_ext/todo-txt.rb

@@ -10,13 +10,37 @@ class Todo::Task
       # Completed tasks are rendered with a strikethrough
       pastel.strikethrough(to_s)
     else
-      # Open tasks delegate to the custom formatting function
-      print_open_task(pastel)
+      [
+        pastel.red(print_priority),
+        pastel.yellow(created_on.to_s),
+        text,
+        pastel.bold.magenta(print_contexts),
+        pastel.bold.blue(print_projects),
+        pastel.bold.cyan(print_tags)
+      ].reject { |item| !item || item.nil? || item.empty? }.join(' ')
     end
   end
 
+  def highlight_as_project
+    return to_s unless STDOUT.tty?
+
+    pastel = Pastel.new
+    [
+      pastel.bold.cyan(print_projects),
+      pastel.red(print_project_context)
+    ].reject { |item| !item || item.nil? || item.empty? }.join(' ')
+  end
+
+  def text=(label)
+    @text = label
+  end
+
   private
 
+  def print_project_context
+    'active' if contexts.include?('@active')
+  end
+
   def print_open_task(pastel)
     [
       pastel.red(print_priority),

data/lib/intent/commands/base.rb

@@ -0,0 +1,40 @@
+module Intent
+  module Commands
+    class Base
+      attr_reader :identity
+      attr_reader :documents
+  
+      def initialize
+        @identity = strip_classname
+        @documents = ::Intent::Core::Documents.new
+      end
+  
+      def print_help(output)
+        output.puts(File.read(help_txt_path))
+      end
+
+      def generate_id
+        Nanoid.generate(size: 8, alphabet: ID_ALPHABET)
+      end
+
+      private
+  
+      T_CLASS_PREFIX = 'Intent::Commands::'
+  
+      ID_ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
+
+      def strip_classname
+        self.class.to_s.sub(T_CLASS_PREFIX, '').downcase
+      end
+  
+      def help_txt_path
+        # TODO: does this work on Windows?
+        "#{__dir__}/../text/#{identity}.help.txt"
+      end
+
+      def create_noun(type, label, tags)
+        Intent::Core::Noun.new(type, label, tags)
+      end
+    end
+  end
+end

data/lib/intent/commands/errors.rb

@@ -0,0 +1,7 @@
+module Intent
+  module Commands
+    module Errors
+      COMMAND_NOT_FOUND = "Command not found"
+    end
+  end
+end

data/lib/intent/commands/intent.rb

@@ -0,0 +1,9 @@
+module Intent
+  module Commands
+    class Intent
+      def run(args, output)
+        output.puts args
+      end
+    end
+  end
+end

data/lib/intent/commands/inventory.rb

@@ -0,0 +1,174 @@
+require 'tty-reader'
+
+module Intent
+  module Commands
+    class Inventory < Base
+      def run(args, output)
+        if args.empty?
+          print_help(output)
+        else
+          case args.first.to_sym
+          when :help
+            print_help(output)
+          when :list
+            tree = TTY::Tree.new(inventory_tree)
+            output.puts(tree.render)
+          when :add
+            noun = args[1].to_sym
+            case noun
+            when :folder then add_folder(args, output)
+            when :box then add_box(args, output)
+            when :stock then add_stock(args, output)
+            else
+              raise "Noun not found"
+            end
+          when :assign
+            noun = args[1].to_sym
+            case noun
+            when :folder then assign_folder(args, output)
+            when :box then assign_box(args, output)
+            end
+          end
+        end
+      end
+
+      private
+
+      def inventory_tree
+        pastel = Pastel.new
+        root = {}
+        documents.inventory.boxes.each do |box|
+          color_code = case box.tags[:id][0].downcase.to_sym
+          when :g then :green
+          when :y then :yellow
+          when :b then :blue
+          when :r then :red
+          else
+            :white
+          end
+          box_key = "#{pastel.decorate(box.tags[:id], :bold, color_code)} #{box.text}"
+          child_items = documents.inventory.items_in(box.tags[:id]).map do |item|
+            "#{pastel.decorate(item.tags[:id], :bold, color_code)} #{item.text}"
+          end
+          root[box_key] = child_items
+        end
+        root
+      end
+
+      def inventory_units_of(type)
+        documents.inventory.units_of(type).map do |unit|
+          [unit.text, unit.tags[:sku]]
+        end.to_h
+      end
+
+      def inventory_unassigned_folders
+        folder_types = documents.inventory.units_of(:folder)
+        documents.inventory.unassigned_folders.map do |folder|
+          unit_label = folder_types.find { |f| f.tags[:sku] == folder.tags[:sku] } 
+          ["#{folder.text} #{folder.tags[:id]} (#{unit_label.text})", folder.tags[:id]]
+        end.to_h
+      end
+
+      def inventory_unassigned_boxes
+        box_types = documents.inventory.units_of(:box)
+        documents.inventory.unassigned_boxes.map do |box|
+          unit_label = box_types.find { |f| f.tags[:sku] == box.tags[:sku] } 
+          ["#{box.text} #{box.tags[:id]} (#{unit_label.text})", box.tags[:id]]
+        end.to_h
+      end
+
+      def add_stock(args, output)
+        prompt = TTY::Prompt.new
+        type = prompt.select('type of stock:', [:folder, :box])
+        ref = self
+
+        unit = prompt.collect do
+          key(:sku).ask('sku:', default: ref.generate_id)
+          key(:label).ask('label:', default: "[Undocumented #{type.capitalize}]")
+          key(:qty).ask('quantity:', default: 1, convert: :int)
+        end
+
+        documents.inventory.add_unit!(unit[:label], type, unit[:sku])
+
+        unit[:qty].times do
+          label = "[Unlabelled #{type.capitalize}]"
+          documents.inventory.add_item!(label, ref.generate_id, type, unit[:sku])
+        end
+      end
+
+      def add_folder(args, output)
+        skus = inventory_units_of(:folder)
+        prompt = TTY::Prompt.new
+        ref = self
+        
+        item = prompt.collect do
+          key(:sku).select('sku:', skus, filter: true)
+          key(:id).ask('id:', default: ref.generate_id)
+          key(:label).ask('label:', default: '[Unlabelled Folder]')
+          key(:active).yes?('is active:')
+        end
+        
+        label = item[:active] ? "#{item[:label]} @active" : item[:label]
+
+        documents.inventory.add_folder!(label, item[:id], item[:sku])
+      end
+
+      def add_box(args, output)
+        skus = inventory_units_of(:box)
+        prompt = TTY::Prompt.new
+        ref = self
+        
+        item = prompt.collect do
+          key(:sku).select('sku:', skus, filter: true)
+          key(:id).ask('id:', default: ref.generate_id)
+          key(:label).ask('label:', default: '[Unlabelled Box]')
+        end
+        
+        # Repository write pattern
+        documents.inventory.add_box!(label, item[:id], item[:sku])
+
+        # Alternative design
+        # noun = create_noun(:box, label, tags)
+        # Add.invoke(:append, documents.inventory, noun)
+      end
+
+      def assign_folder(args, output)
+        projects = documents.projects.all_tokens
+        folders = inventory_unassigned_folders
+        prompt = TTY::Prompt.new
+
+        folder_id = prompt.select('folder:', folders)
+        folder = documents.inventory.folder_by_id(folder_id)
+        
+        details = prompt.collect do
+          key(:projects).multi_select('projects:', projects)
+          key(:label).ask('label:', default: folder.text)
+          # TODO: is active
+        end
+
+        folder.text = details[:label]
+        folder.projects.concat(details[:projects])
+        documents.inventory.save!
+      end
+
+      def assign_box(args, output)
+        projects = documents.projects.all_tokens
+        boxes = inventory_unassigned_boxes
+        prompt = TTY::Prompt.new
+
+        box_id = prompt.select('box:', boxes)
+        box = documents.inventory.box_by_id(box_id)
+        
+        details = prompt.collect do
+          key(:projects).multi_select('projects:', projects)
+          key(:label).ask('label:', default: box.text)
+          # TODO: is active
+        end
+
+        box.text = details[:label]
+        box.projects.concat(details[:projects])
+        documents.inventory.save!
+      end
+    end
+  end
+end

data/lib/intent/commands/projects.rb

@@ -0,0 +1,34 @@
+require 'readline'
+
+module Intent
+  module Commands
+    class Projects < Base
+      def run(args, output)
+        if args.empty?
+          print_help(output)
+        else
+          case args.first.to_sym
+          when :help
+            print_help(output)
+          when :list
+            documents.projects.all.each do |task|
+              output.puts task.highlight_as_project
+            end
+          when :add
+            add_project(args, output)
+          end
+        end
+      end
+
+      private
+
+      def add_project(args, output)
+        prompt = TTY::Prompt.new
+        name = prompt.ask('Project identifier: ')
+        name = name.downcase.gsub("_", "-").gsub(" ", "-").gsub(/[^0-9a-z\-]/i, '')
+        name = "+#{name}" unless name.start_with?('+')
+        output.puts name
+      end
+    end
+  end
+end

data/lib/intent/commands/todo.rb

@@ -0,0 +1,51 @@
+module Intent
+  module Commands
+    class Todo < Base
+      def run(args, output)
+        if args.empty?
+          print_help(output)
+        else
+          case args.first.to_sym
+          when :add then add_line(args, output)
+          when :list then list_draw(args, output)
+          when :focus then focus_draw(args, output)
+          else
+            raise "Verb not found"
+          end
+        end
+      end
+
+      private
+
+      def add_line(args, output)
+        reader = TTY::Reader.new
+        line = reader.read_line("task line: ")
+        documents.inbox.add_line!(line)
+      end
+
+      def focus_draw(args, output)
+        pastel = Pastel.new
+        documents.inbox.focused_projects.each do |project|
+          output.puts pastel.green(project)
+        end
+      end
+
+      def list_draw(args, output)
+        filtered_list = documents.inbox.all
+
+        unless args[1].nil?
+          case args[1][0]
+          when '@'
+            filtered_list = filtered_list.by_context(args[1]).by_not_done
+          when '+'
+            filtered_list = filtered_list.by_project(args[1])
+          end
+        end
+
+        filtered_list.by_not_done.each do |task|
+          output.puts task.to_s_highlighted
+        end
+      end
+    end
+  end
+end

data/lib/intent/commands.rb

@@ -0,0 +1,9 @@
+require 'intent/commands/base'
+require 'intent/commands/errors'
+require 'intent/commands/intent'
+require 'intent/commands/todo'
+require 'intent/commands/projects'
+#require 'intent/commands/project'
+#require 'intent/commands/ideas'
+#require 'intent/commands/idea'
+require 'intent/commands/inventory'

data/lib/intent/core.rb

@@ -0,0 +1,184 @@
+module Intent
+  module Env
+    def self.documents_dir
+      File.expand_path(ENV['INTENT_DOCUMENTS_DIR'] || "").to_s
+    end
+
+    def self.inbox_dir
+      ENV['INTENT_INBOX_DIR']
+    end
+
+    def self.assets_dir
+      ENV['INTENT_ARCHIVE_DIR']
+    end
+
+    def self.projects_dir
+      ENV['INTENT_PROJECTS_DIR']
+    end
+  end
+  
+  module Core
+    List = ::Todo::List
+    Record = ::Todo::Task
+
+    class Noun
+      def initialize(type, label, tags)
+        @type = type
+        @label = label
+        @props = lex_props(tags)
+        @tags = tags
+      end
+
+      private
+
+      def lex_props(tags)
+        p tags
+      end
+    end
+
+    class Projects
+      attr_reader :list
+
+      def initialize(db_path)
+        @list = List.new(db_path)
+      end
+
+      def all
+        list.by_not_done
+      end
+
+      def all_tokens
+        all.map { |project| project.projects.first }
+      end
+    end
+
+    class Inventory
+      attr_reader :list
+
+      def initialize(db_path)
+        @list = List.new(db_path)
+      end
+
+      def all
+        list.by_not_done
+      end
+
+      def folder_by_id(id)
+        all.find { |i| i.tags[:is] == 'folder' && i.tags[:id] == id }
+      end
+
+      def folders
+        all.filter { |i| i.tags[:is] == 'folder' }
+      end
+
+      def items_in(id)
+        all.filter { |i| i.tags[:in] == id }
+      end
+
+      def unassigned_folders
+        all.filter { |i| i.tags[:is] == 'folder' && i.projects.empty? }
+      end
+
+      def assigned_folders
+        all.filter { |i| i.tags[:is] == 'folder' && i.projects.any? }
+      end
+
+      def boxes
+        all.filter { |i| i.tags[:is] == 'box' }
+      end
+
+      def unassigned_boxes
+        all.filter { |i| i.tags[:is] == 'box' && i.projects.empty? }
+      end
+
+      def assigned_boxes
+        all.filter { |i| i.tags[:is] == 'box' && i.projects.any? }
+      end
+
+      def units_of(noun)
+        all.filter { |i| i.tags[:is] == 'unit' && i.tags[:type] == noun.to_s }
+      end
+
+      def add_unit!(description, type, sku)
+        record = Record.new("#{Date.today} #{description} is:unit type:#{type} sku:#{sku}")
+        @list.append(record)
+        @list.save!
+      end
+
+      def add_item!(description, id, type, sku)
+        record = Record.new("#{Date.today} #{description} id:#{id} is:#{type} sku:#{sku}")
+        @list.append(record)
+        @list.save!
+      end
+
+      def add_folder!(description, id, sku)
+        add_item!(description, id, :folder, sku)
+      end
+
+      def add_box!(description, id, sku)
+        add_item!(description, id, :box, sku)
+      end
+
+      def save!
+        @list.save!
+      end
+    end
+
+    class Inbox
+      attr_reader :list
+
+      def initialize(db_path)
+        @list = List.new(db_path)
+      end
+
+      def all
+        @list.by_not_done
+      end
+
+      def focused
+        @list.by_context('@focus').by_not_done
+      end
+
+      def focused_projects
+        focused.map { |t| t.projects }.flatten.uniq
+      end
+
+      def add_line!(line)
+        record = Record.new("#{Date.today} #{line}")
+        @list.prepend(record)
+        @list.save!
+      end
+    end
+
+    class Documents
+      attr_reader :projects
+      attr_reader :inventory
+      attr_reader :inbox
+
+      def initialize
+        @projects = Projects.new("#{Intent::Env.documents_dir}/projects.txt")
+        @inventory = Inventory.new("#{Intent::Env.documents_dir}/inventory.txt")
+        @inbox = Inbox.new("#{Intent::Env.documents_dir}/todo.txt")
+      end
+    end
+  end
+  
+  class Dispatcher
+    def self.exec_command(command, args, output=STDOUT)
+      command = init_command(command).new
+      command.run(args, output)
+    end
+
+    def self.init_command(command)
+      case command
+      when :intent then return Commands::Intent
+      when :inventory then return Commands::Inventory
+      when :projects then return Commands::Projects
+      when :project then return Commands::Project
+      when :todo then return Commands::Todo
+      else
+        raise Commands::Errors::COMMAND_NOT_FOUND
+      end
+    end
+  end
+end

data/lib/intent/desktop.rb

@@ -0,0 +1,3 @@
+require 'pathname'
+
+require 'intent/desktop/commands'

data/lib/intent/projects.rb

@@ -1,4 +1,4 @@
 require 'pathname'
 
 require 'intent/projects/status'
-require 'intent/projects/manager'
+require 'intent/projects/commands'

data/lib/intent/review.rb

@@ -1 +1,10 @@
-require 'intent/review/manager'
+require 'tty-box'
+require 'tty-screen'
+require 'tty-reader'
+require 'tty-cursor'
+require 'tty-pager'
+require 'pastel'
+require 'todo-txt'
+require 'unicode_plot'
+
+require 'intent/review/commands'

data/lib/intent/text/inventory.help.txt

@@ -0,0 +1,6 @@
+usage: inventory <verb>
+
+Tools for managing a design archive and inventory ledger.
+
+inventory list       - list items in the inventory
+inventory add <noun> - add a new item to the inventory

data/lib/intent/text/project.help.txt

@@ -0,0 +1,7 @@
+usage: project <task>
+       intent project <task>
+
+Individual project tasks
+
+project init  - initializes a new project 
+project link  - links an existing project

data/lib/intent/text/projects.help.txt

@@ -0,0 +1,9 @@
+usage: projects <task>
+       intent projects <task>
+
+A set of tasks for managing a network of plain text projects.
+
+projects status  - DEPRECATED parses tracked file status in local project directories
+projects active  - lists currently active projects
+projects focus   - initialise interactive focus navigator
+projects sync    - stores synchronised commit of current changes to projects

data/lib/intent/text/todo.help.txt

@@ -0,0 +1,15 @@
+usage: todo <task>
+       intent todo <task>
+
+A set of tasks for managing a plain text todo list.
+
+todo list      - list all items in the list
+todo add       - add a new task to the list
+todo sample    - randomly select a priority task"
+todo projects  - list all project tags in the list
+todo contexts  - list all context tags in the list
+todo archive   - archive completed tasks in the nearest `done.txt`
+todo status    - show completion status for all projects
+todo sync      - synchronize local changes with remote git repo
+todo collect   - collect open browser tabs as items for later reading
+todo focus     - block distractions and start focusing

data/lib/intent/todo.rb

@@ -5,8 +5,10 @@ require 'fileutils'
 require 'logger'
 require 'git'
 require 'terminal-notifier'
+require 'sorted_set'
 require 'ghost'
-require 'intent/todo/manager'
+
+require 'intent/todo/commands'
 
 Todo.customize do |options|
   options.require_completed_on = false

data/lib/intent/verbs/add.rb

@@ -0,0 +1,21 @@
+module Intent
+  module Verbs
+    class Add
+      def initialize(documents)
+        @documents = documents
+      end
+
+      def invoke_prepend(scope, noun)
+        ledger = @documents.send(scope)
+        ledger.prepend(new Todo::Task(noun.todo_s))
+        ledger.save!
+      end
+
+      def invoke_append(ledger, noun)
+        ledger = @documents.send(scope)
+        ledger.append(new Todo::Task(noun.todo_s))
+        ledger.save!
+      end
+    end
+  end
+end

data/lib/intent/verbs/cite.rb

@@ -0,0 +1,14 @@
+module Intent
+  module Verbs
+    class Cite
+      attr_reader :documents
+      attr_reader :projects
+      attr_reader :contexts
+      attr_reader :bibliography
+
+      def initialize(documents)
+        @documents = documents
+      end
+    end
+  end
+end

data/lib/intent/verbs/install.rb

@@ -0,0 +1,20 @@
+module Intent
+  module Verbs
+    class Install
+      attr_reader :documents
+
+      def initialize(documents)
+        @documents = documents
+      end
+
+      def run
+        # Preprequisite checks
+        # return env_not_detected! unless @documents.env_detected?
+        # return already_installed! if @documents.install_detected?
+
+        
+      end
+
+    end
+  end
+end

data/lib/intent/verbs/review.rb

@@ -0,0 +1,131 @@
+module Intent
+  module Review
+    class Commands < Intent::CommandDispatcher
+      def run(args, output=STDOUT)
+        if args.empty?
+          launch_densityplot
+        else
+          print_help(output)
+        end
+      end
+
+      def launch_densityplot
+        UnicodePlot.barplot(data: {'calyx': 20, 'fictive': 50}, title: "Projects").render
+      end
+
+      def launch_ui_loop
+        list = Todo::List.new(ENV['TODO_TXT'])
+
+        box = TTY::Box.frame(
+          width: TTY::Screen.width,
+          height: TTY::Screen.height-1,
+          align: :center,
+          border: :thick,
+          style: {
+            fg: :bright_yellow,
+            border: {
+              fg: :white,
+            }
+          }
+        )
+        
+        focus_index = 0
+        
+        def truncate(str, width)
+          return str unless str.length >= width
+        
+          "#{str.slice(0, width-3)}..."
+        end
+        
+        def draw_card(top, item, focus)
+        
+          style = unless top == focus
+            { fg: :white, border: { fg: :white } }
+          else
+            { fg: :bright_white, border: { fg: :bright_magenta, bg: :black } }
+          end
+        
+          title = if top == focus
+            {bottom_right: "[x: close][enter: launch]"}
+          else
+            {}
+          end
+        
+          #pastel = Pastel.new
+          width = 90
+        
+          TTY::Box.frame(width: width, height: 4, left: 4, title: title, border: :thick, style: style) do
+            "\s#{truncate(item[:title], 88)}\n\s#{truncate(item[:href], 88)}"
+          end
+        end
+        
+        items_per_page = (TTY::Screen.height-1) / 4
+        
+        items = list.by_not_done.by_context("@reading").slice(0, items_per_page).map do |item|
+          { title: item.text, href: item.text }
+        end
+        
+        $cursor = TTY::Cursor
+        print $cursor.hide
+        
+        def draw_list(items, focus)
+          buffer = []
+          items.each_with_index do |item, i|
+            buffer << draw_card(i, item, focus)
+          end
+          result = buffer.join("")
+        
+          print $cursor.clear_screen + $cursor.move_to(0,0)
+          print result
+        end
+        
+        draw_list(items, focus_index)
+        
+        reader = TTY::Reader.new(interrupt: :exit)
+        
+        reader.on(:keyctrl_x, :keyescape) do
+          print $cursor.clear_screen + $cursor.move_to(0,0)
+          print $cursor.show
+          exit
+        end
+        
+        reader.on(:keytab, :keydown) do
+          if focus_index == items.count - 1
+            focus_index = 0
+          else
+            focus_index += 1
+          end
+          draw_list(items, focus_index)
+        end
+        
+        reader.on(:keyup) do
+          if focus_index == 0
+            focus_index = items.count - 1
+          else
+            focus_index -= 1
+          end
+          draw_list(items, focus_index)
+        end
+        
+        reader.on(:keypress) do |key|
+          if key.value == "x"
+            items.delete_at(focus_index)
+            focus_index -= 1 if focus_index >= items.count
+            draw_list(items, focus_index)
+          end
+        end
+        
+        reader.on(:keyenter) do
+          `chrome-cli open #{items[focus_index][:href]}`
+        end
+        
+        loop do
+          reader.read_line(echo: false)
+        end
+      end
+    end
+  end
+end
+
+
+

data/lib/intent/{todo/manager.rb → verbs/todo.rb}

@@ -4,10 +4,10 @@ module Intent
     List = ::Todo::List
     Syntax = ::Todo::Syntax
 
-    class Manager
+    class Commands < Intent::CommandDispatcher
       include Syntax
 
-      def self.run(args, output=STDOUT)
+      def run(args, output=STDOUT)
         if args.empty?
           print_help(output)
         else
@@ -183,20 +183,7 @@ module Intent
       end
 
       def self.print_help(output)
-        output.puts "usage: todo"
-        output.puts
-        output.puts "A set of tasks for managing a plain text todo list."
-        output.puts
-        output.puts "todo list       - list all items in the list"
-        output.puts "todo add        - add a new task to the list"
-        output.puts "todo sample     - randomly select a priority task"
-        output.puts "todo projects   - list all project tags in the list"
-        output.puts "todo contexts   - list all context tags in the list"
-        output.puts "todo archive    - archive completed tasks in the nearest `done.txt`"
-        output.puts "todo status     - show completion status for all projects"
-        output.puts "todo sync       - synchronize local changes with remote git repo"
-        output.puts "todo collect    - collect open browser tabs as items for later reading"
-        output.puts "todo focus      - block distractions and start focusing"
+        output.puts File.read('./todo.help.txt')
       end
     end
   end

data/lib/intent/version.rb

@@ -1,3 +1,3 @@
 module Intent
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

data/lib/intent.rb

@@ -1,4 +1,21 @@
-require 'intent/todo'
-require 'intent/review'
-require 'intent/projects'
+#require 'random'
+require 'todo-txt'
+require 'pastel'
+require 'tty-prompt'
+require 'tty-table'
+require 'tty-tree'
+require 'nanoid'
+require 'gem_ext/todo-txt'
+
+Todo.customize do |options|
+  options.require_completed_on = false
+end
+
 require 'intent/version'
+require 'intent/core'
+require 'intent/commands'
+# require 'intent/todo'
+# require 'intent/review'
+# require 'intent/projects'
+# require 'intent/desktop'
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: intent
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Mark Rickerby
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-11 00:00:00.000000000 Z
+date: 2024-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: todo-txt
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.1
+        version: 1.19.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.1
+        version: 1.19.1
 - !ruby/object:Gem::Dependency
   name: terminal-notifier
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +80,132 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: unicode_plot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+- !ruby/object:Gem::Dependency
+  name: kdl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+- !ruby/object:Gem::Dependency
+  name: sorted_set
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+- !ruby/object:Gem::Dependency
+  name: strings-ansi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: bibtex-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 6.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 6.1.0
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.23.1
+- !ruby/object:Gem::Dependency
+  name: tty-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+- !ruby/object:Gem::Dependency
+  name: tty-tree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: nanoid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -126,37 +252,54 @@ description:
 email:
 - me@maetl.net
 executables:
+- intent
+- inventory
 - project_doc
 - projects
 - projects_active
-- review
 - todo
 - todo_review
 extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
-- ".travis.yml"
 - Gemfile
 - LICENSE.txt
+- README.md
 - Rakefile
+- bin/intent
+- bin/inventory
 - bin/project_doc
 - bin/projects
 - bin/projects_active
-- bin/review
 - bin/todo
 - bin/todo_review
 - intent.gemspec
 - lib/gem_ext/todo-txt.rb
 - lib/intent.rb
+- lib/intent/commands.rb
+- lib/intent/commands/base.rb
+- lib/intent/commands/errors.rb
+- lib/intent/commands/intent.rb
+- lib/intent/commands/inventory.rb
+- lib/intent/commands/projects.rb
+- lib/intent/commands/todo.rb
+- lib/intent/core.rb
+- lib/intent/desktop.rb
 - lib/intent/projects.rb
-- lib/intent/projects/manager.rb
-- lib/intent/projects/status.rb
 - lib/intent/review.rb
-- lib/intent/review/manager.rb
+- lib/intent/text/inventory.help.txt
+- lib/intent/text/project.help.txt
+- lib/intent/text/projects.help.txt
+- lib/intent/text/todo.help.txt
 - lib/intent/todo.rb
-- lib/intent/todo/manager.rb
 - lib/intent/ui/ttyui.rb
+- lib/intent/verbs/add.rb
+- lib/intent/verbs/cite.rb
+- lib/intent/verbs/install.rb
+- lib/intent/verbs/review.rb
+- lib/intent/verbs/status.rb
+- lib/intent/verbs/todo.rb
 - lib/intent/version.rb
 homepage: http://maetl.net
 licenses:
@@ -177,7 +320,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Text-based project management

data/.travis.yml

@@ -1,4 +0,0 @@
-language: ruby
-rvm:
-  - 2.1.3
-before_install: gem install bundler -v 1.10.6

data/lib/intent/projects/manager.rb

@@ -1,20 +0,0 @@
-module Intent
-  module Projects
-    class Manager
-      def self.run(args, output=STDOUT)
-        if args.empty?
-          print_help(output)
-        else
-          case args.first.to_sym
-          when :status
-            Status.run(File.expand_path('~/Projects').to_s)
-          end
-        end
-      end
-
-      def self.print_help(output)
-        output.puts "usage: review"
-      end
-    end
-  end
-end

data/lib/intent/review/manager.rb

@@ -1,17 +0,0 @@
-module Intent
-  module Review
-    class Manager
-      def self.run(args, output=STDOUT)
-        if args.empty?
-          print_help(output)
-        else
-          puts args
-        end
-      end
-
-      def self.print_help(output)
-        output.puts "usage: review"
-      end
-    end
-  end
-end