memnet-llm 0.2.6__tar.gz

memnet_llm-0.2.6/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# MemNet data (local graph stores)
+*.db
+.memnet/
+
+# Environment
+.env
+.env.local
+
+# IDE / OS
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db

memnet_llm-0.2.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MemNet contributors
+
+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.

memnet_llm-0.2.6/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: memnet-llm
+Version: 0.2.6
+Summary: In-memory working-memory graph CLI for LLM agents (goldfish brain scratch space)
+Project-URL: Homepage, https://github.com/chouswei/MemNet
+Project-URL: Repository, https://github.com/chouswei/MemNet
+Project-URL: Changelog, https://github.com/chouswei/MemNet/blob/master/CHANGELOG.md
+Project-URL: Documentation, https://github.com/chouswei/MemNet/blob/master/LLM-GUIDE.md
+Author: MemNet contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,cli,knowledge-graph,llm,memory,working-memory
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.10
+Requires-Dist: rich>=13.9
+Requires-Dist: typer>=0.15
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# MemNet
+
+**Pure in-memory working-memory graph for LLM "goldfish brains"** — structured state an agent writes once and re-reads each turn because the model forgets.
+
+MemNet is **scratch memory for the current task**, not a durable knowledge base or vector store. Sessions live in RAM, expire by TTL, and disappear on `session close`. There is **no automatic disk state**; persistence is explicit and user-controlled via `session save` / `session load`.
+
+## The problem it solves
+
+LLMs lose track of entities, state, and rules between tool calls. MemNet gives the agent a small, typed, queryable graph it can:
+
+- add facts, tasks, and relations once; update them when state changes,
+- pull back only the live slice on the next turn (`query warm --anchor`),
+- settle or expire missions so they stop polluting the prompt,
+- keep hard limits and produce machine-readable warnings instead of silent bloat.
+
+## Installation
+
+```powershell
+pip install memnet-llm
+```
+
+From source (development):
+
+```powershell
+pip install -e ".[dev]"
+```
+
+The CLI command is still **`memnet`**. PyPI package name is **`memnet-llm`** (the name `memnet` on [PyPI](https://pypi.org/project/memnet/) is a different project — memristive neural networks).
+
+Requires Python ≥ 3.11.
+
+## Quick start
+
+You need two terminals. One runs the in-memory server that holds the graph; the other runs the CLI client.
+
+**Terminal 1 (server):**
+
+```powershell
+memnet serve
+# prints: MEMNET_SERVE=127.0.0.1:18765
+```
+
+**Terminal 2 (client):**
+
+```powershell
+# See the cheat sheet
+memnet guide --loose
+
+# Start a session with the bundled schema
+memnet session open --map-file src/memnet/examples/schema.example.txt
+# stderr also prints: MEMNET_SESSION=mn_xxxxxxxx
+$env:MEMNET_SESSION = "mn_xxxxxxxx"
+
+# Ingest a small world (LAW rules + world state + missions)
+memnet add --file src/memnet/examples/workflow.example.txt
+
+# Preferred read for the next LLM turn: only live mission state
+memnet query warm --anchor PLR01
+
+# When done
+memnet session close $env:MEMNET_SESSION
+```
+
+Without `memnet serve` running, any stateful command returns `@ERR: serve_required`.
+
+For one-off scripting or tests you can set `MEMNET_TEST_INLINE=1` to run in-process (no server), but this is not the normal multi-turn agent mode.
+
+**LLM agents:** read `LLM-GUIDE.md` (in this repo) for the full agent playbook, the goldfish loop, settlement pattern, and disciplines. It is written to be consumed by models.
+
+## The goldfish loop (recommended pattern)
+
+A typical agent turn:
+
+1. `add` new rows or `update` existing ones (`@TAG:` lines, batch via `--stdin` or `--file` is best).
+2. `query warm --anchor <focus>` — returns only active (non-recyclable) rows, always includes LAW.
+3. Paste the wire lines into the prompt, reason, decide on next adds/updates or a mission settle.
+4. On mission complete: **update** the `TSK` (or equivalent) with both `status=settled` **and** `recycle=delete_on_settle`. Mission edges usually use `delete_on_expire` or `delete_on_settle`.
+5. Optionally `housekeep prune stale --apply` to physically remove settled rows.
+6. Next turn starts again at step 1 with a (usually new) anchor.
+
+`query context` (cold) returns everything and emits `@WRN: stale_in_store|…` on stderr when recyclable rows exist. Prefer `warm`.
+
+## Wire format
+
+One record per line:
+
+```
+@TAG: field|field|...
+```
+
+- Pipe inside a value must be escaped: `note\|extra` (or `\\|` in some shells).
+- Always quote the whole line in PowerShell or bash when it contains special characters.
+- Reserved output tags: `@SESSION`, `@ERR`, `@WRN`, `@STAT`, `@REL`, `@DEL`.
+- Errors and advisories go to **stderr**; data rows to **stdout**.
+
+Example multi-line ingest (PowerShell):
+
+```powershell
+memnet add --stdin @"
+@NPC: N01|Shen Tiexin|female(12)|0|traditional|80|active|persistent
+@EDG: E01|N01|seeks_help|PLR01|unlock|delete_on_expire
+"@
+
+memnet update --stdin @"
+@NPC: N01|Shen Tiexin|female(12)|0|traditional|90|active|persistent
+"@
+```
+
+See `memnet guide`, `memnet examples map`, and `memnet tagmap fields --tag <TAG>` for the current schema.
+
+## Commands
+
+Run any command with `--help` for full flags.
+
+### Session lifecycle
+| Command                  | Purpose |
+|--------------------------|---------|
+| `session open --map-file` | Create a new session (prints `@SESSION:` and `MEMNET_SESSION=...` on stderr) |
+| `session resume <id>`    | Attach to an existing session |
+| `session current`        | Show the id from `$env:MEMNET_SESSION` (or "none") |
+| `session list`           | List live sessions (id, expires, minutes left, last modified) |
+| `session save --file`    | **Optional** export of the current graph to a user-chosen snapshot file (wire format) |
+| `session load --file`    | Restore a snapshot into RAM (new session id by default; `--keep-id` to reuse) |
+| `session close <id>`     | Destroy the session (graph is gone) |
+
+Default TTL is 60 minutes (`MEMNET_SESSION_TTL_MINUTES` or `--ttl`).
+
+### Add, update & delete
+- `add [line] [--file PATH] [--stdin] [--dry-run] [--allow-new-relation] [--agent NAME] [--session]`
+  - Create **new** rows only. Fails with `id_exists` if the id is already in the graph.
+- `update [line] [--file PATH] [--stdin] [--dry-run] [--allow-new-relation] [--agent NAME] [--session]`
+  - Replace **existing** rows only. Fails with `not_found` if the id is missing (catches update typos).
+- Batch via `--stdin` or `--file` is strongly preferred. `--dry-run` parses without mutating.
+- `delete --id ID`
+
+### Query (graph reads)
+- `query warm --anchor ID [--depth N] [--max-rows M]` — **the normal read for agents**. `active_only` is forced; anchor is required. LAW rows are always included.
+- `query context [--anchor] [--depth] [--max-rows] [--active-only]` — cold/full view (use for audit; warns on stale rows).
+- `query neighbors <id> [--depth]`
+- `query path <src> <dst>`
+
+### Direct reads
+- `read list [--tag T] [--active-only] [--where field=value ...]`
+- `read get --id ID [--tag T]`
+
+`--where` filters by field value (exact match). Repeat for AND. Use `*` or `?` wildcards for glob match (e.g. `--where name=*Tiexin*`).
+
+### Housekeeping
+- `housekeep stats` — `@STAT` rows + caps for rows/edges/relations/orphans/dangling/recyclable/**modified**.
+- `housekeep stale|orphans|dangling|recyclable` — list the respective sets.
+- `housekeep prune stale|... --apply` — actually delete (emits `@DEL` lines and a summary on stderr).
+
+`stale` = recyclable + dangling + orphans.
+
+### Schema & relations
+- `tagmap fields [--tag T]` / `map fields` — reference field lists.
+- `tagmap show` / `map show` — current session's effective tag map.
+- `relations list` — allowed EDG relation names for this session.
+- New relations are rejected unless `add` or `update` uses `--allow-new-relation` (subject to `max_relations`).
+
+### Examples & server
+- `examples map|workflow|add <tag>|path`
+- `serve [--host] [--port]` — the in-memory graph host. Required for normal CLI use across processes.
+- `version`, `guide`, `guide --loose`
+
+## Session model & optional snapshots
+
+- One `session open` per task. Agents should `resume` rather than open duplicates.
+- The graph is **RAM only** while the session is live.
+- `session save --file my.snap` writes a plain-text wire-format snapshot that *you* own. `session load --file my.snap` brings it back into a (usually new) RAM session.
+- On `close` or TTL expiry the session is dropped from the server; no server-side files remain.
+- Snapshots are a user convenience, not MemNet's durability layer.
+
+## Housekeeping, warnings, and signals
+
+On every stateful command the server emits advisory `@WRN` lines on stderr (capped per call):
+
+- `near_cap*`, `ttl_expiring`
+- `stale_in_store`, `stale_dangling`, `stale_orphans`, `stale_graph`
+- `mission_settled`
+- `fanout_clamped`, `dangling_endpoint`, etc.
+
+`@STAT` lines report counts vs caps. `@DEL` lines are emitted after successful `prune --apply` or `delete`.
+
+## Environment variables
+
+| Variable                        | Effect |
+|---------------------------------|--------|
+| `MEMNET_SESSION`                | Default session id when `--session` is omitted |
+| `MEMNET_SESSION_TTL_MINUTES`    | Default TTL for new sessions (1..1440) |
+| `MEMNET_AGENT`                  | Default agent name stamped on written records |
+| `MEMNET_SERVE_HOST`, `MEMNET_SERVE_PORT` | Bind address for `memnet serve` (client discovery is implicit via the same vars) |
+| `MEMNET_MAX_ROWS` / `MAX_LAW` / `MAX_RELATIONS` / ... | Hard caps (see `Caps` in config) |
+| `MEMNET_TEST_INLINE`            | When set, CLI runs in-process (tests, one-off scripts). Not for normal agent use. |
+
+All caps have `MEMNET_MAX_*` names; see source for the full list and defaults.
+
+## Architecture (one minute)
+
+- `tagMap` — merged fixed + user schema loaded at `session open`. Drives parsing and field order on output.
+- `memStore` — in-memory nodes + directed edges (EDG). Write-order index, simple BFS for neighbours / paths / warm packs.
+- `LAW` rows — special, usually exempt from orphan/dangling accounting and always surface in warm reads.
+- `recycle` field — `persistent` (default for active world) vs `delete_on_settle` / `delete_on_expire` (missions). `query warm` hides the latter.
+- Server holds a registry of live `SessionEntry`s. CLI is a stateless client that talks over localhost TCP (or in-process in tests).
+
+No JSON on the wire for LLM consumption — only the `@TAG:` lines plus a handful of control records on stderr.
+
+## Application notes
+
+Rich, document-style worked examples live under `application-notes/`. These are self-contained narratives (one `.md` per note) showing complete usage patterns with all data — including background, configurations, bibles, rules, and user preferences — kept inside MemNet.
+
+See [application-notes/llm-novel-writer.md](application-notes/llm-novel-writer.md) for the first example: an interactive LLM novel writer driven by the explicit 6-step read → context → user-input-as-data → analyse → update → loop pipeline.
+
+See [application-notes/llm-sysml-v2-modeling.md](application-notes/llm-sysml-v2-modeling.md) for the second: LLM-assisted SysML v2 textual modeling (6U CubeSat PDU controller) with the same 6-step pipeline, a SysML v2 syntax reference table, a deployable "whole model as rows" block, explicit demonstration that models living in different .sysml files are easily referred to together via @PKG rows + declaredIn / cross-package EDG, and concrete examples of using the graph to help build the system (allocations, ports and connections driving wiring, implementation tasks and deployment), write the system model docs (interconnection views, behaviour specs, traceability matrices generated from the rows), and evaluate runtime behaviour (BEHD + timing/power + allocations for analysis, latency and power budgeting). Warm + EDG + settlement still keeps every turn's slice small, granular and on-demand.
+
+## Development
+
+```powershell
+.\scripts\dev.ps1          # setup / test / lint / fmt / cli
+pytest
+```
+
+Tests run with `MEMNET_TEST_INLINE=1` so they do not require a separate `serve` process.
+
+## Licence
+
+MIT

memnet_llm-0.2.6/README.md

@@ -0,0 +1,227 @@
+# MemNet
+
+**Pure in-memory working-memory graph for LLM "goldfish brains"** — structured state an agent writes once and re-reads each turn because the model forgets.
+
+MemNet is **scratch memory for the current task**, not a durable knowledge base or vector store. Sessions live in RAM, expire by TTL, and disappear on `session close`. There is **no automatic disk state**; persistence is explicit and user-controlled via `session save` / `session load`.
+
+## The problem it solves
+
+LLMs lose track of entities, state, and rules between tool calls. MemNet gives the agent a small, typed, queryable graph it can:
+
+- add facts, tasks, and relations once; update them when state changes,
+- pull back only the live slice on the next turn (`query warm --anchor`),
+- settle or expire missions so they stop polluting the prompt,
+- keep hard limits and produce machine-readable warnings instead of silent bloat.
+
+## Installation
+
+```powershell
+pip install memnet-llm
+```
+
+From source (development):
+
+```powershell
+pip install -e ".[dev]"
+```
+
+The CLI command is still **`memnet`**. PyPI package name is **`memnet-llm`** (the name `memnet` on [PyPI](https://pypi.org/project/memnet/) is a different project — memristive neural networks).
+
+Requires Python ≥ 3.11.
+
+## Quick start
+
+You need two terminals. One runs the in-memory server that holds the graph; the other runs the CLI client.
+
+**Terminal 1 (server):**
+
+```powershell
+memnet serve
+# prints: MEMNET_SERVE=127.0.0.1:18765
+```
+
+**Terminal 2 (client):**
+
+```powershell
+# See the cheat sheet
+memnet guide --loose
+
+# Start a session with the bundled schema
+memnet session open --map-file src/memnet/examples/schema.example.txt
+# stderr also prints: MEMNET_SESSION=mn_xxxxxxxx
+$env:MEMNET_SESSION = "mn_xxxxxxxx"
+
+# Ingest a small world (LAW rules + world state + missions)
+memnet add --file src/memnet/examples/workflow.example.txt
+
+# Preferred read for the next LLM turn: only live mission state
+memnet query warm --anchor PLR01
+
+# When done
+memnet session close $env:MEMNET_SESSION
+```
+
+Without `memnet serve` running, any stateful command returns `@ERR: serve_required`.
+
+For one-off scripting or tests you can set `MEMNET_TEST_INLINE=1` to run in-process (no server), but this is not the normal multi-turn agent mode.
+
+**LLM agents:** read `LLM-GUIDE.md` (in this repo) for the full agent playbook, the goldfish loop, settlement pattern, and disciplines. It is written to be consumed by models.
+
+## The goldfish loop (recommended pattern)
+
+A typical agent turn:
+
+1. `add` new rows or `update` existing ones (`@TAG:` lines, batch via `--stdin` or `--file` is best).
+2. `query warm --anchor <focus>` — returns only active (non-recyclable) rows, always includes LAW.
+3. Paste the wire lines into the prompt, reason, decide on next adds/updates or a mission settle.
+4. On mission complete: **update** the `TSK` (or equivalent) with both `status=settled` **and** `recycle=delete_on_settle`. Mission edges usually use `delete_on_expire` or `delete_on_settle`.
+5. Optionally `housekeep prune stale --apply` to physically remove settled rows.
+6. Next turn starts again at step 1 with a (usually new) anchor.
+
+`query context` (cold) returns everything and emits `@WRN: stale_in_store|…` on stderr when recyclable rows exist. Prefer `warm`.
+
+## Wire format
+
+One record per line:
+
+```
+@TAG: field|field|...
+```
+
+- Pipe inside a value must be escaped: `note\|extra` (or `\\|` in some shells).
+- Always quote the whole line in PowerShell or bash when it contains special characters.
+- Reserved output tags: `@SESSION`, `@ERR`, `@WRN`, `@STAT`, `@REL`, `@DEL`.
+- Errors and advisories go to **stderr**; data rows to **stdout**.
+
+Example multi-line ingest (PowerShell):
+
+```powershell
+memnet add --stdin @"
+@NPC: N01|Shen Tiexin|female(12)|0|traditional|80|active|persistent
+@EDG: E01|N01|seeks_help|PLR01|unlock|delete_on_expire
+"@
+
+memnet update --stdin @"
+@NPC: N01|Shen Tiexin|female(12)|0|traditional|90|active|persistent
+"@
+```
+
+See `memnet guide`, `memnet examples map`, and `memnet tagmap fields --tag <TAG>` for the current schema.
+
+## Commands
+
+Run any command with `--help` for full flags.
+
+### Session lifecycle
+| Command                  | Purpose |
+|--------------------------|---------|
+| `session open --map-file` | Create a new session (prints `@SESSION:` and `MEMNET_SESSION=...` on stderr) |
+| `session resume <id>`    | Attach to an existing session |
+| `session current`        | Show the id from `$env:MEMNET_SESSION` (or "none") |
+| `session list`           | List live sessions (id, expires, minutes left, last modified) |
+| `session save --file`    | **Optional** export of the current graph to a user-chosen snapshot file (wire format) |
+| `session load --file`    | Restore a snapshot into RAM (new session id by default; `--keep-id` to reuse) |
+| `session close <id>`     | Destroy the session (graph is gone) |
+
+Default TTL is 60 minutes (`MEMNET_SESSION_TTL_MINUTES` or `--ttl`).
+
+### Add, update & delete
+- `add [line] [--file PATH] [--stdin] [--dry-run] [--allow-new-relation] [--agent NAME] [--session]`
+  - Create **new** rows only. Fails with `id_exists` if the id is already in the graph.
+- `update [line] [--file PATH] [--stdin] [--dry-run] [--allow-new-relation] [--agent NAME] [--session]`
+  - Replace **existing** rows only. Fails with `not_found` if the id is missing (catches update typos).
+- Batch via `--stdin` or `--file` is strongly preferred. `--dry-run` parses without mutating.
+- `delete --id ID`
+
+### Query (graph reads)
+- `query warm --anchor ID [--depth N] [--max-rows M]` — **the normal read for agents**. `active_only` is forced; anchor is required. LAW rows are always included.
+- `query context [--anchor] [--depth] [--max-rows] [--active-only]` — cold/full view (use for audit; warns on stale rows).
+- `query neighbors <id> [--depth]`
+- `query path <src> <dst>`
+
+### Direct reads
+- `read list [--tag T] [--active-only] [--where field=value ...]`
+- `read get --id ID [--tag T]`
+
+`--where` filters by field value (exact match). Repeat for AND. Use `*` or `?` wildcards for glob match (e.g. `--where name=*Tiexin*`).
+
+### Housekeeping
+- `housekeep stats` — `@STAT` rows + caps for rows/edges/relations/orphans/dangling/recyclable/**modified**.
+- `housekeep stale|orphans|dangling|recyclable` — list the respective sets.
+- `housekeep prune stale|... --apply` — actually delete (emits `@DEL` lines and a summary on stderr).
+
+`stale` = recyclable + dangling + orphans.
+
+### Schema & relations
+- `tagmap fields [--tag T]` / `map fields` — reference field lists.
+- `tagmap show` / `map show` — current session's effective tag map.
+- `relations list` — allowed EDG relation names for this session.
+- New relations are rejected unless `add` or `update` uses `--allow-new-relation` (subject to `max_relations`).
+
+### Examples & server
+- `examples map|workflow|add <tag>|path`
+- `serve [--host] [--port]` — the in-memory graph host. Required for normal CLI use across processes.
+- `version`, `guide`, `guide --loose`
+
+## Session model & optional snapshots
+
+- One `session open` per task. Agents should `resume` rather than open duplicates.
+- The graph is **RAM only** while the session is live.
+- `session save --file my.snap` writes a plain-text wire-format snapshot that *you* own. `session load --file my.snap` brings it back into a (usually new) RAM session.
+- On `close` or TTL expiry the session is dropped from the server; no server-side files remain.
+- Snapshots are a user convenience, not MemNet's durability layer.
+
+## Housekeeping, warnings, and signals
+
+On every stateful command the server emits advisory `@WRN` lines on stderr (capped per call):
+
+- `near_cap*`, `ttl_expiring`
+- `stale_in_store`, `stale_dangling`, `stale_orphans`, `stale_graph`
+- `mission_settled`
+- `fanout_clamped`, `dangling_endpoint`, etc.
+
+`@STAT` lines report counts vs caps. `@DEL` lines are emitted after successful `prune --apply` or `delete`.
+
+## Environment variables
+
+| Variable                        | Effect |
+|---------------------------------|--------|
+| `MEMNET_SESSION`                | Default session id when `--session` is omitted |
+| `MEMNET_SESSION_TTL_MINUTES`    | Default TTL for new sessions (1..1440) |
+| `MEMNET_AGENT`                  | Default agent name stamped on written records |
+| `MEMNET_SERVE_HOST`, `MEMNET_SERVE_PORT` | Bind address for `memnet serve` (client discovery is implicit via the same vars) |
+| `MEMNET_MAX_ROWS` / `MAX_LAW` / `MAX_RELATIONS` / ... | Hard caps (see `Caps` in config) |
+| `MEMNET_TEST_INLINE`            | When set, CLI runs in-process (tests, one-off scripts). Not for normal agent use. |
+
+All caps have `MEMNET_MAX_*` names; see source for the full list and defaults.
+
+## Architecture (one minute)
+
+- `tagMap` — merged fixed + user schema loaded at `session open`. Drives parsing and field order on output.
+- `memStore` — in-memory nodes + directed edges (EDG). Write-order index, simple BFS for neighbours / paths / warm packs.
+- `LAW` rows — special, usually exempt from orphan/dangling accounting and always surface in warm reads.
+- `recycle` field — `persistent` (default for active world) vs `delete_on_settle` / `delete_on_expire` (missions). `query warm` hides the latter.
+- Server holds a registry of live `SessionEntry`s. CLI is a stateless client that talks over localhost TCP (or in-process in tests).
+
+No JSON on the wire for LLM consumption — only the `@TAG:` lines plus a handful of control records on stderr.
+
+## Application notes
+
+Rich, document-style worked examples live under `application-notes/`. These are self-contained narratives (one `.md` per note) showing complete usage patterns with all data — including background, configurations, bibles, rules, and user preferences — kept inside MemNet.
+
+See [application-notes/llm-novel-writer.md](application-notes/llm-novel-writer.md) for the first example: an interactive LLM novel writer driven by the explicit 6-step read → context → user-input-as-data → analyse → update → loop pipeline.
+
+See [application-notes/llm-sysml-v2-modeling.md](application-notes/llm-sysml-v2-modeling.md) for the second: LLM-assisted SysML v2 textual modeling (6U CubeSat PDU controller) with the same 6-step pipeline, a SysML v2 syntax reference table, a deployable "whole model as rows" block, explicit demonstration that models living in different .sysml files are easily referred to together via @PKG rows + declaredIn / cross-package EDG, and concrete examples of using the graph to help build the system (allocations, ports and connections driving wiring, implementation tasks and deployment), write the system model docs (interconnection views, behaviour specs, traceability matrices generated from the rows), and evaluate runtime behaviour (BEHD + timing/power + allocations for analysis, latency and power budgeting). Warm + EDG + settlement still keeps every turn's slice small, granular and on-demand.
+
+## Development
+
+```powershell
+.\scripts\dev.ps1          # setup / test / lint / fmt / cli
+pytest
+```
+
+Tests run with `MEMNET_TEST_INLINE=1` so they do not require a separate `serve` process.
+
+## Licence
+
+MIT

memnet_llm-0.2.6/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "memnet-llm"
+dynamic = ["version"]
+description = "In-memory working-memory graph CLI for LLM agents (goldfish brain scratch space)"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "MemNet contributors" }]
+keywords = ["knowledge-graph", "llm", "cli", "memory", "agent", "working-memory"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "pydantic>=2.10",
+    "rich>=13.9",
+    "typer>=0.15",
+]
+
+[project.urls]
+Homepage = "https://github.com/chouswei/MemNet"
+Repository = "https://github.com/chouswei/MemNet"
+Changelog = "https://github.com/chouswei/MemNet/blob/master/CHANGELOG.md"
+Documentation = "https://github.com/chouswei/MemNet/blob/master/LLM-GUIDE.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3",
+    "pytest-cov>=6.0",
+    "ruff>=0.9",
+]
+
+[project.scripts]
+memnet = "memnet.cli:main"
+
+[tool.hatch.version]
+path = "src/memnet/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/memnet"]
+
+[tool.hatch.build.targets.sdist]
+only-include = ["src/memnet", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+markers = [
+    "scheme(id): integration scheme identifier from plan S01-S115",
+]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.ruff.format]
+quote-style = "double"

memnet_llm-0.2.6/src/memnet/__init__.py

@@ -0,0 +1,3 @@
+"""MemNet — a tiny CLI knowledge graph for LLM context."""
+
+__version__ = "0.2.6"

memnet_llm-0.2.6/src/memnet/__main__.py

@@ -0,0 +1,4 @@
+from memnet.cli import app
+
+if __name__ == "__main__":
+    app()