code-moniker-core 0.6.0

Core symbol-graph types and per-language extractors for code-moniker.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

fragment = "core"

# `code_moniker_core` owns the pure model and language extractors. Keep these
# rules colocated with the crate-level architecture they protect.

[aliases]
core    = "moniker ~ '**/dir:src/*:core/**'"
lang    = "moniker ~ '**/dir:src/*:lang/**'"
tree_sitter_sdk_extractor = "moniker ~ '**/dir:src/*:lang/*/*:sdk_pipeline/**'"
text_mini_parser_call = """
  kind = 'method_call'
  AND target.name =~ ^(find|rfind|split|split_once|lines|chars|char_indices|contains|starts_with|trim|trim_start|trim_end)$
"""

[[refs.where]]
id      = "core-no-tree-sitter"
expr    = "$core AND kind = 'imports_symbol' => NOT target ~ '**/external_pkg:tree_sitter/**'"
message = "Module `core` is parser-agnostic; tree-sitter belongs under `crates/core/src/lang/`."

[[rust.fn.where]]
id       = "tree-sitter-extractor-no-text-mini-parser"
severity = "error"
expr     = """
  $tree_sitter_sdk_extractor
  => NOT (
    any(out_refs, kind = 'method_call' AND target.name = 'utf8_text')
    AND any(out_refs, $text_mini_parser_call)
  )
"""
message  = "Tree-sitter extractor `{name}` parses node text manually; traverse `Node` children/fields instead."
rationale = """
The SDK extractors sit directly on top of Tree-sitter. When Tree-sitter already exposes
nodes, fields, token-tree nesting, or attributes, the extractor must consume that structure
instead of reparsing `utf8_text()` with string primitives such as `find`, `split_once`,
`char_indices`, or `starts_with`.

Manual text parsing in extractors is fragile: it duplicates the grammar, misses nested token
trees, and makes correctness depend on formatting trivia. The acceptable escape hatch is an
explicit `code-moniker: ignore[...]` with a short justification when the input is not
represented structurally by Tree-sitter, such as an external manifest format or an intentionally
opaque macro payload.
"""

[[refs.where]]
id      = "core-no-upper"
expr    = """
  $core AND kind = 'imports_symbol'
  => NOT target ~ '**/*:lang/**'
"""
message = "`core` is the foundation submodule; it must not depend on sibling `lang` internals."
rationale = """
The core model must stay reusable by every extractor and surface. Letting it import language
internals would invert the dependency graph and make later language additions affect the base
model.
"""