ctxr-cli 0.2.2 → 0.4.0

package/dist/core/identity.js

@@ -1,143 +0,0 @@
-import { existsSync } from 'node:fs';
-import { mkdir, readFile } from 'node:fs/promises';
-import path from 'node:path';
-import { IdentityEntryMatchError } from './errors.js';
-import { writeFileAtomic } from './fs/atomic.js';
-/**
- * agent-identity spec: three canonical, harness-neutral roles — posture,
- * durable world facts, durable user facts — kept distinct from retrievable
- * knowledge (excluded from every retrieval leg via each resolved path being
- * covered by config.retrieval.exclude_paths). A harness's own
- * identity-injection adapter decides how these reach a running agent; core
- * never reads their content itself.
- *
- * session-capture-command spec (D3): a role's path is CONFIGURABLE
- * (`identity.files`) — a store whose runtime keeps its memory elsewhere
- * points the role there, and every consumer below resolves through
- * `identityFilePath`/`identityFilePaths` rather than assuming the canonical
- * layout, so the relocated file IS the mechanism, not a copy of it.
- */
-export const IDENTITY_ROLES = ['posture', 'world-facts', 'user-facts'];
-/** The canonical filename each role resolves to under `identity.path` when no override is configured. */
-export const IDENTITY_FILES = {
-    posture: 'posture.md',
-    'world-facts': 'world-facts.md',
-    'user-facts': 'user-facts.md',
-};
-const TEMPLATES = {
-    posture: '# Agent posture\n\nHow an agent should approach work in this store: tone, defaults, things to always or never do.\n',
-    'world-facts': '# Durable world facts\n\nFacts about the world (not the user) worth carrying into every session.\n',
-    'user-facts': '# Durable user facts\n\nFacts about the user worth carrying into every session.\n',
-};
-/** The store-relative path this role resolves to: its configured binding, or its canonical file under `identity.path`. */
-export function identityFilePath(config, role) {
-    const bound = config.identity.files[role];
-    const relative = bound ?? path.join(config.identity.path, IDENTITY_FILES[role]);
-    return relative.split(path.sep).join('/');
-}
-export function identityFilePaths(config) {
-    return IDENTITY_ROLES.map((role) => identityFilePath(config, role));
-}
-/** Creates any of the three canonical identity files that don't exist yet — never overwrites an existing one. */
-export async function ensureIdentityFiles(root, config) {
-    const created = [];
-    for (const role of IDENTITY_ROLES) {
-        const relativePath = identityFilePath(config, role);
-        const absolutePath = path.join(root, relativePath);
-        if (!existsSync(absolutePath)) {
-            await mkdir(path.dirname(absolutePath), { recursive: true });
-            await writeFileAtomic(absolutePath, TEMPLATES[role]);
-            created.push(relativePath);
-        }
-    }
-    return created;
-}
-/**
- * session-capture-command spec (D4): an entry is the text between two
- * delimiter lines. The default delimiter ('') means an empty (blank) line,
- * so paragraphs are entries and a heading-sectioned file's headings simply
- * become part of the entry that follows them — no section vocabulary, no
- * format detection.
- */
-export function splitEntries(text, delimiter) {
-    const isDelimiterLine = (line) => (delimiter === '' ? line.trim() === '' : line === delimiter);
-    const entries = [];
-    let current = [];
-    // A single trailing newline is a file-formatting convention, not a blank final line — for a
-    // custom delimiter it would otherwise leak into the last entry as trailing junk.
-    const trimmed = text.endsWith('\n') ? text.slice(0, -1) : text;
-    for (const line of trimmed.split('\n')) {
-        if (isDelimiterLine(line)) {
-            if (current.length > 0) {
-                entries.push(current.join('\n'));
-                current = [];
-            }
-        }
-        else {
-            current.push(line);
-        }
-    }
-    if (current.length > 0)
-        entries.push(current.join('\n'));
-    return entries;
-}
-export function joinEntries(entries, delimiter) {
-    if (entries.length === 0)
-        return '';
-    const separator = delimiter === '' ? '\n\n' : `\n${delimiter}\n`;
-    return `${entries.join(separator)}\n`;
-}
-async function readEntries(absolutePath, delimiter) {
-    let text;
-    try {
-        text = await readFile(absolutePath, 'utf8');
-    }
-    catch (err) {
-        if (err.code === 'ENOENT')
-            return [];
-        throw err;
-    }
-    return splitEntries(text, delimiter);
-}
-function findUniqueMatch(entries, match, filePath) {
-    const indices = entries.reduce((acc, entry, index) => {
-        if (entry.includes(match))
-            acc.push(index);
-        return acc;
-    }, []);
-    if (indices.length !== 1) {
-        throw new IdentityEntryMatchError(filePath, match, indices.length);
-    }
-    return indices[0];
-}
-/** Appends a new entry at the end of the role's file, creating it (with no other entries) if it doesn't exist yet. */
-export async function addIdentityEntry(root, config, role, text) {
-    const relativePath = identityFilePath(config, role);
-    const absolutePath = path.join(root, relativePath);
-    const entries = await readEntries(absolutePath, config.identity.entry_delimiter);
-    entries.push(text);
-    await mkdir(path.dirname(absolutePath), { recursive: true });
-    await writeFileAtomic(absolutePath, joinEntries(entries, config.identity.entry_delimiter));
-    return { path: relativePath, entries: entries.length };
-}
-/** Replaces the single entry containing `match`; refuses, writing nothing, when zero or several entries match. */
-export async function replaceIdentityEntry(root, config, role, match, text) {
-    const relativePath = identityFilePath(config, role);
-    const absolutePath = path.join(root, relativePath);
-    const entries = await readEntries(absolutePath, config.identity.entry_delimiter);
-    const index = findUniqueMatch(entries, match, relativePath);
-    entries[index] = text;
-    await writeFileAtomic(absolutePath, joinEntries(entries, config.identity.entry_delimiter));
-    return { path: relativePath, entries: entries.length };
-}
-/** Removes the single entry containing `match`; refuses, writing nothing, when zero or several entries match. */
-export async function removeIdentityEntry(root, config, role, match) {
-    const relativePath = identityFilePath(config, role);
-    const absolutePath = path.join(root, relativePath);
-    const entries = await readEntries(absolutePath, config.identity.entry_delimiter);
-    const index = findUniqueMatch(entries, match, relativePath);
-    entries.splice(index, 1);
-    await writeFileAtomic(absolutePath, joinEntries(entries, config.identity.entry_delimiter));
-    return { path: relativePath, entries: entries.length };
-}
-//# sourceMappingURL=identity.js.map

package/dist/core/identity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/core/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC;AAGhF,yGAAyG;AACzG,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,OAAO,EAAE,YAAY;IACrB,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;CAC9B,CAAC;AAEF,MAAM,SAAS,GAAiC;IAC9C,OAAO,EAAE,qHAAqH;IAC9H,aAAa,EAAE,oGAAoG;IACnH,YAAY,EAAE,mFAAmF;CAClG,CAAC;AAEF,0HAA0H;AAC1H,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,IAAkB;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAmB;IACzE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB;IAC1D,MAAM,eAAe,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAChH,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,4FAA4F;IAC5F,iFAAiF;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjC,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA0B,EAAE,SAAiB;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC;IACjE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,YAAoB,EAAE,SAAiB;IAChE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,OAA0B,EAAE,KAAa,EAAE,QAAgB;IAClF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAW,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7D,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,uBAAuB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC;AASD,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAmB,EAAE,IAAkB,EAAE,IAAY;IACxG,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3F,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,MAAmB,EACnB,IAAkB,EAClB,KAAa,EACb,IAAY;IAEZ,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC5D,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACtB,MAAM,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3F,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,MAAmB,EACnB,IAAkB,EAClB,KAAa;IAEb,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzB,MAAM,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3F,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACzD,CAAC"}