@caupulican/pi-adaptative 0.81.37 → 0.81.39

package/dist/core/session-role.js

@@ -0,0 +1,52 @@
+/**
+ * Session-role identity: distinguishes a MAIN session (an interactive/direct `pi` session) from a
+ * WORKER session (lane-bound or explicitly dispatched) — the seam every worker-scoped UAC ceiling
+ * and zero-footprint store gates on (see runtime-builder.ts's `isAllowedTool`, the worktree_sync
+ * tool's worker scoping, and the read-only store options threaded through the persistence layer).
+ *
+ * A session is a worker iff EITHER:
+ * - `PI_SESSION_ROLE=worker` is set (an explicit launcher declaration), or
+ * - it is bound to a worktree-sync lane (`PI_WORKTREE_LANE`; see worktree-sync/runtime.ts) — a
+ *   lane-bound session is a worker by construction, regardless of how it was launched.
+ *
+ * `PI_SESSION_ROLE=main` is deliberately NOT an escalation: it can never override a bound lane.
+ * There is no environment value a lane-bound process can set to shed the worker ceiling — the env
+ * var is additive evidence for "worker", never a downgrade signal.
+ */
+import { getBoundWorktreeLaneKey } from "./worktree-sync/runtime.js";
+const PI_SESSION_ROLE_ENV = "PI_SESSION_ROLE";
+/** Derive this process's session role from the environment (env-injectable for tests). */
+export function getSessionRole(env = process.env) {
+    if (env[PI_SESSION_ROLE_ENV] === "worker")
+        return "worker";
+    if (getBoundWorktreeLaneKey(env) !== undefined)
+        return "worker";
+    return "main";
+}
+/** True iff this process is a worker session (lane-bound or explicitly declared). */
+export function isWorkerSession(env = process.env) {
+    return getSessionRole(env) === "worker";
+}
+/**
+ * Tools a worker session may never activate: the orchestration/self-adaptation surface that would
+ * let a worker spawn its own sub-orchestration, mutate settings-driven learning/model state, or
+ * shell out to the unbounded `python` execution contract. `python` is load-bearing for the
+ * zero-footprint guarantee (it can write anywhere the interpreter can reach); `context_scout` is
+ * sub-orchestration (spawns its own isolated agent loop). `bash` is deliberately NOT included: it
+ * stays available as the documented cooperative boundary (see docs/worktree-sync.md) — the same
+ * trust model the lane gate already applies to foreign CLIs it cannot structurally contain.
+ */
+export const WORKER_FORBIDDEN_TOOLS = new Set([
+    "goal",
+    "delegate",
+    "delegate_status",
+    "improvement_loop",
+    "extensionify",
+    "skillify",
+    "run_toolkit_script",
+    "model_fitness",
+    "tmux_agent_manager",
+    "context_scout",
+    "python",
+]);
+//# sourceMappingURL=session-role.js.map

package/dist/core/session-role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-role.js","sourceRoot":"","sources":["../../src/core/session-role.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAIrE,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAE9C,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAe;IACjF,IAAI,GAAG,CAAC,mBAAmB,CAAC,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC3D,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAChE,OAAO,MAAM,CAAC;AAAA,CACd;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAW;IAC9E,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;AAAA,CACxC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IAClE,MAAM;IACN,UAAU;IACV,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;IACd,UAAU;IACV,oBAAoB;IACpB,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,QAAQ;CACR,CAAC,CAAC","sourcesContent":["/**\n * Session-role identity: distinguishes a MAIN session (an interactive/direct `pi` session) from a\n * WORKER session (lane-bound or explicitly dispatched) — the seam every worker-scoped UAC ceiling\n * and zero-footprint store gates on (see runtime-builder.ts's `isAllowedTool`, the worktree_sync\n * tool's worker scoping, and the read-only store options threaded through the persistence layer).\n *\n * A session is a worker iff EITHER:\n * - `PI_SESSION_ROLE=worker` is set (an explicit launcher declaration), or\n * - it is bound to a worktree-sync lane (`PI_WORKTREE_LANE`; see worktree-sync/runtime.ts) — a\n *   lane-bound session is a worker by construction, regardless of how it was launched.\n *\n * `PI_SESSION_ROLE=main` is deliberately NOT an escalation: it can never override a bound lane.\n * There is no environment value a lane-bound process can set to shed the worker ceiling — the env\n * var is additive evidence for \"worker\", never a downgrade signal.\n */\n\nimport { getBoundWorktreeLaneKey } from \"./worktree-sync/runtime.ts\";\n\nexport type SessionRole = \"main\" | \"worker\";\n\nconst PI_SESSION_ROLE_ENV = \"PI_SESSION_ROLE\";\n\n/** Derive this process's session role from the environment (env-injectable for tests). */\nexport function getSessionRole(env: NodeJS.ProcessEnv = process.env): SessionRole {\n\tif (env[PI_SESSION_ROLE_ENV] === \"worker\") return \"worker\";\n\tif (getBoundWorktreeLaneKey(env) !== undefined) return \"worker\";\n\treturn \"main\";\n}\n\n/** True iff this process is a worker session (lane-bound or explicitly declared). */\nexport function isWorkerSession(env: NodeJS.ProcessEnv = process.env): boolean {\n\treturn getSessionRole(env) === \"worker\";\n}\n\n/**\n * Tools a worker session may never activate: the orchestration/self-adaptation surface that would\n * let a worker spawn its own sub-orchestration, mutate settings-driven learning/model state, or\n * shell out to the unbounded `python` execution contract. `python` is load-bearing for the\n * zero-footprint guarantee (it can write anywhere the interpreter can reach); `context_scout` is\n * sub-orchestration (spawns its own isolated agent loop). `bash` is deliberately NOT included: it\n * stays available as the documented cooperative boundary (see docs/worktree-sync.md) — the same\n * trust model the lane gate already applies to foreign CLIs it cannot structurally contain.\n */\nexport const WORKER_FORBIDDEN_TOOLS: ReadonlySet<string> = new Set([\n\t\"goal\",\n\t\"delegate\",\n\t\"delegate_status\",\n\t\"improvement_loop\",\n\t\"extensionify\",\n\t\"skillify\",\n\t\"run_toolkit_script\",\n\t\"model_fitness\",\n\t\"tmux_agent_manager\",\n\t\"context_scout\",\n\t\"python\",\n]);\n"]}

package/dist/core/settings-manager.d.ts

@@ -201,8 +201,41 @@ export interface WorkerDelegationSettings {
     maxConcurrent?: number;
 }
 export type ResolvedWorkerDelegationSettings = Required<Omit<WorkerDelegationSettings, "model" | "profile" | "systemPrompt">> & Pick<WorkerDelegationSettings, "model" | "profile" | "systemPrompt">;
+/** Staleness-propagation policy for worktree-sync; see `core/worktree-sync/codes.ts`. */
+export type WorktreeSyncPolicySetting = "on_land_mandatory" | "overlap_mandatory" | "land_time_only";
+export interface WorktreeSyncSettings {
+    enabled?: boolean;
+    mainBranch?: string;
+    syncPolicy?: WorktreeSyncPolicySetting;
+    gateCommand?: string;
+    gate?: "on" | "off";
+    gateTimeoutMs?: number;
+    maxLanes?: number;
+    worktreesRoot?: string;
+    workerLand?: "deny" | "allow";
+}
+export type ResolvedWorktreeSyncSettings = Required<Omit<WorktreeSyncSettings, "mainBranch" | "gateCommand" | "worktreesRoot">> & Pick<WorktreeSyncSettings, "mainBranch" | "gateCommand" | "worktreesRoot">;
+export declare const DEFAULT_WORKTREE_SYNC_POLICY: WorktreeSyncPolicySetting;
+export declare const DEFAULT_WORKTREE_SYNC_GATE_TIMEOUT_MS = 900000;
+export declare const DEFAULT_WORKTREE_SYNC_MAX_LANES = 5;
+/** Durable master/worker process-matrix supervision; see `core/process-matrix/`. */
+export interface ProcessMatrixSettings {
+    enabled?: boolean;
+    heartbeatMs?: number;
+    adoptionGraceMs?: number;
+    watcherPollMs?: number;
+}
+export type ResolvedProcessMatrixSettings = Required<ProcessMatrixSettings>;
+export declare const DEFAULT_PROCESS_MATRIX_HEARTBEAT_MS = 30000;
+export declare const DEFAULT_PROCESS_MATRIX_ADOPTION_GRACE_MS = 300000;
+export declare const DEFAULT_PROCESS_MATRIX_WATCHER_POLL_MS = 25000;
+/** Windows shell contract engine tier (`src/core/tools/windows-shell-engine.ts`). */
+export interface WindowsShellSettings {
+    pythonEngine?: boolean;
+}
+export type ResolvedWindowsShellSettings = Required<WindowsShellSettings>;
 export type LearningPolicyLayer = "memory" | "skill" | "prompt" | "extension" | "tool" | "script" | "settings" | "source";
-export declare const DEFAULT_LEARNING_POLICY_ENABLED = false;
+export declare const DEFAULT_LEARNING_POLICY_ENABLED = true;
 export declare const DEFAULT_LEARNING_POLICY_AUTO_APPLY_ENABLED = false;
 export declare const DEFAULT_LEARNING_POLICY_CONFIDENCE_THRESHOLD = 90;
 export declare const DEFAULT_LEARNING_POLICY_MIN_OBSERVATIONS = 2;
@@ -328,6 +361,9 @@ export interface Settings {
     autonomy?: AutonomySettings;
     researchLane?: ResearchLaneSettings;
     workerDelegation?: WorkerDelegationSettings;
+    worktreeSync?: WorktreeSyncSettings;
+    processMatrix?: ProcessMatrixSettings;
+    windowsShell?: WindowsShellSettings;
     learningPolicy?: LearningPolicySettings;
     modelCapability?: ModelCapabilitySettings;
     toolkit?: ToolkitSettings;
@@ -354,7 +390,7 @@ export interface ProfileDefinitionInput {
     thinking?: ThinkingLevel;
     modelRouter?: ModelRouterSettings;
     /**
-     * Situational identity (R6): a system-prompt prefix injected while this profile is active, so a
+     * Situational identity: a system-prompt prefix injected while this profile is active, so a
      * profile becomes a full "situation" = soul + capabilities + model/thinking, switched atomically.
      */
     soul?: string;
@@ -499,7 +535,7 @@ export declare class SettingsManager {
      */
     isResourceDeniedByActiveProfile(kind: ResourceProfileKind, resourcePath: string, baseDir?: string): boolean;
     /**
-     * Situational soul(s) of the currently active profile(s) (R6): a system-prompt identity prefix
+     * Situational soul(s) of the currently active profile(s): a system-prompt identity prefix
      * injected while the profile is active. Multiple active profiles' souls are concatenated.
      */
     getActiveProfileSoul(): string | undefined;
@@ -769,6 +805,9 @@ export declare class SettingsManager {
     setAutonomySettings(settings: AutonomySettings, scope?: SettingsScope): void;
     getResearchLaneSettings(): ResolvedResearchLaneSettings;
     setResearchLaneSettings(settings: ResearchLaneSettings, scope?: SettingsScope): void;
+    getWorktreeSyncSettings(): ResolvedWorktreeSyncSettings;
+    getProcessMatrixSettings(): ResolvedProcessMatrixSettings;
+    getWindowsShellSettings(): ResolvedWindowsShellSettings;
     getWorkerDelegationSettings(): ResolvedWorkerDelegationSettings;
     setWorkerDelegationSettings(settings: WorkerDelegationSettings, scope?: SettingsScope): void;
     getLearningPolicySettings(): ResolvedLearningPolicySettings;