Merge pull request #1 from managedcode/codex/create-ragsharp-project-as-nuget-package

Add ragsharp scaffold: codegraph indexer, SQLite store, CLI, installer, templates, docs and tests

Author: KSemenenko

.gitignore

@@ -1 +1,66 @@
-# RagSharp
+# RagSharp
+
+RagSharp provides a deterministic, offline-capable code graph indexer and skill installer for C#/.NET repositories. It ships a single NuGet package containing:
+
+- `ragsharp` — installer for Codex skills.
+- `ragsharp-codegraph` — code graph indexer/query CLI.
+
+See the Codex skill specification at https://agentskills.io/specification.
+
+## Requirements
+
+- .NET SDK 10 (primary) with multi-targeting to net8.0 for fallback.
+- Cross-platform (Windows/macOS/Linux).
+
+## Install .NET 10
+
+Follow the OS-specific steps in [docs/Development/SetupDotNet.md](docs/Development/SetupDotNet.md) and verify:
+
+```bash
+dotnet --info
+dotnet --list-sdks
+```
+
+## Build and test RagSharp
+
+```bash
+dotnet build
+
+dotnet test
+```
+
+## Package
+
+```bash
+dotnet pack src/RagSharp.Packaging/RagSharp.Packaging.csproj -c Release -o dist
+```
+
+## Install in another repository
+
+From the target repository root:
+
+```bash
+dotnet add package RagSharp --source /path/to/ragsharp/dist
+
+ragsharp install --root . --skill-dir .codex/skills
+```
+
+## Index and query
+
+```bash
+ragsharp-codegraph doctor --root .
+
+ragsharp-codegraph index --root . --db .codegraph/index.db --state .codegraph/state.json
+
+ragsharp-codegraph query symbols --db .codegraph/index.db --format json --limit 50 --symbol "Greeter"
+```
+
+## Output locations
+
+- `.codex/skills/` contains installed skills.
+- `.codegraph/` contains the index and state files (not committed).
+- Ensure `.codegraph/` and `state.json` remain in `.gitignore`.
+
+## Troubleshooting
+
+See [docs/Development/Troubleshooting.md](docs/Development/Troubleshooting.md).

README.md

@@ -0,0 +1,15 @@
+---
+name: ragsharp-build-code-graph
+description: |
+  Build or update a code graph index for C#/.NET repositories using ragsharp-codegraph.
+  Triggers: build index, update index, refresh index, code graph, dependency graph, static analysis, Roslyn, line numbers.
+---
+## Steps
+1. Run `ragsharp-codegraph doctor --root .`.
+2. Run `ragsharp-codegraph index --root . --db .codegraph/index.db --state .codegraph/state.json`.
+3. For incremental updates, run `ragsharp-codegraph update --root . --db .codegraph/index.db --state .codegraph/state.json`.
+
+## Expected Results
+- `.codegraph/index.db` exists.
+- `.codegraph/state.json` is updated.
+- Output goes to stderr, JSON is emitted only for query commands.

assets/skill-templates/build-code-graph/SKILL.md

@@ -0,0 +1,6 @@
+# Build Code Graph Skill
+
+Use this skill to initialize or refresh the code graph index.
+- `ragsharp-codegraph doctor` validates tooling.
+- `ragsharp-codegraph index` builds the graph.
+- `ragsharp-codegraph update` applies incremental changes.

assets/skill-templates/build-code-graph/references/README.md

@@ -0,0 +1,2 @@
+param([string]$Root = ".")
+ragsharp-codegraph index --root $Root --db .codegraph/index.db --state .codegraph/state.json

assets/skill-templates/build-code-graph/scripts/run.ps1

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ragsharp-codegraph index --root "${1:-.}" --db .codegraph/index.db --state .codegraph/state.json

assets/skill-templates/build-code-graph/scripts/run.sh

@@ -0,0 +1,9 @@
+---
+name: ragsharp-query-code-graph
+description: |
+  Query the ragsharp code graph for declarations, references, callers, callees, dependencies, and line-number evidence.
+  Triggers: find usages, where defined, callers, callees, dependency path, project deps, type hierarchy, line numbers, evidence.
+---
+## Steps
+1. Run `ragsharp-codegraph query symbols --db .codegraph/index.db --format json --limit 50 --symbol "SymbolName"`.
+2. Use the JSON output to answer questions with file:line-range evidence.

assets/skill-templates/query-code-graph/SKILL.md

@@ -0,0 +1,4 @@
+# Query Code Graph Skill
+
+Use query contracts defined in docs/Development/QueryContract.md and OutputSchema.md.
+Each answer should cite file:line-range evidence from query results.

assets/skill-templates/query-code-graph/references/README.md

@@ -0,0 +1,2 @@
+param([string]$Symbol = "")
+ragsharp-codegraph query symbols --db .codegraph/index.db --format json --limit 50 --symbol $Symbol

assets/skill-templates/query-code-graph/scripts/run.ps1

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ragsharp-codegraph query symbols --db .codegraph/index.db --format json --limit 50 --symbol "${1:-}"