Skip to content

Type-safe string and collection concatenation with proven bounds - built on the proven library

License

Notifications You must be signed in to change notification settings

hyperpolymath/proven-concat

proven-concat

Composable "concat blocks" built from the proven library.

Overview

proven-concat is a catalog of safe, reusable compositions of proven modules. The goal is to make it trivial to assemble a project "base" (CLI tools, API cores, router logic, config loaders, etc.) by concatenating verified components with minimal glue.

Think of it as "unbreakable gist parts" you can combine to get a working, safe core fast.

What it is (and is not)

  • It is a curated set of compositions ("concat blocks") built from proven modules.

  • It is not a server framework or runtime. You plug these cores into your preferred runtime (Idris net libs, FFI, or proven-io).

Concat Blocks (by category)

  • Input and CLI: SafeArgs, SafeEnv, SafePath, SafeFile, SafeCommand

  • Data formats: SafeJson, SafeYAML, SafeTOML, SafeCSV, SafeXML, SafeHtml, SafeMarkdown

  • Web/API core: SafeHTTP, SafeHeader, SafeUrl, SafeCookie, SafeContentType, SafeJWT, SafeOAuth, SafeRateLimiter, SafeWebhook

  • Networking/security: SafeNetwork, SafeDNS, SafeCert, SafeSSH, SafePassword, SafeCrypto, SafeChecksum

  • State and storage: SafeStateMachine, SafeTransaction, SafeQueue, SafeLRU, SafeBloom

  • Scheduling/resilience: SafeCron, SafeRetry, SafeCircuitBreaker

  • Misc utilities: SafeSchema, SafeTemplate, SafeLog, SafeUUID, SafeDateTime

Ready-made Compositions (examples)

  • safe-config-loader: SafeArgs + SafeEnv + SafePath + SafeFile + (JSON/TOML/YAML) + SafeSchema

  • safe-webhook-core: SafeHTTP + SafeHeader + SafeUrl + SafeContentType + SafeJson + SafeJWT + SafeRateLimiter + SafeLog

  • safe-router-table: SafeUrl + SafeRegex + SafeHeader + SafeContentType

  • safe-cli-pipeline: SafeArgs + SafeCSV/SafeJson + SafeFile + SafeChecksum + SafeLog

  • safe-scheduler-core: SafeCron + SafeRetry + SafeCircuitBreaker + SafeRateLimiter

See docs/concat-catalog.adoc for the full catalog and notes.

Where to Start

Next Steps (Suggested)

  • Implement real logic in the four remaining core modules (Webhook/Router/CLI/Scheduler).

  • Replace placeholder types in ConfigLoader with concrete schema-validated types.

  • Add proven-concat.ipkg exports and a minimal build/test harness.

Release Milestones (Initial)

v0.0.1 - Scaffold

  • Repository identity set (name, README, STATE, roadmap)

  • Initial concat catalog document

  • Enumerate core proven modules by category

v0.1.0 - Recipes

  • 5-10 concrete concat recipes with minimal glue

  • Runtime attachment notes (how to plug into IO)

  • Example: config loader core and webhook core

v1.0.0 - Stable Catalog

  • Full coverage of proven modules with intent tags

  • 3-5 mini-program cores with usage notes

  • Clear compatibility/versioning policy

v10.0 - Ecosystem Standard

  • Auto-generated catalog from proven metadata

  • Community contribution process and validation checks

  • Long-term stability guarantees for core recipes

License

PMPL-1.0 (Palimpsest-MPL-1.0)

About

Type-safe string and collection concatenation with proven bounds - built on the proven library

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •