@unbrained/pm-cli 2026.5.2 → 2026.5.3

package/dist/cli/commands/config.js

@@ -8,6 +8,7 @@ import { PmCliError } from "../../core/shared/errors.js";
 import { migrateItemFilesToFormat } from "../../core/store/item-format-migration.js";
 import { getSettingsPath, resolveGlobalPmRoot, resolvePmRoot, } from "../../core/store/paths.js";
 import { readSettingsWithMetadata, writeSettings } from "../../core/store/settings.js";
+import { CONTEXT_DEPTH_VALUES } from "../../types/index.js";
 const CONFIG_SCOPE_VALUES = ["project", "global"];
 const CONFIG_KEY_VALUES = [
     "definition-of-done",
@@ -50,6 +51,7 @@ const CONFIG_KEY_VALUES = [
     "test_result_tracking",
     "telemetry-tracking",
     "telemetry_tracking",
+    "context",
 ];
 const CONFIG_KEY_ALIASES = {
     definition_of_done: ["definition-of-done", "definition_of_done"],
@@ -93,6 +95,7 @@ const CONFIG_KEY_ALIASES = {
     ],
     test_result_tracking: ["test-result-tracking", "test_result_tracking"],
     telemetry_tracking: ["telemetry-tracking", "telemetry_tracking"],
+    context: ["context"],
 };
 const CONFIG_KEY_SUMMARIES = {
     definition_of_done: "Definition of Done criteria list.",
@@ -115,6 +118,7 @@ const CONFIG_KEY_SUMMARIES = {
     governance_force_required_for_stale_lock: "Governance stale-lock force policy (enabled|disabled).",
     test_result_tracking: "Item-level linked test result persistence policy.",
     telemetry_tracking: "Telemetry usage reporting policy.",
+    context: "Context command settings (depth, section toggles, limits).",
 };
 const LIFECYCLE_PATTERN_CONFIG_KEYS = [
     "lifecycle_stale_blocker_reason_patterns",
@@ -202,6 +206,9 @@ function normalizeKey(value) {
         if (value === "telemetry-tracking" || value === "telemetry_tracking") {
             return "telemetry_tracking";
         }
+        if (value === "context") {
+            return "context";
+        }
         return "definition_of_done";
     }
     throw new PmCliError(`Invalid config key "${value}". Supported: ${CONFIG_KEY_VALUES.join(", ")}`, EXIT_CODE.USAGE);
@@ -423,6 +430,14 @@ function readConfigValue(settings, key) {
     if (key === "telemetry_tracking") {
         return settings.telemetry.enabled ? "enabled" : "disabled";
     }
+    if (key === "context") {
+        return {
+            default_depth: settings.context.default_depth,
+            activity_limit: settings.context.activity_limit,
+            stale_threshold_days: settings.context.stale_threshold_days,
+            sections: { ...settings.context.sections },
+        };
+    }
     return [...settings.workflow.definition_of_done];
 }
 function withWarnings(result, warnings) {
@@ -443,6 +458,85 @@ async function resolveSettingsTarget(scope, global) {
     }
     return { pmRoot, settingsPath };
 }
+function parseSectionToggle(raw) {
+    if (raw === undefined)
+        return undefined;
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === "true" || normalized === "enabled" || normalized === "on" || normalized === "1")
+        return true;
+    if (normalized === "false" || normalized === "disabled" || normalized === "off" || normalized === "0")
+        return false;
+    throw new PmCliError(`Context section toggle must be true|false|enabled|disabled, got "${raw}"`, EXIT_CODE.USAGE);
+}
+async function applyContextConfig(settings, options, target, scope, warnings) {
+    let changed = false;
+    const ctx = settings.context;
+    if (options.defaultDepth !== undefined) {
+        const normalized = options.defaultDepth.trim().toLowerCase();
+        if (!CONTEXT_DEPTH_VALUES.includes(normalized)) {
+            throw new PmCliError(`Context --default-depth must be one of ${CONTEXT_DEPTH_VALUES.join("|")}`, EXIT_CODE.USAGE);
+        }
+        if (ctx.default_depth !== normalized) {
+            ctx.default_depth = normalized;
+            changed = true;
+        }
+    }
+    if (options.activityLimit !== undefined) {
+        const parsed = parseInt(options.activityLimit.trim(), 10);
+        if (isNaN(parsed) || parsed <= 0) {
+            throw new PmCliError("Context --activity-limit must be a positive integer", EXIT_CODE.USAGE);
+        }
+        if (ctx.activity_limit !== parsed) {
+            ctx.activity_limit = parsed;
+            changed = true;
+        }
+    }
+    if (options.staleThresholdDays !== undefined) {
+        const parsed = parseInt(options.staleThresholdDays.trim(), 10);
+        if (isNaN(parsed) || parsed <= 0) {
+            throw new PmCliError("Context --stale-threshold-days must be a positive integer", EXIT_CODE.USAGE);
+        }
+        if (ctx.stale_threshold_days !== parsed) {
+            ctx.stale_threshold_days = parsed;
+            changed = true;
+        }
+    }
+    const sectionToggles = [
+        ["hierarchy", options.sectionHierarchy],
+        ["activity", options.sectionActivity],
+        ["progress", options.sectionProgress],
+        ["blockers", options.sectionBlockers],
+        ["files", options.sectionFiles],
+        ["workload", options.sectionWorkload],
+        ["staleness", options.sectionStaleness],
+        ["tests", options.sectionTests],
+    ];
+    for (const [sectionName, rawValue] of sectionToggles) {
+        const toggle = parseSectionToggle(rawValue);
+        if (toggle !== undefined) {
+            const key = sectionName;
+            if (ctx.sections[key] !== toggle) {
+                ctx.sections[key] = toggle;
+                changed = true;
+            }
+        }
+    }
+    if (changed) {
+        await writeSettings(target.pmRoot, settings, "config:set:context");
+    }
+    return withWarnings({
+        scope,
+        key: "context",
+        context_settings: {
+            default_depth: ctx.default_depth,
+            activity_limit: ctx.activity_limit,
+            stale_threshold_days: ctx.stale_threshold_days,
+            sections: { ...ctx.sections },
+        },
+        settings_path: target.settingsPath,
+        changed,
+    }, warnings);
+}
 export async function runConfig(scopeValue, actionValue, keyValue, options, global) {
     const scope = normalizeScope(scopeValue);
     const action = normalizeAction(actionValue);
@@ -454,8 +548,12 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
         const keys = Object.keys(CONFIG_KEY_ALIASES).map((candidate) => ({
             key: candidate,
             aliases: CONFIG_KEY_ALIASES[candidate],
-            value_kind: isCriteriaConfigKey(candidate) ? "string_array" : "enum",
-            set_flags: isCriteriaConfigKey(candidate) ? ["--criterion", "--clear-criteria"] : candidate === "item_format" ? ["--format"] : ["--policy"],
+            value_kind: candidate === "context"
+                ? "object"
+                : isCriteriaConfigKey(candidate) ? "string_array" : "enum",
+            set_flags: candidate === "context"
+                ? ["--default-depth", "--activity-limit", "--stale-threshold-days", "--section-<name>"]
+                : isCriteriaConfigKey(candidate) ? ["--criterion", "--clear-criteria"] : candidate === "item_format" ? ["--format"] : ["--policy"],
             summary: CONFIG_KEY_SUMMARIES[candidate],
             value: readConfigValue(settings, candidate),
         }));
@@ -489,6 +587,7 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
             governance_force_required_for_stale_lock: readConfigValue(settings, "governance_force_required_for_stale_lock"),
             test_result_tracking: readConfigValue(settings, "test_result_tracking"),
             telemetry_tracking: readConfigValue(settings, "telemetry_tracking"),
+            context: readConfigValue(settings, "context"),
         };
         return withWarnings({
             scope,
@@ -673,6 +772,20 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
                 changed: false,
             }, warnings);
         }
+        if (key === "context") {
+            return withWarnings({
+                scope,
+                key,
+                context_settings: {
+                    default_depth: settings.context.default_depth,
+                    activity_limit: settings.context.activity_limit,
+                    stale_threshold_days: settings.context.stale_threshold_days,
+                    sections: { ...settings.context.sections },
+                },
+                settings_path: target.settingsPath,
+                changed: false,
+            }, warnings);
+        }
         return withWarnings({
             scope,
             key,
@@ -1009,6 +1122,9 @@ export async function runConfig(scopeValue, actionValue, keyValue, options, glob
             changed,
         }, warnings);
     }
+    if (key === "context") {
+        return applyContextConfig(settings, options, target, scope, warnings);
+    }
     const nextCriteria = normalizeCriteria(options.criterion, options.clearCriteria);
     const changed = nextCriteria.length !== settings.workflow.definition_of_done.length ||
         nextCriteria.some((value, index) => value !== settings.workflow.definition_of_done[index]);