documinty 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de1f0a6fded0793fb156e8111a074c44dda251836475980441b0c47576660147
-  data.tar.gz: 4fbb5cd7db1b97866eed50050754af3ac09998e7ff4486b5330adfd822fc1537
+  metadata.gz: e847137dcc7a46903f7339d096678c5a07c32413e8877830ba496c6e1325e9e7
+  data.tar.gz: 5672e3ce3188e413bbc292bfe457deb90af10ba22a3ec8b8a9dbeb28635b2aba
 SHA512:
-  metadata.gz: f883d81566c6ab6013c5d6edbc77faf7b2661bb95ada107c1816787099ebc13e3dc92a246b36dbf1489620eed465e8da1c3e68896cd8d6a50224e93f6f9d4e7f
-  data.tar.gz: da024a6231ee1b7bbe131cf4393f5a20351ec7d8ae9e48655cd6ddfd9b8c89d3b0cf749af341970b666ff471704292ba79e904f974dbf4d5cceb67da54f00c98
+  metadata.gz: '0859bd3be39d71225c6a04577062a93b5d3411fb237a6c1de93467e78dc74b8b27fefba48908914a52d92385efbc11086479580ed9c2de51a7e23e1579264c83'
+  data.tar.gz: 4f55d997b8b3a5a1261985830c169b7fb0bf8bdf9c42346c3f5482c492bde72ac0ccc3c7ad6f6deff1b5ea5a0a6cf819b61776db2ed0a68a8aa7f31b21f4623f

data/lib/documinty/cli.rb

@@ -221,10 +221,15 @@ 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
+    desc "methods FILE", "Prompt for removing or adding methods to a tagged file pass add or remove as the action"
+    option :feature, aliases: '-f', required: true, desc: 'Feature name to group under'
+    option :action,    aliases: '-a', required: true, desc: 'Node/type label'
+    def methods(path)
+      if options[:action] != 'add' && options[:action] != 'remove'
+        say "❌ Action not supported must be 'add' OR 'remove'", :red
+        exit(1)
+      end
+
       methods_input = ask("Enter comma-separated methods to add to this node🛠️:")
       method_syms = methods_input
                       .split(",")
@@ -233,10 +238,11 @@ module Documinty
                       .map(&:to_sym)
 
       begin
-        entry = store.add_methods(
+        entry = store.methods(
           path:        path,
           feature:     options[:feature],
-          new_methods: method_syms
+          new_methods: method_syms,
+          action: options[:action].to_sym
         )
         say "✅ Updated methods for #{entry['path']} under '#{entry['feature']}': #{Array(entry['methods']).join(', ')}", :green
       rescue Error => e
@@ -265,18 +271,46 @@ module Documinty
       end
 
       entries.each do |e|
-        desc = e['description'].to_s.strip
-        if desc.empty?
+        desc_text = e['description'].to_s.strip
+
+        if desc_text.empty?
           say "ℹ️  No description provided for '#{path}' under '#{e['feature']}'", :yellow
         else
-          say "📋 #{path}", :cyan
-          say "--→ #{desc}", :green
+          if options[:feature]
+            # Only one feature context
+            say "📋 #{path}", :cyan
+          else
+            # Show which feature this description belongs to
+            say(
+              set_color("📋 #{path} ️", :cyan) +
+                ": " +
+                set_color("(FEATURE: #{e['feature']})", :magenta)
+            )
+          end
+          say "--→ #{desc_text}", :green
         end
       end
     end
 
-    private
+    desc "update-description FILE", "Prompt for and update description for FILE under a feature"
+    option :feature, aliases: '-f', required: true, desc: 'Feature name'
+    def update_description(path)
+      begin
+        new_desc = ask("Enter a new description for '#{path}' under '#{options[:feature]}':")
+        entry = store.update_description(
+          path:            path,
+          feature:         options[:feature],
+          new_description: new_desc
+        )
+        say "✅ Description updated for #{entry['path']} under '#{entry['feature']}':", :green
+        say "   #{entry['description']}", :green
+      rescue Error => e
+        say "❌ #{e.message}", :red
+        exit(1)
+      end
+    end
 
+    private
 
     def truncate(text)
       return "" unless text

data/lib/documinty/store.rb

@@ -108,7 +108,7 @@ module Documinty
     # @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:)
+    def methods(path:, feature:, new_methods:, action:)
       file = feature_file(feature)
       raise Error, "Feature '#{feature}' does not exist" unless File.exist?(file)
 
@@ -123,13 +123,42 @@ module Documinty
 
       # Merge existing methods (strings) with new ones, avoid duplicates
       existing = Array(entry['methods']).map(&:to_s)
-      merged  = (existing + new_methods.map(&:to_s)).uniq
+      if action == :add
+        merged  = (existing + new_methods.map(&:to_s)).uniq
+      else
+        merged  = (existing - new_methods.map(&:to_s)).uniq
+      end
       entry['methods'] = merged
 
       File.write(file, data.to_yaml)
       entry
     end
 
+    # Update the description for a documented file under a given feature
+    # @param path [String]          relative file path
+    # @param feature [String]       feature name
+    # @param new_description [String]
+    # @return [Hash] the updated entry
+    def update_description(path:, feature:, new_description:)
+      file = feature_file(feature)
+      unless File.exist?(file)
+        raise Error, "Feature '#{feature}' does not exist"
+      end
+
+      data     = YAML.load_file(file) || {}
+      entries  = data['entries'] ||= []
+
+      entry = entries.find { |e| e['path'] == path && e['feature'] == feature }
+      unless entry
+        raise Error, "No documentation found for '#{path}' under feature '#{feature}'"
+      end
+
+      entry['description'] = new_description.to_s.strip
+      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.1"
+  VERSION = "0.3.2"
 end

metadata

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