kibi-cli 0.2.6 → 0.2.8

package/dist/extractors/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/extractors/markdown.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAaD,qBAAa,gBAAiB,SAAQ,KAAK;IAOhC,QAAQ,EAAE,MAAM;IANlB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IASM,QAAQ;CAUlB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CA8CV;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAmJtE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/extractors/markdown.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAaD,qBAAa,gBAAiB,SAAQ,KAAK;IAOhC,QAAQ,EAAE,MAAM;IANlB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACR,QAAQ,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IASM,QAAQ;CAUlB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CA8CV;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA4JtE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE"}

package/dist/extractors/markdown.js

@@ -101,7 +101,7 @@ export function extractFromMarkdown(filePath) {
         throw new FrontmatterError(`Failed to read file: ${error instanceof Error ? error.message : String(error)}`, filePath, { classification: "File Read Error" });
     }
     try {
-        const { data, content: body } = matter(content);
+        const { data } = matter(content);
         if (content.trim().startsWith("---")) {
             const parts = content.split("---");
             if (parts.length < 3) {
@@ -136,6 +136,14 @@ export function extractFromMarkdown(filePath) {
         const relationships = [];
         if (Array.isArray(data.links)) {
             for (const link of data.links) {
+                if (typeof link === "string") {
+                    relationships.push({
+                        type: "relates_to",
+                        from: id,
+                        to: link,
+                    });
+                    continue;
+                }
                 if (link &&
                     typeof link === "object" &&
                     typeof link.type === "string" &&

package/dist/prolog.d.ts

@@ -25,6 +25,8 @@ export declare class PrologProcess {
     query(goal: string | string[]): Promise<QueryResult>;
     invalidateCache(): void;
     private isCacheableGoal;
+    private isMutatingGoal;
+    private isExplicitSaveGoal;
     private queryOneShot;
     private execOneShot;
     private normalizeGoal;

package/dist/prolog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prolog.d.ts","sourceRoot":"","sources":["../src/prolog.ts"],"names":[],"mappings":"AA4BA,wBAAgB,eAAe,IAAI,MAAM,CAsCxC;AACD,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,oBAAoB,CAAoC;IAChE,OAAO,CAAC,cAAc,CACyC;IAC/D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,GAAE,aAAkB;IAKjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAoCd,YAAY;IAyCpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAuJ1D,eAAe,IAAI,IAAI;IAIvB,OAAO,CAAC,eAAe;YAYT,YAAY;IA0B1B,OAAO,CAAC,WAAW;IA8EnB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,cAAc;IA8BtB,SAAS,IAAI,OAAO;IAIpB,MAAM,IAAI,MAAM;IAIV,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBjC"}
+{"version":3,"file":"prolog.d.ts","sourceRoot":"","sources":["../src/prolog.ts"],"names":[],"mappings":"AA4BA,wBAAgB,eAAe,IAAI,MAAM,CAsCxC;AACD,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,oBAAoB,CAAoC;IAChE,OAAO,CAAC,cAAc,CACyC;IAC/D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,GAAE,aAAkB;IAKjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAoCd,YAAY;IAyCpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAuJ1D,eAAe,IAAI,IAAI;IAIvB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,kBAAkB;YAIZ,YAAY;IAkC1B,OAAO,CAAC,WAAW;IA8FnB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,cAAc;IA8BtB,SAAS,IAAI,OAAO;IAIpB,MAAM,IAAI,MAAM;IAIV,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAyBjC"}

package/dist/prolog.js

@@ -73,7 +73,7 @@ export class PrologProcess {
         const kbPath = resolveKbPlPath();
         this.process = spawn(this.swiplPath, [
             "-g",
-            `use_module('${kbPath}'), set_prolog_flag(answer_write_options, [max_depth(0), quoted(true)])`,
+            `use_module('${kbPath}'), use_module(library(semweb/rdf_db)), set_prolog_flag(answer_write_options, [max_depth(0), quoted(true)])`,
             "--quiet",
         ]);
         if (!this.process.stdout || !this.process.stderr || !this.process.stdin) {
@@ -256,6 +256,16 @@ export class PrologProcess {
             trimmed.startsWith("kb_delete_") ||
             trimmed.startsWith("kb_retract_"));
     }
+    // implements REQ-009
+    isMutatingGoal(goal) {
+        return (goal.includes("kb_assert_") ||
+            goal.includes("kb_delete_") ||
+            goal.includes("kb_retract_"));
+    }
+    // implements REQ-009
+    isExplicitSaveGoal(goal) {
+        return goal.trim().startsWith("kb_save");
+    }
     async queryOneShot(goal) {
         if (Array.isArray(goal)) {
             return this.execOneShot(goal, this.attachedKbPath);
@@ -269,6 +279,13 @@ export class PrologProcess {
         }
         const attachMatch = trimmedGoal.match(/^kb_attach\('(.+)'\)$/);
         if (attachMatch) {
+            if (this.attachedKbPath !== null) {
+                return {
+                    success: false,
+                    bindings: {},
+                    error: "KB already attached",
+                };
+            }
             const attachResult = this.execOneShot(trimmedGoal, null);
             if (attachResult.success) {
                 this.attachedKbPath = attachMatch[1];
@@ -278,11 +295,21 @@ export class PrologProcess {
         return this.execOneShot(trimmedGoal, this.attachedKbPath);
     }
     execOneShot(goal, kbPath) {
-        const goalList = Array.isArray(goal)
+        const originalGoalList = Array.isArray(goal)
             ? goal.map((item) => this.normalizeGoal(item))
             : [this.normalizeGoal(goal)];
+        const explicitSaveRequested = Array.isArray(goal)
+            ? originalGoalList.some((item) => this.isExplicitSaveGoal(item))
+            : false;
+        const goalList = explicitSaveRequested
+            ? originalGoalList.filter((item) => !this.isExplicitSaveGoal(item))
+            : originalGoalList;
         const isBatch = goalList.length > 1;
-        const combinedGoal = goalList.length === 1 ? goalList[0] : `(${goalList.join(", ")})`;
+        const combinedGoal = goalList.length === 0
+            ? "true"
+            : goalList.length === 1
+                ? goalList[0]
+                : `(${goalList.join(", ")})`;
         const kbModulePath = resolveKbPlPath();
         const prologGoal = [
             `use_module('${kbModulePath}')`,
@@ -292,8 +319,14 @@ export class PrologProcess {
             "read_term_from_atom(GoalAtom, Goal, [variable_names(Vars)])",
             kbPath ? "getenv('KIBI_KB_PATH', KBPath), kb_attach(KBPath)" : "true",
             isBatch ? "WrappedGoal = rdf_transaction(Goal)" : "WrappedGoal = Goal",
-            "(catch(call(WrappedGoal), E, (print_message(error, E), fail)) -> (forall(member(Name=Value, Vars), (write(Name), write('='), write_term(Value, [quoted(true), max_depth(0)]), writeln('.'))), writeln('__KIBI_TRUE__.')) ; writeln('__KIBI_FALSE__.'))",
-            kbPath ? "kb_save, kb_detach" : "true",
+            "(catch(call(WrappedGoal), E, (print_message(error, E), fail)) -> QuerySucceeded = true ; QuerySucceeded = false)",
+            kbPath &&
+                (explicitSaveRequested ||
+                    goalList.some((item) => this.isMutatingGoal(item)))
+                ? "(QuerySucceeded == true -> kb_save ; true)"
+                : "true",
+            kbPath ? "kb_detach" : "true",
+            "(QuerySucceeded == true -> (forall(member(Name=Value, Vars), (write(Name), write('='), write_term(Value, [quoted(true), max_depth(0)]), writeln('.'))), writeln('__KIBI_TRUE__.')) ; writeln('__KIBI_FALSE__.'))",
         ].join(", ");
         const result = spawnSync(this.swiplPath, ["-q", "-g", prologGoal, "-t", "halt"], {
             encoding: "utf8",
@@ -313,6 +346,13 @@ export class PrologProcess {
         }
         const stdout = result.stdout ?? "";
         const stderr = result.stderr ?? "";
+        if (stderr.includes("ERROR")) {
+            return {
+                success: false,
+                bindings: {},
+                error: this.translateError(stderr),
+            };
+        }
         if (stdout.includes("__KIBI_TRUE__")) {
             const clean = stdout
                 .split("\n")
@@ -323,13 +363,6 @@ export class PrologProcess {
                 bindings: this.extractBindings(clean),
             };
         }
-        if (stderr.includes("ERROR")) {
-            return {
-                success: false,
-                bindings: {},
-                error: this.translateError(stderr),
-            };
-        }
         return {
             success: false,
             bindings: {},

package/dist/public/extractors/symbols-coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols-coordinator.d.ts","sourceRoot":"","sources":["../../../src/public/extractors/symbols-coordinator.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"symbols-coordinator.d.ts","sourceRoot":"","sources":["../../../src/public/extractors/symbols-coordinator.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,yCAAyC,CAAC"}

package/dist/public/extractors/symbols-coordinator.js

@@ -14,6 +14,5 @@
 
  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/>.
-*/
-// Public re-export of symbols coordinator
+ */
 export { enrichSymbolCoordinates, } from "../../extractors/symbols-coordinator.js";

package/dist/public/prolog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/prolog/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/public/prolog/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/public/prolog/index.js

@@ -14,6 +14,5 @@
 
  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/>.
-*/
-// Public re-export of PrologProcess
+ */
 export { PrologProcess } from "../../prolog.js";

package/dist/public/schemas/entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/public/schemas/entity.ts"],"names":[],"mappings":"AAoBA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEjB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/public/schemas/entity.ts"],"names":[],"mappings":"AAkBA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEjB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/public/schemas/entity.js

@@ -14,9 +14,7 @@
 
  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/>.
-*/
-// Public export of entity schema
-// Generated from entity.schema.json
+ */
 const entitySchema = {
     $id: "entity.schema.json",
     title: "Entity",

package/dist/public/schemas/relationship.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationship.d.ts","sourceRoot":"","sources":["../../../src/public/schemas/relationship.ts"],"names":[],"mappings":"AAoBA,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCvB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"relationship.d.ts","sourceRoot":"","sources":["../../../src/public/schemas/relationship.ts"],"names":[],"mappings":"AAkBA,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCvB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/public/schemas/relationship.js

@@ -14,9 +14,7 @@
 
  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/>.
-*/
-// Public export of relationship schema
-// Generated from relationship.schema.json
+ */
 const relationshipSchema = {
     $id: "relationship.schema.json",
     title: "Relationship",

package/dist/traceability/git-staged.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-staged.d.ts","sourceRoot":"","sources":["../../src/traceability/git-staged.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAalE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAS5C;AAsCD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,SAAS,EAAE,CAoBb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAiB,GAAG,UAAU,EAAE,CA4FpE;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"git-staged.d.ts","sourceRoot":"","sources":["../../src/traceability/git-staged.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAalE;;GAEG;AAEH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwB5C;AAiDD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,SAAS,EAAE,CAoBb;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAiB,GAAG,UAAU,EAAE,CA6FpE;AAED,eAAe,cAAc,CAAC"}

package/dist/traceability/git-staged.js

@@ -13,16 +13,28 @@ function runGit(cmd, exec) {
 /**
  * Parse null-separated name-status output from git
  */
+// implements REQ-014
 export function parseNameStatusNull(input) {
     if (!input)
         return [];
     const entries = input.split("\0").filter(Boolean);
-    return entries.map((entry) => {
-        const cols = entry.split("\t");
-        const status = cols[0];
-        const parts = cols.slice(1);
-        return { status, parts };
-    });
+    const rows = [];
+    for (let i = 0; i < entries.length;) {
+        const entry = entries[i] ?? "";
+        if (entry.includes("\t")) {
+            const cols = entry.split("\t");
+            rows.push({ status: cols[0] ?? "", parts: cols.slice(1) });
+            i += 1;
+            continue;
+        }
+        const status = entry;
+        const isRenameOrCopy = /^[RC]\d*$/.test(status);
+        const partCount = isRenameOrCopy ? 2 : 1;
+        const parts = entries.slice(i + 1, i + 1 + partCount);
+        rows.push({ status, parts });
+        i += 1 + partCount;
+    }
+    return rows;
 }
 const SUPPORTED_EXT = new Set([
     ".ts",
@@ -34,6 +46,7 @@ const SUPPORTED_EXT = new Set([
     ".mjs",
     ".cjs",
 ]);
+const SUPPORTED_MANIFEST = new Set(["symbols.yaml", "symbols.yml"]);
 const ENTITY_MARKDOWN_DIRS = ["/requirements/", "/scenarios/", "/tests/"];
 function shouldLogTraceDebug() {
     return Boolean(process.env.KIBI_TRACE || process.env.KIBI_DEBUG);
@@ -57,6 +70,16 @@ function isEntityMarkdown(p) {
     }
     return false;
 }
+function isManifestFile(p) {
+    const base = p.split(/[\/]/).pop();
+    if (!base)
+        return false;
+    for (const name of SUPPORTED_MANIFEST) {
+        if (base === name)
+            return true;
+    }
+    return false;
+}
 /**
  * Parse unified diff hunks (new-file coordinates) from git diff output
  */
@@ -86,6 +109,7 @@ export function parseHunksFromDiff(diffText, isNewFile = false) {
 /**
  * Get staged files with statuses, hunks and content.
  */
+// implements REQ-014
 export function getStagedFiles(exec = execSync) {
     // 1. get staged name-status -z
     let nameStatus;
@@ -115,7 +139,9 @@ export function getStagedFiles(exec = execSync) {
                 path = entry.parts[1];
             }
         }
-        if (!hasSupportedExt(path) && !isEntityMarkdown(path)) {
+        if (!hasSupportedExt(path) &&
+            !isEntityMarkdown(path) &&
+            !isManifestFile(path)) {
             if (shouldLogTraceDebug()) {
                 console.debug(`Skipping unsupported extension: ${path}`);
             }

package/dist/traceability/symbol-extract.d.ts

@@ -11,5 +11,10 @@ export interface ExtractedSymbol {
     hunkRanges: HunkRange[];
     reqLinks: string[];
 }
-export declare function extractSymbolsFromStagedFile(stagedFile: StagedFile): ExtractedSymbol[];
+export interface ManifestLookupEntry {
+    id: string;
+    links?: string[];
+}
+export type ManifestLookup = Map<string, ManifestLookupEntry>;
+export declare function extractSymbolsFromStagedFile(stagedFile: StagedFile, manifestLookup?: ManifestLookup): ExtractedSymbol[];
 //# sourceMappingURL=symbol-extract.d.ts.map

package/dist/traceability/symbol-extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbol-extract.d.ts","sourceRoot":"","sources":["../../src/traceability/symbol-extract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7D,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA0DD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,UAAU,GACrB,eAAe,EAAE,CAuLnB"}
+{"version":3,"file":"symbol-extract.d.ts","sourceRoot":"","sources":["../../src/traceability/symbol-extract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7D,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AA4D9D,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,UAAU,EACtB,cAAc,CAAC,EAAE,cAAc,GAC9B,eAAe,EAAE,CA+MnB"}

package/dist/traceability/symbol-extract.js

@@ -28,7 +28,10 @@ function parseReqDirectives(text) {
     const regex = new RegExp(`implements\\s*:?\\s*(${REQ_ID}(?:\\s*,\\s*${REQ_ID})*)\\s*$`, "gim");
     const reqs = new Set();
     let m;
-    while ((m = regex.exec(text))) {
+    while (true) {
+        m = regex.exec(text);
+        if (!m)
+            break;
         const list = m[1];
         for (const part of list.split(/[,\s]+/)) {
             const p = part.trim();
@@ -42,9 +45,9 @@ function parseReqDirectives(text) {
 function rangesIntersect(aStart, aEnd, bStart, bEnd) {
     return aStart <= bEnd && bStart <= aEnd;
 }
-export function extractSymbolsFromStagedFile(stagedFile) {
+export function extractSymbolsFromStagedFile(stagedFile, manifestLookup) {
     const content = stagedFile.content ?? "";
-    const sha = computeContentSha(content + "|" + stagedFile.path);
+    const sha = computeContentSha(`${content}|${stagedFile.path}`);
     // TTL cache lookup
     const now = Date.now();
     let cached = sourceFileCache.get(sha);
@@ -52,7 +55,7 @@ export function extractSymbolsFromStagedFile(stagedFile) {
         // create or recreate SourceFile in project (in-memory)
         try {
             const scriptKind = chooseScriptKind(stagedFile.path);
-            const sf = project.createSourceFile(stagedFile.path + "::staged", content, {
+            const sf = project.createSourceFile(`${stagedFile.path}::staged`, content, {
                 overwrite: true,
                 scriptKind,
             });
@@ -85,13 +88,13 @@ export function extractSymbolsFromStagedFile(stagedFile) {
             const start = nameNode ? nameNode.getStart() : fn.getStart();
             const end = fn.getEnd();
             const span = getSpan(start, end);
-            const reqLinks = parseReqDirectives(fn.getFullText() +
-                "\n" +
-                fn
-                    .getJsDocs()
-                    .map((d) => d.getFullText())
-                    .join("\n"));
-            const id = resolveSymbolId(stagedFile.path, name);
+            const reqLinks = parseReqDirectives(`${fn.getFullText()}\n${fn
+                .getJsDocs()
+                .map((d) => d.getFullText())
+                .join("\n")}`);
+            const { id, reqLinks: manifestLinks } = resolveSymbolId(stagedFile.path, name, manifestLookup);
+            // Merge manifest links with inline directive links (manifest links as fallback)
+            const mergedReqLinks = reqLinks.length > 0 ? reqLinks : (manifestLinks ?? []);
             results.push({
                 id,
                 name,
@@ -102,7 +105,7 @@ export function extractSymbolsFromStagedFile(stagedFile) {
                     endLine: span.endLine,
                 },
                 hunkRanges: intersectingHunks(span.startLine, span.endLine, stagedFile.hunkRanges),
-                reqLinks,
+                reqLinks: mergedReqLinks,
             });
         }
         catch { }
@@ -116,13 +119,13 @@ export function extractSymbolsFromStagedFile(stagedFile) {
             const start = cls.getNameNode()?.getStart() ?? cls.getStart();
             const end = cls.getEnd();
             const span = getSpan(start, end);
-            const reqLinks = parseReqDirectives(cls.getText() +
-                "\n" +
-                cls
-                    .getJsDocs()
-                    .map((d) => d.getFullText())
-                    .join("\n"));
-            const id = resolveSymbolId(stagedFile.path, name);
+            const reqLinks = parseReqDirectives(`${cls.getText()}\n${cls
+                .getJsDocs()
+                .map((d) => d.getFullText())
+                .join("\n")}`);
+            const { id, reqLinks: manifestLinks } = resolveSymbolId(stagedFile.path, name, manifestLookup);
+            // Merge manifest links with inline directive links (manifest links as fallback)
+            const mergedReqLinks = reqLinks.length > 0 ? reqLinks : (manifestLinks ?? []);
             results.push({
                 id,
                 name,
@@ -133,7 +136,7 @@ export function extractSymbolsFromStagedFile(stagedFile) {
                     endLine: span.endLine,
                 },
                 hunkRanges: intersectingHunks(span.startLine, span.endLine, stagedFile.hunkRanges),
-                reqLinks,
+                reqLinks: mergedReqLinks,
             });
         }
         catch { }
@@ -148,7 +151,9 @@ export function extractSymbolsFromStagedFile(stagedFile) {
             const end = en.getEnd();
             const span = getSpan(start, end);
             const reqLinks = parseReqDirectives(en.getText());
-            const id = resolveSymbolId(stagedFile.path, name);
+            const { id, reqLinks: manifestLinks } = resolveSymbolId(stagedFile.path, name, manifestLookup);
+            // Merge manifest links with inline directive links (manifest links as fallback)
+            const mergedReqLinks = reqLinks.length > 0 ? reqLinks : (manifestLinks ?? []);
             results.push({
                 id,
                 name,
@@ -159,7 +164,7 @@ export function extractSymbolsFromStagedFile(stagedFile) {
                     endLine: span.endLine,
                 },
                 hunkRanges: intersectingHunks(span.startLine, span.endLine, stagedFile.hunkRanges),
-                reqLinks,
+                reqLinks: mergedReqLinks,
             });
         }
         catch { }
@@ -175,7 +180,9 @@ export function extractSymbolsFromStagedFile(stagedFile) {
                 const end = decl.getEnd();
                 const span = getSpan(start, end);
                 const reqLinks = parseReqDirectives(decl.getText());
-                const id = resolveSymbolId(stagedFile.path, name);
+                const { id, reqLinks: manifestLinks } = resolveSymbolId(stagedFile.path, name, manifestLookup);
+                // Merge manifest links with inline directive links (manifest links as fallback)
+                const mergedReqLinks = reqLinks.length > 0 ? reqLinks : (manifestLinks ?? []);
                 results.push({
                     id,
                     name,
@@ -186,7 +193,7 @@ export function extractSymbolsFromStagedFile(stagedFile) {
                         endLine: span.endLine,
                     },
                     hunkRanges: intersectingHunks(span.startLine, span.endLine, stagedFile.hunkRanges),
-                    reqLinks,
+                    reqLinks: mergedReqLinks,
                 });
             }
             catch { }
@@ -208,21 +215,42 @@ function intersectingHunks(startLine, endLine, hunks) {
     }
     return out;
 }
-function resolveSymbolId(filePath, name) {
+function resolveSymbolId(filePath, name, manifestLookup) {
+    // First, check the provided manifest lookup if available
+    if (manifestLookup) {
+        // Normalize the source file path for consistent lookup
+        const normalizedSource = filePath.startsWith("/")
+            ? filePath
+            : `${filePath}`;
+        const lookupKey = `${normalizedSource}:${name}`;
+        const entry = manifestLookup.get(lookupKey);
+        if (entry) {
+            return { id: entry.id, reqLinks: entry.links };
+        }
+    }
+    // Fallback: attempt to read manifest entries from a local symbols.yaml (best-effort)
     try {
-        // attempt to read manifest entries for explicit id (best-effort)
-        // extractFromManifest expects a file path; if manifest not present it will throw — catch it
-        const ents = extractFromManifest(filePath);
-        for (const e of ents) {
-            if (e.entity.title === name)
-                return e.entity.id;
+        // Try to find a symbols.yaml in the same directory as the file
+        const dir = filePath.substring(0, filePath.lastIndexOf("/"));
+        if (dir) {
+            const manifestPath = `${dir}/symbols.yaml`;
+            const ents = extractFromManifest(manifestPath);
+            for (const e of ents) {
+                if (e.entity.title === name) {
+                    // Extract requirement links from relationships
+                    const reqLinks = e.relationships
+                        .filter((r) => r.type === "implements" && r.to.match(/^[A-Z][A-Z0-9\-_]*$/))
+                        .map((r) => r.to);
+                    return { id: e.entity.id, reqLinks };
+                }
+            }
         }
     }
     catch {
-        // ignore
+        // ignore - no local manifest or parse error
     }
-    // deterministic id: sha(file:path:name)
+    // Final fallback: deterministic id: sha(file:path:name)
     const h = createHash("sha256");
     h.update(`${filePath}:${name}`);
-    return h.digest("hex").slice(0, 16);
+    return { id: h.digest("hex").slice(0, 16) };
 }

package/dist/traceability/temp-kb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"temp-kb.d.ts","sourceRoot":"","sources":["../../src/traceability/temp-kb.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;CACvB;AAmDD,iBAAe,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/D;AAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2C7E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAkBrE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlE"}
+{"version":3,"file":"temp-kb.d.ts","sourceRoot":"","sources":["../../src/traceability/temp-kb.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;CACvB;AAmDD,iBAAe,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/D;AAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2C7E;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAkBrE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlE"}

package/dist/traceability/temp-kb.js

@@ -82,14 +82,15 @@ export async function createTempKb(baseKbPath) {
     trace(`temporary KB ready at ${kbPath}`);
     return ctx;
 }
+// implements REQ-014
 export function createOverlayFacts(symbols) {
     const lines = [];
     for (const symbol of symbols) {
-        lines.push(`changed_symbol(${escapePrologAtom(symbol.id)}).`);
-        lines.push(`changed_symbol_loc(${escapePrologAtom(symbol.id)}, ${escapePrologAtom(symbol.location.file)}, ${symbol.location.startLine}, 0, ${escapePrologAtom(symbol.name)}).`);
+        lines.push(`kb:changed_symbol(${escapePrologAtom(symbol.id)}).`);
+        lines.push(`kb:changed_symbol_loc(${escapePrologAtom(symbol.id)}, ${escapePrologAtom(symbol.location.file)}, ${symbol.location.startLine}, 0, ${escapePrologAtom(symbol.name)}).`);
         // Emit overlay facts for requirement links from code-comment directives.
         for (const reqId of symbol.reqLinks) {
-            lines.push(`changed_symbol_req(${escapePrologAtom(symbol.id)}, ${escapePrologAtom(reqId)}).`);
+            lines.push(`kb:changed_symbol_req(${escapePrologAtom(symbol.id)}, ${escapePrologAtom(reqId)}).`);
         }
     }
     return lines.join("\n");

package/dist/traceability/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/traceability/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAgHD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,SAAS,EAAE,CAAC,CAqCtB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAiBhE"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/traceability/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAiHD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,SAAS,EAAE,CAAC,CAqCtB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAiBhE"}

package/dist/traceability/validate.js

@@ -1,10 +1,10 @@
-function unquoteAtom(v) {
+function unquoteAtom(value) {
     // remove surrounding single quotes and unescape doubled quotes
-    v = v.trim();
-    if (v.startsWith("'") && v.endsWith("'")) {
-        v = v.slice(1, -1).replace(/''/g, "'");
+    const trimmed = value.trim();
+    if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+        return trimmed.slice(1, -1).replace(/''/g, "'");
     }
-    return v;
+    return trimmed;
 }
 function splitTopLevelComma(s) {
     const parts = [];
@@ -98,14 +98,15 @@ function parsePrologListOfLists(value) {
     }
     return out;
 }
+// implements REQ-014
 export async function validateStagedSymbols(options) {
     const { minLinks, prolog } = options;
-    const goal = `findall([Sym,Count,File,Line,Col,Name], changed_symbol_violation(Sym, ${minLinks}, Count, File, Line, Col, Name), Rows)`;
+    const goal = `findall([Sym,Count,File,Line,Col,Name], kb:changed_symbol_violation(Sym, ${minLinks}, Count, File, Line, Col, Name), Rows)`;
     const res = await prolog.query(goal);
     if (!res.success) {
         throw new Error(`Prolog query failed: ${res.error || "unknown error"}`);
     }
-    const rowsRaw = res.bindings["Rows"] ?? "[]";
+    const rowsRaw = res.bindings.Rows ?? "[]";
     const lists = parsePrologListOfLists(rowsRaw);
     const violations = [];
     for (const row of lists) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-cli",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "description": "Kibi CLI for knowledge base management",
   "engines": {
@@ -71,6 +71,10 @@
     "kibi-core": "^0.1.10",
     "ts-morph": "^23.0.0"
   },
+  "devDependencies": {
+    "@types/node": "latest",
+    "typescript": "^5.7.0"
+  },
   "license": "AGPL-3.0-or-later",
   "author": "Piotr Franczyk",
   "repository": {

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

@@ -14,9 +14,8 @@
 
  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/>.
-*/
+ */
 
-// Public re-export of symbols coordinator
 export {
   enrichSymbolCoordinates,
   type ManifestSymbolEntry,

package/src/public/prolog/index.ts

@@ -14,7 +14,6 @@
 
  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/>.
-*/
+ */
 
-// Public re-export of PrologProcess
 export { PrologProcess } from "../../prolog.js";

package/src/public/schemas/entity.ts

@@ -14,10 +14,8 @@
 
  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/>.
-*/
+ */
 
-// Public export of entity schema
-// Generated from entity.schema.json
 const entitySchema = {
   $id: "entity.schema.json",
   title: "Entity",