@miruzero/zgpt 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# Zero ChatGPT
+
+`M:\Zero_ChatGPT` is the standalone ChatGPT runtime and the only default owner of ChatGPT state.
+
+## Scope
+
+This package contains only ChatGPT-specific runtime code:
+
+- authentication and session bootstrap
+- conversation read/write operations
+- ChatGPT project operations
+- ChatGPT connector operations
+- ChatGPT Web protocol mechanics
+- direct HTTP/SSE transport
+- ChatGPT mutable state under `M:\Zero_ChatGPT\state`
+
+It contains no Zero Core, MCP, Agent orchestration, CLI adapter, or generic device/task runtime.
+
+## Public API
+
+```js
+const chatgpt = require('M:/Zero_ChatGPT');
+
+await chatgpt.auth.ensure();
+await chatgpt.session.acquire();
+await chatgpt.conversation.get(id);
+await chatgpt.conversation.send(id, message);
+await chatgpt.project.listProjects(options);
+await chatgpt.connector.listConnectors(options);
+```
+
+## Runtime rules
+
+- Direct ChatGPT Web transport is the only conversation transport.
+- Session exchange transport must be supplied explicitly; no browser/CDP transport is implicit.
+- 429 opens shared cooldown and is not amplified by retries.
+- No hardcoded credentials or secret-bearing diagnostics.
+- Default writable state lives only under `M:\Zero_ChatGPT\state`.

package/docs/architecture.md

@@ -0,0 +1,51 @@
+# Zero ChatGPT Architecture
+
+## Ownership
+
+`M:\Zero_ChatGPT` owns only ChatGPT-specific runtime behavior and ChatGPT state.
+
+## Runtime
+
+```text
+auth / session / conversation / project / connector
+                    |
+                 protocol
+sentinel / proof / conduit / payload / SSE
+                    |
+                 transport
+               direct HTTP/SSE
+                    |
+                chatgpt.com
+```
+
+Only ChatGPT runtime concerns belong in this package. Zero Core, MCP, Agent orchestration, devices, task routing, and adapter layers stay outside it.
+
+## State
+
+Default mutable state is under `M:\Zero_ChatGPT\state`:
+
+- `auth-context.json`
+- `session-context.json`
+- `temp-conversations.json` when temporary-chat cursor state exists
+- rate-limit state
+
+The state directory is the only default writer for ChatGPT runtime state.
+
+## Boundaries
+
+- `conversation` owns conversation lifecycle and message/stream behavior.
+- `project` owns project CRUD and project conversation grouping.
+- `connector` owns ChatGPT connector discovery, actions, refresh, and mention resolution.
+- `protocol` owns ChatGPT Web payload, Sentinel, conduit, and SSE mechanics.
+- `transport` owns HTTP, headers, retries, cooldown, and session-cookie persistence.
+- `session` owns ChatGPT session acquisition/exchange; it has no implicit browser/CDP transport.
+
+## Invariants
+
+1. Direct transport is the only conversation transport.
+2. Session exchange transport is explicit.
+3. Missing auth fails closed.
+4. Secrets are never embedded in source or diagnostics.
+5. External ChatGPT responses are validated before state mutation.
+6. This package owns only ChatGPT runtime state.
+7. No Zero Core, MCP, Agent, device, task, or adapter implementation lives here.

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@miruzero/zgpt",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "main": "src/index.js",
+  "bin": {
+    "zgpt": "src/cli.js"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "classic-level": "^3.0.0"
+  },
+  "allowScripts": {
+    "classic-level@3.0.0": true
+  },
+  "files": [
+    "src",
+    "README.md",
+    "docs/architecture.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}