Files
ai-engineering/src/main/java/net/intrepid/aiengineering/artifact/ArtifactService.java
T
bquarkz 8f6cfa5d86 feat: import open Discussion Framework agendas into Works
Add deterministic preview and fingerprint-bound application for independent
DF sources under an AIE umbrella. Preserve complete agendas and original
evidence with source-scoped identities, validated receipts and safe retries.

Publish prepared Works atomically, require review for changed imports and
retain existing refinement without source edits or model calls.

Advertise protocol contract 2 while continuing to read contract-1 projects. Add JVM,
concurrency, recovery and native coverage; document usage and complete
WRK-0007 with verification evidence.
2026-11-16 14:53:05 +00:00

69 lines
4.6 KiB
Java

package net.intrepid.aiengineering.artifact;
import net.intrepid.aiengineering.filesystem.*;
import net.intrepid.aiengineering.work.*;
import java.nio.file.*;
import java.time.Instant;
import java.util.*;
public final class ArtifactService {
public static final long MAX_BYTES = 1024 * 1024;
private final WorkService works = new WorkService();
public List<Artifact> list(Path root, String id) {
var work = works.load(root, id); Path folder = works.folder(root, id);
return work.artifacts().stream().map(ref -> {
var artifact = Documents.read(Filespace.resolve(folder, "artifacts/evidence/" + ref + "/artifact.yaml"), Artifact.class);
if (!artifact.id().equals(ref) || !artifact.workId().equals(id)) throw ProtocolException.validation("Artifact identity mismatch: " + ref);
String expected = "artifacts/evidence/" + ref + "/payload";
if (!artifact.path().equals(expected)) throw ProtocolException.validation("Invalid artifact payload reference: " + artifact.path());
return artifact;
}).toList();
}
public Artifact attach(Path root, String workId, Path source, String purpose, String origin, String author) {
if (!Files.isRegularFile(source, LinkOption.NOFOLLOW_LINKS)) throw ProtocolException.missing("Evidence source is not a regular file: " + source);
if (Filespace.io(() -> Files.size(source)) > MAX_BYTES) throw ProtocolException.invalid("Evidence exceeds 1 MiB; reference large resources instead");
byte[] bytes = Filespace.io(() -> {
try (var input = Files.newInputStream(source)) { return input.readNBytes((int) MAX_BYTES + 1); }
});
if (bytes.length > MAX_BYTES) throw ProtocolException.invalid("Evidence exceeds 1 MiB");
return attachBytes(root, workId, bytes, purpose, origin == null ? source.getFileName().toString() : origin, author);
}
/** Framework-generated receipts use the same canonical artifact format and integrity checks. */
public Artifact attachBytes(Path root, String workId, byte[] content, String purpose, String origin, String author) {
byte[] bytes = content.clone();
if (bytes.length > MAX_BYTES) throw ProtocolException.invalid("Evidence exceeds 1 MiB");
return Filespace.locked(root, () -> {
var work = works.editable(root, workId); String id = works.nextReference(work.artifacts(), "ART");
Path folder = works.folder(root, workId);
var artifact = writePrepared(folder, workId, id, bytes, purpose, origin, author);
works.addReference(root, workId, "artifacts", id); return artifact;
});
}
/** Normal evidence format in an unpublished Work folder; caller publishes its Work references. */
public Artifact writePrepared(Path folder, String workId, String id, byte[] content, String purpose, String origin, String author) {
Work.identifier(workId, "WRK"); Work.identifier(id, "ART"); byte[] bytes = content.clone();
if (bytes.length > MAX_BYTES) throw ProtocolException.invalid("Evidence exceeds 1 MiB");
Path parent = Filespace.resolve(folder, "artifacts/evidence");
Path stage = Filespace.resolve(parent, "." + id + "-" + UUID.randomUUID() + ".tmp"); Filespace.directory(stage);
var artifact = new Artifact(1, id, workId, origin, purpose,
"artifacts/evidence/" + id + "/payload", hash(bytes), bytes.length, author, Instant.now().toString());
Filespace.writeBytes(stage.resolve("payload"), bytes, false);
Filespace.write(stage.resolve("artifact.yaml"), Documents.yaml(artifact), false);
Filespace.moveDirectory(stage, Filespace.resolve(parent, id)); return artifact;
}
public void validate(Path root, String id) {
for (var artifact : list(root, id)) {
Path path = Filespace.resolve(works.folder(root, id), artifact.path());
if (!Files.isRegularFile(path)) throw ProtocolException.validation("Missing artifact payload: " + artifact.path());
if (Filespace.io(() -> Files.size(path)) != artifact.size() || artifact.size() > MAX_BYTES)
throw ProtocolException.validation("Artifact size mismatch: " + artifact.id());
if (!hash(Filespace.io(() -> Files.readAllBytes(path))).equals(artifact.sha256()))
throw ProtocolException.validation("Artifact SHA-256 mismatch: " + artifact.id());
}
}
private static String hash(byte[] bytes) {
try { return HexFormat.of().formatHex(java.security.MessageDigest.getInstance("SHA-256").digest(bytes)); }
catch (java.security.NoSuchAlgorithmException e) { throw new IllegalStateException(e); }
}
}