# PrintToVeraeTimeStamp

[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)

PrintIt desktop/CLI path: stamp documents via Verae edge billing (xVerae keys).

## Table of Contents

- [Background](#background)
- [Install](#install)
- [Usage](#usage)
- [Packaging](#packaging)
- [Contributing](#contributing)
- [License](#license)

## Background

Default channel is zapier (zap.verae.ai) with x-billing-channel=printit.
Desktop and print workflows share the same commercial meter as portal API customers.


**Co-contributors:** Grok (xAI), George Lambert, Scott "R00tPiG Security" Lindsey — Verae Inc. ([verae.com](https://verae.com)).

## Install

```sh
go build ./...
```

## Usage

```sh
verae-print stamp --channel=zapier file.pdf   # default billed path
verae-print serve                             # IPP helper + loopback status
verae-print tray-status                       # held/key/helper snapshot
verae-print tray-status --open                # open http://127.0.0.1:8631/queue
verae-print menubar                           # PT-W3/PT-06: tray (Win) or menu bar (macOS)
verae-print menubar --install                 # login presence (Win Startup / macOS LaunchAgent)
verae-print menubar --uninstall               # remove login presence
verae-print pending --html                    # offline queue page
# Live while helper runs: GET /queue (HTML), GET /status (JSON), GET / (health)
# Windows tray: platform/windows/scripts/verae-tray.ps1
# Windows Startup: platform/windows/scripts/install-tray-startup.ps1
# Windows Start Menu (WiX-free stub): platform/windows/scripts/build-tray-startmenu.ps1
# macOS menu bar: platform/macos/menubar/run-menubar.sh
# macOS durable LaunchAgent assets: ~/Library/Application Support/Verae/menubar/
# macOS optional .app (unsigned): platform/macos/menubar/build-menubar-app.sh
# macOS notarization steps (docs only): platform/macos/menubar/README.txt
# Direct chain only with VERAE_ALLOW_DIRECT_VERAE=1
```

## Packaging

Tray, menu bar, CERT-01 digests, version stamps (`HelperVersion` **0.3.6**), and IPP GET vs POST split:

- [docs/PACKAGING.md](docs/PACKAGING.md) — Windows tray (no elevated MSI), macOS LaunchAgent / unsigned `.app` / notarization (docs only), `pending` / `tray-status` / `menubar`, statuslang notify titles, hold ≠ evidence, CERT-01 web viewer.
- [site/printit.verae.ai/certificate.html](site/printit.verae.ai/certificate.html) — CERT-01 branded certificate HTML (plum/gold, multihash when present).

## Contributing

Questions: open an issue on the project Forgejo/GitHub remote, or contact Verae engineering.
PRs are accepted when they include tests and do not leak secrets.

## License

UNLICENSED © Verae Inc. (verae.com)