schist 0.1.0__tar.gz

schist-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: schist
+Version: 0.1.0
+Summary: Agent-first knowledge graph: git is truth, SQLite is query, humans just watch
+Author: schist contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yibeichan/schist
+Project-URL: Repository, https://github.com/yibeichan/schist
+Project-URL: Issues, https://github.com/yibeichan/schist/issues
+Project-URL: Changelog, https://github.com/yibeichan/schist/blob/main/CHANGELOG.md
+Keywords: knowledge-graph,agents,mcp,markdown,sqlite
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: python-frontmatter>=1.1.0
+Requires-Dist: pyyaml>=6.0.3
+
+# schist
+
+Agent-first knowledge graph. Git is truth, SQLite is query, humans just watch.
+
+**schist** is a generic, domain-agnostic knowledge graph where AI agents are the primary writers. Content is markdown + YAML frontmatter, version-controlled in git. SQLite provides the query layer. A static web viewer (D3.js + lunr.js) gives humans a read-only visualization.
+
+## Installation
+
+```bash
+pip install schist
+```
+
+This installs the `schist` CLI and the `schist-ingest` console script (used by the git post-commit hook).
+
+## Quick Start
+
+```bash
+# Create a vault
+mkdir -p ~/vaults/research/{notes,papers,concepts,.schist}
+
+# Add your first note
+schist add --vault ~/vaults/research \
+  --title "First Note" \
+  --tags getting-started \
+  --body "Hello, knowledge graph."
+
+# Search it
+schist search --vault ~/vaults/research "knowledge"
+
+# Get graph context (useful for agent session start)
+schist context --vault ~/vaults/research
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `schist add` | Create a new note |
+| `schist link` | Add a connection between nodes |
+| `schist search` | Full-text search |
+| `schist query` | Raw SQL query |
+| `schist build` | Generate static viewer data |
+| `schist context` | Dump session context |
+| `schist schema` | Print or validate schema |
+
+## MCP Server
+
+The schist MCP server (`@schist/mcp-server`) is published separately on npm:
+
+```bash
+npm install -g @schist/mcp-server
+```
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "schist": {
+      "command": "node",
+      "args": ["/absolute/path/to/schist/mcp-server/dist/index.js"],
+      "env": {
+        "SCHIST_VAULT_PATH": "/absolute/path/to/vault"
+      }
+    }
+  }
+}
+```
+
+See the [full README](https://github.com/yibeichan/schist#readme) for architecture docs, hub & spoke setup, and MCP tool reference.
+
+## License
+
+MIT

schist-0.1.0/README.md

@@ -0,0 +1,74 @@
+# schist
+
+Agent-first knowledge graph. Git is truth, SQLite is query, humans just watch.
+
+**schist** is a generic, domain-agnostic knowledge graph where AI agents are the primary writers. Content is markdown + YAML frontmatter, version-controlled in git. SQLite provides the query layer. A static web viewer (D3.js + lunr.js) gives humans a read-only visualization.
+
+## Installation
+
+```bash
+pip install schist
+```
+
+This installs the `schist` CLI and the `schist-ingest` console script (used by the git post-commit hook).
+
+## Quick Start
+
+```bash
+# Create a vault
+mkdir -p ~/vaults/research/{notes,papers,concepts,.schist}
+
+# Add your first note
+schist add --vault ~/vaults/research \
+  --title "First Note" \
+  --tags getting-started \
+  --body "Hello, knowledge graph."
+
+# Search it
+schist search --vault ~/vaults/research "knowledge"
+
+# Get graph context (useful for agent session start)
+schist context --vault ~/vaults/research
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `schist add` | Create a new note |
+| `schist link` | Add a connection between nodes |
+| `schist search` | Full-text search |
+| `schist query` | Raw SQL query |
+| `schist build` | Generate static viewer data |
+| `schist context` | Dump session context |
+| `schist schema` | Print or validate schema |
+
+## MCP Server
+
+The schist MCP server (`@schist/mcp-server`) is published separately on npm:
+
+```bash
+npm install -g @schist/mcp-server
+```
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "schist": {
+      "command": "node",
+      "args": ["/absolute/path/to/schist/mcp-server/dist/index.js"],
+      "env": {
+        "SCHIST_VAULT_PATH": "/absolute/path/to/vault"
+      }
+    }
+  }
+}
+```
+
+See the [full README](https://github.com/yibeichan/schist#readme) for architecture docs, hub & spoke setup, and MCP tool reference.
+
+## License
+
+MIT

schist-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=82.0.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "schist"
+version = "0.1.0"
+description = "Agent-first knowledge graph: git is truth, SQLite is query, humans just watch"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+    { name = "schist contributors" }
+]
+keywords = ["knowledge-graph", "agents", "mcp", "markdown", "sqlite"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["python-frontmatter>=1.1.0", "pyyaml>=6.0.3"]
+
+[project.urls]
+Homepage = "https://github.com/yibeichan/schist"
+Repository = "https://github.com/yibeichan/schist"
+Issues = "https://github.com/yibeichan/schist/issues"
+Changelog = "https://github.com/yibeichan/schist/blob/main/CHANGELOG.md"
+
+[project.scripts]
+schist = "schist.__main__:main"
+schist-ingest = "schist.ingest:main"
+
+# Explicit package list — without this, setuptools 82+ flat-layout
+# auto-discovery fails when a local `cli/hooks/` directory exists (as
+# created by test_rate_limit.py's `rejected-pushes.log`, which lands
+# under cli/hooks/ by default even though the log file is gitignored).
+# setuptools then errors with "Multiple top-level packages discovered in
+# a flat-layout: ['hooks', 'schist']" because .gitignore is invisible
+# to it. Pinning packages to ["schist"] makes the install deterministic
+# regardless of stray local directories.
+[tool.setuptools]
+packages = ["schist"]
+
+# Ship .sql files (schema.sql, seed-domains.sql) inside the wheel so
+# `schist-ingest` works after `pip install schist` — ingest.py reads
+# schema.sql via Path(__file__).parent / 'schema.sql'.
+[tool.setuptools.package-data]
+schist = ["*.sql"]
+
+[tool.pytest.ini_options]
+markers = [
+    "integration: slow tests that spawn real git subprocesses",
+]

schist-0.1.0/schist/__main__.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+"""schist CLI — agent-first knowledge graph."""
+
+import argparse
+import os
+import sys
+
+from . import commands, sync
+
+
+def main():
+    parser = argparse.ArgumentParser(prog='schist', description='Agent-first knowledge graph CLI')
+    parser.add_argument('--vault', default=os.environ.get('SCHIST_VAULT_PATH'), help='Path to vault root (or set SCHIST_VAULT_PATH)')
+    parser.add_argument('--db', default=None, help='Path to SQLite database (default: <vault>/.schist/schist.db)')
+
+    sub = parser.add_subparsers(dest='command')
+
+    # add
+    p_add = sub.add_parser('add', help='Create a new note')
+    p_add.add_argument('--title', required=True)
+    p_add.add_argument('--body', default=None)
+    p_add.add_argument('--tags', default=None, help='Comma-separated tags')
+    p_add.add_argument('--concepts', default=None, help='Comma-separated concept slugs')
+    p_add.add_argument('--status', default='draft')
+    p_add.add_argument('--dir', default='notes', dest='directory')
+
+    # link
+    p_link = sub.add_parser('link', help='Add a connection between documents')
+    p_link.add_argument('--source', required=True)
+    p_link.add_argument('--target', required=True)
+    p_link.add_argument('--type', required=True, dest='link_type')
+    p_link.add_argument('--context', default=None)
+
+    # search
+    p_search = sub.add_parser('search', help='Full-text search')
+    p_search.add_argument('query', help='Search query')
+    p_search.add_argument('--limit', type=int, default=20)
+    p_search.add_argument('--status', default=None)
+    p_search.add_argument('--tags', default=None, help='Comma-separated AND filter')
+
+    # query
+    p_query = sub.add_parser('query', help='Run a SELECT query')
+    p_query.add_argument('sql', help='SQL query (SELECT only)')
+    p_query.add_argument('--json', action='store_true', dest='as_json')
+
+    # build
+    p_build = sub.add_parser('build', help='Build graph and search index')
+    p_build.add_argument('--out', default=None, help='Output directory (default: <vault>/.schist/data/)')
+
+    # context
+    p_context = sub.add_parser('context', help='Print vault context summary')
+    p_context.add_argument('--depth', choices=['minimal', 'standard', 'full'], default='standard')
+
+    # schema
+    p_schema = sub.add_parser('schema', help='Print or validate schema')
+    p_schema.add_argument('--validate', action='store_true')
+
+    # init
+    p_init = sub.add_parser('init', help='Initialize a vault (standalone, hub, or spoke)')
+    p_init.add_argument('path', nargs='?', default=None,
+                        help='(standalone) Path to new vault (default: current dir)')
+    p_init.add_argument('--spoke', action='store_true', help='Initialize as spoke vault')
+    p_init.add_argument('--hub', help='(spoke) Hub repository URL')
+    p_init.add_argument('--scope', help='(spoke) Scope to sync (directory path)')
+    p_init.add_argument('--identity', default=os.environ.get('SCHIST_IDENTITY'),
+                        help='(spoke/standalone) Identity name (or set SCHIST_IDENTITY)')
+    p_init.add_argument('--hub-path', dest='hub_path',
+                        help='(hub) Path to the bare repo to create')
+    p_init.add_argument('--name', help='(hub/standalone) Vault name for vault.yaml')
+    p_init.add_argument('--participant', action='append',
+                        help='(hub) Participant name (repeatable)')
+
+    # sync
+    p_sync = sub.add_parser('sync', help='Sync spoke vault with hub')
+    sync_sub = p_sync.add_subparsers(dest='sync_action')
+    sync_sub.add_parser('pull', help='Pull updates from hub')
+    sync_sub.add_parser('push', help='Push local changes to hub')
+
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        sys.exit(1)
+
+    # init: all modes (hub, spoke, standalone) routed through one helper so
+    # the conflict matrix lives in one place.
+    if args.command == 'init':
+        sync._dispatch_init(args)
+        sys.exit(0)
+
+    vault_path = args.vault
+    if not vault_path:
+        print('Error: --vault required or set SCHIST_VAULT_PATH', file=sys.stderr)
+        sys.exit(1)
+
+    db_path = args.db or os.path.join(vault_path, '.schist', 'schist.db')
+
+    # sync sub-dispatch
+    if args.command == 'sync':
+        if args.sync_action == 'pull':
+            sync.sync_pull(args, vault_path, db_path)
+        elif args.sync_action == 'push':
+            sync.sync_push(args, vault_path, db_path)
+        else:
+            print('Usage: schist sync {pull|push}', file=sys.stderr)
+            sys.exit(1)
+        sys.exit(0)
+
+    dispatch = {
+        'add': commands.add,
+        'link': commands.link,
+        'search': commands.search,
+        'query': commands.query,
+        'build': commands.build,
+        'context': commands.context,
+        'schema': commands.schema,
+    }
+    dispatch[args.command](args, vault_path, db_path)
+
+
+if __name__ == '__main__':
+    main()