Integrate AStar with VCC Plus disk builds and verified run

Add the vccplus-disk packaging target, project settings, playable AStar.DSK, actual MCP framebuffer screenshot and build-43 validation. Preserve upstream C sources and Makefile unchanged.
This commit is contained in:
Brian Holman committed 2026-11-09 23:33:13 -07:00
1 parent aa048c556d
commit 0c3f8c0324
10 files changed
+211 -16

No files matched your search

+35
View File
@@ -0,0 +1,35 @@
# Source provenance
## Original package
- Original author: **Pierre Sarrazin**.
- Package: **AStar 0.1.0**.
- [Author index](http://sarrazip.com/dev/cmoc.html).
- [Source archive](http://sarrazip.com/dev/astar-0.1.0.tar.gz).
- Archive SHA-256: `acd2d5e2ad709892cb7609f5e53387cbbfe7364e675abb5e4f2a5c806cd0fc7c`.
- Upstream terms: the package and library are explicitly dedicated to the
public domain in the [original README](UPSTREAM_README.md).
The checksum identifies the original source archive used for this import.
A current matching download link is not a separate authenticity guarantee or
proof of the original download event.
## Git history and VCC Plus integration
This is a source-archive import, not an upstream Git checkout. The initial
commit, `aa048c556d77e44c3f7706b11a92268afd554cea`, contains the archive’s original files before
VCC Plus integration. The original README is also preserved byte-for-byte in
`UPSTREAM_README.md`. Source author notices remain intact.
The integration keeps the upstream C/header files and `Makefile` unchanged.
It adds `VCCPlus.mk`, which includes the original Makefile and packages the
compiled demo into `AStar.DSK`; `vccplus-project.json` selects that disk target
and the Disk BASIC launch command. The public README, actual running screenshot,
validation record and Git output exclusions accompany those integration files.
The top-level disk is an intentionally delivered playable artifact, rather than
an incidental object-file cache.
The original source archive and earlier local project were not modified by this
import. The [validation record](VALIDATION.md) documents the completed installed
build-43 public MCP disk build and displayed path result. This repository’s
source history is distinct from later hosting or repository-avatar updates.
+30
View File
@@ -0,0 +1,30 @@
AStar: A demo of the A* search algorithm
========================================
By Pierre Sarrazin (http://sarrazip.com/).
CMOC Home Page: http://sarrazip.com/dev/cmoc.html
Version 0.1.0 - 202?-??-?? - First public release.
# Introduction
[A\*](https://en.wikipedia.org/wiki/A*_search_algorithm)
is a graph traversal and path search algorithm.
This package presents an implementation that assumes that the graph
is a rectangular grid.
See `astar-demo.c` for the demo. It uses `astar.h` and `astar.c`.
# Building the demo
After installing CMOC, type `make`, which should build the library
(`libastar.a`) and the demo executable (`astar.bin`).
# License
This package and library are in the public domain.
+57
View File
@@ -0,0 +1,57 @@
# AStar installed-app validation
Verified **November 9, 2026** through the installed VCC Plus public MCP build
and disposable-playtest interface. This records the selected demonstration;
it is not a full library regression suite.
## Configuration
- VCC Plus **3.5.0 build 43** and its bundled CMOC/Make/disk tools.
- An isolated native copy of the installed application was used to preserve the
active CoCoMan workspace. Its emulator code was unchanged; the bundle identity
was changed and the copy was ad-hoc signed for isolation.
- **Release** configuration; **512 KB RAM, MC6809, Disk BASIC**.
- Approved Make recipe: `VCCPlus.mk`, including upstream `Makefile`.
- Public build action: `disk`; declared target: `vccplus-disk`.
- Declared launch command: `LOADM"ASTAR":EXEC`.
## Build evidence
- Project ID: `963A54EE-D02A-4701-B53A-92FC0BB62D02`; source revision: `0`.
- Recipe ID: `ae0576ed455aa0f6ef31e0372662312b63aa633b175928b7115e9df71267cb88`.
- Build ID: `7237D773-A262-4AE3-9F67-674F2300FC8B`; result: **succeeded**.
- Artifact ID: `1158FAAB-2636-487E-9FB7-68DD272F8CCF`.
- `astar.bin`: **4,540 bytes**; SHA-256
`a967c02ebdb8f5dff0e94d9768fdb0fd37071c22542a9feedc0444c6903e6722`.
- Delivered `AStar.DSK`: **161,280 bytes**; SHA-256
`48c532dee5a302f7b0841f9353c218ae61bee23af0d1bac576e41d11cde3e502`.
CMOC emitted two existing warnings in `astar-demo.c`, at lines **183** and
**242**, about assignment used as a condition. The original source was not
changed to suppress them. Compilation, linking and disk packaging completed.
## Execution and screenshot
The MCP-owned run `321CD4AD-E480-4BB8-95A6-271182F20B74` reached the actual
running demonstration. Its framebuffer showed the grid, a drawn path and the
text **FOUND PATH: A B C G F J K L**. The capture was taken after **1,072 emulated
video fields**, with **5,120 bytes read from disk**, zero disk writes and the
same disk SHA-256 as the verified artifact. The run was then stopped and its
test disk retained by VCC Plus.
[The screenshot](screenshots/running.png) is the actual **640 × 480** framebuffer
returned by MCP. SHA-256:
`689f47c217418b2b0702aa37bf4055bf16ad81e3eb805c2f5544be4a049302b0`.
It is not an illustration, an old distribution disk capture or a build log.
The source waits for a key and returns to BASIC after the displayed result;
this capture session stopped the owned run rather than separately testing that
key-to-BASIC transition.
## Scope
This establishes a fresh Release disk build and a successful displayed result
for the specified MC6809 configuration. It does not claim HD6309 execution,
Intel/Rosetta qualification, physical CoCo hardware, audio listening,
comprehensive library tests or all possible pathfinding inputs. No private
connection grant or raw host log is included in this repository.
Binary file not shown.

After

Width:  |  Height:  |  Size: 8.8 KiB