cliper-memory 0.1.0

package/README.md

@@ -0,0 +1,268 @@
+# Cliper Memory
+
+> Turn any codebase into a structured knowledge graph for AI agents.
+
+Cliper Memory is a repository intelligence engine that converts source code, Git history, architecture, dependencies, and project metadata into structured memories that can be ingested by knowledge graph systems like Cognee.
+
+Instead of storing a single flattened context document, Cliper Memory models a repository as interconnected memory objects, enabling AI systems to understand software at a much higher semantic level.
+
+> Transform any repository into a persistent AI memory graph.
+
+---
+
+## Why?
+
+Large language models struggle with large repositories because:
+
+- Repository context exceeds token limits
+- Important relationships are lost in flattened documents
+- Git history is ignored
+- Architecture is difficult to infer
+- Dependencies become disconnected
+
+Cliper Memory solves this by converting repositories into structured memories that preserve relationships between files, modules, commits, packages, architecture, and future project artifacts.
+
+---
+
+## Features
+
+### Repository Intelligence
+
+- Repository Memory
+- Git Memory
+- File Summary Memory
+- Dependency Memory
+- Architecture Memory
+- Responsibility Memory
+- External Package Memory
+- Gap Detection Memory
+- Commit Memory
+
+### Coming Soon
+
+- Release Memory
+- GitHub Issue Memory
+- Pull Request Memory
+- GitHub Discussion Memory
+- Timeline Memory
+- Semantic Repository Search
+- Multi-provider Memory Support
+
+---
+
+## Memory Types
+
+Every repository is transformed into structured memory objects.
+
+Example:
+
+```
+Repository
+│
+├── Git
+│   ├── Commit
+│   └── Release
+│
+├── Architecture
+│   ├── Module
+│   ├── Dependency
+│   └── Responsibility
+│
+├── Files
+│
+├── Packages
+│
+├── Issues
+│
+├── Pull Requests
+│
+└── Discussions
+```
+
+Each memory contains:
+
+- unique identifier
+- memory type
+- metadata
+- semantic relationships
+- searchable content
+
+---
+
+## Example Memory
+
+```json
+{
+  "id": "dependency:src/index.ts->src/commands/init",
+  "type": "dependency",
+  "title": "src/index.ts imports src/commands/init",
+  "relationships": [
+    "src/index.ts",
+    "src/commands/init"
+  ]
+}
+```
+
+---
+
+## Supported Memory Providers
+
+Current:
+
+- Cognee
+
+Planned:
+
+- Neo4j
+- Memgraph
+- Graphiti
+- LanceDB
+- Local JSON Memory
+
+---
+
+## Installation
+
+```bash
+git clone https://github.com/<your-username>/cliper-memory.git
+
+cd cliper-memory
+
+npm install
+```
+
+---
+
+## Configuration
+
+Create a `.env` file.
+
+```env
+COGNEE_BASE_URL=http://localhost:8000
+COGNEE_API_KEY=YOUR_API_KEY
+```
+
+---
+
+## Usage
+
+Initialize repository memory.
+
+```bash
+npm run build
+
+node dist/index.js init
+```
+
+The repository will be analyzed and converted into structured memories before being synchronized with the configured memory provider.
+
+---
+
+
+## How It Works
+
+Once Cliper Memory is configured, onboarding a repository is a single command.
+
+```bash
+cliper init
+```
+
+During initialization, Cliper Memory:
+
+1. Scans the repository structure.
+2. Extracts source code metadata.
+3. Builds dependency and architecture relationships.
+4. Analyzes Git history.
+5. Detects repository gaps.
+6. Converts everything into structured memory objects.
+7. Uploads the memories to the configured Cognee dataset.
+
+Once synchronized, the repository becomes a persistent knowledge graph stored in the user's Cognee cloud, allowing AI applications to query repository knowledge without repeatedly processing the entire codebase.
+
+---
+
+## Current Memory Pipeline
+
+```
+Repository
+    │
+    ▼
+Repository Scanner
+    │
+    ▼
+Memory Builder
+    │
+    ├── Git Memory
+    ├── File Memory
+    ├── Dependency Memory
+    ├── Architecture Memory
+    ├── Responsibility Memory
+    ├── Package Memory
+    ├── Gap Memory
+    └── Commit Memory
+    │
+    ▼
+Memory Provider
+    │
+    ▼
+Cognee Knowledge Graph
+```
+
+---
+
+## Roadmap
+
+### Phase 1
+
+- [x] Repository Memory
+- [x] Git Memory
+- [x] File Memory
+- [x] Dependency Memory
+- [x] Package Memory
+- [x] Gap Memory
+- [x] Responsibility Memory
+- [x] Architecture Memory
+- [x] Commit Memory
+
+### Phase 2
+
+- [ ] Release Memory
+- [ ] GitHub Issue Memory
+- [ ] Pull Request Memory
+- [ ] GitHub Discussion Memory
+- [ ] Timeline Memory
+
+### Phase 3
+
+- [ ] Semantic Search
+- [ ] Repository Question Answering
+- [ ] Multi-provider Support
+- [ ] Incremental Memory Updates
+- [ ] Live Repository Synchronization
+
+---
+
+## Vision
+
+Cliper Memory is the foundation for persistent AI-native software repositories.
+
+Instead of repeatedly providing repository context to AI assistants, your codebase becomes a continuously synchronized memory graph.
+
+Our long-term vision is to build a companion application that connects directly to your repository memories stored in Cognee.
+
+This will allow developers to:
+
+- Chat with their codebase from desktop or mobile.
+- Explore architecture interactively.
+- Ask questions about implementation details.
+- Understand dependencies between modules.
+- Navigate Git history conversationally.
+- Retrieve repository knowledge without cloning the project.
+
+The goal is to make every software repository accessible through natural language while preserving architectural relationships and engineering context.
+
+---
+
+## License
+
+MIT

package/dist/auth/config.d.ts

@@ -0,0 +1,13 @@
+export declare const CLIPER_DIR: string;
+export declare const CONFIG_FILE: string;
+export interface CliperConfig {
+    cliper?: {
+        token: string;
+    };
+    github?: {
+        token: string;
+    };
+}
+export declare function loadConfig(): CliperConfig;
+export declare function saveConfig(config: CliperConfig): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/auth/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,QACe,CAAC;AAEvC,eAAO,MAAM,WAAW,QACgB,CAAC;AAEzC,MAAM,WAAW,YAAY;IAEzB,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;CAEL;AAED,wBAAgB,UAAU,IAAI,YAAY,CAczC;AAED,wBAAgB,UAAU,CACtB,MAAM,EAAE,YAAY,GACrB,IAAI,CAcN"}

package/dist/auth/config.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILE = exports.CLIPER_DIR = void 0;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+exports.CLIPER_DIR = path_1.default.join(os_1.default.homedir(), ".cliper");
+exports.CONFIG_FILE = path_1.default.join(exports.CLIPER_DIR, "config.json");
+function loadConfig() {
+    if (!fs_1.default.existsSync(exports.CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        return JSON.parse(fs_1.default.readFileSync(exports.CONFIG_FILE, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function saveConfig(config) {
+    if (!fs_1.default.existsSync(exports.CLIPER_DIR)) {
+        fs_1.default.mkdirSync(exports.CLIPER_DIR, {
+            recursive: true
+        });
+    }
+    fs_1.default.writeFileSync(exports.CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+//# sourceMappingURL=config.js.map

package/dist/auth/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/auth/config.ts"],"names":[],"mappings":";;;;;;AAsBA,gCAcC;AAED,gCAgBC;AAtDD,4CAAoB;AACpB,4CAAoB;AACpB,gDAAwB;AAEX,QAAA,UAAU,GACnB,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAE1B,QAAA,WAAW,GACpB,cAAI,CAAC,IAAI,CAAC,kBAAU,EAAE,aAAa,CAAC,CAAC;AAczC,SAAgB,UAAU;IAEtB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,mBAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CACb,YAAE,CAAC,YAAY,CAAC,mBAAW,EAAE,MAAM,CAAC,CACvC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AAEL,CAAC;AAED,SAAgB,UAAU,CACtB,MAAoB;IAGpB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,kBAAU,CAAC,EAAE,CAAC;QAC7B,YAAE,CAAC,SAAS,CAAC,kBAAU,EAAE;YACrB,SAAS,EAAE,IAAI;SAClB,CAAC,CAAC;IACP,CAAC;IAED,YAAE,CAAC,aAAa,CACZ,mBAAW,EACX,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/B,EAAE,IAAI,EAAE,KAAK,EAAE,CAClB,CAAC;AAEN,CAAC"}

package/dist/auth/github.d.ts

@@ -0,0 +1,5 @@
+export declare function getGithubToken(): string | null;
+export declare function saveGithubToken(token: string): void;
+export declare function hasGithubAuth(): boolean;
+export declare function getGithubHeaders(): Record<string, string>;
+//# sourceMappingURL=github.d.ts.map

package/dist/auth/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/auth/github.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAI9C;AAED,wBAAgB,eAAe,CAC3B,KAAK,EAAE,MAAM,GACd,IAAI,CAUN;AAED,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBzD"}

package/dist/auth/github.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGithubToken = getGithubToken;
+exports.saveGithubToken = saveGithubToken;
+exports.hasGithubAuth = hasGithubAuth;
+exports.getGithubHeaders = getGithubHeaders;
+const config_1 = require("./config");
+const chalk_1 = __importDefault(require("chalk"));
+function getGithubToken() {
+    return (0, config_1.loadConfig)().github?.token ?? null;
+}
+function saveGithubToken(token) {
+    const config = (0, config_1.loadConfig)();
+    config.github = {
+        token: token.trim()
+    };
+    (0, config_1.saveConfig)(config);
+}
+function hasGithubAuth() {
+    return getGithubToken() !== null;
+}
+function getGithubHeaders() {
+    const token = getGithubToken();
+    if (!token) {
+        console.log(chalk_1.default.yellow("\nGitHub not authenticated.\nRun:\n\n  cliper auth github\n"));
+    }
+    const headers = {
+        Accept: "application/vnd.github+json"
+    };
+    if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    return headers;
+}
+//# sourceMappingURL=github.js.map

package/dist/auth/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/auth/github.ts"],"names":[],"mappings":";;;;;AAGA,wCAIC;AAED,0CAYC;AAED,sCAIC;AAED,4CAsBC;AAnDD,qCAAkD;AAClD,kDAA0B;AAE1B,SAAgB,cAAc;IAE1B,OAAO,IAAA,mBAAU,GAAE,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;AAE9C,CAAC;AAED,SAAgB,eAAe,CAC3B,KAAa;IAGb,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAE5B,MAAM,CAAC,MAAM,GAAG;QACZ,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;KACtB,CAAC;IAEF,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC;AAEvB,CAAC;AAED,SAAgB,aAAa;IAEzB,OAAO,cAAc,EAAE,KAAK,IAAI,CAAC;AAErC,CAAC;AAED,SAAgB,gBAAgB;IAE5B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAE/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CACP,eAAK,CAAC,MAAM,CACR,6DAA6D,CAChE,CACJ,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAA2B;QACpC,MAAM,EAAE,6BAA6B;KACxC,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC;AAEnB,CAAC"}

package/dist/cognee/legacyClient.d.ts

@@ -0,0 +1,20 @@
+export declare function isCogneeConfigured(): boolean;
+/**
+ * Uploads structured project data into a Cognee dataset as self-describing,
+ * sentence-phrased chunks (see buildCogneeChunks), then triggers cognify
+ * once on the whole dataset. Sending one large document caused Cognee's own
+ * extraction step to fail with IncompleteOutputException (max_tokens) on a
+ * real repo — chunking keeps each /add small enough for that step to
+ * complete reliably.
+ */
+export interface CogneeSearchResult {
+    dataset_id: string;
+    dataset_name: string;
+    search_result: string[];
+}
+/**
+ * Queries Cognee memory for a project's dataset.
+ * search_type defaults to GRAPH_COMPLETION (verified working).
+ */
+export declare function recallContext(projectName: string, query: string): Promise<CogneeSearchResult[]>;
+//# sourceMappingURL=legacyClient.d.ts.map

package/dist/cognee/legacyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacyClient.d.ts","sourceRoot":"","sources":["../../src/cognee/legacyClient.ts"],"names":[],"mappings":"AAYA,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AA6dD;;;;;;;GAOG;AAyEH,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwB/B"}