iwe 0.16.0

IWE CLI utility
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69

DOT OUTPUT FORMAT:

  Graphviz DOT language. Nodes use numeric ids labeled with document
  titles, note-shaped and filled with a per-document color:

    digraph G {
      rankdir=LR
      1[label="Document Title",fillcolor="#ffeaea",shape=note,style=filled]
      2[label="Other Document",fillcolor="#f6e5ee",shape=note,style=filled]
      1 -> 2
    }

  With --include-headers, sections become plain-shaped nodes grouped in
  colored subgraphs per document:

    digraph G {
      rankdir=LR
      1[label="Document Title",shape=note,style=filled]
      2[label="Section",shape=plain]
      subgraph cluster_0 {
        style=filled
        fillcolor="#fff9de"
        2
      }
      2 -> 1 [arrowhead="empty",style="dashed"]
    }

FILTER FLAGS (narrow the exported set):

  --filter "EXPR"             Inline filter expression (YAML).
  -k, --key KEY               Match by key. Repeatable.
  --includes KEY[:DEPTH]      $includes anchor.
  --included-by KEY[:DEPTH]   $includedBy anchor.
  --references KEY[:DIST]     $references anchor.
  --referenced-by KEY[:DIST]  $referencedBy anchor.
  --max-depth N               Default maxDepth for inclusion anchors. Default 1.
  --max-distance N            Default maxDistance for reference anchors. Default 1.

EXAMPLES:

  # Export entire graph
  iwe export

  # Export specific document(s) and connections (-k is repeatable)
  iwe export --key project-main
  iwe export -k project-main -k project-beta

  # Include section headers for detailed view
  iwe export --include-headers

  # Control connection depth
  iwe export --key index --depth 2

  # Restrict to a subtree via filter
  iwe export --included-by projects/alpha
  iwe export --included-by projects/alpha --filter '$nor: [{ $includedBy: archive }]'

USING DOT OUTPUT:

  # Generate PNG visualization
  iwe export > graph.dot
  dot -Tpng graph.dot -o graph.png

  # Generate SVG for web use
  iwe export --include-headers > detailed.dot
  dot -Tsvg detailed.dot -o detailed.svg

  # Interactive exploration with xdot
  iwe export | xdot -