personality 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 972d9bf070fc2adb6ff1c9f74e848d149f187009da323ff57e05db830deaa7ae
-  data.tar.gz: 032e91ed47c22b7ce7bfd80e9aeea49e24ca2b725519bd753642d99d15e257b0
+  metadata.gz: 52727e75770170ffc4ba9f49315e446bf4a0a51f7539e6028649321431d7e8b6
+  data.tar.gz: 727ec7aa33ec4a865efdc1bfa8d192e01c6680af5c1810a94e8207e6784e633e
 SHA512:
-  metadata.gz: a206366eac85dd5cf06b4e3ceb439357864f7f3d93e4eeadf4fda22e651712014b0d15c87f1b611faff95a8b8c4c31c2b662a095b7f17f925c34091fa5888699
-  data.tar.gz: 7f69b0935390d8e2164473510faca1612550a2fd4d4fc6955fcb7eb26a4ebc9b2c469aa930bef0e0b25e6a82f9fb43d43f75c69cbe1b8c7c90a7e4347408572d
+  metadata.gz: 52ec7cadad303c775da827d00064a7d932d8e374251927f3b8686d0da30ce1f9d2e713f50d5af5de0298dfb6b0a66c96e56d09bbd2c9f11e588c0ff939da603b
+  data.tar.gz: cf0e4dfea669a3de87bba632c9b47f28794c93b81131070be3a94113e7eb97d5d249e33ccf2f7d578bf83fe8df42e74be24bf60e80193130a4fab5bc4b7edf99

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/LICENSE

@@ -0,0 +1,80 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Adam Ladachowski / Saiden
+Licensed Work:        personality
+                      The Licensed Work is (c) 2026 Adam Ladachowski
+                      
+                      This License applies to each version of the Licensed
+                      Work. A "version" means any release identified by a
+                      git tag (e.g., v1.0.0). All commits between version
+                      tags are considered part of the preceding tagged
+                      version. Commits before the first tag are version 0.0.0.
+
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided Your use does not include offering the
+                      Licensed Work to third parties on a hosted or
+                      embedded basis in a manner that competes with
+                      Saiden's paid products or services.
+
+                      For organizations with annual revenue exceeding
+                      $1,000,000 USD, commercial licensing is required.
+                      Contact: licensing@saiden.dev
+
+Change Date:          Four years from the date of each version's release.
+                      A version's release date is the timestamp of its git
+                      tag. For version 0.0.0, the Change Date is 2030-04-01.
+
+Change License:       MIT
+
+Notice
+
+The Business Source License (this document, or the "License") is not an
+Open Source license. However, the Licensed Work will eventually be made
+available under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

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/hooks.rb

@@ -78,28 +78,11 @@ module Personality
         Personality::Hooks.log("PreCompact", data)
       end
 
-      desc "notification", "Notification hook — log and speak via TTS"
+      desc "notification", "Notification hook — log only"
       def notification
         require_relative "../hooks"
-        require_relative "../tts"
-
         data = Personality::Hooks.read_stdin_json
         Personality::Hooks.log("Notification", data)
-
-        return unless data
-
-        message = data["message"]
-        return if message.nil? || message.empty?
-
-        # Prepend project name for context
-        cwd = data["cwd"] || Dir.pwd
-        project = File.basename(cwd)
-        speech = "#{project}: #{message}"
-
-        Personality::TTS.stop_current
-        Personality::TTS.speak(speech)
-      rescue
-        # Silently continue if TTS fails
       end
 
       desc "install", "Generate hooks.json for Claude Code"

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