@hivehub/rulebook 5.5.2 → 5.8.0

package/dist/hooks/terse-mode-tracker.js

@@ -1,213 +0,0 @@
-/**
- * Claude Code UserPromptSubmit hook for rulebook-terse.
- *
- * Runs on every user message. Three responsibilities:
- *
- *   1. **Mode switching.** Parses slash commands (`/rulebook-terse`,
- *      `/rulebook-terse brief|terse|ultra|off`, `/rulebook-terse-commit`,
- *      `/rulebook-terse-review`) and natural-language activation
- *      phrases ("be terse", "less tokens please", "terse mode",
- *      "activate rulebook-terse"). Writes the resolved mode to the
- *      flag file via `safeWriteFlag`.
- *
- *   2. **Mode deactivation.** Recognizes "normal mode", "stop terse",
- *      "disable terse", etc. Deletes the flag file.
- *
- *   3. **Per-turn reinforcement.** When the flag is set to a persistent
- *      mode (brief / terse / ultra), emits a short ~45 token attention
- *      anchor as `hookSpecificOutput.additionalContext` JSON. The
- *      SessionStart hook supplied the full rules once; this reminder
- *      keeps the register in the model's attention when other plugins
- *      inject competing instructions mid-conversation.
- *
- *      Independent modes (commit / review) do not get the anchor —
- *      they have their own skill files that fully own the behavior
- *      during the single turn they're invoked.
- *
- * Silent-fails on every filesystem error. A broken hook must NEVER
- * prevent a user message from reaching the model.
- */
-import { unlinkSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { readFlag, safeWriteFlag } from './safe-flag-io.js';
-import { getDefaultMode, getFlagPath } from './terse-config.js';
-/**
- * Modes whose behavior is fully handled by their own sub-skill file
- * and do NOT get a per-turn attention anchor.
- */
-const INDEPENDENT_MODES = new Set(['commit', 'review']);
-/**
- * Natural-language activation patterns. Matched case-insensitively.
- * Both orderings are accepted ("activate caveman" and "caveman mode").
- */
-const ACTIVATION_PATTERNS = [
-    /\b(activate|enable|turn\s+on|start)\b.*\brulebook[-\s]?terse\b/i,
-    /\brulebook[-\s]?terse\b.*\b(mode|activate|enable|turn\s+on|start)\b/i,
-    /\bbe\s+terse\b/i,
-    /\bterse\s+mode\b/i,
-    /\bless\s+tokens?\s*(please)?\b/i,
-];
-/**
- * Natural-language deactivation patterns.
- */
-const DEACTIVATION_PATTERNS = [
-    /\b(stop|disable|turn\s+off|deactivate)\b.*\brulebook[-\s]?terse\b/i,
-    /\brulebook[-\s]?terse\b.*\b(stop|disable|turn\s+off|deactivate)\b/i,
-    /\b(stop|disable)\s+terse\b/i,
-    /\bnormal\s+mode\b/i,
-];
-/**
- * Parse a user prompt for an intent to activate, switch, or disable
- * rulebook-terse. Slash commands take priority over natural language;
- * natural-language deactivation takes priority over activation when
- * both appear in the same prompt.
- *
- * `defaultMode` is used for plain `/rulebook-terse` (no argument).
- */
-export function parseIntent(prompt, defaultMode) {
-    const trimmed = prompt.trim();
-    const lower = trimmed.toLowerCase();
-    // Slash commands — highest priority, exact surface.
-    if (lower.startsWith('/rulebook-terse')) {
-        const parts = lower.split(/\s+/);
-        const cmd = parts[0];
-        const arg = parts[1] ?? '';
-        if (cmd === '/rulebook-terse-commit') {
-            return { kind: 'set', mode: 'commit' };
-        }
-        if (cmd === '/rulebook-terse-review') {
-            return { kind: 'set', mode: 'review' };
-        }
-        if (cmd === '/rulebook-terse') {
-            switch (arg) {
-                case 'off':
-                    return { kind: 'off' };
-                case 'brief':
-                case 'terse':
-                case 'ultra':
-                case 'commit':
-                case 'review':
-                    return { kind: 'set', mode: arg };
-                case '':
-                    return { kind: 'set', mode: defaultMode };
-                default:
-                    return null; // Unknown subcommand — leave mode unchanged.
-            }
-        }
-    }
-    // Natural-language deactivation first — "stop terse" should win over
-    // a stray "terse" that happens to also match activation.
-    if (DEACTIVATION_PATTERNS.some((re) => re.test(trimmed))) {
-        return { kind: 'off' };
-    }
-    if (ACTIVATION_PATTERNS.some((re) => re.test(trimmed))) {
-        return { kind: 'set', mode: defaultMode };
-    }
-    return null;
-}
-/**
- * Build the per-turn attention-anchor JSON emitted when a persistent
- * mode is active. Format matches Claude Code's `hookSpecificOutput`
- * contract for UserPromptSubmit hooks.
- */
-export function buildAttentionAnchor(mode) {
-    const text = `RULEBOOK-TERSE ACTIVE (${mode}). ` +
-        `Drop filler/hedging/pleasantries. ` +
-        (mode === 'brief' ? 'Keep articles and full sentences.' : 'Fragments OK.') +
-        ` Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full.`;
-    return JSON.stringify({
-        hookSpecificOutput: {
-            hookEventName: 'UserPromptSubmit',
-            additionalContext: text,
-        },
-    });
-}
-/**
- * Read an entire JSON object from a readable stream. Claude Code
- * passes hook input as `{ prompt, cwd, ... }` on stdin.
- */
-async function readAllStdin(stream) {
-    const chunks = [];
-    for await (const chunk of stream) {
-        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
-    }
-    return Buffer.concat(chunks).toString('utf8');
-}
-/**
- * Core hook logic, pure and testable. Given an input object and
- * options, returns the string (if any) that should be emitted to
- * stdout, and performs the flag-file side effects.
- */
-export function runHook(input, options = {}) {
-    try {
-        const prompt = input.prompt ?? '';
-        const projectRoot = options.projectRoot ?? input.cwd ?? process.cwd();
-        const env = options.env ?? process.env;
-        const flagPath = getFlagPath(projectRoot);
-        // Resolve default-mode fresh each turn so env changes take effect.
-        const defaultMode = getDefaultMode({ env, projectRoot, tier: env.RULEBOOK_AGENT_TIER });
-        const intent = parseIntent(prompt, defaultMode);
-        if (intent?.kind === 'off') {
-            try {
-                unlinkSync(flagPath);
-            }
-            catch {
-                /* flag already absent — fine */
-            }
-            return null;
-        }
-        if (intent?.kind === 'set') {
-            if (intent.mode === 'off') {
-                try {
-                    unlinkSync(flagPath);
-                }
-                catch {
-                    /* fine */
-                }
-                return null;
-            }
-            safeWriteFlag(flagPath, intent.mode);
-        }
-        // Read whatever mode is now persisted (may be set by this turn or
-        // a previous one) and emit the attention anchor for persistent
-        // modes only.
-        const currentMode = readFlag(flagPath);
-        if (currentMode && currentMode !== 'off' && !INDEPENDENT_MODES.has(currentMode)) {
-            return buildAttentionAnchor(currentMode);
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * CLI entry. Reads JSON from stdin, invokes `runHook`, emits any
- * returned string to stdout. Always exits 0.
- */
-export async function main(options = {}) {
-    try {
-        const stdin = options.stdin ?? process.stdin;
-        const stdout = options.stdout ?? process.stdout;
-        const raw = await readAllStdin(stdin);
-        let input = {};
-        try {
-            input = JSON.parse(raw);
-        }
-        catch {
-            /* Non-JSON input — treat as empty. Hook still no-ops gracefully. */
-        }
-        const out = runHook(input, { projectRoot: options.projectRoot, env: options.env });
-        if (out !== null)
-            stdout.write(out);
-    }
-    catch {
-        /* silent fail */
-    }
-}
-// CLI guard — only auto-run when invoked as the entry script.
-const __filename = fileURLToPath(import.meta.url);
-if (process.argv[1] === __filename) {
-    void main();
-}
-//# sourceMappingURL=terse-mode-tracker.js.map

package/dist/hooks/terse-mode-tracker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"terse-mode-tracker.js","sourceRoot":"","sources":["../../src/hooks/terse-mode-tracker.ts"],"names":[],"mappings":"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"}

package/dist/memory/hnsw-index.d.ts

@@ -1,68 +0,0 @@
-/**
- * Pure TypeScript HNSW (Hierarchical Navigable Small World) Index
- *
- * Approximate nearest neighbor search using cosine distance.
- * Zero native dependencies. Designed for <50K vectors.
- */
-export interface HNSWConfig {
-    M?: number;
-    efConstruction?: number;
-    dimensions: number;
-    maxNodes?: number;
-}
-export declare class HNSWIndex {
-    private readonly M;
-    private readonly efConstruction;
-    private readonly dimensions;
-    private readonly maxNodes;
-    private readonly mL;
-    private nodes;
-    private insertionOrder;
-    private entryPoint;
-    private maxLayer;
-    constructor(config: HNSWConfig);
-    get size(): number;
-    /**
-     * Cosine distance: 1 - cosine_similarity (0 = identical, 2 = opposite)
-     */
-    private cosineDistance;
-    /**
-     * Assign a random layer for a new node
-     */
-    private randomLayer;
-    /**
-     * Greedy search at a single layer, returning ef nearest candidates.
-     * Uses min-heap for candidates and max-heap for results to avoid
-     * O(n log n) array sorts on every iteration (now O(log n) per operation).
-     */
-    private searchLayer;
-    /**
-     * Select M nearest neighbors from candidates, pruning for diversity
-     */
-    private selectNeighbors;
-    /**
-     * Add a vector to the index
-     */
-    add(label: string, vector: Float32Array): void;
-    /**
-     * Search k nearest neighbors
-     */
-    search(query: Float32Array, k: number, ef?: number): Array<{
-        label: string;
-        distance: number;
-    }>;
-    /**
-     * Remove a vector from the index
-     */
-    remove(label: string): void;
-    /**
-     * Serialize the index to an ArrayBuffer for disk persistence
-     * Format: [magic:u32][version:u8][dimensions:u32][M:u16][nodeCount:u32][...nodes]
-     */
-    serialize(): ArrayBuffer;
-    /**
-     * Deserialize an index from an ArrayBuffer
-     */
-    static deserialize(buffer: ArrayBuffer): HNSWIndex;
-}
-//# sourceMappingURL=hnsw-index.d.ts.map

package/dist/memory/hnsw-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hnsw-index.d.ts","sourceRoot":"","sources":["../../src/memory/hnsw-index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsIH,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAK;gBAET,MAAM,EAAE,UAAU;IAQ9B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAsDnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAyG9C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA4B/F;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAwC3B;;;OAGG;IACH,SAAS,IAAI,WAAW;IAkFxB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS;CA2GnD"}