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 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 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(); 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 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); }); } }