UnGathered.com

About

Sat, 24 Oct 2026 00:00:00 +0000

UnGathered is a local collection checker. It starts with items selected from a folder, such as one directory per product or one Markdown file per article. A JSON manifest declares what each item should have beside it. The scanner reports the missing companions and failed checks, while keeping operational errors separate from ordinary gaps.

A manufacturing pack might need a specification, drawing and inspection record. An article might need a matching image file and a line crediting its photographer. The engine applies explicit naming and content rules. It does not guess what a document means or decide whether an image is legally usable. A folder can satisfy its declared rules and still be incomplete under a rule nobody wrote down.

Contact

Sat, 24 Oct 2026 00:00:00 +0000

Write to info@ungathered.com about UnGathered, collection rules or integration work.

For a reproducible problem, include the version, operating system, a manifest and a small folder layout that you can share. Reports contain paths and diagnostics, so inspect them before attaching private document packs. The code repository contains the current implementation and reference material.

Demo

Sat, 24 Oct 2026 00:00:00 +0000

A collection can look busy and still be missing something important. Choose a recorded scan below to see the expected companions and the gaps UnGathered reported. These are generated examples with placeholder documents and images. The manufacturing and publishing gap reports were produced by a downloaded UnGathered 0.1.0 binary; the repaired fixture is from the repository’s recorded demonstration.

This page displays saved reports. It does not inspect your computer, run a scan in the browser or repair files. The incidental absolute root path has been omitted from the display data; the counts and requirement results are unchanged. Both gap examples contain two selected items, with one complete item and two failed requirements.

Download

Sat, 24 Oct 2026 00:00:00 +0000

UnGathered is released under Apache 2.0. Each archive includes the executable, example manifests and reference files, with license notices. Choose the build for your operating system and processor.

Linux on Intel or AMD 64-bit

Linux on ARM64

macOS on Intel

macOS on Apple Silicon

Windows on Intel or AMD 64-bit

The SHA256SUMS manifest lets you check an archive after downloading it. Permanent download links follow the latest full release; versioned files remain on the releases page.

Quick Start

Sat, 24 Oct 2026 00:00:00 +0000

Unpack the archive for your operating system from the download page. The executable, example manifests and reference are included. UnGathered needs no service to run alongside it. This example creates a new, deliberately incomplete document pack:

mkdir -p collection/products/widget
printf 'Specification placeholder\n' > collection/products/widget/specification.pdf
./ungathered --manifest examples/manufacturing.json --root collection

The filenames illustrate document roles; that placeholder is not a real PDF. The scan should return exit 1 and report the missing drawing.pdf and inspection.csv. The rule also checks that the specification is a nonempty regular file. It does not parse PDF contents or decide whether the specification is adequate.

Reference

Sat, 24 Oct 2026 00:00:00 +0000

A version 1 JSON manifest contains named collections. Each collection selects a relative anchor glob with items, chooses file or directory as its kind, and lists named requirements under require. A minimum of one selected item is assumed unless min_items explicitly says otherwise. Manifest keys use lowercase ASCII spelling. Unknown fields, duplicate keys, unsupported globs and invalid regexes are rejected.

Each requirement gives an expected path relative to the scan root. The variables are {item}, the full relative anchor path; {name}, its basename; {stem}, the basename with its last extension removed; and {dir}, its parent directory. For articles/cafe.md those values are articles/cafe.md, cafe.md, cafe and articles. Required paths are literal after expansion, without wildcard searching.

UnGathered Checks Article Images and Photo Credit Lines

Sat, 24 Oct 2026 00:00:00 +0000

A missing image is often obvious in the browser. A missing credit line can be much easier to overlook, especially when the article itself reads well and the photo has already been selected. The publishing example gives both expectations a place in a local collection rule, before treating a folder of article assets as ready.

The generated collection has two Markdown articles, cafe.md and harbor.md. The manifest selects articles/*.md, expects an image at images/{stem}.jpg and looks for a Photo credit: line followed by text inside each article. Cafe has both. Harbor has neither. One recorded scan by a downloaded UnGathered 0.1.0 binary on Linux x86_64 produces four checks: two present requirements, a missing image and a content_mismatch for the credit rule. There is one complete item, two gaps and no operational errors. The command exits 1.

UnGathered Finds Missing Companions in Local Collections

Sat, 24 Oct 2026 00:00:00 +0000

The inspection record is the sort of file nobody notices until somebody needs it. A product folder can contain drawings, notes and several revisions of a specification, while still lacking the one document needed to release a job. UnGathered starts with that awkward possibility. Its first release checks local collections against explicit rules and reports the companions that are missing or fail their declared checks.

A small JSON manifest supplies the expectations. It selects items, such as one directory per product, and names the files each item needs. A rule can require a nonempty drawing, a directory for supporting material or a line of credit text inside an article. The scanner handles file and directory anchors, expands companion paths and keeps each result visible in text, JSON or a self-contained HTML report.

UnGathered Finds Missing Records in a Manufacturing Pack

Sat, 24 Oct 2026 00:00:00 +0000

Two product folders can look equally ready at a glance. In the generated manufacturing example, alpha has its specification, drawing and inspection record. Beta has a specification and a drawing filename too, but the drawing is empty and the inspection record is absent. A file listing shows plenty of activity. The declared checklist gives a more useful answer.

The example manifest selects directories matching products/* and requires three nonempty regular files inside each one: specification.pdf, drawing.pdf and inspection.csv. In one recorded scan with a downloaded UnGathered 0.1.0 binary on Linux x86_64, two selected items produce six checks. Four pass, one fails with too_small and one with missing. Alpha is complete under those rules; beta is not. The process exits 1, identifying declared gaps rather than an operational failure.

UnGathered Names the Things That Have Not Been Collected

Sat, 24 Oct 2026 00:00:00 +0000

UnGathered begins with the part of a collection that is easiest to overlook: the things that have not been gathered. A folder can look substantial because it contains many files. That visual impression says very little about whether the particular companions needed for a job are present.

The name fits the direction of the search. A normal listing starts with the files on disk and shows them to you. UnGathered starts with selected items and declared expectations, then asks which checks fail. The missing drawing receives a name in the report even though there is no drawing file to list. An empty inspection record can receive attention without pretending that its filename proves the work was recorded.

UnGathered Starts With What a Collection Should Contain

Sat, 24 Oct 2026 00:00:00 +0000

A folder listing answers a straightforward question: which files are here? Unfortunately, it cannot tell you which expected files never arrived. That needs another source of information. Someone has to know that a product needs an inspection record, or that an article’s image should have a matching credit line. UnGathered gives those expectations a small, executable form.

The first concept is the anchor. It is an existing item selected by a relative glob: products/* for product directories, for instance, or articles/*.md for article files. Each anchor carries the requirements declared for its collection. With a product directory named products/widget, a path rule such as {item}/drawing.pdf expands to products/widget/drawing.pdf. The rule states the relationship rather than searching vaguely for a similar filename.

UnGathered Tests Gaps Without Hiding Scan Errors

Sat, 24 Oct 2026 00:00:00 +0000

A collection checker can fail in an especially unhelpful way: it can overlook the items it was supposed to check and then announce that everything is complete. UnGathered’s tests therefore pay attention to the route into a result, including anchor selection and errors, rather than only checking a report’s final totals.

The automated tests cover required files and directories, minimum sizes, content patterns, path variables, missing parents and wrong types. They also check deterministic ordering, input preservation, HTML escaping and report output reservation. Empty collections fail by default. A content file above the configured read limit produces an operational error, without matching against a silently shortened prefix.