pi-graphnav 0.2.2 → 0.3.0

package/README.md

@@ -83,6 +83,7 @@ pi install npm:pi-graphnav
 | `/codegraph` or `/codegraph status` | project, index state, mode, blocked/nudged counts |
 | `/codegraph [on\|off]` | switch it all (remembered across sessions) |
 | `/codegraph mode <mode>` | symbol searches: `enforce` (default), `nudge` or `off` |
+| `/codegraph statusline <when>` | status line: `always` (default), `problems` or `never`; CodeGraph keeps working |
 | `/codegraph sync` | sync the index with changed files |
 | `/codegraph reindex` | rebuild the index from scratch |
 | `/codegraph init` | create the index (for a directory that is not a git repo) |
@@ -92,7 +93,7 @@ Settings live in `<pi agent dir>/codegraph.json` (`PI_CODING_AGENT_DIR`, else `~
 | Key | Default | |
 |---|---|---|
 | `enabled` | `true` | master switch |
-| `showStatus` | `true` | status line entry |
+| `showStatus` | `"always"` | status line entry: `"always"`, `"problems"` (only while indexing, or when the index is missing, failing or unavailable) or `"never"`; `true`/`false` still work |
 | `mode` | `"enforce"` | `enforce`, `nudge` or `off` |
 | `autoInit` | `true` | init a git repo that has no index |
 | `autoSync` | `true` | sync or rebuild a stale index at session start |

package/extensions/command/parse.ts

@@ -1,17 +1,18 @@
 /** `/codegraph ...`: parsing and argument completion. Pure: the handler in graphnav.ts acts on the result. */
-import { MODES, type Mode } from "../core/config.ts";
+import { MODES, type Mode, STATUS_SHOWS, type StatusShow } from "../core/config.ts";
 
 export type Command =
 	| { kind: "status" }
 	| { kind: "on" }
 	| { kind: "off" }
 	| { kind: "mode"; mode: Mode }
+	| { kind: "statusline"; show: StatusShow }
 	| { kind: "sync" }
 	| { kind: "reindex" }
 	| { kind: "init" }
 	| { kind: "invalid"; message: string };
 
-export const USAGE = "Usage: /codegraph [status] · on · off · mode <enforce|nudge|off> · sync · reindex · init";
+export const USAGE = "Usage: /codegraph [status] · on · off · mode <enforce|nudge|off> · statusline <always|problems|never> · sync · reindex · init";
 
 export function parseCommand(args: string | undefined): Command {
 	const [cmd, ...rest] = (args ?? "").trim().split(/\s+/).filter(Boolean);
@@ -31,6 +32,12 @@ export function parseCommand(args: string | undefined): Command {
 				? { kind: "mode", mode: m as Mode }
 				: { kind: "invalid", message: "Usage: /codegraph mode <enforce|nudge|off>" };
 		}
+		case "statusline": {
+			const v = rest[0]?.toLowerCase();
+			return STATUS_SHOWS.includes(v as StatusShow) && rest.length === 1
+				? { kind: "statusline", show: v as StatusShow }
+				: { kind: "invalid", message: "Usage: /codegraph statusline <always|problems|never>" };
+		}
 		case "sync":
 			return { kind: "sync" };
 		case "reindex":
@@ -55,6 +62,7 @@ const TOP_LEVEL: CompletionItem[] = [
 	{ value: "on", label: "on", description: "Turn CodeGraph-first on" },
 	{ value: "off", label: "off", description: "Turn CodeGraph-first off" },
 	{ value: "mode ", label: "mode", description: "Symbol searches: enforce, nudge or off" },
+	{ value: "statusline ", label: "statusline", description: "Status line: always, only problems, or never" },
 	{ value: "sync", label: "sync", description: "Sync the index with changed files" },
 	{ value: "reindex", label: "reindex", description: "Rebuild the index from scratch" },
 	{ value: "init", label: "init", description: "Create the index for this project" },
@@ -66,10 +74,16 @@ const MODE_ITEMS: CompletionItem[] = [
 	{ value: "mode off", label: "off", description: "Leave text searches alone" },
 ];
 
+const STATUSLINE_ITEMS: CompletionItem[] = [
+	{ value: "statusline always", label: "always", description: "Always show the CodeGraph status" },
+	{ value: "statusline problems", label: "problems", description: "Only while indexing, or when the index is missing, failing or unavailable" },
+	{ value: "statusline never", label: "never", description: "Never show it (CodeGraph keeps working)" },
+];
+
 /** `prefix` is the whole argument text typed so far (pi replaces it with `value`). */
 export function completions(prefix: string): CompletionItem[] | null {
 	const text = (prefix ?? "").toLowerCase().replace(/^\s+/, "");
-	const pool = text.startsWith("mode ") ? MODE_ITEMS : TOP_LEVEL;
+	const pool = text.startsWith("mode ") ? MODE_ITEMS : text.startsWith("statusline ") ? STATUSLINE_ITEMS : TOP_LEVEL;
 	const out = pool.filter((i) => i.value.startsWith(text));
 	return out.length > 0 ? out : null;
 }

package/extensions/core/config.ts

@@ -11,11 +11,22 @@ import { join } from "node:path";
 export type Mode = "enforce" | "nudge" | "off";
 export const MODES: readonly Mode[] = ["enforce", "nudge", "off"];
 
+/** Status line: always, only when something needs attention (indexing, missing, error, unavailable), or never. */
+export type StatusShow = "always" | "problems" | "never";
+export const STATUS_SHOWS: readonly StatusShow[] = ["always", "problems", "never"];
+
+/** `showStatus` from a config file: one of STATUS_SHOWS, or the 0.2 booleans (true = always, false = never). */
+export function parseStatusShow(v: unknown): StatusShow | undefined {
+	if (v === true) return "always";
+	if (v === false) return "never";
+	return STATUS_SHOWS.includes(v as StatusShow) ? (v as StatusShow) : undefined;
+}
+
 export interface Config {
 	/** Master switch: when false the extension adds no guidance, gates nothing and indexes nothing. */
 	enabled: boolean;
-	/** Show the status line entry. */
-	showStatus: boolean;
+	/** When to show the status line entry. */
+	showStatus: StatusShow;
 	/** Symbol searches with rg/grep: block once (`enforce`), only add a hint (`nudge`) or leave alone (`off`). */
 	mode: Mode;
 	/** Create the index (`codegraph init`) for a git repo that has none. */
@@ -32,7 +43,7 @@ export interface Config {
 
 export const DEFAULT_CONFIG: Config = {
 	enabled: true,
-	showStatus: true,
+	showStatus: "always",
 	mode: "enforce",
 	autoInit: true,
 	autoSync: true,
@@ -49,7 +60,7 @@ export function sanitizeConfig(raw: unknown): Config {
 	const d = DEFAULT_CONFIG;
 	return {
 		enabled: typeof r.enabled === "boolean" ? r.enabled : d.enabled,
-		showStatus: typeof r.showStatus === "boolean" ? r.showStatus : d.showStatus,
+		showStatus: parseStatusShow(r.showStatus) ?? d.showStatus,
 		mode: MODES.includes(r.mode as Mode) ? (r.mode as Mode) : d.mode,
 		autoInit: typeof r.autoInit === "boolean" ? r.autoInit : d.autoInit,
 		autoSync: typeof r.autoSync === "boolean" ? r.autoSync : d.autoSync,

package/extensions/graphnav.ts

@@ -14,7 +14,7 @@ import { homedir } from "node:os";
 import { resolve } from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { completions, parseCommand } from "./command/parse.ts";
-import { type Config, DEFAULT_CONFIG, type ProjectOverrides, readConfig, readProjectConfig, saveConfig } from "./core/config.ts";
+import { type Config, DEFAULT_CONFIG, type ProjectOverrides, readConfig, readProjectConfig, saveConfig, type StatusShow } from "./core/config.ts";
 import {
 	codemodeSearches,
 	candidateSymbols,
@@ -54,6 +54,13 @@ export interface Status {
 	error?: string;
 }
 
+/** Does the status line show for this setting? `problems`: only when the user may need to act or wait. */
+export function showsStatus(show: StatusShow, s: Status): boolean {
+	if (show === "never") return false;
+	if (show === "always") return true;
+	return !!s.unavailable || s.state === "indexing" || s.state === "missing" || s.state === "error";
+}
+
 export function statusText(s: Status): string {
 	if (!s.config.enabled) return "codegraph: off";
 	if (s.unavailable) return `codegraph: unavailable · ${s.config.mode}`;
@@ -170,7 +177,7 @@ export function createExtension(deps: Deps = {}) {
 		const guardNow = new Map<string, Guard>();
 		const unavailable = (root = project?.root) => (root ? (guardNow.get(root)?.open ?? false) : false);
 		const snapshot = (): Status => ({ config, project, state, index, error: lastError, ...counts, unavailable: unavailable(), overrides });
-		const refresh = () => ui?.setStatus("codegraph", config.enabled && config.showStatus ? statusText(snapshot()) : "");
+		const refresh = () => ui?.setStatus("codegraph", config.enabled && showsStatus(config.showStatus, snapshot()) ? statusText(snapshot()) : "");
 
 		const server = (root: string) => {
 			let s = servers.get(root);
@@ -421,6 +428,11 @@ export function createExtension(deps: Deps = {}) {
 					await persist();
 					ctx.ui.notify(`codegraph: mode ${cmd.mode}`, "info");
 					return;
+				case "statusline":
+					config.showStatus = base.showStatus = cmd.show;
+					await persist();
+					ctx.ui.notify(`codegraph: status line ${cmd.show}`, "info");
+					return;
 				case "sync":
 				case "reindex":
 				case "init": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-graphnav",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "CodeGraph-first code navigation for pi: persistent index, auto init/sync, and a gate that steers structural searches to codegraph_* tools.",
   "keywords": [
     "pi-package",