@quickchatai/quickreview 0.0.0-stage → 1.1.0

package/dist/src/memory/layout.js

@@ -0,0 +1,252 @@
+// The layout of a user's memories tree. Separate areas let the round's pinned
+// head read one directory instead of the whole store, and keep ops notes and
+// raw feedback events out of the round's context search. The areas, under
+// `viking://user/<user>/memories/`:
+//
+//   preferences/pinned/  the GUARANTEED HEAD — the owner's standing
+//                        instructions, delivered verbatim every round. An
+//                        entry is pinned by being HERE (placement), and pin /
+//                        unpin MOVE an entry in and out of it.
+//   preferences/         unpinned standing instructions — what the owner types
+//                        (`#manual`), and where an unpinned instruction goes.
+//   experiences/         curated lessons, written by the EOD curator (and the
+//                        setup/scan notes) — the ONLY area the round's context
+//                        block searches.
+//   finding-cases/       one document per posted finding and its fate,
+//                        written by the daemon (src/cases.ts); never listed by
+//                        the whole-tree sweep, never searched by a round.
+//   events/              feedback, bug and ops signals, with `k=v` tags
+//                        (`kind=feedback|bug|ops`, `pr=…`, `day=…`).
+//
+// This module is the VOCABULARY: area names, address arithmetic and the header
+// edits a move needs. It knows nothing about HTTP or OpenViking — an id here
+// is the store's `<area>/<file>` (see src/openviking/store.ts), and only the
+// store turns it into a URI.
+import { EVENT_TAG_RE, HASH_TOKEN_RE, parseEventTags, parseHashTags } from "./eventtags.js";
+/** The guaranteed head. */
+export const PINNED_AREA = "preferences/pinned";
+/** Unpinned standing instructions — the owner's own words. */
+export const PREFERENCES_AREA = "preferences";
+/** Curated lessons — the round's context block searches this area only. */
+export const EXPERIENCES_AREA = "experiences";
+/** Feedback, bug and ops signals. */
+export const EVENTS_AREA = "events";
+/** Finding cases. */
+export const CASES_AREA = "finding-cases";
+/** An entry typed by the owner. */
+export const MANUAL_TAG = "manual";
+/** The header tag carried by a pinned instruction. */
+export const PINNED_TAG = "pinned";
+/** The header tag every reader hides an entry by. */
+export const RETIRED_TAG = "retired";
+/** Whether the header retires this entry from retrieval. */
+export function isRetired(text) {
+    return parseHashTags(text).includes(RETIRED_TAG);
+}
+/** The tag a move's stub carries beside `#retired`. */
+export const MOVED_TAG = "moved";
+/** Is this stored text a move's stub (header `#retired #moved`)? Only such a
+ * stub may be written over by a later move into its address — the store's
+ * move and the relayout plan read it with this one rule. */
+export function isMovedStub(text) {
+    const tags = parseHashTags(text);
+    return tags.includes(RETIRED_TAG) && tags.includes(MOVED_TAG);
+}
+/** Every area of the layout, most specific first. */
+export const MEMORY_AREAS = [
+    PINNED_AREA,
+    PREFERENCES_AREA,
+    EXPERIENCES_AREA,
+    CASES_AREA,
+    EVENTS_AREA,
+];
+/**
+ * The areas the round's context block may draw from: `experiences/`
+ * alone. No ops notes, no raw feedback events, no standing instructions that
+ * are not pinned (the head carries the pinned ones in full), no repo-wide
+ * resources blurbs. They are OpenViking quota buckets by name, which is how
+ * the search is confined to them.
+ */
+export const ROUND_SEARCH_AREAS = [EXPERIENCES_AREA];
+/**
+ * Areas the store's whole-tree SWEEP does not list: `finding-cases/`.
+ * A case is a document the daemon derives from state.db and rewrites itself
+ * (src/cases.ts) — one per posted finding a human answered or whose fate is
+ * known, so hundreds of them, growing every day. Listing them would put every
+ * one into each sweep's hourly full re-read (in the daemon and in the TUI) and
+ * into the memory tab's timeline, and none of the sweep's readers wants them:
+ * the pinned head reads its own directory, the [feedback] pump and the
+ * relayout look for curated and event entries, the TUI curates lessons. The
+ * learner's readers — the EOD curator and the companion — reach cases through
+ * the server's search, which this does not touch.
+ */
+export const SWEEP_EXCLUDED_AREAS = [CASES_AREA];
+/** The event tag a pinned entry carries to remember where it came from, so an
+ * unpin puts it back. */
+export const FROM_TAG = "from";
+/** `experiences/2026….md` → `experiences`; `preferences/pinned/x.md` →
+ * `preferences/pinned`; a file at the root → `""`. */
+export function areaOfId(id) {
+    const cut = id.lastIndexOf("/");
+    return cut < 0 ? "" : id.slice(0, cut);
+}
+/** The file name of an id (`…/x.md` → `x.md`). */
+export function nameOfId(id) {
+    return id.slice(id.lastIndexOf("/") + 1);
+}
+/** Is this entry in the guaranteed head? Placement, never a tag: an address is
+ * chosen by the writer of the file, never by text quoted inside it — the
+ * feedback sink, for one, always writes into `events/`. */
+export function isPinnedId(id) {
+    return areaOfId(id) === PINNED_AREA;
+}
+/** Where `id` lands when it is pinned. */
+export function pinnedIdFor(id) {
+    return `${PINNED_AREA}/${nameOfId(id)}`;
+}
+/** One or two lowercase segments — an area this layout can spell. */
+const AREA_RE = /^[a-z][a-z0-9_-]*(?:\/[a-z][a-z0-9_-]*)?$/;
+export function validArea(area) {
+    return AREA_RE.test(area);
+}
+/**
+ * Where an unpinned entry goes: the area its `from=` tag names (set when it
+ * was pinned), else `preferences/` — an entry somebody pinned was a standing
+ * instruction, and unpinning keeps it one. Never the pinned area itself.
+ */
+export function unpinTargetArea(text) {
+    const from = parseEventTags(text)[FROM_TAG];
+    if (from !== undefined && validArea(from) && from !== PINNED_AREA)
+        return from;
+    return PREFERENCES_AREA;
+}
+/**
+ * Where a NEW entry written through the seam lands when its writer names no
+ * area: the header decides (header-only, so quoted text cannot choose) —
+ * `#pinned` → the head, `#manual` → preferences, anything else → the store's
+ * default area.
+ */
+export function areaForNewEntry(text, fallback) {
+    const tags = parseHashTags(text.trim());
+    if (tags.includes(PINNED_TAG))
+        return PINNED_AREA;
+    if (tags.includes(MANUAL_TAG))
+        return PREFERENCES_AREA;
+    return fallback;
+}
+/**
+ * What the EOD curator is told about the layout. The sweep's seed
+ * (`prompts/eod-sweep.md`) is frozen (rule 6), so the layout reaches the
+ * curator the way the day's cancellation line does: the daemon renders it
+ * after the seed (`renderEodPrompt`'s `memoryLayout`). It rules on nothing the
+ * seed rules on — it says WHERE each kind of entry lives. The seed names the
+ * `events/`, `experiences/` and `preferences/pinned/` areas itself and owns
+ * what may be done with a `#manual` entry; this note must say nothing against
+ * it, which `tests/eod-seed-coherence.test.ts` checks over the real seed.
+ */
+export const MEMORY_LAYOUT_NOTE = [
+    "Reviewer memory (`viking://user/reviewer/memories/`) is laid out in areas.",
+    "Write each entry where it belongs; `viking_write` takes the",
+    "full URI, so the area is the directory you name:",
+    "",
+    "- `" + EXPERIENCES_AREA + "/` — the day's learnings (product 1). The ONLY area a review round",
+    "  searches, so nothing else belongs here.",
+    "- `" + EVENTS_AREA + "/` — feedback, bug and ops signals. An operational defect of the review",
+    "  system is an `events/` entry whose header carries `kind=bug area=operations`;",
+    "  an ops note that is not a defect carries `kind=ops area=operations`. The",
+    "  day's `kind=feedback` entries are here too.",
+    "- `" + PREFERENCES_AREA + "/` — the owner's own words (`#manual`); the memory discipline above",
+    "  rules on them.",
+    "- `" + PINNED_AREA + "/` — THE PINNED AREA: the owner's standing instructions,",
+    "  delivered verbatim in every round. Never write, move, retire or rewrite",
+    "  anything under it.",
+    "- `" + CASES_AREA + "/` — finding CASES, written by the daemon: one per posted finding a",
+    "  human answered or whose fate is known (fixed, refuted, upheld, or left open",
+    "  at the PR's close), with the humans' replies quoted as data. Search them",
+    "  (`viking_search`) for the evidence behind a learning;",
+    "  never write, edit or retire one — the daemon rewrites each from its own",
+    "  records. The daemon may deliver matching cases as data in a review prompt.",
+    "",
+    "An entry's header is its first tokens — `#tags`, then `k=v` tags, then the",
+    "prose (e.g. `#bug kind=bug area=operations day=YYYY-MM-DD What broke …`); a tag",
+    "anywhere else in the text is prose, and nothing reads it.",
+].join("\n");
+// ---- header edits ------------------------------------------------------------
+//
+// The header is the leading run the two parsers of src/memory/eventtags.ts
+// read: tokens that start with `#` (which `parseHashTags` walks through — a
+// bare `#` included) and `k=v` tokens (which `parseEventTags` reads while it
+// skips every `#` token). An edit here stays inside that run, so both parsers
+// see exactly what they saw before plus the edit. A run that holds nothing but
+// a bare `#` is a markdown title, not a header: a tag is then not spliced into
+// the title but put on a first line of its own.
+/** Index (into the separator-keeping token array) just past the header run,
+ * and whether the run holds a real tag. */
+function headerRun(tokens) {
+    let end = 0;
+    let real = false;
+    for (let i = 0; i < tokens.length; i += 2) {
+        const t = tokens[i];
+        if (t === "")
+            continue;
+        const tag = HASH_TOKEN_RE.test(t) || EVENT_TAG_RE.test(t);
+        // A bare `#` after a real tag is a markdown title on the next line.
+        if (!tag && real)
+            break;
+        if (tag || t.startsWith("#")) {
+            end = i + 1;
+            if (tag)
+                real = true;
+            continue;
+        }
+        break;
+    }
+    return { end, real };
+}
+/**
+ * `text` with the `k=v` tags it does not already carry in its header added to
+ * the header: at the end of the leading run of `#tags` and `k=v`, or — when the
+ * text opens with prose or a markdown title — as a first line of their own. A
+ * tag the header already has is left as it is (never two values for one key).
+ * Returns the trimmed text.
+ */
+export function withHeaderTags(text, tags) {
+    const trimmed = text.trim();
+    const have = parseEventTags(trimmed);
+    const add = Object.entries(tags)
+        .filter(([k, v]) => EVENT_TAG_RE.test(`${k}=${v}`) && !(k in have))
+        .map(([k, v]) => `${k}=${v}`)
+        .join(" ");
+    if (add === "")
+        return trimmed;
+    if (trimmed === "")
+        return add;
+    const tokens = trimmed.split(/(\s+)/);
+    const { end, real } = headerRun(tokens);
+    if (!real)
+        return `${add}\n${trimmed}`;
+    const head = tokens.slice(0, end).join("");
+    const tail = tokens.slice(end).join("");
+    return tail.trim() === "" ? `${head} ${add}` : `${head} ${add}${tail}`;
+}
+/** `text` without the header's `key=…` token. Only the header is touched, and
+ * only the gap the token leaves is closed; the rest is the writer's bytes. */
+export function withoutHeaderTag(text, key) {
+    const trimmed = text.trim();
+    const tokens = trimmed.split(/(\s+)/);
+    const { end } = headerRun(tokens);
+    for (let i = 0; i < end; i += 2) {
+        const t = tokens[i];
+        if (!t.startsWith(`${key}=`) || !EVENT_TAG_RE.test(t))
+            continue;
+        // Take the separator before it when there is one (so `#a k=v\nrest`
+        // keeps its line break), else the one after it.
+        if (i > 0)
+            tokens.splice(i - 1, 2);
+        else
+            tokens.splice(i, 2);
+        return tokens.join("").trim();
+    }
+    return trimmed;
+}
+//# sourceMappingURL=layout.js.map

package/dist/src/memory/layout.js.map

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

package/dist/src/memory/legacy-file.js

@@ -0,0 +1,100 @@
+// The archived pi-memory file (MEMORY.md), READ ONLY. It exists so the
+// one-time curated import (`import.ts`) can see it; the file itself is the
+// historical record, archived in place at 0444. There is no write path of any
+// kind here.
+//
+// This is deliberately NOT a `MemoryStore`. It is a `MemorySource`: `read()`
+// and nothing else. The seam has exactly ONE implementation
+// (`src/openviking/store.ts`), and adding a second — even a read-only one —
+// would reopen the question of which engine a caller is talking to.
+//
+// The markdown shape it parses is pi-memory's: write batches delimited by
+// header comments `<!-- YYYY-MM-DD HH:MM:SS [id] -->`, each batch holding one
+// or more blank-line-separated paragraph blocks (one lesson per block). Three
+// header variants existed (plain, `last updated:` overwrite, `HANDOFF`
+// compaction) and all three delimit batches — missing one would mis-attribute
+// its blocks to the previous batch and hand the import the wrong provenance.
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parseHashTags } from "./eventtags.js";
+import { linksOf, tagsOf } from "./store.js";
+/** Where the archived MEMORY.md sits for a process running beside pi. */
+export function legacyMemoryPath() {
+    return process.env["QCR_MEMORY_PATH"] ?? join(homedir(), ".pi", "agent", "memory", "MEMORY.md");
+}
+const HEADER_RE = /^<!--\s*(?:(?:last updated:|HANDOFF)\s+)?(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})\s*\[([^\]]+)\]\s*-->\s*$/;
+/** sha1-12 of a block's exact text. It only fills `MemoryEntry.hash` so a
+ * source entry is a well-formed entry. */
+export function legacyBlockHash(text) {
+    return createHash("sha1").update(text, "utf8").digest("hex").slice(0, 12);
+}
+/** Parse MEMORY.md into entries, file order (append order = oldest first). */
+export function parseLegacyMemory(md) {
+    const entries = [];
+    let header;
+    let block = [];
+    let blockIdx = 0;
+    const flush = () => {
+        const text = block.join("\n").trim();
+        block = [];
+        if (!header || text.length === 0)
+            return;
+        // `tags` stays a full-text scan: it feeds the import classifier, where
+        // over-inclusion is merely noisy.
+        const tags = tagsOf(text);
+        const links = linksOf(text);
+        entries.push({
+            id: header.id,
+            ts: header.ts,
+            day: header.day,
+            block: blockIdx,
+            text,
+            tags,
+            links,
+            // `pinned` is NOT a full-text scan: it is the privileged flag, and a
+            // pinned entry rides the guaranteed head of every round prompt — the
+            // highest-trust position in the system. Entries quote untrusted human
+            // text verbatim, so a `#pinned` written anywhere in a quoted comment
+            // must not be able to promote itself there. Header-only: only the
+            // leading run of `#tag` tokens counts. (The OpenViking store enforces
+            // the same rule with the same helper; see tests/openviking-store.)
+            pinned: parseHashTags(text).includes("pinned"),
+            hash: legacyBlockHash(text),
+        });
+        blockIdx += 1;
+    };
+    for (const line of md.split("\n")) {
+        const m = HEADER_RE.exec(line);
+        if (m) {
+            flush();
+            header = { ts: `${m[1]} ${m[2]}`, day: m[1], id: m[3] };
+            blockIdx = 0;
+            continue;
+        }
+        if (line.trim() === "") {
+            flush();
+            continue;
+        }
+        block.push(line);
+    }
+    flush();
+    return entries;
+}
+/** The import's source: one archived markdown file, read on demand. An
+ * unreadable file is an empty source, never a throw — the import has no abort
+ * path, and "the file is already gone" is a legitimate outcome. */
+export function legacyMemoryFileSource(path = legacyMemoryPath()) {
+    return {
+        async read() {
+            try {
+                return parseLegacyMemory(await readFile(path, "utf8"));
+            }
+            catch {
+                return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=legacy-file.js.map

package/dist/src/memory/legacy-file.js.map

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