/* sk_v4_grow.h -- Artemis grows to fill the stick at its first boot
 * (docs/v4.0.0/STICK.md 5a; plan 2026-10-29-stick-5, Task 2).
 *
 * Built only with STARFORTH_V4=1 (Kconfig.kernel).
 */
#ifndef STARKERNEL_V4_SK_V4_GROW_H
#define STARKERNEL_V4_SK_V4_GROW_H

#include <stdint.h>
#include "blkio.h"

/* How far the Artemis partition `art` may grow, in 512-byte sectors: no
 * further than `cap_sectors`, nor than its volume's BAM can track. 0 when
 * `art` holds no STFR v2 volume. Reads only. */
uint64_t sk_v4_grow_cap_sectors(blkio_dev_t *art, uint64_t cap_sectors);

/* Grow the volume on `art` to fill its partition: its fence (the Artemis
 * signature, Zuse's genesis marker) moved to the new top, then its header.
 * Metadata only. 1 when grown, 0 when it already fills the partition, -1 on
 * an error -- the old header then still names the old volume, whole. */
int sk_v4_grow_artemis(blkio_dev_t *art);

#endif /* STARKERNEL_V4_SK_V4_GROW_H */