Skip to content

matthewwong525/WongStack / .agents/plugins/memory

memory

Verified

FileKindSize
README.mdmarkdown4.7 KB
SKILL.mdskill md5.8 KB
VERSIONother6 B
hooks/claude.jsonconfig957 B
hooks/codex.jsonconfig692 B
references/placing-facts.mdmarkdown2.1 KB
references/recall-helper.mdmarkdown814 B
references/setup.mdmarkdown7.0 KB
references/tidy.mdmarkdown4.4 KB
references/writing-facts.mdmarkdown2.0 KB
scripts/before-edit.mjsscript2.5 KB
scripts/daily-tidy.mjsscript22.1 KB
scripts/lib/areas.mjsscript3.9 KB
scripts/lib/brief.mjsscript2.3 KB
scripts/lib/cli.mjsscript1.2 KB
scripts/lib/daily.mjsscript1.6 KB
scripts/lib/digest.mjsscript11.9 KB
scripts/lib/documents/commands.mjsscript5.7 KB
scripts/lib/documents/corpus.mjsscript6.8 KB
scripts/lib/documents/input.mjsscript2.4 KB
scripts/lib/documents/lexical.mjsscript4.5 KB
scripts/lib/documents/packet.mjsscript10.2 KB
scripts/lib/documents/retrieve.mjsscript1.9 KB
scripts/lib/files.mjsscript3.7 KB
scripts/lib/headless.mjsscript1.5 KB
scripts/lib/knowledge-copy.mjsscript469 B
scripts/lib/machine-id.mjsscript1.9 KB
scripts/lib/primary-root.mjsexecutablescript1.9 KB
scripts/lib/pull.mjsscript27.0 KB
scripts/lib/read-facts.mjsscript1.7 KB
scripts/lib/read-options.mjsscript3.0 KB
scripts/lib/scan.mjsscript2.0 KB
scripts/lib/store.mjsscript7.7 KB
scripts/lib/topics.mjsscript4.6 KB
scripts/lib/transcripts.mjsscript9.6 KB
scripts/lib/upkeep.mjsscript4.0 KB
scripts/lib/usage.mjsscript5.2 KB
scripts/memory.mjsscript45.7 KB
scripts/run.mjsscript20.4 KB
scripts/session-end.mjsscript1.7 KB
scripts/session-start.mjsscript4.6 KB
scripts/topic-match.mjsscript2.1 KB
store/contract.mjsscript14.6 KB
store/interface.d.mtsother2.9 KB
store/interface.mjsscript6.7 KB

scripts/lib/documents/commands.mjs

View on GitHub
import { archiveReader, loadProfile, openStore } from '../store.mjs';
import { loadAreas } from '../areas.mjs';
import { filesBehind } from '../files.mjs';
import { readFacts } from '../read-facts.mjs';
import { recordUse, weakAnswer } from '../usage.mjs';
import { scanCorpus, verifyPassage } from './corpus.mjs';
import { interleaveSources, lexicalSearch } from './lexical.mjs';
import { validateRetrieval } from './input.mjs';
import { retrieveDocuments } from './retrieve.mjs';
import { renderPacket } from './packet.mjs';
const REFUSED = ['auth', 'forbidden', 'signin'];
const FILES_MS = 1500;

// The files behind the facts, within FILES_MS and the recall deadline; a failure leaves the facts as they are.
async function factFiles(ctx, facts, { profile, deadline }) {
  if (!facts.length) return { files: [], state: 'empty' };
  try {
    const chosen = profile === undefined ? await loadProfile(ctx) : profile;
    return await filesBehind(ctx, facts.slice(0, 8), { profile: chosen, areas: await loadAreas(ctx, chosen), limit: 16,
      deadline: Math.min(deadline, Date.now() + FILES_MS) });
  } catch { return { files: [], state: 'unavailable' }; }
}

export async function recallPacket(ctx, options, { includeFacts = true,
  factsRead = (signal) => readFacts(ctx, { positionals: [options.question], values: { ...options.filters, limit: 8, withTags: true } }, openStore(ctx, { signal, timeoutMs: 16000 })),
  documentsRead = retrieveDocuments, timeoutMs = 19000, profile } = {}) {
  const archive = await archiveReader(ctx, profile);
  const deadline = Date.now() + Math.min(19000, timeoutMs), controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), Math.max(1, deadline - Date.now()));
  let onDocumentTimeout;
  const factPromise = includeFacts ? Promise.resolve().then(() => factsRead(controller.signal)).then(result => ({ facts: result.facts,
    filters: result.filters, factSource: { state: result.facts.length ? 'ok' : 'empty' } })).catch(error => ({ facts: [],
    factSource: REFUSED.includes(error.kind) ? { state: 'denied', reason: error.kind === 'signin' ? 'not signed in to the company app; documents remain usable' : 'fact access refused' }
      : { state: 'unavailable', reason: 'fact memory unavailable; documents remain usable' } }))
    : Promise.resolve({ facts: [], factSource: { state: 'empty', reason: 'not requested' } });
  // A dependency that ignores cancellation cannot hold the packet past its deadline.
  const boundedFacts = Promise.race([factPromise, new Promise(resolve => {
    controller.signal.addEventListener('abort', () => resolve({ facts: [], factSource: { state: 'unavailable', reason: 'fact deadline reached' } }), { once: true });
  })]);
  try {
    const documentPromise = Promise.resolve().then(() => documentsRead(ctx, options, { archive, deadline: deadline - 2000 }))
      .catch(() => ({ documents: [], documentSource: { state: 'unavailable', reason: 'document corpus unavailable' } }));
    const boundedDocuments = Promise.race([documentPromise, new Promise(resolve => {
      onDocumentTimeout = () => {
        let documents = [];
        try {
          const corpus = scanCorpus(ctx, { archive, deadline: Date.now() + 400 });
          documents = interleaveSources(lexicalSearch(corpus, options.question, { ...options, deadline: Date.now() + 800 })
            .map(hit => verifyPassage(ctx, hit, { archive })).filter(Boolean), options.limit);
        } catch { /* unavailable below */ }
        resolve({ documents, documentSource: { state: documents.length ? 'partial' : 'unavailable', reason: 'document deadline reached; verified keyword evidence retained' } });
      };
      controller.signal.addEventListener('abort', onDocumentTimeout, { once: true });
    })]);
    const withFiles = boundedFacts.then(async fact => {
      if (!includeFacts) return fact;
      const { files, state } = await factFiles(ctx, fact.facts, { profile, deadline });
      return { ...fact, files, fileSource: state === 'unavailable' ? { state, reason: 'file history unavailable; facts and documents remain usable' } : undefined };
    });
    const [fact, documents] = await Promise.all([withFiles, boundedDocuments]);
    const rendered = renderPacket({ ...options, ...fact, ...documents,
      filters: Object.fromEntries(Object.entries(fact.filters || options.filters).filter(([key]) => ['tag', 'type', 'slug', 'since', 'until'].includes(key))) }, { json: options.json });
    const usable = ['ok', 'empty', 'partial'].includes(fact.factSource.state) && includeFacts
      || ['ok', 'empty', 'partial'].includes(documents.documentSource.state);
    return { ...rendered, code: usable ? 0 : 1, found: { facts: fact.facts, documents: documents.documents || [], state: fact.factSource.state } };
  } finally { clearTimeout(timer); controller.signal.removeEventListener('abort', onDocumentTimeout); controller.abort(); }
}
const lookup = includeFacts => async (ctx, { positionals, values }) => {
  const options = validateRetrieval(positionals.join(' '), values, { recall: includeFacts });
  const result = await recallPacket(ctx, options, { includeFacts });
  process.stdout.write(result.text); process.exitCode = result.code;
  if (includeFacts) recordUse(ctx, recallUse(options.question, result.found));
};
// A recall as a use count: the facts and their tags it gave, or a miss when a readable memory gave no answer.
function recallUse(words, { facts, documents, state }) {
  const miss = ['ok', 'empty'].includes(state) && weakAnswer(words, [...facts.map(fact => fact.body), ...documents.map(doc => doc.text)]);
  return { command: 'recall', facts: miss ? [] : facts.map(fact => fact.id), topics: miss ? [] : facts.flatMap(fact => fact.tags || []), miss, words };
}
export const DOCUMENT_COMMANDS = { documents: lookup(false), recall: lookup(true) };
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall