@1agh/maude 0.47.0 → 0.48.0

package/cli/lib/ddr-to-kgai.test.mjs

@@ -0,0 +1,99 @@
+import assert from 'node:assert/strict';
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { test } from 'node:test';
+import { buildDdrBatch } from './ddr-to-kgai.mjs';
+
+function fixtureDir(files) {
+  const dir = mkdtempSync(join(tmpdir(), 'ddr-'));
+  mkdirSync(dir, { recursive: true });
+  for (const [name, body] of Object.entries(files)) writeFileSync(join(dir, name), body);
+  return dir;
+}
+
+const DDR1 = `# DDR-001: First decision
+
+**Status:** Accepted
+**Date:** 2026-01-01
+**Tags:** infra, monorepo, ci
+
+## Context
+The problem is X.
+
+## Decision
+We pick A because it is simplest and safest.
+`;
+
+const DDR2 = `# DDR-002: Second decision
+
+**Status:** Accepted
+**Date:** 2026-02-02
+**Tags:** auth
+
+**Supersedes:** DDR-001
+**Related:** DDR-003
+
+## Decision
+We replace the earlier approach. See DDR-001 for history and DDR-003 alongside.
+`;
+
+test('each DDR yields one decision with area + title + date + rationale', () => {
+  const { batch, stats } = buildDdrBatch(fixtureDir({ 'DDR-001-x.md': DDR1 }), {});
+  assert.equal(batch.decisions.length, 1);
+  const d = batch.decisions[0];
+  assert.equal(d.title, 'First decision');
+  assert.equal(d.date, '2026-01-01');
+  assert.match(d.rationale, /simplest and safest/);
+  // area = primary tag, decision element, ABOUT link
+  const kinds = d.mutations.map((m) => `${m.op}:${m.kind || m.link || ''}`);
+  assert.ok(kinds.includes('upsert_element:area'));
+  assert.ok(kinds.includes('upsert_element:decision'));
+  assert.ok(kinds.includes('add_link:ABOUT'));
+  assert.equal(stats.files, 1);
+});
+
+test('secondary tags become topic elements + TOUCHES links', () => {
+  const { batch } = buildDdrBatch(fixtureDir({ 'DDR-001-x.md': DDR1 }), {});
+  const muts = batch.decisions[0].mutations;
+  const topics = muts
+    .filter((m) => m.op === 'upsert_element' && m.kind === 'topic')
+    .map((m) => m.name);
+  assert.deepEqual(topics.sort(), ['ci', 'monorepo']); // primary 'infra' is the area, not a topic
+  assert.ok(muts.some((m) => m.link === 'TOUCHES'));
+});
+
+test('typed Supersedes marker wins; bare mention does not duplicate it', () => {
+  const { batch } = buildDdrBatch(fixtureDir({ 'DDR-002-y.md': DDR2 }), {});
+  const links = batch.decisions[0].mutations.filter((m) => m.op === 'add_link');
+  const sup = links.filter((l) => l.link === 'SUPERSEDES' && l.to === 'decision:DDR-001');
+  assert.equal(
+    sup.length,
+    1,
+    'exactly one SUPERSEDES → DDR-001 (typed marker, not duplicated by the bare mention)'
+  );
+  // DDR-003 came from **Related:** → REFERENCES
+  assert.ok(links.some((l) => l.link === 'REFERENCES' && l.to === 'decision:DDR-003'));
+});
+
+test('scope tags are added per decision when scope is set (model A)', () => {
+  const { batch } = buildDdrBatch(fixtureDir({ 'DDR-001-x.md': DDR1 }), {
+    repo: 'maude',
+    dept: 'dev',
+  });
+  const muts = batch.decisions[0].mutations;
+  assert.ok(muts.some((m) => m.op === 'upsert_element' && m.kind === 'repo' && m.name === 'maude'));
+  assert.ok(muts.some((m) => m.link === 'IN_REPO' && m.to === 'repo:maude'));
+  assert.ok(muts.some((m) => m.link === 'IN_DEPT' && m.to === 'dept:dev'));
+});
+
+test('no scope ⇒ no scope mutations', () => {
+  const { batch } = buildDdrBatch(fixtureDir({ 'DDR-001-x.md': DDR1 }), {});
+  const muts = batch.decisions[0].mutations;
+  assert.ok(!muts.some((m) => m.link === 'IN_REPO' || m.link === 'IN_DEPT'));
+});
+
+test('non-DDR files are ignored', () => {
+  const { batch } = buildDdrBatch(fixtureDir({ 'DDR-001-x.md': DDR1, 'README.md': '# index' }), {});
+  assert.equal(batch.decisions.length, 1);
+});

package/cli/lib/flow-design-integration.test.mjs

@@ -158,8 +158,8 @@ test('wiring: ddr-keeper + record-ddr have the canvas-reference prompt', () => {
 });
 
 test('wiring: DDR-066 exists and is indexed', () => {
-  const ddr = read('.ai/decisions/DDR-066-soft-handoff-prompt-in-flow-done.md');
+  const ddr = read('.ai/archive/decisions/DDR-066-soft-handoff-prompt-in-flow-done.md');
   assert.match(ddr, /soft prompt/i);
-  const index = read('.ai/decisions/README.md');
+  const index = read('.ai/archive/decisions/README.md');
   assert.match(index, /DDR-066/);
 });

package/cli/lib/gitignore-block.mjs

@@ -51,6 +51,10 @@ export function buildBlock(designRel = '.design') {
     `${root}/_chat/`, // ACP transcripts (per-machine)
     `${root}/_untrusted/`, // hub-synced untrusted file mirror (DDR-054)
     `${root}/_comments/`, // hub-sync-only collab comments (DDR-102/DDR-115 — never git)
+    // kgai knowledge-graph projection (repo-root, NOT under the design root) —
+    // per-machine append-only store, rebuilds from the remote on `kg sync`
+    // (feature-kgai-ecosystem-integration, DDR-115). kgai itself also ignores it.
+    '.kgai/',
     END_MARKER,
   ];
   return `${lines.join('\n')}\n`;

package/cli/lib/plugin-name-namespace.test.mjs

@@ -0,0 +1,71 @@
+// DDR-006 (superseded) regression guard.
+//
+// Claude Code now prepends the `<plugin>:` namespace to every plugin
+// command/agent/skill itself (fixed upstream in Claude Code 2.1.216 — see
+// changelog "Fixed plugin skills with a `name` frontmatter field losing
+// their plugin prefix in slash-command autocomplete" — and Claude Code
+// 2.1.218 explicitly reserves `:` in agent names for that namespacing).
+// Baking the prefix into our own `name:` frontmatter, which DDR-006
+// (2026-05-13) required as a workaround for the OLD (opposite) bug, now
+// produces a doubled prefix — `/design:design:new`, `flow:flow:a11y-auditor`.
+//
+// Two invariants this guards:
+//   1. `name:` frontmatter in plugins/{design,flow}/{commands,agents,skills}/
+//      must be the BARE slug — no `design:`/`flow:` prefix.
+//   2. `subagent_type:` references to our OWN plugin agents must carry
+//      exactly ONE `<plugin>:` prefix (the form the runtime's own namespace
+//      + our bare `name:` resolves to) — never zero (broken lookup against
+//      a namespaced registry) and never two (stale pre-fix leftover).
+
+import assert from 'node:assert/strict';
+import { execSync } from 'node:child_process';
+import { test } from 'node:test';
+
+function grep(pattern, extraArgs = '') {
+  const out = execSync(
+    `grep -rn ${extraArgs} '${pattern}' plugins/design plugins/flow --include='*.md' || true`,
+    { encoding: 'utf8' }
+  );
+  return out.trim().split('\n').filter(Boolean);
+}
+
+test('no plugin name: frontmatter carries a redundant design:/flow: prefix', () => {
+  const offenders = grep('^name: \\(design\\|flow\\):');
+  assert.deepEqual(
+    offenders,
+    [],
+    `These files declare name: with the plugin prefix baked in — Claude Code adds the plugin namespace itself now, so this doubles into e.g. /design:design:new (DDR-006 superseded):\n  ${offenders.join('\n  ')}`
+  );
+});
+
+test('no doubled design:design: / flow:flow: namespace anywhere in plugin markdown', () => {
+  const offenders = grep('design:design:\\|flow:flow:');
+  assert.deepEqual(
+    offenders,
+    [],
+    `Doubled plugin namespace found — strip one level (DDR-006 superseded):\n  ${offenders.join('\n  ')}`
+  );
+});
+
+test('subagent_type references to our own plugin agents carry exactly one <plugin>: prefix', () => {
+  // Bare `subagent_type: <slug>` where <slug> looks like one of our
+  // agent-style names (-critic/-agent/-auditor/-hacker/-keeper/-director/
+  // -analyst suffix) but has no plugin prefix — excludes Claude Code
+  // built-ins (e.g. code-simplifier, which is not one of our plugin agents)
+  // and the `"<critic-name>"` template placeholder.
+  const bareOffenders = grep(
+    'subagent_type:.*"\\?[a-z][a-z0-9-]*\\(-critic\\|-agent\\|-auditor\\|-hacker\\|-keeper\\|-director\\|-analyst\\)"\\?'
+  ).filter((line) => !/design:|flow:|<critic-name>|code-simplifier/.test(line));
+  assert.deepEqual(
+    bareOffenders,
+    [],
+    `These subagent_type references to a plugin-owned agent are missing the <plugin>: prefix and will fail to resolve against the namespaced registry:\n  ${bareOffenders.join('\n  ')}`
+  );
+
+  const doubledOffenders = grep('subagent_type:.*\\(design:design:\\|flow:flow:\\)');
+  assert.deepEqual(
+    doubledOffenders,
+    [],
+    `These subagent_type references are double-prefixed (DDR-006 superseded):\n  ${doubledOffenders.join('\n  ')}`
+  );
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1agh/maude",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "Marketplace of Claude Code plugins by Michal Dovrtěl: `design` (canvas-first design iteration) + `flow` (generic agentic workflow loop with .ai second brain). Ships the `maude` CLI (with `mdcc` legacy alias) to scaffold workspace, run the design dev server, and manage configs.",
   "type": "module",
   "engines": {
@@ -51,13 +51,13 @@
     "test:e2e:desktop:acp-cold-start": "pnpm --filter @maude/desktop-e2e e2e:acp-cold-start"
   },
   "optionalDependencies": {
-    "@1agh/maude-darwin-arm64": "0.47.0",
-    "@1agh/maude-darwin-x64": "0.47.0",
-    "@1agh/maude-linux-arm64": "0.47.0",
-    "@1agh/maude-linux-arm64-musl": "0.47.0",
-    "@1agh/maude-linux-x64": "0.47.0",
-    "@1agh/maude-linux-x64-musl": "0.47.0",
-    "@1agh/maude-win32-x64": "0.47.0"
+    "@1agh/maude-darwin-arm64": "0.48.0",
+    "@1agh/maude-darwin-x64": "0.48.0",
+    "@1agh/maude-linux-arm64": "0.48.0",
+    "@1agh/maude-linux-arm64-musl": "0.48.0",
+    "@1agh/maude-linux-x64": "0.48.0",
+    "@1agh/maude-linux-x64-musl": "0.48.0",
+    "@1agh/maude-win32-x64": "0.48.0"
   },
   "files": [
     "cli",

package/plugins/design/dependencies.json

@@ -146,6 +146,23 @@
       "usedBy": ["commands/init.md", "skills/design/SKILL.md"],
       "docsUrl": "https://github.com/1aGh/maude"
     },
+    {
+      "id": "kg",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "kg version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "See docs/kgai-onboarding.md — download the pinned kgai release binary (kgai is capability-gated + opt-out; nothing to install to use classic .ai/ mode)",
+        "darwin": "curl -fsSL https://github.com/kgaidev/kgai/releases/download/v0.1.9/kg-darwin-arm64 -o /usr/local/bin/kg && chmod +x /usr/local/bin/kg"
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "Design DS/canvas/brand decisions are not recorded to the kgai graph; the classic .ai/ path (via /flow:record-ddr) and on-disk sidecars are unchanged.",
+      "usedBy": ["skills/design-system/SKILL.md", "commands/edit.md"],
+      "docsUrl": "https://github.com/kgaidev/kgai"
+    },
     {
       "id": "jq",
       "type": "system-tool",

package/plugins/flow/.claude-plugin/config.schema.json

@@ -305,6 +305,72 @@
         }
       }
     },
+    "knowledgeGraph": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Opt-OUT, capability-gated knowledge-graph memory backend (kgai). ON by default when the capability exists: an absent `knowledgeGraph` block is treated as `mode:auto`, so when the `kg` CLI is on PATH AND a store is resolvable, flow/design decision reads/writes route through the event-sourced graph instead of `.ai/decisions/` + `.ai/state/STATE.md`. When `kg` is absent, the store is unreachable, or `mode:off`, everything falls back to today's `.ai/` file behavior — no regression, nothing to configure downstream. Mirrors the `orchestration` capability-gate (DDR-130). Design plugin reads the SAME block. See the `kgai-backend` skill for the resolver.",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["auto", "on", "off"],
+          "default": "auto",
+          "description": "Opt-out default `auto` (absent block == `auto`). `auto` = active only when `kg` is on PATH AND (`store` is set OR a local `.kgai/store` exists) — conservative, mirrors `orchestration.mode:auto`; a first-run repo stays on files until the user opts in via onboarding. `on` = force kgai active (errors surface rather than silently falling back). `off` = disable entirely; today's classic `.ai/decisions/` + STATE.md path, byte-for-byte unchanged."
+        },
+        "engine": {
+          "type": "string",
+          "enum": ["kgai"],
+          "default": "kgai",
+          "description": "Knowledge-graph engine. Reserved for future engines; only `kgai` is implemented."
+        },
+        "engineVersion": {
+          "type": "string",
+          "default": "v0.1.9",
+          "description": "PINNED kgai release the CLI + desktop bundle target. Advance deliberately (harness-verified via `maude kg check-upstream`), never float — auto-tracking `latest` would let an upstream change silently alter behavior mid-rollout and is a supply-chain surface (DDR-054/056 reasoning: the bundled `kg` is third-party)."
+        },
+        "store": {
+          "type": "string",
+          "default": "",
+          "description": "Remote store the graph syncs to. `s3://company-kg/store` (shared company remote, cross-repo) | `kgai://org/project` (cloud-broker keyspace) | git remote | `\"\"` = local-only `.kgai/store`. Empty string keeps everything on this machine."
+        },
+        "scope": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Cross-repo scope stamped on every write, so one shared store can host many repos/departments and search can bias to the local scope first. Project-agnostic — values are per-repo config, never hardcoded in the plugin.",
+          "properties": {
+            "repo": {
+              "type": "string",
+              "description": "This repo's name, stamped as a `repo:<name>` element + `IN_REPO` link on every decision."
+            },
+            "dept": {
+              "type": "string",
+              "description": "This repo's department (e.g. dev/marketing/finance/automations), stamped as a `dept:<name>` element + `IN_DEPT` link. Default search bias — reads re-rank `dept:<this>` hits first; `--all-scopes` widens."
+            }
+          }
+        },
+        "capture": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Which write paths route into the graph when active. All default `true`.",
+          "properties": {
+            "decisions": {
+              "type": "boolean",
+              "default": true,
+              "description": "Route `/flow:record-ddr` + DDR-worthy design writes to `kg ingest` instead of a `DDR-NNN.md` file."
+            },
+            "state": {
+              "type": "boolean",
+              "default": true,
+              "description": "Route STATE.md history / pause-resume events to kgai as dated events."
+            },
+            "auto": {
+              "type": "boolean",
+              "default": true,
+              "description": "Let kgai's own `Stop` hook nudge autonomous decision capture after structural edits (zero added LLM cost). Set `false` to suppress the nudge."
+            }
+          }
+        }
+      }
+    },
     "security": {
       "type": "object",
       "additionalProperties": false,

package/plugins/flow/dependencies.json

@@ -95,6 +95,23 @@
       ],
       "docsUrl": "https://github.com/anthropics/agent-device"
     },
+    {
+      "id": "kg",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "kg version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "See docs/kgai-onboarding.md — download the pinned kgai release binary (kgai is capability-gated + opt-out; nothing to install to use classic .ai/ mode)",
+        "darwin": "curl -fsSL https://github.com/kgaidev/kgai/releases/download/v0.1.9/kg-darwin-arm64 -o /usr/local/bin/kg && chmod +x /usr/local/bin/kg"
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "flow/design fall back to the classic .ai/decisions/ + STATE.md file path (no regression). The kgai knowledge-graph backend (kg context/ingest/sync, cross-repo company memory) is inactive.",
+      "usedBy": ["skills/kgai-backend/SKILL.md", "commands/migrate-kgai.md"],
+      "docsUrl": "https://github.com/kgaidev/kgai"
+    },
     {
       "id": "jq",
       "type": "system-tool",