painapple-code 1.0.2__tar.gz → 1.0.3__tar.gz

{painapple_code-1.0.2/src/painapple_code.egg-info → painapple_code-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: painapple-code
-Version: 1.0.2
+Version: 1.0.3
 Summary: Self-hosted remote UI for Claude Code that journals every turn - background AI summaries become shadow-git commits and a queryable DuckDB history
 Author-email: Michał Booth-Wrotkowski <michal@boothw.com>
 License-Expression: AGPL-3.0-or-later

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.0.2'
-__version_tuple__ = version_tuple = (1, 0, 2)
+__version__ = version = '1.0.3'
+__version_tuple__ = version_tuple = (1, 0, 3)
 
-__commit_id__ = commit_id = 'ge157c77'
+__commit_id__ = commit_id = 'g1be1164'

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/cli/deploy/container.py

@@ -533,6 +533,10 @@ def run_container(cfg, detach, profile=None):
     from painapple_code.cli.netinfo import port_holder, port_taken
     reason = port_taken(cfg.listen_host, cfg.port)
     if reason:
+        if getattr(reason, "bad_host", False):
+            err(f"Cannot bind {cfg.listen_host}:{cfg.port} — {reason}")
+            say(f"  {DIM}Fix the bind host:  {hint('setup', profile)}{RESET}")
+            return 1
         holder = port_holder(cfg.port)
         err(f"Port {cfg.port} on {cfg.listen_host} is already in use — {reason}"
             + (f" (held by {holder})" if holder else ""))

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/cli/lifecycle_cmd.py

@@ -283,6 +283,9 @@ def _start(target, extra):
     from painapple_code.cli.netinfo import port_holder, port_taken
     reason = port_taken(host, port)
     if reason:
+        if getattr(reason, "bad_host", False):
+            err(f"Cannot bind {host}:{port} — {reason}. Check the host address.")
+            return 1
         holder = port_holder(port)
         err(f"Port {port} on {host} is already in use — {reason}"
             + (f" (held by {holder})" if holder else ""))

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/cli/netinfo.py

@@ -37,18 +37,36 @@ def detect_local_ips():
     return results
 
 
+class BindFailure(str):
+    """Reason string from port_taken(). `bad_host` is True when the HOST is
+    the problem (unresolvable, or not an address on this machine —
+    EADDRNOTAVAIL) rather than the port being held by another process, so
+    callers can skip the "already in use" framing and the holder lookup."""
+    bad_host = False
+
+
+def _bind_failure(reason, bad_host=False):
+    out = BindFailure(reason)
+    out.bad_host = bad_host
+    return out
+
+
 def port_taken(host, port):
     """Reason string when `host:port` can't be bound, '' when it's free.
 
     A plain bind test — catches ANY holder, unlike a scan of painapple's
     own process table. Used by the server's own pre-flight and by
     `painapple start` so the failure is reported before a detached child
-    inherits it. Unresolvable host counts as taken (with the reason)."""
+    inherits it. Non-empty returns are BindFailure: `bad_host` marks a
+    wrong bind address (unresolvable / not local) as opposed to a port
+    genuinely held by another process."""
+    import errno
     import socket
     try:
         infos = socket.getaddrinfo(host, port, type=socket.SOCK_STREAM)
     except socket.gaierror as e:
-        return f"cannot resolve host {host!r} ({e})"
+        return _bind_failure(f"cannot resolve host {host!r} ({e})",
+                             bad_host=True)
     family, socktype, proto, _canon, sockaddr = infos[0]
     with socket.socket(family, socktype, proto) as sock:
         # SO_REUSEADDR means opposite things on the two platforms. On POSIX
@@ -65,7 +83,17 @@ def port_taken(host, port):
         try:
             sock.bind(sockaddr)
         except OSError as e:
-            return e.strerror or str(e)
+            msg = e.strerror or str(e)
+            # EADDRNOTAVAIL ("Cannot assign requested address") is not a
+            # port conflict — the IP isn't assigned to any interface here.
+            # Framing it as "already in use" sent users hunting for a
+            # holder that doesn't exist (winsock code on Windows differs).
+            if e.errno in (errno.EADDRNOTAVAIL,
+                           getattr(errno, "WSAEADDRNOTAVAIL", None)):
+                return _bind_failure(
+                    f"{msg} — {host!r} is not an address on this machine",
+                    bad_host=True)
+            return _bind_failure(msg)
     return ""
 
 

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/cli/serve_args.py

@@ -85,6 +85,12 @@ def build_parser():
                            "its own directory. This anchors the file explorer and "
                            "the welcome screen's project suggestions. Mapped to "
                            "/workspace inside Docker. (--cwd is an alias)")
+    core.add_argument("--project", dest="project",
+                      action=argparse.BooleanOptionalAction, default=None,
+                      help="Treat the workspace as ONE project (the welcome screen "
+                           "offers it as a single entry) instead of a folder of "
+                           "projects. Default: auto-detect by a top-level .git; "
+                           "--no-project disables the auto-detect.")
     core.add_argument("--instance-name", default=None,
                       help="Instance label for PWA icon and UI (e.g., DEV, STABLE)")
     core.add_argument("--accent", default=None,

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/paths.py

@@ -494,6 +494,30 @@ def _looks_like_project(child: Path) -> bool:
     return False
 
 
+def resolve_workspace_is_project(workspace: str, flag: Optional[bool]) -> tuple[bool, str]:
+    """Decide whether the workspace IS one project (vs a wrapper dir of projects).
+
+    flag: True/False = forced by --project/--no-project, None = auto-detect.
+    Auto-detect keys on a top-level ``.git`` ONLY (dir for a normal repo,
+    file for a git worktree) — the same zero-config pick the Docker launch
+    path uses (cli/deploy/launch.py), deliberately NOT the broader
+    ``_looks_like_project`` manifest list: a wrapper dir with a stray
+    requirements.txt must not silently flip modes.
+
+    Returns:
+        (is_project, reason) — reason is human-readable for the startup log.
+    """
+    if flag is True:
+        return True, "forced by --project"
+    if flag is False:
+        return False, "forced by --no-project"
+    try:
+        has_git = (Path(workspace).expanduser() / ".git").exists()
+    except OSError:
+        has_git = False
+    return (True, "found .git") if has_git else (False, "no .git")
+
+
 def list_workspace_dirs(root: str, exclude_paths: Optional[list[str]] = None,
                         limit: int = 100) -> list[dict]:
     """List immediate sub-directories of a workspace root, excluding ones

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/routes/api_session_welcome.py

@@ -93,18 +93,50 @@ async def get_welcome_projects(request: Request):
     enriched.sort(key=lambda x: x["name"].lower())
 
     workspace_root = getattr(request.app.state, "workspace_root", None)
+    is_project = bool(getattr(request.app.state, "workspace_is_project", False))
     workspace_dirs: list[dict] = []
-    if workspace_root:
+    if workspace_root and is_project:
+        # The workspace IS one project — never list its internals
+        # (src/, node_modules/, …). Offer the root itself as the single
+        # "unvisited" chip until the first session tracks it as a project.
+        workspace_dirs = _root_as_workspace_entry(workspace_root, projects)
+    elif workspace_root:
         exclude = [p["path"] for p in projects]
         workspace_dirs = list_workspace_dirs(workspace_root, exclude_paths=exclude)
 
     return {
         "projects": enriched,
         "workspace_root": workspace_root,
+        "workspace_is_project": is_project,
         "workspace_dirs": workspace_dirs,
     }
 
 
+def _root_as_workspace_entry(workspace_root: str, projects: list[dict]) -> list[dict]:
+    """Project-mode chip list: the workspace root itself, in the same shape
+    `list_workspace_dirs` emits — or [] once it's already a tracked project
+    (it then appears in `projects` instead)."""
+    root = Path(workspace_root)
+    tracked = set()
+    for p in projects:
+        try:
+            tracked.add(str(Path(p["path"]).expanduser().resolve()))
+        except (OSError, RuntimeError):
+            continue
+    if str(root) in tracked:
+        return []
+    try:
+        mtime = root.stat().st_mtime
+    except OSError:
+        return []
+    return [{
+        "path": str(root),
+        "name": root.name,
+        "mtime": mtime,
+        "looks_like_project": True,
+    }]
+
+
 @router.get("/api/welcome/projects/sessions")
 async def get_project_sessions(path: str, limit: int = 15):
     """Recent sessions for a specific project — drives the quick-switcher drill-in.

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/server.py

@@ -1794,6 +1794,24 @@ def _preflight_port(host: str, port: int) -> None:
     if not reason:
         return
 
+    if getattr(reason, "bad_host", False):
+        # The HOST is wrong (unresolvable / not a local address), not the
+        # port — the "already in use" box below would send the user cycling
+        # through ports that were never the problem.
+        print(f"""
+╔══════════════════════════════════════════════════════════════╗
+║           pAInapple Code Server — cannot start
+╠══════════════════════════════════════════════════════════════╣
+║  Cannot bind {host}:{port} — the bind host is wrong.
+║  {reason}
+║
+║  Try:  {'painapple --host 0.0.0.0':<27} (listen on all interfaces)
+║        {'painapple --host 127.0.0.1':<27} (this machine only)
+╚══════════════════════════════════════════════════════════════╝
+""", file=sys.__stderr__ or sys.stdout)
+        logger.error(f"Cannot bind {host}:{port} — {reason}; not starting")
+        sys.exit(1)
+
     holder = port_holder(port)
     port_flag = f"painapple --port {port + 1}"
     print(f"""
@@ -2039,16 +2057,23 @@ def main(argv=None):
     app.state.agents = agents
     app.state.workspace = args.workspace
 
-    # --workspace IS the root: the dir that holds the project subdirs, not
-    # one project. Sessions pick their own cwd from the welcome screen and
-    # files/git/terminal follow THAT, so this only anchors discovery (the
-    # welcome "Unvisited" chips, the file-explorer browse root) and supplies
-    # a fallback cwd for sessions created without one. Stored as absolute
-    # string (or None) for route modules to read.
+    # --workspace anchors discovery (the welcome "Unvisited" chips, the
+    # file-explorer browse root) and supplies a fallback cwd for sessions
+    # created without one — sessions pick their own cwd from the welcome
+    # screen and files/git/terminal follow THAT. Two modes: a WRAPPER dir
+    # holding project subdirs (welcome lists them), or ONE project
+    # (welcome offers just the workspace itself — never its internals like
+    # src/ or node_modules/). Mode from --project/--no-project, else
+    # auto-detected by a top-level .git (same pick as Docker's launch
+    # path, which sidesteps this via the one-level-down mount). Stored as
+    # absolute string (or None) for route modules to read.
     try:
         app.state.workspace_root = str(Path(args.workspace).expanduser().resolve())
     except (OSError, RuntimeError):
         app.state.workspace_root = None
+    is_project, project_reason = paths.resolve_workspace_is_project(
+        args.workspace, args.project)
+    app.state.workspace_is_project = is_project
 
     # Load config file and populate auth state (fails open if the directory
     # can't be written — intentional: we want a noisy permissions error).
@@ -2116,6 +2141,13 @@ def main(argv=None):
                 "Use --tls=auto (default) unless you have a reason."
             )
 
+    # Project-mode annotation on the Workspace banner line; a fuller notice
+    # prints below the box ONLY when the mode was auto-detected (explicit
+    # --project/--no-project users already know what they asked for).
+    workspace_mode = ""
+    if app.state.workspace_is_project:
+        workspace_mode = f"  (single project: {project_reason})"
+
     instance_line = ""
     if instance_config.get("name"):
         instance_line = f"\n║  Instance:       {instance_config['name']} (accent: {instance_config.get('accent', 'default')})"
@@ -2164,11 +2196,16 @@ def main(argv=None):
 ╠══════════════════════════════════════════════════════════════╣
 ║  WebSocket:      {ws_scheme}://{args.host}:{args.port}/chat
 ║  Files API:      {scheme}://{args.host}:{args.port}/api/files
-║  Workspace:      {args.workspace}{instance_line}{shadow_db_line}{log_dir_line}{state_suffix_line}
+║  Workspace:      {args.workspace}{workspace_mode}{instance_line}{shadow_db_line}{log_dir_line}{state_suffix_line}
 ║  Auth File:      {app.state.auth_config_file}{tls_line}{auth_lines}
 ╚══════════════════════════════════════════════════════════════╝
     """)
 
+    if args.project is None and app.state.workspace_is_project:
+        print(f"{DIM}Workspace looks like a project (found .git) — the welcome "
+              f"screen shows it as one project, not its subfolders. Pass "
+              f"--no-project to treat it as a folder of projects.{_ANSI_RESET}")
+
     # Trust X-Forwarded-* only from loopback by default (a reverse proxy on
     # the same host). A remote proxy sets FORWARDED_ALLOW_IPS explicitly. The
     # old "*" let ANY direct client spoof X-Forwarded-Proto and flip the

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code/static/css/67-file-preview-widget.css

@@ -1031,6 +1031,23 @@
     transition: all 0.15s;
 }
 
+/* Icon buttons in the panzoom toolbar (e.g. annotate): the inline SVG ships
+   only a viewBox, so without explicit sizing it renders at the 300×150
+   replaced-element default and the icon clips out of the button entirely. */
+.panzoom-annotate-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: var(--layout-btn-sm);
+    padding: 0;
+    flex-shrink: 0;
+}
+
+.panzoom-annotate-btn svg {
+    width: 14px;
+    height: 14px;
+}
+
 .panzoom-ctrl-btn:hover, .panzoom-ctrl-btn:active {
     background: var(--surface-hover, #30363d);
     color: var(--text-primary, #e6edf3);

{painapple_code-1.0.2 → painapple_code-1.0.3/src/painapple_code.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: painapple-code
-Version: 1.0.2
+Version: 1.0.3
 Summary: Self-hosted remote UI for Claude Code that journals every turn - background AI summaries become shadow-git commits and a queryable DuckDB history
 Author-email: Michał Booth-Wrotkowski <michal@boothw.com>
 License-Expression: AGPL-3.0-or-later

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code.egg-info/scm_file_list.json

@@ -634,12 +634,14 @@
     "tests/test_text_io_encoding.py",
     "tests/test_tls_optional.py",
     "tests/test_turn_model_attribution.py",
+    "tests/test_workspace_project_mode.py",
     "tests/web/account_credentials_test.json",
     "tests/web/journal_defaults_test.json",
     "tests/web/journal_naming_test.json",
     "tests/web/provider_prompt_argv_note_test.json",
     "tests/web/status_bar_journal_test.json",
     "tests/web/sw_never_caches_project_content_test.json",
+    "tests/web/welcome_project_mode_test.json",
     "tools/bundle-feature-source.sh",
     "tools/bundler/build-app.mjs",
     "tools/bundler/package-lock.json",

{painapple_code-1.0.2 → painapple_code-1.0.3}/src/painapple_code.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "1.0.2",
+  "tag": "1.0.3",
   "distance": 0,
-  "node": "ge157c77",
+  "node": "g1be1164",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-08-31"