@hypercarrier/rarebit 0.1.0-alpha.6 → 0.2.0

package/src/types.d.ts

@@ -1,5 +1,47 @@
 export type RarebitModel = { provider: string; id: string };
 
+export type RarebitDiagnosticsSettings = {
+  summaryTriggered: boolean;
+  summaryUpdated: boolean;
+};
+export type RarebitRecapSettings = {
+  enabled: boolean;
+  delayMs: number;
+  timezone: string;
+};
+export type RarebitResolvedSettings = {
+  model?: RarebitModel;
+  modelConfigurationError?: string;
+  summaryPolicy: RarebitSummaryPolicy;
+  autoTitle: boolean;
+  summaryPrompt?: unknown;
+  maxInputTokens: number;
+  diagnostics: RarebitDiagnosticsSettings;
+  recap: RarebitRecapSettings;
+};
+export const DEFAULT_RAREBIT_RECAP_DELAY_MS: 60000;
+export const DEFAULT_RAREBIT_RECAP_TIMEZONE: "host";
+export const DEFAULT_RAREBIT_MAX_INPUT_TOKENS: 64000;
+export const MAX_RAREBIT_INPUT_TOKENS: number;
+export const DEFAULT_RAREBIT_DIAGNOSTICS: Readonly<RarebitDiagnosticsSettings>;
+export const RAREBIT_SUMMARY_PROMPT_IDENTITY_VERSION: "rarebit-summary-prompt-v1";
+export const MAX_RAREBIT_SUMMARY_PROMPT_CHARS: 64000;
+export const DEFAULT_RAREBIT_SUMMARY_PROMPT_GUIDANCE: string;
+export const MAX_RAREBIT_SUMMARY_CHARS: 8000;
+export function normalizeRarebitSummaryPrompt(value?: unknown): {
+  guidance: string;
+  promptIdentity: string | null;
+};
+export function mergeRarebitSettings(
+  globalSettings?: Record<string, unknown>,
+  projectSettings?: Record<string, unknown>,
+): Record<string, unknown>;
+export function normalizeRarebitRecapTimezone(value?: unknown): string;
+export function resolveRarebitSettings(
+  globalSettings?: Record<string, unknown>,
+  projectSettings?: Record<string, unknown>,
+): RarebitResolvedSettings;
+
 /** Seeded destination entries, including the generated fork notice. */
 export function getImportedRarebitEntryIds(entries: readonly unknown[]): Set<string>;
 export const RAREBIT_FORK_LINEAGE_SCHEMA_VERSION: 1;
@@ -227,14 +269,20 @@ export function composeRarebitSummaryDerivationInput(
   selection: ReturnType<typeof selectRarebits>,
   options?: {
     promptVersion?: string;
+    summaryPrompt?: unknown;
     lifecycleBoundary?: "owner_request" | "agent_settled" | "manual";
     maxPromptChars?: number;
-  },
-): { prompt: string; coverage: RarebitSummaryInputCoverage };
+  }): {
+  prompt: string;
+  promptIdentity: string | null;
+  promptVersion: string;
+  coverage: RarebitSummaryInputCoverage;
+};
 export function composeRarebitSummaryPrompt(
   selection: ReturnType<typeof selectRarebits>,
   options?: {
     promptVersion?: string;
+    summaryPrompt?: unknown;
     lifecycleBoundary?: "owner_request" | "agent_settled" | "manual";
     maxPromptChars?: number;
   },
@@ -242,7 +290,10 @@ export function composeRarebitSummaryPrompt(
 export function composeRarebitTitlePrompt(
   selection: ReturnType<typeof selectRarebits>,
 ): string;
-export function normalizeRarebitSummary(value: unknown): string;
+export function normalizeRarebitSummary(
+  value: unknown,
+  options?: { maxChars?: number },
+): string;
 export function normalizeRarebitSummarySynthesis(
   value: unknown,
   options?: { maxChars?: number },
@@ -395,11 +446,17 @@ export type RarebitNativeObservation =
 
 export const RAREBIT_SUMMARY_SCHEMA_VERSION: 4;
 export const RAREBIT_SUMMARY_IMPLEMENTATION_VERSION: "hc-rarebit-summary-v6";
+export const RAREBIT_INPUT_CHARS_PER_TOKEN: 4;
+export const DEFAULT_RAREBIT_MAX_PROMPT_CHARS: 256000;
 export function processRarebitSummary(
   ctx: unknown,
   config?: {
     model?: RarebitModel;
     summaryPolicy?: RarebitSummaryPolicy;
+    summaryPrompt?: unknown;
+    maxInputTokens?: number;
+    maxPromptChars?: number;
+    diagnostics?: RarebitDiagnosticsSettings;
     forceSynthesis?: boolean;
     // New derivation accepts only evidence-transition or explicit boundaries;
     // RarebitSummaryReceiptV4 retains session_start for historical reads.

package/test/lifecycle-contract-independent.test.mjs

@@ -532,6 +532,7 @@ test("TUI notices state input cardinality, clearly estimated trigger tokens, and
       rarebitRoot: join(root, "rarebit"),
       summaryPolicy: { minTotalLength: 0, maxRarebitRatio: 1 },
       model: { provider: "test-provider", id: "cheap-model" },
+      diagnostics: { summaryTriggered: true, summaryUpdated: true },
       modelClient: {
         complete: async () => ({
           text: JSON.stringify({
@@ -588,6 +589,7 @@ test("updated notice never substitutes the local estimate for absent provider us
       rarebitRoot: join(root, "rarebit"),
       summaryPolicy: { minTotalLength: 0, maxRarebitRatio: 1 },
       model: { provider: "requested-provider", id: "requested-model" },
+      diagnostics: { summaryTriggered: true, summaryUpdated: true },
       modelClient: {
         complete: async () => ({
           text: JSON.stringify({

package/test/package-artifact-identity.test.mjs

@@ -0,0 +1,54 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { execFileSync, spawnSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(fileURLToPath(new URL("..", import.meta.url)));
+const verifier = join(root, "scripts/verify-package.mjs");
+
+function syntheticTarball(field, value) {
+  const work = mkdtempSync(join(tmpdir(), "rarebit-artifact-test-"));
+  const packageDir = join(work, "package");
+  execFileSync("mkdir", ["-p", packageDir]);
+  const packageJson = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+  packageJson[field] = value;
+  writeFileSync(join(packageDir, "package.json"), `${JSON.stringify(packageJson)}\n`);
+  const tarball = join(work, `${field}.tgz`);
+  execFileSync("tar", ["-czf", tarball, "-C", work, "package"]);
+  return { work, tarball };
+}
+
+function runVerifier(tarball) {
+  return spawnSync(process.execPath, [verifier], {
+    cwd: root,
+    env: { ...process.env, RELEASE_TARBALL: tarball },
+    encoding: "utf8",
+  });
+}
+
+test("rejects packed name and version changes against selected source", () => {
+  for (const [field, value] of [["name", "invalid-name"], ["version", "0.0.0-invalid-test"]]) {
+    const fixture = syntheticTarball(field, value);
+    try {
+      const result = runVerifier(fixture.tarball);
+      assert.notEqual(result.status, 0, `${field} mutation was accepted`);
+      assert.match(`${result.stdout}\n${result.stderr}`, /packed package (name|version) differs from selected source/);
+    } finally {
+      rmSync(fixture.work, { recursive: true, force: true });
+    }
+  }
+});
+
+test("accepts the normal packed artifact", () => {
+  const filename = JSON.parse(execFileSync("npm", ["pack", "--json", "--ignore-scripts"], { cwd: root, encoding: "utf8" }))[0].filename;
+  const tarball = join(root, filename);
+  try {
+    const result = runVerifier(tarball);
+    assert.equal(result.status, 0, result.stderr);
+  } finally {
+    rmSync(tarball, { force: true });
+  }
+});

package/test/rarebit-command.test.mjs

@@ -14,11 +14,11 @@ const values = (prefix) =>
 test("one grammar derives command description and usage", () => {
   assert.equal(
     rarebitCommandDescription(),
-    "Rarebit status/recall/fork/config/auto-title/title/summarize",
+    "Rarebit menu/settings/help/status/recall/fork/config/auto-title/title/recap/summarize",
   );
   assert.equal(
     rarebitCommandUsage(),
-    "Usage: /rarebit [status|recall|fork|config|auto-title|title|summarize]",
+    "Usage: /rarebit [menu|settings|help|status|recall|fork|config|auto-title|title|recap|summarize]",
   );
   assert.equal(
     rarebitCommandUsage("config"),
@@ -41,7 +41,7 @@ test("one grammar derives command description and usage", () => {
 test("parser accepts exactly the command grammar", () => {
   assert.deepEqual(parseRarebitCommand(""), {
     ok: true,
-    subcommand: "status",
+    subcommand: "menu",
     arguments: [],
   });
   assert.equal(parseRarebitCommand("fork").ok, true);
@@ -93,15 +93,19 @@ test("parser accepts exactly the command grammar", () => {
 
 test("autocomplete covers subcommands and discrete nested arguments", () => {
   assert.deepEqual(values(""), [
+    "menu",
+    "settings",
+    "help",
     "status",
     "recall",
     "fork",
     "config",
     "auto-title",
     "title",
+    "recap",
     "summarize",
   ]);
-  assert.deepEqual(values("s"), ["status", "summarize"]);
+  assert.deepEqual(values("s"), ["settings", "status", "summarize"]);
   assert.deepEqual(values("config "), [
     "config max_rarebit_ratio ",
     "config min_total_length ",