superlocalmemory 3.7.8 → 3.8.0

package/plugin-src/skills/slm-scope/SKILL.md

@@ -0,0 +1,176 @@
+---
+name: slm-scope
+description: Controls memory visibility across profiles — personal (private, default), shared (selected profiles), or global (all profiles on this machine). Default is always personal. Only change scope when the user explicitly asks to share a memory across workspaces. Works with both remember (write scope) and recall (read scope flags).
+when_to_use: |
+  - "Share this memory with the team profile"
+  - "Store this globally so all my agents can see it"
+  - "Recall anything shared from the work profile"
+  - "Can other agents on this machine see my memories?"
+  - User explicitly asks to cross-profile share a fact or see shared facts
+  - Enterprise setup where multiple profiles collaborate
+allowed-tools: remember, recall, search, list_recent, Bash
+---
+
+# slm-scope — Memory Scope and Sharing Model
+
+SuperLocalMemory is profile-isolated by default. Every profile is a fully
+independent memory namespace. The scope model adds controlled, opt-in sharing
+between profiles on the same machine — it is never active unless you explicitly
+set it.
+
+---
+
+## The Three Scopes
+
+| Scope | Visibility | When to use |
+|-------|-----------|-------------|
+| `personal` | Active profile only | Default — all facts. Never set explicitly. |
+| `shared` | Active profile + `shared_with` profiles | Team handoffs, shared project context |
+| `global` | Every profile on this machine | Machine-wide conventions, org-wide rules |
+
+**The default is always `personal`.** A fact stored without a `scope` argument
+is private to the profile that stored it. Recall without scope flags returns only
+personal facts. This is identical to single-profile SLM.
+
+---
+
+## Opt-in is mandatory
+
+Never set `scope="shared"` or `scope="global"` (or the recall equivalents
+`include_shared`, `include_global`) unless the user explicitly asks you to share
+or read across profiles. This is a hard rule — scope expansion is an action with
+team-wide or machine-wide impact, and it must always be user-initiated.
+
+---
+
+## Writing a shared or global fact
+
+### share with specific profiles
+
+```
+remember(
+  content="API gateway rate limit is 1000 req/min per client",
+  tags="api,limits,ops",
+  project="platform",
+  importance=8,
+  session_id="<sid>",
+  scope="shared",
+  shared_with="devops-profile,backend-profile",
+)
+```
+
+`shared_with` is a comma-separated list of profile IDs that should be able to
+recall this fact. Use `slm status` to see the current profile name — that is the
+`profile_id` to supply.
+
+### share with all profiles on the machine
+
+```
+remember(
+  content="All services must enforce TLS 1.3 minimum",
+  tags="security,tls,global",
+  project="infra",
+  importance=9,
+  session_id="<sid>",
+  scope="global",
+)
+```
+
+`scope="global"` makes the fact visible to every profile on this machine. Use
+this only for machine-wide conventions (security rules, org-wide constraints).
+
+---
+
+## Reading shared or global facts
+
+By default, `recall` returns only the active profile's personal facts. To surface
+shared and global facts, pass the opt-in flags:
+
+```
+recall(
+  query="rate limiting rules",
+  limit=20,
+  include_global=True,   # include global-scope facts
+  include_shared=True,   # include facts shared with this profile
+  session_id="<sid>",
+)
+```
+
+You can opt in to either or both flags independently. Only the active profile's
+permitted shared facts are returned — you cannot read another profile's personal
+facts.
+
+### CLI equivalents
+
+```bash
+# Recall with global facts included
+slm recall "rate limiting rules" --include-global
+
+# Recall with shared facts included
+slm recall "rate limiting rules" --include-shared
+
+# Both
+slm recall "rate limiting rules" --include-global --include-shared
+
+# Store a global fact
+slm remember "TLS 1.3 minimum" --scope global
+
+# Store a shared fact (shared-with is a comma-separated list of profile IDs)
+slm remember "API rate limit 1000/min" --scope shared --shared-with devops,backend
+```
+
+CLI flags verified in source: `--include-global` / `--no-global`, `--include-shared` / `--no-shared`,
+`--scope personal|shared|global`, `--shared-with <profile-ids>`.
+
+---
+
+## Configuring scope defaults
+
+Per-profile defaults live in `mode_a/b/c.json` configuration. To make a profile
+always include global facts without passing flags each time:
+
+```json
+{
+  "recall": {
+    "include_global": true,
+    "include_shared": false
+  }
+}
+```
+
+Changing the default requires editing the profile config directly — this is an
+admin-level operation.
+
+---
+
+## Enterprise governance
+
+In a governed workspace (admin/member/viewer roles), scope expansion may be
+restricted:
+- **Viewers** cannot write `scope="global"` facts — their writes are always `personal`.
+- **Members** can write `scope="shared"` with profiles in their access list.
+- **Admins** can write `scope="global"` unrestricted.
+
+See `slm-governance` for the full enterprise behavior model.
+
+---
+
+## Scope deletion and retention
+
+A `scope="global"` fact deleted by one profile is deleted for all profiles. A
+`scope="shared"` fact is deleted from all profiles that had access to it.
+Use `slm forget "<query>" --dry-run` before any deletion involving shared facts
+to review the impact. See `slm-remember` for the full deletion discipline.
+
+---
+
+## Related skills
+
+- `slm-remember` — full fact storage reference including scope parameters
+- `slm-recall` — full retrieval reference including include_global/include_shared
+- `slm-profile` — what a profile is and how to switch between them
+- `slm-governance` — enterprise role restrictions on scope
+
+---
+
+*SuperLocalMemory v3.8.0 · Qualixar · AGPL-3.0-or-later*

package/plugin-src/skills/slm-session/SKILL.md

@@ -204,4 +204,27 @@ slm doctor [--json]    # preflight check including daemon and embedding worker
 
 ---
 
-*SuperLocalMemory v3.6.18 · Qualixar · AGPL-3.0-or-later*
+## Profile context (v3.8.0+)
+
+`session_init` operates on the currently active profile. If you need to start
+a session on a different workspace, call `switch_profile` (requires `code`,
+`full`, or `power` MCP profile) before `session_init`, then call `session_init`
+for that workspace. See `slm-profile` for workspace switching.
+
+The returned `memories` array reflects facts stored in the active profile only.
+To also surface shared or global facts in the initial context, pass the query
+explicitly and call `recall` with `include_global`/`include_shared` after
+`session_init`. See `slm-scope` for the sharing model.
+
+---
+
+## Related skills
+
+- `slm-recall` — multi-channel retrieval during the session
+- `slm-remember` — store durable facts during the session
+- `slm-profile` — workspace isolation and profile switching
+- `slm-scope` — multi-scope sharing model
+
+---
+
+*SuperLocalMemory v3.8.0 · Qualixar · AGPL-3.0-or-later*

package/plugin-src/skills/slm-status/SKILL.md

@@ -146,4 +146,21 @@ Note: the `slm optimize` subcommands have known pre-existing parse-test failures
 
 ---
 
-SuperLocalMemory v3.6.18 · Qualixar · AGPL-3.0-or-later
+## Profile-aware status (v3.8.0+)
+
+`slm status --json` reports the currently active profile name in the `profile`
+field. Use this to confirm which workspace is active before starting work on a
+multi-profile setup. To switch the active profile, see `slm-profile`.
+
+---
+
+## Related skills
+
+- `slm-session` — session lifecycle (session_init/close_session)
+- `slm-profile` — workspace isolation and profile switching
+- `slm-cache` — KV cache performance metrics
+- `slm-compress` — reversible context compression
+
+---
+
+SuperLocalMemory v3.8.0 · Qualixar · AGPL-3.0-or-later

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.7.8"
+version = "3.8.0"
 description = "Local-first agent memory with auditable hybrid retrieval"
 readme = "README.md"
 license = "AGPL-3.0-or-later"

package/scripts/postinstall/validation.js

@@ -44,6 +44,8 @@ function validateReplyFileSchema(obj) {
     consolidation_cadence: { type: 'string' },
     inline_entity_detection: { type: 'boolean' },
     telemetry: { type: 'string' },
+    // v3.8.0 — deployment mode (personal|enterprise)
+    deployment: { type: 'string', enum: ['personal', 'enterprise'] },
   };
   for (const key of Object.keys(obj)) {
     if (!Object.prototype.hasOwnProperty.call(schema, key)) {

package/scripts/postinstall-interactive.js

@@ -144,6 +144,8 @@ function parseArgs(argv) {
     home: null,
     replyFile: null,
     homeOutsideHome: false, // H-10: opt-in flag for --home outside $HOME
+    // v3.8.0: deployment mode — "personal" | "enterprise" (default: personal)
+    deployment: null,
   };
   for (const a of argv) {
     if (a === '--dry-run') args.dryRun = true;
@@ -152,6 +154,11 @@ function parseArgs(argv) {
     else if (a.startsWith('--profile=')) args.profile = a.slice('--profile='.length);
     else if (a.startsWith('--home=')) args.home = a.slice('--home='.length);
     else if (a.startsWith('--reply-file=')) args.replyFile = a.slice('--reply-file='.length);
+    else if (a.startsWith('--deployment=')) {
+      const val = a.slice('--deployment='.length).toLowerCase();
+      // Only accept known presets; silently ignore anything else (safe default: personal)
+      args.deployment = (val === 'enterprise') ? 'enterprise' : 'personal';
+    }
   }
   return args;
 }
@@ -165,6 +172,22 @@ const {
   validateHomePath,
 } = require('./postinstall/validation.js');
 
+// v3.8.0 — deployment mode helpers (personal vs enterprise)
+const {
+  DEPLOYMENT_PRESETS,
+  DEFAULT_DEPLOYMENT_MODE,
+  promptDeploymentMode,
+  renderDeploymentBlock,
+} = require('./postinstall/deployment.js');
+
+// v3.8.0 — IDE multi-select + non-destructive connect
+const {
+  IDE_IDS,
+  IDE_DISPLAY,
+  promptIdeMultiselect,
+  executeIdeConnections,
+} = require('./postinstall/ide-multiselect.js');
+
 // ------------------------------------------------------------------------
 // TTY detection
 // ------------------------------------------------------------------------
@@ -198,8 +221,22 @@ function probeColdStartMs() {
   // synchronous spawn with timeout to keep total benchmark ≤15s.
   try {
     const { spawnSync } = require('child_process');
+    // Windows has no `python3`; use the py launcher (`py -3`) or fall back to
+    // `python`. Probing the wrong name returns a pessimistic estimate and
+    // downgrades the recommended profile on every Windows install.
+    let pythonBin = 'python3';
+    let pythonArgs = ['-c', 'pass'];
+    if (process.platform === 'win32') {
+      if (spawnSync('py', ['-3', '-c', 'pass'], { timeout: 1000 }).status === 0) {
+        pythonBin = 'py';
+        pythonArgs = ['-3', '-c', 'pass'];
+      } else {
+        pythonBin = 'python';
+        pythonArgs = ['-c', 'pass'];
+      }
+    }
     const start = Date.now();
-    const r = spawnSync('python3', ['-c', 'pass'], { timeout: 5000 });
+    const r = spawnSync(pythonBin, pythonArgs, { timeout: 5000 });
     const elapsed = Date.now() - start;
     if (r.error || r.status !== 0) return 2000; // pessimistic
     return elapsed;
@@ -337,6 +374,11 @@ function renderConfigToml(config) {
   lines.push('[telemetry]');
   lines.push(`mode = ${tomlEscape(config.telemetry)}`);
   lines.push('');
+  // v3.8.0: [deployment] block — only serialised for non-personal modes to
+  // avoid churning existing config.toml files (no-churn contract).
+  // renderDeploymentBlock() returns [] for personal (the default).
+  const depLines = renderDeploymentBlock(config.deployment || null);
+  for (const dl of depLines) lines.push(dl);
   return lines.join('\n');
 }
 
@@ -626,12 +668,16 @@ async function main() {
     console.log(downgrade.line);
   }
 
+  // v3.8.0: resolve deployment preset (personal default; --deployment flag or TTY prompt).
+  let deploymentPreset = DEPLOYMENT_PRESETS[args.deployment] || DEPLOYMENT_PRESETS.personal;
+
   if (args.profile === 'custom' || (replyFileContents && replyFileContents.profile === 'custom')) {
     config = buildCustomConfig(replyFileContents || {});
   } else if (args.profile && PROFILES[args.profile]) {
     config = { profile: args.profile, ...PROFILES[args.profile] };
   } else if (nonInteractive) {
     // Non-TTY: silently apply recommended (benchmark-driven) profile.
+    // Deployment defaults to personal (no change to existing non-TTY behaviour).
     config = { profile: recommended, ...PROFILES[recommended] };
   } else {
     // Interactive TTY flow.
@@ -641,11 +687,24 @@ async function main() {
     });
     try {
       config = await runInteractiveFlow(rl, recommended);
+      // v3.8.0: deployment question (only in TTY if no --deployment flag given)
+      if (!args.deployment) {
+        deploymentPreset = await promptDeploymentMode(rl);
+      }
+      // v3.8.0: IDE multi-select (TTY only)
+      const selectedIdes = await promptIdeMultiselect(rl);
+      if (selectedIdes.length > 0) {
+        // Deferred — don't close rl yet so output lands before close message.
+        config._pendingIdes = selectedIdes;
+      }
     } finally {
       rl.close();
     }
   }
 
+  // Attach deployment to config object so renderConfigToml can serialise it.
+  config.deployment = deploymentPreset;
+
   // Dry-run: report only, no write.
   if (args.dryRun) {
     console.log('SLM dry-run: would write profile=' + config.profile +
@@ -692,12 +751,17 @@ async function main() {
       fs.closeSync(fd);
     }
     fs.renameSync(tmpPath, cfgPath);
-    console.log('SLM: wrote config.toml for profile=' + config.profile);
+    console.log('SLM: wrote config.toml for profile=' + config.profile +
+      (config.deployment && config.deployment.mode !== 'personal'
+        ? ' deployment=' + config.deployment.mode
+        : ''));
   } catch (e) {
     console.error('SLM: failed to write config.toml: ' + e.message);
     return 4;
   }
 
+  // v3.8.0: Execute IDE connections after config write so state is consistent.
+  if (config._pendingIdes) executeIdeConnections(config._pendingIdes, slmDir);
 
   // UX-G2: show the one-screen delta banner so upgraders see what shipped.
   printLivingBrainDelta();
@@ -736,4 +800,12 @@ module.exports = {
   PROFILES,
   CUSTOM_KNOB_ENUMS, // UX-M3
   printLivingBrainDelta, // UX-G2 (exposed for the test harness only)
+  // v3.8.0 — deployment
+  DEPLOYMENT_PRESETS,
+  DEFAULT_DEPLOYMENT_MODE,
+  renderDeploymentBlock,
+  // v3.8.0 — IDE multi-select
+  IDE_IDS,
+  IDE_DISPLAY,
+  executeIdeConnections,
 };

package/src/superlocalmemory/__init__.py

@@ -32,7 +32,7 @@ if "OMP_NUM_THREADS" not in os.environ:
     os.environ["OMP_NUM_THREADS"] = "2"
 # ---------------------------------------------------------------------------
 
-__version__ = "3.7.8"
+__version__ = "3.8.0"
 
 _REQUIRED_VERSIONS = {
     "sentence_transformers": "5.3.0",

package/src/superlocalmemory/access/__init__.py

@@ -0,0 +1,3 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under AGPL-3.0-or-later - see LICENSE file
+"""SLM access control (RBAC) package."""