kibi-cli 0.2.3 → 0.2.5

package/dist/utils/config.d.ts

@@ -1,3 +1,4 @@
+import { type ChecksConfig, type SymbolTraceabilityOptions } from "./rule-registry.js";
 /**
  * Configuration paths for entity documentation directories.
  */
@@ -17,12 +18,20 @@ export interface KbConfigPaths {
  */
 export interface KbConfig {
     paths: KbConfigPaths;
+    /**
+     * @deprecated defaultBranch is deprecated. Branch lifecycle now follows git naturally
+     * without requiring a configured default. This field is ignored but kept for compatibility.
+     */
     defaultBranch?: string;
+    checks?: ChecksConfig;
 }
+export type { ChecksConfig, SymbolTraceabilityOptions };
 /**
  * Default configuration values for new repositories.
  */
-export declare const DEFAULT_CONFIG: KbConfig;
+export declare const DEFAULT_CONFIG: KbConfig & {
+    $schema: string;
+};
 /**
  * Default paths used by sync command (backward compatible glob patterns).
  */

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAY5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAShC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAqBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAqBpE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAcxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAShC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAiChE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAiCpE"}

package/dist/utils/config.js

@@ -17,10 +17,12 @@
  */
 import { existsSync, readFileSync } from "node:fs";
 import * as path from "node:path";
+import { DEFAULT_CHECKS_CONFIG, } from "./rule-registry.js";
 /**
  * Default configuration values for new repositories.
  */
 export const DEFAULT_CONFIG = {
+    $schema: "https://raw.githubusercontent.com/Looted/kibi/master/packages/cli/schema/config.json",
     paths: {
         requirements: "documentation/requirements",
         scenarios: "documentation/scenarios",
@@ -31,7 +33,7 @@ export const DEFAULT_CONFIG = {
         facts: "documentation/facts",
         symbols: "documentation/symbols.yaml",
     },
-    defaultBranch: undefined,
+    checks: DEFAULT_CHECKS_CONFIG,
 };
 /**
  * Default paths used by sync command (backward compatible glob patterns).
@@ -72,6 +74,18 @@ export function loadConfig(cwd = process.cwd()) {
             ...userConfig.paths,
         },
         defaultBranch: userConfig.defaultBranch,
+        checks: userConfig.checks
+            ? {
+                rules: {
+                    ...DEFAULT_CHECKS_CONFIG.rules,
+                    ...userConfig.checks.rules,
+                },
+                symbolTraceability: {
+                    ...DEFAULT_CHECKS_CONFIG.symbolTraceability,
+                    ...userConfig.checks.symbolTraceability,
+                },
+            }
+            : DEFAULT_CHECKS_CONFIG,
     };
 }
 /**
@@ -101,5 +115,17 @@ export function loadSyncConfig(cwd = process.cwd()) {
             ...userConfig.paths,
         },
         defaultBranch: userConfig.defaultBranch,
+        checks: userConfig.checks
+            ? {
+                rules: {
+                    ...DEFAULT_CHECKS_CONFIG.rules,
+                    ...userConfig.checks.rules,
+                },
+                symbolTraceability: {
+                    ...DEFAULT_CHECKS_CONFIG.symbolTraceability,
+                    ...userConfig.checks.symbolTraceability,
+                },
+            }
+            : DEFAULT_CHECKS_CONFIG,
     };
 }

package/dist/utils/rule-registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Central registry of all KB check rules.
+ * This is the single source of truth for rule names, descriptions, and defaults.
+ */
+export interface RuleDefinition {
+    name: string;
+    description: string;
+    defaultEnabled: boolean;
+    category: "coverage" | "integrity" | "lifecycle" | "traceability";
+}
+export interface SymbolTraceabilityOptions {
+    requireAdr: boolean;
+}
+export interface ChecksConfig {
+    rules: Record<string, boolean>;
+    symbolTraceability: SymbolTraceabilityOptions;
+}
+/**
+ * All known check rules.
+ * When adding a new rule, add it here.
+ */
+export declare const RULES: readonly RuleDefinition[];
+/**
+ * Set of all rule names for quick lookups.
+ */
+export declare const RULE_NAMES: Set<string>;
+/**
+ * Default checks configuration with all rules enabled.
+ */
+export declare const DEFAULT_CHECKS_CONFIG: ChecksConfig;
+/**
+ * Get effective rules based on config and CLI --rules filter.
+ * @param configRules Rules from .kb/config.json (may be partial)
+ * @param cliRules Optional comma-separated list from --rules CLI flag
+ * @returns Set of rule names that should run
+ */
+export declare function getEffectiveRules(configRules?: Record<string, boolean>, cliRules?: string): Set<string>;
+/**
+ * Validate a rule name.
+ * @returns Error message if invalid, null if valid
+ */
+export declare function validateRuleName(name: string): string | null;
+/**
+ * Merge partial checks config with defaults.
+ */
+export declare function mergeChecksConfig(partial?: Partial<ChecksConfig>): ChecksConfig;
+//# sourceMappingURL=rule-registry.d.ts.map

package/dist/utils/rule-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-registry.d.ts","sourceRoot":"","sources":["../../src/utils/rule-registry.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;CACnE;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,cAAc,EAsDjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU,aAAoC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,CAAC,CA4Bb;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAWd"}

package/dist/utils/rule-registry.js

@@ -0,0 +1,139 @@
+/*
+ Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ Copyright (C) 2026 Piotr Franczyk
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * All known check rules.
+ * When adding a new rule, add it here.
+ */
+export const RULES = [
+    {
+        name: "must-priority-coverage",
+        description: "Every must-priority requirement must have a scenario and a test",
+        defaultEnabled: true,
+        category: "coverage",
+    },
+    {
+        name: "symbol-coverage",
+        description: "Symbols should be traceable to requirements via transitive implements",
+        defaultEnabled: true,
+        category: "coverage",
+    },
+    {
+        name: "symbol-traceability",
+        description: "Source symbols must have direct implements links to requirements; optionally constrained_by ADR",
+        defaultEnabled: true,
+        category: "traceability",
+    },
+    {
+        name: "no-dangling-refs",
+        description: "All relationship targets must exist in the KB",
+        defaultEnabled: true,
+        category: "integrity",
+    },
+    {
+        name: "no-cycles",
+        description: "No circular dependency chains in requirements",
+        defaultEnabled: true,
+        category: "integrity",
+    },
+    {
+        name: "required-fields",
+        description: "All entities must have required fields",
+        defaultEnabled: true,
+        category: "integrity",
+    },
+    {
+        name: "deprecated-adr-no-successor",
+        description: "Deprecated ADRs must have a successor ADR that supersedes them",
+        defaultEnabled: true,
+        category: "lifecycle",
+    },
+    {
+        name: "domain-contradictions",
+        description: "Detect contradictions between requirements constraining the same fact",
+        defaultEnabled: true,
+        category: "integrity",
+    },
+];
+/**
+ * Set of all rule names for quick lookups.
+ */
+export const RULE_NAMES = new Set(RULES.map((r) => r.name));
+/**
+ * Default checks configuration with all rules enabled.
+ */
+export const DEFAULT_CHECKS_CONFIG = {
+    rules: Object.fromEntries(RULES.map((r) => [r.name, r.defaultEnabled])),
+    symbolTraceability: {
+        requireAdr: false,
+    },
+};
+/**
+ * Get effective rules based on config and CLI --rules filter.
+ * @param configRules Rules from .kb/config.json (may be partial)
+ * @param cliRules Optional comma-separated list from --rules CLI flag
+ * @returns Set of rule names that should run
+ */
+export function getEffectiveRules(configRules, cliRules) {
+    // Start with all known rules
+    const effective = new Set();
+    for (const rule of RULES) {
+        // Config value takes precedence over default, missing means use default
+        const enabled = configRules?.[rule.name] ?? rule.defaultEnabled;
+        if (enabled) {
+            effective.add(rule.name);
+        }
+    }
+    // CLI --rules is an intersection filter (narrows to specified rules)
+    if (cliRules) {
+        const allowed = new Set(cliRules
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => RULE_NAMES.has(s)));
+        for (const rule of effective) {
+            if (!allowed.has(rule)) {
+                effective.delete(rule);
+            }
+        }
+    }
+    return effective;
+}
+/**
+ * Validate a rule name.
+ * @returns Error message if invalid, null if valid
+ */
+export function validateRuleName(name) {
+    if (!RULE_NAMES.has(name)) {
+        return `Unknown rule: ${name}. Valid rules: ${Array.from(RULE_NAMES).join(", ")}`;
+    }
+    return null;
+}
+/**
+ * Merge partial checks config with defaults.
+ */
+export function mergeChecksConfig(partial) {
+    return {
+        rules: {
+            ...DEFAULT_CHECKS_CONFIG.rules,
+            ...partial?.rules,
+        },
+        symbolTraceability: {
+            ...DEFAULT_CHECKS_CONFIG.symbolTraceability,
+            ...partial?.symbolTraceability,
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "description": "Kibi CLI for knowledge base management",
   "engines": {
@@ -31,6 +31,10 @@
       "types": "./dist/public/prolog/index.d.ts",
       "default": "./dist/public/prolog/index.js"
     },
+    "./prolog/codec": {
+      "types": "./dist/prolog/codec.d.ts",
+      "default": "./dist/prolog/codec.js"
+    },
     "./extractors/symbols-coordinator": {
       "types": "./dist/public/extractors/symbols-coordinator.d.ts",
       "default": "./dist/public/extractors/symbols-coordinator.js"

package/schema/config.json

@@ -0,0 +1,156 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://raw.githubusercontent.com/Looted/kibi/master/packages/cli/schema/config.json",
+  "title": "Kibi Configuration",
+  "description": "Configuration schema for Kibi knowledge base",
+  "type": "object",
+  "properties": {
+    "paths": {
+      "type": "object",
+      "description": "Directory paths for entity documentation",
+      "properties": {
+        "requirements": {
+          "type": "string",
+          "description": "Path to requirements markdown files",
+          "default": "documentation/requirements"
+        },
+        "scenarios": {
+          "type": "string",
+          "description": "Path to BDD scenario markdown files",
+          "default": "documentation/scenarios"
+        },
+        "tests": {
+          "type": "string",
+          "description": "Path to test specification markdown files",
+          "default": "documentation/tests"
+        },
+        "adr": {
+          "type": "string",
+          "description": "Path to Architecture Decision Record markdown files",
+          "default": "documentation/adr"
+        },
+        "flags": {
+          "type": "string",
+          "description": "Path to feature flag markdown files",
+          "default": "documentation/flags"
+        },
+        "events": {
+          "type": "string",
+          "description": "Path to domain event markdown files",
+          "default": "documentation/events"
+        },
+        "facts": {
+          "type": "string",
+          "description": "Path to atomic fact markdown files",
+          "default": "documentation/facts"
+        },
+        "symbols": {
+          "type": "string",
+          "description": "Path to symbols.yaml manifest file",
+          "default": "documentation/symbols.yaml"
+        }
+      }
+    },
+    "defaultBranch": {
+      "type": "string",
+      "description": "[DEPRECATED] No longer used. Branch lifecycle now follows git naturally without requiring a configured default. This field is ignored but kept for backward compatibility.",
+      "deprecated": true
+    },
+    "checks": {
+      "type": "object",
+      "description": "Configuration for KB validation rules",
+      "properties": {
+        "rules": {
+          "type": "object",
+          "description": "Enable/disable individual validation rules. All rules default to true.",
+          "properties": {
+            "must-priority-coverage": {
+              "type": "boolean",
+              "description": "Every must-priority requirement must have at least one scenario and one test",
+              "default": true
+            },
+            "symbol-coverage": {
+              "type": "boolean",
+              "description": "Symbols should be traceable to requirements via transitive implements relationships",
+              "default": true
+            },
+            "symbol-traceability": {
+              "type": "boolean",
+              "description": "Source symbols must have direct implements links to requirements (and optionally ADR constraints)",
+              "default": true
+            },
+            "no-dangling-refs": {
+              "type": "boolean",
+              "description": "All relationship targets must exist in the KB",
+              "default": true
+            },
+            "no-cycles": {
+              "type": "boolean",
+              "description": "No circular dependency chains in requirements",
+              "default": true
+            },
+            "required-fields": {
+              "type": "boolean",
+              "description": "All entities must have required fields (id, title, status, created_at, updated_at, source)",
+              "default": true
+            },
+            "deprecated-adr-no-successor": {
+              "type": "boolean",
+              "description": "Deprecated ADRs must have a successor ADR that supersedes them",
+              "default": true
+            },
+            "domain-contradictions": {
+              "type": "boolean",
+              "description": "Detect contradictions between requirements constraining the same fact",
+              "default": true
+            }
+          },
+          "additionalProperties": false
+        },
+        "symbolTraceability": {
+          "type": "object",
+          "description": "Options for the symbol-traceability rule",
+          "properties": {
+            "requireAdr": {
+              "type": "boolean",
+              "description": "If true, symbols must also have a direct constrained_by relationship to an ADR",
+              "default": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "examples": [
+    {
+      "paths": {
+        "requirements": "documentation/requirements",
+        "scenarios": "documentation/scenarios",
+        "tests": "documentation/tests",
+        "adr": "documentation/adr",
+        "flags": "documentation/flags",
+        "events": "documentation/events",
+        "facts": "documentation/facts",
+        "symbols": "documentation/symbols.yaml"
+      },
+      "checks": {
+        "rules": {
+          "must-priority-coverage": true,
+          "symbol-coverage": true,
+          "symbol-traceability": true,
+          "no-dangling-refs": true,
+          "no-cycles": true,
+          "required-fields": true,
+          "deprecated-adr-no-successor": true,
+          "domain-contradictions": true
+        },
+        "symbolTraceability": {
+          "requireAdr": false
+        }
+      }
+    }
+  ]
+}

package/src/public/extractors/symbols-coordinator.ts

@@ -16,33 +16,6 @@
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-/*
- How to apply this header to source files (examples)
-
- 1) Prepend header to a single file (POSIX shells):
-
-    cat LICENSE_HEADER.txt "$FILE" > "$FILE".with-header && mv "$FILE".with-header "$FILE"
-
- 2) Apply to multiple files (example: the project's main entry files):
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp packages/cli/src/*.ts packages/mcp/src/*.ts; do
-      if [ -f "$f" ]; then
-        cp "$f" "$f".bak
-        (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-      fi
-    done
-
- 3) Avoid duplicating the header: run a quick guard to only add if missing
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp; do
-      if [ -f "$f" ]; then
-        if ! head -n 5 "$f" | grep -q "Copyright (C) 2026 Piotr Franczyk"; then
-          cp "$f" "$f".bak
-          (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-        fi
-      fi
-    done
-*/
 // Public re-export of symbols coordinator
 export {
   enrichSymbolCoordinates,

package/src/public/prolog/index.ts

@@ -16,32 +16,5 @@
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-/*
- How to apply this header to source files (examples)
-
- 1) Prepend header to a single file (POSIX shells):
-
-    cat LICENSE_HEADER.txt "$FILE" > "$FILE".with-header && mv "$FILE".with-header "$FILE"
-
- 2) Apply to multiple files (example: the project's main entry files):
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp packages/cli/src/*.ts packages/mcp/src/*.ts; do
-      if [ -f "$f" ]; then
-        cp "$f" "$f".bak
-        (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-      fi
-    done
-
- 3) Avoid duplicating the header: run a quick guard to only add if missing
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp; do
-      if [ -f "$f" ]; then
-        if ! head -n 5 "$f" | grep -q "Copyright (C) 2026 Piotr Franczyk"; then
-          cp "$f" "$f".bak
-          (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-        fi
-      fi
-    done
-*/
 // Public re-export of PrologProcess
 export { PrologProcess } from "../../prolog.js";

package/src/public/schemas/entity.ts

@@ -16,33 +16,6 @@
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-/*
- How to apply this header to source files (examples)
-
- 1) Prepend header to a single file (POSIX shells):
-
-    cat LICENSE_HEADER.txt "$FILE" > "$FILE".with-header && mv "$FILE".with-header "$FILE"
-
- 2) Apply to multiple files (example: the project's main entry files):
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp packages/cli/src/*.ts packages/mcp/src/*.ts; do
-      if [ -f "$f" ]; then
-        cp "$f" "$f".bak
-        (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-      fi
-    done
-
- 3) Avoid duplicating the header: run a quick guard to only add if missing
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp; do
-      if [ -f "$f" ]; then
-        if ! head -n 5 "$f" | grep -q "Copyright (C) 2026 Piotr Franczyk"; then
-          cp "$f" "$f".bak
-          (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-        fi
-      fi
-    done
-*/
 // Public export of entity schema
 // Generated from entity.schema.json
 const entitySchema = {

package/src/public/schemas/relationship.ts

@@ -16,33 +16,6 @@
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-/*
- How to apply this header to source files (examples)
-
- 1) Prepend header to a single file (POSIX shells):
-
-    cat LICENSE_HEADER.txt "$FILE" > "$FILE".with-header && mv "$FILE".with-header "$FILE"
-
- 2) Apply to multiple files (example: the project's main entry files):
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp packages/cli/src/*.ts packages/mcp/src/*.ts; do
-      if [ -f "$f" ]; then
-        cp "$f" "$f".bak
-        (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-      fi
-    done
-
- 3) Avoid duplicating the header: run a quick guard to only add if missing
-
-    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp; do
-      if [ -f "$f" ]; then
-        if ! head -n 5 "$f" | grep -q "Copyright (C) 2026 Piotr Franczyk"; then
-          cp "$f" "$f".bak
-          (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
-        fi
-      fi
-    done
-*/
 // Public export of relationship schema
 // Generated from relationship.schema.json
 const relationshipSchema = {