wellwelwel/lagune / .claude/skills/ingest
ingest
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.6 KB |
| tools/anchor.ts | script | 696 B |
| tools/commands/anchors.ts | script | 1.6 KB |
| tools/commands/extract.ts | script | 2.6 KB |
| tools/commands/files.ts | script | 1.1 KB |
| tools/commands/is.ts | script | 600 B |
| tools/commands/outline.ts | script | 3.1 KB |
| tools/commands/overview.ts | script | 3.5 KB |
| tools/commands/read.ts | script | 1.6 KB |
| tools/commands/search.ts | script | 3.6 KB |
| tools/commands/tree.ts | script | 2.2 KB |
| tools/digest.ts | script | 4.4 KB |
| tools/fail.ts | script | 81 B |
| tools/format.ts | script | 798 B |
| tools/hidden.ts | script | 474 B |
| tools/ingest.ts | script | 5.8 KB |
| tools/package.json | manifest | 23 B |
| tools/paths.ts | script | 433 B |
| tools/pattern/check.ts | script | 1.8 KB |
| tools/pattern/match.ts | script | 1.3 KB |
| tools/pattern/worker.ts | script | 491 B |
| tools/selection.ts | script | 2.2 KB |
| tools/stats.ts | script | 567 B |
| tools/types.ts | script | 1.7 KB |
tools/commands/search.ts
View on GitHubimport type { Command, Entry, LineTest, Match, Options } from '../types.ts';
import { fail } from '../fail.ts';
import { clip, displayPath, formatCount, omitted } from '../format.ts';
import { matchPatterns } from '../pattern/match.ts';
import { selectedEntries } from '../selection.ts';
const MAX_LINE_WIDTH = 240;
const DEFAULT_LIMIT = 60;
const termMatcherFor = (options: Options): LineTest => {
const terms = options.caseSensitive
? options.terms
: options.terms.map((term) => term.toLowerCase());
return (line) => {
const haystack = options.caseSensitive ? line : line.toLowerCase();
return terms.some((term) => haystack.includes(term));
};
};
const matchesIn = (
entry: Entry,
matchesTerm: LineTest,
patternLines: Set<number>
): Match[] =>
entry.lines.flatMap((line, index) =>
patternLines.has(index + 1) || matchesTerm(line)
? [{ entry, line: index + 1 }]
: []
);
const contextOf = (match: Match, context: number): string[] => {
const first = Math.max(1, match.line - context);
const last = Math.min(match.entry.lines.length, match.line + context);
return match.entry.lines
.slice(first - 1, last)
.map(
(line, index) =>
` ${first + index}${first + index === match.line ? ':' : '-'} ${clip(line, MAX_LINE_WIDTH)}`
);
};
export const search: Command = async (digests, options) => {
if (options.terms.includes('')) fail('--term cannot be empty');
if (options.terms.length === 0 && options.patterns.length === 0)
fail('search needs at least one --term or --pattern');
const candidates = digests.flatMap((digest) =>
selectedEntries(digest, options).map((entry) => ({ digest, entry }))
);
const patternLines = await matchPatterns(
candidates.map(({ entry }) => entry),
options.patterns,
options.caseSensitive
);
const matchesTerm = termMatcherFor(options);
const hits = candidates
.map(({ digest, entry }, index) => ({
digest,
entry,
found: matchesIn(entry, matchesTerm, patternLines[index]),
}))
.filter(({ found }) => found.length > 0);
const total = hits.reduce((sum, { found }) => sum + found.length, 0);
const header = `${formatCount(total)} matches in ${formatCount(hits.length)} files`;
if (options.filesOnly) {
const ranked = [...hits].sort(
(left, right) => right.found.length - left.found.length
);
const limit = options.limit ?? DEFAULT_LIMIT;
return [
header,
...ranked
.slice(0, limit)
.map(
({ digest, entry, found }) =>
` ${displayPath(digests, digest, entry.path)} ${formatCount(found.length)}`
),
...omitted(ranked.length - limit, ', narrow with --under or --ext'),
];
}
const limit = options.limit ?? DEFAULT_LIMIT;
const blocks = hits.reduce<{ lines: string[]; shown: number }>(
(state, { digest, entry, found }) => {
const budget = Math.min(options.perFile, limit - state.shown);
if (budget <= 0) return state;
const shown = found.slice(0, budget);
return {
shown: state.shown + shown.length,
lines: [
...state.lines,
`${displayPath(digests, digest, entry.path)} (${formatCount(found.length)})`,
...shown.flatMap((match) => contextOf(match, options.context)),
...omitted(
found.length - shown.length,
' in this file, narrow the search or read it'
),
],
};
},
{ lines: [], shown: 0 }
);
return [
header,
...blocks.lines,
...omitted(
total - blocks.shown,
', list files with --files-only, or narrow with --under or --ext'
),
];
};
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |