sneakoscope 10.1.1 → 10.1.2

package/README.md

@@ -16,7 +16,7 @@
 Sneakoscope Codex (`sks`) is an open-source trust layer for Codex CLI and ChatGPT Desktop. It coordinates bounded AI coding agents, records machine-verifiable evidence, preserves project memory, and blocks release claims that are not supported by current tests or artifacts. Search visibility outcomes are measured separately; SKS does not promise rankings or traffic.
 <!-- END SKS SEARCH VISIBILITY MARKETING -->
 
-Current package: **SKS 10.1.1**. Install the latest stable release from npm.
+Current package: **SKS 10.1.2**. Install the latest stable release from npm.
 
 [Quick start](#install-in-one-command) · [Commands](#everyday-commands) · [SKS Center](#sks-center-macos) · [Documentation](#documentation) · [Changelog](CHANGELOG.md)
 
@@ -56,6 +56,13 @@ for setup boundaries and reported execution evidence.
 
 ## Everyday commands
 
+SKS enables experimental Astra context management by default during setup and
+repair. Turn it off in **SKS Center → Settings → Astra context management**, or
+use `sks codex-app context-management off`. Updates preserve an explicit opt-out.
+Start a new task after changing the setting. Availability depends on a supported
+Codex client and eligible ChatGPT sign-in; API-key and custom-provider sessions
+may not activate it. See [OpenAI's context management guidance](https://learn.chatgpt.com/docs/models#experimental-context-management).
+
 Use these inside a Codex conversation:
 
 | Command | Purpose |

package/crates/sks-core/Cargo.lock

@@ -259,7 +259,7 @@ dependencies = [
 
 [[package]]
 name = "sks-core"
-version = "10.1.1"
+version = "10.1.2"
 dependencies = [
  "globset",
  "grep-matcher",

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "10.1.1"
+version = "10.1.2"
 edition = "2021"
 
 [dependencies]

package/dist/cli/router.js

@@ -302,7 +302,7 @@ export function safeReadOnlySubcommand(command, args) {
     if (command === 'mcp' && sub === 'config' && ['list', 'test', 'backups', 'show'].includes(nested)) {
         return !args.some((arg) => ['--fix', '--yes', '-y', '--write', '--apply', '--execute', '--force', '--real'].includes(String(arg)));
     }
-    if (command === 'codex-app' && sub === 'context-1m' && (nested === 'status' || nested === '' || nested.startsWith('--'))) {
+    if (command === 'codex-app' && ['context-1m', 'context-management'].includes(sub) && (nested === 'status' || nested === '' || nested.startsWith('--'))) {
         return !args.some((arg) => ['--fix', '--yes', '-y', '--write', '--apply', '--execute', '--force', '--real'].includes(String(arg)));
     }
     if (command === 'remote' && ['readiness', 'status', 'show'].includes(sub)) {

package/dist/commands/codex-app.js

@@ -14,6 +14,17 @@ import { restartCodexApp } from '../core/codex-app/codex-app-restart.js';
 import { resetRoleModelPreference, roleModelPreferencesStatus, setRoleModelPreference } from '../core/subagents/role-model-preferences.js';
 export async function run(_command, args = []) {
     const action = args[0] || 'check';
+    if (action === 'context-management') {
+        const { contextManagementCommand } = await import('../core/codex-app/context-management-command.js');
+        const result = await contextManagementCommand(args.slice(1));
+        if (flag(args, '--json'))
+            printJson(result);
+        else
+            console.log(`${result.ok ? (result.enabled ? 'Enabled' : 'Disabled') : 'Unavailable'}: ${result.message}`);
+        if (!result.ok)
+            process.exitCode = 1;
+        return;
+    }
     if (action === 'restart')
         return printCodexAppResult(args, await restartCodexApp());
     if (action === 'context-1m') {
@@ -137,7 +148,7 @@ export async function run(_command, args = []) {
             process.exitCode = 1;
         return;
     }
-    console.error('Usage: sks codex-app check|status|restart|context-1m [status|on|off] [--no-restart]|harness-matrix|skill-sync|agent-role-sync|init-deep|hook-lifecycle|execution-profile|role-models|set-role-model --role <name> [--provider <id>] --model <catalog-slug> --reasoning <effort>|reset-role-model --role <name>|product-design [--check-only]|ensure-product-design|chrome-extension|pat status|remote-control [--json]');
+    console.error('Usage: sks codex-app check|status|restart|context-management [status|on|off]|context-1m [status|on|off] [--no-restart]|harness-matrix|skill-sync|agent-role-sync|init-deep|hook-lifecycle|execution-profile|role-models|set-role-model --role <name> [--provider <id>] --model <catalog-slug> --reasoning <effort>|reset-role-model --role <name>|product-design [--check-only]|ensure-product-design|chrome-extension|pat status|remote-control [--json]');
     console.error('Provider routing moved to: sks bridge provider configure|validate|enable; sks bridge catalog sync; sks bridge route set-default.');
     process.exitCode = 1;
 }

package/dist/config/skills-manifest.json

@@ -1,6 +1,6 @@
 {
   "schema": "sks.skills-manifest.v1",
-  "package_version": "10.1.1",
+  "package_version": "10.1.2",
   "skills": [
     {
       "canonical_name": "sks",

package/dist/core/codex/context-management.js

@@ -0,0 +1,55 @@
+import { parse } from 'smol-toml';
+import { isDeepStrictEqual } from 'node:util';
+export function contextManagementValue(text) {
+    const value = parse(text).features?.context_management?.experimental_mode;
+    if (value !== undefined && typeof value !== 'boolean')
+        throw new Error('context_management_invalid_boolean');
+    return value;
+}
+export function setContextManagement(text, enabled, onlyIfAbsent = false) {
+    const before = parse(text);
+    const current = contextManagementValue(text);
+    if (current === enabled || (onlyIfAbsent && current !== undefined))
+        return text;
+    const expected = structuredClone(before);
+    expected.features ??= {};
+    expected.features.context_management ??= {};
+    expected.features.context_management.experimental_mode = enabled;
+    const valid = (candidate) => {
+        try {
+            return isDeepStrictEqual(parse(candidate), expected);
+        }
+        catch {
+            return false;
+        }
+    };
+    if (current !== undefined) {
+        for (const match of text.matchAll(/\b(?:true|false)\b/g)) {
+            const candidate = text.slice(0, match.index) + String(enabled) + text.slice(match.index + match[0].length);
+            if (valid(candidate))
+                return candidate;
+        }
+    }
+    else {
+        const suffix = `\n[features.context_management]\nexperimental_mode = ${enabled}\n`;
+        if (valid(text + suffix))
+            return text + suffix;
+        const candidates = [
+            `features.context_management.experimental_mode = ${enabled}\n${text}`,
+            ...[...text.matchAll(/\{/g)].flatMap(match => {
+                const offset = match.index + 1;
+                const separator = /^\s*\}/.test(text.slice(offset)) ? '' : ', ';
+                return [`experimental_mode = ${enabled}`, `context_management = { experimental_mode = ${enabled} }`]
+                    .map(value => text.slice(0, offset) + value + separator + text.slice(offset));
+            }),
+            ...[...text.matchAll(/^\s*\[[^\n]+\][^\n]*(?:\n|$)/gm)].flatMap(match => {
+                const offset = match.index + match[0].length;
+                return ['experimental_mode', 'context_management.experimental_mode'].map(key => text.slice(0, offset) + `\n${key} = ${enabled}\n` + text.slice(offset));
+            }),
+        ];
+        for (const candidate of candidates)
+            if (valid(candidate))
+                return candidate;
+    }
+    throw new Error('context_management_config_edit_unsupported');
+}

package/dist/core/codex-app/context-management-command.js

@@ -0,0 +1,38 @@
+import fs from 'node:fs/promises';
+import { codexUserConfigPath } from './codex-model-catalog.js';
+import { writeCodexConfigGuarded } from '../codex/codex-config-guard.js';
+import { contextManagementValue, setContextManagement } from '../codex/context-management.js';
+export async function contextManagementCommand(args, options = {}) {
+    const configPath = codexUserConfigPath(options);
+    const action = args[0] || 'status';
+    try {
+        if (!['status', 'on', 'off'].includes(action) || args.slice(1).some(arg => arg !== '--json'))
+            throw new Error('context_management_invalid_arguments');
+        let exists = true;
+        const before = await fs.readFile(configPath, 'utf8').catch(error => { if (error.code !== 'ENOENT')
+            throw error; exists = false; return ''; });
+        let after = before;
+        let changed = false;
+        if (action !== 'status') {
+            const next = setContextManagement(before, action === 'on');
+            const write = await writeCodexConfigGuarded({
+                configPath, before, cause: 'context-management', removeTopLevelModeLocks: false,
+                verifyUnchangedBeforeWrite: true, expectedBeforeExists: exists, mutate: () => next,
+            });
+            if (!write.ok)
+                throw new Error(`context_management_write_${write.status}`);
+            after = await fs.readFile(configPath, 'utf8');
+            if (contextManagementValue(after) !== (action === 'on'))
+                throw new Error('context_management_readback_mismatch');
+            changed = write.changed;
+        }
+        const value = contextManagementValue(after);
+        return { schema: 'sks.context-management.v1', ok: true, enabled: value === true, configured: value !== undefined,
+            default_enabled: true, changed, config_path: configPath,
+            message: 'Applies to new tasks on supported Codex clients with eligible ChatGPT sign-in. API-key and custom-provider sessions may not activate it.' };
+    }
+    catch {
+        return { schema: 'sks.context-management.v1', ok: false, enabled: null, config_path: configPath,
+            message: 'Could not read or update the setting. Check the Codex configuration; existing content was not replaced without validation.' };
+    }
+}

package/dist/core/codex-runtime/codex-desktop-config-policy.js

@@ -1,4 +1,5 @@
 import os from 'node:os';
+import { setContextManagement } from '../codex/context-management.js';
 import path from 'node:path';
 import { DEFAULT_CODEX_APP_PLUGINS } from '../routes.js';
 import { ensureDir, PACKAGE_VERSION, readText, writeTextAtomic } from '../fsx.js';
@@ -95,6 +96,7 @@ function normalizeCodexFastModeUiConfigOnce(text = '', opts = {}) {
                 next = upsertTomlTable(next, table, `[${table}]\nenabled = true`);
         }
     }
+    next = setContextManagement(next, true, true);
     return ensureTrailingNewline(next);
 }
 function removeTopLevelTomlKey(text = '', key = '') {

package/dist/core/routes.js

@@ -644,7 +644,7 @@ export const COMMAND_CATALOG = [
     { name: 'uninstall', usage: 'sks uninstall [--dry-run] [--yes] [--keep-config] [--keep-data] [--purge-projects] [--json]', description: 'Remove SKS global skills, hooks, menu bar, state, temp files, and optional project residue while preserving user-owned content by default.' },
     { name: 'deps', usage: 'sks deps check [--json] [--yes]', description: 'Check Node/npm and Codex CLI readiness; pass --yes to repair missing Codex CLI tooling when supported.' },
     { name: 'codex', usage: 'sks codex compatibility|version|update-status [--refresh]|update|doctor|schema|current [--json]', description: 'Check Codex CLI compatibility/version/update status, run the official `codex update`, and inspect current manifest, capability, and hook-schema evidence.' },
-    { name: 'codex-app', usage: 'sks codex-app [check|status|restart|context-1m [status|on|off]|product-design|chrome-extension|pat status|remote-control]', description: 'Check Codex App integration, Desktop Bridge readiness, Product Design plugin readiness, Codex Chrome Extension web verification readiness, PAT-safe status, first-party MCP/plugin readiness, Codex CLI remote-control availability, and the opt-in GPT-5.6 Sol 1M context window toggle with automatic Codex restart. Provider routing is managed only by sks bridge.' },
+    { name: 'codex-app', usage: 'sks codex-app [check|status|restart|context-management [status|on|off]|context-1m [status|on|off]|product-design|chrome-extension|pat status|remote-control]', description: 'Check Codex App integration, Desktop Bridge readiness, Product Design plugin readiness, Codex Chrome Extension web verification readiness, PAT-safe status, first-party MCP/plugin readiness, Codex CLI remote-control availability, and the opt-in GPT-5.6 Sol 1M context window toggle with automatic Codex restart. Provider routing is managed only by sks bridge.' },
     { name: 'codex-native', usage: 'sks codex-native status|feature-broker|invocation-plan|init-deep [--json]', description: 'Inspect Codex Native feature broker readiness, invocation routing, pattern evidence, and managed memory setup.' },
     { name: 'hooks', usage: 'sks hooks explain|status|trust-report|replay|codex-validate|warning-check ... [--json]', description: 'Explain Codex hook events, validate current vendored event output schemas, replay fixtures, and enforce warning-zero SKS hook policies.' },
     { name: 'remote', usage: 'sks remote readiness|machines|worker ... [--json]', description: 'Inspect official Codex Remote readiness and the allowlisted proof-aware SSH stdio worker surface.' },

package/dist/core/version.js

@@ -1 +1 @@
-export const PACKAGE_VERSION = '10.1.1';
+export const PACKAGE_VERSION = '10.1.2';

package/dist/native/sks-menubar/Sources/SettingsViewController.swift

@@ -19,6 +19,11 @@ final class SettingsViewController: NSViewController, ControlCenterPage {
     private var contextEnabled: Bool?
     private var contextBusy = false
     private var contextGeneration = 0
+    private let memoryToggle = NSSwitch()
+    private let memoryStatus = NativeView.detail("Checking saved preference…")
+    private var memoryEnabled: Bool?
+    private var memoryBusy = false
+    private var memoryGeneration = 0
     init(processClient: ProcessClient, operations: OperationCoordinator, notifications: NotificationCoordinator) {
         self.processClient = processClient
         self.operations = operations
@@ -28,6 +33,17 @@ final class SettingsViewController: NSViewController, ControlCenterPage {
     required init?(coder: NSCoder) { nil }
 
     override func loadView() {
+        memoryToggle.target = self
+        memoryToggle.action = #selector(toggleContextManagement)
+        memoryToggle.isEnabled = false
+        memoryToggle.setAccessibilityLabel("Experimental context management")
+        memoryToggle.setAccessibilityIdentifier("sks-context-management-toggle")
+        memoryStatus.setAccessibilityIdentifier("sks-context-management-status")
+        let memoryCard = NativeView.card(
+            title: "Astra context management",
+            subtitle: "Experimental · Keep notes and retrieve earlier messages and tool results. Enabled by default in SKS. Applies to new tasks with supported Codex and eligible ChatGPT sign-in; API-key and custom-provider sessions may not activate it.",
+            views: [NativeView.row([memoryToggle, NativeView.detail("Enable experimental context management")]), memoryStatus]
+        )
         followCodexLifecycle.target = self; followCodexLifecycle.action = #selector(save)
         followCodexLifecycle.setAccessibilityLabel("Show SKS Menu only while Codex is running")
         notificationButton = NativeView.button("Enable Notifications", target: self, action: #selector(enableNotifications))
@@ -50,11 +66,12 @@ final class SettingsViewController: NSViewController, ControlCenterPage {
         )
         view = NativeView.page([
             ControlKit.header("Settings", "Choose how SKS works on this Mac."),
-            lifecycleCard, notificationsCard, NativeDisclosure("Advanced", views: [contextCard])
+            memoryCard, lifecycleCard, notificationsCard, NativeDisclosure("Advanced", views: [contextCard])
         ])
     }
 
     func refreshOnAppear() {
+        refreshContextManagement()
         refreshContext1m()
         let configResult = readConfig()
         switch configResult {
@@ -87,6 +104,53 @@ final class SettingsViewController: NSViewController, ControlCenterPage {
         }
     }
 
+    private func refreshContextManagement() {
+        guard !memoryBusy else { return }
+        memoryGeneration += 1
+        let generation = memoryGeneration
+        processClient.run(["codex-app", "context-management", "status", "--json"], timeout: NativeView.statusTimeout) { [weak self] result in
+            guard let self = self, !self.memoryBusy, generation == self.memoryGeneration else { return }
+            guard result.code == 0, let payload = self.json(result.output),
+                  payload["schema"] as? String == "sks.context-management.v1",
+                  payload["ok"] as? Bool == true, let enabled = payload["enabled"] as? Bool else {
+                self.memoryEnabled = nil
+                self.memoryToggle.isEnabled = false
+                self.memoryStatus.stringValue = "Saved setting unavailable. Check Codex configuration, then reopen Settings."
+                return
+            }
+            self.memoryEnabled = enabled
+            self.memoryToggle.state = enabled ? .on : .off
+            self.memoryToggle.isEnabled = true
+            self.memoryStatus.stringValue = enabled
+                ? "Setting enabled · start a new task to apply. Availability depends on Codex and your sign-in."
+                : "Setting disabled · your choice is preserved during updates."
+        }
+    }
+
+    @objc private func toggleContextManagement() {
+        guard !memoryBusy, let previous = memoryEnabled else { return }
+        let desired = memoryToggle.state == .on
+        guard let operation = operations.begin(kind: "context-management", mutationGroup: "codex-config", summary: "Change experimental context management") else {
+            memoryToggle.state = previous ? .on : .off
+            memoryStatus.stringValue = "Another configuration change is running. Try again when it finishes."
+            return
+        }
+        memoryBusy = true
+        memoryGeneration += 1
+        memoryToggle.isEnabled = false
+        memoryStatus.stringValue = "Saving preference…"
+        processClient.run(["codex-app", "context-management", desired ? "on" : "off", "--json"], timeout: NativeView.mutationTimeout) { [weak self] result in
+            guard let self = self else { return }
+            self.memoryBusy = false
+            let payload = self.json(result.output)
+            let ok = result.code == 0 && payload?["schema"] as? String == "sks.context-management.v1"
+                && payload?["ok"] as? Bool == true && payload?["enabled"] as? Bool == desired
+            _ = self.operations.update(operation, state: ok ? .succeeded : .failed, stage: "complete", progress: 1,
+                summary: ok ? "Preference saved. Start a new Codex task to apply." : "Save could not be confirmed. Rechecking the setting.")
+            self.refreshContextManagement()
+        }
+    }
+
     private func refreshContext1m(preserveStatusText: Bool = false) {
         contextGeneration += 1
         let requestGeneration = contextGeneration

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "ㅅㅋㅅ",
-  "version": "10.1.1",
+  "version": "10.1.2",
   "description": "Sneakoscope Codex (`sks`) is an open-source trust layer for Codex CLI and ChatGPT Desktop. It coordinates bounded AI coding agents, records machine-verifiable evidence, preserves project memory, and blocks release claims that are not supported by current tests or artifacts. Search visibility outcomes are measured separately; SKS does not promise rankings or traffic.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
@@ -196,7 +196,7 @@
   "dependencies": {
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/server": "2.0.0",
-    "@openai/codex-sdk": "0.150.1",
+    "@openai/codex-sdk": "0.153.4",
     "smol-toml": "^1.7.0",
     "typescript": "^5.9.3",
     "ws": "^8.21.3"