arkaos 4.22.0 → 4.23.0

package/departments/sales/SKILL.md

@@ -7,8 +7,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/challenger-sell/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/deal-qualify/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/discovery-call/SKILL.md

@@ -11,8 +11,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/forecast-revenue/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/negotiate-plan/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/objection-handle/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/pipeline-manage/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/sales/skills/pricing-negotiate/SKILL.md

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/SKILL.md

@@ -8,8 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/blue-ocean/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/bmc/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/board-advisor/SKILL.md

@@ -15,8 +15,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/cto-advisor/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/extract-data/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/five-forces/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/growth-strategy/SKILL.md

@@ -17,8 +17,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/moat-analysis/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/position/SKILL.md

@@ -15,8 +15,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/strategy/skills/scenario-plan/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/installer/config-seed.js

@@ -5,9 +5,12 @@
 // user choice (true OR false) is always preserved.
 //
 // Seeded template keys (operator decisions):
-//   hooks.hardEnforcement = true   (PR19 v2.41.0)
-//   hooks.kbFirst         = true   (PR-3 v4.1 — KB-first ON out of the box)
-//   memory.sessionMemory  = true   (F1-A2 — session semantic memory ON)
+//   hooks.hardEnforcement       = true   (PR19 v2.41.0)
+//   hooks.kbFirst               = true   (PR-3 v4.1 — KB-first ON out of the box)
+//   memory.sessionMemory        = true   (F1-A2 — session semantic memory ON)
+//   knowledge.graphify.enabled  = true   (graphify HTTP — "active once configured".
+//                                          Applies only when a url + token are also
+//                                          set; a fresh user with no endpoint is a no-op.)
 //
 // Returns a status object:
 //   { action: "created" | "added-key" | "noop"
@@ -28,37 +31,31 @@ const SEEDED_SECTIONS = {
   memory: ["sessionMemory"],
 };
 
+// Nested boolean seeds: [section, subsection, key, value]. Same idempotent
+// contract as SEEDED_SECTIONS (seed only when unset, preserve explicit
+// user choice), but for keys nested two levels deep. graphify.enabled means
+// "be active once a url + token exist" — it never activates on its own.
+const NESTED_SEEDS = [
+  ["knowledge", "graphify", "enabled", true],
+];
+
 function defaultConfig() {
   const config = {};
   for (const [section, keys] of Object.entries(SEEDED_SECTIONS)) {
     config[section] = {};
     for (const key of keys) config[section][key] = true;
   }
+  for (const [section, sub, key, value] of NESTED_SEEDS) {
+    config[section] = config[section] || {};
+    config[section][sub] = config[section][sub] || {};
+    config[section][sub][key] = value;
+  }
   return config;
 }
 
-export function seedArkaosConfig({ home = homedir() } = {}) {
-  const cfgPath = join(home, ".arkaos", "config.json");
-
-  if (!existsSync(cfgPath)) {
-    writeConfig(cfgPath, defaultConfig());
-    return { action: "created", path: cfgPath };
-  }
-
-  let config;
-  try {
-    config = JSON.parse(readFileSync(cfgPath, "utf-8"));
-    if (typeof config !== "object" || config === null) {
-      throw new Error("config root is not an object");
-    }
-  } catch {
-    // Corrupt JSON — keep the broken copy for recovery, write safe default.
-    const backup = `${cfgPath}.broken-${Date.now()}`;
-    try { copyFileSync(cfgPath, backup); } catch { /* best effort */ }
-    writeConfig(cfgPath, defaultConfig());
-    return { action: "rewrote-corrupt", path: cfgPath, backup };
-  }
-
+// Seed the one-level keys in SEEDED_SECTIONS: write only when unset, never
+// clobber an explicit true/false.
+function applyFlatSeeds(config) {
   let added = false;
   let preservedFalse = false;
   for (const [section, keys] of Object.entries(SEEDED_SECTIONS)) {
@@ -76,6 +73,65 @@ export function seedArkaosConfig({ home = homedir() } = {}) {
       added = true;
     }
   }
+  return { added, preservedFalse };
+}
+
+// Seed the two-level keys in NESTED_SEEDS, same contract as the flat ones:
+// write only when unset, never clobber an explicit true/false.
+// Extracted so seedArkaosConfig stays under the 30-line Clean Code limit.
+function applyNestedSeeds(config) {
+  let added = false;
+  let preservedFalse = false;
+  for (const [section, sub, key, value] of NESTED_SEEDS) {
+    const sec = config[section];
+    config[section] = sec && typeof sec === "object" ? sec : {};
+    const subObj = config[section][sub];
+    config[section][sub] = subObj && typeof subObj === "object" ? subObj : {};
+    const current = config[section][sub][key];
+    if (current === true || current === false) {
+      if (current === false) preservedFalse = true; // explicit user choice
+      continue;
+    }
+    config[section][sub][key] = value;
+    added = true;
+  }
+  return { added, preservedFalse };
+}
+
+// Load the config for seeding. Returns {config} when there is something to
+// seed, or {done} when the file was absent or corrupt and has been written
+// from the template — in which case the caller returns that status as-is.
+function loadOrReset(cfgPath) {
+  if (!existsSync(cfgPath)) {
+    writeConfig(cfgPath, defaultConfig());
+    return { done: { action: "created", path: cfgPath } };
+  }
+  try {
+    const config = JSON.parse(readFileSync(cfgPath, "utf-8"));
+    if (typeof config !== "object" || config === null) {
+      throw new Error("config root is not an object");
+    }
+    return { config };
+  } catch {
+    // Corrupt JSON — keep the broken copy for recovery, write safe default.
+    const backup = `${cfgPath}.broken-${Date.now()}`;
+    try { copyFileSync(cfgPath, backup); } catch { /* best effort */ }
+    writeConfig(cfgPath, defaultConfig());
+    return { done: { action: "rewrote-corrupt", path: cfgPath, backup } };
+  }
+}
+
+export function seedArkaosConfig({ home = homedir() } = {}) {
+  const cfgPath = join(home, ".arkaos", "config.json");
+
+  const loaded = loadOrReset(cfgPath);
+  if (loaded.done) return loaded.done;
+  const config = loaded.config;
+
+  const flat = applyFlatSeeds(config);
+  const nested = applyNestedSeeds(config);
+  const added = flat.added || nested.added;
+  const preservedFalse = flat.preservedFalse || nested.preservedFalse;
 
   if (added) {
     writeConfig(cfgPath, config);