kibi-cli 0.1.0

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

@@ -0,0 +1,50 @@
+/*
+ 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/>.
+*/
+
+/*
+ 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,
+  type ManifestSymbolEntry,
+} from "../../extractors/symbols-coordinator.js";

package/src/public/prolog/index.ts

@@ -0,0 +1,47 @@
+/*
+ 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/>.
+*/
+
+/*
+ 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

@@ -0,0 +1,104 @@
+/*
+ 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/>.
+*/
+
+/*
+ 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 = {
+  $id: "entity.schema.json",
+  title: "Entity",
+  type: "object",
+  properties: {
+    id: { type: "string" },
+    title: { type: "string" },
+    status: {
+      type: "string",
+      enum: [
+        "active",
+        "draft",
+        "archived",
+        "deleted",
+        "approved",
+        "rejected",
+        "pending",
+        "in_progress",
+        "superseded",
+      ],
+    },
+    created_at: { type: "string" },
+    updated_at: { type: "string" },
+    source: { type: "string" },
+    tags: { type: "array", items: { type: "string" } },
+    owner: { type: "string" },
+    priority: { type: "string" },
+    severity: { type: "string" },
+    links: { type: "array", items: { type: "string" } },
+    text_ref: { type: "string" },
+    type: {
+      type: "string",
+      enum: [
+        "req",
+        "scenario",
+        "test",
+        "adr",
+        "flag",
+        "event",
+        "symbol",
+        "fact",
+      ],
+    },
+  },
+  required: [
+    "id",
+    "title",
+    "status",
+    "created_at",
+    "updated_at",
+    "source",
+    "type",
+  ],
+  additionalProperties: false,
+};
+
+export default entitySchema;

package/src/public/schemas/relationship.ts

@@ -0,0 +1,83 @@
+/*
+ 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/>.
+*/
+
+/*
+ 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 = {
+  $id: "relationship.schema.json",
+  title: "Relationship",
+  type: "object",
+  properties: {
+    type: {
+      type: "string",
+      enum: [
+        "depends_on",
+        "specified_by",
+        "verified_by",
+        "validates",
+        "implements",
+        "covered_by",
+        "constrained_by",
+        "constrains",
+        "requires_property",
+        "guards",
+        "publishes",
+        "consumes",
+        "supersedes",
+        "relates_to",
+      ],
+    },
+    from: { type: "string" },
+    to: { type: "string" },
+    created_at: { type: "string" },
+    created_by: { type: "string" },
+    source: { type: "string" },
+    confidence: { type: "number", minimum: 0, maximum: 1 },
+  },
+  required: ["type", "from", "to"],
+  additionalProperties: false,
+};
+
+export default relationshipSchema;

package/src/schemas/changeset.schema.json

@@ -0,0 +1,48 @@
+{
+  "$id": "changeset.schema.json",
+  "title": "Changeset",
+  "type": "object",
+  "properties": {
+    "operations": {
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "operation": { "const": "upsert" },
+              "entity": { "$ref": "./entity.schema.json" },
+              "relationships": {
+                "type": "array",
+                "items": { "$ref": "./relationship.schema.json" }
+              }
+            },
+            "required": ["operation", "entity"],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "operation": { "const": "delete" },
+              "id": { "type": "string" }
+            },
+            "required": ["operation", "id"],
+            "additionalProperties": false
+          }
+        ]
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "timestamp": { "type": "string" },
+        "author": { "type": "string" },
+        "source": { "type": "string" }
+      },
+      "required": ["timestamp"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["operations"],
+  "additionalProperties": false
+}

package/src/schemas/entity.schema.json

@@ -0,0 +1,55 @@
+{
+  "$id": "entity.schema.json",
+  "title": "Entity",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string" },
+    "title": { "type": "string" },
+    "status": {
+      "type": "string",
+      "enum": [
+        "active",
+        "draft",
+        "archived",
+        "deleted",
+        "approved",
+        "rejected",
+        "pending",
+        "in_progress",
+        "superseded"
+      ]
+    },
+    "created_at": { "type": "string" },
+    "updated_at": { "type": "string" },
+    "source": { "type": "string" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "owner": { "type": "string" },
+    "priority": { "type": "string" },
+    "severity": { "type": "string" },
+    "links": { "type": "array", "items": { "type": "string" } },
+    "text_ref": { "type": "string" },
+    "type": {
+      "type": "string",
+      "enum": [
+        "req",
+        "scenario",
+        "test",
+        "adr",
+        "flag",
+        "event",
+        "symbol",
+        "fact"
+      ]
+    }
+  },
+  "required": [
+    "id",
+    "title",
+    "status",
+    "created_at",
+    "updated_at",
+    "source",
+    "type"
+  ],
+  "additionalProperties": false
+}

package/src/schemas/relationship.schema.json

@@ -0,0 +1,34 @@
+{
+  "$id": "relationship.schema.json",
+  "title": "Relationship",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "enum": [
+        "depends_on",
+        "specified_by",
+        "verified_by",
+        "validates",
+        "implements",
+        "covered_by",
+        "constrained_by",
+        "constrains",
+        "requires_property",
+        "guards",
+        "publishes",
+        "consumes",
+        "supersedes",
+        "relates_to"
+      ]
+    },
+    "from": { "type": "string" },
+    "to": { "type": "string" },
+    "created_at": { "type": "string" },
+    "created_by": { "type": "string" },
+    "source": { "type": "string" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 }
+  },
+  "required": ["type", "from", "to"],
+  "additionalProperties": false
+}