feat(curation): skill bundles, /journey timeline, and autonomous curator (#44) #45
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,120 @@ | ||
| import Foundation | ||
|
|
||
| public struct JourneyItem: Identifiable, Sendable, Equatable { | ||
| public let id: UUID | ||
| public let title: String | ||
| public let category: String // "Skill", "Profile", "Soul", "Fact" | ||
| public let timestamp: Date | ||
| public let summary: String | ||
| public let path: String? | ||
|
|
||
| public init(id: UUID = UUID(), title: String, category: String, timestamp: Date, summary: String, path: String? = nil) { | ||
| self.id = id | ||
| self.title = title | ||
| self.category = category | ||
| self.timestamp = timestamp | ||
| self.summary = summary | ||
| self.path = path | ||
| } | ||
| } | ||
|
|
||
| public final class JourneyManager: Sendable { | ||
| public static let shared = JourneyManager() | ||
|
|
||
| private init() {} | ||
|
|
||
| public func buildTimeline() async -> [JourneyItem] { | ||
| await buildTimeline(paths: .default) | ||
| } | ||
|
|
||
| func buildTimeline(paths: IrisPaths) async -> [JourneyItem] { | ||
| var items: [JourneyItem] = [] | ||
| let fileManager = FileManager.default | ||
| let isoFormatter = ISO8601DateFormatter() | ||
|
|
||
| // 1. Scan USER.md | ||
| if fileManager.fileExists(atPath: paths.userMd.path), | ||
| let content = try? String(contentsOf: paths.userMd, encoding: .utf8) { | ||
| let (desc, date) = parseFrontmatterDetails(content: content, fallbackDate: getFileModDate(paths.userMd)) | ||
| items.append(JourneyItem(title: "User Profile Updated", category: "Profile", timestamp: date, summary: desc, path: paths.userMd.path)) | ||
| } | ||
|
|
||
| // 2. Scan SOUL.md | ||
| if fileManager.fileExists(atPath: paths.soulMd.path), | ||
| let content = try? String(contentsOf: paths.soulMd, encoding: .utf8) { | ||
| let (desc, date) = parseFrontmatterDetails(content: content, fallbackDate: getFileModDate(paths.soulMd)) | ||
| items.append(JourneyItem(title: "Persona / SOUL Evolved", category: "Soul", timestamp: date, summary: desc, path: paths.soulMd.path)) | ||
| } | ||
|
|
||
| // 3. Scan Skills | ||
| if let skillFolders = try? fileManager.contentsOfDirectory(atPath: paths.skillsDir.path) { | ||
| for folder in skillFolders { | ||
| let skillFile = paths.skillsDir.appendingPathComponent("\(folder)/SKILL.md") | ||
| if fileManager.fileExists(atPath: skillFile.path), | ||
| let content = try? String(contentsOf: skillFile, encoding: .utf8) { | ||
| let (desc, date) = parseFrontmatterDetails(content: content, fallbackDate: getFileModDate(skillFile)) | ||
| items.append(JourneyItem(title: "Learned Skill: \(folder)", category: "Skill", timestamp: date, summary: desc, path: skillFile.path)) | ||
| } | ||
| } | ||
| } | ||
|
|
||
| // 4. Scan FactStore | ||
| if let facts = try? FactStoreManager.shared.search(query: "", limit: 20) { | ||
| for fact in facts { | ||
| let date = Date(timeIntervalSince1970: TimeInterval(fact.createdAt)) | ||
| items.append(JourneyItem(title: "Fact Saved [\(fact.category)]", category: "Fact", timestamp: date, summary: fact.content)) | ||
| } | ||
| } | ||
|
|
||
| return items.sorted { $0.timestamp > $1.timestamp } | ||
| } | ||
|
|
||
| public func formatTimelineMarkdown(items: [JourneyItem]) -> String { | ||
| guard !items.isEmpty else { | ||
| return "No learned memories or skills found in Iris journey timeline." | ||
| } | ||
|
|
||
| let formatter = DateFormatter() | ||
| formatter.dateStyle = .medium | ||
| formatter.timeStyle = .short | ||
|
|
||
| var markdown = "### 📜 Iris Learning Journey Timeline (\(items.count) Milestones)\n\n" | ||
| for item in items { | ||
| let dateStr = formatter.string(from: item.timestamp) | ||
| let badge = "[\(item.category.uppercased())]" | ||
| markdown += "• **\(dateStr)** `\(badge)` **\(item.title)**\n *\(item.summary)*\n\n" | ||
| } | ||
| return markdown | ||
| } | ||
|
|
||
| private func getFileModDate(_ url: URL) -> Date { | ||
| (try? FileManager.default.attributesOfItem(atPath: url.path)[.modificationDate] as? Date) ?? Date() | ||
| } | ||
|
|
||
| private func parseFrontmatterDetails(content: String, fallbackDate: Date) -> (summary: String, date: Date) { | ||
| let lines = content.components(separatedBy: .newlines) | ||
| var inFrontmatter = false | ||
| var desc = "No summary provided." | ||
| var date = fallbackDate | ||
| let isoFormatter = ISO8601DateFormatter() | ||
|
|
||
| for line in lines { | ||
| if line == "---" { | ||
| if inFrontmatter { break } | ||
| inFrontmatter = true | ||
| continue | ||
| } | ||
| if inFrontmatter { | ||
| if line.starts(with: "description:") { | ||
| desc = String(line.dropFirst("description:".count)).trimmingCharacters(in: .whitespaces) | ||
| } else if line.starts(with: "timestamp:") { | ||
| let rawDate = String(line.dropFirst("timestamp:".count)).trimmingCharacters(in: .whitespaces) | ||
| if let parsed = isoFormatter.date(from: rawDate) { | ||
| date = parsed | ||
| } | ||
| } | ||
| } | ||
| } | ||
| return (desc, date) | ||
| } | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,91 @@ | ||
| import Foundation | ||
|
|
||
| public struct SkillBundle: Codable, Sendable, Equatable { | ||
| public let name: String | ||
| public let description: String | ||
| public let skillNames: [String] | ||
|
|
||
| public init(name: String, description: String, skillNames: [String]) { | ||
| self.name = name.lowercased().trimmingCharacters(in: .whitespacesAndNewlines) | ||
| self.description = description | ||
| self.skillNames = skillNames.map { $0.lowercased().trimmingCharacters(in: .whitespacesAndNewlines) } | ||
| } | ||
| } | ||
|
|
||
| public final class SkillBundleManager: Sendable { | ||
| public static let shared = SkillBundleManager() | ||
|
|
||
| private let lock = NSLock() | ||
| private var _activeBundle: SkillBundle? = nil | ||
|
|
||
| public var activeBundle: SkillBundle? { | ||
| get { | ||
| lock.lock() | ||
| defer { lock.unlock() } | ||
| return _activeBundle | ||
| } | ||
| set { | ||
| lock.lock() | ||
| _activeBundle = newValue | ||
| lock.unlock() | ||
| } | ||
| } | ||
|
|
||
| private init() {} | ||
|
|
||
| private func bundleFile(paths: IrisPaths) -> URL { | ||
| paths.memoryDir.appendingPathComponent("bundles.json") | ||
| } | ||
|
|
||
| public func listBundles() -> [SkillBundle] { | ||
| listBundles(paths: .default) | ||
| } | ||
|
|
||
| func listBundles(paths: IrisPaths) -> [SkillBundle] { | ||
| let url = bundleFile(paths: paths) | ||
| guard let data = try? Data(contentsOf: url), | ||
| let bundles = try? JSONDecoder().decode([SkillBundle].self, from: data) else { | ||
| return [] | ||
| } | ||
| return bundles.sorted { $0.name.localizedCaseInsensitiveCompare($1.name) == .orderedAscending } | ||
| } | ||
|
|
||
| public func saveBundle(_ bundle: SkillBundle) throws { | ||
| try saveBundle(bundle, paths: .default) | ||
| } | ||
|
|
||
| func saveBundle(_ bundle: SkillBundle, paths: IrisPaths) throws { | ||
| var current = listBundles(paths: paths) | ||
| current.removeAll { $0.name == bundle.name } | ||
| current.append(bundle) | ||
|
|
||
| let url = bundleFile(paths: paths) | ||
| let fileManager = FileManager.default | ||
| try fileManager.createDirectory(at: paths.memoryDir, withIntermediateDirectories: true) | ||
| let data = try JSONEncoder().encode(current) | ||
| try data.write(to: url, atomically: true) | ||
| } | ||
|
|
||
| public func deleteBundle(name: String) throws { | ||
| try deleteBundle(name: name, paths: .default) | ||
| } | ||
|
|
||
| func deleteBundle(name: String, paths: IrisPaths) throws { | ||
| let cleanName = name.lowercased().trimmingCharacters(in: .whitespacesAndNewlines) | ||
| var current = listBundles(paths: paths) | ||
| current.removeAll { $0.name == cleanName } | ||
|
|
||
| let url = bundleFile(paths: paths) | ||
| let data = try JSONEncoder().encode(current) | ||
| try data.write(to: url, atomically: true) | ||
| } | ||
|
|
||
| public func getBundle(name: String) -> SkillBundle? { | ||
| getBundle(name: name, paths: .default) | ||
| } | ||
|
|
||
| func getBundle(name: String, paths: IrisPaths) -> SkillBundle? { | ||
| let cleanName = name.lowercased().trimmingCharacters(in: .whitespacesAndNewlines) | ||
| return listBundles(paths: paths).first { $0.name == cleanName } | ||
| } | ||
| } |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is the crux of the review: curation runs only when a human types
/skills curate. The stated goal is automatic curation, so this manual command is the wrong entry point. The curation pass belongs in the reflection cadence (which already runs periodically), reading its own report and acting — not a keystroke. As-is, 'autonomous curator' is a manual button.