PostPhone User String
A quiet protocol that signals focus, intentional computing, and steady progress.
Version 0.1.0
PostPhone/1.0 (Desktop; NoCell; Progress)
Context
The spec folder defines the structure, the philosophy folder names the intention, the reference folder offers examples, and the implementations folder keeps terse generators in sync with the idea.
Format
The string follows the familiar AppName/Version (Environment; Attributes) rhythm. Names are short, readable, and tuned to the principle you want to express.
Metadata
Tooling context lives under .codex/settings.json and metadata/repro.json. Keep model_description aligned with the repo’s narrative so anyone can understand why the profile exists.
Quiet Truth
The table below names every surface this branch touches so the story stays transparent.
| Area | Update | Why it matters |
|---|---|---|
| README | Documented the Python package, optional CLI extras, and quiet intent. | Orients contributors to the twin spec + utility focus. |
| pyproject.toml | Moved Click into base dependencies and declared dev extras. | The CLI and tests now install without separate files. |
| userstring/cli.py | Imported defaults lazily, reused constants, kept fallback tidy. | Ensures single source for defaults and minimal dependency churn. |
| userstring/generator.py | Sanitizes inputs, rejects unsafe characters, and avoids injections. | Shields the UA string from control characters or delimiters. |
| userstring/parser.py | Compiled a strict regex and anchored it with fullmatch. |
Parses only well-formed strings, preventing trailing noise. |
| userstring/constants.py | Derives DEFAULT_VERSION from package metadata. |
No drift between constants and package version. |
| Version truth | Reflects the actual package version (0.1.0) so the story stays honest. | Clarifies what “PostPhone/1.0” means in the repository context. |
| examples/ + tests/ | Wrapped example in main(), added default test, gitkeep placeholders. |
Keeps imports side-effect free and ensures coverage + clean repo. |
| Webpage | Represents the quiet truth in a calm table and tone. | Shows the reach of the project without visual noise. |