Skip to content

wellwelwel/lagune / .claude/skills/ingest

ingest

Verified

Use before reading any .txt file, whatever its name, and whenever a task builds on GitIngest digests. Checks whether a file is a digest (a whole repository in one file) and surveys, searches, and reads it without loading it whole. Returns only the requested lines, with token estimates and anchors for a reusable synthesis.

tools/types.ts

View on GitHub
export type EntryKind = 'text' | 'binary' | 'empty' | 'symlink';

export type Entry = {
  path: string;
  kind: EntryKind;
  target: string | null;
  lines: string[];
  characters: number;
  noise: boolean;
};

export type Digest = {
  file: string;
  root: string;
  bytes: number;
  entries: Entry[];
  byPath: Map<string, Entry>;
};

export type Probe = { file: string; root: string | null; bytes: number };

export type Scope = {
  under: string[];
  extensions: string[];
  name: string | null;
  noise: boolean;
};

export type Options = {
  scope: Scope;
  terms: string[];
  patterns: string[];
  caseSensitive: boolean;
  context: number;
  limit: number | null;
  perFile: number;
  filesOnly: boolean;
  paths: string[];
  at: string[];
  lines: string | null;
  depth: number;
  sort: 'path' | 'size';
  out: string | null;
  synthesis: string | null;
};

export type Command = (
  digests: Digest[],
  options: Options
) => Promise<string[]>;

export type Range = { start: number; end: number | null };

export type Anchor = { path: string; range: Range };

export type CitedAnchor = { text: string; anchor: Anchor | null };

export type Target = { digest: Digest; entry: Entry; range: Range | null };

export type Stats = { files: number; characters: number };

export type LineTest = (line: string) => boolean;

export type Match = { entry: Entry; line: number };

export type PatternRequest = {
  sources: string[];
  flags: string;
  texts: string[];
};

export type RepetitionScan = {
  output: string;
  escaped: boolean;
  inClass: boolean;
  skip: number;
};

export type OutlineRule = { extensions: string[]; pattern: RegExp };

export type WriteOutcome = { entry: Entry; problem: string | null };
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall