@hypercarrier/rarebit 0.1.0-alpha.6 → 0.2.1

package/src/extension.mjs

@@ -13,6 +13,7 @@ import {
 } from "./rarebit-service.mjs";
 import {
   DEFAULT_RAREBIT_SUMMARY_POLICY,
+  normalizeRarebitSummaryPrompt,
   selectRarebits,
   sha256,
 } from "./rarebit-core.mjs";
@@ -23,6 +24,7 @@ import {
   getRarebitArgumentCompletions,
   parseRarebitCommand,
   rarebitCommandDescription,
+  rarebitCommandUsage,
 } from "./rarebit-command.mjs";
 import {
   buildRarebitForkPlan,
@@ -39,6 +41,13 @@ import {
   createDetachedMaterializer,
   registerRarebitLifecycle,
 } from "./lifecycle.mjs";
+import { createRarebitRecapController } from "./rarebit-recap.mjs";
+import { readRarebitCurrent } from "./rarebit-store.mjs";
+import {
+  openRarebitPalette,
+  openRarebitSettings,
+  rarebitPaletteCommand,
+} from "./rarebit-settings-ui.mjs";
 import {
   automaticSummaryInhibitionIdentity,
   queryAutomaticSummaryPolicy,
@@ -104,6 +113,10 @@ export async function readConfiguredRarebitSettings({
     },
     summaryPolicy: resolved.summaryPolicy,
     autoTitle: resolved.autoTitle,
+    maxInputTokens: resolved.maxInputTokens,
+    summaryPrompt: resolved.summaryPrompt,
+    diagnostics: resolved.diagnostics,
+    recap: resolved.recap,
     reserveTokens: resolveReserveTokens(global.value, project.value, model),
   };
 }
@@ -121,6 +134,23 @@ export default function registerPiRarebit(pi, config = {}) {
     });
   const activityReporter =
     explicit.activityReporter ?? createHerdrActivityReporter();
+  const recapController = createRarebitRecapController({
+    appendEntry: typeof pi.registerEntryRenderer === "function" && typeof pi.appendEntry === "function"
+      ? (type, data) => pi.appendEntry(type, data) : undefined,
+    delayMs: explicit.recap?.delayMs,
+    timezone: explicit.recap?.timezone,
+  });
+  pi.registerEntryRenderer?.("rarebit-recap", recapController.renderEntry);
+  const acknowledgeRecap = (ctx) => {
+    const result = recapController.acknowledge(ctx);
+    notify(ctx, result.acknowledged ? "Recap marked as read" :
+      result.reason === "already_read" ? "Recap already marked as read" : "No Recap to mark as read in this branch", "info");
+  };
+  if (typeof pi.registerEntryRenderer === "function")
+    pi.registerShortcut?.("ctrl+alt+g", {
+      description: "Mark the latest Recap as read",
+      handler: async (ctx) => acknowledgeRecap(ctx),
+    });
   const projectActivity = (ctx) => {
     const entries = ctx?.sessionManager?.getBranch?.() ?? [];
     return projectRarebitSessionActivity({
@@ -155,10 +185,11 @@ export default function registerPiRarebit(pi, config = {}) {
       ? `${name} tokens: ${value}`
       : `${name} tokens: unavailable`;
 
-  const notifyOutcome = (ctx, result, triggered) => {
-    if (!triggered || result?.duplicate || result?.inFlight) return;
+  const notifyOutcome = (ctx, result, triggered, diagnostics = {}) => {
+    if (result?.duplicate || result?.inFlight) return;
     switch (result?.record?.status) {
       case "ok":
+        if (!triggered || diagnostics.summaryUpdated !== true) return;
         notify(
           ctx,
           `Rarebit Summary updated (${tokenLabel("input", result.record.synthesis?.usage?.inputTokens)} · ${tokenLabel("output", result.record.synthesis?.usage?.outputTokens)} · model ${resultModelLabel(result)})`,
@@ -221,6 +252,16 @@ export default function registerPiRarebit(pi, config = {}) {
       ...injected,
       ...explicit,
       summaryPolicy,
+      maxInputTokens: explicit.maxInputTokens ?? injected.maxInputTokens,
+      summaryPrompt: explicit.summaryPrompt ?? injected.summaryPrompt,
+      diagnostics: {
+        ...(injected.diagnostics ?? {}),
+        ...(explicit.diagnostics ?? {}),
+      },
+      recap: {
+        ...(injected.recap ?? {}),
+        ...(explicit.recap ?? {}),
+      },
       piAi: explicit.piAi ?? {
         complete: async (...args) => (await import("@earendil-works/pi-ai/compat")).complete(...args),
       },
@@ -228,10 +269,23 @@ export default function registerPiRarebit(pi, config = {}) {
   };
 
   const materialize = async (ctx, { force = false } = {}) => {
+    const recapToken = recapController.captureMaterialization(ctx);
     let synthesisTriggered = false;
     const effective = await loadEffective(ctx);
+    let summaryPrompt;
+    try {
+      summaryPrompt = normalizeRarebitSummaryPrompt(effective.summaryPrompt).guidance;
+    } catch (error) {
+      notify(
+        ctx,
+        `Invalid rarebit.summary_prompt: ${error?.message ?? error}`,
+        "error",
+      );
+      return { record: { status: "invalid_configuration" } };
+    }
     const result = await processRarebitSummary(ctx, {
       ...effective,
+      summaryPrompt,
       forceSynthesis: force,
       lifecycleBoundary: force ? "manual" : ctx?.lifecycleBoundary,
       queryAutomaticSummaryPolicy:
@@ -239,15 +293,27 @@ export default function registerPiRarebit(pi, config = {}) {
       onSynthesisTriggered: (detail) => {
         synthesisTriggered = true;
         const count = detail.rarebitCount ?? detail.rarebitCount;
-        notify(
-          ctx,
-          `Rarebit Summary triggered (${count} Rarebits · input tokens: ~${detail.estimatedInputTokens} estimated (chars/4) · model ${modelLabel(detail.model)})`,
-          "info",
-        );
+        if (effective.diagnostics?.summaryTriggered === true)
+          notify(
+            ctx,
+            `Rarebit Summary triggered (${count} Rarebits · input tokens: ~${detail.estimatedInputTokens} estimated (chars/4) · model ${modelLabel(detail.model)})`,
+            "info",
+          );
       },
     });
-    notifyOutcome(ctx, result, synthesisTriggered);
-    return result;
+    if (!force) notifyOutcome(ctx, result, synthesisTriggered, effective.diagnostics);
+    recapController.offer({
+      ctx,
+      result,
+      token: recapToken,
+      recapEnabled: effective.recap?.enabled !== false,
+      recapDelayMs: effective.recap?.delayMs,
+      recapTimezone: effective.recap?.timezone,
+      sessionRoot: effective.sessionRoot,
+      rarebitRoot: effective.rarebitRoot,
+      allowExternalSession: effective.allowExternalSession === true,
+    });
+    return { ...result, rarebitEffective: effective };
   };
   const schedule = createDetachedMaterializer(materialize, (_error, ctx) => {
     notify(
@@ -256,15 +322,49 @@ export default function registerPiRarebit(pi, config = {}) {
       "error",
     );
   });
-  const scheduleManualSummary = createDetachedMaterializer(
-    (ctx) => materialize(ctx, { force: true }),
-    (_error, ctx) =>
-      notify(
-        ctx,
-        "Rarebit Summary failed; inspect its private materialization",
-        "error",
-      ),
-  );
+  const manualAssessmentIsCurrent = async (result, ctx) => {
+    const session = identityFrom(ctx);
+    const generation = activeSession?.generation;
+    const selectionHash = selectRarebits(ctx?.sessionManager?.getBranch?.() ?? []).manifestHash;
+    if (!sameActiveSession(session)) return false;
+    const current = await readRarebitCurrent({
+      sessionFile: session.sessionFile,
+      sessionRoot: result.rarebitEffective?.sessionRoot,
+      rarebitRoot: result.rarebitEffective?.rarebitRoot,
+      allowExternalSession: result.rarebitEffective?.allowExternalSession === true,
+    }).catch(() => null);
+    if (!sameActiveSession(session) || activeSession?.generation !== generation ||
+        !sameActiveSession(identityFrom(ctx)) ||
+        selectRarebits(ctx?.sessionManager?.getBranch?.() ?? []).manifestHash !== selectionHash)
+      return false;
+    return current?.artifactState?.receiptRef?.jobId === result.record?.jobId &&
+      current?.artifactState?.nativeRef?.sessionId === session.sessionId &&
+      current?.artifactState?.nativeRef?.selectionManifestHash === selectionHash &&
+      current?.artifactState?.syncState === "assessment_current";
+  };
+  const scheduleManualSummary = (ctx) => {
+    void materialize(ctx, { force: true }).then(async (result) => {
+      if (result?.inFlight) {
+        notify(ctx, "Rarebit Summary is already in flight", "info");
+        return;
+      }
+      if (result?.record?.status === "ok") {
+        const isCurrent = await manualAssessmentIsCurrent(result, ctx);
+        const duplicate = result?.duplicate === true;
+        notify(ctx,
+          duplicate
+            ? isCurrent ? "Rarebit Summary is already current" : "Rarebit Summary already exists but is not current"
+            : isCurrent ? "Rarebit Summary updated and current" : "Rarebit Summary generated but is not current",
+          isCurrent ? "info" : "warning",
+        );
+        return;
+      }
+      if (result?.record?.status === "skipped_ephemeral_session")
+        notify(ctx, "Rarebit Summary unavailable: Session is not persisted", "warning");
+      else
+        notifyOutcome(ctx, { record: result?.record }, false, result?.rarebitEffective?.diagnostics ?? {});
+    }).catch(() => notify(ctx, "Rarebit Summary failed; inspect its private materialization", "error"));
+  };
 
   const identityFrom = (ctx) => ({
     sessionId: String(
@@ -354,20 +454,33 @@ export default function registerPiRarebit(pi, config = {}) {
   );
 
   registerRarebitLifecycle(pi, schedule, {
-    onSessionStart: (ctx) => {
-      activeSession = identityFrom(ctx);
+    onSessionStart: (ctx, generation) => {
+      recapController.invalidate(ctx, generation);
+      activeSession = { ...identityFrom(ctx), generation };
       activityReporter.start(projectActivity(ctx));
     },
-    onSessionTree: (ctx) => {
+    onAgentStart: (ctx, generation) => {
+      recapController.invalidate(ctx, generation);
+    },
+    onTurnStart: (ctx, generation) => {
+      recapController.invalidate(ctx, generation);
+    },
+    onInputSent: (ctx, generation) => {
+      recapController.invalidate(ctx, generation);
+    },
+    onSessionTree: (ctx, _event, generation) => {
+      recapController.invalidate(ctx, generation);
       activityReporter.update(projectActivity(ctx));
     },
     onSelectedUserPersisted: (ctx) => {
       activityReporter.update(projectActivity(ctx));
     },
     onAgentSettled: (ctx) => {
+      recapController.updateContext(ctx);
       activityReporter.update(projectActivity(ctx));
     },
-    onSessionShutdown: () => {
+    onSessionShutdown: (ctx, generation) => {
+      recapController.invalidate(ctx, generation);
       activeSession = undefined;
       activityReporter.stop();
     },
@@ -445,7 +558,35 @@ ${fence(requestText)}`;
     description: rarebitCommandDescription(),
     getArgumentCompletions: getRarebitArgumentCompletions,
     handler: async (args, ctx) => {
-      const command = parseRarebitCommand(args);
+      let commandInput = String(args ?? "");
+      const trimmedCommandInput = commandInput.trim();
+      if (!trimmedCommandInput || trimmedCommandInput === "menu") {
+        const currentUiState = () => ({
+          ...identityFrom(ctx),
+          branchLeafId: ctx?.sessionManager?.getBranch?.()?.at(-1)?.id ?? null,
+          cwd: ctx?.cwd ?? process.cwd(),
+          projectTrusted: ctx?.isProjectTrusted?.() === true,
+        });
+        const initial = currentUiState();
+        const selection = await openRarebitPalette(ctx, {
+          isCurrent: () => {
+            const current = currentUiState();
+            return current.sessionId === initial.sessionId &&
+              current.sessionFile === initial.sessionFile &&
+              current.branchLeafId === initial.branchLeafId &&
+              current.cwd === initial.cwd &&
+              current.projectTrusted === initial.projectTrusted;
+          },
+        });
+        commandInput = rarebitPaletteCommand(selection) ?? "";
+        if (!commandInput) return;
+        if (selection?.id === "recall") {
+          const prompt = await ctx.ui.input?.("Rarebit recall prompt", "");
+          if (prompt === undefined || !String(prompt).trim()) return;
+          commandInput = `recall ${prompt}`;
+        }
+      }
+      const command = parseRarebitCommand(commandInput);
       if (!command.ok) {
         notify(
           ctx,
@@ -457,6 +598,61 @@ ${fence(requestText)}`;
         return;
       }
       const { subcommand, arguments: rest } = command;
+      if (subcommand === "help") {
+        notify(
+          ctx,
+          [
+            rarebitCommandUsage(),
+            ...(commandInput.trim().split(/\s+/).length === 1
+              ? ["Use /rarebit to open the interactive command palette."]
+              : []),
+          ].join("\n"),
+          "info",
+        );
+        return;
+      }
+      if (subcommand === "settings") {
+        const currentUiState = () => ({
+          ...identityFrom(ctx),
+          branchLeafId: ctx?.sessionManager?.getBranch?.()?.at(-1)?.id ?? null,
+          cwd: ctx?.cwd ?? process.cwd(),
+          projectTrusted: ctx?.isProjectTrusted?.() === true,
+        });
+        const initial = currentUiState();
+        await openRarebitSettings(ctx, {
+          initialScope: rest[0] === "project" ? "project" : "global",
+          projectTrusted: initial.projectTrusted,
+          isCurrent: () => {
+            const current = currentUiState();
+            return current.sessionId === initial.sessionId &&
+              current.sessionFile === initial.sessionFile &&
+              current.branchLeafId === initial.branchLeafId &&
+              current.cwd === initial.cwd &&
+              current.projectTrusted === initial.projectTrusted;
+          },
+          onSaved: async ({ namespace, document }) => {
+            const previous = document?.namespace ?? {};
+            const changed = (path) => {
+              const read = (value) => path.reduce((current, key) => current?.[key], value);
+              return JSON.stringify(read(previous)) !== JSON.stringify(read(namespace));
+            };
+            if (changed(["max_rarebit_ratio"])) {
+              const next = { ...policyOverrides };
+              delete next.maxRarebitRatio;
+              policyOverrides = next;
+            }
+            if (changed(["min_total_length"])) {
+              const next = { ...policyOverrides };
+              delete next.minTotalLength;
+              policyOverrides = next;
+            }
+            if (changed(["auto_title"])) autoTitleOverride = undefined;
+            const effective = await loadEffective(ctx);
+            if (effective.recap?.enabled === false) recapController.invalidate(ctx);
+          },
+        });
+        return;
+      }
       if (subcommand === "fork") {
         if (typeof ctx?.switchSession !== "function") {
           notify(ctx, "Rarebit fork is unavailable in this Pi runtime", "error");
@@ -580,7 +776,7 @@ ${fence(requestText)}`;
           : "settings_or_default";
         notify(
           ctx,
-          `Rarebit ${subcommand}: auto-title=${autoTitleOverride ?? effective.autoTitle ?? true}; max_rarebit_ratio=${policy.maxRarebitRatio} (${ratioSource}); min_total_length=${policy.minTotalLength} estimated tokens via ceil(chars/4) (${lengthSource}); measurement=${policy.measurementVersion}; model=${modelLabel(effective.model)} from ${effective.modelProvenance?.settingsKey ?? "explicit config"}${policyStatus}`,
+          `Rarebit ${subcommand}: auto-title=${autoTitleOverride ?? effective.autoTitle ?? true}; recap=${effective.recap?.enabled !== false ? "on" : "off"} after ${effective.recap?.delayMs ?? 60000}ms (${effective.recap?.timezone ?? "host"}); diagnostics=triggered:${effective.diagnostics?.summaryTriggered === true ? "on" : "off"},updated:${effective.diagnostics?.summaryUpdated === true ? "on" : "off"}; max_input_tokens=${effective.maxInputTokens ?? 64000}; max_rarebit_ratio=${policy.maxRarebitRatio} (${ratioSource}); min_total_length=${policy.minTotalLength} estimated tokens via ceil(chars/4) (${lengthSource}); measurement=${policy.measurementVersion}; model=${modelLabel(effective.model)} from ${effective.modelProvenance?.settingsKey ?? "explicit config"}${policyStatus}`,
           "info",
         );
         return;
@@ -610,6 +806,32 @@ ${fence(requestText)}`;
         );
         return;
       }
+      if (subcommand === "got-it") {
+        acknowledgeRecap(ctx);
+        return;
+      }
+      if (subcommand === "recap") {
+        if (effective.recap?.enabled === false) {
+          recapController.invalidate(ctx);
+          notify(ctx, "Rarebit Recap is disabled in settings", "info");
+          return;
+        }
+        const recap = await recapController.showExisting(ctx, {
+          sessionRoot: effective.sessionRoot,
+          rarebitRoot: effective.rarebitRoot,
+          recapTimezone: effective.recap?.timezone,
+          allowExternalSession: effective.allowExternalSession === true,
+        });
+        if (!recap.shown)
+          notify(
+            ctx,
+            recap.reason === "no_current_summary"
+              ? "Rarebit has no current Summary for this Session branch"
+              : "Rarebit Recap is unavailable in this UI",
+            "warning",
+          );
+        return;
+      }
       if (subcommand === "title") {
         void generateTitle(ctx, { manual: true }).catch(() =>
           notify(ctx, "Rarebit title generation failed", "error"),

package/src/lifecycle.mjs

@@ -16,7 +16,12 @@ function messageText(event) {
     .join("\n");
 }
 
-function snapshotMaterializationContext(ctx, mayNotify, lifecycleBoundary) {
+function snapshotMaterializationContext(
+  ctx,
+  mayNotify,
+  lifecycleBoundary,
+  rarebitLifecycleGeneration,
+) {
   const sessionManager = ctx?.sessionManager;
   const header = sessionManager?.getHeader?.();
   const branch = sessionManager?.getBranch?.();
@@ -39,6 +44,7 @@ function snapshotMaterializationContext(ctx, mayNotify, lifecycleBoundary) {
     modelRegistry: ctx?.modelRegistry,
     sessionId: ctx?.sessionId,
     lifecycleBoundary,
+    rarebitLifecycleGeneration,
     isProjectTrusted: () => projectTrusted,
     sessionManager: {
       getHeader: () => header,
@@ -126,6 +132,7 @@ export function registerRarebitLifecycle(pi, schedule, options = {}) {
   let ownerMessageSeen = false;
   let sessionGeneration = 0;
   let sessionLive = false;
+  let rarebitLifecycleGeneration = 0;
   const MAX_PENDING_INPUT_ORIGINS = 256;
 
   const clearInputOrigins = () => {
@@ -169,7 +176,8 @@ export function registerRarebitLifecycle(pi, schedule, options = {}) {
   };
 
   pi.on("session_start", (_event, ctx) => {
-    options.onSessionStart?.(ctx);
+    rarebitLifecycleGeneration += 1;
+    options.onSessionStart?.(ctx, rarebitLifecycleGeneration);
     clearInputOrigins();
     persistedUserInputAwaitingProvider = false;
     selectedUserMessageAwaitingProvider = false;
@@ -185,13 +193,26 @@ export function registerRarebitLifecycle(pi, schedule, options = {}) {
     // the selected Session evidence.
   });
 
-  pi.on("agent_start", () => {
+  pi.on("agent_start", (_event, ctx) => {
+    rarebitLifecycleGeneration += 1;
+    options.onAgentStart?.(ctx, rarebitLifecycleGeneration);
     // A retry, compaction pass, or queued continuation starts a new agent run;
     // an earlier stop is not the fully settled branch.
     normalStopAwaitingSettlement = false;
   });
 
-  pi.on("input", (event) => {
+  pi.on("turn_start", (_event, ctx) => {
+    rarebitLifecycleGeneration += 1;
+    options.onTurnStart?.(ctx, rarebitLifecycleGeneration);
+  });
+
+  pi.on("input", (event, ctx) => {
+    rarebitLifecycleGeneration += 1;
+    try {
+      options.onInputSent?.(ctx, rarebitLifecycleGeneration);
+    } catch {
+      // Human-facing cancellation is optional and must not alter input delivery.
+    }
     const bucket =
       event?.streamingBehavior === "steer"
         ? "steer"
@@ -235,8 +256,9 @@ export function registerRarebitLifecycle(pi, schedule, options = {}) {
   });
 
   pi.on("session_tree", (event, ctx) => {
+    rarebitLifecycleGeneration += 1;
     try {
-      options.onSessionTree?.(ctx, event);
+      options.onSessionTree?.(ctx, event, rarebitLifecycleGeneration);
     } catch {
       // Tree recency is an optional projection, not materialization truth.
     }
@@ -261,6 +283,7 @@ export function registerRarebitLifecycle(pi, schedule, options = {}) {
       ctx,
       () => sessionLive && sessionGeneration === generation,
       pendingLifecycleBoundary,
+      rarebitLifecycleGeneration,
     );
     pendingLifecycleBoundary = "owner_request";
     schedule(snapshot);
@@ -306,17 +329,19 @@ export function registerRarebitLifecycle(pi, schedule, options = {}) {
         ctx,
         () => sessionLive && sessionGeneration === generation,
         "agent_settled",
+        rarebitLifecycleGeneration,
       ),
     );
   });
 
-  pi.on("session_shutdown", () => {
+  pi.on("session_shutdown", (_event, ctx) => {
+    rarebitLifecycleGeneration += 1;
     clearInputOrigins();
     persistedUserInputAwaitingProvider = false;
     selectedUserMessageAwaitingProvider = false;
     firstOwnerInputAwaitingProvider = undefined;
     normalStopAwaitingSettlement = false;
     sessionLive = false;
-    options.onSessionShutdown?.();
+    options.onSessionShutdown?.(ctx, rarebitLifecycleGeneration);
   });
 }

package/src/rarebit-artifact-state.mjs

@@ -383,6 +383,7 @@ export function validateRarebitArtifactReceipt(record) {
       "hc-rarebit-summary-v4",
       "hc-rarebit-summary-v5",
       "hc-rarebit-summary-v6",
+      "hc-rarebit-summary-v7",
     ].includes(
       record.implementationVersion,
     ) ||
@@ -407,7 +408,7 @@ export function validateRarebitArtifactReceipt(record) {
   if (
     (hasInputCoverage && !validInputCoverage(record.inputCoverage)) ||
     (record.status === "ok" &&
-      ["hc-rarebit-summary-v5", "hc-rarebit-summary-v6"].includes(
+      ["hc-rarebit-summary-v5", "hc-rarebit-summary-v6", "hc-rarebit-summary-v7"].includes(
         record.implementationVersion,
       ) &&
       !hasInputCoverage)
@@ -776,16 +777,7 @@ export function projectRarebitArtifactState({
   const settled = newest(
     exact.filter(({ record }) => record.lifecycleBoundary === "agent_settled"),
   );
-  if (settled && (!activeRequest || newerThan(settled, activeRequest)))
-    return result({
-      syncState: "assessment_current",
-      projection: projection(settled.record),
-      applicability: "exact_selection",
-      nativeRef: nativeReference(native),
-      receiptRef: ref(settled.record),
-      retry: null,
-    });
-  if (activeRequest) {
+  if (activeRequest && !(settled && newerThan(settled, activeRequest))) {
     const cutLength = activeRequest.record.selection.occurrenceCount;
     const settlementPending = native.selection.occurrences
       .slice(cutLength)
@@ -805,7 +797,11 @@ export function projectRarebitArtifactState({
     });
   }
   const assessment = newest(
-    exact.filter(({ record }) => record.lifecycleBoundary !== "owner_request"),
+    exact.filter(({ record }) =>
+      record.lifecycleBoundary === "agent_settled" ||
+      record.lifecycleBoundary === "manual" ||
+      record.lifecycleBoundary === "session_start",
+    ),
   );
   if (assessment)
     return result({

package/src/rarebit-cli.mjs

@@ -205,6 +205,7 @@ export async function readRarebitCliSettings({
       rawRefs: [globalPath, projectPath],
     },
     summaryPolicy: resolved.summaryPolicy,
+    summaryPrompt: resolved.summaryPrompt,
     autoTitle: resolved.autoTitle,
   };
 }
@@ -351,6 +352,7 @@ export async function runRarebitCli(options, dependencies = {}) {
         model: runtime.model,
         modelProvenance: runtime.modelProvenance,
         summaryPolicy: runtime.summaryPolicy,
+        summaryPrompt: runtime.summaryPrompt,
         forceSynthesis: options.force === true,
         allowExternalSession: true,
         rarebitRoot: dependencies.rarebitRoot,

package/src/rarebit-command.mjs

@@ -17,8 +17,23 @@ const rest = (usage) => ({
 
 export const RAREBIT_COMMAND_GRAMMAR = Object.freeze({
   name: "rarebit",
-  defaultSubcommand: "status",
+  defaultSubcommand: "menu",
   subcommands: Object.freeze([
+    {
+      name: "menu",
+      description: "Open the interactive Rarebit command palette",
+      forms: [[]],
+    },
+    {
+      name: "settings",
+      description: "Open interactive Rarebit settings",
+      forms: [[], [literal("global", "Edit global Pi settings")], [literal("project", "Edit trusted project settings")]],
+    },
+    {
+      name: "help",
+      description: "Show Rarebit command help",
+      forms: [[]],
+    },
     {
       name: "status",
       description: "Show effective Rarebit configuration",
@@ -73,6 +88,16 @@ export const RAREBIT_COMMAND_GRAMMAR = Object.freeze({
       usageNote: "use Pi's native /name for a literal title",
       forms: [[]],
     },
+    {
+      name: "recap",
+      description: "Show the current Recap in the TUI",
+      forms: [[]],
+    },
+    {
+      name: "got-it",
+      description: "Mark the latest displayed Recap as read",
+      forms: [[]],
+    },
     {
       name: "summarize",
       description: "Force a Rarebit Summary materialization",