diff --git a/README.md b/README.md index d5faed9..bf161ae 100644 --- a/README.md +++ b/README.md @@ -137,3 +137,18 @@ important source excerpts and explicit test limits. See the Start with the [organized handbook](docs/handbook.md) for current usage, design, security and test guidance. Reviewed downloadable editions: [project-guide.docx](docs/reports/project-guide.docx) · [validation-review.docx](docs/reports/validation-review.docx) · [validation-evidence.xlsx](docs/reports/validation-evidence.xlsx). [Publication identities and source scope](docs/reports/publications.json) · [Documentation validation record](docs/reports/documentation-refresh-2026-11-09.md). Historical results retain their own tested revision and date. + +## Current Windows application guide + +The [version 0.4.4 illustrated guide](docs/reports/windows-application-guide-0.4.4.docx) explains the actual +installed application with two real screenshots, a worked user workflow, important +source excerpts and observed validation. Read the [dated delivery report](docs/reports/installed-windows-2026-11-10.md) +and [byte and page review](docs/reports/windows-application-guide-0.4.4.json) for exact scope. Historical Office +editions remain available with their original baselines. + +New documentation files: + +- [docs/reports/windows-application-guide-0.4.4.docx](docs/reports/windows-application-guide-0.4.4.docx): Individually reviewed four-page installed application guide with actual screenshots, worked workflow, immutable source excerpts and limits. +- [docs/reports/windows-application-guide-0.4.4.json](docs/reports/windows-application-guide-0.4.4.json): Exact Word, actual screenshot and reviewed page digests plus observed source-specific validation results. +- [docs/screenshots/installed-0.4.4/desktop-workspace.png](docs/screenshots/installed-0.4.4/desktop-workspace.png): Actual installed application synthetic-profile screenshot: Installed developer workspace. +- [docs/screenshots/installed-0.4.4/desktop-source-inspector.png](docs/screenshots/installed-0.4.4/desktop-source-inspector.png): Actual installed application synthetic-profile screenshot: Verified source inspection. diff --git a/docs/reports/installed-windows-2026-11-10.md b/docs/reports/installed-windows-2026-11-10.md new file mode 100644 index 0000000..b4ca78e --- /dev/null +++ b/docs/reports/installed-windows-2026-11-10.md @@ -0,0 +1,47 @@ +# Installed Windows application validation 10 November 2026 + +By Jason Stys. This edition documents actual published **0.4.4** installed +bytes built from `8a533a0b9838b994c18ec0475d91a4f8db1be6fa`. Earlier Office editions retain their +historical source baselines and byte identities. + +## Observed results + +All 12 downloaded assets matched provider/sidecar hashes; all 3 archives carried the exact 0.4.4 source manifest. Actual installed runtime is CPython 3.14.10/Electron 44.11. + +The full installed registration, WebCrypto unlock, editor, source inspection and 48-category journey passed. Both complete saved revisions also survived a real 0.4.3 to 0.4.4 same-account vault upgrade. + +The journey checked vault lock, owned service drain, sealing and actual service and bootloader exit. + +422 source tests,2 Windows platform skips and 28 subtests passed, with 85.13 percent coverage at the unchanged 80 percent controller/training floor. Current main/compiler/package/CodeQL workflows passed. + +Actual target exits 0, 1, 2, 7, 255 and malformed input 2 were measured; argument rejection, report write failure and timeout were blocked. + +## Illustrated workflow and implementation + +The [four-page application guide](windows-application-guide-0.4.4.docx) contains actual installed +application screenshots, prepared inputs used within the full app, operating +steps and important code excerpts from the immutable runtime source. Every page +was inspected and the OOXML schema passed validation. The [review manifest](windows-application-guide-0.4.4.json) +records Word, screenshot, source and rendered-page identities. + +## User data and limits + +Use the matching versioned Windows installer and its SHA256 sidecar from Releases. The existing per user installation and shortcut are retained; no IntelliJ, system Python or package manager setup is needed to open the app. + +Account archives live separately in the OS user application data directory named CodeFlowStudioAccounts. Preserve the complete directory and your private vault phrase before a later upgrade. Login recovery does not imply recovery of a lost encryption phrase. + +Local compilation needs a working isolated engine and matching 0.4.4 worker image. Hosted compiler checks passed; Docker on this PC was unchanged. + +Measured instrumentation does not mean 100 percent line coverage or proven correctness. Same identity file bindings check consistency and are not tamper proof attestation of a malicious worker target. Unused candidates require developer review. + +Unsigned packages trust the local OS and service while unlocked. Synthetic upgrade records matched exactly; normal archives were backed up and checksum-compared without decrypting them. + +Desktop and Start-menu target identities were verified where created. A complete +actual installed executable journey is separate from normal shortcut activation; +this report does not claim an additional manual shortcut-button test. No Docker +configuration, real credential or existing account data was used by the synthetic +acceptance. Prepared scenarios are inputs to the full product, never separate demo +applications. + +This documentation commit must pass its own hosted checks. Earlier runtime results +do not certify future source changes. diff --git a/docs/reports/windows-application-guide-0.4.4.docx b/docs/reports/windows-application-guide-0.4.4.docx new file mode 100644 index 0000000..b0d6ee5 Binary files /dev/null and b/docs/reports/windows-application-guide-0.4.4.docx differ diff --git a/docs/reports/windows-application-guide-0.4.4.json b/docs/reports/windows-application-guide-0.4.4.json new file mode 100644 index 0000000..8e72028 --- /dev/null +++ b/docs/reports/windows-application-guide-0.4.4.json @@ -0,0 +1,93 @@ +{ + "schema": 1, + "repository": "code-flow-studio", + "runtimeVersion": "0.4.4", + "runtimeSource": "8a533a0b9838b994c18ec0475d91a4f8db1be6fa", + "createdAt": "2026-11-11T04:13:49.645Z", + "author": "Jason Stys", + "document": "windows-application-guide-0.4.4.docx", + "sha256": "e48348e5b38561badb0a47d62d7772402c36dd8805a8d2673f376f282ca4c7dd", + "screenshots": [ + { + "file": "desktop-workspace.png", + "sha256": "215384e422a8380a464ed7a3ce4a5cc26ae771cb39bf58542d9bb84a9f6e9505", + "width": 2139, + "height": 1407, + "caption": "The actual installed workspace with a synthetic project after revision save and static review. This overview illustrates the interface; the native journey independently verified real account creation, vault unlock, editing and history." + }, + { + "file": "desktop-source-inspector.png", + "sha256": "f5138722b3ec6e9c4f5840197276e16c498a1f34b778a12394b47397f5b671a1", + "width": 1634, + "height": 1239, + "caption": "The installed application highlights physical line 6 of helper.py in its immutable evidence snapshot. The current draft matches the verified source bytes. This is static evidence from a synthetic example, not a local compiler execution claim." + } + ], + "snippets": [ + { + "file": "runner/csharp_coverage_bridge.py", + "first": 239, + "last": 250, + "sha256": "64e1d4e2dfca531b58e595945e937b41de1334eaba71b729e85794f8ff4fcc41", + "url": "https://github.com/JasonStys/code-flow-studio/blob/8a533a0b9838b994c18ec0475d91a4f8db1be6fa/runner/csharp_coverage_bridge.py#L239" + }, + { + "file": "ui/SourceInspector.tsx", + "first": 60, + "last": 79, + "sha256": "2413783242d19c11b1eab25dddb7a4985aec247689df7980ebe2ee2933797a73", + "url": "https://github.com/JasonStys/code-flow-studio/blob/8a533a0b9838b994c18ec0475d91a4f8db1be6fa/ui/SourceInspector.tsx#L60" + } + ], + "observedTests": [ + { + "name": "Installed identity", + "observed": "All 12 downloaded assets matched provider/sidecar hashes; all 3 archives carried the exact 0.4.4 source manifest. Actual installed runtime is CPython 3.14.10/Electron 44.11.", + "result": "Passed" + }, + { + "name": "Native user journey", + "observed": "The full installed registration, WebCrypto unlock, editor, source inspection and 48-category journey passed. Both complete saved revisions also survived a real 0.4.3 to 0.4.4 same-account vault upgrade.", + "result": "Passed" + }, + { + "name": "Lock and shutdown", + "observed": "The journey checked vault lock, owned service drain, sealing and actual service and bootloader exit.", + "result": "Passed" + }, + { + "name": "Source release tests", + "observed": "422 source tests,2 Windows platform skips and 28 subtests passed, with 85.13 percent coverage at the unchanged 80 percent controller/training floor. Current main/compiler/package/CodeQL workflows passed.", + "result": "Passed" + }, + { + "name": "Hosted CSharp controls", + "observed": "Actual target exits 0, 1, 2, 7, 255 and malformed input 2 were measured; argument rejection, report write failure and timeout were blocked.", + "result": "Passed" + } + ], + "visualReview": { + "approved": true, + "scope": "all four pages individually inspected", + "ooxmlSchema": "passed", + "pages": [ + { + "file": "page-1.png", + "sha256": "e43f5dfa4476e1407ad388e43f4001d4a01b8373cd849696e96c94d3358cf159" + }, + { + "file": "page-2.png", + "sha256": "ebdc7968144ddd60b35dce0b307766b571bf4afef48482bb5b54ed67d4b90eb2" + }, + { + "file": "page-3.png", + "sha256": "4dfd1870fe1cb89a0b385014d184a2324657e8ffac4fea5e45389ccd7a9ce879" + }, + { + "file": "page-4.png", + "sha256": "1e2d8bc3618fbb4c542cae687e36855219b8f124ecee0da4cb3314ccef804035" + } + ], + "reviewedUtc": "2026-11-11T04:31:35.372369+00:00" + } +} diff --git a/docs/screenshots/installed-0.4.4/desktop-source-inspector.png b/docs/screenshots/installed-0.4.4/desktop-source-inspector.png new file mode 100644 index 0000000..e0a3700 Binary files /dev/null and b/docs/screenshots/installed-0.4.4/desktop-source-inspector.png differ diff --git a/docs/screenshots/installed-0.4.4/desktop-workspace.png b/docs/screenshots/installed-0.4.4/desktop-workspace.png new file mode 100644 index 0000000..5f657bf Binary files /dev/null and b/docs/screenshots/installed-0.4.4/desktop-workspace.png differ