powercontext 0.0.1__tar.gz

powercontext-0.0.1/.agents/plugins/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "name": "powercontext",
+  "interface": {
+    "displayName": "PowerContext"
+  },
+  "plugins": [
+    {
+      "name": "powercontext",
+      "source": {
+        "source": "local",
+        "path": "./integrations/codex/plugins/powercontext"
+      },
+      "policy": {
+        "installation": "AVAILABLE"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

powercontext-0.0.1/.dockerignore

@@ -0,0 +1,28 @@
+.git
+.github
+.agents
+.venv
+**/.venv
+.tox
+.pytest_cache
+**/.pytest_cache
+.ruff_cache
+**/.ruff_cache
+.mypy_cache
+.powercontext
+__pycache__
+**/__pycache__
+*.py[cod]
+*.db
+*.sqlite*
+.env
+.env.*
+build
+dist
+site
+docs
+integrations/*
+!integrations/bub
+!integrations/bub/**
+openapi
+tests

powercontext-0.0.1/.env.example

@@ -0,0 +1,39 @@
+# Copy this file to .env, replace the API key, then load it with:
+# set -a; . ./.env; set +a
+
+# Server transport
+POWERCONTEXT_SERVER_HTTP_HOST=127.0.0.1
+POWERCONTEXT_SERVER_HTTP_PORT=8000
+POWERCONTEXT_SERVER_MCP_ENABLED=true
+POWERCONTEXT_SERVER_MCP_PATH=/mcp
+
+# Built-in SQLite database. Use an absolute Vec1 path in deployed environments.
+POWERCONTEXT_SERVER_DATABASE_KIND=sqlite
+POWERCONTEXT_SERVER_DATABASE_URL=sqlite+aiosqlite:///.powercontext/powercontext.db
+POWERCONTEXT_SERVER_DATABASE_VEC1_EXTENSION=.powercontext/vec1.so
+
+# To use OceanBase instead, replace the SQLite database values:
+# POWERCONTEXT_SERVER_DATABASE_KIND=oceanbase
+# POWERCONTEXT_SERVER_DATABASE_URL=mysql+aoceanbase://user:password@host:2881/powercontext?charset=utf8mb4
+
+# Source windows are flushed explicitly unless the optional interval is set.
+POWERCONTEXT_SERVER_RUNTIME_SOURCE_WINDOW_LIMIT=100
+# POWERCONTEXT_SERVER_RUNTIME_SCHEDULE_SECONDS=60
+
+# OpenRouter generation and embeddings
+POWERCONTEXT_SERVER_INFERENCE_GENERATION_MODEL=openrouter:deepseek/deepseek-v4-pro
+POWERCONTEXT_SERVER_INFERENCE_GENERATION_TIMEOUT_SECONDS=30
+POWERCONTEXT_SERVER_INFERENCE_GENERATION_MAX_REQUESTS=2
+POWERCONTEXT_SERVER_INFERENCE_EMBEDDING_MODEL=openrouter:qwen/qwen3-embedding-4b
+POWERCONTEXT_SERVER_INFERENCE_EMBEDDING_PROFILE_ID=openrouter-qwen3-embedding-4b-2560-unit
+POWERCONTEXT_SERVER_INFERENCE_EMBEDDING_DIMENSION=2560
+POWERCONTEXT_SERVER_INFERENCE_EMBEDDING_NORMALIZATION=unit
+POWERCONTEXT_SERVER_INFERENCE_EMBEDDING_TIMEOUT_SECONDS=30
+
+OPENROUTER_API_KEY=replace-me
+OPENROUTER_APP_TITLE=PowerContext
+# OPENROUTER_APP_URL=https://your-application.example
+
+# Client CLI
+POWERCONTEXT_CLIENT_SERVER_URL=http://127.0.0.1:8000
+POWERCONTEXT_CLIENT_TIMEOUT=10

powercontext-0.0.1/.github/ISSUE_TEMPLATE/1-bug-report.yml

@@ -0,0 +1,66 @@
+name: Bug Report
+description: Report a reproducible problem in PowerContext
+title: "bug: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: "Thank you for taking the time to report a bug. Please provide enough detail for maintainers to reproduce and diagnose the issue."
+
+  - type: textarea
+    id: describe-bug
+    attributes:
+      label: Describe the bug
+      description: "A clear and concise description of the problem."
+      placeholder: "Describe what went wrong..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to reproduce
+      description: "List the exact steps, commands, inputs, or environment state needed to reproduce the behavior."
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected behavior
+      description: "Describe what you expected to happen."
+      placeholder: "Explain the expected result..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual behavior
+      description: "Describe what actually happened. Include relevant logs, stack traces, or screenshots."
+      placeholder: "Paste logs or error output here..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: "Share the version, Python runtime, operating system, and any relevant dependency versions."
+      placeholder: |
+        - PowerContext version:
+        - Python version:
+        - OS:
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: willing-to-submit-pr
+    attributes:
+      label: Are you willing to submit a PR to fix this bug?
+      options:
+        - label: "Yes, I would like to submit a PR."

powercontext-0.0.1/.github/ISSUE_TEMPLATE/2-feature-request.yml

@@ -0,0 +1,51 @@
+name: Feature Request
+description: Suggest an improvement or new capability for PowerContext
+title: "feat: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: "Thank you for suggesting an improvement. Substantial changes may be asked to go through the RFC process under `docs/rfcs` before implementation."
+
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: Feature description
+      description: "Describe the capability you would like to see."
+      placeholder: "Describe the feature..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem-solution
+    attributes:
+      label: Problem and proposed solution
+      description: "Explain the problem this solves and how you expect the solution to work."
+      placeholder: "What problem does this solve? What should the user experience or API look like?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: "List any alternative designs, workarounds, or tradeoffs you have considered."
+      placeholder: "Describe alternatives or explain why they are not enough..."
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: "Add any other context, examples, screenshots, or links."
+      placeholder: "Add supporting details here..."
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: willing-to-contribute
+    attributes:
+      label: Are you willing to contribute to this feature?
+      options:
+        - label: "Yes, I am willing to contribute code, docs, or design feedback."

powercontext-0.0.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Discussions
+    url: https://github.com/oceanbase/powercontext/discussions
+    about: Ask questions and discuss ideas before filing an issue.

powercontext-0.0.1/.github/actions/setup-python-env/action.yml

@@ -0,0 +1,30 @@
+name: "Setup Python Environment"
+description: "Set up Python environment for the given Python version"
+
+inputs:
+  python-version:
+    description: "Python version to use"
+    required: true
+    default: "3.12"
+  uv-version:
+    description: "uv version to use"
+    required: true
+    default: "0.10.12"
+
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/setup-python@v6
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v9.0.0
+      with:
+        version: ${{ inputs.uv-version }}
+        enable-cache: 'true'
+        cache-suffix: ${{ matrix.python-version }}
+
+    - name: Install Python dependencies
+      run: uv sync --frozen
+      shell: bash

powercontext-0.0.1/.github/pull_request_template.md

@@ -0,0 +1,41 @@
+# Which issue or RFC does this PR close?
+
+<!--
+Link the related issue or RFC using GitHub syntax.
+For example, `Closes #123` indicates that this PR will close issue #123.
+If this PR implements an RFC, link the RFC and any existing tracking issue.
+-->
+
+Closes #.
+
+# Rationale for this change
+
+<!--
+Explain why this change is needed. If the linked issue or RFC already explains the rationale clearly, a short summary is enough.
+-->
+
+# What changes are included in this PR?
+
+<!--
+Summarize the important changes. Focus on behavior, API, docs, tests, and migration impact.
+-->
+
+# Are there any user-facing changes?
+
+<!--
+If there are user-facing changes, documentation may need to be updated before approval.
+If there are breaking changes to public APIs or persisted formats, call them out explicitly.
+-->
+
+# How was this change tested?
+
+<!--
+List commands run, tests added or updated, and any manual validation performed.
+-->
+
+# AI usage statement
+
+<!--
+If AI tools were used to build this PR, describe the tool and model where possible.
+If not applicable, write `Not used`.
+-->