personality 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 972d9bf070fc2adb6ff1c9f74e848d149f187009da323ff57e05db830deaa7ae
-  data.tar.gz: 032e91ed47c22b7ce7bfd80e9aeea49e24ca2b725519bd753642d99d15e257b0
+  metadata.gz: aade948f54c7dc05e1cbbbe4b080c0ab2f512e7754f0c105083da6d5c2cb8fe2
+  data.tar.gz: 4dd893cc5fe35fc7c7922d656d67b3c4c1ebcb5871909886bcca9afc32e53f57
 SHA512:
-  metadata.gz: a206366eac85dd5cf06b4e3ceb439357864f7f3d93e4eeadf4fda22e651712014b0d15c87f1b611faff95a8b8c4c31c2b662a095b7f17f925c34091fa5888699
-  data.tar.gz: 7f69b0935390d8e2164473510faca1612550a2fd4d4fc6955fcb7eb26a4ebc9b2c469aa930bef0e0b25e6a82f9fb43d43f75c69cbe1b8c7c90a7e4347408572d
+  metadata.gz: 63345439767b800d1acbd2244faaa15aa55165ad85d16c5ef113ef55e39ff08b10eb6e95a9fa167dc61b24c7b29d5e20a233547b7cbacb02b1068b4d08fa21f1
+  data.tar.gz: 2c2e7c5935347f285cd515e01ffcfee234f51c8f7dcca326354b12e1ce69ef92be77f45f1d3733534fcf3ee69d6a407c67a984be53333b1de8e985cd3302ec70

data/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__plugin_psn_core__index_clear",
+      "mcp__plugin_psn_core__index_code",
+      "mcp__plugin_psn_core__index_search"
+    ]
+  }
+}

data/README.md

@@ -1,35 +1,114 @@
 # Personality
 
-TODO: Delete this and the text below, and describe your gem
+Infrastructure layer for [Claude Code](https://docs.anthropic.com/en/docs/claude-code): persistent memory with vector search, code/doc indexing, TTS, persona management, and MCP server.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/personality`. To experiment with that code, run `bin/console` for an interactive prompt.
+[![Gem Version](https://badge.fury.io/rb/personality.svg)](https://rubygems.org/gems/personality)
+[![CI](https://github.com/aladac/personality/actions/workflows/main.yml/badge.svg)](https://github.com/aladac/personality/actions/workflows/main.yml)
+
+## Features
+
+- **Memory** — Cart-scoped persistent memory with vector similarity search
+- **Code/Doc Indexing** — Semantic search across codebases and documentation
+- **TTS** — Text-to-speech via piper-tts with voice management
+- **Personas** — Cartridge-based persona system with identity, preferences, and memories
+- **MCP Server** — 18 tools and 3 resources over stdio transport
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+```bash
+gem install personality
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "personality"
+```
+
+### Dependencies
 
-Install the gem and add to the application's Gemfile by executing:
+| Dependency | Purpose |
+|------------|---------|
+| [Ollama](https://ollama.com) | Embeddings (nomic-embed-text) |
+| [piper-tts](https://github.com/rhasspy/piper) | Text-to-speech synthesis |
+| SQLite | Database (bundled via sqlite3 gem) |
+
+## Usage
+
+### CLI
 
 ```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+psn help                          # Show all commands
+psn memory store SUBJECT CONTENT  # Store a memory
+psn memory recall QUERY           # Recall by similarity
+psn index code ./src              # Index code for search
+psn index search "auth handler"   # Semantic code search
+psn tts speak "Hello world"       # Speak text aloud
+psn cart list                     # List personas
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+### MCP Server
+
+Start the MCP server for Claude Code integration:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+psn-mcp
 ```
 
-## Usage
+Tools use dot notation: `memory.store`, `memory.recall`, `index.search`, `cart.use`, etc.
+
+### As a Claude Code Plugin
+
+Add to your Claude Code `settings.json`:
 
-TODO: Write usage instructions here
+```json
+{
+  "plugins": ["personality"]
+}
+```
+
+## Architecture
+
+Service objects hold all logic. CLI and MCP are thin wrappers.
+
+```
+lib/personality/
+  db.rb          # SQLite + sqlite-vec, migrations
+  embedding.rb   # Ollama HTTP client (nomic-embed-text, 768 dims)
+  chunker.rb     # Text splitting (2000 chars, 200 overlap)
+  memory.rb      # Vector memory (cart-scoped)
+  indexer.rb     # Code/doc indexing + semantic search
+  cart.rb        # Persona management
+  tts.rb         # Piper TTS synthesis + playback
+  mcp/server.rb  # MCP server (official mcp gem)
+```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```bash
+bundle install
+bundle exec rake          # Run tests + linter
+bundle exec rspec         # Tests only
+bundle exec standardrb    # Linter only
+```
+
+Tests stub external dependencies (Ollama, piper) — no services needed to run the suite.
+
+## Releasing
+
+Push a stable version tag to trigger the release workflow:
+
+```bash
+# Update lib/personality/version.rb, then:
+git commit -am "Bump version to X.Y.Z"
+git tag vX.Y.Z
+git push && git push origin vX.Y.Z
+```
+
+This publishes to [RubyGems](https://rubygems.org/gems/personality), [GitHub Packages](https://github.com/aladac/personality/packages), and creates a [GitHub Release](https://github.com/aladac/personality/releases) with the `.gem` attached.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Pre-release versions (e.g. `v0.2.0.pre1`) are not published.
 
-## Contributing
+## License
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/personality.
+[MIT](LICENSE.txt)

data/exe/psn-http

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "personality"
+require "personality/mcp/rack_app"
+require "personality/mcp/oauth"
+require "rack"
+require "rack/handler/puma"
+
+host = ENV.fetch("PSN_HOST", "127.0.0.1")
+port = ENV.fetch("PSN_PORT", "8081").to_i
+base_url = ENV.fetch("PSN_BASE_URL", "https://psn.saiden.dev")
+
+# OAuth credentials
+client_id = Personality::MCP::OAuth::CLIENT_ID
+client_secret = Personality::MCP::OAuth::CLIENT_SECRET
+
+app = Personality::MCP::RackApp.new(base_url: base_url)
+
+puts "Starting PSN MCP HTTP server on #{host}:#{port}"
+puts "Base URL: #{base_url}"
+puts ""
+puts "OAuth Credentials (for claude.ai):"
+puts "  Client ID:     #{client_id}"
+puts "  Client Secret: #{client_secret}"
+puts ""
+
+Rack::Handler::Puma.run(app, Host: host, Port: port, Verbose: true)

data/exe/psn-mcp

@@ -4,4 +4,18 @@
 require "personality"
 require "personality/mcp/server"
 
-Personality::MCP::Server.run
+# Parse --mode argument
+mode = :all
+ARGV.each_with_index do |arg, i|
+  if arg == "--mode" && ARGV[i + 1]
+    mode = ARGV[i + 1].to_sym
+  elsif arg.start_with?("--mode=")
+    mode = arg.split("=", 2).last.to_sym
+  elsif arg == "--indexer-only"
+    mode = :indexer
+  elsif arg == "--core-only"
+    mode = :core
+  end
+end
+
+Personality::MCP::Server.run(mode: mode)

data/exe/psn-voice

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "personality"
+require "personality/mcp/voice_server"
+
+Personality::MCP::VoiceServer.run

data/lib/personality/cart.rb

@@ -5,6 +5,7 @@ require_relative "db"
 module Personality
   class Cart
     DEFAULT_TAG = "default"
+    CONFIG_PATH = File.join(Dir.home, ".config", "psn", "config.toml")
 
     class << self
       def find_or_create(tag)
@@ -23,7 +24,7 @@ module Personality
       end
 
       def active
-        tag = ENV.fetch("PERSONALITY_CART", DEFAULT_TAG)
+        tag = ENV.fetch("PERSONALITY_CART") { configured_cart }
         find_or_create(tag)
       end
 
@@ -57,6 +58,16 @@ module Personality
 
       private
 
+      def configured_cart
+        return DEFAULT_TAG unless File.exist?(CONFIG_PATH)
+
+        require "toml-rb"
+        config = TomlRB.parse(File.read(CONFIG_PATH))
+        config.dig("persona", "cart") || DEFAULT_TAG
+      rescue => _e
+        DEFAULT_TAG
+      end
+
       def row_to_hash(row)
         {
           id: row["id"],

data/lib/personality/cart_manager.rb

@@ -225,7 +225,7 @@ module Personality
         [cart.version, cart.preferences.identity.source, cart.preferences.identity.name, cart.preferences.identity.type, cart.preferences.identity.tagline, db_cart[:id]]
       )
 
-      mem = Memory.new
+      mem = Memory.new(cart_id: db_cart[:id])
       stored = 0
       skipped = 0
 

data/lib/personality/cli/index.rb

@@ -11,17 +11,35 @@ module Personality
         require_relative "../indexer"
         require_relative "../db"
         require "pastel"
-        require "tty-spinner"
+        require "tty-progressbar"
 
         DB.migrate!
         pastel = Pastel.new
-        spinner = TTY::Spinner.new("  :spinner Indexing code...", format: :dots)
-        spinner.auto_spin
-
-        result = Personality::Indexer.new.index_code(path: path, project: options[:project])
+        bar = nil
+
+        result = Personality::Indexer.new.index_code(path: path, project: options[:project]) do |file, current, total|
+          if bar.nil?
+            bar = TTY::ProgressBar.new(
+              "  Indexing [:bar] :current/:total :percent",
+              total: total,
+              width: 30,
+              complete: "█",
+              incomplete: "░",
+              hide_cursor: false,
+              clear: false
+            )
+          end
+          bar.current = current
+          # Show current file on line below progress bar, then cursor back up
+          filename = File.basename(file)
+          $stdout.print "\n  #{pastel.dim(filename.slice(0, 60).ljust(60))}\e[K\e[A\r"
+          $stdout.flush
+        end
 
-        spinner.success(pastel.green("done"))
-        puts "  #{pastel.bold(result[:project])}: #{result[:indexed]} chunks indexed"
+        # Clear filename line (move down, clear, move up) and finish
+        $stdout.print "\n\e[K\e[A"
+        bar&.finish
+        puts "  #{pastel.bold(result[:project])}: #{pastel.green(result[:indexed])} chunks indexed"
         if result[:errors].any?
           puts pastel.yellow("  Errors (#{result[:errors].length}):")
           result[:errors].each { |e| puts "    #{e}" }
@@ -34,17 +52,35 @@ module Personality
         require_relative "../indexer"
         require_relative "../db"
         require "pastel"
-        require "tty-spinner"
+        require "tty-progressbar"
 
         DB.migrate!
         pastel = Pastel.new
-        spinner = TTY::Spinner.new("  :spinner Indexing docs...", format: :dots)
-        spinner.auto_spin
-
-        result = Personality::Indexer.new.index_docs(path: path, project: options[:project])
+        bar = nil
+
+        result = Personality::Indexer.new.index_docs(path: path, project: options[:project]) do |file, current, total|
+          if bar.nil?
+            bar = TTY::ProgressBar.new(
+              "  Indexing [:bar] :current/:total :percent",
+              total: total,
+              width: 30,
+              complete: "█",
+              incomplete: "░",
+              hide_cursor: false,
+              clear: false
+            )
+          end
+          bar.current = current
+          # Show current file on line below progress bar, then cursor back up
+          filename = File.basename(file)
+          $stdout.print "\n  #{pastel.dim(filename.slice(0, 60).ljust(60))}\e[K\e[A\r"
+          $stdout.flush
+        end
 
-        spinner.success(pastel.green("done"))
-        puts "  #{pastel.bold(result[:project])}: #{result[:indexed]} chunks indexed"
+        # Clear filename line (move down, clear, move up) and finish
+        $stdout.print "\n\e[K\e[A"
+        bar&.finish
+        puts "  #{pastel.bold(result[:project])}: #{pastel.green(result[:indexed])} chunks indexed"
         if result[:errors].any?
           puts pastel.yellow("  Errors (#{result[:errors].length}):")
           result[:errors].each { |e| puts "    #{e}" }

data/lib/personality/cli/tts.rb

@@ -7,11 +7,12 @@ module Personality
     class Tts < Thor
       desc "speak TEXT", "Speak text aloud"
       option :voice, type: :string, aliases: "-v", desc: "Voice model name"
+      option :language, type: :string, aliases: "-l", desc: "Language code (en, pl)"
       def speak(text)
         require_relative "../tts"
         require "pastel"
 
-        result = Personality::TTS.speak_and_wait(text, voice: options[:voice])
+        result = Personality::TTS.speak_and_wait(text, voice: options[:voice], language: options[:language])
         if result[:error]
           puts Pastel.new.red(result[:error])
           exit 1
@@ -124,14 +125,38 @@ module Personality
 
         pastel = Pastel.new
         voice = Personality::TTS.active_voice
+        backend = Personality::TTS.backend
+
+        puts "#{pastel.bold("Backend:")} #{backend}"
         puts "#{pastel.bold("Voice:")} #{voice}"
         if Personality::TTS.find_voice(voice)
-          puts "#{pastel.green("✓")} Installed"
+          puts "#{pastel.green("✓")} Available"
+        elsif backend == "xtts"
+          puts "#{pastel.yellow("!")} Voice not found on XTTS host"
         else
           puts "#{pastel.yellow("!")} Not installed — run: psn tts download #{voice}"
         end
       end
 
+      desc "backend", "Show TTS backend info"
+      def backend
+        require_relative "../tts"
+        require "pastel"
+
+        pastel = Pastel.new
+        backend = Personality::TTS.backend
+
+        puts "#{pastel.bold("Backend:")} #{backend}"
+        if backend == "xtts"
+          puts "#{pastel.bold("Host:")} #{Personality::TTS::XTTS_HOST}"
+          puts "#{pastel.bold("Project:")} #{Personality::TTS::XTTS_PROJECT}"
+          puts pastel.dim("\nSet TTS_BACKEND=piper to use local piper")
+        else
+          puts "#{pastel.bold("Voices dir:")} #{Personality::TTS::VOICES_DIR}"
+          puts pastel.dim("\nSet TTS_BACKEND=xtts to use XTTS on junkpile")
+        end
+      end
+
       def self.exit_on_failure?
         true
       end

data/lib/personality/indexer.rb

@@ -9,8 +9,17 @@ module Personality
   class Indexer
     CODE_EXTENSIONS = %w[.py .rs .rb .js .ts .go .java .c .cpp .h].to_set.freeze
     DOC_EXTENSIONS = %w[.md .txt .rst .adoc].to_set.freeze
-
-    def index_code(path:, project: nil, extensions: nil)
+    EXCLUDED_DIRS = %w[
+      target dist build out _build deps
+      node_modules vendor .bundle
+      __pycache__ .venv venv env .env
+      .git .hg .svn
+      coverage .nyc_output
+      .next .turbo .cargo .cache
+      tmp log logs
+    ].to_set.freeze
+
+    def index_code(path:, project: nil, extensions: nil, &block)
       dir = File.expand_path(path)
       proj = project || File.basename(dir)
       exts = if extensions
@@ -19,14 +28,14 @@ module Personality
         CODE_EXTENSIONS
       end
 
-      index_files(dir, proj, exts, table: "code_chunks", vec_table: "vec_code", language: true)
+      index_files(dir, proj, exts, table: "code_chunks", vec_table: "vec_code", language: true, &block)
     end
 
-    def index_docs(path:, project: nil)
+    def index_docs(path:, project: nil, &block)
       dir = File.expand_path(path)
       proj = project || File.basename(dir)
 
-      index_files(dir, proj, DOC_EXTENSIONS, table: "doc_chunks", vec_table: "vec_docs", language: false)
+      index_files(dir, proj, DOC_EXTENSIONS, table: "doc_chunks", vec_table: "vec_docs", language: false, &block)
     end
 
     def search(query:, type: :all, project: nil, limit: 10)
@@ -91,13 +100,22 @@ module Personality
 
     private
 
-    def index_files(dir, project, extensions, table:, vec_table:, language:)
+    def index_files(dir, project, extensions, table:, vec_table:, language:, &block)
       indexed = 0
       errors = []
 
-      Dir.glob(File.join(dir, "**", "*")).each do |file_path|
-        next unless File.file?(file_path)
-        next unless extensions.include?(File.extname(file_path).downcase)
+      # Collect files first for progress reporting, excluding build/vendor dirs
+      files = Dir.glob(File.join(dir, "**", "*")).select do |file_path|
+        next false unless File.file?(file_path)
+        next false unless extensions.include?(File.extname(file_path).downcase)
+        # Skip files in excluded directories
+        path_parts = file_path.sub("#{dir}/", "").split("/")
+        !path_parts.any? { |part| EXCLUDED_DIRS.include?(part) }
+      end
+
+      total = files.size
+      files.each_with_index do |file_path, idx|
+        yield(file_path, idx + 1, total) if block_given?
 
         begin
           lang = language ? File.extname(file_path).downcase[1..] : nil