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/corpus.mjs

View on GitHub
// Only public knowledge documents in this checkout are searched.
import { execFileSync } from 'node:child_process';
import { createHash } from 'node:crypto';
import { lstatSync, readFileSync, realpathSync, statSync } from 'node:fs';
import { isAbsolute, join, relative, resolve, sep } from 'node:path';
import { knowledgeCopy } from '../knowledge-copy.mjs';

export const COLLECTIONS = {
  wiki: 'Current reusable team guidance; read the original before acting.',
  knowledge: 'Company knowledge: the business, its customers and how the team works; read the original before acting.',
  specs: 'Recorded shipped requirements; compare with current guidance and code.',
  active: 'Proposed work, not necessarily shipped or authoritative.',
  archive: 'Historical decisions and rationale, possibly superseded.',
};
export const SCOPES = { current: ['wiki', 'knowledge', 'specs'], history: ['wiki', 'knowledge', 'specs', 'archive'], active: ['wiki', 'knowledge', 'specs', 'active'], all: Object.keys(COLLECTIONS) };
const CURRENT = ['wiki', 'knowledge', 'specs'];
export const hashText = text => createHash('sha256').update(text).digest('hex');
export const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;

export function sourceRole(path) {
  if (/(?:^|\/)(?:logs?|transcripts?|evidence|cache|\.cache)(?:[./-]|$)/i.test(path)
    || /(?:^|\/)(?:review|evidence|log|transcript)(?:[.-][^/]*)?\.md$/i.test(path)) return null;
  if (/^wiki\/(?!people(?:\/|$))[^\\]*\.md$/.test(path)) return 'wiki';
  if (/^knowledge\/(?!people(?:\/|$))[^\\]*(?<!\.mine)\.md$/.test(path)) return 'knowledge';
  if (/^openspec\/specs\/[^\\]*\.md$/.test(path)) return 'specs';
  const match = path.match(/^openspec\/changes\/(archive\/)?([a-z0-9-]+)\/(proposal\.md|design\.md|tasks\.md|specs\/[^\\]+\/spec\.md)$/);
  return match ? match[1] ? 'archive' : 'active' : null;
}
export function sourceChange(path) {
  const slug = path.match(/^openspec\/changes\/(?:archive\/)?([^/]+)\//)?.[1];
  return slug?.replace(/^\d{4}-\d{2}-\d{2}-/, '') || null;
}

// A knowledge page is read inside the copy's real folder, which `knowledge/` links to: no other link is followed.
export function safeSource(root, path, copy = path?.startsWith('knowledge/') ? knowledgeCopy(root) : null) {
  if (!path || isAbsolute(path) || path.includes('\\') || path.split('/').some(part => !part || part === '.' || part === '..')) return null;
  const role = sourceRole(path);
  if (!role || (role === 'knowledge' && !copy)) return null;
  try {
    const base = role === 'knowledge' ? copy : realpathSync(root);
    let file = base;
    for (const part of role === 'knowledge' ? path.split('/').slice(1) : path.split('/')) {
      file = join(file, part);
      if (lstatSync(file).isSymbolicLink()) return null;
    }
    const rel = relative(base, realpathSync(file));
    if (rel.startsWith(`..${sep}`) || rel === '..' || isAbsolute(rel) || !lstatSync(file).isFile()) return null;
    return file;
  } catch { return null; }
}

const NO_ARCHIVE = { list: () => [], files: () => null, read: () => null };
const PART = /^openspec\/changes\/archive\/([^/]+)\/(.+)$/;
// A finished change's part with no file of its own: read inside its packed file, by its old path.
function packedPart(path, archive) {
  const [, folder, part] = path.match(PART) ?? [];
  return folder ? archive.read(folder, part) : null;
}
// Each packed change's parts at their old paths, so it is searched as its folder was; none past the deadline.
const packedPaths = (archive, deadline) => archive.list().filter(each => each.packed)
  .flatMap(({ folder }) => Date.now() < deadline ? (archive.files(folder) ?? []).map(part => `openspec/changes/archive/${folder}/${part}`) : []);

export function scanCorpus(ctx, { listFiles, archive = NO_ARCHIVE, deadline = Date.now() + 4000, maxBytes = 32 * 1024 * 1024, maxFileBytes = 2 * 1024 * 1024 } = {}) {
  const root = realpathSync(ctx.root), copy = knowledgeCopy(root);
  const listed = (cwd, args) => execFileSync('git', ['ls-files', '-z', '--cached', '--others', '--exclude-standard', ...args],
    { cwd, encoding: 'utf8', maxBuffer: 8 * 1024 * 1024, timeout: 3000, windowsHide: true }).split('\0');
  const paths = [...(listFiles ? listFiles(root) : [...listed(root, ['--', 'wiki', 'openspec']),
    ...(copy ? listed(copy, []).filter(Boolean).map(path => `knowledge/${path}`) : [])]), ...packedPaths(archive, deadline)];
  const entries = {};
  let bytes = 0, omitted = 0;
  const priority = { wiki: 0, knowledge: 1, specs: 2, active: 3, archive: 4 };
  for (const path of [...new Set(paths)].sort((a, b) => (priority[sourceRole(a)] ?? 5) - (priority[sourceRole(b)] ?? 5) || a.localeCompare(b))) {
    const role = sourceRole(path);
    if (!role) continue;
    if (Date.now() >= deadline) { omitted++; continue; }
    const file = safeSource(root, path, copy);
    try {
      const packed = !file && role === 'archive' ? packedPart(path, archive) : null;
      if (!file && packed === null) continue;
      const size = file ? statSync(file).size : Buffer.byteLength(packed);
      if (size > maxFileBytes || bytes + size > maxBytes) { omitted++; continue; }
      const text = file ? readFileSync(file, 'utf8') : packed;
      bytes += size;
      entries[path] = { path, role, hash: hashText(text), bytes: Buffer.byteLength(text), text };
    } catch { omitted++; } // A moved file during the scan never invalidates other sources.
  }
  return { root: resolve(root), entries, omitted };
}

export function scopedEntries(corpus, { scope = 'current', change } = {}) {
  return Object.values(corpus.entries).filter(entry => SCOPES[scope]?.includes(entry.role)
    && (!change || CURRENT.includes(entry.role) || sourceChange(entry.path) === change));
}

// Final validation reopens originals: a ranked hit is only a candidate.
export function verifyPassage(ctx, candidate, { beforeRead = () => {}, archive = NO_ARCHIVE } = {}) {
  beforeRead(candidate);
  const file = safeSource(ctx.root, candidate.path);
  const packed = !file && sourceRole(candidate.path) === 'archive' ? packedPart(candidate.path, archive) : null;
  if (!file && packed === null) return null;
  try {
    if ((file ? statSync(file).size : Buffer.byteLength(packed)) > 2 * 1024 * 1024) return null;
    const text = file ? readFileSync(file, 'utf8') : packed, hash = hashText(text), lines = text.split(/\r?\n/);
    if (hash !== candidate.hash || !Number.isInteger(candidate.startLine) || !Number.isInteger(candidate.endLine)
      || candidate.startLine < 1 || candidate.endLine < candidate.startLine || candidate.endLine > lines.length) return null;
    const excerpt = lines.slice(candidate.startLine - 1, candidate.endLine).join('\n');
    if (candidate.text !== excerpt) return null;
    return { ...candidate, role: sourceRole(candidate.path), hash, text: excerpt, freshness: 'verified',
      reference: `${candidate.path}:${candidate.startLine}` };
  } catch { return null; }
}
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