Merge the next version: fixes, Claude Platform, Project Docs and enowX UI

AGENTS.md

@@ -30,6 +30,7 @@ Go 1.27+ is required (MyGo needs it). With an older `go`, set `GOTOOLCHAIN=go1.2
 | `core/git` | Thin wrappers over the `git` CLI | **No** |
 | `core/project` | Project folders a daemon knows, in the user's order and groups, stored in `~/.enowx-app/projects.json` | **No** |
 | `core/notes` | The user's notes on a host, a Markdown file each in `~/.enowx-app/notes` (see `docs/notes.md`) | **No** |
+| `core/projectdocs` | Project Docs: a project documented as notes under one project note: the first line and Based on lines in the body, catalog and templates, staleness, the approval gate, the guard on agents' writes, the skills (see `docs/project-docs.md`) | **No** |
 | `core/features` | Which features agents get, per scope (everywhere, host, project, session), resolved for a session; the registry is `core/agent.Features` (see `docs/features.md`) | **No** |
 | `core/notify` | How the app notifies of agents: the settings kept in the synced settings, the sounds built in (synthesized), quiet hours | **No** |
 | `core/usersync` | Keeps the user's data (notes, canvases, settings, vault) the same on every host: three-way file sync, merges, conflicts, trash (see `docs/user-data-sync.md`) | **No** |
@@ -44,6 +45,9 @@ Go 1.27+ is required (MyGo needs it). With an older `go`, set `GOTOOLCHAIN=go1.2
 | `core/vault` | The user's credential vault: sealed with a key that stays on the device, its platforms, what a session gets of a credential, hosts' imports, the SSH agent and the record of uses (see `docs/vault.md`) | **No** |
 | `core/accounts` | Agents' configs (synced): other accounts, each a home of its own sharing the agent's settings, and model APIs; team members' accounts per host (see `docs/configs.md`, `docs/accounts.md`) | **No** |
 | `core/agent` | Agent presets (Claude Code, Codex, …) and how they take a first prompt | **No** |
+| `core/platformagent` | Claude Platform, enowX's own agent (see `docs/claude-platform.md`): the loop over Anthropic's Messages API | **No** |
+| `core/platformagent/record` | Its conversation's file format, read by `core/transcript` and `core/tokens` | **No** |
+| `core/platformagent/terminal`, `tools`, `permission`, `mcpclient` | Its screen in a session's terminal, its tools, permission rules and MCP client | **No** |
 | `core/agentapi` | How each agent takes a model API: per session by its environment and flags (a config's), or in its own settings, backed up first, for those that can't (see `docs/configs.md`, `docs/agent-api.md`) | **No** |
 | `core/hosts` | The device's server list (`~/.enowx-app/hosts.json`); passwords live in the keychain, never here | **No** |
 | `core/tailnet` | Devices on the user's tailnet, via the `tailscale` CLI | **No** |
@@ -76,13 +80,18 @@ Go 1.27+ is required (MyGo needs it). With an older `go`, set `GOTOOLCHAIN=go1.2
 | `core/discordrpc` | Discord Rich Presence over the Discord app's local IPC socket (named pipe on Windows) | **No** |
 | `core/cacheclean` | Clean cache: what a host's enowX folder takes, what can go of it, and removing that, never anything outside the few folders it names (see `docs/daemon.md`) | **No** |
 | `core/procstat` | Memory and CPU of process trees and of the machine, for the resource usage view | **No** |
+| `core/selfprofile` | What the process it runs in holds and uses, by the system's count and the Go runtime's, for `enowx-app profile` (see `docs/performance.md`) | **No** |
+| `core/memtune` | How long-running programs give memory back: the limit on the Go heap, returning what a burst leaves (see `docs/performance.md`) | **No** |
 | `cloud/` | The team cloud's server (`cloud/server`), its database (`cloud/store`), API types (`cloud/api`) and the sealing of a team's keys and items (`cloud/seal`) (see `docs/cloud.md`) | **No** |
+| `cloud/library` | enowX UI's server, under `/v1/library`: the community library's API, its web sign-in, moderation (see `docs/library.md`) | **No** |
+| `core/designshare` | A canvas's design made into what the community library keeps: its bundle and checks, the host's drafts, the code, skills and `enowx://` links people take from it; `core/designshare/thumb` its picture (see `docs/library.md`) | **No** |
 | `cmd/enowx-cloud` | The cloud server's entry point and its image (`Dockerfile`) | **No** |
 | `hostconn/` | Connects to a host's daemon: starts or replaces it locally, installs or upgrades it over SSH | **No** |
 | `docs/` | The docs, and package `docs` shipping them in the program for `goa doc` (all top-level `*.md` but `PLAN.md`) | **No** |
 | `version/` | The release version shared by app, daemon and client | **No** |
 | `internal/quietcmd` | Starts programs in the background without a console window on Windows | **No** |
 | `internal/watchdog` | Leaves a report when a thread stops answering (every goroutine's stack, what was on screen), and a line of what memory holds, in the data folder's `watchdog` folder | **No** |
+| `internal/rpccount` | A connection counting calls and bytes, for tests saying how often a method is called | **No** |
 | `internal/testlisten` | A test binary standing in for a dev server a session starts, for tests of ports | **No** |
 | `core/*` (others) | Runner, scheduler, store (later) | **No** |
 | `transport/` | Local socket, SSH, daemon spawning | **No** |
@@ -92,8 +101,10 @@ Go 1.27+ is required (MyGo needs it). With an older `go`, set `GOTOOLCHAIN=go1.2
 | `ui/widget` | Controls every view shares: buttons, dialogs, menus, chips, Markdown | Yes |
 | `ui/textfmt` | How values read in the UI: sizes, plurals, paths | **No** |
 | `ui/localpicker` | Picks files and folders of this device, for adding them to a session's folder | Yes |
-| `ui/chatview`, `ui/activityview`, `ui/appwindow`, `ui/libraryview`, `ui/browserview`, `ui/checkview`, `ui/diffview`, `ui/fileview`, `ui/portview`, `ui/trafficview`, `ui/androidview`, `ui/notesview`, `ui/canvasview`, `ui/vaultview`, `ui/usageview`, `ui/folderpicker`, `ui/syncview` | Self-contained views; they get what they need from `ui` through options and callbacks, never import it | Yes |
+| `ui/chatview`, `ui/activityview`, `ui/appwindow`, `ui/libraryview`, `ui/communityview`, `ui/browserview`, `ui/checkview`, `ui/diffview`, `ui/fileview`, `ui/portview`, `ui/trafficview`, `ui/androidview`, `ui/notesview`, `ui/canvasview`, `ui/vaultview`, `ui/usageview`, `ui/folderpicker`, `ui/syncview` | Self-contained views; they get what they need from `ui` through options and callbacks, never import it | Yes |
 | `ui/onboardview` | The first run: the app assembling itself, a clock driving the opening, frames, wires and the change of style, the seven steps in a panel; its links in `links.go` (see `docs/onboarding.md`); self-contained like the views above | Yes |
+| `ui/platformview` | Claude Platform's sheet (API keys, from the vault; its system prompt) and the words its chat says of them; self-contained like the views above | Yes |
+| `ui/projectdocsview` | Project Docs on the Notes page: making a project, its summary, a document's strip; self-contained like the views above, drawn through a hook of `ui/notesview` | Yes |
 | `ui/tokenview` | The Tokens tab of Resource usage: every host's token use, budgets, prices, coverage; self-contained like the views above | Yes |
 
 Keep MyGo out of packages marked **No**. If MyGo ever has to be replaced, only `ui/`, `cmd/enowx` and the terminal emulation in `core/session` should change.

cli/background.go

@@ -0,0 +1,86 @@
+package cli
+
+import (
+	"errors"
+	"flag"
+	"fmt"
+	"strconv"
+	"text/tabwriter"
+	"time"
+
+	"github.com/enowx/enowx/proto"
+	"github.com/enowx/enowx/ui/textfmt"
+)
+
+const backgroundUsage = "usage: enowx-app background [SESSION] | background stop SESSION PID --yes"
+
+// background lists a session's background agents, or stops one.
+func (r runner) background(args []string) error {
+	if len(args) > 0 && args[0] == "stop" {
+		return r.backgroundStop(args[1:])
+	}
+	if len(args) > 1 {
+		return errors.New(backgroundUsage)
+	}
+	list, err := r.c.Sessions()
+	if err != nil {
+		return err
+	}
+	only := ""
+	if len(args) == 1 {
+		s, err := r.session(args[0])
+		if err != nil {
+			return err
+		}
+		only = s.ID
+	}
+	w := tabwriter.NewWriter(r.out, 0, 0, 2, ' ', 0)
+	fmt.Fprintln(w, "SESSION\tPID\tAGENT\tFOR\tCPU\tMEMORY\tNOTE")
+	now := time.Now()
+	for _, s := range list {
+		if only != "" && s.ID != only {
+			continue
+		}
+		for _, b := range s.Background {
+			note := ""
+			switch {
+			case b.Stuck:
+				note = "stuck: next to no CPU for a while"
+			case b.Left:
+				note = "left from under its agent"
+			}
+			fmt.Fprintf(w, "%s\t%d\t%s\t%s\t%s\t%s\t%s\n", s.ID, b.PID, b.Name, textfmt.Age(b.Since, now), textfmt.CPU(b.CPUPercent), textfmt.Bytes(b.Memory), note)
+		}
+	}
+	if err := w.Flush(); err != nil {
+		return err
+	}
+	fmt.Fprintln(r.out, "Seen by the process tree: a subagent inside its agent's process, at an API, or under a CLI's own background service (OpenCode's server) doesn't show.")
+	return nil
+}
+
+func (r runner) backgroundStop(args []string) error {
+	fs := flag.NewFlagSet("background stop", flag.ContinueOnError)
+	yes := fs.Bool("yes", false, "")
+	s, rest, err := r.sessionAndFlags(fs, args, backgroundUsage)
+	if err != nil {
+		return err
+	}
+	if len(rest) != 1 {
+		return errors.New(backgroundUsage)
+	}
+	pid, err := strconv.Atoi(rest[0])
+	if err != nil {
+		return errors.New(backgroundUsage)
+	}
+	for _, b := range s.Background {
+		if b.PID != pid {
+			continue
+		}
+		if err := needYes(*yes, "stopping "+b.Name+" (what it hasn't saved is lost)"); err != nil {
+			return err
+		}
+		return r.guarded(proto.MethodSessionStopBackground, proto.StopBackgroundParams{Session: s.ID, PID: pid, Start: b.Start}, nil)
+	}
+	return fmt.Errorf("process %d isn't a background agent of %s", pid, s.ID)
+}

cli/canvas_brief.go

@@ -29,6 +29,7 @@ func (r runner) canvasBrief(args []string) error {
 		return err
 	}
 	if *set == "" {
+		defer r.canvasReferences(c)
 		if c.Brief == nil {
 			fmt.Fprintf(r.out, "No brief yet. Write one: enowx-app canvas brief %s --set -, with these sections:\n\n%s", c.ID, designbrief.Template())
 			return nil

cli/canvas_chat.go

@@ -81,7 +81,7 @@ func (r runner) canvasSession(id, agent string) (proto.SessionInfo, bool, error)
 		return proto.SessionInfo{}, false, err
 	}
 	for i := len(list) - 1; i >= 0; i-- {
-		if s := list[i]; s.CanvasFor == id && s.Agent == agent && !s.Exited {
+		if s := list[i]; s.CanvasFor == id && s.Agent == agent && !s.Exited && !strings.HasPrefix(s.Group, proto.UnslopGroup) {
 			return s, true, nil
 		}
 	}

cli/canvas_designs.go

@@ -9,6 +9,7 @@ import (
 	"strings"
 
 	"github.com/enowx/enowx/core/canvas"
+	"github.com/enowx/enowx/core/designshare"
 	"github.com/enowx/enowx/proto"
 )
 
@@ -165,6 +166,10 @@ func canvasSized(c proto.Canvas) bool {
 }
 
 func (r runner) listDesigns(c proto.Canvas) error {
+	return r.labelledIfCopied(c, func(r runner) error { return r.printDesigns(c) })
+}
+
+func (r runner) printDesigns(c proto.Canvas) error {
 	fmt.Fprintf(r.out, "%s  %s: %d designs\n", c.ID, c.Title, len(c.Frames))
 	for i, f := range c.Frames {
 		marks := ""
@@ -179,7 +184,7 @@ func (r runner) listDesigns(c proto.Canvas) error {
 		if group != "" {
 			group = "  (" + group + ")"
 		}
-		fmt.Fprintf(r.out, "%3d  %s%s  %d×%d%s  %s\n", i+1, f.Name, group, f.Width, f.Height, marks, canvas.Link(c.ID, i+1))
+		fmt.Fprintf(r.out, "%3d  %s%s  %d×%d%s  %s\n", i+1, designshare.OneLine(f.Name), group, f.Width, f.Height, marks, canvas.Link(c.ID, i+1))
 		if f.Description != "" {
 			fmt.Fprintf(r.out, "     %s\n", f.Description)
 		}

cli/canvas_show.go

@@ -11,6 +11,7 @@ import (
 	"time"
 
 	"github.com/enowx/enowx/core/canvas"
+	"github.com/enowx/enowx/core/designshare"
 	"github.com/enowx/enowx/proto"
 )
 
@@ -28,6 +29,7 @@ func (r runner) canvasList() error {
 			names[sp.Team] = sp.Name
 		}
 	}
+	var copied strings.Builder // their titles are the library's creators' words
 	for _, c := range list {
 		state := ""
 		if c.Team != "" {
@@ -36,8 +38,15 @@ func (r runner) canvasList() error {
 		if c.Paused {
 			state += "  (paused by the user)"
 		}
+		if c.Source != nil {
+			fmt.Fprintf(&copied, "%s  %-9s  %s%s\n", c.ID, c.Kind, designshare.OneLine(c.Title), state)
+			continue
+		}
 		fmt.Fprintf(r.out, "%s  %-9s  %s%s\n", c.ID, c.Kind, c.Title, state)
 	}
+	if copied.Len() > 0 {
+		fmt.Fprintf(r.out, "Copied from the community library:\n%s\n", designshare.ForAgents(strings.TrimRight(copied.String(), "\n")))
+	}
 	return nil
 }
 
@@ -91,6 +100,10 @@ func (r runner) canvasNew(title string, f *canvasFlags) error {
 // canvasShow prints what an agent works from: frames, their elements by
 // id, and the comments still open.
 func (r runner) canvasShow(c proto.Canvas, f *canvasFlags) error {
+	return r.labelledIfCopied(c, func(r runner) error { return r.printCanvas(c, f) })
+}
+
+func (r runner) printCanvas(c proto.Canvas, f *canvasFlags) error {
 	if *f.showHTML {
 		i, err := canvas.FrameIndex(c, *f.frame)
 		if err != nil {
@@ -107,7 +120,7 @@ func (r runner) canvasShow(c proto.Canvas, f *canvasFlags) error {
 		fmt.Fprintf(r.out, "Projects: %s\n", strings.Join(c.Projects, ", "))
 	}
 	for _, fr := range c.Frames {
-		fmt.Fprintf(r.out, "\nFrame %s (%s) %d×%d\n", fr.Name, fr.ID, fr.Width, fr.Height)
+		fmt.Fprintf(r.out, "\nFrame %s (%s) %d×%d\n", designshare.OneLine(fr.Name), fr.ID, fr.Width, fr.Height)
 		if g := fr.Grid; g != nil {
 			var names []string
 			for _, a := range g.Areas {