@chrisdudek/yg 4.2.0 → 5.0.0-alpha.2

package/README.md

@@ -1,8 +1,10 @@
 # @chrisdudek/yg
 
-Yggdrasil CLI — continuous architecture enforcement for AI-assisted development.
+**Your agent will ignore CLAUDE.md. Yggdrasil makes sure it doesn't.**
 
-See the [main README](../../README.md) for documentation, or visit
+Architecture rules your agent can't ignore. You write them in plain Markdown; a reviewer verifies every change and feeds violations back into the agent's loop — before it moves on. Works with Claude Code, Cursor, Copilot, Codex, Cline, and more. The reviewer runs against your code, not your diffs. The feedback is specific, and the agent has to fix before moving on.
+
+See the [main README](https://github.com/krzysztofdudek/Yggdrasil#readme) for documentation, or visit
 [krzysztofdudek.github.io/Yggdrasil](https://krzysztofdudek.github.io/Yggdrasil/).
 
 ## Install

package/dist/ast.d.ts

@@ -0,0 +1,51 @@
+import { Tree, Node } from 'web-tree-sitter';
+export { Node as SyntaxNode, Tree } from 'web-tree-sitter';
+
+interface SourceFile {
+    /** Project-relative POSIX path */
+    path: string;
+    /** Raw source code */
+    content: string;
+    /** Parsed tree-sitter Tree */
+    ast: Tree;
+}
+interface CheckContext {
+    files: SourceFile[];
+}
+interface Violation {
+    /** Project-relative POSIX path */
+    file: string;
+    /** 1-based line number */
+    line: number;
+    /** 0-based column number */
+    column: number;
+    message: string;
+}
+
+declare function report(file: SourceFile, node: Node, message: string): Violation;
+
+type InFilePattern = {
+    glob: string;
+} | {
+    regex: RegExp;
+} | {
+    contains: string;
+};
+declare function inFile(file: SourceFile, pattern: InFilePattern): boolean;
+
+declare function walk(node: Node, visitor: (node: Node) => boolean | void): void;
+declare function closest(node: Node, types: string | string[]): Node | null;
+
+type FindCommentsTarget = {
+    path: string;
+    ast: Tree;
+} | {
+    ast: Tree;
+    language: string;
+} | {
+    rootNode: Node;
+    language: string;
+};
+declare function findComments(target: FindCommentsTarget): Node[];
+
+export { type CheckContext, type FindCommentsTarget, type InFilePattern, type SourceFile, type Violation, closest, findComments, inFile, report, walk };

package/dist/ast.js

@@ -0,0 +1,279 @@
+// src/ast/report.ts
+function report(file, node, message) {
+  return {
+    file: file.path,
+    line: node.startPosition.row + 1,
+    column: node.startPosition.column,
+    message
+  };
+}
+
+// src/ast/file-path.ts
+import { minimatch } from "minimatch";
+function inFile(file, pattern) {
+  if ("glob" in pattern) return minimatch(file.path, pattern.glob);
+  if ("regex" in pattern) return pattern.regex.test(file.path);
+  if ("contains" in pattern) return file.path.includes(pattern.contains);
+  return false;
+}
+
+// src/ast/walk.ts
+function walk(node, visitor) {
+  const result = visitor(node);
+  if (result === false) return;
+  for (let i = 0; i < node.childCount; i++) {
+    const child = node.child(i);
+    if (child !== null) walk(child, visitor);
+  }
+}
+function closest(node, types) {
+  const typeSet = typeof types === "string" ? /* @__PURE__ */ new Set([types]) : new Set(types);
+  let cur = node.parent;
+  while (cur !== null) {
+    if (typeSet.has(cur.type)) return cur;
+    cur = cur.parent;
+  }
+  return null;
+}
+
+// src/ast/find-comments.ts
+import { extname } from "path";
+
+// src/core/graph/language-registry.ts
+var LANGUAGES = {
+  typescript: {
+    id: "typescript",
+    extensions: [".ts"],
+    wasmFile: "tree-sitter-typescript.wasm",
+    wasmPackage: "tree-sitter-typescript",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-typescript",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  tsx: {
+    id: "tsx",
+    extensions: [".tsx"],
+    wasmFile: "tree-sitter-tsx.wasm",
+    wasmPackage: "tree-sitter-typescript",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-typescript",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  javascript: {
+    id: "javascript",
+    extensions: [".js", ".mjs", ".cjs", ".jsx"],
+    wasmFile: "tree-sitter-javascript.wasm",
+    wasmPackage: "tree-sitter-javascript",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-javascript",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  python: {
+    id: "python",
+    extensions: [".py"],
+    wasmFile: "tree-sitter-python.wasm",
+    wasmPackage: "tree-sitter-python",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-python",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["#"]
+  },
+  go: {
+    id: "go",
+    extensions: [".go"],
+    wasmFile: "tree-sitter-go.wasm",
+    wasmPackage: "tree-sitter-go",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-go",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  rust: {
+    id: "rust",
+    extensions: [".rs"],
+    wasmFile: "tree-sitter-rust.wasm",
+    wasmPackage: "tree-sitter-rust",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-rust",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["line_comment", "block_comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  java: {
+    id: "java",
+    extensions: [".java"],
+    wasmFile: "tree-sitter-java.wasm",
+    wasmPackage: "tree-sitter-java",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-java",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["line_comment", "block_comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  csharp: {
+    id: "csharp",
+    extensions: [".cs"],
+    wasmFile: "tree-sitter-c_sharp.wasm",
+    wasmPackage: "tree-sitter-c-sharp",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-c-sharp",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  c: {
+    id: "c",
+    extensions: [".c", ".h"],
+    wasmFile: "tree-sitter-c.wasm",
+    wasmPackage: "tree-sitter-c",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-c",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  cpp: {
+    id: "cpp",
+    extensions: [".cpp", ".cc", ".cxx", ".hpp", ".hh", ".hxx"],
+    wasmFile: "tree-sitter-cpp.wasm",
+    wasmPackage: "tree-sitter-cpp",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-cpp",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  php: {
+    id: "php",
+    extensions: [".php"],
+    wasmFile: "tree-sitter-php_only.wasm",
+    wasmPackage: "tree-sitter-php",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-php",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["//", "#", "/*"]
+  },
+  ruby: {
+    id: "ruby",
+    extensions: [".rb"],
+    wasmFile: "tree-sitter-ruby.wasm",
+    wasmPackage: "tree-sitter-ruby",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-ruby",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["#"]
+  },
+  json: {
+    id: "json",
+    extensions: [".json"],
+    wasmFile: "tree-sitter-json.wasm",
+    wasmPackage: "tree-sitter-json",
+    grammarRepo: "https://github.com/tree-sitter/tree-sitter-json",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: [],
+    commentDelimiters: []
+  },
+  kotlin: {
+    id: "kotlin",
+    extensions: [".kt", ".kts"],
+    wasmFile: "tree-sitter-kotlin.wasm",
+    wasmPackage: "@tree-sitter-grammars/tree-sitter-kotlin",
+    grammarRepo: "https://github.com/tree-sitter-grammars/tree-sitter-kotlin",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["line_comment", "block_comment"],
+    commentDelimiters: ["//", "/*"]
+  },
+  yaml: {
+    id: "yaml",
+    extensions: [".yaml", ".yml"],
+    wasmFile: "tree-sitter-yaml.wasm",
+    wasmPackage: "@tree-sitter-grammars/tree-sitter-yaml",
+    grammarRepo: "https://github.com/tree-sitter-grammars/tree-sitter-yaml",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["#"]
+  },
+  toml: {
+    id: "toml",
+    extensions: [".toml"],
+    wasmFile: "tree-sitter-toml.wasm",
+    wasmPackage: "@tree-sitter-grammars/tree-sitter-toml",
+    grammarRepo: "https://github.com/tree-sitter-grammars/tree-sitter-toml",
+    grammarCommit: "",
+    treeSitterCliVersion: "",
+    externalScanner: false,
+    commentTypes: ["comment"],
+    commentDelimiters: ["#"]
+  }
+};
+var EXTENSION_TO_LANGUAGE = Object.fromEntries(
+  Object.values(LANGUAGES).flatMap((def) => def.extensions.map((ext) => [ext, def.id]))
+);
+function getLanguageForExtension(ext, overrides) {
+  if (overrides && ext in overrides) return overrides[ext];
+  return EXTENSION_TO_LANGUAGE[ext] ?? null;
+}
+
+// src/ast/find-comments.ts
+function findComments(target) {
+  const hasAst = "ast" in target;
+  const hasRootNode = "rootNode" in target;
+  if (hasAst && hasRootNode) {
+    throw new Error("AST_FINDCOMMENTS_AMBIGUOUS_TARGET: pass either ast or rootNode, not both");
+  }
+  let language = "language" in target ? target.language : void 0;
+  if (language === void 0 && "path" in target) {
+    language = getLanguageForExtension(extname(target.path)) ?? void 0;
+  }
+  if (language === void 0) {
+    throw new Error(
+      "AST_FINDCOMMENTS_NO_LANGUAGE: pass a SourceFile whose path has a known extension, or an explicit { language }"
+    );
+  }
+  const def = LANGUAGES[language];
+  if (def === void 0) {
+    throw new Error(`AST_FINDCOMMENTS_UNKNOWN_LANGUAGE: '${language}' not in registry`);
+  }
+  const root = hasAst ? target.ast.rootNode : target.rootNode;
+  const out = [];
+  for (const type of def.commentTypes) {
+    out.push(...root.descendantsOfType(type));
+  }
+  return out;
+}
+export {
+  closest,
+  findComments,
+  inFile,
+  report,
+  walk
+};
+//# sourceMappingURL=ast.js.map