Feat llm dev

.env.example

@@ -0,0 +1,27 @@
+# Copy this file to `.env` and adjust values for your environment.
+# `.env` is gitignored; this template is committed as a reference.
+# All values are optional — the application has safe defaults.
+# Every key is prefixed with CODE_AGENT_ so it never collides with the
+# provider's own environment variables (e.g. Ollama's OLLAMA_HOST).
+
+# Ollama connection (defaults: http://localhost:11434)
+CODE_AGENT_OLLAMA_SCHEME=http
+CODE_AGENT_OLLAMA_HOST=localhost
+CODE_AGENT_OLLAMA_PORT=11434
+CODE_AGENT_OLLAMA_MODEL=gpt-oss:20b-cloud
+
+# OpenAI (optional; when omitted, OpenAIProvider falls back to OPENAI_API_KEY)
+CODE_AGENT_OPENAI_API_KEY=
+CODE_AGENT_OPENAI_MODEL=gpt-4o
+CODE_AGENT_OPENAI_BASE_URL=
+
+# Sampling / behaviour
+CODE_AGENT_PROVIDER=ollama
+CODE_AGENT_TEMPERATURE=0.7
+CODE_AGENT_MAX_TOKENS=6000
+CODE_AGENT_STREAM=true
+CODE_AGENT_ROOT_DIR=.
+CODE_AGENT_VERBOSE=true
+CODE_AGENT_LOG_LEVEL=INFO
+CODE_AGENT_MAX_ITERATIONS=50
+CODE_AGENT_MAX_EXECUTION_TIME=5000

.gitignore

@@ -2,13 +2,21 @@
 .idea/
 *.iml
 *.ipr
+.*
+apidocs
+stubs/
+th*
+docs/visualizations/*.mmd
+.tmp
+**/pdf_docs
+mermaid-magic.json
 
 # CMake
 cmake-build-*/
-
+_extensions
 # File-based project format
 *.iws
-
+!.pre-commit*
 # IntelliJ
 out/
 
@@ -31,10 +39,12 @@ __pycache__/
 *.so
 
 # Distribution / packaging
+**/node_modules/
 .Python
 build/
 develop-eggs/
 dist/
+node_modules/
 downloads/
 eggs/
 .eggs/
@@ -69,9 +79,6 @@ htmlcov/
 .cache
 nosetests.xml
 coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
 .pytest_cache/
 cover/
 
@@ -80,8 +87,6 @@ cover/
 *.pot
 
 # Django stuff:
-*.log
-local_settings.py
 db.sqlite3
 db.sqlite3-journal
 
@@ -100,7 +105,7 @@ docs/_build/
 
 # IPython
 profile_default/
-ipython_config.py
+# ipython_config.py # temp disabled during this work
 
 # pyenv
 #   For a library or package, you might want to ignore these files since the code is
@@ -216,3 +221,9 @@ _site/
 docs/docs_web/
 /renv/.gitignore
 /renv/activate.R
+
+# MemPalace per-project files (issue #185)
+mempalace.yaml
+entities.json
+/.tmp/
+pdf_docs/

.pre-commit-config.yaml

@@ -1,27 +1,58 @@
 exclude: '^packrat(/|$)'  # Exclude the packrat folder
-
 repos:
+   # Local hooks must be defined inline (repo: local does not read
+  # .pre-commit-hooks.yaml); the script entries live in project_management/.
+  - repo: local
+    hooks:
+      # - id: run-autofix
+      #   name: run-autofix
+      #   entry: project_management/run_autofix.sh
+      #   language: script
+      #   stages: [pre-commit, manual]
+      - id: pre-push-quick
+        name: pre-push-quick
+        entry: pre-push-quick
+        language: script
+        stages: [pre-push, manual]
+      - id: run-formatters
+        name: run-formatters
+        entry: project_management/run_formatters.sh
+        language: script
+        stages: [pre-push, manual]
+      - id: run-vis
+        name: run-vis
+        entry: project_management/run_vis.sh
+        language: script
+        stages: [pre-push, manual]
+      - id: run-analyzers
+        name: run-analyzers
+        entry: project_management/run_analyzers.sh
+        language: script
+        stages: [manual]
+
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
     hooks:
-      - id: trailing-whitespace
-      - id: end-of-file-fixer
       - id: check-yaml
-      - id: requirements-txt-fixer
+      - id: check-added-large-files
+      - id: check-builtin-literals
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: check-shebang-scripts-are-executable
+      - id: check-merge-conflict
+      - id: check-symlinks
+      - id: check-vcs-permalinks
+      - id: debug-statements
+      - id: check-toml
+      - id: check-ast
+      - id: destroyed-symlinks
+      - id: sort-simple-yaml
   - repo: https://github.com/asottile/setup-cfg-fmt
-    rev: v3.1.0
+    rev: v3.2.0
     hooks:
       - id: setup-cfg-fmt
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.21.0
+    rev: v3.21.2
     hooks:
       - id: pyupgrade
         args: [ --py310-plus ]
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    # Ruff version.
-    rev: v0.14.3
-    hooks: # Run the linter.
-      - id: ruff-check
-        args: [ --fix ]
-        # Run the formatter.
-      - id: ruff-format