kscli 1.1.0__tar.gz

kscli-1.1.0/.github/workflows/workflow.yml

@@ -0,0 +1,180 @@
+name: Test
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches:
+      - main
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || !startsWith(github.event.head_commit.message, 'chore(release):')
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Cache virtual environment
+        uses: actions/cache@v4
+        id: cache-venv
+        with:
+          path: .venv
+          key: venv-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+          restore-keys: |
+            venv-${{ runner.os }}-
+
+      - name: Install dev dependencies
+        run: uv sync --all-extras --group dev
+
+      - name: Run ruff check
+        run: make lint
+
+      - name: Run type checker
+        run: make typecheck
+
+  e2e:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || !startsWith(github.event.head_commit.message, 'chore(release):')
+    steps:
+      - name: Generate GitHub App token
+        uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.RELEASE_GH_APP_ID }}
+          private-key: ${{ secrets.RELEASE_GH_APP_PRIVATE_KEY }}
+          owner: ${{ github.repository_owner }}
+          repositories: ks-backend
+
+      - name: Checkout ks-cli
+        uses: actions/checkout@v6
+        with:
+          path: ks-cli
+
+      - name: Checkout ks-backend
+        uses: actions/checkout@v6
+        with:
+          repository: knowledgestack/ks-backend
+          token: ${{ steps.app-token.outputs.token }}
+          path: ks-backend
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: |
+            ks-backend/uv.lock
+            ks-cli/uv.lock
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install ks-backend dependencies
+        working-directory: ks-backend
+        run: make install-dev
+
+      - name: Create shared email directory
+        run: mkdir -p /tmp/ks/e2e-testing/emails && chmod 777 /tmp/ks/e2e-testing/emails
+
+      - name: Start e2e stack
+        working-directory: ks-backend
+        run: make e2e-stack
+
+      - name: Seed database
+        working-directory: ks-backend
+        run: make e2e-prep
+
+      - name: Install ks-cli dependencies
+        working-directory: ks-cli
+        run: uv sync --all-extras --group dev
+
+      - name: Run e2e tests
+        working-directory: ks-cli
+        run: make e2e-test
+
+  release:
+    runs-on: ubuntu-latest
+    environment: "production"
+    concurrency:
+      group: release
+      cancel-in-progress: false
+    needs: [lint, e2e]
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Generate release token
+        uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.RELEASE_GH_APP_ID }}
+          private-key: ${{ secrets.RELEASE_GH_APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v6
+        with:
+          ref: main
+          token: ${{ steps.app-token.outputs.token }}
+          persist-credentials: true
+          fetch-depth: 0
+
+      - name: Setup | Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install dev dependencies
+        run: uv sync
+
+      - name: Get current version
+        id: current-version
+        run: |
+          REPO_VERSION=$(uv version --short)
+          echo "Detected current version=${REPO_VERSION}"
+          echo "prevtag=v${REPO_VERSION}" >> $GITHUB_OUTPUT
+
+      # Don't use the official python-semantic-release action because it's too slow
+      - name: Run semantic-release
+        id: semantic-release
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }} # For release publishing
+        run: |
+          uvx python-semantic-release -c semantic_release.toml version --vcs-release --changelog
+          NEW_TAG=$(uvx python-semantic-release -c semantic_release.toml version --print-tag)
+          echo "Current semantic release tag=${NEW_TAG}"
+          echo "tag=$NEW_TAG" >> $GITHUB_OUTPUT
+
+      - name: Check for build artifacts
+        id: check-dist
+        run: |
+          if ls dist/*.whl dist/*.tar.gz 1>/dev/null 2>&1; then
+            echo "has_dist=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_dist=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Publish to PyPI
+        if: steps.check-dist.outputs.has_dist == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1

kscli-1.1.0/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

kscli-1.1.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: local
+    hooks:
+      - id: lint_fix
+        name: ruff check --fix
+        entry: make fix
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: typecheck
+        name: basedpyright typecheck
+        entry: make typecheck
+        language: system
+        pass_filenames: false
+        always_run: true

kscli-1.1.0/.serena/.gitignore

@@ -0,0 +1 @@
+/cache

kscli-1.1.0/.serena/memories/project_overview.md

@@ -0,0 +1,64 @@
+# Project Overview
+
+## Purpose
+`ks-cli` (kscli) is a CLI tool for the Knowledge Stack platform. It wraps the auto-generated `ksapi` Python SDK with a Click-based command interface using a verb-first routing pattern (e.g. `kscli get folders`, `kscli describe document <id>`).
+
+## Tech Stack
+- **Language**: Python 3.14+
+- **Runtime/Package Manager**: uv
+- **CLI Framework**: Click
+- **HTTP Client**: httpx (for auth), ksapi SDK (generated, uses urllib3)
+- **Output**: Rich (tables), custom formatters (json, yaml, tree, id-only)
+- **Auth**: JWT-based via admin impersonation (`/v1/auth/assume_user`)
+- **Linting**: Ruff
+- **Type Checking**: basedpyright
+- **Testing**: pytest (e2e tests via subprocess)
+- **Releases**: semantic-release with conventional commits
+
+## Codebase Structure
+```
+src/kscli/
+├── cli.py              # Root CLI group, verb-first routing, command registration
+├── client.py           # SDK client helpers (get_api_client, handle_client_errors, to_dict)
+├── auth.py             # Credential caching, JWT token management, assume_user
+├── config.py           # Layered config: env vars → config file → defaults
+├── output.py           # Output formatters: table, json, yaml, id-only, tree
+├── __main__.py         # Entry point
+└── commands/
+    ├── auth.py         # assume-user, whoami
+    ├── settings.py     # settings environment, settings show
+    ├── folders.py      # Folder CRUD
+    ├── documents.py    # Document CRUD + ingest
+    ├── versions.py     # Version CRUD + contents
+    ├── sections.py     # Section CRUD
+    ├── chunks.py       # Chunk CRUD + search
+    ├── chunk_lineages.py
+    ├── path_parts.py   # Read-only
+    ├── tags.py         # Tag CRUD + attach/detach
+    ├── tenants.py      # Tenant CRUD + user listing
+    ├── invites.py      # Invite CRUD + accept
+    ├── permissions.py  # Permission CRUD
+    ├── threads.py      # Thread/message CRUD
+    └── workflows.py    # Workflow listing + actions
+
+tests/
+├── conftest.py         # Fixtures (cli_env, cli_authenticated)
+├── cli_helpers.py      # Subprocess helpers (run_kscli, run_kscli_ok, run_kscli_fail)
+└── test_cli_*.py       # E2e tests per resource
+```
+
+## Key Architecture Patterns
+
+### Verb-first CLI routing
+Commands are organized as `kscli <verb> <resource>`. Verb groups (get, describe, create, update, delete, search, etc.) are defined in `cli.py`. Each resource module exposes `register_<verb>(group)` functions that add Click commands to those groups.
+
+### Command implementation pattern
+Every command follows this pattern:
+1. Get authenticated client: `api_client = get_api_client(ctx)`
+2. Wrap in error handling: `with handle_client_errors():`
+3. Instantiate SDK API: `api = ksapi.<Resource>Api(api_client)`
+4. Call SDK method and format: `print_result(ctx, to_dict(result), columns=COLUMNS)`
+
+### Config layering
+Environment variables → `~/.config/kscli/config.json` → defaults.
+Key env vars: `KSCLI_BASE_URL`, `ADMIN_API_KEY`, `KSCLI_FORMAT`, `KSCLI_VERIFY_SSL`, `KSCLI_CA_BUNDLE`, `KSCLI_CONFIG`, `KSCLI_CREDENTIALS_PATH`.

kscli-1.1.0/.serena/memories/style_and_conventions.md

@@ -0,0 +1,32 @@
+# Style and Conventions
+
+## Code Style
+- **Line length**: 88 characters
+- **Quote style**: Double quotes
+- **Indent style**: Spaces
+- **Docstrings**: Google convention (when present; most D1xx rules are ignored)
+- **Type hints**: Used throughout; checked with basedpyright
+- **Imports**: isort-managed, first-party packages: `shared_utils`, `database_schema`, `private_api_client`
+
+## Ruff Rules
+Extensive rule set enabled (E, W, F, I, UP, B, C4, DTZ, T10, G, PIE, PT, RET, SIM, TCH, ARG, PTH, ERA, PD, PGH, PL, RUF, D). Notable ignores:
+- All missing docstring rules (D100-D107) are ignored
+- E501 (line length) ignored — handled by formatter
+- B008 (function call in default argument) ignored — common in Click/FastAPI
+- Tests allow assert, unused args (fixtures), magic values
+
+## Naming Conventions
+- Command modules: `src/kscli/commands/<resource>.py`
+- Test files: `tests/test_cli_<resource>.py`
+- Registration functions: `register_<verb>(group: click.Group)`
+- Column definitions: `COLUMNS = [...]` at module level
+
+## Design Patterns
+- **Verb-first routing**: Commands registered as `<verb> <resource>`, not `<resource> <verb>`
+- **Registration pattern**: Each module exposes `register_<verb>()` functions, wired in `cli.py`
+- **Error handling**: Always use `with handle_client_errors():` context manager around API calls
+- **SDK usage**: `ksapi` is auto-generated — never modify it directly
+- **Output**: Always pass through `to_dict()` → `print_result()` pipeline
+
+## Commit Convention
+Conventional commits (semantic-release): `feat:`, `fix:`, `perf:`, `chore:`, `ci:`, `docs:`, `style:`, `refactor:`, `test:`

kscli-1.1.0/.serena/memories/suggested_commands.md

@@ -0,0 +1,44 @@
+# Suggested Commands
+
+## Development Setup
+```bash
+uv sync --all-extras --group dev     # Install all dependencies
+uv run pre-commit install            # Install pre-commit hooks
+```
+
+## Linting & Formatting
+```bash
+uv run ruff check                    # Lint
+uv run ruff check --fix              # Lint + autofix
+uv run ruff format                   # Format code
+```
+
+## Type Checking
+```bash
+uv run basedpyright --stats          # Type check
+```
+
+## Testing
+```bash
+uv run pytest                        # Run all tests
+uv run pytest tests/test_cli_folders.py  # Single test file
+uv run pytest tests/test_cli_folders.py::TestCliFolders::test_get_folders_root  # Single test
+uv run pytest -x                     # Stop on first failure
+```
+
+## Pre-commit (all checks)
+```bash
+make pre-commit                      # Runs lint + typecheck + test
+```
+
+## Running the CLI
+```bash
+uv run kscli --help                  # Show CLI help
+uv run python -m kscli              # Alternative entry point
+```
+
+## System utilities (macOS/Darwin)
+```bash
+git status / git diff / git log      # Git operations
+ls / find / grep                     # File operations (standard unix)
+```

kscli-1.1.0/.serena/memories/task_completion_checklist.md

@@ -0,0 +1,15 @@
+# Task Completion Checklist
+
+After completing a coding task, run these checks:
+
+1. **Lint**: `uv run ruff check` — fix any issues with `uv run ruff check --fix`
+2. **Format**: `uv run ruff format` — ensure code is properly formatted
+3. **Type check**: `uv run basedpyright --stats` — resolve any type errors
+4. **Test**: `uv run pytest` — ensure all tests pass
+
+Or run all at once: `make pre-commit`
+
+## When adding a new resource command
+- Create `src/kscli/commands/<resource>.py` with `register_<verb>()` functions
+- Register the commands in `src/kscli/cli.py` on the appropriate verb groups
+- Add tests in `tests/test_cli_<resource>.py` using `cli_helpers.run_kscli_ok`/`run_kscli_fail`

kscli-1.1.0/.serena/project.yml

@@ -0,0 +1,117 @@
+# the name by which the project can be referenced within Serena
+project_name: "ks-cli"
+
+
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   php_phpactor        powershell          python              python_jedi         r
+#   rego                ruby                ruby_solargraph     rust                scala
+#   swift               terraform           toml                typescript          typescript_vts
+#   vue                 yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   Some languages require additional setup/installations.
+#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- python
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use project's .gitignore files to ignore files
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore in this project.
+# Same syntax as gitignore, so you can use * and **.
+# Note: global ignored_paths from serena_config.yml are also applied additively.
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
+included_optional_tools: []
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+# override of the corresponding setting in serena_config.yml, see the documentation there.
+# If null or missing, the value from the global config is used.
+symbol_info_budget: