From 42415ba47c653e1b59dd8fa5362066910fc71daa Mon Sep 17 00:00:00 2001
From: robojerk <rob@raines.xyz>
Date: Wed, 27 Aug 2025 19:42:32 -0700
Subject: [PATCH] added todo.txt

---
 src-tsp/main.tsp |  6 ++-
 todo.txt         | 98 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 102 insertions(+), 2 deletions(-)
 create mode 100644 todo.txt

diff --git a/src-tsp/main.tsp b/src-tsp/main.tsp
index c7cbba0..5c166a2 100644
--- a/src-tsp/main.tsp
+++ b/src-tsp/main.tsp
@@ -24,15 +24,17 @@ model Recipe {
 
   /**
    * The [OCI](https://opencontainers.org/) image to base your custom image on.
-   * Only atomic Fedora images and those based on them are officially supported.
+   * For Fedora: Only atomic Fedora images and those based on them are officially supported.
    * Universal Blue is recommended. [A list of Universal Blue's images](https://universal-blue.org/images/) can be found on their website
+   * For Debian: Debian 13 (trixie) and newer releases are supported, including sid (unstable).
    * BlueBuild-built images can be used as well.
    */
   `base-image`: string;
 
   /**
    * The tag of the base image to build on.
-   * Used to select a version explicitly (`40`) or to always use the latest stable version (`latest`).
+   * For Fedora: Used to select a version explicitly (`40`) or to always use the latest stable version (`latest`).
+   * For Debian: Use codenames like `trixie` (Debian 13), `forky` (Debian 14), or `sid` (unstable).
    * A list of all available tags can be viewed by pasting your `base-image` url into your browser.
    */
   `image-version`: string | integer;
diff --git a/todo.txt b/todo.txt
new file mode 100644
index 0000000..50714ee
--- /dev/null
+++ b/todo.txt
@@ -0,0 +1,98 @@
+# Blue-Build Schema Debian Support Tasks
+
+## Overview
+This file contains tasks specific to the blue-build-schema project for adding Debian support.
+
+## Current Status
+✅ **COMPLETED**: Created apt.tsp schema (replaces dnf.tsp)
+✅ **COMPLETED**: Created apt-ostree.tsp schema (replaces rpm-ostree.tsp)
+✅ **COMPLETED**: Updated main.tsp with Debian support
+✅ **COMPLETED**: Updated modules/index.tsp with new schemas
+✅ **COMPLETED**: Added Debian base image documentation
+✅ **COMPLETED**: Added Debian version support documentation
+
+## Remaining Tasks
+
+### Schema Validation (HIGH PRIORITY)  ( Untested )
+- [ ] Test apt.tsp schema validation
+- [ ] Test apt-ostree.tsp schema validation
+- [ ] Test main.tsp schema validation
+- [ ] Validate schema compatibility with existing modules
+- [ ] Test schema generation and JSON output
+
+### Schema Testing  ( Untested )
+- [ ] Test schema with valid Debian configurations
+- [ ] Test schema with invalid configurations (error handling)
+- [ ] Test schema with edge cases
+- [ ] Validate schema against example recipes
+- [ ] Test schema versioning and backward compatibility
+
+### Schema Generation
+- [ ] Generate JSON schemas from TypeScript definitions
+- [ ] Validate generated schemas
+- [ ] Test schema loading in validation tools
+- [ ] Verify schema documentation generation
+- [ ] Test schema integration with build tools
+
+### Documentation Updates
+- [ ] Update blue-build-schema/README.md with Debian support
+- [ ] Add Debian-specific schema examples
+- [ ] Document schema validation rules
+- [ ] Create schema migration guide
+- [ ] Add Debian-specific field documentation
+
+### Integration Testing
+- [ ] Test schema integration with blue-build-cli
+- [ ] Test schema integration with blue-build-modules
+- [ ] Validate schema in end-to-end builds
+- [ ] Test schema error reporting
+- [ ] Verify schema validation in module execution
+
+### Advanced Schema Features
+- [ ] Add Debian-specific validation rules
+- [ ] Implement conditional schema validation
+- [ ] Add Debian version compatibility checking
+- [ ] Support for Debian-specific field types
+- [ ] Add schema migration tools
+
+## Schema-Specific Tasks
+
+### apt.tsp Schema
+- [ ] Validate PPA repository field definitions
+- [ ] Test backports field validation
+- [ ] Verify task-install field structure
+- [ ] Test package specification validation
+- [ ] Validate repository cleanup field
+
+### apt-ostree.tsp Schema
+- [ ] Test ostree-specific field validation
+- [ ] Validate package replacement structure
+- [ ] Test repository field definitions
+- [ ] Verify key management fields
+- [ ] Test optfix field validation
+
+### Main Schema Updates
+- [ ] Validate Debian base image references
+- [ ] Test Debian version field handling
+- [ ] Verify platform support for Debian
+- [ ] Test module compatibility validation
+- [ ] Validate Debian-specific documentation
+
+## Build and Testing
+- [ ] Build TypeScript schemas
+- [ ] Run schema validation tests
+- [ ] Test schema generation pipeline
+- [ ] Validate schema output format
+- [ ] Test schema versioning
+
+## Dependencies
+- TypeScript compiler must be available
+- Schema generation tools must be functional
+- Validation tools must support new schemas
+- Integration with other projects must be tested
+
+## Notes
+- All core schemas are implemented and ready for validation
+- Focus should be on testing and validation
+- Schemas maintain compatibility with existing module structure
+- TypeScript definitions are complete and ready for use