npm - pi-gitnexus-fork - Versions diffs - 0.7.0 - Mend

pi-gitnexus-fork 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (117) hide show

package/.github/workflows/ci.yml +20 -0
package/.gitnexusignore +11 -0
package/.sg-rules/async-function-must-await-or-return.yml +55 -0
package/.sg-rules/catch-must-log-error.yml +78 -0
package/.sg-rules/class-must-implement-or-extend.yml +61 -0
package/.sg-rules/class-property-must-be-readonly.yml +61 -0
package/.sg-rules/error-must-extend-base.yml +56 -0
package/.sg-rules/generic-must-be-constrained.yml +60 -0
package/.sg-rules/import-reexport-risk.yml +9 -0
package/.sg-rules/missing-session-id-in-api.yml +16 -0
package/.sg-rules/no-any-in-generic-args.yml +57 -0
package/.sg-rules/no-await-in-promise-all.yml +28 -0
package/.sg-rules/no-barrel-export.yml +17 -0
package/.sg-rules/no-bq-write-in-module.yml +65 -0
package/.sg-rules/no-console-except-error.yml +27 -0
package/.sg-rules/no-console-in-server.yml +42 -0
package/.sg-rules/no-empty-catch.yml +20 -0
package/.sg-rules/no-empty-function.yml +24 -0
package/.sg-rules/no-eval.yml +28 -0
package/.sg-rules/no-explicit-any.yml +34 -0
package/.sg-rules/no-hardcoded-placeholder-string.yml +23 -0
package/.sg-rules/no-hardcoded-secrets.yml +32 -0
package/.sg-rules/no-innerHTML.yml +22 -0
package/.sg-rules/no-json-parse-without-trycatch.yml +33 -0
package/.sg-rules/no-magic-numbers.yml +25 -0
package/.sg-rules/no-nested-ternary.yml +21 -0
package/.sg-rules/no-non-null-assertion.yml +25 -0
package/.sg-rules/no-stub-implementation.yml +44 -0
package/.sg-rules/no-throw-literal.yml +50 -0
package/.sg-rules/no-todo-comment.yml +24 -0
package/.sg-rules/no-ts-ignore-comment.yml +48 -0
package/.sg-rules/no-type-assertion-in-jsx.yml +23 -0
package/.sg-rules/no-unguarded-trim.yml +24 -0
package/.sg-rules/no-unknown-without-narrowing.yml +76 -0
package/.sg-rules/no-unsafe-bracket-access.yml +58 -0
package/.sg-rules/no-unsafe-type-assertion.yml +45 -0
package/.sg-rules/switch-must-be-exhaustive.yml +62 -0
package/.sg-rules/zod-async-refine-without-abort.yml +62 -0
package/.sg-rules/zod-enum-unsafe-access.yml +59 -0
package/.sg-rules/zod-nested-object-deep-path.yml +70 -0
package/.sg-rules/zod-optional-without-default-in-route.yml +50 -0
package/.sg-rules/zod-parse-not-safe.yml +42 -0
package/.sg-rules/zod-preprocess-without-fallback.yml +58 -0
package/.sg-rules/zod-refine-no-return-undefined.yml +54 -0
package/.sg-rules/zod-transform-without-output-type.yml +52 -0
package/.sg-sha +1 -0
package/.sgignore +4 -0
package/AGENTS.md +1 -0
package/CHANGELOG.md +99 -0
package/LICENSE +21 -0
package/README.md +113 -0
package/biome.json +25 -0
package/coverage/base.css +224 -0
package/coverage/block-navigation.js +87 -0
package/coverage/clover.xml +890 -0
package/coverage/coverage-final.json +12 -0
package/coverage/favicon.png +0 -0
package/coverage/index.html +131 -0
package/coverage/prettify.css +1 -0
package/coverage/prettify.js +2 -0
package/coverage/sort-arrow-sprite.png +0 -0
package/coverage/sorter.js +210 -0
package/coverage/src/augment-remote.ts.html +274 -0
package/coverage/src/gitnexus.ts.html +1363 -0
package/coverage/src/index.html +236 -0
package/coverage/src/index.ts.html +1561 -0
package/coverage/src/mcp-client-factory.ts.html +367 -0
package/coverage/src/mcp-client-stdio.ts.html +736 -0
package/coverage/src/mcp-client.ts.html +568 -0
package/coverage/src/remote-mcp-client.ts.html +709 -0
package/coverage/src/repo-resolver.ts.html +526 -0
package/coverage/src/tools.ts.html +970 -0
package/coverage/src/ui/index.html +131 -0
package/coverage/src/ui/main-menu.ts.html +502 -0
package/coverage/src/ui/settings-menu.ts.html +460 -0
package/dist/augment-remote.d.ts +11 -0
package/dist/augment-remote.js +55 -0
package/dist/gitnexus.d.ts +103 -0
package/dist/gitnexus.js +410 -0
package/dist/index.d.ts +2 -0
package/dist/index.js +479 -0
package/dist/mcp-client-factory.d.ts +19 -0
package/dist/mcp-client-factory.js +78 -0
package/dist/mcp-client-stdio.d.ts +35 -0
package/dist/mcp-client-stdio.js +186 -0
package/dist/mcp-client.d.ts +45 -0
package/dist/mcp-client.js +145 -0
package/dist/remote-mcp-client.d.ts +43 -0
package/dist/remote-mcp-client.js +181 -0
package/dist/repo-resolver.d.ts +47 -0
package/dist/repo-resolver.js +123 -0
package/dist/tools.d.ts +6 -0
package/dist/tools.js +230 -0
package/dist/ui/main-menu.d.ts +33 -0
package/dist/ui/main-menu.js +102 -0
package/dist/ui/settings-menu.d.ts +16 -0
package/dist/ui/settings-menu.js +95 -0
package/docs/design/remote-mcp-backend.md +153 -0
package/media/screenshot.png +0 -0
package/package.json +61 -0
package/sgconfig.yml +4 -0
package/skills/gitnexus-debugging/SKILL.md +84 -0
package/skills/gitnexus-exploring/SKILL.md +73 -0
package/skills/gitnexus-impact-analysis/SKILL.md +93 -0
package/skills/gitnexus-pr-review/SKILL.md +109 -0
package/skills/gitnexus-refactoring/SKILL.md +85 -0
package/src/augment-remote.ts +63 -0
package/src/gitnexus.ts +426 -0
package/src/index.ts +492 -0
package/src/mcp-client-factory.ts +94 -0
package/src/mcp-client-stdio.ts +217 -0
package/src/mcp-client.ts +208 -0
package/src/remote-mcp-client.ts +250 -0
package/src/repo-resolver.ts +147 -0
package/src/tools.ts +295 -0
package/src/ui/main-menu.ts +139 -0
package/src/ui/settings-menu.ts +125 -0

package/coverage/src/ui/settings-menu.ts.html ADDED Viewed

@@ -0,0 +1,460 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for src/ui/settings-menu.ts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../prettify.css" />
+    <link rel="stylesheet" href="../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../index.html">All files</a> / <a href="index.html">src/ui</a> settings-menu.ts</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>0/29</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>0/20</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>0/7</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">0% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>0/29</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line low'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a>
+<a name='L37'></a><a href='#L37'>37</a>
+<a name='L38'></a><a href='#L38'>38</a>
+<a name='L39'></a><a href='#L39'>39</a>
+<a name='L40'></a><a href='#L40'>40</a>
+<a name='L41'></a><a href='#L41'>41</a>
+<a name='L42'></a><a href='#L42'>42</a>
+<a name='L43'></a><a href='#L43'>43</a>
+<a name='L44'></a><a href='#L44'>44</a>
+<a name='L45'></a><a href='#L45'>45</a>
+<a name='L46'></a><a href='#L46'>46</a>
+<a name='L47'></a><a href='#L47'>47</a>
+<a name='L48'></a><a href='#L48'>48</a>
+<a name='L49'></a><a href='#L49'>49</a>
+<a name='L50'></a><a href='#L50'>50</a>
+<a name='L51'></a><a href='#L51'>51</a>
+<a name='L52'></a><a href='#L52'>52</a>
+<a name='L53'></a><a href='#L53'>53</a>
+<a name='L54'></a><a href='#L54'>54</a>
+<a name='L55'></a><a href='#L55'>55</a>
+<a name='L56'></a><a href='#L56'>56</a>
+<a name='L57'></a><a href='#L57'>57</a>
+<a name='L58'></a><a href='#L58'>58</a>
+<a name='L59'></a><a href='#L59'>59</a>
+<a name='L60'></a><a href='#L60'>60</a>
+<a name='L61'></a><a href='#L61'>61</a>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a>
+<a name='L70'></a><a href='#L70'>70</a>
+<a name='L71'></a><a href='#L71'>71</a>
+<a name='L72'></a><a href='#L72'>72</a>
+<a name='L73'></a><a href='#L73'>73</a>
+<a name='L74'></a><a href='#L74'>74</a>
+<a name='L75'></a><a href='#L75'>75</a>
+<a name='L76'></a><a href='#L76'>76</a>
+<a name='L77'></a><a href='#L77'>77</a>
+<a name='L78'></a><a href='#L78'>78</a>
+<a name='L79'></a><a href='#L79'>79</a>
+<a name='L80'></a><a href='#L80'>80</a>
+<a name='L81'></a><a href='#L81'>81</a>
+<a name='L82'></a><a href='#L82'>82</a>
+<a name='L83'></a><a href='#L83'>83</a>
+<a name='L84'></a><a href='#L84'>84</a>
+<a name='L85'></a><a href='#L85'>85</a>
+<a name='L86'></a><a href='#L86'>86</a>
+<a name='L87'></a><a href='#L87'>87</a>
+<a name='L88'></a><a href='#L88'>88</a>
+<a name='L89'></a><a href='#L89'>89</a>
+<a name='L90'></a><a href='#L90'>90</a>
+<a name='L91'></a><a href='#L91'>91</a>
+<a name='L92'></a><a href='#L92'>92</a>
+<a name='L93'></a><a href='#L93'>93</a>
+<a name='L94'></a><a href='#L94'>94</a>
+<a name='L95'></a><a href='#L95'>95</a>
+<a name='L96'></a><a href='#L96'>96</a>
+<a name='L97'></a><a href='#L97'>97</a>
+<a name='L98'></a><a href='#L98'>98</a>
+<a name='L99'></a><a href='#L99'>99</a>
+<a name='L100'></a><a href='#L100'>100</a>
+<a name='L101'></a><a href='#L101'>101</a>
+<a name='L102'></a><a href='#L102'>102</a>
+<a name='L103'></a><a href='#L103'>103</a>
+<a name='L104'></a><a href='#L104'>104</a>
+<a name='L105'></a><a href='#L105'>105</a>
+<a name='L106'></a><a href='#L106'>106</a>
+<a name='L107'></a><a href='#L107'>107</a>
+<a name='L108'></a><a href='#L108'>108</a>
+<a name='L109'></a><a href='#L109'>109</a>
+<a name='L110'></a><a href='#L110'>110</a>
+<a name='L111'></a><a href='#L111'>111</a>
+<a name='L112'></a><a href='#L112'>112</a>
+<a name='L113'></a><a href='#L113'>113</a>
+<a name='L114'></a><a href='#L114'>114</a>
+<a name='L115'></a><a href='#L115'>115</a>
+<a name='L116'></a><a href='#L116'>116</a>
+<a name='L117'></a><a href='#L117'>117</a>
+<a name='L118'></a><a href='#L118'>118</a>
+<a name='L119'></a><a href='#L119'>119</a>
+<a name='L120'></a><a href='#L120'>120</a>
+<a name='L121'></a><a href='#L121'>121</a>
+<a name='L122'></a><a href='#L122'>122</a>
+<a name='L123'></a><a href='#L123'>123</a>
+<a name='L124'></a><a href='#L124'>124</a>
+<a name='L125'></a><a href='#L125'>125</a>
+<a name='L126'></a><a href='#L126'>126</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
+ * settings-menu.ts — Interactive settings panel for /gitnexus settings.
+ *
+ * Uses ui.custom() + SettingsList for native TUI rendering with keyboard
+ * navigation, live toggle, and per-row descriptions.
+ */
+&nbsp;
+import { getSettingsListTheme } from "@mariozechner/pi-coding-agent";
+import { Container, type SettingItem, SettingsList, Spacer, Text } from "@mariozechner/pi-tui";
+import { type GitNexusConfig, saveConfig } from "../gitnexus.js";
+&nbsp;
+// ── Types ───────────────────────────────────────────────────────────────────
+&nbsp;
+export type SettingsUI = {
+  custom&lt;T&gt;(
+    factory: (tui: any, theme: any, keybindings: any, done: (result: T) =&gt; void) =&gt; any,
+    options?: { overlay?: boolean; overlayOptions?: any },
+  ): Promise&lt;T&gt;;
+};
+&nbsp;
+// ── Settings panel ──────────────────────────────────────────────────────────
+&nbsp;
+export async function <span class="fstat-no" title="function not covered" >openSettingsMenu(</span>
+  ui: SettingsUI,
+  cfg: GitNexusConfig,
+  state: { augmentEnabled: boolean },
+  onBack: () =&gt; Promise&lt;void&gt;,
+): Promise&lt;void&gt; {
+<span class="cstat-no" title="statement not covered" >  await ui.<span class="fstat-no" title="function not covered" >custom((_</span>tui, theme, _kb, done) =&gt; {</span>
+    const items: SettingItem[] = <span class="cstat-no" title="statement not covered" >[</span>
+      {
+        id: "autoAugment",
+        label: "Auto-augment",
+        description:
+          "When ON: search results (grep, find, read, bash) are automatically " +
+          "enriched with knowledge graph context. When OFF: graph context is " +
+          "only available via explicit /gitnexus commands and tools.",
+        currentValue: state.augmentEnabled ? "on" : "off",
+        values: ["on", "off"],
+      },
+      {
+        id: "augmentTimeout",
+        label: "Augment timeout",
+        description:
+          "Maximum time (in seconds) to wait for a graph augmentation response. " +
+          "Increase for large repos with slow I/O, decrease for snappier responses. " +
+          "Default: 8s.",
+        currentValue: String(cfg.augmentTimeout ?? 8),
+        values: ["4", "6", "8", "10", "15", "20"],
+      },
+      {
+        id: "maxAugmentsPerResult",
+        label: "Max augments per result",
+        description:
+          "Maximum number of patterns to augment in parallel per search result. " +
+          "Higher values provide more context but use more tokens. Default: 3.",
+        currentValue: String(cfg.maxAugmentsPerResult ?? 3),
+        values: ["1", "2", "3", "5"],
+      },
+      {
+        id: "maxSecondaryPatterns",
+        label: "Max secondary patterns",
+        description:
+          "Maximum number of secondary file-based patterns extracted from grep/bash " +
+          "output. These provide additional context from files mentioned in results. " +
+          "Default: 2.",
+        currentValue: String(cfg.maxSecondaryPatterns ?? 2),
+        values: ["0", "1", "2", "3", "5"],
+      },
+      {
+        id: "cmd",
+        label: "GitNexus command",
+        description:
+          "The shell command used to invoke gitnexus. " +
+          "Change if gitnexus is installed in a non-standard location or you want " +
+          "to use npx. Default: gitnexus.",
+        currentValue: cfg.cmd ?? "gitnexus",
+        values: ["gitnexus", "npx gitnexus@latest", "npx -y gitnexus@latest"],
+      },
+    ];
+&nbsp;
+    const list = <span class="cstat-no" title="statement not covered" >new SettingsList(</span>
+      items,
+      Math.min(items.length + 2, 15),
+      getSettingsListTheme(),
+      /* onChange */ (<span class="fstat-no" title="function not covered" >id, n</span>ewValue) =&gt; {
+<span class="cstat-no" title="statement not covered" >        if (id === "autoAugment") {</span>
+<span class="cstat-no" title="statement not covered" >          state.augmentEnabled = newValue === "on";</span>
+<span class="cstat-no" title="statement not covered" >          cfg.autoAugment = newValue === "on";</span>
+<span class="cstat-no" title="statement not covered" >          saveConfig(cfg);</span>
+        }
+<span class="cstat-no" title="statement not covered" >        if (id === "augmentTimeout") {</span>
+<span class="cstat-no" title="statement not covered" >          cfg.augmentTimeout = parseInt(newValue, 10);</span>
+<span class="cstat-no" title="statement not covered" >          saveConfig(cfg);</span>
+        }
+<span class="cstat-no" title="statement not covered" >        if (id === "maxAugmentsPerResult") {</span>
+<span class="cstat-no" title="statement not covered" >          cfg.maxAugmentsPerResult = parseInt(newValue, 10);</span>
+<span class="cstat-no" title="statement not covered" >          saveConfig(cfg);</span>
+        }
+<span class="cstat-no" title="statement not covered" >        if (id === "maxSecondaryPatterns") {</span>
+<span class="cstat-no" title="statement not covered" >          cfg.maxSecondaryPatterns = parseInt(newValue, 10);</span>
+<span class="cstat-no" title="statement not covered" >          saveConfig(cfg);</span>
+        }
+<span class="cstat-no" title="statement not covered" >        if (id === "cmd") {</span>
+<span class="cstat-no" title="statement not covered" >          cfg.cmd = newValue;</span>
+<span class="cstat-no" title="statement not covered" >          saveConfig(cfg);</span>
+        }
+      },
+      /* onCancel */ () =&gt; <span class="cstat-no" title="statement not covered" ><span class="fstat-no" title="function not covered" >done(u</span>ndefined),</span>
+    );
+&nbsp;
+    const container = <span class="cstat-no" title="statement not covered" >new Container();</span>
+<span class="cstat-no" title="statement not covered" >    container.addChild(new Text(theme.bold(theme.fg("accent", "⚙  GitNexus Settings")), 0, 0));</span>
+<span class="cstat-no" title="statement not covered" >    container.addChild(new Spacer(1));</span>
+<span class="cstat-no" title="statement not covered" >    container.addChild(list);</span>
+&nbsp;
+<span class="cstat-no" title="statement not covered" >    return {</span>
+<span class="fstat-no" title="function not covered" >      render: (w</span>: number) =&gt; <span class="cstat-no" title="statement not covered" >container.render(w),</span>
+<span class="fstat-no" title="function not covered" >      invalidate: () =&gt; <span class="cstat-no" title="statement not covered" >c</span>ontainer.invalidate(),</span>
+<span class="fstat-no" title="function not covered" >      handleInput: (d</span>ata: string) =&gt; <span class="cstat-no" title="statement not covered" >list.handleInput?.(data),</span>
+    };
+  });
+&nbsp;
+<span class="cstat-no" title="statement not covered" >  return onBack();</span>
+}
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-05-03T18:51:43.670Z
+            </div>
+        <script src="../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../sorter.js"></script>
+        <script src="../../block-navigation.js"></script>
+    </body>
+</html>

package/dist/augment-remote.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+/** Reset caches. Call on session start. */
+export declare function clearAugmentCache(): void;
+/**
+ * Run augment via remote MCP query tool.
+ *
+ * @param pattern    The search pattern to look up
+ * @param cwd        The host working directory (passed to callTool)
+ * @param serverRepo The server-side repo path
+ * @returns The augment result text, or empty string on error/empty
+ */
+export declare function augmentRemote(pattern: string, cwd: string, serverRepo: string): Promise<string>;

package/dist/augment-remote.js ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * Patterns already augmented this session (with non-empty results).
+ * Keys are lowercased for case-insensitive dedup.
+ * Uses microsecond-precision timestamps for test isolation.
+ */
+const augmentedCache = new Map();
+/**
+ * Patterns that returned empty results on first attempt.
+ */
+const emptyCache = new Set();
+/** Reset caches. Call on session start. */
+export function clearAugmentCache() {
+    augmentedCache.clear();
+    emptyCache.clear();
+}
+/**
+ * Run augment via remote MCP query tool.
+ *
+ * @param pattern    The search pattern to look up
+ * @param cwd        The host working directory (passed to callTool)
+ * @param serverRepo The server-side repo path
+ * @returns The augment result text, or empty string on error/empty
+ */
+export async function augmentRemote(pattern, cwd, serverRepo) {
+    const key = pattern.toLowerCase();
+    const now = performance.now();
+    // Check augmented cache — return cached result if recent
+    const cached = augmentedCache.get(key);
+    if (cached && (now - cached.ts) < 0.5) {
+        return cached.result;
+    }
+    // Check empty cache — skip early
+    if (emptyCache.has(key)) {
+        return '';
+    }
+    try {
+        // Dynamic import to avoid vi.mock hoisting issues with mcp-client-factory
+        const { McpClientFactory } = await import('./mcp-client-factory');
+        const config = McpClientFactory.loadConfig();
+        const client = await McpClientFactory.createClient(config);
+        const result = await client.callTool('query', { query: pattern, repo: serverRepo }, cwd);
+        if (result) {
+            augmentedCache.set(key, { result, ts: performance.now() });
+            return result;
+        }
+        else {
+            emptyCache.add(key);
+            return '';
+        }
+    }
+    catch {
+        emptyCache.add(key);
+        return '';
+    }
+}

package/dist/gitnexus.d.ts ADDED Viewed

@@ -0,0 +1,103 @@
+/** Max output chars returned to the LLM. Prevents context flooding. JS strings are UTF-16 chars, not bytes. */
+export declare const MAX_OUTPUT_CHARS: number;
+/**
+ * Environment passed to all child processes.
+ * On session_start, the agent's PATH is merged with the login shell's PATH
+ * (via resolveShellPath) so that nvm/fnm/volta paths are picked up while
+ * preserving any directories the agent already had (e.g. ~/.local/share/nvm/…).
+ */
+export declare let spawnEnv: NodeJS.ProcessEnv;
+export declare function updateSpawnEnv(env: NodeJS.ProcessEnv): void;
+/**
+ * Resolved command prefix for invoking gitnexus.
+ * Defaults to ['gitnexus']; session_start may override it from the flag or saved config.
+ */
+export declare let gitnexusCmd: string[];
+export declare function setGitnexusCmd(cmd: string[]): void;
+/** Supported MCP transport modes. */
+export type McpMode = 'auto' | 'local' | 'remote';
+/** Persisted configuration for pi-gitnexus. Loaded from ~/.pi/pi-gitnexus.json. */
+export interface GitNexusConfig {
+    /** Transport mode: 'auto' probes local binary first, 'local' forces stdio, 'remote' forces HTTP. */
+    mode?: McpMode;
+    /** Remote MCP server URL (StreamableHTTP). Only used when mode is 'remote' or 'auto' fallback. */
+    serverUrl?: string;
+    /** Local gitnexus command override, e.g. 'npx gitnexus@latest'. */
+    cmd?: string;
+    /** Whether the tool_result hook auto-appends graph context. Default: true. */
+    autoAugment?: boolean;
+    /** Augment subprocess timeout in seconds. Default: 8. */
+    augmentTimeout?: number;
+    /** Maximum number of augment calls per tool_result event. Default: 3. */
+    maxAugmentsPerResult?: number;
+    /** Maximum secondary file patterns extracted from grep output. Default: 2. */
+    maxSecondaryPatterns?: number;
+}
+/** Validate and normalize a McpMode value. Returns 'auto' for invalid values. */
+export declare function validateMcpMode(mode: unknown): McpMode;
+/** Default remote MCP server URL. */
+export declare const DEFAULT_SERVER_URL = "http://100.114.135.99:4747/api/mcp";
+export declare function loadSavedConfig(): GitNexusConfig;
+export declare function saveConfig(config: GitNexusConfig): void;
+export declare function resolveGitNexusCmd(flag: string | undefined, saved: string | undefined): string[];
+export declare function normalizePathArg(path: string): string;
+export declare function expandUserPath(path: string): string;
+export declare function setAugmentTimeout(seconds: number): void;
+/** Walk up ancestors looking for a .gitnexus/ directory. Result is cached per cwd. */
+export declare function findGitNexusRoot(cwd: string): string | null;
+export declare function findGitNexusIndex(cwd: string): boolean;
+/** Clear the index cache. Call on session_start when cwd may have changed. */
+export declare function clearIndexCache(): void;
+/**
+ * Extract the longest identifier-like literal from a regex pattern.
+ * Splits on metacharacters, returns the longest segment that looks like
+ * a code identifier (>= 3 chars, starts with letter/underscore).
+ */
+export declare function extractLiteralFromRegex(raw: string): string | null;
+/**
+ * Extract the primary search pattern from a tool's input object.
+ *
+ * grep  → input.pattern
+ * find  → basename of the glob pattern (e.g. "**\/foo.ts" → "foo")
+ * bash  → grep/rg pattern, find -name value, or cat/head/tail filename
+ * read  → basename of the file path (code files only)
+ *
+ * Returns null if pattern is missing or shorter than 3 chars.
+ */
+export declare function extractPattern(toolName: string, input: Record<string, unknown>): string | null;
+/**
+ * Extract { path, pattern } pairs from a read_many tool input.
+ * read_many input is { files: Array<{ path: string, ... }> }.
+ * Falls back to scanning content for @path lines if input lacks a files array.
+ * Returns code files only, deduplicated by basename pattern.
+ */
+export declare function extractFilesFromReadMany(input: Record<string, unknown>, content: {
+    type: string;
+    text?: string;
+}[]): Array<{
+    path: string;
+    pattern: string;
+}>;
+/**
+ * Extract up to `limit` unique file basenames (without extension) from
+ * grep-style output lines of the form "path/to/file.ext:lineno:content".
+ * Used to augment secondary context from search results.
+ */
+export declare function extractFilePatternsFromContent(content: {
+    type: string;
+    text?: string;
+}[], limit?: number): string[];
+/**
+ * Validate that a file path stays within cwd (path traversal guard).
+ * Returns the resolved absolute path, or null if it escapes cwd.
+ */
+export declare function safeResolvePath(file: string, cwd: string): string | null;
+export declare function toRepoRelativePath(file: string, repoRoot: string): string | null;
+export declare function validateRepoRelativePath(file: string): string | null;
+/**
+ * Spawn `gitnexus augment <pattern>` and return its output.
+ * gitnexus augment writes results to stderr (not stdout).
+ * Used by the tool_result hook — not by registered tools (those use mcp-client).
+ * Returns output trimmed and truncated to MAX_OUTPUT_CHARS, or "" on any error.
+ */
+export declare function runAugment(pattern: string, cwd: string): Promise<string>;