native macOS codings agent orchestrator prowl.onev.cat
Something went wrong. Try again.
Swift
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396import Foundationimport ProwlCLIShared
nonisolated enum ProwlPaths { /// Isolates live Debug acceptance from personal settings and runtime data. static var debugDataDirectory: URL? { #if DEBUG if let path = ProcessInfo.processInfo.environment["PROWL_DEBUG_DATA_DIRECTORY"], path.hasPrefix("/") { return URL(filePath: path, directoryHint: .isDirectory) } #endif return nil }
static var baseDirectory: URL { if let directory = debugDataDirectory { return directory } let home = FileManager.default.homeDirectoryForCurrentUser let prowlDir = home.appending(path: ".prowl", directoryHint: .isDirectory) let legacyDir = home.appending(path: ".supacode", directoryHint: .isDirectory) // Migrate from legacy ~/.supacode to ~/.prowl on first access if !FileManager.default.fileExists(atPath: prowlDir.path(percentEncoded: false)), FileManager.default.fileExists(atPath: legacyDir.path(percentEncoded: false)) { try? FileManager.default.copyItem(at: legacyDir, to: prowlDir) } return prowlDir }
static var repositorySettingsDirectory: URL { baseDirectory.appending(path: "repo", directoryHint: .isDirectory) }
static var appSupportDirectory: URL { if let directory = debugDataDirectory { return directory.appending(path: "app-support") } let appSupport = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first ?? baseDirectory return appSupport .appending(path: "com.onevcat.prowl", directoryHint: .isDirectory) .standardizedFileURL }
static var cacheDirectory: URL { appSupportDirectory.appending(path: "cache", directoryHint: .isDirectory) }
/// The agent-facing documentation set bundled inside the app /// (`Prowl.app/Contents/Resources/docs`). Shipped so users and their /// AI agents can read the manual straight from the installed app. static var bundledDocsURL: URL? { Bundle.main.resourceURL?.appending(path: "docs", directoryHint: .isDirectory) }
/// Bundled workflow definitions (`Prowl.app/Contents/Resources/workflows`); absent until the /// first built-in ships, which discovery tolerates. static var bundledWorkflowsURL: URL? { Bundle.main.resourceURL.map(WorkflowSources.bundleDirectory(resourcesURL:)) }
static var bundledMirrorRelayURL: URL? { Bundle.main.resourceURL?.appending( path: "prowl-mirror-relay/prowl-mirror-relay", directoryHint: .notDirectory) }
static var bundledCLIURL: URL? { Bundle.main.resourceURL?.appending( path: "prowl-cli/prowl", directoryHint: .notDirectory ) }
/// Copilot loads hooks only from a plugin directory on disk, so Prowl ships a static one /// inside the bundle (`Prowl.app/Contents/Resources/agent-hooks/copilot`). Its `hooks.json` /// resolves the CLI relative to `$COPILOT_PLUGIN_ROOT`, so the directory stays read-only and /// needs no per-launch materialization. static var bundledCopilotHookPluginURL: URL? { Bundle.main.resourceURL?.appending( path: "agent-hooks/copilot", directoryHint: .isDirectory ) }
/// Extension files relayed by the Pi-family and OpenCode managed hooks (docs-ai 064.010). static var bundledPiHookExtensionURL: URL? { bundledAgentHookFileURL("pi/prowl-hooks.ts") } static var bundledOMPHookExtensionURL: URL? { bundledAgentHookFileURL("omp/prowl-hooks.ts") } static var bundledOpenCodeHookPluginURL: URL? { bundledAgentHookFileURL("opencode/prowl-hooks.ts") }
private static func bundledAgentHookFileURL(_ relativePath: String) -> URL? { Bundle.main.resourceURL?.appending(path: "agent-hooks/\(relativePath)", directoryHint: .notDirectory) }
static var agentHookForwardingDirectory: URL { cacheDirectory.appending(path: "agent-hook-forwarding", directoryHint: .isDirectory) }
/// Per-pane Codex TUI session logs (docs-ai 073). They hold prompt text; see `CodexTUISessionLog`. static var codexTUISessionLogDirectory: URL { cacheDirectory.appending(path: "codex-tui-sessions", directoryHint: .isDirectory) }
/// On-disk path to the bundled docs index (`docs/README.md`), e.g. /// `/Applications/Prowl.app/Contents/Resources/docs/README.md`. `nil` only /// if the bundle has no resource directory (should not happen at runtime). static var bundledDocsReadmePath: String? { bundledDocsURL? .appending(path: "README.md", directoryHint: .notDirectory) .path(percentEncoded: false) }
/// On-disk path to the bundled docs directory itself. static var bundledDocsDirectoryPath: String? { bundledDocsURL?.path(percentEncoded: false) }
static var reposDirectory: URL { baseDirectory.appending(path: "repos", directoryHint: .isDirectory) }
static var workspacesDirectory: URL { baseDirectory.appending(path: "workspaces", directoryHint: .isDirectory) }
static func repositoryDirectory(for rootURL: URL) -> URL { let name = repositoryDirectoryName(for: rootURL) return reposDirectory.appending(path: name, directoryHint: .isDirectory) }
static func normalizedWorktreeBaseDirectoryPath( _ rawPath: String?, repositoryRootURL: URL? = nil ) -> String? { guard let rawPath else { return nil } return PathPolicy.normalizePath( rawPath, relativeTo: repositoryRootURL, resolvingSymlinks: false ) }
/// Resolves an explicit worktree directory from the dialog's optional name / /// path overrides. Returns `nil` when neither is set so callers keep `wt`'s /// default `base/<branch>` placement. The path override sets the parent /// directory (default: the resolved base); the name override sets the leaf /// folder (default: the branch name). static func resolvedWorktreeDirectory( defaultBaseDirectory: URL, repositoryRootURL: URL, nameOverride: String?, pathOverride: String?, branchName: String ) -> URL? { let trimmedName = nameOverride?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "" let trimmedPath = pathOverride?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "" guard !trimmedName.isEmpty || !trimmedPath.isEmpty else { return nil } return worktreePlacement( defaultBaseDirectory: defaultBaseDirectory, repositoryRootURL: repositoryRootURL, trimmedName: trimmedName, trimmedPath: trimmedPath, branchName: branchName ) }
/// Always-concrete counterpart to `resolvedWorktreeDirectory` for the dialog's /// live destination preview. Falls back to the default base and branch name /// when the overrides are empty. static func previewWorktreeDirectory( defaultBaseDirectory: URL, repositoryRootURL: URL, nameOverride: String?, pathOverride: String?, branchName: String ) -> URL { worktreePlacement( defaultBaseDirectory: defaultBaseDirectory, repositoryRootURL: repositoryRootURL, trimmedName: nameOverride?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "", trimmedPath: pathOverride?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "", branchName: branchName ) }
/// Shared base + leaf join for both resolvers. `trimmedName` / `trimmedPath` /// are expected pre-trimmed by callers; only the branch-name fallback is /// re-trimmed defensively. private static func worktreePlacement( defaultBaseDirectory: URL, repositoryRootURL: URL, trimmedName: String, trimmedPath: String, branchName: String ) -> URL { let baseURL: URL if let normalizedPath = normalizedWorktreeBaseDirectoryPath( trimmedPath, repositoryRootURL: repositoryRootURL ) { baseURL = URL(filePath: normalizedPath, directoryHint: .isDirectory).standardizedFileURL } else { baseURL = defaultBaseDirectory.standardizedFileURL } let leaf = trimmedName.isEmpty ? branchName.trimmingCharacters(in: .whitespacesAndNewlines) : trimmedName guard !leaf.isEmpty else { return baseURL } return baseURL.appending(path: leaf, directoryHint: .isDirectory).standardizedFileURL }
static func worktreeBaseDirectory( for repositoryRootURL: URL, globalDefaultPath: String?, repositoryOverridePath: String? ) -> URL { let rootURL = repositoryRootURL.standardizedFileURL if let repositoryOverridePath = normalizedWorktreeBaseDirectoryPath( repositoryOverridePath, repositoryRootURL: rootURL ) { return PathPolicy.normalizeURL( URL(filePath: repositoryOverridePath, directoryHint: .isDirectory), resolvingSymlinks: false ) } if let globalDefaultPath = normalizedWorktreeBaseDirectoryPath(globalDefaultPath) { return PathPolicy.normalizeURL( URL(filePath: globalDefaultPath, directoryHint: .isDirectory), resolvingSymlinks: false ) .appending(path: repositoryDirectoryName(for: rootURL), directoryHint: .isDirectory) .standardizedFileURL } return repositoryDirectory(for: rootURL) }
static func exampleWorktreePath( for repositoryRootURL: URL, globalDefaultPath: String?, repositoryOverridePath: String?, branchName: String = "swift-otter" ) -> String { worktreeBaseDirectory( for: repositoryRootURL, globalDefaultPath: globalDefaultPath, repositoryOverridePath: repositoryOverridePath ) .appending(path: branchName, directoryHint: .isDirectory) .standardizedFileURL .path(percentEncoded: false) }
static var settingsURL: URL { baseDirectory.appending(path: "settings.json", directoryHint: .notDirectory) }
static var userGlobalSettingsURL: URL { baseDirectory.appending(path: "global.onevcat.json", directoryHint: .notDirectory) }
/// Base for account-bound agent profile homes: `~/.prowl/agent-profiles/`. /// Chosen over Application Support to keep the path free of spaces handed /// to third-party CLIs (docs-ai 053). static var agentProfileHomesDirectory: URL { baseDirectory.appending(path: "agent-profiles", directoryHint: .isDirectory) }
static var repositorySnapshotURL: URL { cacheDirectory.appending(path: "repository-snapshot.json", directoryHint: .notDirectory) }
static var terminalLayoutSnapshotURL: URL { cacheDirectory.appending(path: "terminal-layout-snapshot.json", directoryHint: .notDirectory) }
static var repositoryEntriesURL: URL { baseDirectory.appending(path: "repository-entries.json", directoryHint: .notDirectory) }
static var repositoryAppearancesURL: URL { baseDirectory.appending(path: "repository-appearances.json", directoryHint: .notDirectory) }
/// Directory where user-imported repository icon images live, scoped /// per-repo so cleanup is automatic when the per-repo settings /// directory is removed. static func repositoryIconsDirectory(for rootURL: URL) -> URL { repositorySettingsDirectory(for: rootURL) .appending(path: "icons", directoryHint: .isDirectory) }
/// Resolved file URL for a stored icon filename. The filename is the /// only thing persisted in `RepositoryAppearance` so that moving a /// repository (or renaming its directory) leaves the artifact alone. static func repositoryIconFileURL(filename: String, repositoryRootURL rootURL: URL) -> URL { repositoryIconsDirectory(for: rootURL) .appending(path: filename, directoryHint: .notDirectory) }
static func migrateLegacyCacheFilesIfNeeded( fileManager: FileManager = .default, legacyDirectory: URL? = nil, cacheDirectory: URL? = nil ) throws { let sourceDirectory = (legacyDirectory ?? baseDirectory).standardizedFileURL let destinationDirectory = (cacheDirectory ?? self.cacheDirectory).standardizedFileURL try fileManager.createDirectory(at: destinationDirectory, withIntermediateDirectories: true)
let fileNames = [ "repository-snapshot.json", "terminal-layout-snapshot.json", ]
for name in fileNames { let legacyURL = sourceDirectory.appending(path: name, directoryHint: .notDirectory) let destinationURL = destinationDirectory.appending(path: name, directoryHint: .notDirectory) guard !fileManager.fileExists(atPath: destinationURL.path(percentEncoded: false)) else { continue } guard fileManager.fileExists(atPath: legacyURL.path(percentEncoded: false)) else { continue } do { try fileManager.moveItem(at: legacyURL, to: destinationURL) } catch { try fileManager.copyItem(at: legacyURL, to: destinationURL) try? fileManager.removeItem(at: legacyURL) } } }
static func repositorySettingsURL(for rootURL: URL) -> URL { repositorySettingsDirectory(for: rootURL) .appending(path: "prowl.json", directoryHint: .notDirectory) }
static func userRepositorySettingsURL(for rootURL: URL) -> URL { repositorySettingsDirectory(for: rootURL) .appending(path: "prowl.onevcat.json", directoryHint: .notDirectory) }
/// Legacy location: ~/.prowl/repo/<name>/supacode.json (pre-rename) static func legacyRepositorySettingsURL(for rootURL: URL) -> URL { repositorySettingsDirectory(for: rootURL) .appending(path: "supacode.json", directoryHint: .notDirectory) }
/// Legacy location: ~/.prowl/repo/<name>/supacode.onevcat.json (pre-rename) static func legacyUserRepositorySettingsURL(for rootURL: URL) -> URL { repositorySettingsDirectory(for: rootURL) .appending(path: "supacode.onevcat.json", directoryHint: .notDirectory) }
/// Legacy location: <repo-root>/supacode.json (original upstream location) static func originalLegacyRepositorySettingsURL(for rootURL: URL) -> URL { rootURL.standardizedFileURL.appending(path: "supacode.json", directoryHint: .notDirectory) }
/// Legacy location: <repo-root>/supacode.onevcat.json (original upstream location) static func originalLegacyUserRepositorySettingsURL(for rootURL: URL) -> URL { rootURL.standardizedFileURL.appending(path: "supacode.onevcat.json", directoryHint: .notDirectory) }
private static func repositorySettingsDirectory(for rootURL: URL) -> URL { let name = repositorySettingsDirectoryName(for: rootURL) return repositorySettingsDirectory.appending(path: name, directoryHint: .isDirectory) }
private static func repositoryDirectoryName(for rootURL: URL) -> String { let repoName = rootURL.lastPathComponent if repoName.isEmpty || repoName == ".bare" || repoName == ".git" { let path = rootURL.standardizedFileURL.path(percentEncoded: false) let trimmed = path.trimmingCharacters(in: CharacterSet(charactersIn: "/")) if trimmed.isEmpty { return "_" } return trimmed.replacing("/", with: "_") } return repoName }
private static func repositorySettingsDirectoryName(for rootURL: URL) -> String { let repoName = rootURL.standardizedFileURL.lastPathComponent if repoName.isEmpty || repoName == "/" { return "_" } return repoName }}