@north-light/crouter 0.3.175 → 0.3.177

package/dist/core/substrate/on-read-pure.js

@@ -1,272 +0,0 @@
-// on-read.ts — file-context delivery for the document substrate.
-//
-// A memory with file-read visibility participates only through an explicit
-// `applies-to` path glob (authoring lint requires one). Two events use that one
-// routing mechanism:
-//
-//   • A successful `read` tool call evaluates the read file against every
-//     visible substrate doc. Project stores encountered between that file and
-//     the filesystem root join the resolved cwd/profile corpus, so a nested
-//     workspace can contribute guidance exactly when a file beneath it is read.
-//   • Opening a workspace evaluates the reserved `applies-to: "."` target for
-//     every project store mounted by the cwd and selected profile. This happens
-//     while the first-message bearings are assembled, so workspace-wide context
-//     arrives before the task rather than waiting for an arbitrary first file.
-//
-// `read-when` remains an additional OR trigger over a read markdown file's own
-// frontmatter. It does not replace `applies-to`: every non-none file-read rung
-// still declares its path boundary explicitly.
-//
-// Every candidate renders at its own fileReadVisibility rung. Explicit routing
-// is the whole on-read model, so directory INDEX ceilings remain a boot-catalog
-// concern and do not cap a deliberately matched document.
-import { realpathSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { basename, dirname, matchesGlob, parse, relative, sep } from 'node:path';
-import { CRTR_DIR_NAME } from '../../types.js';
-import { pathExists, readText, walkFiles } from '../fs-utils.js';
-import { parseFrontmatterGeneric } from '../frontmatter.js';
-import { evalCondition } from '../predicate.js';
-import { listAllMemoryDocs, listProjectMemoryDocs } from '../memory-resolver.js';
-import { userScopeRoot } from '../scope.js';
-import { displayName } from './ceiling.js';
-import { gatePasses } from './gate.js';
-import { normalizeDocName, parseSubstrateDoc, parseSubstrateFrontmatter, previewLine, resolveDocName } from './schema.js';
-import { cachedSubstrateDocs } from './session-cache.js';
-const JUNK_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', '.cache', '.yalc']);
-function realpathOrSelf(p) {
-    try {
-        return realpathSync(p);
-    }
-    catch {
-        return p;
-    }
-}
-function attr(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/"/g, '"')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
-}
-function gitRootOf(p) {
-    let d = p;
-    const root = parse(d).root;
-    while (true) {
-        if (pathExists(`${d}${sep}.git`))
-            return d;
-        if (d === root)
-            return null;
-        const parent = dirname(d);
-        if (parent === d)
-            return null;
-        d = parent;
-    }
-}
-function disp(p) {
-    const root = gitRootOf(p);
-    if (!root)
-        return p;
-    const rel = relative(root, p);
-    return rel === '' ? '.' : rel;
-}
-function isJunkAncestor(dir) {
-    return dir.split(sep).some((segment) => JUNK_DIRS.has(segment));
-}
-function owningRootOf(doc) {
-    const parts = doc.path.split(sep);
-    const idx = parts.lastIndexOf(CRTR_DIR_NAME);
-    if (idx <= 0)
-        return null;
-    return parts.slice(0, idx).join(sep) || sep;
-}
-function loadProjectDoc(file, memoryDir) {
-    try {
-        const raw = relative(memoryDir, file)
-            .replace(/\.md$/i, '')
-            .split(sep)
-            .join('/');
-        const fallbackName = normalizeDocName(raw);
-        if (fallbackName === '')
-            return null;
-        const { data, body } = parseFrontmatterGeneric(readText(file));
-        const schema = parseSubstrateFrontmatter(data);
-        if (schema === null)
-            return null;
-        return {
-            ...schema,
-            name: resolveDocName(data, fallbackName),
-            scope: 'project',
-            path: file,
-            body,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-function safeWalkMarkdown(dir) {
-    try {
-        return walkFiles(dir, (name) => name.toLowerCase().endsWith('.md'));
-    }
-    catch {
-        return [];
-    }
-}
-/** Project docs from every workspace store enclosing the read file. This is a
- * discovery walk only: each returned doc must still match an explicit trigger. */
-function enclosingProjectDocs(absReadFile) {
-    const docs = [];
-    const seen = new Set();
-    const home = realpathOrSelf(homedir());
-    const userRoot = realpathOrSelf(userScopeRoot());
-    const fsRoot = parse(absReadFile).root;
-    let dir = dirname(absReadFile);
-    while (true) {
-        if (dir !== home && dir !== userRoot && !isJunkAncestor(dir)) {
-            const memoryDir = `${dir}${sep}${CRTR_DIR_NAME}${sep}memory`;
-            if (pathExists(memoryDir)) {
-                for (const file of safeWalkMarkdown(memoryDir)) {
-                    const real = realpathOrSelf(file);
-                    if (seen.has(real))
-                        continue;
-                    seen.add(real);
-                    const doc = loadProjectDoc(file, memoryDir);
-                    if (doc !== null)
-                        docs.push(doc);
-                }
-            }
-        }
-        if (dir === home || dir === fsRoot)
-            break;
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return docs;
-}
-function resolvedDocs() {
-    try {
-        return cachedSubstrateDocs(listAllMemoryDocs, parseSubstrateDoc);
-    }
-    catch {
-        return [];
-    }
-}
-function dedupeByPhysicalPath(docs) {
-    const seen = new Set();
-    const out = [];
-    for (const doc of docs) {
-        const real = realpathOrSelf(doc.path);
-        if (seen.has(real))
-            continue;
-        seen.add(real);
-        out.push(doc);
-    }
-    return out;
-}
-function globMatches(glob, absReadFile, owningRoot) {
-    const targets = [absReadFile, basename(absReadFile)];
-    if (owningRoot !== null)
-        targets.push(relative(owningRoot, absReadFile));
-    return targets.some((target) => {
-        try {
-            return matchesGlob(target, glob);
-        }
-        catch {
-            return false;
-        }
-    });
-}
-function readFileFrontmatter(absReadFile) {
-    if (!/\.(md|mdx|markdown)$/i.test(absReadFile))
-        return {};
-    try {
-        return parseFrontmatterGeneric(readText(absReadFile)).data ?? {};
-    }
-    catch {
-        return {};
-    }
-}
-function matchesReadEvent(doc, absReadFile, readFrontmatter) {
-    const pathMatch = doc.appliesTo?.some((glob) => globMatches(glob, absReadFile, owningRootOf(doc))) === true;
-    const frontmatterMatch = doc.readWhen !== undefined &&
-        Object.keys(readFrontmatter).length > 0 &&
-        evalCondition(doc.readWhen, readFrontmatter);
-    return pathMatch || frontmatterMatch;
-}
-function envelopeName(doc) {
-    const displayed = displayName(doc.name);
-    if (displayed !== '')
-        return displayed;
-    const root = owningRootOf(doc);
-    return root === null ? doc.name : basename(root);
-}
-function renderDocEnvelope(doc) {
-    const rung = doc.fileReadVisibility;
-    if (rung === 'none')
-        return null;
-    let body = '';
-    if (rung === 'content')
-        body = doc.body.trim();
-    else if (rung === 'preview')
-        body = previewLine(doc);
-    const attrs = `kind="${attr(doc.kind)}" name="${attr(envelopeName(doc))}" src="${attr(disp(doc.path))}"`;
-    return body === '' ? `<memory ${attrs} />` : `<memory ${attrs}>\n${body}\n</memory>`;
-}
-function renderCandidates(subject, docs, seen) {
-    const rendered = [];
-    for (const doc of docs) {
-        const real = realpathOrSelf(doc.path);
-        if (seen.has(real))
-            continue;
-        try {
-            if (!gatePasses(doc, subject))
-                continue;
-            const block = renderDocEnvelope(doc);
-            if (block === null)
-                continue;
-            seen.add(real);
-            rendered.push(block);
-        }
-        catch {
-            continue;
-        }
-    }
-    return rendered.length === 0
-        ? ''
-        : `<auto-loaded-context>\n${rendered.join('\n')}\n</auto-loaded-context>`;
-}
-/** Surface docs matched by a successful read tool call using the caller-supplied
- * daemon snapshot subject. */
-export function renderOnReadDocsForSubject(subject, readFilePath, seen = new Set()) {
-    const absReadFile = realpathOrSelf(readFilePath);
-    const readFrontmatter = readFileFrontmatter(absReadFile);
-    const docs = dedupeByPhysicalPath([...enclosingProjectDocs(absReadFile), ...resolvedDocs()])
-        .filter((doc) => realpathOrSelf(doc.path) !== absReadFile)
-        .filter((doc) => matchesReadEvent(doc, absReadFile, readFrontmatter));
-    return renderCandidates(subject, docs, seen);
-}
-/** Workspace boot docs using the snapshot's cwd/profile instead of a canvas
- * lookup. */
-export function renderWorkspaceOpenDocsForSubject(subject, cwd, profileId) {
-    let docs;
-    try {
-        docs = listProjectMemoryDocs(cwd, profileId)
-            .map(parseSubstrateDoc)
-            .filter((doc) => doc !== null);
-    }
-    catch {
-        return '';
-    }
-    docs = dedupeByPhysicalPath(docs)
-        .filter((doc) => doc.appliesTo?.some((glob) => glob.trim() === '.') === true)
-        .sort((a, b) => {
-        const aRoot = owningRootOf(a) ?? '';
-        const bRoot = owningRootOf(b) ?? '';
-        const depth = aRoot.split(sep).filter(Boolean).length - bRoot.split(sep).filter(Boolean).length;
-        return depth || aRoot.localeCompare(bRoot) || a.path.localeCompare(b.path);
-    });
-    return renderCandidates(subject, docs, new Set());
-}