pi-ui-extend 1.0.41 → 1.0.42

package/dist/default-pix-config.js

@@ -6,6 +6,16 @@ export const DEFAULT_PIX_CONFIG_JSONC = String.raw `{
   "ignoreContextFiles": false,
   // Maximum pi session JSONL files to retain per project. 0 disables automatic deletion.
   "maxProjectSessions": 0,
+  "desktop": {
+    // External editor used by Pix Desktop's Project explorer: zed, code/vscode, cursor, subl, idea, webstorm, or an executable path/name.
+    "externalEditor": "zed",
+    "git": {
+      // LLM used for Source Control code review.
+      "reviewModelRef": "openai-codex/gpt-5.6-luna:medium",
+      // LLM used to generate commit messages from staged changes.
+      "commitMessageModelRef": "openai-codex/gpt-5.6-luna:minimal"
+    }
+  },
 
   "toolRenderer": {
     "default": { "previewLines": 0, "direction": "head", "color": "toolTitle" },

package/dist/schemas/index.d.ts

@@ -3,3 +3,4 @@
  */
 export { PixConfigSchema } from "./pix-schema.js";
 export { PiToolsSuiteConfigSchema } from "./pi-tools-suite-schema.js";
+export { ProjectTasksSchema } from "./tasks-schema.js";

package/dist/schemas/index.js

@@ -3,3 +3,4 @@
  */
 export { PixConfigSchema } from "./pix-schema.js";
 export { PiToolsSuiteConfigSchema } from "./pi-tools-suite-schema.js";
+export { ProjectTasksSchema } from "./tasks-schema.js";

package/dist/schemas/pi-tools-suite-schema.d.ts

@@ -21,6 +21,10 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
             chatId: Type.TOptional<Type.TString>;
         }>>;
     }>>;
+    commentChecker: Type.TOptional<Type.TObject<{
+        enabled: Type.TOptional<Type.TBoolean>;
+        strictness: Type.TOptional<Type.TUnion<[Type.TLiteral<"conservative">, Type.TLiteral<"balanced">, Type.TLiteral<"aggressive">]>>;
+    }>>;
     dcp: Type.TOptional<Type.TObject<{
         enabled: Type.TOptional<Type.TBoolean>;
         debug: Type.TOptional<Type.TBoolean>;
@@ -30,12 +34,13 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
         }>>;
         manualMode: Type.TOptional<Type.TObject<{
             enabled: Type.TOptional<Type.TBoolean>;
+            automaticStrategies: Type.TOptional<Type.TNever>;
         }>>;
         compress: Type.TOptional<Type.TObject<{
             maxContextPercent: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
             minContextPercent: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
-            modelMaxContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TNumber>>;
-            modelMinContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TNumber>>;
+            modelMaxContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+            modelMinContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
             maxContextLimit: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
             minContextLimit: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
             modelMaxContextLimits: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
@@ -80,68 +85,79 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
                 maxSuggestions: Type.TOptional<Type.TNumber>;
                 protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
             }>>;
+            deduplication: Type.TOptional<Type.TNever>;
+            purgeErrors: Type.TOptional<Type.TNever>;
+            autoToolPruning: Type.TOptional<Type.TNever>;
         }>>;
         protectedFilePatterns: Type.TOptional<Type.TArray<Type.TString>>;
-    }>>;
-    asyncSubagents: Type.TOptional<Type.TObject<{
-        defaultType: Type.TOptional<Type.TString>;
-        routing: Type.TOptional<Type.TObject<{
+        modelOverrides: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
             enabled: Type.TOptional<Type.TBoolean>;
-            model: Type.TOptional<Type.TString>;
-            fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
-            maxTaskChars: Type.TOptional<Type.TNumber>;
-            maxTokens: Type.TOptional<Type.TNumber>;
-            maxRetries: Type.TOptional<Type.TNumber>;
-            timeoutMs: Type.TOptional<Type.TNumber>;
             debug: Type.TOptional<Type.TBoolean>;
-        }>>;
-        vision: Type.TOptional<Type.TObject<{
-            blindModelPatterns: Type.TOptional<Type.TArray<Type.TString>>;
-        }>>;
-        presets: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
-            description: Type.TOptional<Type.TString>;
-            models: Type.TOptional<Type.TArray<Type.TString>>;
-            model: Type.TOptional<Type.TString>;
-            fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
-            thinking: Type.TOptional<Type.TString>;
-            extraArgs: Type.TOptional<Type.TArray<Type.TString>>;
-            timeoutMs: Type.TOptional<Type.TNumber>;
-            types: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
-                model: Type.TOptional<Type.TString>;
-                fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
-                thinking: Type.TOptional<Type.TString>;
-                extraArgs: Type.TOptional<Type.TArray<Type.TString>>;
-                timeoutMs: Type.TOptional<Type.TNumber>;
-            }>>>;
-        }>>>;
-        types: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
-            description: Type.TOptional<Type.TString>;
-            icon: Type.TOptional<Type.TString>;
-            models: Type.TOptional<Type.TArray<Type.TString>>;
-            model: Type.TOptional<Type.TString>;
-            fallbackModels: Type.TOptional<Type.TArray<Type.TString>>;
-            thinking: Type.TOptional<Type.TString>;
-            tools: Type.TOptional<Type.TArray<Type.TString>>;
-            isolatedSkills: Type.TOptional<Type.TArray<Type.TString>>;
-            extraArgs: Type.TOptional<Type.TArray<Type.TString>>;
-            promptAppend: Type.TOptional<Type.TString>;
-            promptOverride: Type.TOptional<Type.TString>;
-            retry: Type.TOptional<Type.TObject<{
-                maxRetries: Type.TOptional<Type.TNumber>;
-                backoffMs: Type.TOptional<Type.TNumber>;
-                retryableExitCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
+            debugLog: Type.TOptional<Type.TObject<{
+                maxBytes: Type.TOptional<Type.TNumber>;
+                maxBackups: Type.TOptional<Type.TNumber>;
+            }>>;
+            manualMode: Type.TOptional<Type.TObject<{
+                enabled: Type.TOptional<Type.TBoolean>;
+                automaticStrategies: Type.TOptional<Type.TNever>;
+            }>>;
+            compress: Type.TOptional<Type.TObject<{
+                maxContextPercent: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+                minContextPercent: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+                modelMaxContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+                modelMinContextPercent: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+                maxContextLimit: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+                minContextLimit: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TString]>>;
+                modelMaxContextLimits: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+                modelMinContextLimits: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TNumber, Type.TString]>>>;
+                summaryBuffer: Type.TOptional<Type.TBoolean>;
+                nudgeFrequency: Type.TOptional<Type.TNumber>;
+                iterationNudgeThreshold: Type.TOptional<Type.TNumber>;
+                nudgeForce: Type.TOptional<Type.TUnion<[Type.TLiteral<"strong">, Type.TLiteral<"soft">]>>;
+                protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
+                protectTags: Type.TOptional<Type.TBoolean>;
+                protectUserMessages: Type.TOptional<Type.TBoolean>;
+                autoCandidates: Type.TOptional<Type.TObject<{
+                    enabled: Type.TOptional<Type.TBoolean>;
+                    minContextPercent: Type.TOptional<Type.TNumber>;
+                    keepRecentTurns: Type.TOptional<Type.TNumber>;
+                    minMessages: Type.TOptional<Type.TNumber>;
+                    minTokens: Type.TOptional<Type.TNumber>;
+                }>>;
+                messageMode: Type.TOptional<Type.TObject<{
+                    enabled: Type.TOptional<Type.TBoolean>;
+                    minContextPercent: Type.TOptional<Type.TNumber>;
+                    keepRecentTurns: Type.TOptional<Type.TNumber>;
+                    mediumTokens: Type.TOptional<Type.TNumber>;
+                    highTokens: Type.TOptional<Type.TNumber>;
+                    maxSuggestions: Type.TOptional<Type.TNumber>;
+                }>>;
+                autoCompress: Type.TOptional<Type.TObject<{
+                    enabled: Type.TOptional<Type.TBoolean>;
+                    patience: Type.TOptional<Type.TNumber>;
+                    summarizerModel: Type.TOptional<Type.TArray<Type.TString>>;
+                    timeoutMs: Type.TOptional<Type.TNumber>;
+                }>>;
+            }>>;
+            strategies: Type.TOptional<Type.TObject<{
+                emergencyCurrentTurnPruning: Type.TOptional<Type.TObject<{
+                    enabled: Type.TOptional<Type.TBoolean>;
+                    hardContextPercent: Type.TOptional<Type.TNumber>;
+                    targetContextPercent: Type.TOptional<Type.TNumber>;
+                    patience: Type.TOptional<Type.TNumber>;
+                    keepRecentToolPairs: Type.TOptional<Type.TNumber>;
+                    minOutputTokens: Type.TOptional<Type.TNumber>;
+                    maxSuggestions: Type.TOptional<Type.TNumber>;
+                    protectedTools: Type.TOptional<Type.TArray<Type.TString>>;
+                }>>;
+                deduplication: Type.TOptional<Type.TNever>;
+                purgeErrors: Type.TOptional<Type.TNever>;
+                autoToolPruning: Type.TOptional<Type.TNever>;
             }>>;
-            maxResultBytes: Type.TOptional<Type.TNumber>;
-            timeoutMs: Type.TOptional<Type.TNumber>;
+            protectedFilePatterns: Type.TOptional<Type.TArray<Type.TString>>;
+            pruneNotification: Type.TOptional<Type.TNever>;
         }>>>;
-        maxConcurrent: Type.TOptional<Type.TNumber>;
-        retry: Type.TOptional<Type.TObject<{
-            maxRetries: Type.TOptional<Type.TNumber>;
-            backoffMs: Type.TOptional<Type.TNumber>;
-            retryableExitCodes: Type.TOptional<Type.TArray<Type.TNumber>>;
-        }>>;
-        maxResultBytes: Type.TOptional<Type.TNumber>;
-        timeoutMs: Type.TOptional<Type.TNumber>;
+        pruneNotification: Type.TOptional<Type.TNever>;
     }>>;
     toolRenderer: Type.TOptional<Type.TObject<{
         default: Type.TOptional<Type.TObject<{
@@ -184,6 +200,11 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
     repoDiscovery: Type.TOptional<Type.TObject<{
         profile: Type.TOptional<Type.TUnion<[Type.TLiteral<"baseline">, Type.TLiteral<"native-compact">]>>;
     }>>;
+    resourceRegistry: Type.TOptional<Type.TObject<{
+        remote: Type.TOptional<Type.TString>;
+        branch: Type.TOptional<Type.TString>;
+        projectKey: Type.TOptional<Type.TString>;
+    }>>;
     lsp: Type.TOptional<Type.TObject<{
         servers: Type.TOptional<Type.TArray<Type.TObject<{
             id: Type.TString;
@@ -206,5 +227,6 @@ export declare const PiToolsSuiteConfigSchema: Type.TObject<{
             settings: Type.TOptional<Type.TUnknown>;
         }>>>;
     }>>;
+    asyncSubagents: Type.TOptional<Type.TNever>;
 }>;
 export type PiToolsSuiteConfigSchemaType = Static<typeof PiToolsSuiteConfigSchema>;

package/dist/schemas/pi-tools-suite-schema.js

@@ -39,6 +39,7 @@ const TerminalBellConfig = Type.Object({
 // ---------------------------------------------------------------------------
 const DcpManualModeConfig = Type.Object({
     enabled: Type.Optional(Type.Boolean({ description: "Enable manual DCP mode." })),
+    automaticStrategies: Type.Optional(Type.Never({ description: "Removed legacy key. Manual mode now has only the explicit enabled flag." })),
 }, { description: "Manual mode configuration." });
 const DcpAutoCandidatesConfig = Type.Object({
     enabled: Type.Optional(Type.Boolean({ description: "Enable auto candidate selection for compression." })),
@@ -56,16 +57,16 @@ const DcpMessageModeConfig = Type.Object({
     maxSuggestions: Type.Optional(Type.Number({ description: "Maximum compression suggestions.", minimum: 0 })),
 }, { description: "Message-mode compression configuration." });
 const DcpAutoCompressConfig = Type.Object({
-    enabled: Type.Optional(Type.Boolean({ description: "Allow bounded automatic summary creation after pressure/opportunity gates." })),
+    enabled: Type.Optional(Type.Boolean({ description: "Allow autonomous compression after pressure/opportunity gates. Explicit compress calls can still use summarizerModel when summary is omitted." })),
     patience: Type.Optional(Type.Number({ description: "Completed actionable opportunities allowed before automatic compression.", minimum: 0 })),
-    summarizerModel: Type.Optional(Type.Array(Type.String(), { description: "Ordered summarizer model refs; empty uses the deterministic extractive summary." })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-summarizer deadline in milliseconds.", minimum: 1 })),
+    summarizerModel: Type.Optional(Type.Array(Type.String(), { description: "Ordered model refs used by auto-compress and explicit compress when summary is omitted; empty uses the deterministic extractive summary." })),
+    timeoutMs: Type.Optional(Type.Number({ description: "Per-summarizer deadline in milliseconds for automatic and explicit generated summaries.", minimum: 1 })),
 }, { description: "Bounded automatic compression fallback." });
 const DcpCompressConfig = Type.Object({
     maxContextPercent: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Maximum context percent (0–1 or '80%') before compression triggers." })),
     minContextPercent: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Target context percent after compression." })),
-    modelMaxContextPercent: Type.Optional(Type.Record(Type.String(), Type.Number(), { description: "Per-model max context percent overrides." })),
-    modelMinContextPercent: Type.Optional(Type.Record(Type.String(), Type.Number(), { description: "Per-model min context percent overrides." })),
+    modelMaxContextPercent: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model max context overrides using the same fraction/token/percent formats." })),
+    modelMinContextPercent: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model min context overrides using the same fraction/token/percent formats." })),
     maxContextLimit: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Absolute max context tokens or '200k'." })),
     minContextLimit: Type.Optional(Type.Union([Type.Number(), Type.String()], { description: "Absolute min context tokens." })),
     modelMaxContextLimits: Type.Optional(Type.Record(Type.String(), Type.Union([Type.Number(), Type.String()]), { description: "Per-model max context limit overrides." })),
@@ -93,7 +94,23 @@ const DcpEmergencyCurrentTurnPruningConfig = Type.Object({
 }, { description: "Single bounded emergency cleanup strategy." });
 const DcpStrategiesConfig = Type.Object({
     emergencyCurrentTurnPruning: Type.Optional(DcpEmergencyCurrentTurnPruningConfig),
+    deduplication: Type.Optional(Type.Never({ description: "Removed legacy key; no automatic replacement policy maps to it." })),
+    purgeErrors: Type.Optional(Type.Never({ description: "Removed legacy key; no automatic replacement policy maps to it." })),
+    autoToolPruning: Type.Optional(Type.Never({ description: "Removed legacy key. Use explicit /dcp sweep or DCP compression/emergency policies instead." })),
 }, { description: "Bounded DCP emergency strategy." });
+const DcpConfigOverride = Type.Object({
+    enabled: Type.Optional(Type.Boolean()),
+    debug: Type.Optional(Type.Boolean()),
+    debugLog: Type.Optional(Type.Object({
+        maxBytes: Type.Optional(Type.Number({ minimum: 1024 })),
+        maxBackups: Type.Optional(Type.Number({ minimum: 1 })),
+    })),
+    manualMode: Type.Optional(DcpManualModeConfig),
+    compress: Type.Optional(DcpCompressConfig),
+    strategies: Type.Optional(DcpStrategiesConfig),
+    protectedFilePatterns: Type.Optional(Type.Array(Type.String())),
+    pruneNotification: Type.Optional(Type.Never({ description: "Removed legacy key; pruning notifications are no longer configurable." })),
+}, { description: "Partial DCP override applied to a matching provider/model or bare-model key. Keys support * and ? wildcards." });
 const DcpConfig = Type.Object({
     enabled: Type.Optional(Type.Boolean({ description: "Enable DCP (Dynamic Context Pruning)." })),
     debug: Type.Optional(Type.Boolean({ description: "Enable DCP debug logging." })),
@@ -105,73 +122,10 @@ const DcpConfig = Type.Object({
     compress: Type.Optional(DcpCompressConfig),
     strategies: Type.Optional(DcpStrategiesConfig),
     protectedFilePatterns: Type.Optional(Type.Array(Type.String(), { description: "File path glob patterns whose content is protected from pruning." })),
+    modelOverrides: Type.Optional(Type.Record(Type.String(), DcpConfigOverride, { description: "Per-model partial DCP overrides. Exact keys take precedence over matching wildcards." })),
+    pruneNotification: Type.Optional(Type.Never({ description: "Removed legacy key; pruning notifications are no longer configurable." })),
 }, { description: "DCP (Dynamic Context Pruning) configuration." });
 // ---------------------------------------------------------------------------
-// Async subagents
-// ---------------------------------------------------------------------------
-const RetryConfig = Type.Object({
-    maxRetries: Type.Optional(Type.Number({ description: "Maximum retry attempts.", minimum: 0 })),
-    backoffMs: Type.Optional(Type.Number({ description: "Base delay in ms before first retry.", minimum: 0 })),
-    retryableExitCodes: Type.Optional(Type.Array(Type.Number(), { description: "Exit codes eligible for retry. Empty array disables retry." })),
-}, { description: "Retry configuration for sub-agents." });
-const SubagentRoutingConfig = Type.Object({
-    enabled: Type.Optional(Type.Boolean({ description: "Enable fallback LLM selection for omitted subagentType values. Explicit valid types bypass the router; when disabled, every spawn task must specify a valid type." })),
-    model: Type.Optional(Type.String({ description: "Router model in provider/model form." })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { uniqueItems: true, description: "Ordered router model fallbacks tried when the primary routing model is unavailable or fails. The current parent model is always tried last." })),
-    maxTaskChars: Type.Optional(Type.Number({ description: "Max task/scope characters sent to router.", minimum: 100 })),
-    maxTokens: Type.Optional(Type.Number({ description: "Max router response tokens.", minimum: 8 })),
-    maxRetries: Type.Optional(Type.Number({ description: "Router request retries.", minimum: 0 })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Router request timeout in ms.", minimum: 1000 })),
-    debug: Type.Optional(Type.Boolean({ description: "Show routing debug warnings." })),
-}, { description: "Fallback role routing for omitted types. Unknown explicit types or failed/incomplete routing reject the entire batch before any agents launch." });
-const SubagentVisionConfig = Type.Object({
-    blindModelPatterns: Type.Optional(Type.Array(Type.String(), { description: "Glob-like model refs treated as unable to inspect images." })),
-}, { description: "Vision capability overrides." });
-const SubagentPresetTypeOverride = Type.Object({
-    model: Type.Optional(Type.String({ description: "Model override for this type within the preset." })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Per-role fallback models." })),
-    thinking: Type.Optional(Type.String({ description: "Thinking level override." })),
-    extraArgs: Type.Optional(Type.Array(Type.String(), { description: "Extra CLI arguments." })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-agent wall-clock timeout in ms.", minimum: 1 })),
-}, { description: "Per-type override within a preset." });
-const SubagentPreset = Type.Object({
-    description: Type.Optional(Type.String({ description: "Preset description." })),
-    models: Type.Optional(Type.Array(Type.String({ pattern: "^[^\\s/*]+/[^\\s*]+$" }), { uniqueItems: true, description: "Available model pool. Filter the agent's ordered models by membership; pool order is ignored. Empty intersection rejects spawn. Oracle also respects this pool." })),
-    model: Type.Optional(Type.String({ description: "Legacy default model. Ignored when models is set.", deprecated: true })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Legacy fallback list. Ignored when models is set.", deprecated: true })),
-    thinking: Type.Optional(Type.String({ description: "Default thinking level." })),
-    extraArgs: Type.Optional(Type.Array(Type.String(), { description: "Extra CLI arguments." })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-agent wall-clock timeout in ms.", minimum: 1 })),
-    types: Type.Optional(Type.Record(Type.String(), SubagentPresetTypeOverride, { description: "Per-type overrides." })),
-}, { description: "Named available-model pool. Legacy model/types overrides remain supported; prefer models for new presets." });
-const SubagentTypeConfig = Type.Object({
-    description: Type.Optional(Type.String({ description: "Role description for routing." })),
-    icon: Type.Optional(Type.String({ description: "Agent icon name rendered by UIs (pix TUI icon themes and Pix Desktop lucide icons): agent, search, code, flask, globe, sparkles, brain, wrench, terminal, bug, book, eye, zap, rocket. Unknown names render as the neutral agent icon." })),
-    models: Type.Optional(Type.Array(Type.String({ pattern: "^[^\\s/*]+/[^\\s*]+$" }), { uniqueItems: true, description: "Ordered model candidates. First usable member of the preset pool runs; only remaining compatible members can be used on quota failure. Replaces legacy model/fallbackModels/modelByParent selection." })),
-    model: Type.Optional(Type.String({ description: "Legacy primary model; use models for new profiles.", deprecated: true })),
-    fallbackModels: Type.Optional(Type.Array(Type.String(), { description: "Legacy candidates after model; use models for a complete ranked list.", deprecated: true })),
-    thinking: Type.Optional(Type.String({ description: "Thinking level." })),
-    tools: Type.Optional(Type.Array(Type.String(), { description: "Enabled tools for this type." })),
-    isolatedSkills: Type.Optional(Type.Array(Type.String(), { description: "Explicit skill files loaded after disabling normal skill discovery for this type." })),
-    extraArgs: Type.Optional(Type.Array(Type.String(), { description: "Extra CLI arguments." })),
-    promptAppend: Type.Optional(Type.String({ description: "Extra prompt text appended after generated prompt." })),
-    promptOverride: Type.Optional(Type.String({ description: "Full prompt replacement." })),
-    retry: Type.Optional(RetryConfig),
-    maxResultBytes: Type.Optional(Type.Number({ description: "Max bytes in result summary.", minimum: 0 })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Per-agent wall-clock timeout in ms.", minimum: 1 })),
-}, { description: "Configuration for a sub-agent type/role." });
-const AsyncSubagentsConfig = Type.Object({
-    defaultType: Type.Optional(Type.String({ description: "Preferred role for genuinely ambiguous router tasks and legacy resolver default. Not used as a spawn fallback for missing/invalid routes." })),
-    routing: Type.Optional(SubagentRoutingConfig),
-    vision: Type.Optional(SubagentVisionConfig),
-    presets: Type.Optional(Type.Record(Type.String(), SubagentPreset, { description: "Named spawn presets." })),
-    types: Type.Optional(Type.Record(Type.String(), SubagentTypeConfig, { description: "Sub-agent type definitions." })),
-    maxConcurrent: Type.Optional(Type.Number({ description: "Max concurrent agents per spawn batch (0 = unlimited).", minimum: 0 })),
-    retry: Type.Optional(RetryConfig),
-    maxResultBytes: Type.Optional(Type.Number({ description: "Global max bytes in result summary.", minimum: 0 })),
-    timeoutMs: Type.Optional(Type.Number({ description: "Global per-agent wall-clock timeout in ms.", minimum: 1 })),
-}, { description: "Async sub-agent configuration." });
-// ---------------------------------------------------------------------------
 // Prompt commands
 // ---------------------------------------------------------------------------
 const PromptCommand = Type.Object({
@@ -185,20 +139,29 @@ const SecretFirewallConfig = Type.Object({
     sessionHygiene: Type.Optional(Type.Boolean({ description: "Redact detected secret material from tool results and completed messages before it remains in session history." })),
     notify: Type.Optional(Type.Boolean({ description: "Show a warning when one or more secrets are redacted. Secret values are never included in notifications." })),
 }, { description: "Settings for the opt-in credential-firewall module." });
+const CommentCheckerConfig = Type.Object({
+    enabled: Type.Optional(Type.Boolean({ description: "Enable or disable comment-checker without disabling the whole module." })),
+    strictness: Type.Optional(Type.Union([Type.Literal("conservative"), Type.Literal("balanced"), Type.Literal("aggressive")], { description: "Comment classification strictness. Defaults to balanced." })),
+}, { description: "Settings for the comment-checker module." });
 const ContextGatewayBudgetsConfig = Type.Object({
-    maxInlineBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Initial inline byte budget used by Context Gateway policy experiments. Default 8192." })),
-    maxResultBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Experimental delivered-result byte budget. P01 observe measures the available tool-result content boundary; later shaping must account for the final provider-visible serialization. Default 8192." })),
-    maxExactReadBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Future exact-read byte budget. Default 32768." })),
-    maxSearchBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Future search-delivery byte budget. Default 8192." })),
-    maxSearchMatches: Type.Optional(Type.Integer({ minimum: 1, maximum: 1000, description: "Future search match budget. Default 12." })),
-}, { description: "Context Gateway delivery budgets. In P01 only maxResultBytes is used for passive observe accounting." });
+    maxInlineBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Maximum inline size for a proven compact representation. Default 8192." })),
+    maxResultBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Budget for shell/other result classes. Selective enforce currently compacts only recognised complete simple test/build output. Default 8192." })),
+    maxExactReadBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Read-class observation budget. Reads remain passthrough because snapshot-safe recovery is not available. Default 32768." })),
+    maxSearchBytes: Type.Optional(Type.Integer({ minimum: 1, maximum: 67108864, description: "Repo-search/AST/structure observation budget. Gateway does not post-hoc truncate producer output. Default 8192." })),
+    maxSearchMatches: Type.Optional(Type.Integer({ minimum: 1, maximum: 1000, description: "Reserved search-match policy budget. Default 12." })),
+}, { description: "Context Gateway class-specific observation and selective-enforcement budgets." });
 const ContextGatewayConfig = Type.Object({
-    mode: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("observe"), Type.Literal("enforce")], { description: "Context Gateway mode. P01 implements off/observe; enforce is parsed but explicitly refused until later integration gates." })),
+    mode: Type.Optional(Type.Union([Type.Literal("off"), Type.Literal("observe"), Type.Literal("enforce")], { description: "Context Gateway mode. observe is passive; enforce only compacts proven complete simple test/build output and otherwise passes results through." })),
     budgets: Type.Optional(ContextGatewayBudgetsConfig),
 }, { description: "Context Gateway configuration. Default mode is off." });
 const RepoDiscoveryConfig = Type.Object({
     profile: Type.Optional(Type.Union([Type.Literal("baseline"), Type.Literal("native-compact")], { description: "repo_* runtime profile. baseline preserves historical argv/defaults; native-compact enables bounded native flags, cursors, validation, and an explicit per-call full override." })),
 }, { description: "Repository discovery runtime policy. Default profile is baseline." });
+const ResourceRegistryConfig = Type.Object({
+    remote: Type.Optional(Type.String({ description: "Git remote URL for the private registry. The repository contains reusable top-level skills/ and agents/ plus project-scoped state under projects/." })),
+    branch: Type.Optional(Type.String({ description: "Registry branch used for install/update/push/pull. Defaults to main." })),
+    projectKey: Type.Optional(Type.String({ description: "Optional explicit key for this project's projects/<key>/tasks.jsonc, plans/, and TODO.md state. Normally derived from the current Git origin." })),
+}, { description: "Private Git-backed registry for reusable skills/agents and project-scoped tasks/plans state." });
 // ---------------------------------------------------------------------------
 // LSP
 // ---------------------------------------------------------------------------
@@ -247,14 +210,16 @@ export const PiToolsSuiteConfigSchema = Type.Object({
     ]), { description: "Force per-todo thinking for matching provider/model or bare-model keys. Keys support * and ? wildcards; null removes an inherited override." })),
     lookupModel: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Vision-capable provider/model used by GLM's lookup tool; unset or null disables lookup." })),
     terminalBell: Type.Optional(TerminalBellConfig),
+    commentChecker: Type.Optional(CommentCheckerConfig),
     dcp: Type.Optional(DcpConfig),
-    asyncSubagents: Type.Optional(AsyncSubagentsConfig),
     toolRenderer: Type.Optional(ToolRendererConfig),
     promptCommands: Type.Optional(PromptCommandsConfig),
     secretFirewall: Type.Optional(SecretFirewallConfig),
     contextGateway: Type.Optional(ContextGatewayConfig),
     repoDiscovery: Type.Optional(RepoDiscoveryConfig),
+    resourceRegistry: Type.Optional(ResourceRegistryConfig),
     lsp: Type.Optional(LspConfig),
+    asyncSubagents: Type.Optional(Type.Never({ description: "Removed legacy key. Configure sub-agents in .pi/agents/*.md and model pools in .pi/agents/presets.jsonc." })),
 }, {
     $id: "https://unpkg.com/pi-ui-extend/schemas/pi-tools-suite.json",
     $schema: "https://json-schema.org/draft-07/schema#",

package/dist/schemas/pix-schema.d.ts

@@ -64,5 +64,12 @@ export declare const PixConfigSchema: Type.TObject<{
             label: Type.TString;
         }>>>;
     }>>;
+    desktop: Type.TOptional<Type.TObject<{
+        externalEditor: Type.TOptional<Type.TString>;
+        git: Type.TOptional<Type.TObject<{
+            reviewModelRef: Type.TOptional<Type.TString>;
+            commitMessageModelRef: Type.TOptional<Type.TString>;
+        }>>;
+    }>>;
 }>;
 export type PixConfigSchemaType = Static<typeof PixConfigSchema>;

package/dist/schemas/pix-schema.js

@@ -69,6 +69,19 @@ const DictationConfig = Type.Object({
     language: Type.Optional(Type.String({ description: "Selected language code, e.g. 'en' or 'ru'." })),
     languages: Type.Optional(Type.Record(Type.String(), DictationLanguageModelConfig, { description: "Available language models keyed by language code." })),
 }, { description: "Voice dictation (Vosk) configuration." });
+const DesktopConfig = Type.Object({
+    externalEditor: Type.Optional(Type.String({
+        description: "External editor used by Pix Desktop project explorer. Known aliases include zed, code/vscode, cursor, subl/sublime, idea/intellij, and webstorm; an executable path/name is also accepted.",
+    })),
+    git: Type.Optional(Type.Object({
+        reviewModelRef: Type.Optional(Type.String({
+            description: "Model reference used by Pix Desktop for LLM review of Git diffs, optionally with a :thinking suffix.",
+        })),
+        commitMessageModelRef: Type.Optional(Type.String({
+            description: "Model reference used by Pix Desktop to generate Git commit messages, optionally with a :thinking suffix.",
+        })),
+    }, { description: "Pix Desktop Git/Source Control LLM preferences." })),
+}, { description: "Pix Desktop-specific preferences." });
 // ---------------------------------------------------------------------------
 // Top-level schema
 // ---------------------------------------------------------------------------
@@ -85,6 +98,7 @@ export const PixConfigSchema = Type.Object({
     modelColors: Type.Optional(ModelColorsConfig),
     iconTheme: Type.Optional(IconThemeConfig),
     dictation: Type.Optional(DictationConfig),
+    desktop: Type.Optional(DesktopConfig),
 }, {
     $id: "https://unpkg.com/pi-ui-extend/schemas/pix.json",
     $schema: "https://json-schema.org/draft-07/schema#",

package/dist/schemas/tasks-schema.d.ts

@@ -0,0 +1,18 @@
+/** JSON Schema for project-scoped Desktop tasks stored in <cwd>/.pi/tasks.jsonc. */
+import { Static, Type } from "typebox";
+export declare const ProjectTasksSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    version: Type.TLiteral<1>;
+    tasks: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        title: Type.TString;
+        description: Type.TOptional<Type.TString>;
+        type: Type.TUnion<[Type.TLiteral<"bug">, Type.TLiteral<"feature">, Type.TLiteral<"improvement">]>;
+        status: Type.TUnion<[Type.TLiteral<"backlog">, Type.TLiteral<"todo">, Type.TLiteral<"in-progress">, Type.TLiteral<"done">]>;
+        priority: Type.TUnion<[Type.TLiteral<"low">, Type.TLiteral<"medium">, Type.TLiteral<"high">, Type.TLiteral<"urgent">]>;
+        sessionId: Type.TOptional<Type.TString>;
+        createdAt: Type.TString;
+        updatedAt: Type.TString;
+    }>>;
+}>;
+export type ProjectTasksSchemaType = Static<typeof ProjectTasksSchema>;

package/dist/schemas/tasks-schema.js

@@ -0,0 +1,41 @@
+/** JSON Schema for project-scoped Desktop tasks stored in <cwd>/.pi/tasks.jsonc. */
+import { Type } from "typebox";
+const TaskType = Type.Union([
+    Type.Literal("bug"),
+    Type.Literal("feature"),
+    Type.Literal("improvement"),
+]);
+const TaskStatus = Type.Union([
+    Type.Literal("backlog"),
+    Type.Literal("todo"),
+    Type.Literal("in-progress"),
+    Type.Literal("done"),
+]);
+const TaskPriority = Type.Union([
+    Type.Literal("low"),
+    Type.Literal("medium"),
+    Type.Literal("high"),
+    Type.Literal("urgent"),
+]);
+const ProjectTask = Type.Object({
+    id: Type.String({ minLength: 1, maxLength: 128, description: "Stable unique task id." }),
+    title: Type.String({ minLength: 1, maxLength: 200, description: "Short task title." }),
+    description: Type.Optional(Type.String({ maxLength: 10_000, description: "Optional detailed task description." })),
+    type: TaskType,
+    status: TaskStatus,
+    priority: TaskPriority,
+    sessionId: Type.Optional(Type.String({ minLength: 1, maxLength: 512, description: "Optional Pi session associated with this task." })),
+    createdAt: Type.String({ format: "date-time", description: "RFC 3339 creation timestamp." }),
+    updatedAt: Type.String({ format: "date-time", description: "RFC 3339 last-update timestamp." }),
+}, { additionalProperties: false });
+export const ProjectTasksSchema = Type.Object({
+    $schema: Type.Optional(Type.String({ description: "JSON Schema URL used by editors for validation and autocomplete." })),
+    version: Type.Literal(1, { description: "Task document format version." }),
+    tasks: Type.Array(ProjectTask, { maxItems: 10_000, description: "Project tasks. Task ids must be unique." }),
+}, {
+    $id: "https://unpkg.com/pi-ui-extend/schemas/tasks.json",
+    $schema: "https://json-schema.org/draft-07/schema#",
+    title: "Pix Project Tasks",
+    description: "Project-scoped task document stored in <cwd>/.pi/tasks.jsonc.",
+    additionalProperties: false,
+});

package/docs/concurrency.md

@@ -1,9 +1,15 @@
 # Spec: Application concurrency and lifecycle safety
 
+<!-- markdownlint-disable MD013 -->
+
 ## Type
 
 Change
 
+## Lifecycle
+
+Active implemented contract.
+
 ## Goal
 
 Keep tab, session, editor, extension UI, persistence, and shutdown work bound to

package/docs/desktop-mvp.md

@@ -4,6 +4,13 @@
 
 Change
 
+## Lifecycle
+
+Historical baseline. This document records the first Desktop vertical slice and
+still contains useful process-host/ACP transport contracts, but it is no longer
+the current feature-scope inventory. Later implemented Desktop behavior is
+specified by the `specs/desktop-*.md` family.
+
 ## Goal
 
 Provide a lightweight desktop client for Pix using Tauri 2 and Svelte 5 +
@@ -21,7 +28,11 @@ updates, cancel a running turn, and answer extension elicitations.
   elicitations.
 - Development commands and a documented local setup path.
 
-## Non-goals
+## MVP-era non-goals
+
+The items below were intentionally out of scope for the first slice. Several
+were implemented later and are governed by newer feature specs; they are not
+current product non-goals.
 
 - Feature parity with `PiUiExtendApp`.
 - Voice input, an embedded terminal, custom widgets, image attachments,