documinty 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f47f710104e3d97dbf8afa35333f6c5559acfae0b9920b88a371d8e4ac2e17f
-  data.tar.gz: 3ac6cf1da6b1582176be4b7b1120c415dd859b1acf602942462c0f49f8980a66
+  metadata.gz: de1f0a6fded0793fb156e8111a074c44dda251836475980441b0c47576660147
+  data.tar.gz: 4fbb5cd7db1b97866eed50050754af3ac09998e7ff4486b5330adfd822fc1537
 SHA512:
-  metadata.gz: 5181bcec104b0441f59681e3e4dc792dcca156581bbb7b2da7b66d0a1a88d470de55faa22f223cbbbae1bd117dbce39f129af7373429874e96832867469897b6
-  data.tar.gz: 460d9755b0baf1155a66f2e30d7d50c73063b01cb1cfbf47c0090cadbcb2c126bd9dcf24770c2c5e1d314bed381dbd2b67e0e77095ac218dc7cb853f67e5924e
+  metadata.gz: f883d81566c6ab6013c5d6edbc77faf7b2661bb95ada107c1816787099ebc13e3dc92a246b36dbf1489620eed465e8da1c3e68896cd8d6a50224e93f6f9d4e7f
+  data.tar.gz: da024a6231ee1b7bbe131cf4393f5a20351ec7d8ae9e48655cd6ddfd9b8c89d3b0cf749af341970b666ff471704292ba79e904f974dbf4d5cceb67da54f00c98

data/lib/documinty/cli.rb

@@ -4,6 +4,7 @@ require 'documinty/store'
 
 module Documinty
   class CLI < Thor
+    MAX_DESC_LENGTH = 80
     def self.exit_on_failure?
       true
     end
@@ -112,7 +113,7 @@ module Documinty
           say(
             set_color("Description📝", label_color) +
               ": " +
-              set_color(e['description'], value_color)
+              set_color(truncate(e['description']), value_color)
           )
         end
 
@@ -150,8 +151,8 @@ module Documinty
       end
     end
 
-    desc "show-feature FEATURE", "List all files documented under FEATURE"
-    def list_f(feature)
+    desc "show_feature FEATURE", "List all files documented under FEATURE"
+    def show_feature(feature)
       begin
         entries = store.entries_for_feature(feature)
       rescue Error => e
@@ -163,13 +164,21 @@ module Documinty
         say "No entries under '#{feature}'.", :red
       else
         say "Entries for '#{feature}':"
+        label_color   = :cyan
+        value_color   = :magenta
         entries.each do |e|
-          say "• #{e['path']} (#{e['node']}) – #{e['description']}", :green
+
+
+          # File
+          say(
+            set_color("📄#{e['path']} | ", label_color) +
+              set_color("(#{e['node']}) – #{e['description']}", value_color)
+          )
         end
       end
     end
 
-    desc "show_feature_involved FEATURE", "Display files under FEATURE grouped by directory"
+    desc "involved_f FEATURE", "Display files under FEATURE grouped by directory"
     def involved_f(feature)
       begin
         entries = store.entries_for_feature(feature)
@@ -212,8 +221,69 @@ module Documinty
       end
     end
 
+    desc "add_methods FILE", "Prompt for and add methods to an existing documented file"
+    option :feature, aliases: '-f', required: true, desc: "Feature name"
+    def add_methods(path)
+      # Ask interactively for comma-separated methods
+      methods_input = ask("Enter comma-separated methods to add to this node🛠️:")
+      method_syms = methods_input
+                      .split(",")
+                      .map(&:strip)
+                      .reject(&:empty?)
+                      .map(&:to_sym)
+
+      begin
+        entry = store.add_methods(
+          path:        path,
+          feature:     options[:feature],
+          new_methods: method_syms
+        )
+        say "✅ Updated methods for #{entry['path']} under '#{entry['feature']}': #{Array(entry['methods']).join(', ')}", :green
+      rescue Error => e
+        say "❌ #{e.message}", :red
+        exit(1)
+      end
+    end
+
+    desc "describe FILE", "Display only the description for FILE"
+    option :feature, aliases: '-f', desc: "If provided, only show description under that feature"
+    def describe(path)
+      entries = store.entries_for(path)
+
+      # If a specific feature is requested, filter to those entries
+      if options[:feature]
+        entries = entries.select { |e| Array(e['features'] || e['feature']).include?(options[:feature]) }
+      end
+
+      if entries.empty?
+        if options[:feature]
+          say "❌ No description found for '#{path}' under feature '#{options[:feature]}'", :red
+        else
+          say "❌ No description found for '#{path}'", :red
+        end
+        exit(1)
+      end
+
+      entries.each do |e|
+        desc = e['description'].to_s.strip
+        if desc.empty?
+          say "ℹ️  No description provided for '#{path}' under '#{e['feature']}'", :yellow
+        else
+          say "📋 #{path}", :cyan
+          say "--→ #{desc}", :green
+        end
+      end
+    end
+
     private
 
+
+    def truncate(text)
+      return "" unless text
+      return text if text.length <= MAX_DESC_LENGTH
+      text[0, MAX_DESC_LENGTH] + "(…)"
+    end
+
     def store
       @store ||= Store.new(Dir.pwd)
     end

data/lib/documinty/store.rb

@@ -103,6 +103,33 @@ module Documinty
       data['entries'] || []
     end
 
+    # Add one or more methods to a documented file under a given feature
+    # @param path [String]       relative file path
+    # @param feature [String]    feature name (must already exist on that entry)
+    # @param new_methods [Array<Symbol>]  list of symbols to add
+    # @return [Hash] the updated entry
+    def add_methods(path:, feature:, new_methods:)
+      file = feature_file(feature)
+      raise Error, "Feature '#{feature}' does not exist" unless File.exist?(file)
+
+      data = YAML.load_file(file) || {}
+      entries = data['entries'] || []
+
+      # Find the exact entry by path + feature
+      entry = entries.find { |e| e['path'] == path && e['feature'] == feature }
+      unless entry
+        raise Error, "No documentation found for '#{path}' under feature '#{feature}'"
+      end
+
+      # Merge existing methods (strings) with new ones, avoid duplicates
+      existing = Array(entry['methods']).map(&:to_s)
+      merged  = (existing + new_methods.map(&:to_s)).uniq
+      entry['methods'] = merged
+
+      File.write(file, data.to_yaml)
+      entry
+    end
+
     private
 
     # Build the path to a feature’s YAML file

data/lib/documinty/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: documinty
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Marcel Carrero Pedre
 bindir: exe
 cert_chain: []
-date: 2025-06-03 00:00:00.000000000 Z
+date: 2025-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor