easy_creds 1.0.1

data/lib/easy_creds/views/init_tree.rb

@@ -0,0 +1,250 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+
+require 'tty-reader'
+require 'tty-cursor'
+require 'tty-screen'
+
+module EasyCreds
+  module Views
+    module InitTree
+      MAX_WIDTH   = 120
+      MIN_LEFT_W  = 32
+      MAX_LEFT_W  = 54
+      HEADER_ROWS = 2
+      FOOTER_ROWS = 2
+
+      SOURCE_TAG = {
+        unset:        ['○', 'unset',  :dim],
+        template:     ['▾', 'tmpl',   :dim],
+        generate:     ['⚡', 'gen',    :ok],
+        generate_alt: ['⚡', 'alt',    :ok],
+        from_op:      ['☁', 'op',     :info],
+        manual:       ['✎', 'manual', :warn],
+        ar_batch:     ['⚡', 'batch',  :ok]
+      }.freeze
+
+      def self.run(state, ctx)
+        reader    = TTY::Reader.new(interrupt: :signal)
+        show_help = false
+
+        print TTY::Cursor.hide
+        redraw(state, ctx, show_help: show_help)
+
+        loop do
+          key    = reader.read_keypress(nonblock: false)
+          signal = InitDispatch.handle(key, state, root: ctx.root)
+
+          case signal
+          when :manual_entry
+            print TTY::Cursor.show
+            val = ctx.prompt.ask('  Value (input hidden): ') { |q| q.echo(false) }
+            print TTY::Cursor.hide
+            state.set_entry(state.current, value: val, source: :manual) if val.present?
+          when :toggle_help
+            show_help = !show_help
+          when :save
+            return :saved
+          when :quit
+            return :aborted unless state.dirty
+
+            print TTY::Cursor.show
+            system('clear')
+            return :aborted unless ctx.prompt.yes?('  Quit without saving?', default: false)
+
+            print TTY::Cursor.hide
+          end
+
+          redraw(state, ctx, show_help: show_help)
+        end
+      rescue Interrupt
+        :aborted
+      ensure
+        print TTY::Cursor.show
+        print TTY::Cursor.move_to(0, 0)
+        print TTY::Cursor.clear_screen_down
+      end
+
+      def self.build_tree_rows(entries)
+        seen_groups = {}
+        rows = []
+        entries.each do |entry|
+          parts = entry.key.split('.')
+          group = parts.size > 1 ? parts.first : nil
+          leaf  = parts.size > 1 ? parts[1..].join('.') : parts.first
+          if group && !seen_groups[group]
+            seen_groups[group] = true
+            rows << { kind: :header, label: group }
+          end
+          indent = group ? 4 : 2
+          rows << { kind: :entry, label: leaf, entry: entry, indent: indent }
+        end
+        rows
+      end
+
+      def self.redraw(state, ctx, show_help:)
+        width        = [TTY::Screen.width, MAX_WIDTH].min
+        height       = TTY::Screen.height
+        content_rows = [height - HEADER_ROWS - FOOTER_ROWS, 4].max
+
+        # Right pane is wider (~56%) per design: left ratio 1.1, right 1.4
+        left_w  = (width * 0.44).to_i.clamp(MIN_LEFT_W, MAX_LEFT_W)
+        right_w = width - left_w - 1
+
+        tree_rows     = build_tree_rows(state.entries)
+        cursor_tree_i = tree_rows.index { |r| r[:kind] == :entry && r[:entry] == state.current } || 0
+        state.adjust_scroll(cursor_tree_i, content_rows)
+
+        visible_rows = tree_rows[state.scroll_offset, content_rows] || []
+        right_rows   = show_help ? help_right_rows(right_w) : detail_right_rows(state, right_w)
+
+        buf = +''
+        buf << "\e[H\e[J"
+
+        # Traffic-light title bar
+        set_c  = state.set_count == state.total ? state.set_count.to_s : state.set_count.to_s
+        status = "#{state.set_count}/#{state.total} set"
+        buf << "#{Theme.title_bar("init · #{ctx.env}", width, status: status)}\n"
+        buf << "#{Theme.box_h(width)}\n"
+
+        content_rows.times do |i|
+          left_row  = build_left_row(visible_rows[i], state, left_w)
+          right_row = right_rows[i] || ''
+          buf << "#{left_row}#{Theme.box_side}#{rpad(right_row, right_w)}\n"
+        end
+
+        buf << "#{Theme.box_h(width)}\n"
+        buf << footer_line(state, width, show_help)
+
+        print buf
+      end
+
+      private_class_method def self.build_left_row(row_data, state, width)
+        return ' ' * width unless row_data
+
+        if row_data[:kind] == :header
+          label = Theme.dim("  ▾ #{row_data[:label]}")
+          return rpad(label, width)
+        end
+
+        entry  = row_data[:entry]
+        indent = row_data[:indent]
+        cursor = entry == state.current
+
+        icon, tag_label, color_m = SOURCE_TAG.fetch(entry.source, SOURCE_TAG[:unset])
+        badge = "#{Theme.public_send(color_m, icon)} #{Theme.dim(tag_label)}"
+
+        prefix = cursor ? Theme.accent('› ') : '  '
+        leaf   = row_data[:label]
+        leaf_w = width - indent - badge_visible_length - 4
+        line   = (' ' * indent) + prefix + rpad(leaf, [leaf_w, 4].max) + badge
+
+        line
+      end
+
+      private_class_method def self.badge_visible_length
+        8
+      end
+
+      private_class_method def self.detail_right_rows(state, width)
+        entry = state.current
+        rows  = []
+
+        rows << ''
+        rows << "  #{Theme.bold(entry.key)}"
+        rows << "  #{Theme.dim('─' * [width - 4, 20].min)}"
+        rows << ''
+
+        icon, label, color_m = SOURCE_TAG.fetch(entry.source, SOURCE_TAG[:unset])
+        status_str = Theme.public_send(color_m, "#{icon} #{label}")
+        masked     = Theme.dim(entry.masked_value || '—')
+        rows << "  #{Theme.dim('Status  ')} #{status_str} #{masked}"
+        rows << ''
+
+        rows << "  #{Theme.dim('Hint    ')} #{Theme.accent(":#{entry.hint}")}" if entry.hint
+
+        if entry.placeholder
+          ph_display = entry.placeholder.to_s[0, [width - 14, 20].max]
+          rows << "  #{Theme.dim('Template')} #{Theme.dim(ph_display)}"
+        end
+
+        op_str = entry.op_value ? Theme.ok('available') : Theme.dim('—')
+        rows << "  #{Theme.dim('Remote  ')} #{op_str}"
+
+        rows << ''
+        rows << "  #{Theme.dim('Actions ──────────────────')}"
+        is_ar = entry.hint == :ar_encryption
+        g_action   = is_ar ? Theme.dim('generate (use [b] for AR)') : ('generate  ' + Theme.dim('(default)'))
+        alt_action = is_ar ? Theme.dim('n/a') : ('alt generate  ' + Theme.dim('(hex64)'))
+        rows << "  #{Theme.kbd('g')} #{g_action}"
+        rows << "  #{Theme.kbd('G')} #{alt_action}"
+        rows << "  #{Theme.kbd('b')} #{Theme.ok('ar_encryption batch')}  #{Theme.dim('(3 keys)')}"
+        rows << "  #{Theme.kbd('t')} use template placeholder"
+        op_action = entry.op_value ? 'use 1Password value' : Theme.dim('1Password value  (—)')
+        rows << "  #{Theme.kbd('o')} #{op_action}"
+        rows << "  #{Theme.kbd('m')} enter manually  #{Theme.dim('(hidden)')}"
+        rows << "  #{Theme.kbd('c')} clear / reset to unset"
+        rows
+      end
+
+      private_class_method def self.help_right_rows(width)
+        rows = []
+        rows << ''
+        rows << "  #{Theme.bold('Keyboard shortcuts')}"
+        rows << "  #{Theme.dim('─' * [width - 4, 20].min)}"
+        rows << ''
+        rows << "  #{Theme.bold('Navigate')}"
+        rows << "  #{Theme.kbd('↑')} #{Theme.dim('/')} #{Theme.kbd('↓')}  #{Theme.dim('or')}  #{Theme.kbd('k')} #{Theme.dim('/')} #{Theme.kbd('j')}    move cursor"
+        rows << "  #{Theme.kbd('PgUp')} #{Theme.kbd('PgDn')}      jump 10 rows"
+        rows << "  #{Theme.kbd('Home')} #{Theme.kbd('End')}        first / last entry"
+        rows << ''
+        rows << "  #{Theme.bold('Fill single entry')}"
+        rows << "  #{Theme.kbd('g')}  generate (default strategy)"
+        rows << "  #{Theme.kbd('G')}  alt generate  #{Theme.dim('(SecureRandom hex64)')}"
+        rows << "  #{Theme.kbd('b')}  AR encryption batch  #{Theme.dim('(3 keys)')}"
+        rows << "  #{Theme.kbd('t')}  use template placeholder"
+        rows << "  #{Theme.kbd('o')}  use 1Password remote value"
+        rows << "  #{Theme.kbd('m')}  enter manually  #{Theme.dim('(hidden input)')}"
+        rows << "  #{Theme.kbd('c')}  clear / reset to unset"
+        rows << ''
+        rows << "  #{Theme.bold('Fill all unset')}"
+        rows << "  #{Theme.kbd('T')}  template all"
+        rows << "  #{Theme.kbd('R')}  generate all with hints"
+        rows << "  #{Theme.kbd('O')}  1Password fill all"
+        rows << ''
+        rows << "  #{Theme.bold('Session')}"
+        rows << "  #{Theme.kbd('s')}  save and write .yml.enc"
+        rows << "  #{Theme.kbd('q')}  quit  #{Theme.dim('(confirm if unsaved)')}"
+        rows << "  #{Theme.kbd('?')}  toggle this help"
+        rows
+      end
+
+      private_class_method def self.footer_line(state, width, show_help)
+        pct    = state.total.zero? ? 0 : (state.set_count * 100 / state.total)
+        bar_w  = 10
+        filled = (bar_w * pct / 100).round
+        bar    = Theme.ok('█' * filled) + Theme.dim('░' * (bar_w - filled))
+        count  = Theme.dim("#{state.set_count}/#{state.total}")
+
+        if show_help
+          hint = "  #{bar} #{count}   #{Theme.kbd('?')} #{Theme.dim('hide help')}\n"
+        else
+          keys = [
+            ['↑↓', 'nav'], ['g', 'gen'], ['G', 'alt'], ['b', 'batch'],
+            ['t', 'tmpl'], ['m', 'enter'], ['c', 'clear'], ['?', 'help']
+          ].map { |k, l| "#{Theme.kbd(k)} #{Theme.dim(l)}" }.join('  ')
+          hint = "  #{bar} #{count}   #{keys}\n"
+        end
+        hint
+      end
+
+      private_class_method def self.rpad(str, width)
+        vl = str.gsub(/\e\[[0-9;]*[mJHABCDsuK]/, '').length
+        str + (' ' * [width - vl, 0].max)
+      end
+    end
+  end
+end
+
+# rubocop:enable Metrics/AbcSize, Metrics/MethodLength

data/lib/easy_creds/views/local_menu.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module EasyCreds
+  module Views
+    module LocalMenu
+      def self.ask(prompt, env)
+        choices = [
+          { name: "  #{Theme.bold('status')}      #{Theme.dim('─')} show local overlay file + key presence",
+            value: :status },
+          { name: "  #{Theme.bold('init')}        #{Theme.dim('─')} create #{env}_local.yml.enc + key",
+            value: :init },
+          { name: Theme.dim('  ─────────────────────────────────────────────'),
+            value: nil, disabled: '' },
+          { name: "  #{Theme.bold('edit')}        #{Theme.dim('─')} interactive key-by-key editor (local)",
+            value: :edit },
+          { name: "  #{Theme.bold('editor-edit')} #{Theme.dim('─')} open local YAML in $EDITOR",
+            value: :editor_edit },
+          { name: "  #{Theme.bold('sync-key')}    #{Theme.dim('─')} push/pull #{env}_local.key to 1Password",
+            value: :sync_key },
+          { name: Theme.dim('  ─────────────────────────────────────────────'),
+            value: nil, disabled: '' },
+          { name: "  #{Theme.dim("delete      ─ remove #{env}_local.yml.enc + .key")}",
+            value: :delete },
+          { name: "  #{Theme.dim('back        ─ return to main menu')}",
+            value: :back }
+        ]
+
+        prompt.select(
+          "\nLocal overlay — #{Theme.env_tag(env)}:",
+          choices,
+          cycle: true,
+          filter: false,
+          per_page: choices.size
+        )
+      end
+    end
+  end
+end

data/lib/easy_creds/views/menu.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module EasyCreds
+  module Views
+    module Menu
+      def self.ask(prompt)
+        p = Theme.pastel
+
+        choices = [
+          # ── Inspect ───────────────────────────────────────────────────────
+          { name: Theme.dim('  ── Inspect ──────────────────────────────────'),
+            value: nil, disabled: '' },
+          { name: "  #{Theme.bold('status')}    #{Theme.dim('─')} show local vs 1Password drift",
+            value: :status },
+
+          # ── Sync ──────────────────────────────────────────────────────────
+          { name: Theme.dim('  ── Sync ─────────────────────────────────────'),
+            value: nil, disabled: '' },
+          { name: "  #{Theme.bold('init')}      #{Theme.dim('─')} bootstrap credentials from example.yml",
+            value: :init },
+          { name: "  #{Theme.bold('push')}      #{Theme.dim('─')} #{Theme::ICONS[:push]} local → 1Password",
+            value: :push },
+          { name: "  #{Theme.bold('pull')}      #{Theme.dim('─')} #{Theme::ICONS[:pull]} 1Password → local",
+            value: :pull },
+
+          # ── Edit ──────────────────────────────────────────────────────────
+          { name: Theme.dim('  ── Edit ─────────────────────────────────────'),
+            value: nil, disabled: '' },
+          { name: "  #{Theme.bold('edit')}      #{Theme.dim('─')} interactive key-by-key editor",
+            value: :edit },
+          { name: "  #{Theme.bold('editor')}    #{Theme.dim('─')} open decrypted YAML in $EDITOR",
+            value: :editor_edit },
+
+          # ── Other ─────────────────────────────────────────────────────────
+          { name: Theme.dim('  ─────────────────────────────────────────────'),
+            value: nil, disabled: '' },
+          { name: "  #{Theme.bold('local')}     #{Theme.dim('─')} manage encrypted local override",
+            value: :local },
+          { name: "  #{Theme.bold('switch')}    #{Theme.dim('─')} change environment",
+            value: :switch },
+          { name: "  #{Theme.dim('quit')}",
+            value: :quit }
+        ]
+
+        prompt.select(
+          "\nWhat would you like to do?",
+          choices,
+          cycle: true,
+          filter: false,
+          per_page: choices.size
+        )
+      end
+    end
+  end
+end

data/lib/easy_creds/views/project_picker.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module EasyCreds
+  module Views
+    module ProjectPicker
+      # Returns a Projects::Project, :init_here, :templates, :settings, or :quit
+      def self.ask(prompt, registry)
+        choices = []
+
+        if registry.projects.any?
+          choices << { name: Theme.dim('  ── Registered projects ──────────────────────'),
+                       value: nil, disabled: '' }
+          registry.projects
+                  .sort_by { |pr| -(pr.last_seen_at&.to_i || 0) }
+                  .each { |pr| choices << { name: project_row(pr), value: pr } }
+        end
+
+        choices << { name: Theme.dim('  ── Actions ──────────────────────────────────'),
+                     value: nil, disabled: '' }
+        choices << { name: "  #{Theme.bold('init here')}     #{Theme.dim('─')} register current directory as a project",
+                     value: :init_here }
+        choices << { name: "  #{Theme.bold('templates')}     #{Theme.dim('─')} manage global template library",
+                     value: :templates }
+        choices << { name: "  #{Theme.bold('settings')}      #{Theme.dim('─')} edit global easy_creds config",
+                     value: :settings }
+        choices << { name: "  #{Theme.dim('quit')}", value: :quit }
+
+        prompt.select(
+          "\nWhat would you like to do?",
+          choices,
+          cycle: true,
+          filter: false,
+          per_page: [choices.size, 20].min
+        )
+      end
+
+      def self.project_row(pr)
+        miss = pr.exists_on_disk? ? '' : "  #{Theme.error('(missing)')}"
+        kind = pr.rails? ? Theme.ok('rails') : Theme.accent('standalone')
+        seen = relative_time(pr.last_seen_at)
+        "  #{Theme.bold(pr.name.ljust(20))} #{kind}  #{Theme.dim(pr.display_path)}  #{Theme.dim(seen)}#{miss}"
+      end
+
+      def self.relative_time(t)
+        return '—' unless t
+
+        secs = Time.now.utc - t.to_time.utc
+        return 'just now' if secs < 60
+        return "#{(secs / 60).to_i}m ago"  if secs < 3_600
+        return "#{(secs / 3_600).to_i}h ago" if secs < 86_400
+
+        "#{(secs / 86_400).to_i}d ago"
+      end
+    end
+  end
+end

data/lib/easy_creds/views/settings_menu.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+
+module EasyCreds
+  module Views
+    module SettingsMenu
+      def self.run(prompt)
+        loop do
+          cfg = EasyCreds.config
+          p   = Theme.pastel
+
+          choice = prompt.select(
+            "\nGlobal settings:",
+            [
+              { name: "  #{p.bold('default vault')}       #{p.dim('─')} #{cfg.default_vault || p.dim('(not set)')}",
+                value: :vault },
+              { name: "  #{p.bold('default template')}    #{p.dim('─')} #{cfg.default_template}",
+                value: :template },
+              { name: "  #{p.bold('default provider')}    #{p.dim('─')} #{cfg.default_provider}",
+                value: :provider },
+              { name: "  #{p.bold('editor')}              #{p.dim('─')} #{cfg.editor || p.dim('($VISUAL/$EDITOR)')}",
+                value: :editor },
+              { name: "  #{p.bold('test 1Password')}      #{p.dim('─')} verify op CLI sign-in",
+                value: :op_test },
+              { name: "  #{p.bold('show paths')}          #{p.dim('─')} display config / template / project locations",
+                value: :paths },
+              { name: "  #{p.bold('prune missing')}       #{p.dim('─')} remove registry entries for deleted paths",
+                value: :prune },
+              { name: "  #{p.dim('back')}", value: :back }
+            ],
+            cycle: true, per_page: 10
+          )
+
+          case choice
+          when :back     then return
+          when :vault    then update_setting(:default_vault,    prompt_vault(prompt))
+          when :template then update_setting(:default_template, prompt_template(prompt))
+          when :provider then update_setting(:default_provider,
+                                            prompt.select('Provider:', [{ name: '1Password', value: :onepassword }]))
+          when :editor   then update_setting(:editor,
+                                            prompt.ask('Editor command:', default: cfg.editor))
+          when :op_test  then run_op_test
+          when :paths    then show_paths(cfg)
+          when :prune    then prune_projects(prompt)
+          end
+        end
+      end
+
+      def self.update_setting(attr, value)
+        return unless value
+
+        EasyCreds.configure { |c| c.public_send(:"#{attr}=", value) }
+        path = File.join(EasyCreds.config.global_dir, 'config.yml')
+        Configuration.write_file!(EasyCreds.config, path)
+        Theme.success("#{attr} → #{value}")
+      end
+
+      def self.prompt_vault(prompt)
+        VaultPicker.pick(prompt)
+      end
+
+      def self.prompt_template(prompt)
+        registry = Templates::Registry.new(global_dir: EasyCreds.config.global_dir)
+        names    = registry.list.map(&:to_s)
+        prompt.select('Select default template:', names, cycle: true)&.to_sym
+      end
+
+      def self.run_op_test
+        if system('op whoami > /dev/null 2>&1')
+          email = `op whoami --format=json 2>/dev/null`.then do |raw|
+            JSON.parse(raw)['email']
+          rescue StandardError
+            '(unknown)'
+          end
+          Theme.success("Signed in to 1Password as #{email}")
+        else
+          Theme.failure('Not signed in to 1Password. Run: op signin')
+        end
+      end
+
+      def self.show_paths(cfg)
+        p = Theme.pastel
+        puts ''
+        puts "  #{p.dim('global dir')}      #{cfg.global_dir}"
+        puts "  #{p.dim('config.yml')}      #{File.join(cfg.global_dir, 'config.yml')}"
+        puts "  #{p.dim('templates')}       #{cfg.resolved_templates_dir}"
+        puts "  #{p.dim('projects.yml')}    #{Projects::Registry.registry_path}"
+        puts ''
+        puts '  Press enter to continue...'
+        $stdin.gets
+      end
+
+      def self.prune_projects(prompt)
+        registry = Projects::Registry.load
+        gone     = registry.prune_missing!
+
+        if gone.empty?
+          Theme.notice('No missing projects found.')
+        else
+          gone.each { |pr| Theme.success("Removed #{pr.name} (#{pr.path})") }
+        end
+      end
+    end
+  end
+end
+
+# rubocop:enable Metrics/MethodLength, Metrics/AbcSize

data/lib/easy_creds/views/templates_menu.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+
+module EasyCreds
+  module Views
+    module TemplatesMenu
+      def self.run(prompt)
+        loop do
+          registry = Templates::Registry.new(global_dir: EasyCreds.config.global_dir)
+          default  = EasyCreds.config.default_template
+
+          choices = build_choices(registry, default)
+          choice  = prompt.select("\nTemplate library:", choices, cycle: true, filter: false,
+                                  per_page: [choices.size, 20].min)
+
+          case choice
+          when nil     then next
+          when :create then create_template(prompt, registry)
+          when :back   then return
+          else
+            template_actions(prompt, registry, choice, default)
+          end
+        end
+      end
+
+      def self.build_choices(registry, default)
+        p       = Theme.pastel
+        choices = [{ name: p.dim('  ── Bundled (read-only) ────────────────────────'),
+                     value: nil, disabled: '' }]
+
+        registry.send(:bundled_names).sort.each do |name|
+          star = name == default ? " #{p.green('[default]')}" : ''
+          choices << { name: "  #{p.bold(name.to_s.ljust(28))} #{p.dim('bundled')}#{star}", value: name }
+        end
+
+        user_names = registry.send(:user_names).sort
+        if user_names.any?
+          choices << { name: p.dim('  ── User templates ─────────────────────────────'),
+                       value: nil, disabled: '' }
+          user_names.each do |name|
+            star = name == default ? " #{p.green('[default]')}" : ''
+            choices << { name: "  #{p.bold(name.to_s.ljust(28))} #{p.dim('user')}#{star}", value: name }
+          end
+        end
+
+        choices << { name: p.dim('  ─────────────────────────────────────────────────'),
+                     value: nil, disabled: '' }
+        choices << { name: "  #{p.bold('create new')}", value: :create }
+        choices << { name: "  #{p.dim('back')}", value: :back }
+        choices
+      end
+
+      def self.template_actions(prompt, registry, name, default)
+        p       = Theme.pastel
+        is_user = registry.user_defined?(name)
+
+        actions = [
+          { name: "  #{p.bold('set as default')}    #{p.dim('─')} mark this as the default template", value: :set_default }
+        ]
+        actions << { name: "  #{p.bold('edit ($EDITOR)')}    #{p.dim('─')} open YAML in $EDITOR", value: :edit_editor }
+        actions << { name: "  #{p.bold('duplicate')}         #{p.dim('─')} copy to user templates dir", value: :duplicate }
+        actions << { name: "  #{p.bold('delete')}            #{p.dim('─')} remove (user templates only)", value: :delete } if is_user
+        actions << { name: "  #{p.dim('back')}", value: :back }
+
+        action = prompt.select("Template: #{p.bold(name.to_s)}", actions, cycle: true)
+
+        case action
+        when :set_default  then set_default(name)
+        when :edit_editor  then edit_in_editor(registry, name)
+        when :duplicate    then duplicate_template(prompt, registry, name)
+        when :delete       then delete_template(prompt, registry, name)
+        end
+      end
+
+      def self.set_default(name)
+        EasyCreds.configure { |c| c.default_template = name }
+        path = File.join(EasyCreds.config.global_dir, 'config.yml')
+        Configuration.write_file!(EasyCreds.config, path)
+        Theme.success("Default template set to #{name}")
+      end
+
+      def self.edit_in_editor(registry, name)
+        path = prepare_user_copy(registry, name)
+        editor = EasyCreds.config.editor || ENV['VISUAL'] || ENV.fetch('EDITOR', 'vi')
+        system("#{editor} #{Shellwords.escape(path)}")
+      end
+
+      def self.prepare_user_copy(registry, name)
+        user_path = File.join(EasyCreds.config.global_dir, 'templates', "#{name}.yml")
+        return user_path if File.exist?(user_path)
+
+        bundled = registry.send(:bundled_path, name)
+        FileUtils.cp(bundled, user_path)
+        Theme.notice("Copied bundled template to #{user_path} — editing your copy.")
+        user_path
+      end
+
+      def self.duplicate_template(prompt, registry, name)
+        new_name = prompt.ask('New template name (used as filename):') do |q|
+          q.validate(/\A[a-z0-9_-]+\z/, 'Use lowercase letters, digits, hyphens, or underscores.')
+        end
+        return unless new_name
+
+        src  = registry.path_for(name)
+        dest = File.join(EasyCreds.config.global_dir, 'templates', "#{new_name}.yml")
+        if File.exist?(dest)
+          Theme.failure("#{dest} already exists.")
+          return
+        end
+        FileUtils.cp(src, dest)
+        Theme.success("Created #{dest}")
+      end
+
+      def self.delete_template(prompt, registry, name)
+        return unless prompt.yes?("Delete template '#{name}'?", default: false)
+
+        registry.delete(name)
+        Theme.success("Deleted #{name}")
+      end
+
+      def self.create_template(prompt, _registry)
+        name = prompt.ask('New template name:') do |q|
+          q.validate(/\A[a-z0-9_-]+\z/, 'Use lowercase letters, digits, hyphens, or underscores.')
+        end
+        return unless name
+
+        dest = File.join(EasyCreds.config.global_dir, 'templates', "#{name}.yml")
+        if File.exist?(dest)
+          Theme.failure("#{dest} already exists.")
+          return
+        end
+        File.write(dest, "# #{name}\n# Add your credential keys below:\n")
+        editor = EasyCreds.config.editor || ENV['VISUAL'] || ENV.fetch('EDITOR', 'vi')
+        system("#{editor} #{Shellwords.escape(dest)}")
+        Theme.success("Created #{dest}")
+      end
+    end
+  end
+end
+
+# rubocop:enable Metrics/MethodLength, Metrics/AbcSize