cognits 0.0.1__tar.gz

cognits-0.0.1/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+dist/
+
+# Runtime data (sessions, DB, RAG index, encrypted keys)
+.learnit/
+.cognits/
+
+# Frontend build artifacts
+frontend/node_modules/
+frontend/dist/
+src/cognits/frontend_dist/
+
+# Internal design docs and dev tooling
+IDEA.md
+CONVERSACION_CON_LA_IDEA.md
+AGENTS.md
+.opencode/
+opencode.jsonc
+.claude/
+
+# Legacy Go code (pre-Python rewrite, kept for reference)
+legacy/
+
+# Local
+nohup.out
+*.log

cognits-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eduardo Suárez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cognits-0.0.1/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: cognits
+Version: 0.0.1
+Summary: Cognits — Context-Oriented Generation for Neural Intelligent Tutoring Systems. Multi-agent AI personal tutor.
+Author-email: Eduardo Suárez <edusrez@proton.me>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: <3.14,>=3.11
+Requires-Dist: chromadb==1.5.9
+Requires-Dist: cryptography>=42
+Requires-Dist: fastapi>=0.115
+Requires-Dist: fastembed==0.8.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: uvicorn[standard]>=0.30
+Description-Content-Type: text/markdown
+
+# Cognits
+
+**C**ontext-**O**riented **G**eneration for **N**eural **I**ntelligent **T**utoring **S**ystems.
+
+Multi-agent AI personal tutor: a Socratic orchestrator coordinates subagents
+(documentalist with local RAG, web researcher) to guide your learning from a
+local web interface, anchored to the project folder you're learning about.
+
+## Installation
+
+```bash
+uv tool install cognits
+```
+
+> The installation includes the local RAG engine (onnxruntime + ChromaDB, ~600 MB).
+> On first launch, the BGE-M3 embeddings model is downloaded (~2.3 GB).
+
+## Usage
+
+```bash
+cd my-learning-project
+cognits
+```
+
+Starts a local server (port 5173 by default, `PORT` env var) and opens the
+interface in your browser. State lives in `./.cognits/` (sessions, reports,
+encrypted configuration, RAG index).
+
+## Development
+
+```bash
+scripts/dev.sh    # Vite (HMR) + uvicorn --reload
+scripts/build.sh  # frontend build + wheel
+uv run pytest
+```
+
+The frontend is a SolidJS SPA in `frontend/`; the backend is Python (FastAPI)
+in `src/cognits/`.

cognits-0.0.1/README.md

@@ -0,0 +1,38 @@
+# Cognits
+
+**C**ontext-**O**riented **G**eneration for **N**eural **I**ntelligent **T**utoring **S**ystems.
+
+Multi-agent AI personal tutor: a Socratic orchestrator coordinates subagents
+(documentalist with local RAG, web researcher) to guide your learning from a
+local web interface, anchored to the project folder you're learning about.
+
+## Installation
+
+```bash
+uv tool install cognits
+```
+
+> The installation includes the local RAG engine (onnxruntime + ChromaDB, ~600 MB).
+> On first launch, the BGE-M3 embeddings model is downloaded (~2.3 GB).
+
+## Usage
+
+```bash
+cd my-learning-project
+cognits
+```
+
+Starts a local server (port 5173 by default, `PORT` env var) and opens the
+interface in your browser. State lives in `./.cognits/` (sessions, reports,
+encrypted configuration, RAG index).
+
+## Development
+
+```bash
+scripts/dev.sh    # Vite (HMR) + uvicorn --reload
+scripts/build.sh  # frontend build + wheel
+uv run pytest
+```
+
+The frontend is a SolidJS SPA in `frontend/`; the backend is Python (FastAPI)
+in `src/cognits/`.

cognits-0.0.1/frontend/src/App.tsx

@@ -0,0 +1,180 @@
+import { createEffect, createMemo, Show, createSignal, onCleanup, onMount } from "solid-js"
+import {
+  rootId,
+  getViewportData,
+  getSplitData,
+  setFraction,
+  moveTab,
+  placeSessionTabs,
+  removeSessionTabs,
+  type ViewportId,
+} from "./stores/viewport-tree-store"
+import { dragState, endDrag } from "./drag/drag-state"
+import { activeSessionId } from "./stores/session-store"
+import { loadConfig, defaultChatViewport, defaultWriteViewport, loadSessionConfig } from "./stores/settings-store"
+import { loadSessionMessages } from "./stores/chat-store"
+import { initDesktops, createDesktop, switchDesktop, closeDesktop, desktopCount, activeDesktopIndex } from "./stores/desktop-store"
+import Viewport from "./components/Viewport"
+import DragOverlay from "./components/DragOverlay"
+
+initDesktops()
+
+export default function App() {
+  createEffect(() => {
+    const sid = activeSessionId()
+    if (sid) {
+      placeSessionTabs(defaultChatViewport(), defaultWriteViewport())
+      loadSessionMessages(sid)
+      loadSessionConfig(sid)
+    } else {
+      removeSessionTabs()
+    }
+  })
+
+  const handleDrop = () => {
+    const ds = dragState()
+    if (ds.targetViewport !== null) {
+      moveTab(ds.tabId, ds.sourceViewport, ds.targetViewport, ds.insertIndex)
+    }
+    endDrag()
+  }
+
+  onCleanup(() => {
+    endDrag()
+  })
+
+  onMount(() => {
+    loadConfig()
+    const handler = (e: KeyboardEvent) => {
+      const tag = (e.target as HTMLElement).tagName
+      if (tag === "INPUT" || tag === "TEXTAREA") return
+
+      if (!e.ctrlKey && !e.shiftKey && !e.altKey) {
+        if (e.key === "n") {
+          e.preventDefault()
+          createDesktop()
+          return
+        }
+        const num = parseInt(e.key)
+        if (num >= 1 && num <= 9 && num <= desktopCount()) {
+          e.preventDefault()
+          switchDesktop(num - 1)
+        }
+      }
+      if (!e.ctrlKey && e.shiftKey && !e.altKey) {
+        if (e.key === "N") {
+          e.preventDefault()
+          closeDesktop(activeDesktopIndex())
+        }
+      }
+    }
+    document.addEventListener("keydown", handler)
+    onCleanup(() => document.removeEventListener("keydown", handler))
+  })
+
+  return (
+    <div
+      class="h-screen w-screen bg-black text-[#e0e0e0] select-none"
+      onContextMenu={(e) => e.preventDefault()}
+    >
+      <GridNode id={rootId()} />
+      <DragOverlay onDrop={handleDrop} />
+    </div>
+  )
+}
+
+function GridNode(props: { id: ViewportId }) {
+  const split = createMemo(() => getSplitData(props.id))
+  const leaf = createMemo(() => getViewportData(props.id))
+
+  return (
+    <Show when={split()} fallback={
+      <Show when={leaf()}>
+        {(vp) => (
+          <div style={{ width: "100%", height: "100%" }}>
+            <Viewport id={props.id} data={vp()} />
+          </div>
+        )}
+      </Show>
+    }>
+      <SplitView id={props.id} />
+    </Show>
+  )
+}
+
+function SplitView(props: { id: ViewportId }) {
+  const split = createMemo(() => getSplitData(props.id)!)
+  const children = createMemo(() => split().children)
+  const f0 = createMemo(() => split().fractions[0])
+  const f1 = createMemo(() => split().fractions[1])
+  const isH = createMemo(() => split().direction === "h")
+  const [dragging, setDragging] = createSignal(false)
+
+  const onResizerDown = (e: MouseEvent) => {
+    e.preventDefault()
+    // Capture the container here: during the drag the pointer can leave
+    // this split and ev.target would point to another container.
+    const gridRef = (e.currentTarget as HTMLElement).closest("[data-split]") as HTMLElement | null
+    if (!gridRef) return
+    setDragging(true)
+
+    const start = isH() ? e.clientX : e.clientY
+    const startF0 = f0()
+    const startF1 = f1()
+    const totalFr = startF0 + startF1
+
+    const onMove = (ev: MouseEvent) => {
+      const current = isH() ? ev.clientX : ev.clientY
+      const delta = current - start
+
+      const rect = gridRef.getBoundingClientRect()
+      const size = isH() ? rect.width - 4 : rect.height - 4
+
+      if (size <= 0) return
+      const p0 = (startF0 * size) / totalFr
+      const p1 = Math.max(10, Math.min(size - 10, p0 + delta))
+      const clamped = (p1 * totalFr) / size
+      setFraction(props.id, 0, Math.max(0.5, clamped))
+      setFraction(props.id, 1, Math.max(0.5, totalFr - clamped))
+    }
+
+    const onUp = () => {
+      setDragging(false)
+      document.removeEventListener("mousemove", onMove)
+      document.removeEventListener("mouseup", onUp)
+    }
+
+    document.addEventListener("mousemove", onMove)
+    document.addEventListener("mouseup", onUp)
+  }
+
+  return (
+    <div
+      data-split
+      style={{
+        display: "grid",
+        overflow: "hidden",
+        width: "100%",
+        height: "100%",
+        ...(isH()
+          ? {
+              "grid-template-columns": `minmax(0, ${f0()}fr) 4px minmax(0, ${f1()}fr)`,
+              "grid-template-rows": "minmax(0, 1fr)",
+            }
+          : {
+              "grid-template-columns": "minmax(0, 1fr)",
+              "grid-template-rows": `minmax(0, ${f0()}fr) 4px minmax(0, ${f1()}fr)`,
+            }),
+      }}
+    >
+      <GridNode id={children()[0]} />
+      <div
+        class="resizer"
+        classList={{ "resizer-dragging": dragging() }}
+        style={{ cursor: isH() ? "col-resize" : "row-resize" }}
+        onMouseDown={onResizerDown}
+      />
+      <GridNode id={children()[1]} />
+    </div>
+  )
+}

cognits-0.0.1/frontend/src/FileTree.tsx

@@ -0,0 +1,101 @@
+import { createSignal, For, Show } from "solid-js"
+import type { FileNode } from "./types"
+
+function ChevronRight() {
+  return (
+    <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+      <path d="M9 18l6-6-6-6" />
+    </svg>
+  )
+}
+
+function ChevronDown() {
+  return (
+    <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+      <path d="M6 9l6 6 6-6" />
+    </svg>
+  )
+}
+
+function FolderIcon() {
+  return (
+    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+      <path d="M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z" />
+    </svg>
+  )
+}
+
+function FileIcon() {
+  return (
+    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+      <path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z" />
+      <polyline points="14 2 14 8 20 8" />
+    </svg>
+  )
+}
+
+export default function FileTree(props: { node: () => FileNode | null }) {
+  return (
+    <div style="padding: 4px 0">
+      <Show when={props.node()}>
+        {(n) => <NodeView node={n()} depth={0} />}
+      </Show>
+    </div>
+  )
+}
+
+function ToggleIcon(props: { expanded: boolean }) {
+  return (
+    <span style={{ display: "inline-flex", "align-items": "center", width: "14px", color: "#6a6a6a" }}>
+      {props.expanded ? <ChevronDown /> : <ChevronRight />}
+    </span>
+  )
+}
+
+function NodeView(props: { node: FileNode; depth: number }) {
+  const isRoot = props.depth === 0
+  const [expanded, setExpanded] = createSignal(isRoot)
+  const hasKids = props.node.isDir && props.node.children && props.node.children.length > 0
+
+  function handleClick() {
+    if (!isRoot && hasKids) setExpanded(!expanded())
+  }
+
+  return (
+    <>
+      <div
+        style={{
+          cursor: isRoot ? "default" : "pointer",
+          padding: `1px 8px 1px ${8 + props.depth * 14}px`,
+          "font-size": "13px",
+          "line-height": "1.5",
+          "white-space": "nowrap",
+          overflow: "hidden",
+          "text-overflow": "ellipsis",
+          display: "flex",
+          "align-items": "center",
+          gap: "4px",
+        }}
+        onClick={handleClick}
+      >
+        <Show when={!isRoot && hasKids} fallback={
+          <span style={{ display: "inline-flex", "align-items": "center", width: "14px" }}>
+            {props.node.isDir ? (
+              <span style={{ color: "#6a6a6a" }}><FolderIcon /></span>
+            ) : (
+              <span style={{ color: "#6a6a6a" }}><FileIcon /></span>
+            )}
+          </span>
+        }>
+          <ToggleIcon expanded={expanded()} />
+        </Show>
+        <span style={{ color: "#e0e0e0" }}>{props.node.name}</span>
+      </div>
+      <Show when={hasKids && (isRoot || expanded())}>
+        <For each={props.node.children}>
+          {(child) => <NodeView node={child} depth={props.depth + 1} />}
+        </For>
+      </Show>
+    </>
+  )
+}

cognits-0.0.1/frontend/src/FileTreeWrapper.tsx

@@ -0,0 +1,18 @@
+import { createSignal, onMount } from "solid-js"
+import FileTree from "./FileTree"
+import type { FileNode } from "./types"
+
+export default function FileTreeWrapper() {
+  const [tree, setTree] = createSignal<FileNode | null>(null)
+
+  onMount(async () => {
+    try {
+      const res = await fetch("/api/tree")
+      setTree(await res.json())
+    } catch (err) {
+      console.error(err)
+    }
+  })
+
+  return <FileTree node={tree} />
+}