isomage 1.0.0

Browse and extract files from ISO images without mounting them
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# Contributing to isomage

Thanks for considering a contribution. isomage is a small, focused Rust
CLI; PRs that keep it small and focused are the easiest to land.

## Before you open a PR

1. **Build and test**:
   ```sh
   make test-data
   cargo build
   cargo test
   ```
2. **Run the prompt-log check locally** (installs a pre-commit hook the
   first time):
   ```sh
   ./scripts/install-hooks.sh
   ```
3. **Write a prompt log entry** describing the human prompts and key
   decisions in your change. See [`prompts/PROMPTLOG.md`](prompts/PROMPTLOG.md)
   for the spec.

## The promptlog pattern

isomage commits the prompts that led to each change, alongside the code.
This is the [promptlog pattern](https://jackdanger.com/promptlog/). It
applies whether you wrote the code yourself, paired with an AI agent, or
the agent did most of the work.

The CI gate fails any PR that changes `src/` or `Cargo.toml` without adding
a file under `prompts/`. The format is documented in
[`prompts/PROMPTLOG.md`](prompts/PROMPTLOG.md); a step-by-step skill for AI
agents lives at [`.claude/skills/promptlog.md`](.claude/skills/promptlog.md).

**You don't have to use an AI agent to contribute.** If you wrote the code
yourself, the prompt log is a short rationale document — what you set out
to change, and why you made the design choices you did. Same format, no
"Assistant" section required if there wasn't one.

## What kinds of changes are welcome

- Bug fixes with a regression test
- Support for ISO/UDF variants that currently fail to parse (please include
  a small sample ISO under `test_data/`, generated by `make test-data` when
  possible)
- CLI polish, better error messages, performance improvements
- Documentation, especially around the file formats

## What's out of scope

- ISO writing — isomage is read-only by design
- Mount-style integrations (FUSE, etc.) — also by design
- Dependencies beyond the standard library + `clap` without strong justification

## Questions

Open an issue or start a draft PR. Both are good ways to check whether a
change is in scope before you invest in it.