feat: Implement initial KnowCode project structure, core data models, and language specific parsers for Python, Markdown and YAML files.

Author: deepakdgupta1

.github/workflows/ci-cd.yml

@@ -0,0 +1,91 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    name: Test & Lint (${{ matrix.os }} / py${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Fetch all history for changelog/commit analysis if needed
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Lint with Ruff
+        run: uv run ruff check .
+
+      - name: Test with pytest (and coverage)
+        run: uv run pytest -v --cov=src --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          file: ./coverage.xml
+          fail_ci_if_error: false # Don't fail the build if codecov is just down/unconfigured
+
+      - name: Prune uv cache
+        run: uv cache prune --ci
+
+  docs:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    needs: test # Only build docs if tests pass
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Build MkDocs
+        run: uv run mkdocs build
+
+      # Optional: Deploy to GitHub Pages (disabled for this example, but ready to enable)
+      # - name: Deploy to GitHub Pages
+      #   uses: mkdocs/gh-deployer@...
+
+  changelog:
+    name: Generate Changelog
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main' # Only runs on push to main
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 100 # Fetch enough history for the log
+
+      - name: Generate Changelog Entry
+        # We run the script directly. In a real scenario, this step might modify the file
+        # and create a PR, or just upload the artifact.
+        # For now, it appends to CHANGELOG.md in the runner.
+        run: python3 scripts/generate_changelog.py
+
+      - name: Upload Changelog Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: changelog-update
+          path: CHANGELOG.md

.gitignore

@@ -205,3 +205,8 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# KnowCode generated files
+knowcode_knowledge.json
+docs_test/
+

EVOLUTION.md

@@ -0,0 +1,35 @@
+# Project Evolution & Delta Log
+
+This document tracks the incremental evolution of the codebase. It serves as a high-level narrative for human developers and a semantic anchor for LLMs.
+
+---
+
+## [v0.1.0] - 2023-10-27
+
+**Commit Range:** `init...a1b2c3d`
+**Focus:** MVP Release - Core Parsing and Graph Building
+
+### 🧠 Temporal Context & Intent
+Initial release of the KnowCode MVP. The primary focus was establishing the pipeline to convert raw source code into a queryable knowledge graph. The scope was strictly limited to Python, Markdown, and YAML to prove the concept of "token-efficient context generation" without tracking temporal changes (git history) yet.
+
+### 🏗️ Architectural Impact
+* **Pipeline Established:** Implemented the core `Scanner` -> `Parser` -> `GraphBuilder` -> `ContextSynthesizer` flow.
+* **Graph Model:** Entities (Class, Function, Module) are now linked via simple relationships (Calls, Imports, Inherits) in an in-memory store.
+* **CLI:** Established `click`-based CLI as the sole entry point.
+
+### 📝 Delta Changes
+
+#### 🚀 Features (`feat`)
+* **parser:** Implement Python AST parser for function/class extraction
+    * *Context:* Uses standard `ast` library to identify nodes and edges.
+* **graph:** Create in-memory KnowledgeStore with JSON export
+* **cli:** Add `analyze` and `query` commands
+    * *Context:* Allows users to build the graph and perform relationship lookups (callers/callees).
+
+#### 🐛 Fixes (`fix`)
+* **scanner:** Correctly ignore files listed in `.gitignore`
+    * *Resolution:* Integrated `pathspec` to parse gitignore patterns before scanning.
+
+#### 🔧 Maintenance (`chore`, `docs`)
+* **docs:** Add comprehensive project documentation and CLI reference
+* **ci:** Configure basic GitHub Actions for linting (ruff)