Workflow Rule

Workflow Rule
-------------

This utility is a developer convenience. It must not become a public app dependency.

One-source-of-truth fit
-----------------------

The ZIP remains the artifact. The extracted date folder is a local mirror. S3/CloudFront is the hosted mirror.

The watcher does not edit app defaults, playlists, docs, or source code. It only moves the already-generated build into the right places.

Recommended S3 path
-------------------


s3://BUCKET/beta/_daily-builds/YYYY-MM-DD/


Example hosted URL:


https://8k.art/beta/_daily-builds/YYYY-MM-DD/


Safety model
------------

The default config starts in dry-run mode. That makes the first test show the AWS commands without changing S3.

Set this only after verifying paths:


$Settings.DryRun = $false


Why PowerShell first
--------------------

PowerShell is already available on Windows 11, supports silent scheduled tasks, can watch file changes, can extract ZIP files, and can call AWS CLI. This avoids building and maintaining a full GUI app before the workflow is stable.

A future GUI can wrap the same config and scripts.


v002 strict payload rule
------------------------

The uploader is not a generic Downloads-folder uploader.

It only processes:


index_beta_YYYY-MM-DD-v###.zip


and only mirrors approved extracted payload files:


index_beta_YYYY-MM-DD-v###.html
_MyAnythingList-defaults.txt
docs/YYYY-MM-DD/v###/en-us/controllable-parameters.html


Normal Chrome downloads and unrelated ZIP files are ignored. ZIPs with unexpected contents are refused.


v003 no local server stack rule
-------------------------------

This uploader must help people avoid IIS/PHP/MySQL-level setup.

It requires only Windows PowerShell, AWS CLI v2, and configured AWS credentials.

The public app remains standalone. The uploader remains a file mirror convenience layer.


File Explorer timestamp sorting rule
------------------------------------
After extracting an approved daily build, v006 touches the extracted app/defaults/docs payload and local date folder to the current local time so the newest extracted build appears at the top when sorted by Date modified.


Developer-local package timestamp rule
--------------------------------------
Package HHMM must be the actual America/Los_Angeles local time when the artifact is created. Do not invent, estimate, round forward, or use a future timestamp.