feat: Disk Inspector — show detailed AKAI disk metadata #2

New Issue

2026-06-22T02:37:09Z

david commented

2026-06-22 02:37:09 +00:00

Feature: Disk Inspector

As a sampler user preparing to load a disk on real hardware
I want to see detailed technical metadata about an AKAI disk image
So that I can verify it will work with my specific sampler model

Acceptance Criteria

Scenario: Inspect a CD3000 CD-ROM image

Given an AKAI CD3000 CD-ROM disk image
When I run the Disk Inspector on it
Then I see: disk type, total size, partition count, volume count per partition
And I see the CD-ROM label (from cdinfo command)
And I see each volume's OS version and load number

Scenario: Inspect an S900 hard disk image

Given an S900 hard disk image formatted for SUPRA30M
When I inspect it
Then I see: "S900 HD — 30,496 KB — 3,812 blocks (8KB)"
And I see the compression ratio of any S900 compressed samples

Scenario: Inspect an image with no recognisable filesystem

Given a file that is not an AKAI disk image
When I inspect it
Then I see "Not a valid AKAI disk image" with the raw `df` error output

Implementation

Single akaiutil call: df → parse block counts, partition letters, sizes
Follow up with dinfo / pwd for current-directory-level info
Endpoint: /api/inspect?iso=<path>
Return structured JSON: type, blocks, partitions, volumes

Karpathy Principle

One akaiutil session, one endpoint, structured output. Minimal and testable.

## Feature: Disk Inspector **As a** sampler user preparing to load a disk on real hardware **I want to** see detailed technical metadata about an AKAI disk image **So that** I can verify it will work with my specific sampler model ### Acceptance Criteria **Scenario: Inspect a CD3000 CD-ROM image** ``` Given an AKAI CD3000 CD-ROM disk image When I run the Disk Inspector on it Then I see: disk type, total size, partition count, volume count per partition And I see the CD-ROM label (from cdinfo command) And I see each volume's OS version and load number ``` **Scenario: Inspect an S900 hard disk image** ``` Given an S900 hard disk image formatted for SUPRA30M When I inspect it Then I see: "S900 HD — 30,496 KB — 3,812 blocks (8KB)" And I see the compression ratio of any S900 compressed samples ``` **Scenario: Inspect an image with no recognisable filesystem** ``` Given a file that is not an AKAI disk image When I inspect it Then I see "Not a valid AKAI disk image" with the raw `df` error output ``` ### Implementation - Single `akaiutil` call: `df` → parse block counts, partition letters, sizes - Follow up with `dinfo` / `pwd` for current-directory-level info - Endpoint: `/api/inspect?iso=<path>` - Return structured JSON: type, blocks, partitions, volumes ### Karpathy Principle One akaiutil session, one endpoint, structured output. Minimal and testable.

david added the feature disk-ops labels 2026-06-22 02:37:09 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: david/akai-utils#2