intent 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a80e9d9082642b1f2325b40629ff95ffb096cdba644d0f2d5aa2af25541c2d2b
-  data.tar.gz: 90ed06f5afbf84636fbeb70e6fab66a4868dc0d485b751178b2ff31568315237
+  metadata.gz: eceb2c98af31fff1168ee446ea327a674c510e96d5bcfb948cae895e391a8399
+  data.tar.gz: a8225ec76a08ba859b7f8abff5729527e0426e51fff1757c26e00a63f5b5a9af
 SHA512:
-  metadata.gz: a4a23b8d4882af953e2d330c26388c91bb86513c1881192952998f6f74b5f49b682f4b609566ea18b0b6f0ad7517020ac15ccc22ce8756edc001ac5fc25c455b
-  data.tar.gz: cfc14324613fc505a6ec0a591e73f667dd3360b4ec1d8ee7f05d86813fcbaf5e645f12b917579adc6b046223dbc251f665f65b0cd70087dac39d59cc7adfdccf
+  metadata.gz: 7151b6b4e09485ade42fc3dc8756aeaf933d72b96acdb5d216764866d9cf52dd04cfacb828bc4f8498e2a5d90397d7db30add5ae44f3370afb0f9c5916f24765
+  data.tar.gz: fb6b9209b34d67417a232b68e2a02dea9faf99e822252becc5d1b7dfc5a6fad5c8885ba4050258a587abc6e7afdc366e97afaf10be0ebbb768e45f2ba014987d

data/README.md

@@ -1,6 +1,6 @@
 # Intent
 
-Automation engine with todo.txt
+> **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.
 
@@ -16,6 +16,10 @@ gem install intent
 intent help
 ```
 
+## The ledger concept
+
+Docs and an essay about managing text-based computational ledgers ‘coming soon’ (eventually).
+
 ## Copyright & License
 
 Copyright 2024 Mark Rickerby <https://maetl.net>.

data/bin/project

@@ -0,0 +1,10 @@
+#!/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(:project, ARGV.dup)

data/intent.gemspec

@@ -32,6 +32,7 @@ Gem::Specification.new do |spec|
   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_runtime_dependency "paint", "~> 2.3.0"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "rake"

data/lib/intent/args.rb

@@ -0,0 +1,32 @@
+module Intent
+  class Args
+    def initialize(input)
+      @arity = input.length
+
+      unless empty?
+        case @arity
+        when 1 then interpret_args_unary(input[0])
+        when 2 then interpret_args_binary(input[0], input[1])
+        when 3 then interpret_args_ternary(input[0], input[1], input[2])
+        end
+      end
+    end
+
+    def empty?
+      @arity == 0
+    end
+
+    private
+
+    def interpret_args_unary(arg1)
+
+    end
+
+    def interpret_args_binary(arg1, arg2)
+    end
+
+    def interpret_args_ternary(arg1, arg2, arg3)
+
+    end
+  end
+end

data/lib/intent/commands/intent.rb

@@ -1,8 +1,17 @@
 module Intent
   module Commands
-    class Intent
+    class Intent < Base
       def run(args, output)
-        output.puts args
+        if args.empty?
+          print_help(output)
+        else
+          case args.first.to_sym
+          when :help
+            print_help(output)
+          else
+            raise Core::Errors::COMMAND_NOT_FOUND
+          end
+        end
       end
     end
   end

data/lib/intent/commands/inventory.rb

@@ -1,5 +1,3 @@
-require 'tty-reader'
-
 module Intent
   module Commands
     class Inventory < Base
@@ -28,6 +26,12 @@ module Intent
             when :folder then assign_folder(args, output)
             when :box then assign_box(args, output)
             end
+            # CONCEPT:
+            # Verbs::Assign.invoke_rewrite()
+            # verbs.assign.invoke_rewrite(documents.inventory, noun)
+          when :sync then sync_inventory(args, output)
+          else
+            raise Errors:COMMAND_NOT_FOUND
           end
         end
       end
@@ -35,7 +39,7 @@ module Intent
       private
 
       def inventory_tree
-        pastel = Pastel.new
+        color = ::Intent::UI::TermColor.new
         root = {}
         documents.inventory.boxes.each do |box|
           color_code = case box.tags[:id][0].downcase.to_sym
@@ -46,21 +50,23 @@ module Intent
           else
             :white
           end
-          box_key = "#{pastel.decorate(box.tags[:id], :bold, color_code)} #{box.text}"
+          box_key = "#{color.bold.decorate(box.tags[:id], 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}"
+            "#{color.bold.decorate(item.tags[:id], color_code)} #{item.text}"
           end
           root[box_key] = child_items
         end
         root
       end
 
+      # ui format reader
       def inventory_units_of(type)
         documents.inventory.units_of(type).map do |unit|
           [unit.text, unit.tags[:sku]]
         end.to_h
       end
 
+      # ui format reader
       def inventory_unassigned_folders
         folder_types = documents.inventory.units_of(:folder)
         documents.inventory.unassigned_folders.map do |folder|
@@ -69,6 +75,16 @@ module Intent
         end.to_h
       end
 
+      # ui format reader
+      def inventory_assigned_boxes
+        box_types = documents.inventory.units_of(:box)
+        documents.inventory.assigned_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
+
+      # ui format reader
       def inventory_unassigned_boxes
         box_types = documents.inventory.units_of(:box)
         documents.inventory.unassigned_boxes.map do |box|
@@ -98,6 +114,7 @@ module Intent
 
       def add_folder(args, output)
         skus = inventory_units_of(:folder)
+        projects = documents.projects.all_tokens
         prompt = TTY::Prompt.new
         ref = self
         
@@ -105,12 +122,35 @@ module Intent
           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])
+        should_assign_projects = prompt.yes?('assign to projects:')
+
+        if should_assign_projects
+          assigned_projects = prompt.multi_select('projects:', projects, filter: true)
+          label = "#{item[:label]} #{assigned_projects.join(' ')}"
+        else
+          label = item[:label]
+        end
+
+        should_file_in = prompt.select('file in:', {
+          "Active, not in box" => :active,
+          "Unassigned box" => :unassigned,
+          "Assigned project box" => :assigned
+        })
+
+        case should_file_in
+        when :active 
+          label << " @active"
+          in_box = nil
+        when :unassigned
+          in_box = prompt.select('box', inventory_unassigned_boxes)
+        when :assigned
+          # TODO: filter on selected projects only
+          in_box = prompt.select('box:', inventory_assigned_boxes)
+        end
+
+        documents.inventory.add_folder!(label, item[:id], item[:sku], in_box)
       end
 
       def add_box(args, output)
@@ -125,7 +165,7 @@ module Intent
         end
         
         # Repository write pattern
-        documents.inventory.add_box!(label, item[:id], item[:sku])
+        documents.inventory.add_box!(item[:label], item[:id], item[:sku])
 
         # Alternative design
         # noun = create_noun(:box, label, tags)
@@ -169,6 +209,11 @@ module Intent
         box.projects.concat(details[:projects])
         documents.inventory.save!
       end
+
+      def sync_inventory(args, output)
+        result = documents.inventory.sync!
+        output.puts "Sync inventory result: #{result}"
+      end
     end
   end
 end

data/lib/intent/commands/project.rb

@@ -0,0 +1,91 @@
+module Intent
+  module Commands
+    class Project < Projects
+      def run(args, output)
+        if args.empty?
+          print_help(output)
+        else
+          case args.first.to_sym
+          when :help
+            print_help(output)
+          when :link
+            if args[1].nil?
+              # launch into projects selection?
+              raise "Need to link to a noun at this stage, sorry"
+            else
+              case args[1].to_sym
+              when :notes then link_notes(args, output)
+              else
+                raise "Noun not implemented"
+              end
+            end
+          else
+            raise Errors:COMMAND_NOT_FOUND
+          end
+        end
+      end
+
+      private
+
+      def link_notes(args, output, needs_assign=false)
+        prompt = TTY::Prompt.new
+
+        project = if args.last.start_with?('+')
+          # args.last
+          # if documents.working_directory.is_linked?
+          #   documents.working_directory.project
+          # else
+          # end
+          raise "Good idea and should work but not implemented properly, sorry"
+        else
+          # TODO: need to test if working_directory is documents_dir
+          # 
+          if documents.working_directory.is_linked?
+            documents.working_directory.project
+          else
+            needs_assign = true
+            p_name = prompt.select('assign directory to project:', documents.projects.all_tokens)
+            p_id = prompt.ask('id for this directory:', default: generate_id)
+            p_name
+          end
+        end
+
+        if needs_assign
+          c_id = documents.inventory.local_computer_id
+          documents.projects.add_directory!(documents.working_directory.path, p_name, p_id, c_id)
+        end
+
+        project_ref = project.sub('+', '')
+
+        # Symlink done using maetl local notes convention, this could be improved
+        # and made more flexible. Would also be good to delegate this outside
+        # of the UI routine link_notes()
+        target_path = File.join(Env.documents_dir, project.sub('+', ''), 'notes.md')
+
+        if File.exist?(target_path)
+          # TODO: use directory instance given by input filtering so that
+          #       operations can work on both working dir and a path provided in the UI
+          symbolic_path = File.join(documents.working_directory.path, 'NOTES.md')
+          File.symlink(target_path, symbolic_path)
+          
+          # ignore_path = File.join(documents.working_directory.path, '.gitignore')
+          # if File.exist?(ignore_path)
+          #   unless File.read(ignore_path).to_s.include?('NOTES.md')
+          #     File.write(ignore_path, "NOTES.md\n", mode: 'a+')
+          #   end
+          # end
+        else
+          output.puts "#{project} does not have notes"
+        end
+        
+        # output.puts Dir.pwd
+        # output.puts ::Intent::Env.documents_dir
+        # output.puts ::Intent::Env.computer_serial
+        # Check if current working directory is a linked directory
+        #item = documents.projects.linked_directory(Dir.pwd)
+        #output.puts item
+        #File.symlink("DOCUMENT_DIR/project-name/notes.md", "Projects/project-name/NOTES.md")
+      end
+    end
+  end
+end

data/lib/intent/commands/projects.rb

@@ -1,5 +1,3 @@
-require 'readline'
-
 module Intent
   module Commands
     class Projects < Base
@@ -14,8 +12,10 @@ module Intent
             documents.projects.all.each do |task|
               output.puts task.highlight_as_project
             end
-          when :add
-            add_project(args, output)
+          when :add then add_project(args, output)
+          when :sync then sync_project(args, output)
+          else
+            raise Errors:COMMAND_NOT_FOUND
           end
         end
       end
@@ -29,6 +29,11 @@ module Intent
         name = "+#{name}" unless name.start_with?('+')
         output.puts name
       end
+
+      def sync_project(args, output)
+        result = documents.projects.sync!
+        output.puts "Sync projects result: #{result}"
+      end
     end
   end
 end

data/lib/intent/commands.rb

@@ -3,7 +3,7 @@ require 'intent/commands/errors'
 require 'intent/commands/intent'
 require 'intent/commands/todo'
 require 'intent/commands/projects'
-#require 'intent/commands/project'
+require 'intent/commands/project'
 #require 'intent/commands/ideas'
 #require 'intent/commands/idea'
 require 'intent/commands/inventory'

data/lib/intent/core/directory.rb

@@ -0,0 +1,37 @@
+module Intent
+  module Core
+    class Directory
+      attr_reader :path
+
+      def initialize(path, projects)
+        @path = path
+        @ledger = projects
+        @record = projects.all.find { |d| d.tags[:is] == 'directory' && d.text == @path }
+      end
+
+      def project
+        record.projects.first
+      end
+
+      def is_linked?
+        !record.nil? && record.projects.any?
+      end
+
+      def assign!(project)
+        if record.nil?
+          @record = Record.new("#{Date.today} #{@path} is:directory type:#{type} sku:#{sku}")
+          ledger.append(record)
+        else
+          record.projects << project
+        end
+
+        ledger.save!
+      end
+
+      private
+
+      attr_reader :ledger
+      attr_reader :record
+    end
+  end
+end

data/lib/intent/core/documents.rb

@@ -0,0 +1,17 @@
+module Intent
+  module Core
+    class Documents
+      attr_reader :projects
+      attr_reader :inventory
+      attr_reader :inbox
+      attr_reader :working_directory
+
+      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")
+        @working_directory = Directory.new(Dir.pwd, @projects)
+      end
+    end
+  end
+end

data/lib/intent/core/inbox.rb

@@ -0,0 +1,29 @@
+module Intent
+  module Core
+    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
+  end
+end

data/lib/intent/core/inventory.rb

@@ -0,0 +1,101 @@
+module Intent
+  module Core
+    class Inventory
+      attr_reader :list
+      attr_reader :ledger_path
+
+      def initialize(db_path)
+        @ledger_path = 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 local_computer_id
+        all.find { |i| i.tags[:is] == 'computer' && i.tags[:serial] == Env.computer_serial }.tags[:id]
+      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, box=nil)
+        description << " in:#{box}" unless box.nil?
+        record = Record.new("#{Date.today} #{description} id:#{id} is:#{type} sku:#{sku}")
+        @list.append(record)
+        @list.save!
+      end
+
+      def add_folder!(description, id, sku, box=nil)
+        add_item!(description, id, :folder, sku, box)
+      end
+
+      def add_box!(description, id, sku)
+        add_item!(description, id, :box, sku)
+      end
+
+      def save!
+        @list.save!
+      end
+
+      def sync!
+        ledger_file = File.basename(ledger_path)
+
+        if repo.status.changed?(ledger_file)
+          repo.add(ledger_file)
+          repo.commit("Synchronizing inventory [#{Time.new}]")
+          repo.push
+          true # Result:OK
+        else
+          false # Result::NO_CHANGES
+        end
+      end
+
+      private
+
+      def repo
+        @repo ||= Git.open(Env.documents_dir, :log => Logger.new(STDERR, level: Logger::INFO))
+      end
+    end
+  end
+end

data/lib/intent/core/projects.rb

@@ -0,0 +1,58 @@
+module Intent
+  module Core
+    class Projects
+      attr_reader :list
+      attr_reader :ledger_path
+
+      def initialize(db_path)
+        @ledger_path = db_path
+        @list = List.new(db_path)
+      end
+
+      def all
+        list.by_not_done
+      end
+
+      def all_tokens
+        all.map { |item| item.projects.first }.uniq
+      end
+
+      def linked_directory(path)
+        all.find { |item| item.text == path && ['repository', 'directory'].include?(item.tags[:is]) }
+      end
+
+      def sync!
+        ledger_file = File.basename(ledger_path)
+
+        if repo.status.changed?(ledger_file)
+          repo.add(ledger_file)
+          repo.commit("Synchronizing projects [#{Time.new}]")
+          repo.push
+          true # Result:OK
+        else
+          false # Result::NO_CHANGES
+        end
+      end
+
+      def add_directory!(path, project, id, computer)
+        record = Record.new([
+          Date.today,
+          path,
+          project,
+          "is:directory",
+          "id:#{id}",
+          "computer:#{computer}"
+        ].join(' '))
+
+        @list.append(record)
+        @list.save!
+      end
+
+      private
+
+      def repo
+        @repo ||= Git.open(Env.documents_dir, :log => Logger.new(STDERR, level: Logger::INFO))
+      end
+    end
+  end
+end

data/lib/intent/core.rb

@@ -1,25 +1,25 @@
 module Intent
-  module Env
-    def self.documents_dir
-      File.expand_path(ENV['INTENT_DOCUMENTS_DIR'] || "").to_s
-    end
+  module Core
+    List = ::Todo::List
+    Record = ::Todo::Task
 
-    def self.inbox_dir
-      ENV['INTENT_INBOX_DIR']
-    end
+    VERBS = [:add, :assign, :list, :link, :sync]
 
-    def self.assets_dir
-      ENV['INTENT_ARCHIVE_DIR']
-    end
+    NOUNS = {
+      inventory: [:unit, :box, :folder, :computer],
+      projects: [:project, :directory, :repository],
+      todo: [:task]
+    }
+
+    class Action
+      attr_reader :verb
+      attr_reader :noun
 
-    def self.projects_dir
-      ENV['INTENT_PROJECTS_DIR']
+      def initialize(verb_sym, noun_r)
+        @verb = Verbs.instance_for(verb_sym)
+        @noun = Noun.new(noun_r.type, noun_r.label, noun_r.tags)
+      end
     end
-  end
-  
-  module Core
-    List = ::Todo::List
-    Record = ::Todo::Task
 
     class Noun
       def initialize(type, label, tags)
@@ -35,150 +35,11 @@ module Intent
         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
+
+require 'intent/core/projects'
+require 'intent/core/inventory'
+require 'intent/core/inbox'
+require 'intent/core/directory'
+require 'intent/core/documents'

data/lib/intent/desktop.rb

@@ -1,3 +1,5 @@
-require 'pathname'
-
-require 'intent/desktop/commands'
+require 'intent/verbs/add'
+require 'intent/verbs/assign'
+require 'intent/verbs/link'
+require 'intent/verbs/list'
+require 'intent/verbs/sync'

data/lib/intent/dispatcher.rb

@@ -0,0 +1,20 @@
+module Intent
+  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/env.rb

@@ -0,0 +1,26 @@
+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
+
+    def self.computer_serial
+      # macOS: `system_profiler SPHardwareDataType`
+      # Win: `wmic bios get serialnumber`
+      # Linux: `ls /sys/devices/virtual/dmi/id`
+      ENV['INTENT_COMPUTER_SERIAL']
+    end
+  end
+end

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

@@ -0,0 +1,82 @@
+====================================================================
+Intent . Havin a blast on the command line
+====================================================================
+
+Welcome to the only task manager you will (n)ever need.
+
+These docs are not written for a wide audience, but here’s the
+essentials:
+
+Verbs
+-----
+
+### `add [noun]`
+
+Adds [noun] to the ledger denoted by the given command.
+
+```
+projects add
+projects add project
+projects add directory
+projects add repository
+
+project add
+
+inventory add
+inventory add folder
+inventory add box
+inventory add unit
+inventory add computer
+
+todo add
+
+inbox add
+```
+
+### `assign [noun]`
+
+Assigns projects, contexts, tags and associations to ap.
+
+```
+projects assign
+
+project assign
+
+inventory assign
+```
+
+### `list [noun]`
+
+Lists elements in the ledger.
+
+```
+projects list
+
+project list
+
+inventory list
+
+todo list
+
+inbox list
+```
+
+### `link [noun]`
+
+Links elements from a local directory to an assigned project.
+
+```
+project link
+```
+
+### `sync [noun]`
+
+Synchronises changes to the Git origin.
+
+```
+projects sync
+
+inventory sync
+```
+
+Documentation is patchy and not always up to date.

data/lib/intent/ui/term_color.rb

@@ -0,0 +1,80 @@
+module Intent
+  module UI
+    # Shim to convert between Pastel to Paint gems
+    # without needing to edit existing call sites.
+    #
+    # It might be helpful to normalize this convention with an API
+    # anyway as we generally want to use the 8/16 colour defaults
+    # as they pick up user terminal customisation properly, whereas
+    # going full 256 or 24 bit colour means generic RGB values are likely
+    # to look shit on customised terminal backgrounds.
+    #
+    # This way we get the benefits of *mostly* sticking to the terminal
+    # defaults, while extending the range of colours with a few carefully
+    # chosen values.
+    class TermColor
+      def initialize
+        @decoration_scope = []
+      end
+
+      def decorate(text, *args)
+        decoration_scope.push(*args)
+        return_decorator(text)
+      end
+
+      def bold(text=nil)
+        decoration_scope.push(:bold)
+        return_decorator(text)
+      end
+
+      def red(text=nil)
+        decoration_scope.push(:red)
+        return_decorator(text)
+      end
+
+      def green(text)
+        decoration_scope.push(:green)
+        return_decorator(text)
+      end
+
+      def blue(text)
+        decoration_scope.push(:blue)
+        return_decorator(text)
+      end
+
+      def yellow(text)
+        decoration_scope.push(:yellow)
+        return_decorator(text)
+      end
+
+      def cyan(text)
+        decoration_scope.push(:cyan)
+        return_decorator(text)
+      end
+
+      def orange(text)
+        decoration_scope.push('orange')
+        return_decorator(text)
+      end
+
+      def brown(text)
+        decoration_scope.push('tan')
+        return_decorator(text)
+      end
+
+      private
+
+      attr_reader :decoration_scope
+
+      def return_decorator(text)
+        if text.nil?
+          self
+        else
+          decorated = Paint[text, *decoration_scope]
+          decoration_scope.clear
+          decorated
+        end
+      end
+    end
+  end
+end

data/lib/intent/version.rb

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

data/lib/intent.rb

@@ -1,21 +1,37 @@
 #require 'random'
-require 'todo-txt'
+#require 'pathname'
+
+# Pastel still required but deprecated
 require 'pastel'
+require 'paint'
+
+# CLI UI tools
 require 'tty-prompt'
 require 'tty-table'
 require 'tty-tree'
+
+# Identifiers
 require 'nanoid'
+#require 'calyx'
+
+# Interact with git repos
+require 'logger'
+require 'git'
+
+# todo.txt data structure support
+require 'todo-txt'
 require 'gem_ext/todo-txt'
 
 Todo.customize do |options|
   options.require_completed_on = false
 end
 
+# Intent library
 require 'intent/version'
+require 'intent/env'
+require 'intent/args'
 require 'intent/core'
+#require 'intent/verbs'
 require 'intent/commands'
-# require 'intent/todo'
-# require 'intent/review'
-# require 'intent/projects'
-# require 'intent/desktop'
-
+require 'intent/ui/term_color'
+require 'intent/dispatcher'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: intent
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Mark Rickerby
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-16 00:00:00.000000000 Z
+date: 2024-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: todo-txt
@@ -206,6 +206,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -254,9 +268,9 @@ email:
 executables:
 - intent
 - inventory
+- project
 - project_doc
 - projects
-- projects_active
 - todo
 - todo_review
 extensions: []
@@ -269,30 +283,42 @@ files:
 - Rakefile
 - bin/intent
 - bin/inventory
+- bin/project
 - bin/project_doc
 - bin/projects
-- bin/projects_active
 - bin/todo
 - bin/todo_review
 - intent.gemspec
 - lib/gem_ext/todo-txt.rb
 - lib/intent.rb
+- lib/intent/args.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/project.rb
 - lib/intent/commands/projects.rb
 - lib/intent/commands/todo.rb
 - lib/intent/core.rb
+- lib/intent/core/directory.rb
+- lib/intent/core/documents.rb
+- lib/intent/core/inbox.rb
+- lib/intent/core/inventory.rb
+- lib/intent/core/projects.rb
 - lib/intent/desktop.rb
+- lib/intent/dispatcher.rb
+- lib/intent/env.rb
 - lib/intent/projects.rb
 - lib/intent/review.rb
+- lib/intent/text/intent.help.txt
 - 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/ui/projects_active.rb
+- lib/intent/ui/term_color.rb
 - lib/intent/ui/ttyui.rb
 - lib/intent/verbs/add.rb
 - lib/intent/verbs/cite.rb