abstractnote 0.1.0__tar.gz → 0.3.0__tar.gz

{abstractnote-0.1.0/src/abstractnote.egg-info → abstractnote-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractnote
-Version: 0.1.0
+Version: 0.3.0
 Summary: AbstractNote: one endpoint for your notes; a temporal semantic knowledge graph of your life, built on AbstractGateway, AbstractRuntime and AbstractMemory
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 License-Expression: MIT
@@ -18,13 +18,14 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: abstractmemory>=0.3.1
+Requires-Dist: abstractmemory>=0.4.0
 Requires-Dist: abstractsemantics>=0.0.5
-Requires-Dist: abstractruntime>=0.10.2
+Requires-Dist: abstractruntime>=0.15.0
 Requires-Dist: abstractcore>=2.26.3
 Requires-Dist: pydantic>=2.0
+Requires-Dist: networkx<3.7,>=3.2
 Provides-Extra: gateway
-Requires-Dist: abstractgateway>=0.15.11; extra == "gateway"
+Requires-Dist: abstractgateway>=0.17.0; extra == "gateway"
 Requires-Dist: fastapi>=0.110; extra == "gateway"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
@@ -44,8 +45,12 @@ runtime and one notebook per user, app hosting), **AbstractRuntime** and **Abstr
 capture and understanding workflows), **AbstractMemory** (temporal facts) and **AbstractCore**
 (models, structured output, embeddings).
 
-Status: version 0.1.0, in development. It is not published on PyPI or npm yet; you install it
-from source (see [Install](#install)).
+Status: version 0.3.0, alpha. The Python package is `abstractnote` on PyPI and the web app is
+`@abstractframework/note` on npm (see [Install](#install)).
+
+What's new in 0.3.0: the web app follows runs through the gateway's replay view and says when a run waits
+for an answer, the top bar carries the shared Docs assistant and one account widget, and Capture uses the
+shared composer. See [CHANGELOG.md](CHANGELOG.md#030---2026-11-02).
 
 ## What you get
 
@@ -65,29 +70,23 @@ from source (see [Install](#install)).
 
 ## Install
 
-AbstractNote needs Python 3.10 or later and the framework packages next to it. Until the
-packages are published, install everything from source checkouts:
+AbstractNote needs Python 3.10 or later. Install it with the gateway integration:
 
 ```sh
-python3 -m venv .venv
-.venv/bin/pip install -e ../abstractsemantics -e ../abstractcore -e ../abstractruntime \
-                      -e ../abstractmemory     # a checkout that has close_assertion, see below
-.venv/bin/pip install -e .
-.venv/bin/abstractnote --help
+pip install "abstractnote[gateway]"
+abstractnote --help
 ```
 
-Two framework changes that AbstractNote relies on are not in released packages yet:
-
-- **AbstractMemory `close_assertion`** (the `close-assertion` branch): closes a superseded fact in
-  place. AbstractNote's first release waits for the AbstractMemory release that contains it.
-- **The AbstractGateway integration** (the `abstractnote-seam` branch): binds the note tools to
-  each user's notebook, serves the note read API and lists the Note app. You need it only for the
-  gateway path; the headless notebook works without a gateway. The gateway must carry this seam
-  (`abstractgateway.abstractnote_seam`; the first gateway release with it is named at
-  AbstractNote's release): the `[gateway]` extra alone does not guarantee it, and
-  `abstractnote.gateway` refuses to import into a gateway without it, with one sentence.
+This brings AbstractMemory 0.4.0 or later, AbstractRuntime 0.15.0 or later and AbstractGateway 0.17.0 or later. The
+gateway carries the AbstractNote integration (`abstractgateway.abstractnote_seam`) since 0.15.11: with
+`abstractnote` installed in the gateway's environment, every user gets the note tools, the note
+read API under `/api/gateway/note` and the note workflows. `pip install abstractnote` alone is
+enough for a headless notebook on one machine. To run models locally on Apple silicon, add
+`pip install "abstractcore[apple]"` (MLX).
 
-To run models locally on Apple silicon, add `pip install "abstractcore[apple]"` (MLX).
+The web app is the npm package `@abstractframework/note`, which the gateway's app catalog installs
+and serves as the Note app. To work on AbstractNote itself, install it from a source checkout; see
+[CONTRIBUTING.md](CONTRIBUTING.md) and [docs/getting-started.md](docs/getting-started.md#install-from-source).
 
 ## Quick start
 
@@ -121,7 +120,7 @@ gateway, the web app and the watch app.
 
 | Client | Where | What it does |
 |---|---|---|
-| Web app | [`web/`](web/) (`@abstractframework/note`) | Capture (a chat with attachments), Graph (entities and links through time), Remember (since you last looked, cue cards, ask by effort, then and now), Settings |
+| Web app | [`web/`](web/) (`@abstractframework/note`) | Capture (a chat with attachments), Remember (since you last looked, cue cards, ask by effort, then and now), Explore (entities and links through time), Processing (what the notebook is doing with your notes, live: the queue and its pace, the notes being understood, failures, and the scheduled consolidation), and a Settings panel |
 | Apple Watch app | [`watch/apple/`](watch/apple/README.md) | Note, Ask, Today, Settings; watch-only, watchOS 26 or later |
 | Command line | `abstractnote` | Headless capture, search, processing, imports, rebuild, JSON output for scripts and agents |
 

{abstractnote-0.1.0 → abstractnote-0.3.0}/README.md

@@ -11,8 +11,12 @@ runtime and one notebook per user, app hosting), **AbstractRuntime** and **Abstr
 capture and understanding workflows), **AbstractMemory** (temporal facts) and **AbstractCore**
 (models, structured output, embeddings).
 
-Status: version 0.1.0, in development. It is not published on PyPI or npm yet; you install it
-from source (see [Install](#install)).
+Status: version 0.3.0, alpha. The Python package is `abstractnote` on PyPI and the web app is
+`@abstractframework/note` on npm (see [Install](#install)).
+
+What's new in 0.3.0: the web app follows runs through the gateway's replay view and says when a run waits
+for an answer, the top bar carries the shared Docs assistant and one account widget, and Capture uses the
+shared composer. See [CHANGELOG.md](CHANGELOG.md#030---2026-11-02).
 
 ## What you get
 
@@ -32,29 +36,23 @@ from source (see [Install](#install)).
 
 ## Install
 
-AbstractNote needs Python 3.10 or later and the framework packages next to it. Until the
-packages are published, install everything from source checkouts:
+AbstractNote needs Python 3.10 or later. Install it with the gateway integration:
 
 ```sh
-python3 -m venv .venv
-.venv/bin/pip install -e ../abstractsemantics -e ../abstractcore -e ../abstractruntime \
-                      -e ../abstractmemory     # a checkout that has close_assertion, see below
-.venv/bin/pip install -e .
-.venv/bin/abstractnote --help
+pip install "abstractnote[gateway]"
+abstractnote --help
 ```
 
-Two framework changes that AbstractNote relies on are not in released packages yet:
-
-- **AbstractMemory `close_assertion`** (the `close-assertion` branch): closes a superseded fact in
-  place. AbstractNote's first release waits for the AbstractMemory release that contains it.
-- **The AbstractGateway integration** (the `abstractnote-seam` branch): binds the note tools to
-  each user's notebook, serves the note read API and lists the Note app. You need it only for the
-  gateway path; the headless notebook works without a gateway. The gateway must carry this seam
-  (`abstractgateway.abstractnote_seam`; the first gateway release with it is named at
-  AbstractNote's release): the `[gateway]` extra alone does not guarantee it, and
-  `abstractnote.gateway` refuses to import into a gateway without it, with one sentence.
+This brings AbstractMemory 0.4.0 or later, AbstractRuntime 0.15.0 or later and AbstractGateway 0.17.0 or later. The
+gateway carries the AbstractNote integration (`abstractgateway.abstractnote_seam`) since 0.15.11: with
+`abstractnote` installed in the gateway's environment, every user gets the note tools, the note
+read API under `/api/gateway/note` and the note workflows. `pip install abstractnote` alone is
+enough for a headless notebook on one machine. To run models locally on Apple silicon, add
+`pip install "abstractcore[apple]"` (MLX).
 
-To run models locally on Apple silicon, add `pip install "abstractcore[apple]"` (MLX).
+The web app is the npm package `@abstractframework/note`, which the gateway's app catalog installs
+and serves as the Note app. To work on AbstractNote itself, install it from a source checkout; see
+[CONTRIBUTING.md](CONTRIBUTING.md) and [docs/getting-started.md](docs/getting-started.md#install-from-source).
 
 ## Quick start
 
@@ -88,7 +86,7 @@ gateway, the web app and the watch app.
 
 | Client | Where | What it does |
 |---|---|---|
-| Web app | [`web/`](web/) (`@abstractframework/note`) | Capture (a chat with attachments), Graph (entities and links through time), Remember (since you last looked, cue cards, ask by effort, then and now), Settings |
+| Web app | [`web/`](web/) (`@abstractframework/note`) | Capture (a chat with attachments), Remember (since you last looked, cue cards, ask by effort, then and now), Explore (entities and links through time), Processing (what the notebook is doing with your notes, live: the queue and its pace, the notes being understood, failures, and the scheduled consolidation), and a Settings panel |
 | Apple Watch app | [`watch/apple/`](watch/apple/README.md) | Note, Ask, Today, Settings; watch-only, watchOS 26 or later |
 | Command line | `abstractnote` | Headless capture, search, processing, imports, rebuild, JSON output for scripts and agents |
 

{abstractnote-0.1.0 → abstractnote-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "abstractnote"
-version = "0.1.0"
+version = "0.3.0"
 description = "AbstractNote: one endpoint for your notes; a temporal semantic knowledge graph of your life, built on AbstractGateway, AbstractRuntime and AbstractMemory"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -21,18 +21,21 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
 dependencies = [
-    "abstractmemory>=0.3.1",
+    "abstractmemory>=0.4.0",
     "abstractsemantics>=0.0.5",
-    "abstractruntime>=0.10.2",
+    "abstractruntime>=0.15.0",
     "abstractcore>=2.26.3",
     "pydantic>=2.0",
+    # Louvain community detection over the entity graph (backlog 0030); pure Python, no compiled parts.
+    # Capped below 3.7: Louvain gives other communities from one networkx release to the next (gate 04 M1), so
+    # only tested releases are allowed; meta.communities records the version and a change carries labels over.
+    "networkx>=3.2,<3.7",
 ]
 
 [project.optional-dependencies]
-# The gateway must carry the AbstractNote seam (abstractgateway.abstractnote_seam); no released
-# AbstractGateway has it yet, so this floor is raised to the first release that does when
-# AbstractNote is released. Until then abstractnote.gateway refuses to import without the seam.
-gateway = ["abstractgateway>=0.15.11", "fastapi>=0.110"]
+# The gateway must carry the AbstractNote seam (abstractgateway.abstractnote_seam); 0.15.11 is
+# the first AbstractGateway release that does. abstractnote.gateway refuses to import without it.
+gateway = ["abstractgateway>=0.17.0", "fastapi>=0.110"]
 dev = ["pytest>=7.0", "ruff>=0.1"]
 
 [project.scripts]
@@ -51,7 +54,7 @@ where = ["src"]
 include = ["abstractnote*"]
 
 [tool.setuptools.package-data]
-abstractnote = ["flows/json/*.json", "process/prompts/*.md"]
+abstractnote = ["flows/json/*.json", "process/prompts/*.md", "process/generic_words.txt"]
 
 [tool.ruff]
 line-length = 110

{abstractnote-0.1.0 → abstractnote-0.3.0}/src/abstractnote/__init__.py

@@ -4,7 +4,7 @@
 returns the note tools for flows and agents.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.3.0"
 
 
 def __getattr__(name: str):  # lazy: importing abstractnote stays cheap

{abstractnote-0.1.0 → abstractnote-0.3.0}/src/abstractnote/cli.py

@@ -6,6 +6,10 @@ gateway the notebook is ``<gateway data dir>/abstractnote``, or
 ``--gateway URL --token T`` client mode is not available yet and says so.
 Output is JSON on stdout. Exit codes: 0 done, 2 bad input, 3 a part of
 AbstractNote that is not installed or not available yet.
+
+Read commands (search, entity, day, status, changes) never finish a half-applied revision:
+another process may still be applying it. ``capture`` and ``process`` recover first, and
+``abstractnote recover`` does it on request.
 """
 
 from __future__ import annotations
@@ -59,6 +63,8 @@ def build_parser() -> argparse.ArgumentParser:
     p.add_argument("--until")
     p.add_argument("--as-of")
     p.add_argument("--limit", type=int, default=20)
+    p.add_argument("--order", choices=["relevance", "earliest"], default="relevance",
+                   help="quick effort: best matches first, or the matching notes oldest first")
     p.add_argument("--provider", help="model provider for standard and deep effort")
     p.add_argument("--model", help="model for standard and deep effort")
 
@@ -80,10 +86,28 @@ def build_parser() -> argparse.ArgumentParser:
     p.add_argument("--since")
     p.add_argument("--limit", type=int, default=50)
 
+    p = sub.add_parser("recover", help="finish revisions a stopped process left half applied")
+    _common(p)
+
     p = sub.add_parser("rebuild", help="replay revisions into fresh index and triple stores")
     _common(p)
     p.add_argument("--reembed", action="store_true", help="recompute every vector with the given embedder")
 
+    p = sub.add_parser("normalize", help="merge the entities that share a canonical name (one reversible merge each)")
+    _common(p)
+    p.add_argument("--dry-run", action="store_true", help="only list the groups that would be merged")
+    p.add_argument("--account", help="who asked, recorded in each merge's source")
+
+    p = sub.add_parser("normalize-topics", help="give every topic one spelling (one revision)")
+    _common(p)
+    p.add_argument("--dry-run", action="store_true", help="only list the groups")
+    p.add_argument("--account", help="who asked, recorded in the revision's source")
+
+    p = sub.add_parser("dedupe-sources", help="archive the second copy of memory files imported by two importers")
+    _common(p)
+    p.add_argument("--dry-run", action="store_true", help="only list the pairs")
+    p.add_argument("--account", help="who asked, recorded in the revision's source")
+
     p = sub.add_parser("process", help="process queued notes now")
     _common(p)
     p.add_argument("--local", action="store_true", help="run the flows here (headless)")
@@ -92,6 +116,15 @@ def build_parser() -> argparse.ArgumentParser:
     p.add_argument("--max-items", type=int, default=20)
     p.add_argument("--budget-s", type=float, default=90.0)
 
+    p = sub.add_parser("refile", help="file the understood notes that have no kind (imports skipped the filing)")
+    _common(p)
+    p.add_argument("--missing", action="store_true", help="the understood notes without a kind (required)")
+    p.add_argument("--local", action="store_true", help="run the filing flow here (headless)")
+    p.add_argument("--provider")
+    p.add_argument("--model")
+    p.add_argument("--max-items", type=int, default=50)
+    p.add_argument("--budget-s", type=float, default=600.0)
+
     p = sub.add_parser("bundle", help="pack the abstractnote .flow bundle")
     p.add_argument("--out", type=Path, default=Path("."))
 
@@ -153,7 +186,8 @@ def _runner(args: argparse.Namespace) -> Any:
 def _cmd_search(args: argparse.Namespace) -> Any:
     if args.effort == "quick":
         with _open(args) as nb:
-            return nb.search(args.query, since=args.since, until=args.until, as_of=args.as_of, limit=args.limit)
+            return nb.search(args.query, since=args.since, until=args.until, as_of=args.as_of, limit=args.limit,
+                             order=args.order)
     _client_mode(args)
     if not args.notebook:
         raise ValueError("Say which notebook with --notebook DIR.")
@@ -171,6 +205,32 @@ def _cmd_process(args: argparse.Namespace) -> Any:
     return _runner(args).run_drain(max_items=args.max_items, budget_s=args.budget_s)
 
 
+def _cmd_refile(args: argparse.Namespace) -> Any:
+    _client_mode(args)
+    if not args.missing:
+        raise ValueError("Say which notes to file: --missing (the understood notes without a kind).")
+    if not args.local:
+        raise NotImplementedError("Filing through a gateway is not available here; use --local with --provider and "
+                                  "--model.")
+    if not args.notebook:
+        raise ValueError("Say which notebook with --notebook DIR.")
+    from .ingest.refile import refile_missing
+
+    runner = _runner(args)
+    with _open(args) as nb:
+        nb.require_embedder()
+        return refile_missing(nb, lambda note_id: runner.run("note-file", {"note_id": note_id}),
+                              max_items=args.max_items, budget_s=args.budget_s,
+                              model=f"{args.provider}/{args.model}")
+
+
+def _cmd_normalize(args: argparse.Namespace) -> Any:
+    # A dry run needs no embedder: a notebook pinned to a model that is not available here opens read-only for
+    # meaning, which is enough to list the groups; the merges themselves need the notebook's model.
+    with _open(args) as nb:
+        return nb.normalize_entities(args.account, client="cli", dry_run=args.dry_run)
+
+
 def _cmd_bundle(args: argparse.Namespace) -> Any:
     try:
         from .flows.bundle import pack
@@ -213,11 +273,25 @@ def main(argv: Optional[List[str]] = None) -> int:
         elif args.command == "changes":
             with _open(args) as nb:
                 out = nb.changes(args.since, args.limit)
+        elif args.command == "recover":
+            with _open(args) as nb:
+                nb.require_embedder()
+                out = {"recovered": nb.recover()}
         elif args.command == "rebuild":
             with _open(args) as nb:
                 out = nb.rebuild(reembed=args.reembed, embedder=_embedder(args))
+        elif args.command == "normalize":
+            out = _cmd_normalize(args)
+        elif args.command == "normalize-topics":
+            with _open(args) as nb:
+                out = nb.normalize_topics(args.account, client="cli", dry_run=args.dry_run)
+        elif args.command == "dedupe-sources":
+            with _open(args) as nb:
+                out = nb.dedupe_sources(args.account, client="cli", dry_run=args.dry_run)
         elif args.command == "process":
             out = _cmd_process(args)
+        elif args.command == "refile":
+            out = _cmd_refile(args)
         elif args.command == "bundle":
             out = _cmd_bundle(args)
         elif args.command == "processor":