Project Scaffold Delivery Console

Introduction

This application provides deterministic scaffold generation for classification and DLP automation projects. It is designed for repeatable output, controlled delivery, and review-first change promotion.

How the system works

• Capture operator inputs for project metadata, template selection, and delivery mode.
• Resolve template and profile settings into deterministic generation instructions.
• Run path-safety and repository guards before write operations.
• Return a stable execution payload with delivery metadata and errors when present.

Delivery modes

• ZIP export: local artifact download with no GitHub authentication requirement.
• Create repository: provision a repository and commit generated scaffold files.
• Existing repository PR: open a branch and pull request without direct default-branch writes.

Typical workflow

• Run in ZIP mode first and inspect generated file structure.
• Adjust template, category, and profile until outputs match expectations.
• Switch to the required GitHub delivery path and validate repository targeting.
• Run orchestration and verify the execution ledger before promotion.

GitHub authentication

• Required OAuth scope: read:user user:email repo.
• Use Re-authorize when token scopes or installation permissions change.
• GitHub delivery controls are disabled when runtime auth variables are missing.

Safety guardrails

• Existing repository updates are pull-request only.
• Path traversal and unsafe output paths are blocked before generation.
• File collisions in existing repositories are skipped rather than overwritten.

Templates and profiles

Templates define structural scaffolding. Category, profile, and prompt-pack selections constrain generated content shape and keep output deterministic across runs.

Output artifacts

• Scaffold files in stable deterministic ordering.
• Baseline repository files when repository delivery modes are selected.
• Execution payload with job state, delivery metadata, and surfaced errors.

Troubleshooting

• GitHub controls unavailable: verify runtime auth variables and restart.
• Repository list empty: check account access, then run Re-authorize.
• Execution failed: inspect the ledger payload, correct inputs, and rerun.