Skip to content

Egonex-AI/Understand-Anything / understand-anything-plugin/skills/understand

understand

Verified

Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships

FileKindSize
SKILL.mdskill md67.9 KB
build-fingerprints.mjsscript3.7 KB
compute-batches.mjsscript26.4 KB
extract-import-map.mjsscript81.6 KB
extract-structure-result.mjsscript9.8 KB
extract-structure.mjsscript7.4 KB
finalize-incremental.mjsscript19.7 KB
frameworks/django.mdmarkdown4.7 KB
frameworks/express.mdmarkdown4.3 KB
frameworks/fastapi.mdmarkdown4.3 KB
frameworks/flask.mdmarkdown3.4 KB
frameworks/gin.mdmarkdown4.5 KB
frameworks/nextjs.mdmarkdown4.3 KB
frameworks/rails.mdmarkdown5.3 KB
frameworks/react.mdmarkdown3.7 KB
frameworks/spring.mdmarkdown4.9 KB
frameworks/vue.mdmarkdown4.4 KB
generate-ignore.mjsscript2.5 KB
languages/cpp.mdmarkdown2.5 KB
languages/csharp.mdmarkdown2.6 KB
languages/css.mdmarkdown2.0 KB
languages/dockerfile.mdmarkdown1.9 KB
languages/go.mdmarkdown2.4 KB
languages/graphql.mdmarkdown1.9 KB
languages/html.mdmarkdown1.9 KB
languages/java.mdmarkdown2.4 KB
languages/javascript.mdmarkdown2.3 KB
languages/json.mdmarkdown1.7 KB
languages/kotlin.mdmarkdown2.5 KB
languages/markdown.mdmarkdown1.9 KB
languages/php.mdmarkdown2.5 KB
languages/protobuf.mdmarkdown1.8 KB
languages/python.mdmarkdown2.6 KB
languages/ruby.mdmarkdown2.4 KB
languages/rust.mdmarkdown2.4 KB
languages/scala.mdmarkdown3.2 KB
languages/shell.mdmarkdown1.8 KB
languages/sql.mdmarkdown2.0 KB
languages/swift.mdmarkdown2.5 KB
languages/terraform.mdmarkdown2.1 KB
languages/typescript.mdmarkdown2.5 KB
languages/yaml.mdmarkdown1.9 KB
locales/en.mdmarkdown1.5 KB
locales/ja.mdmarkdown2.1 KB
locales/ko.mdmarkdown1.9 KB
locales/ru.mdmarkdown3.1 KB
locales/vi.mdmarkdown2.1 KB
locales/zh-TW.mdmarkdown1.7 KB
locales/zh.mdmarkdown1.7 KB
merge-batch-graphs.pyscript57.6 KB
merge-subdomain-graphs.pyscript16.1 KB
normalize-tour.mjsscript3.4 KB
prepare-incremental.mjsscript25.4 KB
prepare-symbol-retry.mjsscript7.4 KB
prune-code-lessons.mjsscript4.2 KB
scan-project.mjsscript31.5 KB
validate-incremental-symbols.mjsscript25.8 KB

prune-code-lessons.mjs

View on GitHub
#!/usr/bin/env node
/**
 * Prune served code-lessons entries for files that no longer exist in the
 * saved knowledge graph. A PARTIAL_UPDATE can remove deleted or newly
 * ignored files from the graph while their source-derived lessons survive in
 * code-lessons.json — the viewer endpoint then keeps serving lessons for
 * paths the graph no longer knows about. Run this after a successful partial
 * save; surviving lessons are left untouched.
 *
 * Usage: node prune-code-lessons.mjs <projectRoot>
 *
 * Reads  $UA_DIR/knowledge-graph.json (file-level node filePaths form the
 *        legal key set — including table/endpoint nodes' filePaths, so a file
 *        that only has entity nodes left keeps its lesson)
 *        $UA_DIR/code-lessons.json (served lessons; missing -> silent no-op)
 * Writes $UA_DIR/code-lessons.json back only when at least one orphan entry
 *        was removed (atomic temp+rename).
 */

import { createRequire } from 'node:module';
import { dirname, isAbsolute, join, resolve } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { existsSync, readFileSync, realpathSync, renameSync, writeFileSync } from 'node:fs';

const __dirname = dirname(fileURLToPath(import.meta.url));
const pluginRoot = resolve(__dirname, '../..');
const require = createRequire(resolve(pluginRoot, 'package.json'));

let core;
try {
  core = await import(pathToFileURL(require.resolve('@understand-anything/core')).href);
} catch {
  core = await import(pathToFileURL(resolve(pluginRoot, 'packages/core/dist/index.js')).href);
}

const { resolveUaDir } = core;

function normalizeRelativePath(value) {
  if (typeof value !== 'string' || !value || isAbsolute(value)) return null;
  const platformPath = process.platform === 'win32' ? value.replaceAll('\\', '/') : value;
  const path = platformPath.replace(/^\.\//, '');
  if (!path || path.split('/').some(part => part === '..')) return null;
  return path;
}

function readJson(path) {
  return JSON.parse(readFileSync(path, 'utf-8'));
}

function atomicWriteJson(path, value) {
  const tempPath = `${path}.tmp-${process.pid}-${Date.now()}`;
  writeFileSync(tempPath, `${JSON.stringify(value, null, 2)}\n`, 'utf-8');
  renameSync(tempPath, path);
  // Verify the durable target, not the temporary file.
  JSON.parse(readFileSync(path, 'utf-8'));
}

const args = process.argv.slice(2);
if (args.length !== 1 || args[0].startsWith('--')) {
  console.error('Usage: node prune-code-lessons.mjs <projectRoot>');
  process.exit(1);
}

const projectRoot = realpathSync(args[0]);
const uaDir = resolveUaDir(projectRoot);
const graphPath = join(uaDir, 'knowledge-graph.json');
const lessonsPath = join(uaDir, 'code-lessons.json');

// Silent no-ops: nothing served to prune, or no graph to prune against.
if (!existsSync(graphPath) || !existsSync(lessonsPath)) {
  process.exit(0);
}

const graph = readJson(graphPath);
const nodes = Array.isArray(graph?.nodes) ? graph.nodes : [];

// Lessons are keyed by relative file path; any node carrying a filePath keeps
// that path's lesson legal (whole-file nodes, plus table/endpoint entities).
const legalPaths = new Set();
for (const node of nodes) {
  const path = normalizeRelativePath(node?.filePath);
  if (path) legalPaths.add(path);
}

const lessons = readJson(lessonsPath);
const files = lessons && typeof lessons === 'object' && !Array.isArray(lessons)
  ? lessons.files
  : null;
if (!files || typeof files !== 'object' || Array.isArray(files)) {
  process.exit(0);
}

// Null-prototype dictionary mirrors the dashboard's normalizeCodeLessons
// defense: a lesson keyed "__proto__" must survive the rewrite as an own
// entry instead of silently hitting Object.prototype's setter (which would
// drop the entry without counting it as removed).
const kept = Object.create(null);
let removed = 0;
for (const [filePath, entry] of Object.entries(files)) {
  const normalized = normalizeRelativePath(filePath);
  if (normalized && legalPaths.has(normalized)) {
    kept[filePath] = entry;
  } else {
    removed += 1;
  }
}

if (removed === 0) {
  process.stdout.write('Code lessons pruned: nothing to remove\n');
  process.exit(0);
}

atomicWriteJson(lessonsPath, { ...lessons, files: kept });
process.stdout.write(`Code lessons pruned: removed ${removed} orphaned entr${removed === 1 ? 'y' : 'ies'}\n`);
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall