> For the complete documentation index, see [llms.txt](https://www.csvpath.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.csvpath.org/topics/higher-level-topics/organizing-inbound-data/the-three-data-spaces/trusted-publishing.md).

# Trusted Publishing

<figure><img src="/files/mlXSQel4Nn7rJZ0uw9M8" alt="" width="375"><figcaption><p>The trusted publishing area is the most flexible and content rich</p></figcaption></figure>

We refer to the trusted publishing space as the Archive. By default the Archive is at `./archive`, but you can name it anything you like and house it on any of the backend storage systems CsvPath Framework supports. &#x20;

The Archive is the richest, most flexible, and most complex of the data file areas in CsvPath Framework. It is a kind of namespace. In large DataOps groups or companies with many data partners we would recommend using multiple archives in order to make your data estate more manageable. If you use multiple trusted publishing archives they can live together in one backend system or be split over multiple systems of different types.

Within the Archive the first level is a list of named-results. A named-result takes the same name as the named-paths group that generated it. When you ask CsvPath Framework for the named-results using just the plain named-results name, it gives you the results from the most recent run.

Within a named-results directory you can have a set of run directories. (Sometimes we refer to these as runs, run\_dirs, or run homes). Alternatively, you can optionally define a directory structure within a named-results directory that helps you organize results according to how you want to access your data. The organization is defined using the template stored with the named-paths group. &#x20;

Within the template-defined organizational folder you come to a set of run\_dirs named with a datetime. The datestamp in the form `%Y-%m-%d_%H-%M-%S_nn`, where the optional `nn` is a number from `0` to `99` that disambiguates any runs that have the same datestamp. For example: `2025-02-28_14-32-59_0`.

Optionally, the named-results layout template can have one or more suffix directories below the run\_dir. These would only add value only if they help a downstream system better identify what data is available in the run without other downstream data consumers having to browse a larger directory structure above the run\_dir.&#x20;

Below the suffix directories, if any, are the individual csvpath results directories. (These are sometimes referred to as instance directories). There is one instance result directory for each csvpath in the named-paths group that generated the named-results. And collectively these instance directories hold the final output of the run.

CsvPath Framework generates up to seven common files for each csvpath instance. They are:

| File          | Purpose                                                                                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| data.csv      | Holds the matched rows from the file being validated and/or upgraded                                                                                        |
| unmatched.csv | Contains rows that didn't match. These rows could be considered valid, invalid, or just extra, depending on how the run is setup.                           |
| vars.json     | CsvPath Framework allows you to set and use variables in your csvpath statements. These are somewhat similar to session variables in an application server. |
| meta.json     | Contains user-defined metadata, per-csvpath configuration settings, and runtime csvpath info.                                                               |
| errors.json   | A set of detailed error event dictionaries that give user-friendly error messages and developer-friendly data about any validation or csvpath errors.       |
| printouts.txt | Any number of user-defined print statement streams are collected in a multi-section output file.                                                            |
| manifest.json | CsvPath Framework-generated metadata about the run the results come from                                                                                    |

We will dig into these results outputs in many other parts of this documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.csvpath.org/topics/higher-level-topics/organizing-inbound-data/the-three-data-spaces/trusted-publishing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.