@kkelly-offical/kkcode 0.1.2

package/src/github/flow.mjs

@@ -0,0 +1,298 @@
+import { createInterface } from "node:readline/promises"
+import { stdin as input, stdout as output } from "node:process"
+import { ensureGitHubAuth } from "./auth.mjs"
+import { listUserRepos, searchRepos, listBranches } from "./api.mjs"
+import { ensureRepo, isLocalRepo, listLocalRepos, localBranches, repoLocalPath, removeLocalRepo, syncRepo, hasLocalChanges, getChangedFiles, generateCommitMessage, commitAndPush } from "./workspace.mjs"
+
+function timeAgo(dateStr) {
+  if (!dateStr) return ""
+  const diff = Date.now() - new Date(dateStr).getTime()
+  const mins = Math.floor(diff / 60000)
+  if (mins < 1) return "just now"
+  if (mins < 60) return `${mins}m ago`
+  const hours = Math.floor(mins / 60)
+  if (hours < 24) return `${hours}h ago`
+  const days = Math.floor(hours / 24)
+  if (days < 30) return `${days}d ago`
+  return `${Math.floor(days / 30)}mo ago`
+}
+
+function padEnd(str, len) {
+  return str.length >= len ? str : str + " ".repeat(len - str.length)
+}
+
+function printRepoList(repos, localSet) {
+  const maxNameLen = Math.min(40, Math.max(...repos.map((r) => r.full_name.length)))
+  for (let i = 0; i < repos.length; i++) {
+    const r = repos[i]
+    const idx = `  \x1b[2m${String(i + 1).padStart(2)}.\x1b[0m `
+    const name = padEnd(r.full_name, maxNameLen + 2)
+    const local = localSet.has(r.full_name) ? "\x1b[32m[local]\x1b[0m " : "        "
+    const stars = r.stars > 0 ? `\x1b[33m★${r.stars}\x1b[0m` : ""
+    const priv = r.private ? " \x1b[31m●\x1b[0m" : ""
+    const time = `\x1b[2m${timeAgo(r.pushed_at)}\x1b[0m`
+    console.log(`${idx}${name}${local}${stars}${priv}  ${time}`)
+  }
+}
+
+function printBranchList(branches, localSet, defaultBranch) {
+  for (let i = 0; i < branches.length; i++) {
+    const b = branches[i]
+    const idx = `  \x1b[2m${String(i + 1).padStart(2)}.\x1b[0m `
+    const isDefault = b.name === defaultBranch ? " \x1b[2m(default)\x1b[0m" : ""
+    const local = localSet.has(b.name) ? " \x1b[32m[local]\x1b[0m" : ""
+    const prot = b.protected ? " \x1b[33m🔒\x1b[0m" : ""
+    console.log(`${idx}${b.name}${isDefault}${local}${prot}`)
+  }
+}
+
+async function prompt(rl, message) {
+  const answer = await rl.question(`\x1b[36m  > ${message}\x1b[0m`)
+  return answer.trim()
+}
+
+export async function runGitHubFlow() {
+  const { token, login } = await ensureGitHubAuth()
+
+  const rl = createInterface({ input, output })
+
+  try {
+    // --- Repo selection ---
+    const localRepoList = await listLocalRepos()
+    const localRepoSet = new Set(localRepoList)
+
+    console.log(`\x1b[2m  👤 @${login}\x1b[0m`)
+    console.log(`\n\x1b[1m  📦 你的仓库:\x1b[0m \x1b[2m(输入序号选择，或输入关键词搜索)\x1b[0m\n`)
+
+    let repos = await listUserRepos(token)
+    printRepoList(repos, localRepoSet)
+
+    let selectedRepo = null
+    while (!selectedRepo) {
+      const input = await prompt(rl, "")
+      if (!input) continue
+
+      const num = parseInt(input, 10)
+      if (!isNaN(num) && num >= 1 && num <= repos.length) {
+        selectedRepo = repos[num - 1]
+      } else {
+        // Search
+        console.log(`\n\x1b[2m  搜索 "${input}" ...\x1b[0m\n`)
+        repos = await searchRepos(token, input, login)
+        if (repos.length === 0) {
+          console.log("  \x1b[31m未找到匹配的仓库\x1b[0m\n")
+          repos = await listUserRepos(token)
+          printRepoList(repos, localRepoSet)
+        } else {
+          printRepoList(repos, localRepoSet)
+        }
+      }
+    }
+
+    // --- Branch selection ---
+    console.log(`\n\x1b[1m  🌿 分支:\x1b[0m \x1b[2m${selectedRepo.full_name}\x1b[0m\n`)
+
+    const branches = await listBranches(token, selectedRepo.owner, selectedRepo.name)
+    const localPath = repoLocalPath(selectedRepo.full_name)
+    const existsLocally = await isLocalRepo(selectedRepo.full_name)
+    const localBranchSet = new Set(existsLocally ? await localBranches(localPath) : [])
+
+    // Sort: default branch first, then local branches, then the rest
+    branches.sort((a, b) => {
+      if (a.name === selectedRepo.default_branch) return -1
+      if (b.name === selectedRepo.default_branch) return 1
+      const aLocal = localBranchSet.has(a.name) ? 0 : 1
+      const bLocal = localBranchSet.has(b.name) ? 0 : 1
+      return aLocal - bLocal
+    })
+
+    printBranchList(branches, localBranchSet, selectedRepo.default_branch)
+
+    let selectedBranch = null
+    while (!selectedBranch) {
+      const input = await prompt(rl, "选择分支: ")
+      if (!input) continue
+
+      const num = parseInt(input, 10)
+      if (!isNaN(num) && num >= 1 && num <= branches.length) {
+        selectedBranch = branches[num - 1].name
+      } else {
+        // Direct branch name input
+        const match = branches.find((b) => b.name === input)
+        if (match) {
+          selectedBranch = match.name
+        } else {
+          console.log(`  \x1b[31m未找到分支 "${input}"\x1b[0m`)
+        }
+      }
+    }
+
+    // --- Local repo action selection ---
+    let action = "clone"
+    if (existsLocally) {
+      console.log(`\n\x1b[33m  📦 本地已存在仓库 ${selectedRepo.full_name}\x1b[0m\n`)
+      console.log("  请选择操作：")
+      console.log("    \x1b[36m1.\x1b[0m 使用本地仓库（不更新）")
+      console.log("    \x1b[36m2.\x1b[0m 同步云端最新代码（git pull）")
+      console.log("    \x1b[36m3.\x1b[0m 强制重新克隆（删除本地，重新下载）")
+      console.log("")
+
+      while (true) {
+        const choice = await prompt(rl, "选择操作 (1-3): ")
+        if (choice === "1") {
+          action = "use-local"
+          break
+        } else if (choice === "2") {
+          action = "sync"
+          break
+        } else if (choice === "3") {
+          action = "reclone"
+          break
+        } else {
+          console.log("  \x1b[31m请输入 1、2 或 3\x1b[0m")
+        }
+      }
+    }
+
+    rl.close()
+
+    // --- Execute action ---
+    let result
+    if (action === "use-local") {
+      console.log(`\n\x1b[36m  📂 使用本地仓库 ${selectedRepo.full_name}@${selectedBranch} ...\x1b[0m`)
+      const localPath = repoLocalPath(selectedRepo.full_name)
+      // Just checkout the branch if needed
+      const localBranchList = await localBranches(localPath)
+      if (!localBranchList.includes(selectedBranch)) {
+        console.log(`  \x1b[33m⚠ 本地没有分支 ${selectedBranch}，切换到默认分支\x1b[0m`)
+        selectedBranch = selectedRepo.default_branch
+      }
+      result = { path: localPath, isNew: false, action: "use-local" }
+    } else if (action === "sync") {
+      console.log(`\n\x1b[36m  📥 同步云端代码 ${selectedRepo.full_name}@${selectedBranch} ...\x1b[0m`)
+      result = await syncRepo({
+        fullName: selectedRepo.full_name,
+        branch: selectedBranch,
+        token
+      })
+      result.action = "sync"
+    } else if (action === "reclone") {
+      console.log(`\n\x1b[36m  🗑️  删除本地仓库...\x1b[0m`)
+      await removeLocalRepo(selectedRepo.full_name)
+      console.log(`\x1b[36m  📥 重新克隆 ${selectedRepo.full_name}@${selectedBranch} ...\x1b[0m`)
+      result = await ensureRepo({
+        fullName: selectedRepo.full_name,
+        branch: selectedBranch,
+        token
+      })
+      result.action = "reclone"
+    } else {
+      // Clone new repo
+      console.log(`\n\x1b[36m  📥 克隆仓库 ${selectedRepo.full_name}@${selectedBranch} ...\x1b[0m`)
+      result = await ensureRepo({
+        fullName: selectedRepo.full_name,
+        branch: selectedBranch,
+        token
+      })
+      result.action = "clone"
+    }
+
+    console.log(`  \x1b[2m→ ${result.path}\x1b[0m`)
+    console.log(`\x1b[32m  ✓ 就绪\x1b[0m\n`)
+
+    return { cwd: result.path }
+  } finally {
+    rl.close()
+  }
+}
+
+/**
+ * REPL 退出后询问用户是否推送代码到 GitHub
+ * @param {Object} flowResult - runGitHubFlow 返回的结果
+ */
+export async function promptPushChanges(flowResult) {
+  const { cwd } = flowResult
+  if (!cwd) return
+
+  // Check if there are any changes
+  const hasChanges = await hasLocalChanges(cwd)
+  if (!hasChanges) {
+    console.log("\n\x1b[2m  没有检测到代码变更\x1b[0m")
+    return
+  }
+
+  // Get changed files for display
+  const changedFiles = await getChangedFiles(cwd)
+  console.log("\n\x1b[33m  📦 检测到代码变更:\x1b[0m\n")
+  for (const file of changedFiles.slice(0, 10)) {
+    console.log(`    \x1b[36m${file}\x1b[0m`)
+  }
+  if (changedFiles.length > 10) {
+    console.log(`    \x1b[2m... 还有 ${changedFiles.length - 10} 个文件\x1b[0m`)
+  }
+  console.log("")
+
+  // Create readline interface
+  const rl = createInterface({ input, output })
+
+  try {
+    // Ask user what to do
+    console.log("\x1b[1m  是否推送到 GitHub?\x1b[0m\n")
+    console.log("    \x1b[36m1.\x1b[0m 推送变更到云端 (commit & push)")
+    console.log("    \x1b[36m2.\x1b[0m 放弃变更，保持云端版本")
+    console.log("    \x1b[36m3.\x1b[0m 稍后手动处理\n")
+
+    let choice = null
+    while (!choice) {
+      const answer = await rl.question(`\x1b[36m  > 选择 (1-3): \x1b[0m`)
+      const trimmed = answer.trim()
+      if (trimmed === "1" || trimmed === "2" || trimmed === "3") {
+        choice = trimmed
+      } else {
+        console.log("  \x1b[31m请输入 1、2 或 3\x1b[0m")
+      }
+    }
+
+    if (choice === "1") {
+      // Get current branch
+      const { execFile } = await import("node:child_process")
+      const currentBranch = await new Promise((resolve) => {
+        execFile("git", ["branch", "--show-current"], { cwd }, (err, stdout) => {
+          resolve(err ? "main" : stdout.trim())
+        })
+      })
+
+      // Get commit message (use default or ask user)
+      const defaultMessage = await generateCommitMessage(cwd)
+      const customMessage = await rl.question(`\x1b[36m  > 提交信息 [${defaultMessage}]: \x1b[0m`)
+      const message = customMessage.trim() || defaultMessage
+
+      // Get token
+      const { getStoredToken: getToken } = await import("./auth.mjs")
+      const { token } = await getToken() || {}
+      if (!token) {
+        console.log("\n  \x1b[31m错误: 未找到 GitHub Token，无法推送\x1b[0m")
+        return
+      }
+
+      console.log("\n  \x1b[36m📤 正在推送...\x1b[0m")
+      try {
+        await commitAndPush({ repoPath: cwd, message, branch: currentBranch, token })
+        console.log(`\x1b[32m  ✓ 已成功推送到 GitHub (${currentBranch})\x1b[0m\n`)
+      } catch (error) {
+        console.log(`\x1b[31m  ✗ 推送失败: ${error.message}\x1b[0m\n`)
+      }
+    } else if (choice === "2") {
+      console.log("\n  \x1b[33m⚠ 已放弃本地变更\x1b[0m\n")
+      // Optionally reset the repo
+      const { execFile } = await import("node:child_process")
+      await new Promise((resolve) => {
+        execFile("git", ["reset", "--hard", "HEAD"], { cwd }, () => resolve())
+      })
+    } else {
+      console.log("\n  \x1b[2m已跳过推送，您稍后可以使用 git 命令手动处理\x1b[0m\n")
+    }
+  } finally {
+    rl.close()
+  }
+}

package/src/github/workspace.mjs

@@ -0,0 +1,212 @@
+import { execFile } from "node:child_process"
+import { mkdir, readdir, stat, rm } from "node:fs/promises"
+import path from "node:path"
+import { githubReposDir } from "../storage/paths.mjs"
+
+function exec(cmd, args, opts = {}) {
+  return new Promise((resolve, reject) => {
+    execFile(cmd, args, { timeout: 120000, ...opts }, (err, stdout, stderr) => {
+      if (err) {
+        err.stderr = stderr
+        reject(err)
+      } else {
+        resolve(stdout.trim())
+      }
+    })
+  })
+}
+
+export function repoLocalPath(fullName) {
+  const [owner, repo] = fullName.split("/")
+  return path.join(githubReposDir(), owner, repo)
+}
+
+export async function isLocalRepo(fullName) {
+  try {
+    const p = repoLocalPath(fullName)
+    const s = await stat(path.join(p, ".git"))
+    return s.isDirectory()
+  } catch {
+    return false
+  }
+}
+
+export async function ensureRepo({ fullName, branch, token }) {
+  const localPath = repoLocalPath(fullName)
+  const exists = await isLocalRepo(fullName)
+
+  if (!exists) {
+    // Clone
+    await mkdir(path.dirname(localPath), { recursive: true })
+    const cloneUrl = `https://${token}@github.com/${fullName}.git`
+    await exec("git", ["clone", "--depth", "1", "-b", branch, "--single-branch", cloneUrl, localPath])
+    // Remove token from remote URL
+    const cleanUrl = `https://github.com/${fullName}.git`
+    await exec("git", ["remote", "set-url", "origin", cleanUrl], { cwd: localPath })
+    // Store token in git credential for this repo
+    await configureCredential(localPath, token)
+    return { path: localPath, isNew: true }
+  }
+
+  // Existing repo — fetch & checkout
+  await configureCredential(localPath, token)
+  await exec("git", ["fetch", "origin"], { cwd: localPath })
+
+  // Check if branch exists locally
+  const localBranchList = await localBranches(localPath)
+  if (localBranchList.includes(branch)) {
+    await exec("git", ["checkout", branch], { cwd: localPath })
+    await exec("git", ["pull", "--ff-only", "origin", branch], { cwd: localPath }).catch(() => {
+      // pull may fail if diverged, that's ok
+    })
+  } else {
+    // Checkout remote branch
+    await exec("git", ["checkout", "-b", branch, `origin/${branch}`], { cwd: localPath })
+  }
+
+  return { path: localPath, isNew: false }
+}
+
+async function configureCredential(repoPath, token) {
+  // Use store credential helper scoped to this repo
+  const credentialPath = path.join(repoPath, ".git", "kkcode-credentials")
+  const { writeFile } = await import("node:fs/promises")
+  await writeFile(credentialPath, `https://x-access-token:${token}@github.com\n`, "utf8")
+  await exec("git", ["config", "credential.helper", `store --file="${credentialPath}"`], { cwd: repoPath })
+}
+
+export async function listLocalRepos() {
+  const root = githubReposDir()
+  const repos = []
+  try {
+    const owners = await readdir(root)
+    for (const owner of owners) {
+      const ownerPath = path.join(root, owner)
+      const ownerStat = await stat(ownerPath).catch(() => null)
+      if (!ownerStat || !ownerStat.isDirectory()) continue
+      const names = await readdir(ownerPath)
+      for (const name of names) {
+        const gitDir = path.join(ownerPath, name, ".git")
+        const gitStat = await stat(gitDir).catch(() => null)
+        if (gitStat && gitStat.isDirectory()) {
+          repos.push(`${owner}/${name}`)
+        }
+      }
+    }
+  } catch {
+    // repos dir doesn't exist yet
+  }
+  return repos
+}
+
+export async function localBranches(repoPath) {
+  try {
+    const out = await exec("git", ["branch", "--list", "--format=%(refname:short)"], { cwd: repoPath })
+    return out.split("\n").filter(Boolean)
+  } catch {
+    return []
+  }
+}
+
+export async function removeLocalRepo(fullName) {
+  const localPath = repoLocalPath(fullName)
+  try {
+    await rm(localPath, { recursive: true, force: true })
+    return true
+  } catch {
+    return false
+  }
+}
+
+export async function syncRepo({ fullName, branch, token }) {
+  const localPath = repoLocalPath(fullName)
+  await configureCredential(localPath, token)
+  await exec("git", ["fetch", "origin"], { cwd: localPath })
+
+  // Check if branch exists locally
+  const localBranchList = await localBranches(localPath)
+  if (localBranchList.includes(branch)) {
+    await exec("git", ["checkout", branch], { cwd: localPath })
+    await exec("git", ["pull", "--ff-only", "origin", branch], { cwd: localPath }).catch(() => {
+      // pull may fail if diverged, that's ok
+    })
+  } else {
+    // Checkout remote branch
+    await exec("git", ["checkout", "-b", branch, `origin/${branch}`], { cwd: localPath })
+  }
+
+  return { path: localPath }
+}
+
+// Check if there are uncommitted changes
+export async function hasLocalChanges(repoPath) {
+  try {
+    const status = await exec("git", ["status", "--porcelain"], { cwd: repoPath })
+    return status.length > 0
+  } catch {
+    return false
+  }
+}
+
+// Get diff stats for display
+export async function getDiffStats(repoPath) {
+  try {
+    const stats = await exec("git", ["diff", "--stat", "HEAD"], { cwd: repoPath })
+    return stats
+  } catch {
+    return ""
+  }
+}
+
+// Get changed files list
+export async function getChangedFiles(repoPath) {
+  try {
+    const output = await exec("git", ["status", "--short"], { cwd: repoPath })
+    return output.split("\n").filter(Boolean)
+  } catch {
+    return []
+  }
+}
+
+// Commit and push changes
+export async function commitAndPush({ repoPath, message, branch, token }) {
+  await configureCredential(repoPath, token)
+
+  // Add all changes
+  await exec("git", ["add", "-A"], { cwd: repoPath })
+
+  // Commit
+  await exec("git", ["commit", "-m", message], { cwd: repoPath })
+
+  // Push
+  await exec("git", ["push", "origin", branch], { cwd: repoPath })
+
+  return true
+}
+
+// Generate a commit message based on changes
+export async function generateCommitMessage(repoPath) {
+  try {
+    const files = await getChangedFiles(repoPath)
+    if (files.length === 0) return "Update files"
+
+    // Count types of changes
+    const added = files.filter(f => f.startsWith("A") || f.startsWith("??")).length
+    const modified = files.filter(f => f.startsWith("M")).length
+    const deleted = files.filter(f => f.startsWith("D")).length
+
+    if (added > 0 && modified === 0 && deleted === 0) {
+      return added === 1 ? "Add file" : `Add ${added} files`
+    }
+    if (modified > 0 && added === 0 && deleted === 0) {
+      return modified === 1 ? "Update file" : `Update ${modified} files`
+    }
+    if (deleted > 0 && added === 0 && modified === 0) {
+      return deleted === 1 ? "Remove file" : `Remove ${deleted} files`
+    }
+
+    return `Update files (+${added} ~${modified} -${deleted})`
+  } catch {
+    return "Update files"
+  }
+}

package/src/index.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { Command } from "commander"
+import { createThemeCommand } from "./commands/theme.mjs"
+import { createUsageCommand } from "./commands/usage.mjs"
+import { createReviewCommand } from "./commands/review.mjs"
+import { createSessionCommand } from "./commands/session.mjs"
+import { createChatCommand } from "./commands/chat.mjs"
+import { createAgentCommand } from "./commands/agent.mjs"
+import { createMcpCommand } from "./commands/mcp.mjs"
+import { createPermissionCommand } from "./commands/permission.mjs"
+import { createDoctorCommand } from "./commands/doctor.mjs"
+import { createConfigCommand } from "./commands/config.mjs"
+import { createPromptCommand } from "./commands/prompt.mjs"
+import { createLongagentCommand } from "./commands/longagent.mjs"
+import { createHookCommand } from "./commands/hook.mjs"
+import { createCommandCommand } from "./commands/command.mjs"
+import { createRuleCommand } from "./commands/rule.mjs"
+import { createBackgroundCommand } from "./commands/background.mjs"
+import { createInitCommand } from "./commands/init.mjs"
+import { createAuditCommand } from "./commands/audit.mjs"
+import { startRepl } from "./repl.mjs"
+
+async function main() {
+  const hasTrust = process.argv.includes("--trust")
+  const hasGithub = process.argv.includes("--github")
+
+  if (hasGithub) {
+    const githubArgIndex = process.argv.indexOf("--github")
+    const nextArg = process.argv[githubArgIndex + 1]
+    
+    if (nextArg === "logout") {
+      const { logout } = await import("./github/auth.mjs")
+      const success = await logout()
+      if (success) {
+        console.log("✓ 已登出 GitHub 账户")
+      } else {
+        console.log("⚠ 没有已登录的 GitHub 账户")
+      }
+      return
+    }
+    
+    const { runGitHubFlow, promptPushChanges } = await import("./github/flow.mjs")
+    const result = await runGitHubFlow()
+    process.chdir(result.cwd)
+    await startRepl({ trust: hasTrust })
+    // After REPL exits, ask user if they want to push changes
+    await promptPushChanges(result)
+    return
+  }
+
+  if (process.argv.length <= 2 || (process.argv.length === 3 && hasTrust)) {
+    await startRepl({ trust: hasTrust })
+    return
+  }
+
+  const program = new Command()
+  program.name("kkcode").description("kkcode CLI").version("0.1.2")
+  program.addCommand(createChatCommand())
+  program.addCommand(createThemeCommand())
+  program.addCommand(createUsageCommand())
+  program.addCommand(createReviewCommand())
+  program.addCommand(createAgentCommand())
+  program.addCommand(createMcpCommand())
+  program.addCommand(createPermissionCommand())
+  program.addCommand(createDoctorCommand())
+  program.addCommand(createConfigCommand())
+  program.addCommand(createSessionCommand())
+  program.addCommand(createPromptCommand())
+  program.addCommand(createLongagentCommand())
+  program.addCommand(createHookCommand())
+  program.addCommand(createCommandCommand())
+  program.addCommand(createRuleCommand())
+  program.addCommand(createBackgroundCommand())
+  program.addCommand(createAuditCommand())
+  program.addCommand(createInitCommand())
+  await program.parseAsync(process.argv)
+}
+
+main().catch((error) => {
+  console.error(error.message)
+  process.exit(1)
+})

package/src/knowledge/api-design.txt

@@ -0,0 +1,9 @@
+API design conventions:
+- RESTful: resources as nouns, HTTP verbs for actions
+- Consistent response format: { data, error, meta }
+- Input validation at the boundary (controller/handler level)
+- Service layer for business logic, separate from HTTP handling
+- Error responses: appropriate status codes + error message + error code
+- Authentication middleware, not inline checks
+- Pagination: cursor-based or offset-based, consistent across endpoints
+- Versioning: URL prefix (/api/v1/) or header-based

package/src/knowledge/cpp.txt

@@ -0,0 +1,10 @@
+C/C++ conventions for this project:
+- C++: prefer modern C++ (C++17/20), RAII for resource management
+- Smart pointers: std::unique_ptr (default), std::shared_ptr (shared ownership)
+- Containers: std::vector, std::unordered_map, std::string
+- Error handling: exceptions for C++, error codes for C, std::expected (C++23)
+- Build: CMake (CMakeLists.txt) or Makefile
+- Headers: #pragma once or include guards, forward declarations to reduce includes
+- Naming: snake_case (Google/STL style) or camelCase (project convention)
+- Testing: Google Test (gtest) or Catch2
+- Memory: avoid raw new/delete, use containers and smart pointers

package/src/knowledge/docker.txt

@@ -0,0 +1,10 @@
+Docker conventions for this project:
+- Multi-stage builds: separate build and runtime stages
+- Use specific base image tags, not :latest
+- .dockerignore to exclude node_modules, .git, .env
+- One process per container, use docker-compose for multi-service
+- COPY package*.json first, then npm install (layer caching)
+- Non-root user: USER node or create dedicated user
+- Health checks: HEALTHCHECK CMD curl -f http://localhost:PORT/health
+- Environment variables for configuration, not hardcoded values
+- docker-compose.yml: services, volumes, networks, depends_on

package/src/knowledge/dotnet.txt

@@ -0,0 +1,9 @@
+ASP.NET Core conventions for this project:
+- Minimal API or Controller-based endpoints
+- Dependency injection via builder.Services
+- Entity Framework Core for data access with migrations
+- DTOs separate from domain models
+- Middleware pipeline for cross-cutting concerns
+- appsettings.json for configuration, IOptions<T> pattern
+- xUnit or NUnit for testing, Moq for mocking
+- Async/await throughout, CancellationToken for cancellation

package/src/knowledge/electron.txt

@@ -0,0 +1,10 @@
+Electron conventions for this project:
+- Process model: main process (Node.js) + renderer process (Chromium)
+- IPC: ipcMain/ipcRenderer for inter-process communication
+- Preload scripts: contextBridge.exposeInMainWorld() for secure API exposure
+- contextIsolation: true, nodeIntegration: false (security defaults)
+- BrowserWindow for app windows, Menu/Tray for system integration
+- Auto-update: electron-updater for release distribution
+- Packaging: electron-builder or electron-forge
+- File system access through main process, not renderer
+- Store user data in app.getPath('userData')

package/src/knowledge/flutter.txt

@@ -0,0 +1,10 @@
+Flutter/Dart conventions for this project:
+- Widget composition: small, focused widgets over large build() methods
+- StatelessWidget for UI without state, StatefulWidget only when needed
+- State management: Provider, Riverpod, or Bloc pattern
+- Navigation: GoRouter or Navigator 2.0 for declarative routing
+- Naming: snake_case for files, PascalCase for classes, camelCase for variables
+- Async: Future<T> and Stream<T> with async/await
+- Null safety: use required, late, and ? operators properly
+- Testing: widget tests with testWidgets(), unit tests with test()
+- Folder structure: lib/screens/, lib/widgets/, lib/models/, lib/services/

package/src/knowledge/go.txt

@@ -0,0 +1,9 @@
+Go conventions for this project:
+- Standard project layout: cmd/, internal/, pkg/
+- Error handling: return errors, don't panic. Wrap with fmt.Errorf("context: %w", err)
+- Interfaces: small, defined by consumer not provider
+- Concurrency: goroutines + channels, or sync.WaitGroup
+- Testing: table-driven tests, testify for assertions
+- Naming: MixedCaps, no underscores. Exported = uppercase first letter
+- Context: pass context.Context as first parameter
+- Dependencies: go mod, minimal external deps

package/src/knowledge/graphql.txt

@@ -0,0 +1,10 @@
+GraphQL conventions:
+- Schema-first or code-first design, consistent across project
+- Types: Query for reads, Mutation for writes, Subscription for real-time
+- Naming: camelCase for fields, PascalCase for types, UPPER_CASE for enums
+- Input types for mutation arguments: input CreateUserInput { ... }
+- Pagination: Relay-style connections (edges, nodes, pageInfo) or simple offset
+- Error handling: use errors array with extensions for error codes
+- N+1 prevention: DataLoader for batching and caching
+- Resolvers: thin resolvers that delegate to service layer
+- Authentication: context-based, not per-resolver checks