Files
ai-engineering/src/main/java/net/intrepid/aiengineering/discussion/DiscussionService.java
T
bquarkz f5d5db73c2
Test / Tests and coverage occurred while executing withChecks step.
Intrepid/AI Engineering/pipeline/head There was a failure building this commit
build / jvm (push) Canceled after 0s
build / native (macos-15, macos-arm64) (push) Canceled after 0s
build / native (ubuntu-24.04, linux-x86_64) (push) Canceled after 0s
build / native (windows-2025, windows-x86_64) (push) Canceled after 0s
feat: add Work guidance and adaptive Plan experiments
Persist explicit human discussion choices, DEC requests and approval policies. Add optional evidence-backed Plan experiments and align context, adapters and next actions under protocol contract 3.

Include WRK-000B decisions, plan history and verification evidence: 167 JVM tests, 25 focused checks, Jenkins fixtures and native smoke coverage.
2026-11-16 17:33:24 +00:00

77 lines
5.1 KiB
Java

package net.intrepid.aiengineering.discussion;
import net.intrepid.aiengineering.filesystem.*;
import net.intrepid.aiengineering.work.*;
import java.nio.file.Path;
import java.time.Instant;
import java.util.List;
public final class DiscussionService {
public boolean hasPending(Path root, String work) {
var entries = list(root, work);
var answered = entries.stream().filter(e -> e.kind() == DiscussionEntry.Kind.RESPONSE || e.kind() == DiscussionEntry.Kind.CONCLUSION)
.map(DiscussionEntry::respondsTo).filter(java.util.Objects::nonNull).toList();
return entries.stream().anyMatch(e -> (e.kind() == DiscussionEntry.Kind.QUESTION || e.kind() == DiscussionEntry.Kind.ISSUE) && !answered.contains(e.id()))
|| new SurveyService().list(root, work).stream().anyMatch(s -> s.questions().isEmpty() || !s.pending().isEmpty());
}
private final WorkService works = new WorkService();
public List<DiscussionEntry> list(Path root, String id) {
Work work = works.load(root, id); Path folder = works.folder(root, id);
return work.discussions().stream().map(ref -> {
var entry = Documents.readMarkdownDocument(Filespace.resolve(folder, "discussions/" + ref + ".md"), DiscussionEntry.class, "text");
if (!entry.id().equals(ref) || !entry.workId().equals(id)) throw ProtocolException.validation("Discussion identity mismatch: " + ref);
return entry;
}).toList();
}
public DiscussionEntry add(Path root, String workId, String text, DiscussionEntry.Kind kind, String author, String discussionId, String respondsTo) {
return Filespace.locked(root, () -> {
var work = works.editable(root, workId);
if (discussionId.startsWith("TOP-")) new TopicService().require(root, workId, discussionId);
if (respondsTo != null && list(root, workId).stream().noneMatch(e -> e.id().equals(respondsTo)))
throw ProtocolException.invalid("Response target not found in Work: " + respondsTo);
String id = works.nextReference(work.discussions(), "DSC");
var entry = writePrepared(works.folder(root, workId), workId, id, text, kind, author, discussionId, respondsTo);
works.addReference(root, workId, "discussions", id); return entry;
});
}
/** Normal discussion format in an unpublished Work folder; caller publishes its Work references. */
public DiscussionEntry writePrepared(Path folder, String workId, String id, String text, DiscussionEntry.Kind kind,
String author, String discussionId, String respondsTo) {
var entry = new DiscussionEntry(1, id, workId, discussionId, kind, author, Instant.now().toString(), respondsTo, text);
Documents.writeMarkdownDocument(Filespace.resolve(folder, "discussions/" + id + ".md"), entry, "text", false); return entry;
}
public record MigrationReport(int schemaVersion, int converted, int unchanged, List<String> backups) {
public MigrationReport { backups = List.copyOf(backups); }
}
private record Conversion(Path path, String original, String converted) {}
/** Explicit formatting migration, preserving semantic history and Work modification timestamps. */
public MigrationReport migrate(Path root, String workId) {
return Filespace.locked(root, () -> {
var entries = list(root, workId); var conversions = new java.util.ArrayList<Conversion>();
Path folder = works.folder(root, workId);
// Preflight every entry before creating backups or replacing any file.
for (var entry : entries) {
Path path = Filespace.resolve(folder, "discussions/" + entry.id() + ".md");
if (Documents.documentVersion(path) == 1) {
String original = Filespace.read(path);
if (!Documents.readMarkdownDocument(path, DiscussionEntry.class, "text").equals(entry))
throw ProtocolException.validation("Discussion changed during migration: " + path);
conversions.add(new Conversion(path, original, Documents.markdownMigration(path, entry, "text")));
}
}
var backups = new java.util.ArrayList<String>();
String backupDirectory = ".ai-engineering/.local/backups/discussions/" + workId + "/" + java.util.UUID.randomUUID();
for (var conversion : conversions) {
if (!Filespace.read(conversion.path()).equals(conversion.original()))
throw ProtocolException.validation("Discussion changed during migration; retry after the other editor finishes: " + conversion.path());
String relative = backupDirectory + "/" + conversion.path().getFileName();
Path backup = Filespace.resolve(root, relative); Filespace.directory(backup.getParent());
Filespace.write(backup, conversion.original(), false);
Filespace.write(conversion.path(), conversion.converted(), true);
backups.add(relative);
}
return new MigrationReport(1, conversions.size(), entries.size() - conversions.size(), backups);
});
}
}