Polish graphite README

Author: cemphlvn

README.md

@@ -1,16 +1,75 @@
 # Graphite
 
+> ontology-based server communications bootstrap kit
+
 Status: `incubating_pre_1_0`
 
-Graphite is a local-first protocol-server pattern for epistemic institutions.
+Graphite is a local-first bootstrap kit for building protocol servers where ontology, messages, claims, labs, governance, and tools are handled as explicit communication objects.
+
+```text
+ontology + protocol objects + signed gates + queryable graph state
+```
+
+It is designed for teams who want their server to understand not only data, but the meaning, status, source, and authority of the things being communicated.
+
+## What It Is
+
+Graphite gives a clean starting point for servers that need:
+
+- ontology-aware communication,
+- local-first operation,
+- private-by-default knowledge growth,
+- signed gates for decisions and updates,
+- claim and source tracking,
+- lab-safe experimentation,
+- AI-assisted workflows with human authority separated,
+- graphable state that can be inspected and evolved.
+
+In one sentence:
+
+```text
+Graphite is an ontology-based server communications bootstrap kit.
+```
+
+## Why It Exists
+
+Most servers move payloads.
+
+Graphite treats communication itself as the native object.
+
+A message is not only text. A claim is not only a note. A decision is not only a log entry. Each object can carry its role, evidence, authority, status, signature, and relation to the wider graph.
 
-Definition:
+That makes Graphite useful for foundations, research labs, small institutions, multi-agent systems, protocol consoles, and developer teams that need a shared language for what is being said, changed, approved, or questioned.
+
+## Core Model
 
 ```text
-Graphite is a local-first protocol server where ontology, claims, labs, governance, and tools grow as signed, queryable graph state.
+origin -> message -> claim -> gate -> update -> graph
 ```
 
-## Important Boundary
+- `origin`: who or what produced the communication
+- `message`: the raw communication event
+- `claim`: a structured statement that can be checked
+- `gate`: the rule or authority required before adoption
+- `update`: the accepted change to local state
+- `graph`: the growing map of relations, sources, and decisions
+
+## Design Principles
+
+- local first: the node should remain useful without depending on a central cloud
+- private by default: knowledge can grow locally before it is published
+- explicit authority: humans, agents, tools, and institutions should not be blurred
+- signed when serious: governance and adoption need cryptographic accountability
+- graphable by design: communication should become searchable structure
+- AI supported, not AI owned: AI can assist reasoning, but gates define authority
+
+## What It Is Not
+
+Graphite is not yet a production framework, standard, or foundation-wide dependency.
+
+It is also not a replacement for legal review, institutional governance, security audits, or domain-specific compliance.
+
+## Foundation Boundary
 
 Graphite is not yet formally adopted by the Gelişim Sanat Merkezi foundation.
 
@@ -28,22 +87,7 @@ Current role:
 incubator repo boundary inside foundation
 ```
 
-## Why This Exists
-
-The foundation accidentally discovered a useful server pattern:
-
-- local-first,
-- private by default,
-- ontology-aware,
-- claim-status aware,
-- lab-safe,
-- signed-governance capable,
-- graphable,
-- AI-assisted but authority-separated.
-
-Graphite is the attempt to extract that pattern into its own repo so other developers can inspect, harden, and eventually support it.
-
-## 1.0 Rule
+## Road To 1.0
 
 Graphite becomes foundation-wide only when:
 
@@ -57,3 +101,12 @@ signed foundation governance approves adoption
 
 Until then, it remains a lab-grade incubator.
 
+## Feedback
+
+Serious technical feedback is welcome through GitHub issues, discussions, or the wiki.
+
+Created by Cem Pehlivan:
+
+```text
+https://www.linkedin.com/in/cemphlvn/
+```

package.json

@@ -2,7 +2,7 @@
   "name": "@gsm-foundation/graphite",
   "version": "0.0.0-incubating",
   "private": true,
-  "description": "local-first epistemic protocol server pattern incubated by the Gelişim Sanat Merkezi foundation",
+  "description": "ontology-based server communications bootstrap kit",
   "type": "module",
   "scripts": {
     "check": "node scripts/check.mjs"
@@ -11,4 +11,3 @@
     "node": ">=18"
   }
 }
-