codepulse-engine 0.1.0__py3-none-any.whl

codepulse/storage/schema_migrations/versions/b9014c049e33_add_api_key_repository_role.py

@@ -0,0 +1,65 @@
+"""add_api_key_repository_role
+
+Revision ID: b9014c049e33
+Revises: 135a7b064ea7
+Create Date: 2026-09-23 00:00:00.000000
+
+Phase 7.2 (roadmap §37 item 7.2: "RBAC roles + repo permission model";
+§15's literal minimal-viable model: "roles `viewer` (search/read),
+`indexer` (viewer + trigger indexing), `admin` (all + manage keys/
+repos). Enforced at the repository-permission level, not globally.").
+Architecture: `role` lives on `api_key_repositories`
+(`APIKeyRepositoryModel`), the per-(key, repository) grant table --
+not on `api_keys` itself -- matching "not globally" literally. See
+`APIKeyRepositoryModel`'s own docstring for the full reasoning.
+
+This migration is purely additive and non-destructive:
+
+  Adds `api_key_repositories.role` (`VARCHAR(20)`, `NOT NULL`,
+  `DEFAULT 'admin'`). Every existing grant row, before this migration,
+  had UNRESTRICTED access to every endpoint that checked repository
+  membership alone (no role concept existed to restrict it) --
+  backfilling every existing row to `'admin'` reflects that row's
+  actual historical capability honestly, not a guess (there is only
+  one historically-correct answer here, unlike an ambiguous backfill
+  elsewhere in this project's history). `codepulse.auth.
+  create_api_key`'s own default for grants created AFTER this
+  migration is intentionally the safer `'viewer'` (least privilege) --
+  a forward-looking application-level default, not a migration
+  concern. SQLite applies the column default to every existing row
+  automatically when a `NOT NULL DEFAULT` column is added.
+
+Uses Alembic "batch" mode (SQLite table-rebuild-under-the-hood),
+matching every prior column-addition migration in this project's
+history.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'b9014c049e33'
+down_revision: Union[str, Sequence[str], None] = '135a7b064ea7'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    with op.batch_alter_table('api_key_repositories', schema=None) as batch_op:
+        batch_op.add_column(
+            sa.Column(
+                'role',
+                sa.String(length=20),
+                nullable=False,
+                server_default='admin',
+            )
+        )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    with op.batch_alter_table('api_key_repositories', schema=None) as batch_op:
+        batch_op.drop_column('role')

codepulse/storage/schema_migrations/versions/c286d277ea21_add_repository_snapshot_model.py

@@ -0,0 +1,62 @@
+"""add_repository_snapshot_model
+
+Revision ID: c286d277ea21
+Revises: de22df2fc3ce
+Create Date: 2026-09-14 20:00:00.000000
+
+Phase 3.1 (roadmap §37 item 3.1: "Git-diff change detection
+(added/modified/deleted)"; §29 Data Model, which explicitly names
+`RepositorySnapshot` as required now: "Required for incremental indexing
+(§9) and crash-safe reads (§17)").
+
+This migration is purely additive and non-destructive: it creates one new
+table (`repository_snapshots`) and touches no existing table, column, or
+row. No `codepulse.db` data is read, transformed, or migrated.
+
+`repository_snapshots`: one row per successful indexing run (a
+run-history table, like `index_jobs` -- no natural-key `UniqueConstraint`)
+-- `commit_sha` records the git commit the repository's content was at
+(`NULL` for a non-git/local-path repository), `embedding_model`/
+`embedding_dim` record what embedding configuration was used. See
+codepulse.storage.db.RepositorySnapshotModel's own docstring for the full
+design rationale, including what this milestone deliberately does NOT
+implement (§17's full crash-safe status-gated read semantics).
+
+Since this is a brand new table, no pre-flight duplicate check is needed
+(unlike prior phases' migrations that added constraints to existing,
+possibly-already-populated tables) -- there is no pre-existing data that
+could violate anything here.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'c286d277ea21'
+down_revision: Union[str, Sequence[str], None] = 'de22df2fc3ce'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.create_table(
+        'repository_snapshots',
+        sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+        sa.Column('repo_id', sa.Integer(), nullable=False),
+        sa.Column('commit_sha', sa.String(length=64), nullable=True),
+        sa.Column('embedding_model', sa.String(length=255), nullable=True),
+        sa.Column('embedding_dim', sa.Integer(), nullable=True),
+        sa.Column('indexed_at', sa.DateTime(), nullable=False),
+        sa.ForeignKeyConstraint(['repo_id'], ['repositories.id'], ondelete='CASCADE'),
+        sa.PrimaryKeyConstraint('id'),
+    )
+    op.create_index(op.f('ix_repository_snapshots_repo_id'), 'repository_snapshots', ['repo_id'], unique=False)
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index(op.f('ix_repository_snapshots_repo_id'), table_name='repository_snapshots')
+    op.drop_table('repository_snapshots')

codepulse/storage/schema_migrations/versions/de22df2fc3ce_add_index_job_model.py

@@ -0,0 +1,59 @@
+"""add_index_job_model
+
+Revision ID: de22df2fc3ce
+Revises: b0bdd63949f4
+Create Date: 2026-09-08 23:46:00.576010
+
+Phase 1.3 (roadmap §37 item 1.3: "IndexJob state machine + /v1/jobs/{id}").
+
+This migration is purely additive and non-destructive: it creates one new
+table (`index_jobs`) and touches no existing table, column, or row. No
+`codepulse.db` data is read, transformed, or migrated.
+
+`index_jobs`: one row per indexing *run* (an event, not an idempotent
+upsert-by-natural-key entity like every other table in this schema) --
+`status` cycles through `queued -> running -> succeeded|failed|cancelled`
+(see codepulse.storage.db.IndexJobModel's docstring). `result_summary`
+holds a JSON-serialized copy of the real, measured result of
+`IndexingEngine.index_directory()` once a job succeeds.
+
+Since this is a brand new table, no pre-flight duplicate check is needed
+(unlike prior phases' migrations that added constraints to existing,
+possibly-already-populated tables) -- there is no pre-existing data that
+could violate anything here.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'de22df2fc3ce'
+down_revision: Union[str, Sequence[str], None] = 'b0bdd63949f4'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.create_table(
+        'index_jobs',
+        sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+        sa.Column('repo_id', sa.Integer(), nullable=False),
+        sa.Column('status', sa.String(length=20), nullable=False),
+        sa.Column('created_at', sa.DateTime(), nullable=False),
+        sa.Column('started_at', sa.DateTime(), nullable=True),
+        sa.Column('finished_at', sa.DateTime(), nullable=True),
+        sa.Column('error_message', sa.Text(), nullable=True),
+        sa.Column('result_summary', sa.Text(), nullable=True),
+        sa.ForeignKeyConstraint(['repo_id'], ['repositories.id'], ondelete='CASCADE'),
+        sa.PrimaryKeyConstraint('id'),
+    )
+    op.create_index(op.f('ix_index_jobs_repo_id'), 'index_jobs', ['repo_id'], unique=False)
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index(op.f('ix_index_jobs_repo_id'), table_name='index_jobs')
+    op.drop_table('index_jobs')

codepulse/storage/schema_migrations/versions/f6e481353553_rename_dependency_to_call_edge_add_confidence.py

@@ -0,0 +1,80 @@
+"""rename_dependency_to_call_edge_add_confidence
+
+Revision ID: f6e481353553
+Revises: c286d277ea21
+Create Date: 2026-09-15 00:00:00.000000
+
+Phase 3.4 (roadmap §37 item 3.4: "CallEdge.confidence scoring"; §11:
+"every `CallEdge` should carry a `confidence` field — `high` when
+resolved through an explicit import mapping to a known file+symbol,
+`low` when resolved only by bare-name match against same-file symbols,
+`unresolved` when the callee couldn't be matched to any known symbol at
+all"; §29 Data Model: "`CallEdge` | Yes (rename from `DependencyModel`,
+add `confidence`) | §11").
+
+This migration:
+
+  1. Renames the `dependencies` table to `call_edges` (matching the
+     roadmap's own target entity name), and renames its two existing
+     indexes to match (`ix_dependencies_*` -> `ix_call_edges_*`, the
+     exact names SQLAlchemy's `index=True` would auto-generate for a
+     model actually named `call_edges` -- kept in sync with what a
+     brand-new database created from today's models would produce).
+  2. Adds a new, nullable `confidence` column.
+
+Non-destructive: every existing row's `id`, `source_symbol_name`,
+`source_file`, `target_symbol_name`, `target_file`, and `call_count`
+value is preserved exactly (a table rename changes no row data at all).
+
+`confidence` is deliberately left NULL for pre-existing rows, not
+backfilled with a guessed value -- CLAUDE.md's "no fabricated metrics"
+rule applies here: this migration has no way to honestly reconstruct
+which resolution path (import-mapped, same-file bare-name, or
+unresolved) produced a historical row, since that information was
+never persisted before this migration existed. Each such row gets a
+real, accurate `confidence` automatically the next time its repository
+is re-indexed (see `codepulse.parser.graph.CallGraphBuilder._build_graph`
+and `IndexingEngine._persist_to_db`), at which point the resolution
+decision is freshly recomputed.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'f6e481353553'
+down_revision: Union[str, Sequence[str], None] = 'c286d277ea21'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.rename_table('dependencies', 'call_edges')
+    op.drop_index('ix_dependencies_source_symbol_name', table_name='call_edges')
+    op.drop_index('ix_dependencies_target_symbol_name', table_name='call_edges')
+    op.create_index(
+        op.f('ix_call_edges_source_symbol_name'), 'call_edges', ['source_symbol_name'], unique=False
+    )
+    op.create_index(
+        op.f('ix_call_edges_target_symbol_name'), 'call_edges', ['target_symbol_name'], unique=False
+    )
+    with op.batch_alter_table('call_edges', schema=None) as batch_op:
+        batch_op.add_column(sa.Column('confidence', sa.String(length=20), nullable=True))
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    with op.batch_alter_table('call_edges', schema=None) as batch_op:
+        batch_op.drop_column('confidence')
+    op.drop_index(op.f('ix_call_edges_source_symbol_name'), table_name='call_edges')
+    op.drop_index(op.f('ix_call_edges_target_symbol_name'), table_name='call_edges')
+    op.create_index(
+        'ix_dependencies_source_symbol_name', 'call_edges', ['source_symbol_name'], unique=False
+    )
+    op.create_index(
+        'ix_dependencies_target_symbol_name', 'call_edges', ['target_symbol_name'], unique=False
+    )
+    op.rename_table('call_edges', 'dependencies')

codepulse/symbol_identity.py

@@ -0,0 +1,29 @@
+"""
+The one place that decides what a symbol's in-memory id looks like.
+
+FUTURE_CHANGES item 31: the ids used to be `repo::file::name`, so same-named
+symbols in one file (every class's `__init__`, `run`, `get`, property setters,
+overloads) shared one id. The roadmap (section 29, idempotency rule) defines a
+symbol's natural key as `(file_id, name, start_line)` and the database enforces
+it; these ids now carry the same three parts, plus the repository.
+
+An id is a pure function of the symbol, so it can be rebuilt from a database row
+alone (after a restart, or when purging a file's old documents) with no knowledge
+of the symbol's siblings. Ids exist only in memory (the lexical and vector indexes
+are rebuilt from the database at startup); nothing persists them.
+
+A symbol whose lines shift gets a new id, which matches how incremental indexing
+already treats it (the same `(name, start_line)` key: the old row is replaced and
+the symbol is re-chunked and re-embedded).
+"""
+from __future__ import annotations
+
+
+def symbol_doc_id(repo_id: int, file_path: str, name: str, start_line: int) -> str:
+    """Id of a symbol in the lexical index, the in-memory symbol maps and result lists."""
+    return f"{repo_id}::{file_path}::{name}@{start_line}"
+
+
+def chunk_doc_id(repo_id: int, file_path: str, name: str, start_line: int, chunk_index: int) -> str:
+    """Id of one embedded chunk of a symbol in the vector index."""
+    return f"{symbol_doc_id(repo_id, file_path, name, start_line)}::{chunk_index}"

codepulse_engine-0.1.0.dist-info/METADATA

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: codepulse-engine
+Version: 0.1.0
+Summary: Local-first code intelligence engine: hybrid keyword, semantic and call-graph search and impact analysis for developers and AI agents, over a CLI, a REST API and an MCP server.
+Author: Dhairya Chhabra
+License: MIT
+Project-URL: Homepage, https://github.com/Chh-Dhairya/CodePulse
+Project-URL: Repository, https://github.com/Chh-Dhairya/CodePulse
+Project-URL: Issues, https://github.com/Chh-Dhairya/CodePulse/issues
+Project-URL: Documentation, https://github.com/Chh-Dhairya/CodePulse/tree/HEAD/docs
+Keywords: code search,code intelligence,semantic search,call graph,impact analysis,mcp,model context protocol,tree-sitter,local-first,developer tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi<0.112.0,>=0.111.0
+Requires-Dist: uvicorn[standard]<0.31.0,>=0.30.0
+Requires-Dist: pydantic<2.8.0,>=2.7.0
+Requires-Dist: sqlalchemy<2.1.0,>=2.0.30
+Requires-Dist: alembic<1.14.0,>=1.13.1
+Requires-Dist: tantivy<0.23.0,>=0.22.0
+Requires-Dist: sqlite-vec<0.2.0,>=0.1.9
+Requires-Dist: tree-sitter<0.22.0,>=0.21.0
+Requires-Dist: tree-sitter-languages>=1.10.2
+Requires-Dist: pathspec<1.2.0,>=1.1.0
+Requires-Dist: networkx<4.0,>=3.0
+Requires-Dist: mcp<2.0.0,>=1.9.0
+Requires-Dist: sentence-transformers<3.1.0,>=3.0.0
+Requires-Dist: torch<2.4.0,>=2.3.0
+Requires-Dist: numpy<2
+Requires-Dist: rich<16.0.0,>=15.0.0
+Requires-Dist: prometheus-client<0.21.0,>=0.20.0
+Requires-Dist: httpx<0.28.0,>=0.27.0
+Requires-Dist: structlog<24.2.0,>=24.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.2.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.7; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.4.8; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: setuptools>=68.0; extra == "dev"
+Dynamic: license-file
+
+# CodePulse
+
+**A local-first code intelligence engine for developers and AI agents.**
+
+CodePulse indexes a repository once, then answers questions about it through one shared core, reachable from a CLI, a REST API, or an MCP server:
+
+```
+Index → Retrieve → Explain (structure) → Navigate → Decide (impact) → Act
+```
+
+- **Hybrid retrieval.** Keyword (BM25 via Tantivy), semantic (sentence-transformers embeddings in sqlite-vec) and structural (call graph) signals are fused into one ranking.
+- **Agent-native.** Responses are structured and token-efficient, and they say explicitly when results were truncated or omitted.
+- **Local-first.** Everything runs on your machine: SQLite, embedded indexes, a local embedding model. No external service or API key is needed to index and search.
+
+Python and JavaScript/TypeScript sources are parsed (tree-sitter) into symbols, a call graph, and inheritance edges.
+
+## Install
+
+Requires **Python 3.11 or 3.12** (3.13+ is not supported yet).
+
+```bash
+python -m venv .venv
+source .venv/bin/activate        # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+This installs a `codepulse` command (`python -m codepulse.cli` works too). The first run downloads the `all-MiniLM-L6-v2` embedding model from Hugging Face (about 90 MB) and caches it. After that CodePulse works offline.
+
+## Quick start
+
+```bash
+codepulse init .                                 # writes codepulse.toml here
+codepulse index path/to/repo                     # full index
+codepulse search path/to/repo -q "parse config"  # hybrid search (also: -t keyword|semantic)
+codepulse symbol path/to/repo load_config        # definition lookup
+codepulse callers path/to/repo load_config       # who calls it (direct + transitive)
+codepulse impact path/to/repo load_config        # blast radius if it changes
+codepulse status path/to/repo                    # index freshness
+codepulse doctor                                 # environment diagnostics
+```
+
+Every query command accepts `--json`. Run `codepulse --help` for the full list: `parse`, `search`, `impact`, `init`, `index`, `update`, `symbol`, `refs`, `callers`, `callees`, `similar`, `status`, `modules`, `doctor`, `migrate`, `key`, `serve`.
+
+### Where the database lives
+
+By default there is **one database per user**, in your operating system's per-user data directory (`%LOCALAPPDATA%\CodePulse` on Windows, `~/Library/Application Support/CodePulse` on macOS, `$XDG_DATA_HOME/codepulse` or `~/.local/share/codepulse` on Linux), so it does not matter which directory you run a command from and nothing is written into your projects. Set `CODEPULSE_DATA_DIR` to move that directory.
+
+Two things override the default:
+
+- An explicit setting always wins: `--db-url`, `CODEPULSE_DB_URL`, or `db_url` in `codepulse.toml` (`codepulse init` writes a project-local one).
+- If the directory you run from already contains a `codepulse.db`, that file is used (it was the default before), so existing setups keep working unchanged.
+
+Every command prints which database it is using on stderr, and says so when it is about to create a new one. A `codepulse.toml` is picked up only from the directory you run from.
+
+### Incremental indexing
+
+`codepulse update <repo>` re-indexes using `git diff` when the repository has git history and a prior snapshot exists. Otherwise it falls back to a full index. The call graph is held in memory, so the incremental path only applies inside a long-lived process such as `codepulse serve`. A one-shot CLI run always does a full index and reports `incremental: false`.
+
+## REST API
+
+```bash
+codepulse serve                    # http://127.0.0.1:8000
+```
+
+Interactive docs are at `/docs`. Health checks are `/health/live` and `/health/ready`; `/metrics` exposes Prometheus metrics. All other endpoints need an `X-API-Key` header.
+
+Keys are scoped to repositories and carry a role: `viewer` (search and read) < `indexer` (plus indexing) < `admin` (plus managing keys). Creating a key over REST needs an admin key, so make your first one on the command line:
+
+```bash
+codepulse key create --repo path/to/project                  # role indexer (the default)
+codepulse key create --repo path/to/project --role admin --name ci
+codepulse key create --repo a --repo b --json                # several folders; machine-readable
+```
+
+It prints the key once (only its hash is stored) and registers the folder if it is not in the database yet, so you can index it with that key right away. At least one `--repo` is required, since a key with no repository can do nothing. Further keys can come from `POST /v1/admin/keys`. A key can index a new repository only if it already holds the `indexer` role (or higher) on some existing repository; the key that creates a repository becomes its `admin`, so it can follow the indexing job and see the result.
+
+Main endpoints: `POST /v1/search`, `POST /v1/repositories/index`, `GET /v1/repositories/{id}/index-status`, `GET /v1/symbols/{id}`, `POST /v1/symbols/{id}/impact-analysis`, `POST /v1/symbols/{id}/similar`, `GET /v1/symbols/{id}/references`, `POST /v1/agent/context`. Errors always use one shape: `{"error": {"code", "message", "details"}}`. Requests are rate-limited per key (5 req/s, burst 20, configurable).
+
+A local repository is identified by its canonical path (absolute, symlinks and `..` resolved, true case and an uppercase drive letter on Windows, no trailing separator), so `C:\\proj`, `c:/proj/` and `C:\\proj\\sub\\..` are one repository, not three.
+
+Local-path ingestion can be restricted to an allow-list with `ingestion_allowed_roots` (or `CODEPULSE_INGESTION_ALLOWED_ROOTS`). Cloning from git URLs is not implemented: the URL is validated (https/ssh, SSRF check) and the request is then rejected with 501.
+
+## MCP server
+
+```bash
+export CODEPULSE_MCP_API_KEY=cpk_...   # or pass --api-key
+codepulse serve --mcp                  # stdio transport
+```
+
+The connection is scoped to the repositories the key can access. The MCP tools call the same functions as the CLI and REST API; there is no separate implementation.
+
+## VS Code extension
+
+A separate extension (CodeLens, hovers, impact tree, MCP registration) lives in its own repository, [`codepulse-vscode`](https://github.com/Chh-Dhairya/codepulse-vscode). It talks to a running `codepulse serve` using a scoped API key.
+
+## Configuration
+
+Precedence: CLI flags > `CODEPULSE_*` environment variables > `codepulse.toml` > built-in defaults. Common settings are `db_url`, `embedding_model`, `embedding_device`, `ingestion_allowed_roots`, and the `rate_limit_*` options. See `codepulse/config.py` for the full list.
+
+## Upgrading an existing database
+
+After updating CodePulse, bring the database up to date with one command:
+
+```bash
+codepulse migrate            # apply (backs the SQLite file up first)
+codepulse migrate --check    # only report: exit 0 up to date, 1 needs migrating, 2 cannot be migrated safely
+```
+
+It works on whatever database CodePulse is configured for (`--db-url`, `CODEPULSE_DB_URL`, a `codepulse.toml` in the current directory, or the default `sqlite:///codepulse.db`) and does the safe thing for each case:
+
+| The database is | `migrate` |
+|---|---|
+| new (no tables yet) | creates it at the current schema |
+| behind | copies it to `<file>.pre-<revision>-<time>.bak`, then upgrades it |
+| from an older CodePulse and was never tracked | checks its schema against the models; if it matches (tables it does not have yet are simply created, empty), records it as up to date, after a backup |
+| not tracked and its schema differs in any other way (a missing or extra column, an extra table) | refuses, lists what differs, changes nothing |
+| from a newer CodePulse | refuses, changes nothing |
+
+Every CodePulse command prints a warning on stderr when the database is behind, and `codepulse doctor` reports the schema state. Until you migrate, CodePulse keeps working; features that need a newer table (for example module structure after a restart) are simply unavailable and a warning is logged. A database CodePulse creates from scratch is tracked from the start, so it can always be upgraded this way. The migration scripts ship inside the package, so this works from an installed copy as well as from a checkout.
+
+## Development
+
+```bash
+pytest tests/ -q
+```
+
+Schema changes go through Alembic (`codepulse/storage/schema_migrations/`; `alembic.ini` in the repository root points at it for `alembic revision`/`alembic upgrade` during development). PostgreSQL, Redis, and distributed workers are intentionally out of scope for now.
+
+## Project documents
+
+- [`docs/CodePulse_Strategy_and_Roadmap.md`](https://github.com/Chh-Dhairya/CodePulse/blob/HEAD/docs/CodePulse_Strategy_and_Roadmap.md): the authoritative strategy, architecture, and milestone plan.
+- [`docs/CODEPULSE_PRODUCT_AND_ARCHITECTURE.md`](https://github.com/Chh-Dhairya/CodePulse/blob/HEAD/docs/CODEPULSE_PRODUCT_AND_ARCHITECTURE.md): what CodePulse is and how it is built, as shipped.
+- [`docs/CODEPULSE_CLIENT_STRATEGY.md`](https://github.com/Chh-Dhairya/CodePulse/blob/HEAD/docs/CODEPULSE_CLIENT_STRATEGY.md): the plan for the VS Code extension and other clients.
+- [`docs/BACKUP_RESTORE.md`](https://github.com/Chh-Dhairya/CodePulse/blob/HEAD/docs/BACKUP_RESTORE.md): backing up and restoring a database.
+- [`docs/ORIGINAL_DESIGN.md`](https://github.com/Chh-Dhairya/CodePulse/blob/HEAD/docs/ORIGINAL_DESIGN.md): the original design, kept for history (it describes infrastructure that was never built).
+- [`docs/internal/`](https://github.com/Chh-Dhairya/CodePulse/tree/HEAD/docs/internal/): the working log (`CODEPULSE_PROGRESS.md`: what is built and verified, milestone by milestone) and `CODEPULSE_FUTURE_CHANGES.md` (known limitations and planned improvements).
+
+## License
+
+MIT. See [LICENSE](https://github.com/Chh-Dhairya/CodePulse/blob/HEAD/LICENSE).

codepulse_engine-0.1.0.dist-info/RECORD

@@ -0,0 +1,56 @@
+codepulse/__init__.py,sha256=NMjXlDqrrDuzz4lqokxvda3NJwT1t6kdUTawPCxfTOk,80
+codepulse/auth.py,sha256=jCJtUrk53Dhhh1a5UxJQLWbYEl6Mz1oeU-_2I2s_qzQ,16232
+codepulse/cli.py,sha256=1jZYFQLYO55YwR4km9qx7YXrIWIZ9-d-Kl8xNsTSikc,48178
+codepulse/config.py,sha256=18WGtd05kpxbc4XGuVtkAbOvReVxKyJLG-NkMCY9ZhQ,19268
+codepulse/data_location.py,sha256=p_4dMFHaqw93DT_dgaB4x9fB4JF_Q5kalm4p0xos-n4,3399
+codepulse/git_diff.py,sha256=QmH32PSQoZ7GhDO-rgpnMUDBCD1etthznq330k2ha0w,8760
+codepulse/ingestion_safety.py,sha256=BpyzfXCx8eGueLf9o-Ipy1lQ1hqzVkrrrCpGeZgYxBI,7879
+codepulse/jobs.py,sha256=YdQeZ7nVERCi4ZMdcu3lY5Sf0QJ5_yDu6pjjNCaMlvo,11258
+codepulse/mcp_server.py,sha256=6Lp97C88SW4U0bmi0Q2KrZ7Xf5s55r3igNF8gouaJKQ,12750
+codepulse/models.py,sha256=Zes0jKnV2yA-ZeeWIIta3uJ3JIbKA36izZh9MfQNMGA,5943
+codepulse/observability.py,sha256=AXqAvGUxZENwu2ygA3l8ZJDvS4XcLzZBhW3Shhot7GU,5806
+codepulse/rate_limit.py,sha256=64ayl8JWeUzC8gQJlA0NQ_pHYNI7komOjj8OiPxBEBE,6173
+codepulse/repository_identity.py,sha256=ttkSsAmW9_2XqwWhJpJEYLsbruavxfeJHc1A_1YULrs,3817
+codepulse/symbol_identity.py,sha256=WRqeneAUc-nsiLkocl_sNvyutxe49XVxCv58VaVi8xU,1503
+codepulse/api/app.py,sha256=FHQ_7nVOX6Var1X52QiBh-icWL8-pWdIBS_RMt5_bIU,59980
+codepulse/api/errors.py,sha256=TeGXFfAaY_tcUIzYuDW5Ck5HA2c10Q3IT55OvfqvD_Y,8522
+codepulse/api/security.py,sha256=wp44y5knQLGA7qugVi8YXvSFBMttaDwvElCF-qVtQP0,9381
+codepulse/embeddings/chunker.py,sha256=nf64CnP3_IZjHWylcJCtyHp06J4BWS48Paz2bnjg0_g,4875
+codepulse/embeddings/embedder.py,sha256=EhPLncT3Rk_bmbQ4sNEqSO0mZiFVOX6efUo-85RCLM0,4690
+codepulse/indexer/engine.py,sha256=GDqoblE9Q2yisug_w76zKXpTyQoGR_JbH7MqPjoJDUY,135158
+codepulse/indexer/ignore.py,sha256=_sm-0AqgwuzbNSQ2ne36UqsSLng5H3pnaZJWBiK0nrs,5499
+codepulse/parser/__init__.py,sha256=tUqFIUZye-zpOXdRpefLVW0goGj_lcf2z3mfGfe3jWU,253
+codepulse/parser/base.py,sha256=cvYxyfkwxLTgwQTBa3Nm89fRgGAjmvsMw-vmm9aVVGQ,2027
+codepulse/parser/factory.py,sha256=arQlbleElFZXUvWV24HFfUXgCFuSWM_34EpHTbK2dww,1420
+codepulse/parser/graph.py,sha256=mXBQFYmWwUoUuD41h9B_5xB9M5W6admUGC1Z7dlO2nw,24342
+codepulse/parser/javascript.py,sha256=CYgt1Avx3iFXynF6jzXl0B-Q0cU_rGmNYNG2wzQoZho,19870
+codepulse/parser/module_graph.py,sha256=lfD3RvefsZIoMbe040zo8ISs-vdRAD0R5_ME0EDK6_s,11947
+codepulse/parser/python.py,sha256=bvNJklZvVh1mwFz7MBUFRLj9nvV0ihFNKAqt9Ubkhdo,14513
+codepulse/search/bm25.py,sha256=Ov9JXeMu6XLM1N_g7Z97DC-czPx77jnBZUN-hvOknOg,17406
+codepulse/search/ranker.py,sha256=NAgC69GTdt9BKwnpQz3Ec3BkmbYGzicFdgbrAN3QFDY,16526
+codepulse/search/tokenizer.py,sha256=uvItiFxDiU72KCbva1sW_ZHcYI3RZBr9wpjOGc-YyoA,2389
+codepulse/search/vector.py,sha256=rLpn4VfvCoa2Qbb_f_Tzlvhy4cgUPlciBh5dTzxWEzg,19320
+codepulse/storage/db.py,sha256=0YowdvEOGiN-DQ_OF91gN5nF7xfu6bsaimRlChkg4EI,26970
+codepulse/storage/migrations.py,sha256=4T9OL8RpQ2JlSvpCCTCbPJs8bGq0pZ664pwR3Ki5l8I,16121
+codepulse/storage/schema_migrations/README,sha256=MVlc9TYmr57RbhXET6QxgyCcwWP7w-vLkEsirENqiIQ,38
+codepulse/storage/schema_migrations/env.py,sha256=oDPiMYwF7-h3Dl10AK3K0lWKbkpaHvPQIHfhxy7nGbA,1947
+codepulse/storage/schema_migrations/script.py.mako,sha256=04kgeBtNMa4cCnG8CfQcKt6P6rnloIfj8wy0u_DBydM,704
+codepulse/storage/schema_migrations/versions/135a7b064ea7_add_base_classes_and_relationship_type.py,sha256=un3HGj9vFiDfNIhYYHpYRJeQKYCP1rcjHSx_lVUJ0sU,3512
+codepulse/storage/schema_migrations/versions/20fc2d0607e2_add_file_content_hash_and_natural_key_.py,sha256=b6QKhYFIrwtK3L6SujplmW7xvkz0-Ub-ru1SJ2cJtEs,4320
+codepulse/storage/schema_migrations/versions/21a7cb7f1a85_initial_schema.py,sha256=E6cJ8kQKPMylIex1sKMRc77_h_iQpDfn1My_-oFL82g,4686
+codepulse/storage/schema_migrations/versions/2cd38eb12a7e_add_call_edge_repo_id_isolation_fix.py,sha256=omKUXc9BagP2vpVX5fwscJ-5PFyh0tZiCZuMBw-Zy7Q,5130
+codepulse/storage/schema_migrations/versions/3ba396e9c78f_add_symbol_natural_key_uniqueness.py,sha256=qBuuUIByouP-n21sUzBOdQi3yJynoskdvAgHH0E9W5U,2980
+codepulse/storage/schema_migrations/versions/49572f834366_add_embedding_persistence_fields.py,sha256=Wv0CFE8LvtzwSEpMyxFZq-H9Izjy98P9aVH4iR7UQrk,4531
+codepulse/storage/schema_migrations/versions/7c3e5a91d2f4_add_module_edges.py,sha256=8MuGbFC_4xC5D504X2i0H-P0q6GK77SVs5Jj5WzKyRQ,2682
+codepulse/storage/schema_migrations/versions/a41f0d2c6b8e_canonicalize_repository_urls.py,sha256=s98BmtNmi6ycc21Z0KKfdj_ElDNo_BrCosvozSODwyo,3902
+codepulse/storage/schema_migrations/versions/b0bdd63949f4_add_api_key_model.py,sha256=wx3rnk8anXU7KNUQagIbNmQFZPR_awtafti6UcLfmXY,2993
+codepulse/storage/schema_migrations/versions/b9014c049e33_add_api_key_repository_role.py,sha256=JSZDTj_DnJumMlm4cGpul2HBkZzS8cCvBNpH-9IETQY,2537
+codepulse/storage/schema_migrations/versions/c286d277ea21_add_repository_snapshot_model.py,sha256=E4jKc4TFRVxg-Z8Ns_zCb5O1M-8bxOu-kb-FTjBc-p0,2645
+codepulse/storage/schema_migrations/versions/de22df2fc3ce_add_index_job_model.py,sha256=tmMEzU6o5Igv8u3YELN4B4GtNxoJw2em9p7CTG4bjuk,2367
+codepulse/storage/schema_migrations/versions/f6e481353553_rename_dependency_to_call_edge_add_confidence.py,sha256=7pr9GYNf_FcvlrKc_qeoOMrW2mAkzgSobfIMvzXKDvM,3566
+codepulse_engine-0.1.0.dist-info/licenses/LICENSE,sha256=hMHnUvamOVPVjz9uh9RTcDdnx5jkz_JTs579jfpU8aU,1072
+codepulse_engine-0.1.0.dist-info/METADATA,sha256=3Ewu7tnYtqxMjQWlajJzufUVGoOe6hsEaIgK889sjk0,12389
+codepulse_engine-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+codepulse_engine-0.1.0.dist-info/entry_points.txt,sha256=xRsekBS_9RQ0fx-UagKqWflKPqnxwpJSS2AtWCPIoK0,49
+codepulse_engine-0.1.0.dist-info/top_level.txt,sha256=mKhxHbH2S88BxfgihA0ZatGxffQORlWftBSZp71ZJuc,10
+codepulse_engine-0.1.0.dist-info/RECORD,,

codepulse_engine-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codepulse_engine-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codepulse = codepulse.cli:main

codepulse_engine-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dhairya Chhabra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codepulse_engine-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+codepulse