rekipedia 0.9.3__tar.gz

rekipedia-0.9.3/.editorconfig

@@ -0,0 +1,99 @@
+# ──────────────────────────────────────────────────────────────────────────────
+#  C# / .NET EditorConfig + Roslyn analyser settings
+#  Drop in project root as .editorconfig
+#  Works with: dotnet format, Visual Studio, Rider, VS Code (C# Dev Kit)
+#  Run: dotnet format --verify-no-changes
+# ──────────────────────────────────────────────────────────────────────────────
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{cs,csx}]
+# ── Naming (Clean Code: meaningful names, DDD: ubiquitous language) ──────────
+
+# Interfaces must start with I
+dotnet_naming_rule.interface_should_start_with_i.severity = warning
+dotnet_naming_rule.interface_should_start_with_i.symbols = interface
+dotnet_naming_rule.interface_should_start_with_i.style = begins_with_i
+
+dotnet_naming_symbols.interface.applicable_kinds = interface
+dotnet_naming_symbols.interface.applicable_accessibilities = public, internal
+
+dotnet_naming_style.begins_with_i.required_prefix = I
+dotnet_naming_style.begins_with_i.capitalization = pascal_case
+
+# Types: PascalCase
+dotnet_naming_rule.types_pascal_case.severity = warning
+dotnet_naming_rule.types_pascal_case.symbols = types
+dotnet_naming_rule.types_pascal_case.style = pascal_case_style
+
+dotnet_naming_symbols.types.applicable_kinds = class, struct, enum, record
+dotnet_naming_style.pascal_case_style.capitalization = pascal_case
+
+# Private fields: _camelCase
+dotnet_naming_rule.private_fields_camel.severity = warning
+dotnet_naming_rule.private_fields_camel.symbols = private_fields
+dotnet_naming_rule.private_fields_camel.style = underscore_camel
+
+dotnet_naming_symbols.private_fields.applicable_kinds = field
+dotnet_naming_symbols.private_fields.applicable_accessibilities = private, private_protected
+dotnet_naming_style.underscore_camel.required_prefix = _
+dotnet_naming_style.underscore_camel.capitalization = camel_case
+
+# ── Code quality (Clean Code + DDD) ─────────────────────────────────────────
+
+# Prefer var only when type is apparent
+csharp_style_var_for_built_in_types = false:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+csharp_style_var_elsewhere = false:suggestion
+
+# Expression-bodied members — keep short
+csharp_style_expression_bodied_methods = when_on_single_line:suggestion
+csharp_style_expression_bodied_properties = true:suggestion
+
+# Pattern matching (reduces nesting)
+csharp_style_prefer_switch_expression = true:suggestion
+csharp_prefer_pattern_matching = true:suggestion
+csharp_style_prefer_not_pattern = true:suggestion
+
+# Null checks (prefer is null over == null)
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:warning
+
+# DDD value objects — prefer records for immutability
+csharp_style_prefer_primary_constructors = true:suggestion
+
+# Throw expressions (cleaner guard clauses)
+csharp_style_throw_expression = true:suggestion
+
+# ── Roslyn analyser severity overrides ──────────────────────────────────────
+
+# CA1822 — mark members static if they don't access instance state
+dotnet_diagnostic.CA1822.severity = suggestion
+
+# CA1062 — validate public API arguments (boundaries / ACL)
+dotnet_diagnostic.CA1062.severity = warning
+
+# CA2000 — dispose objects before losing scope
+dotnet_diagnostic.CA2000.severity = warning
+
+# MA0051 — method too long (> 60 lines)
+dotnet_diagnostic.MA0051.severity = warning
+
+# MA0016 — prefer return collection abstraction (DDD repository interfaces)
+dotnet_diagnostic.MA0016.severity = suggestion
+
+# S1135 — complete TODO comments
+dotnet_diagnostic.S1135.severity = suggestion
+
+[*.{json,yml,yaml,xml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

rekipedia-0.9.3/.env.sample

@@ -0,0 +1,13 @@
+# close-wiki environment variables
+# Copy this file to .env and fill in the values you need.
+# All variables are optional — they override the settings in .close-wiki/config.yml.
+
+# LLM model (any litellm model string)
+# Examples: gpt-5.5 | claude-opus-4-7 | gemini/gemini-2.5-pro | ollama/llama4
+CLOSE_WIKI_MODEL=ollama/llama4
+
+# API key for the chosen provider (leave blank for local models like Ollama)
+CLOSE_WIKI_API_KEY=
+
+# Custom base URL for self-hosted or proxied endpoints
+CLOSE_WIKI_BASE_URL=

rekipedia-0.9.3/.github/_rules.instructions.md

@@ -0,0 +1,84 @@
+---
+applyTo: "**/*.{ts,js,tsx,jsx,py,go,java,cs,rb,rs,swift,kt}"
+---
+
+# Clean Code + DDD Review Rules
+
+Scope: readability and maintainability only. High-confidence findings only. Max 3 per file by impact.
+No finding → reply: "No significant Clean Code issues found."
+
+## Clean Code
+
+| Rule                    | Severity | Flag when                                                                  |
+| ----------------------- | -------- | -------------------------------------------------------------------------- |
+| `meaningful-names`      | medium   | Vague names: `data`, `tmp`, `res`, `doStuff`, `flag`                       |
+| `single-responsibility` | high     | Function/class mixes validation, persistence, business logic, side effects |
+| `minimize-duplication`  | high     | Business logic repeated across 2+ functions or files                       |
+| `avoid-deep-nesting`    | medium   | Nested `if/else` hides happy path; guard clauses would flatten it          |
+| `small-interfaces`      | medium   | 5+ mixed-purpose parameters                                                |
+| `named-constants`       | low      | Unnamed business literals in logic                                         |
+| `comment-why-not-what`  | low      | Comment restates code instead of explaining intent                         |
+| `clear-error-handling`  | medium   | Silent failures, bare catch, generic exception, missing context            |
+
+## DDD (apply when domain modelling exists)
+
+| Rule                             | Severity | Flag when                                               |
+| -------------------------------- | -------- | ------------------------------------------------------- |
+| `ubiquitous-language`            | medium   | Generic name where a domain term exists                 |
+| `bounded-context-violation`      | high     | Module imports another context's internals without ACL  |
+| `aggregate-integrity-bypass`     | high     | External code mutates aggregate bypassing the root      |
+| `value-object-mutability`        | medium   | Value-semantics object is mutable or identity-compared  |
+| `domain-logic-in-adapters`       | high     | Business rules in controllers, handlers, or DB adapters |
+| `missing-acl`                    | medium   | External model types referenced directly in domain code |
+| `missing-repository-abstraction` | medium   | Domain code calls ORM/SQL/HTTP directly                 |
+| `missing-domain-event`           | low      | State transition side effects via direct calls          |
+
+## Output
+
+```
+## Clean Code Review
+Files reviewed: N | Findings: N (High: N, Medium: N, Low: N)
+
+### Finding N
+- Severity: high | medium | low
+- Rule: <rule-id>
+- Location: <file>:<line>
+- Problem: <what>
+- Why it matters: <impact>
+- Suggested fix: <action>
+- Refactor example: (optional)
+```
+
+## Guardrails
+
+- Skip formatting enforced by linters
+- Every finding must cite a specific file and line
+- No refactor demand when framework/business constraints apply
+- No speculative findings — skip if unsure
+- high/medium = mandatory · low = suggestion
+
+## Simplicity First
+
+- Minimum code that solves the problem. Nothing speculative.
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+- The test: would a senior engineer say this is overcomplicated? If yes, simplify.
+
+## Surgical Changes
+
+- Touch only what you must. Don't improve adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it — don't delete it.
+- Remove imports, variables, or functions that **your** changes made unused, not pre-existing ones.
+- The test: every changed line should trace directly to the user's request.
+
+## Think Before Coding
+
+- State assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them — don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.

rekipedia-0.9.3/.github/clean-code-review.instructions.md

@@ -0,0 +1,17 @@
+---
+applyTo: "**/*.{ts,js,tsx,jsx,py,go,java,cs,rb,rs,swift,kt}"
+---
+
+You are a Clean Code + DDD review assistant embedded in the editor.
+Apply the rules defined in `_rules.instructions.md` in this same folder.
+
+When asked to review code, automatically trigger a full Clean Code + DDD review.
+
+Language-specific reminders:
+- **TypeScript/JS**: no `any` hiding intent; branded types for value objects; domain ≠ UI layer
+- **Python**: explicit exceptions; small modules; dataclasses/pydantic for value objects
+- **Go**: explicit error returns; small functions; struct aggregates with exported methods only
+- **Java/Kotlin**: no bloated services; package-per-bounded-context layout
+- **C#**: thin controllers; record types for value objects; no static utility bags
+- **Ruby**: small methods; avoid obscuring meta-programming
+- **Rust**: explicit error types; no `.unwrap()` chains where errors propagate

rekipedia-0.9.3/.github/husky-enforcement.instructions.md

@@ -0,0 +1,26 @@
+---
+applyTo: "package.json,commitlint.config.cjs,.husky/**,linting/shared/.pre-commit-config.yaml"
+---
+
+You are a commit hygiene enforcement assistant.
+Apply all rules defined in `skills/shared/husky-rules.md`.
+
+**On every interaction involving git commits, commit messages, or these files, check:**
+
+1. Is husky installed? (`node_modules/.bin/husky` must exist)
+   - If not → `npm install`
+2. Are hooks registered? (`.git/hooks/commit-msg` and `.git/hooks/pre-commit` must exist)
+   - If not → `npm run prepare`
+3. Are hook files executable?
+   - If not → `chmod +x .husky/commit-msg .husky/pre-commit`
+
+**Commit message format — always enforce:**
+```
+<type>(<scope>): <subject in lowercase, max 72 chars>
+```
+Types: `feat` `fix` `docs` `style` `refactor` `perf` `test` `chore` `revert` `release`
+Scopes: `shared` `copilot` `claude` `cursor` `opencode` `windsurf` `generic` `linting` `python` `typescript` `go` `java` `csharp` `hooks` `deps` `ci` `release`
+
+**Never suggest `git commit --no-verify`** — fix the root cause instead.
+
+**When a new file type is added**, remind the developer to add a lint-staged entry to `package.json`.

rekipedia-0.9.3/.github/lint-report.instructions.md

@@ -0,0 +1,66 @@
+---
+applyTo: "**"
+---
+
+You are a Lint Report Analyst embedded in the editor.
+Apply the full prompt defined in `skills/shared/lint-report-prompt.md`.
+
+**Trigger phrase:** When the user pastes linting output or asks you to "analyze lint output", "explain linting errors", or "generate a lint report", activate this skill automatically.
+
+**What to do:**
+1. Detect the linter and language from the pasted output (Ruff, ESLint, golangci-lint, Checkstyle, PMD, dotnet format).
+2. Parse every finding and translate rule codes into plain-English explanations.
+3. Group findings by severity: Errors → Warnings → Style/Info.
+4. Map violations to the project's Clean Code rule IDs from `_rules.instructions.md` where a clear match exists.
+5. Deduplicate — if the same rule fires 10+ times, list the 3 worst offenders and note the total.
+6. Return the report in exactly this structure:
+
+```
+## Lint Analysis Report
+
+**Language:** <detected> | **Tool:** <linter> | **Files scanned:** N | **Total issues:** N (Errors: N, Warnings: N, Style: N)
+
+### Executive Summary
+[2–4 plain-English sentences — no rule code jargon]
+
+### Findings by Priority
+
+#### Must Fix — Errors (N)
+| File | Line | Code | What It Means | Clean Code Rule |
+|---|---|---|---|---|
+
+#### Should Address — Warnings (N)
+| File | Line | Code | What It Means | Clean Code Rule |
+|---|---|---|---|---|
+
+#### Consider — Style / Info (N)
+| File | Line | Code | What It Means | Clean Code Rule |
+|---|---|---|---|---|
+
+### Top Recurring Violations
+| Code | Occurrences | What It Means | Priority |
+|---|---|---|---|
+
+### Prioritised Action Plan
+1. [Must Fix] <concrete action>
+2. [Should Fix] <next most impactful>
+3. ...
+
+### Clean Code Rule Mapping
+| Lint Code | Clean Code Rule | Why It Matters |
+|---|---|---|
+```
+
+Omit any section with zero findings.  
+If there are no findings: `No linting issues found. Code passes all configured checks.`
+
+**Saving the report:**  
+If the user's message names a file path (e.g. `reports/2026-04-15/report.md`), write the complete report to that file using the editor's file-creation capability.  
+If no path is given, default to `reports/<YYYY-MM-DD>/report.md` (today's date).  
+Always create parent directories if they do not exist.
+
+**Guardrails:**
+- Do not echo the raw linter message — explain the *impact* in plain English.
+- Do not invent findings not present in the input.
+- Do not suggest disabling rules — suggest fixing the root cause.
+- Severity must match the linter's own severity — do not up-rate or down-rate.

rekipedia-0.9.3/.github/scripts/update-homebrew-tap.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""
+update-homebrew-tap.py
+Post-release script: compute sha256 for all platforms and push Formula + Cask to homebrew-tap.
+Usage: python3 update-homebrew-tap.py <version> <pat>
+e.g.   python3 update-homebrew-tap.py 0.9.1 ghp_xxx
+"""
+
+import sys
+import json
+import base64
+import hashlib
+import urllib.request
+
+VERSION = sys.argv[1].lstrip("v")
+PAT = sys.argv[2]
+TAG = f"v{VERSION}"
+BASE_URL = f"https://github.com/unrealandychan/rekipedia-releases/releases/download/{TAG}"
+TAP_REPO = "unrealandychan/homebrew-tap"
+
+PLATFORMS = {
+    "darwin_amd64": f"{BASE_URL}/rekipedia_darwin_amd64.tar.gz",
+    "darwin_arm64": f"{BASE_URL}/rekipedia_darwin_arm64.tar.gz",
+    "linux_amd64":  f"{BASE_URL}/rekipedia_linux_amd64.tar.gz",
+    "linux_arm64":  f"{BASE_URL}/rekipedia_linux_arm64.tar.gz",
+}
+
+
+def sha256_url(url):
+    print(f"  Downloading {url} ...")
+    req = urllib.request.Request(url, headers={"User-Agent": "update-tap/1.0"})
+    with urllib.request.urlopen(req) as resp:
+        data = resp.read()
+    return hashlib.sha256(data).hexdigest()
+
+
+def gh_get_sha(path):
+    url = f"https://api.github.com/repos/{TAP_REPO}/contents/{path}"
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"token {PAT}",
+        "Accept": "application/vnd.github.v3+json",
+    })
+    try:
+        with urllib.request.urlopen(req) as resp:
+            return json.loads(resp.read())["sha"]
+    except Exception:
+        return None  # file doesn't exist yet
+
+
+def gh_put(path, content, sha, message):
+    url = f"https://api.github.com/repos/{TAP_REPO}/contents/{path}"
+    payload = {
+        "message": message,
+        "content": base64.b64encode(content.encode()).decode(),
+        "committer": {"name": "HermesBot", "email": "bot@rekipedia.dev"},
+    }
+    if sha:
+        payload["sha"] = sha
+    data = json.dumps(payload).encode()
+    req = urllib.request.Request(url, data=data, method="PUT", headers={
+        "Authorization": f"token {PAT}",
+        "Content-Type": "application/json",
+    })
+    with urllib.request.urlopen(req) as resp:
+        result = json.loads(resp.read())
+    return result["commit"]["sha"]
+
+
+# ── 1. Compute sha256 ──────────────────────────────────────────────────────────
+print(f"Computing sha256 for {TAG}...")
+shas = {p: sha256_url(u) for p, u in PLATFORMS.items()}
+for p, s in shas.items():
+    print(f"  {p}: {s}")
+
+
+# ── 2. Formula (Formula/rekipedia.rb) ────────────────────────────────────────
+formula = f"""# typed: false
+# frozen_string_literal: true
+
+class Rekipedia < Formula
+  desc "Agentic repo-to-wiki — scan any codebase into a structured knowledge base"
+  homepage "https://github.com/unrealandychan/rekipedia"
+  version "{VERSION}"
+  license "MIT"
+
+  on_macos do
+    if Hardware::CPU.intel?
+      url "{PLATFORMS['darwin_amd64']}"
+      sha256 "{shas['darwin_amd64']}"
+    end
+    if Hardware::CPU.arm?
+      url "{PLATFORMS['darwin_arm64']}"
+      sha256 "{shas['darwin_arm64']}"
+    end
+  end
+
+  on_linux do
+    if Hardware::CPU.intel? && Hardware::CPU.is_64_bit?
+      url "{PLATFORMS['linux_amd64']}"
+      sha256 "{shas['linux_amd64']}"
+    end
+    if Hardware::CPU.arm? && Hardware::CPU.is_64_bit?
+      url "{PLATFORMS['linux_arm64']}"
+      sha256 "{shas['linux_arm64']}"
+    end
+  end
+
+  def install
+    bin.install "rekipedia"
+  end
+
+  test do
+    system "#{{bin}}/rekipedia", "--version"
+  end
+end
+"""
+
+print("\nPushing Formula/rekipedia.rb ...")
+sha = gh_get_sha("Formula/rekipedia.rb")
+commit = gh_put("Formula/rekipedia.rb", formula, sha, f"chore: bump rekipedia to {TAG}")
+print(f"  ✓ commit {commit[:7]}")
+
+print(f"\n✅ Homebrew tap updated to {TAG}")

rekipedia-0.9.3/.github/workflows/go-ci.yml

@@ -0,0 +1,46 @@
+name: Go CI
+
+on:
+  push:
+    branches: [feat/golang-rewrite, main]
+    paths: ['go/**']
+  pull_request:
+    branches: [main]
+    paths: ['go/**']
+
+jobs:
+  test:
+    name: Test & Build
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: go
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.25'
+          cache-dependency-path: go/go.sum
+
+      - name: Install CGO deps
+        run: sudo apt-get install -y gcc gcc-aarch64-linux-gnu
+
+      - name: go mod tidy check
+        run: |
+          go mod tidy
+          git diff --exit-code go.sum || (echo "go.sum not up to date — run 'go mod tidy'" && exit 1)
+
+      - name: go vet
+        run: go vet ./...
+
+      - name: go test
+        run: go test ./... -v -count=1 -timeout 120s
+
+      - name: Build binary (smoke test)
+        run: |
+          CGO_ENABLED=1 go build -ldflags "-s -w" -o /tmp/rekipedia ./cmd/rekipedia
+          /tmp/rekipedia --version
+          /tmp/rekipedia --help
+          /tmp/rekipedia scan --help

rekipedia-0.9.3/.github/workflows/go-release.yml

@@ -0,0 +1,42 @@
+name: Go Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    name: goreleaser
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.25'
+          cache-dependency-path: go/go.sum
+
+      - name: Run goreleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          version: ~> v2
+          args: release --clean
+          workdir: go
+        env:
+          GITHUB_TOKEN: ${{ secrets.RELEASE_PAT }}
+          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+
+      - name: Update Homebrew tap (Formula fallback)
+        if: always()
+        run: |
+          TAG=${GITHUB_REF#refs/tags/}
+          VERSION=${TAG#v}
+          echo "Updating homebrew tap for $TAG ..."
+          python3 .github/scripts/update-homebrew-tap.py "$VERSION" "${{ secrets.HOMEBREW_TAP_TOKEN }}"

rekipedia-0.9.3/.github/workflows/python-release.yml

@@ -0,0 +1,32 @@
+name: Python Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    name: Build & publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write  # required for trusted publishing (OIDC)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install build tools
+        run: pip install hatch
+
+      - name: Build distribution
+        run: hatch build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses PyPI Trusted Publishing (OIDC) — no API token needed.
+        # Configure at: https://pypi.org/manage/project/rekipedia/settings/publishing/

rekipedia-0.9.3/.gitignore

@@ -0,0 +1,27 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+dist/
+build/
+.coverage
+htmlcov/
+.pytest_cache/
+
+# uv
+.uv/
+
+# Environment
+.env
+
+# npm
+node_modules/
+*.tgz
+
+# macOS
+.DS_Store
+
+# close-wiki store (for if this repo is scanned)
+.close-wiki/store.db