pressto 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6638b7737d249c98f90985929f36e7c667d4da36b34832e723b99de94193932e
+  data.tar.gz: 7f43192670d78811762764af34f1ccfd14f5b0a0020a98762f48fafaf00919cc
+SHA512:
+  metadata.gz: abca6a6f09fff3cd32ca3c29fab4ed3b610787383fab0072dc36b25efbbe043e22385ef6313944b5abd1f4134d2e33d37369b8c8940ac5a6c09ab775a9e2f246
+  data.tar.gz: 765bcf8bf635cf7e1fa64d9aedad1a4fb4ede42e5e10f5e9b12685f6c40eb049e9ca5bef7e90d75fc000c34ecdcee5965b113e884ce3c0ad1e96007aef8cae59

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to Pressto are documented here. Format loosely follows
+[Keep a Changelog](https://keepachangelog.com/); this project uses [SemVer](https://semver.org/).
+
+## [0.0.1] - 2026-07-07
+
+### Added
+- Reserve the `pressto` gem name on RubyGems.
+- Establish the `Pressto` module namespace and error hierarchy
+  (`Pressto::Error`, `Pressto::GenerationError`).
+- Project skeleton with RSpec, Rake, and RuboCop wiring.

data/README.md

@@ -0,0 +1,50 @@
+# Pressto
+
+**Deterministic puzzle & activity book generator for print-on-demand publishing.**
+
+Pressto turns puzzle definitions into print-ready book interiors (Amazon KDP PDFs). It is the
+generation engine behind the [Bright Grid Press](https://github.com/borisano/pressto) catalog.
+
+> **Status: 0.0.x — name reservation.** This release establishes the gem name and the module
+> namespace. The engines are being built test-first; see the roadmap below.
+
+## What it will do
+
+One gem, many engines — each grouping the puzzle types that share generation machinery:
+
+| Engine | Types | Notes |
+|---|---|---|
+| Grid search | word search, number search | themed word lists; language-independent number grids |
+| Sudoku family | classic, killer, jigsaw, diagonal | one solver core, variant constraints |
+| Kakuro | cross-sums | constraint-solver moat |
+| Cryptogram | substitution ciphers | public-domain quote corpus |
+| Maze | kids mazes (themed, masked) | provable difficulty grading |
+| Math worksheet | color-by-number, drills | grade-banded, curriculum-checked |
+| Crossword | fill-in (phase 1), codeword | uniqueness-proved |
+| Bible content | verse cloze, who-said-it, memorization | retrieval-only from scripture text |
+| Guided journal | keepsake / memory journals | prompt curation |
+| Prompt content | would-you-rather, jokes, riddles | curated, screened |
+
+Every generated puzzle is **software-verified**: solvable, uniquely solvable (where the type
+requires it), difficulty-graded by a solving-technique simulator, deduplicated against a
+registry, and screened for unfortunate content.
+
+## Design principles
+
+- **Deterministic:** `generate(params, seed:)` is a pure function — same inputs produce a
+  byte-identical result. No wall-clock timeouts in generation logic.
+- **Standard contract:** every engine emits the same JSON-serializable envelope.
+- **TDD, always:** failing test first; edge cases are catalogued and each has a named test.
+
+Full specifications and build order live in the project's `technical_planning/` documents.
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec
+```
+
+## License
+
+Proprietary — all rights reserved. Not licensed for redistribution.

data/lib/pressto/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Pressto
+  VERSION = "0.0.1"
+end

data/lib/pressto.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "pressto/version"
+
+# Pressto — a deterministic generator for puzzle and activity book interiors,
+# producing print-ready PDFs for Amazon KDP (and dual-listing on Etsy).
+#
+# This 0.0.x line reserves the gem name. The full engine set (word/number search,
+# sudoku family, kakuro, cryptograms, mazes, math worksheets, fill-ins, Bible
+# content, guided journals, prompt content) is specified in the project's
+# technical_planning documents and is built test-first per IMPLEMENTATION_STANDARDS.
+module Pressto
+  # Base class for all Pressto errors.
+  class Error < StandardError; end
+
+  # Raised when generation cannot produce a valid puzzle within its deterministic
+  # budget. Carries machine-readable context (reason, seed, params) so a failed
+  # book build is reproducible.
+  class GenerationError < Error; end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: pressto
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Bright Grid Press
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: 'Pressto generates print-ready puzzle and activity book interiors — word
+  search, number search, sudoku (classic, killer, jigsaw), kakuro, mazes, cryptograms,
+  fill-ins, math worksheets, and more — as Amazon KDP-ready PDFs. Every puzzle is
+  software-verified: solvable, uniquely solvable where applicable, difficulty-graded,
+  and deduplicated. This 0.0.x line reserves the name while the engines are built.'
+email:
+- borisano@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- lib/pressto.rb
+- lib/pressto/version.rb
+homepage: https://github.com/borisano/pressto
+licenses: []
+metadata:
+  homepage_uri: https://github.com/borisano/pressto
+  source_code_uri: https://github.com/borisano/pressto
+  changelog_uri: https://github.com/borisano/pressto/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Deterministic puzzle and activity book generator for print-on-demand publishing.
+test_files: []