@kontourai/flow-agents 3.3.0 → 3.4.1

package/build/src/cli/effective-backlog-settings.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from "node:url";
 import { parseArgs, flagString, flagBool } from "../lib/args.js";
 import { readJson } from "../lib/fs.js";
 const PROJECT_SETTINGS_RELATIVE_PATH = path.join("context", "settings", "backlog-provider-settings.json");
+const WORKSPACE_SETTINGS_RELATIVE_PATH = path.join(".kontourai", "settings.json");
 function loadSettings(file) {
     if (!fs.existsSync(file))
         return null;
@@ -36,6 +37,14 @@ function currentRepo(repoPath) {
     }
     return null;
 }
+function gitRoot(repoPath) {
+    try {
+        return child_process.execFileSync("git", ["-C", repoPath, "rev-parse", "--show-toplevel"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    }
+    catch {
+        return null;
+    }
+}
 function merge(base, override) {
     if (!base && !override)
         return null;
@@ -60,6 +69,45 @@ function findProject(settings, repo) {
         return projectRepo.owner === repo.owner && projectRepo.name === repo.name;
     }) ?? null;
 }
+function workspaceRepos(settings) {
+    const workspace = settings?.workspace;
+    if (typeof workspace !== "object" || workspace === null || Array.isArray(workspace))
+        return [];
+    const repos = workspace.repos;
+    return Array.isArray(repos) ? repos.flatMap((repo) => typeof repo === "string" && repo.trim() ? [repo.trim()] : []) : [];
+}
+function hasWorkspaceSettings(repoPath) {
+    return fs.existsSync(path.join(repoPath, WORKSPACE_SETTINGS_RELATIVE_PATH));
+}
+function isGitRepoRoot(candidate) {
+    if (fs.existsSync(path.join(candidate, ".git")))
+        return true;
+    try {
+        const root = child_process.execFileSync("git", ["-C", candidate, "rev-parse", "--show-toplevel"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        return fs.realpathSync(root) === fs.realpathSync(candidate);
+    }
+    catch {
+        return false;
+    }
+}
+function depthOneGitRepoCount(repoPath) {
+    if (!fs.existsSync(repoPath))
+        return 0;
+    let count = 0;
+    for (const name of fs.readdirSync(repoPath)) {
+        const candidate = path.join(repoPath, name);
+        if (!fs.statSync(candidate).isDirectory())
+            continue;
+        if (isGitRepoRoot(candidate))
+            count += 1;
+        if (count >= 2)
+            return count;
+    }
+    return count;
+}
+function isWorkspacePath(repoPath) {
+    return hasWorkspaceSettings(repoPath) || depthOneGitRepoCount(repoPath) >= 2;
+}
 function defaultProjectSettingsPath() {
     let cursor = path.dirname(fileURLToPath(import.meta.url));
     while (true) {
@@ -73,15 +121,35 @@ function defaultProjectSettingsPath() {
     }
 }
 function effective(repoPath, projectSettings, globalSettings) {
+    const globalDoc = loadSettings(globalSettings);
+    const root = gitRoot(repoPath);
+    if (!root && isWorkspacePath(repoPath)) {
+        const workspaceSettings = path.join(repoPath, WORKSPACE_SETTINGS_RELATIVE_PATH);
+        const workspaceDoc = loadSettings(workspaceSettings);
+        const effectiveSettings = merge(globalDoc?.defaults, workspaceDoc?.defaults);
+        const repos = workspaceRepos(workspaceDoc);
+        if (effectiveSettings) {
+            if (repos.length)
+                effectiveSettings.workspace = { repos };
+            return [{
+                    status: "configured",
+                    scope: "workspace",
+                    workspace: { root: repoPath, settings_path: workspaceSettings, repos },
+                    source: workspaceDoc?.defaults ? "workspace" : "global",
+                    precedence: ["workspace.defaults", "global.defaults"],
+                    settings: effectiveSettings,
+                }, 0];
+        }
+        return [{ status: "ask_user", scope: "workspace", reason: "no_backlog_provider_settings", message: "Ask the user which backlog WorkItemProvider and BoardProvider to use for this workspace.", workspace: { root: repoPath, settings_path: workspaceSettings, repos }, resolution: { workspace_settings_path: workspaceSettings, global_settings_path: globalSettings, checked: ["workspace", "global"] } }, 2];
+    }
     const repo = currentRepo(repoPath);
     const projectDoc = loadSettings(projectSettings);
-    const globalDoc = loadSettings(globalSettings);
     if (!repo)
         return [{ status: "ask_user", reason: "could_not_identify_current_repo", message: "Ask the user which backlog WorkItemProvider and BoardProvider to use for this workspace.", resolution: { project_settings_path: projectSettings, global_settings_path: globalSettings } }, 2];
     const effectiveSettings = merge(merge(merge(globalDoc?.defaults, findProject(globalDoc, repo)), projectDoc?.defaults), findProject(projectDoc, repo));
     if (!effectiveSettings)
         return [{ status: "ask_user", reason: "no_backlog_provider_settings", message: "Ask the user which backlog WorkItemProvider and BoardProvider to use before selecting work.", current_repo: repo, resolution: { project_settings_path: projectSettings, global_settings_path: globalSettings, checked: ["project", "global"] } }, 2];
-    return [{ status: "configured", current_repo: repo, source: findProject(projectDoc, repo) || projectDoc?.defaults ? "project" : "global", precedence: ["project.projects match", "project.defaults", "global.projects match", "global.defaults"], settings: effectiveSettings }, 0];
+    return [{ status: "configured", scope: "repo", current_repo: repo, source: findProject(projectDoc, repo) || projectDoc?.defaults ? "project" : "global", precedence: ["project.projects match", "project.defaults", "global.projects match", "global.defaults"], settings: effectiveSettings }, 0];
 }
 export function main(argv = process.argv.slice(2)) {
     const args = parseArgs(argv);

package/build/src/cli/init.d.ts

@@ -1,3 +1,4 @@
+type Runtime = "base" | "codex" | "claude-code" | "kiro" | "opencode" | "pi";
 export declare const COLLISION_MARKER = "Recording Flow Agents telemetry";
 /**
  * Check whether a user-level Claude Code settings file already contains
@@ -13,5 +14,38 @@ export declare const COLLISION_MARKER = "Recording Flow Agents telemetry";
  * @returns true if a collision was detected, false otherwise.
  */
 export declare function checkScopeCollision(userSettingsFile?: string): boolean;
+/**
+ * Detect the current runtime from environment-variable signals already
+ * ambient in the invoking process (Claude Code / Codex / opencode session
+ * markers). Reuses the single existing `detectRuntime` implementation from
+ * `scripts/hooks/lib/actor-identity.js` (via the same `createRequire` pattern
+ * used elsewhere in this file for `install-merge.js`/`skill-drift.js`)
+ * instead of forking a second copy of the env-var contract. `pi`'s env-var
+ * contract is unverified there (see actor-identity.js's own docstring) and is
+ * intentionally out of scope for auto-detection, so it maps down to
+ * `"unknown"` here (pi still falls back to `"base"` like today).
+ */
+export declare function detectRuntimeFromProcessEnv(env?: NodeJS.ProcessEnv): Runtime | "unknown";
+/**
+ * Detect the current runtime by probing for exactly one runtime's own global
+ * config directory on disk (the same paths `globalDest` computes for
+ * `--global` installs — see `runtimeGlobalConfigCandidates`). Zero matches or
+ * 2+ matches are both ambiguous and must never guess: only a single
+ * unambiguous hit returns a runtime; everything else is `"unknown"`.
+ */
+export declare function detectRuntimeFromFilesystem(homedir?: string, env?: NodeJS.ProcessEnv): Runtime | "unknown";
+/**
+ * Layered runtime auto-detection default used to pre-fill both the
+ * interactive prompt and the headless `--runtime` fallback: (1) env-var
+ * signals from the invoking process, (2) failing that, an unambiguous
+ * filesystem probe, (3) failing that, today's `"base"` default. An explicit
+ * `--runtime` flag or interactive answer always overrides this — this
+ * function only supplies the fallback default (see `interactiveOptions` /
+ * `headlessOptions`).
+ */
+export declare function detectDefaultRuntime(env?: NodeJS.ProcessEnv, homedir?: string): Runtime;
+export declare function globalDest(runtime: Runtime): string;
+export declare function ensureBundle(runtime: Runtime): string;
 export declare function main(argv?: string[]): Promise<number>;
 export declare function mainDogfood(argv?: string[]): Promise<number>;
+export {};